@oiz/stzh-components 2.2.0-beta → 2.3.0-alpha

package/dist/cjs/{focus-trap.esm-1cb6bb2e.js → focus-trap.esm-34a1a0d0.js}

@@ -1,7 +1,7 @@
 'use strict';
 
 /*!
-* tabbable 6.0.0
+* tabbable 6.0.1
 * @license MIT, https://github.com/focus-trap/tabbable/blob/master/LICENSE
 */
 var candidateSelectors = ['input', 'select', 'textarea', 'a[href]', 'button', '[tabindex]:not(slot)', 'audio[controls]', 'video[controls]', '[contenteditable]:not([contenteditable="false"])', 'details>summary:first-of-type', 'details'];
@@ -13,23 +13,22 @@ var getRootNode = !NoElement && Element.prototype.getRootNode ? function (elemen
 } : function (element) {
   return element.ownerDocument;
 };
+
 /**
  * @param {Element} el container to check in
  * @param {boolean} includeContainer add container to check
  * @param {(node: Element) => boolean} filter filter candidates
  * @returns {Element[]}
  */
-
 var getCandidates = function getCandidates(el, includeContainer, filter) {
   var candidates = Array.prototype.slice.apply(el.querySelectorAll(candidateSelector));
-
   if (includeContainer && matches.call(el, candidateSelector)) {
     candidates.unshift(el);
   }
-
   candidates = candidates.filter(filter);
   return candidates;
 };
+
 /**
  * @callback GetShadowRoot
  * @param {Element} element to check for shadow root
@@ -43,9 +42,9 @@ var getCandidates = function getCandidates(el, includeContainer, filter) {
  */
 
 /**
- * @typedef {Object} CandidatesScope
- * @property {Element} scope contains inner candidates
- * @property {Element[]} candidates
+ * @typedef {Object} CandidateScope
+ * @property {Element} scopeParent contains inner candidates
+ * @property {Element[]} candidates list of candidates found in the scope parent
  */
 
 /**
@@ -54,7 +53,7 @@ var getCandidates = function getCandidates(el, includeContainer, filter) {
  *  if a function, implies shadow support is enabled and either returns the shadow root of an element
  *  or a boolean stating if it has an undisclosed shadow root
  * @property {(node: Element) => boolean} filter filter candidates
- * @property {boolean} flatten if true then result will flatten any CandidatesScope into the returned list
+ * @property {boolean} flatten if true then result will flatten any CandidateScope into the returned list
  * @property {ShadowRootFilter} shadowRootFilter filter shadow roots;
  */
 
@@ -62,44 +61,38 @@ var getCandidates = function getCandidates(el, includeContainer, filter) {
  * @param {Element[]} elements list of element containers to match candidates from
  * @param {boolean} includeContainer add container list to check
  * @param {IterativeOptions} options
- * @returns {Array.<Element|CandidatesScope>}
+ * @returns {Array.<Element|CandidateScope>}
  */
-
-
 var getCandidatesIteratively = function getCandidatesIteratively(elements, includeContainer, options) {
   var candidates = [];
   var elementsToCheck = Array.from(elements);
-
   while (elementsToCheck.length) {
     var element = elementsToCheck.shift();
-
     if (element.tagName === 'SLOT') {
       // add shadow dom slot scope (slot itself cannot be focusable)
       var assigned = element.assignedElements();
       var content = assigned.length ? assigned : element.children;
       var nestedCandidates = getCandidatesIteratively(content, true, options);
-
       if (options.flatten) {
         candidates.push.apply(candidates, nestedCandidates);
       } else {
         candidates.push({
-          scope: element,
+          scopeParent: element,
           candidates: nestedCandidates
         });
       }
     } else {
       // check candidate element
       var validCandidate = matches.call(element, candidateSelector);
-
       if (validCandidate && options.filter(element) && (includeContainer || !elements.includes(element))) {
         candidates.push(element);
-      } // iterate over shadow content if possible
-
+      }
 
-      var shadowRoot = element.shadowRoot || // check for an undisclosed shadow
+      // iterate over shadow content if possible
+      var shadowRoot = element.shadowRoot ||
+      // check for an undisclosed shadow
       typeof options.getShadowRoot === 'function' && options.getShadowRoot(element);
       var validShadowRoot = !options.shadowRootFilter || options.shadowRootFilter(element);
-
       if (shadowRoot && validShadowRoot) {
         // add shadow dom scope IIF a shadow root node was given; otherwise, an undisclosed
         //  shadow exists, so look at light dom children as fallback BUT create a scope for any
@@ -108,12 +101,11 @@ var getCandidatesIteratively = function getCandidatesIteratively(elements, inclu
         //  slotted somewhere _inside_ the undisclosed shadow) -- the scope is created below,
         //  _after_ we return from this recursive call
         var _nestedCandidates = getCandidatesIteratively(shadowRoot === true ? element.children : shadowRoot.children, true, options);
-
         if (options.flatten) {
           candidates.push.apply(candidates, _nestedCandidates);
         } else {
           candidates.push({
-            scope: element,
+            scopeParent: element,
             candidates: _nestedCandidates
           });
         }
@@ -124,10 +116,8 @@ var getCandidatesIteratively = function getCandidatesIteratively(elements, inclu
       }
     }
   }
-
   return candidates;
 };
-
 var getTabindex = function getTabindex(node, isScope) {
   if (node.tabIndex < 0) {
     // in Chrome, <details/>, <audio controls/> and <video controls/> elements get a default
@@ -145,29 +135,23 @@ var getTabindex = function getTabindex(node, isScope) {
       return 0;
     }
   }
-
   return node.tabIndex;
 };
-
 var sortOrderedTabbables = function sortOrderedTabbables(a, b) {
   return a.tabIndex === b.tabIndex ? a.documentOrder - b.documentOrder : a.tabIndex - b.tabIndex;
 };
-
 var isInput = function isInput(node) {
   return node.tagName === 'INPUT';
 };
-
 var isHiddenInput = function isHiddenInput(node) {
   return isInput(node) && node.type === 'hidden';
 };
-
 var isDetailsWithSummary = function isDetailsWithSummary(node) {
   var r = node.tagName === 'DETAILS' && Array.prototype.slice.apply(node.children).some(function (child) {
     return child.tagName === 'SUMMARY';
   });
   return r;
 };
-
 var getCheckedRadio = function getCheckedRadio(nodes, form) {
   for (var i = 0; i < nodes.length; i++) {
     if (nodes[i].checked && nodes[i].form === form) {
@@ -175,20 +159,15 @@ var getCheckedRadio = function getCheckedRadio(nodes, form) {
     }
   }
 };
-
 var isTabbableRadio = function isTabbableRadio(node) {
   if (!node.name) {
     return true;
   }
-
   var radioScope = node.form || getRootNode(node);
-
   var queryRadios = function queryRadios(name) {
     return radioScope.querySelectorAll('input[type="radio"][name="' + name + '"]');
   };
-
   var radioSet;
-
   if (typeof window !== 'undefined' && typeof window.CSS !== 'undefined' && typeof window.CSS.escape === 'function') {
     radioSet = queryRadios(window.CSS.escape(node.name));
   } else {
@@ -200,23 +179,19 @@ var isTabbableRadio = function isTabbableRadio(node) {
       return false;
     }
   }
-
   var checked = getCheckedRadio(radioSet, node.form);
   return !checked || checked === node;
 };
-
 var isRadio = function isRadio(node) {
   return isInput(node) && node.type === 'radio';
 };
-
 var isNonTabbableRadio = function isNonTabbableRadio(node) {
   return isRadio(node) && !isTabbableRadio(node);
-}; // determines if a node is ultimately attached to the window's document
-
+};
 
+// determines if a node is ultimately attached to the window's document
 var isNodeAttached = function isNodeAttached(node) {
   var _nodeRootHost;
-
   // The root node is the shadow root if the node is in a shadow DOM; some document otherwise
   //  (but NOT _the_ document; see second 'If' comment below for more).
   // If rootNode is shadow root, it'll have a host, which is the element to which the shadow
@@ -238,32 +213,25 @@ var isNodeAttached = function isNodeAttached(node) {
   //  node is actually detached.
   var nodeRootHost = getRootNode(node).host;
   var attached = !!((_nodeRootHost = nodeRootHost) !== null && _nodeRootHost !== void 0 && _nodeRootHost.ownerDocument.contains(nodeRootHost) || node.ownerDocument.contains(node));
-
   while (!attached && nodeRootHost) {
     var _nodeRootHost2;
-
     // since it's not attached and we have a root host, the node MUST be in a nested shadow DOM,
     //  which means we need to get the host's host and check if that parent host is contained
     //  in (i.e. attached to) the document
     nodeRootHost = getRootNode(nodeRootHost).host;
     attached = !!((_nodeRootHost2 = nodeRootHost) !== null && _nodeRootHost2 !== void 0 && _nodeRootHost2.ownerDocument.contains(nodeRootHost));
   }
-
   return attached;
 };
-
 var isZeroArea = function isZeroArea(node) {
   var _node$getBoundingClie = node.getBoundingClientRect(),
-      width = _node$getBoundingClie.width,
-      height = _node$getBoundingClie.height;
-
+    width = _node$getBoundingClie.width,
+    height = _node$getBoundingClie.height;
   return width === 0 && height === 0;
 };
-
 var isHidden = function isHidden(node, _ref) {
   var displayCheck = _ref.displayCheck,
-      getShadowRoot = _ref.getShadowRoot;
-
+    getShadowRoot = _ref.getShadowRoot;
   // NOTE: visibility will be `undefined` if node is detached from the document
   //  (see notes about this further down), which means we will consider it visible
   //  (this is legacy behavior from a very long way back)
@@ -272,24 +240,19 @@ var isHidden = function isHidden(node, _ref) {
   if (getComputedStyle(node).visibility === 'hidden') {
     return true;
   }
-
   var isDirectSummary = matches.call(node, 'details>summary:first-of-type');
   var nodeUnderDetails = isDirectSummary ? node.parentElement : node;
-
   if (matches.call(nodeUnderDetails, 'details:not([open]) *')) {
     return true;
   }
-
   if (!displayCheck || displayCheck === 'full' || displayCheck === 'legacy-full') {
     if (typeof getShadowRoot === 'function') {
       // figure out if we should consider the node to be in an undisclosed shadow and use the
       //  'non-zero-area' fallback
       var originalNode = node;
-
       while (node) {
         var parentElement = node.parentElement;
         var rootNode = getRootNode(node);
-
         if (parentElement && !parentElement.shadowRoot && getShadowRoot(parentElement) === true // check if there's an undisclosed shadow
         ) {
           // node has an undisclosed shadow which means we can only treat it as a black box, so we
@@ -306,25 +269,27 @@ var isHidden = function isHidden(node, _ref) {
           node = parentElement;
         }
       }
-
       node = originalNode;
-    } // else, `getShadowRoot` might be true, but all that does is enable shadow DOM support
+    }
+    // else, `getShadowRoot` might be true, but all that does is enable shadow DOM support
     //  (i.e. it does not also presume that all nodes might have undisclosed shadows); or
     //  it might be a falsy value, which means shadow DOM support is disabled
+
     // Since we didn't find it sitting in an undisclosed shadow (or shadows are disabled)
     //  now we can just test to see if it would normally be visible or not, provided it's
     //  attached to the main document.
     // NOTE: We must consider case where node is inside a shadow DOM and given directly to
     //  `isTabbable()` or `isFocusable()` -- regardless of `getShadowRoot` option setting.
 
-
     if (isNodeAttached(node)) {
       // this works wherever the node is: if there's at least one client rect, it's
       //  somehow displayed; it also covers the CSS 'display: contents' case where the
       //  node itself is hidden in place of its contents; and there's no need to search
       //  up the hierarchy either
       return !node.getClientRects().length;
-    } // Else, the node isn't attached to the document, which means the `getClientRects()`
+    }
+
+    // Else, the node isn't attached to the document, which means the `getClientRects()`
     //  API will __always__ return zero rects (this can happen, for example, if React
     //  is used to render nodes onto a detached tree, as confirmed in this thread:
     //  https://github.com/facebook/react/issues/9117#issuecomment-284228870)
@@ -340,12 +305,10 @@ var isHidden = function isHidden(node, _ref) {
     //
     // v6.0.0: As of this major release, the default 'full' option __no longer treats detached
     //  nodes as visible with the 'none' fallback.__
-
-
     if (displayCheck !== 'legacy-full') {
       return true; // hidden
-    } // else, fallback to 'none' mode and consider the node visible
-
+    }
+    // else, fallback to 'none' mode and consider the node visible
   } else if (displayCheck === 'non-zero-area') {
     // NOTE: Even though this tests that the node's client rect is non-zero to determine
     //  whether it's displayed, and that a detached node will __always__ have a zero-area
@@ -353,89 +316,79 @@ var isHidden = function isHidden(node, _ref) {
     //  this mode, we do want to consider nodes that have a zero area to be hidden at all
     //  times, and that includes attached or not.
     return isZeroArea(node);
-  } // visible, as far as we can tell, or per current `displayCheck=none` mode, we assume
-  //  it's visible
-
+  }
 
+  // visible, as far as we can tell, or per current `displayCheck=none` mode, we assume
+  //  it's visible
   return false;
-}; // form fields (nested) inside a disabled fieldset are not focusable/tabbable
+};
+
+// form fields (nested) inside a disabled fieldset are not focusable/tabbable
 //  unless they are in the _first_ <legend> element of the top-most disabled
 //  fieldset
-
-
 var isDisabledFromFieldset = function isDisabledFromFieldset(node) {
   if (/^(INPUT|BUTTON|SELECT|TEXTAREA)$/.test(node.tagName)) {
-    var parentNode = node.parentElement; // check if `node` is contained in a disabled <fieldset>
-
+    var parentNode = node.parentElement;
+    // check if `node` is contained in a disabled <fieldset>
     while (parentNode) {
       if (parentNode.tagName === 'FIELDSET' && parentNode.disabled) {
         // look for the first <legend> among the children of the disabled <fieldset>
         for (var i = 0; i < parentNode.children.length; i++) {
-          var child = parentNode.children.item(i); // when the first <legend> (in document order) is found
-
+          var child = parentNode.children.item(i);
+          // when the first <legend> (in document order) is found
           if (child.tagName === 'LEGEND') {
             // if its parent <fieldset> is not nested in another disabled <fieldset>,
             // return whether `node` is a descendant of its first <legend>
             return matches.call(parentNode, 'fieldset[disabled] *') ? true : !child.contains(node);
           }
-        } // the disabled <fieldset> containing `node` has no <legend>
-
-
+        }
+        // the disabled <fieldset> containing `node` has no <legend>
         return true;
       }
-
       parentNode = parentNode.parentElement;
     }
-  } // else, node's tabbable/focusable state should not be affected by a fieldset's
-  //  enabled/disabled state
-
+  }
 
+  // else, node's tabbable/focusable state should not be affected by a fieldset's
+  //  enabled/disabled state
   return false;
 };
-
 var isNodeMatchingSelectorFocusable = function isNodeMatchingSelectorFocusable(options, node) {
-  if (node.disabled || isHiddenInput(node) || isHidden(node, options) || // For a details element with a summary, the summary element gets the focus
+  if (node.disabled || isHiddenInput(node) || isHidden(node, options) ||
+  // For a details element with a summary, the summary element gets the focus
   isDetailsWithSummary(node) || isDisabledFromFieldset(node)) {
     return false;
   }
-
   return true;
 };
-
 var isNodeMatchingSelectorTabbable = function isNodeMatchingSelectorTabbable(options, node) {
   if (isNonTabbableRadio(node) || getTabindex(node) < 0 || !isNodeMatchingSelectorFocusable(options, node)) {
     return false;
   }
-
   return true;
 };
-
 var isValidShadowRootTabbable = function isValidShadowRootTabbable(shadowHostNode) {
   var tabIndex = parseInt(shadowHostNode.getAttribute('tabindex'), 10);
-
   if (isNaN(tabIndex) || tabIndex >= 0) {
     return true;
-  } // If a custom element has an explicit negative tabindex,
+  }
+  // If a custom element has an explicit negative tabindex,
   // browsers will not allow tab targeting said element's children.
-
-
   return false;
 };
+
 /**
- * @param {Array.<Element|CandidatesScope>} candidates
+ * @param {Array.<Element|CandidateScope>} candidates
  * @returns Element[]
  */
-
-
 var sortByOrder = function sortByOrder(candidates) {
   var regularTabbables = [];
   var orderedTabbables = [];
   candidates.forEach(function (item, i) {
-    var isScope = !!item.scope;
-    var element = isScope ? item.scope : item;
+    var isScope = !!item.scopeParent;
+    var element = isScope ? item.scopeParent : item;
     var candidateTabindex = getTabindex(element, isScope);
     var elements = isScope ? sortByOrder(item.candidates) : element;
-
     if (candidateTabindex === 0) {
       isScope ? regularTabbables.push.apply(regularTabbables, elements) : regularTabbables.push(element);
     } else {
@@ -453,11 +406,9 @@ var sortByOrder = function sortByOrder(candidates) {
     return acc;
   }, []).concat(regularTabbables);
 };
-
 var tabbable = function tabbable(el, options) {
   options = options || {};
   var candidates;
-
   if (options.getShadowRoot) {
     candidates = getCandidatesIteratively([el], options.includeContainer, {
       filter: isNodeMatchingSelectorTabbable.bind(null, options),
@@ -468,14 +419,11 @@ var tabbable = function tabbable(el, options) {
   } else {
     candidates = getCandidates(el, options.includeContainer, isNodeMatchingSelectorTabbable.bind(null, options));
   }
-
   return sortByOrder(candidates);
 };
-
 var focusable = function focusable(el, options) {
   options = options || {};
   var candidates;
-
   if (options.getShadowRoot) {
     candidates = getCandidatesIteratively([el], options.includeContainer, {
       filter: isNodeMatchingSelectorFocusable.bind(null, options),
@@ -485,58 +433,45 @@ var focusable = function focusable(el, options) {
   } else {
     candidates = getCandidates(el, options.includeContainer, isNodeMatchingSelectorFocusable.bind(null, options));
   }
-
   return candidates;
 };
-
 var isTabbable = function isTabbable(node, options) {
   options = options || {};
-
   if (!node) {
     throw new Error('No node provided');
   }
-
   if (matches.call(node, candidateSelector) === false) {
     return false;
   }
-
   return isNodeMatchingSelectorTabbable(options, node);
 };
-
 var focusableCandidateSelector = /* #__PURE__ */candidateSelectors.concat('iframe').join(',');
-
 var isFocusable = function isFocusable(node, options) {
   options = options || {};
-
   if (!node) {
     throw new Error('No node provided');
   }
-
   if (matches.call(node, focusableCandidateSelector) === false) {
     return false;
   }
-
   return isNodeMatchingSelectorFocusable(options, node);
 };
 
 /*!
-* focus-trap 7.0.0
+* focus-trap 7.2.0
 * @license MIT, https://github.com/focus-trap/focus-trap/blob/master/LICENSE
 */
 
 function ownKeys(object, enumerableOnly) {
   var keys = Object.keys(object);
-
   if (Object.getOwnPropertySymbols) {
     var symbols = Object.getOwnPropertySymbols(object);
     enumerableOnly && (symbols = symbols.filter(function (sym) {
       return Object.getOwnPropertyDescriptor(object, sym).enumerable;
     })), keys.push.apply(keys, symbols);
   }
-
   return keys;
 }
-
 function _objectSpread2(target) {
   for (var i = 1; i < arguments.length; i++) {
     var source = null != arguments[i] ? arguments[i] : {};
@@ -546,11 +481,10 @@ function _objectSpread2(target) {
       Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
     });
   }
-
   return target;
 }
-
 function _defineProperty(obj, key, value) {
+  key = _toPropertyKey(key);
   if (key in obj) {
     Object.defineProperty(obj, key, {
       value: value,
@@ -561,64 +495,75 @@ function _defineProperty(obj, key, value) {
   } else {
     obj[key] = value;
   }
-
   return obj;
 }
+function _toPrimitive(input, hint) {
+  if (typeof input !== "object" || input === null) return input;
+  var prim = input[Symbol.toPrimitive];
+  if (prim !== undefined) {
+    var res = prim.call(input, hint || "default");
+    if (typeof res !== "object") return res;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return (hint === "string" ? String : Number)(input);
+}
+function _toPropertyKey(arg) {
+  var key = _toPrimitive(arg, "string");
+  return typeof key === "symbol" ? key : String(key);
+}
 
-var activeFocusTraps = function () {
-  var trapQueue = [];
-  return {
-    activateTrap: function activateTrap(trap) {
-      if (trapQueue.length > 0) {
-        var activeTrap = trapQueue[trapQueue.length - 1];
-
-        if (activeTrap !== trap) {
-          activeTrap.pause();
-        }
-      }
-
-      var trapIndex = trapQueue.indexOf(trap);
-
-      if (trapIndex === -1) {
-        trapQueue.push(trap);
-      } else {
-        // move this existing trap to the front of the queue
-        trapQueue.splice(trapIndex, 1);
-        trapQueue.push(trap);
-      }
-    },
-    deactivateTrap: function deactivateTrap(trap) {
-      var trapIndex = trapQueue.indexOf(trap);
-
-      if (trapIndex !== -1) {
-        trapQueue.splice(trapIndex, 1);
-      }
-
-      if (trapQueue.length > 0) {
-        trapQueue[trapQueue.length - 1].unpause();
+var activeFocusTraps = {
+  activateTrap: function activateTrap(trapStack, trap) {
+    if (trapStack.length > 0) {
+      var activeTrap = trapStack[trapStack.length - 1];
+      if (activeTrap !== trap) {
+        activeTrap.pause();
       }
     }
-  };
-}();
-
+    var trapIndex = trapStack.indexOf(trap);
+    if (trapIndex === -1) {
+      trapStack.push(trap);
+    } else {
+      // move this existing trap to the front of the queue
+      trapStack.splice(trapIndex, 1);
+      trapStack.push(trap);
+    }
+  },
+  deactivateTrap: function deactivateTrap(trapStack, trap) {
+    var trapIndex = trapStack.indexOf(trap);
+    if (trapIndex !== -1) {
+      trapStack.splice(trapIndex, 1);
+    }
+    if (trapStack.length > 0) {
+      trapStack[trapStack.length - 1].unpause();
+    }
+  }
+};
 var isSelectableInput = function isSelectableInput(node) {
   return node.tagName && node.tagName.toLowerCase() === 'input' && typeof node.select === 'function';
 };
-
 var isEscapeEvent = function isEscapeEvent(e) {
   return e.key === 'Escape' || e.key === 'Esc' || e.keyCode === 27;
 };
-
 var isTabEvent = function isTabEvent(e) {
   return e.key === 'Tab' || e.keyCode === 9;
 };
 
+// checks for TAB by default
+var isKeyForward = function isKeyForward(e) {
+  return isTabEvent(e) && !e.shiftKey;
+};
+
+// checks for SHIFT+TAB by default
+var isKeyBackward = function isKeyBackward(e) {
+  return isTabEvent(e) && e.shiftKey;
+};
 var delay = function delay(fn) {
   return setTimeout(fn, 0);
-}; // Array.find/findIndex() are not supported on IE; this replicates enough
-//  of Array.findIndex() for our needs
-
+};
 
+// Array.find/findIndex() are not supported on IE; this replicates enough
+//  of Array.findIndex() for our needs
 var findIndex = function findIndex(arr, fn) {
   var idx = -1;
   arr.every(function (value, i) {
@@ -629,8 +574,10 @@ var findIndex = function findIndex(arr, fn) {
 
     return true; // next
   });
+
   return idx;
 };
+
 /**
  * Get an option's value when it could be a plain value, or a handler that provides
  *  the value.
@@ -638,16 +585,12 @@ var findIndex = function findIndex(arr, fn) {
  * @param {...*} [params] Any parameters to pass to the handler, if `value` is a function.
  * @returns {*} The `value`, or the handler's returned value.
  */
-
-
 var valueOrHandler = function valueOrHandler(value) {
   for (var _len = arguments.length, params = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
     params[_key - 1] = arguments[_key];
   }
-
   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
@@ -659,17 +602,21 @@ var getActualTarget = function getActualTarget(event) {
   return event.target.shadowRoot && typeof event.composedPath === 'function' ? event.composedPath()[0] : event.target;
 };
 
+// NOTE: this must be _outside_ `createFocusTrap()` to make sure all traps in this
+//  current instance use the same stack if `userOptions.trapStack` isn't specified
+var internalTrapStack = [];
 var createFocusTrap = function createFocusTrap(elements, userOptions) {
   // 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 trapStack = (userOptions === null || userOptions === void 0 ? void 0 : userOptions.trapStack) || internalTrapStack;
   var config = _objectSpread2({
     returnFocusOnDeactivate: true,
     escapeDeactivates: true,
-    delayInitialFocus: true
+    delayInitialFocus: true,
+    isKeyForward: isKeyForward,
+    isKeyBackward: isKeyBackward
   }, userOptions);
-
   var state = {
     // containers given to createFocusTrap()
     // @type {Array<HTMLElement>}
@@ -689,6 +636,7 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
     // }>}
     containerGroups: [],
     // same order/length as `containers` list
+
     // references to objects in `containerGroups`, but only those that actually have
     //  tabbable nodes in them
     // NOTE: same order as `containers` and `containerGroups`, but __not necessarily__
@@ -712,10 +660,10 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
    * @param {string|undefined} [configOptionName] Name of option to use __instead of__ `optionName`
    *  IIF `configOverrideOptions` is not defined. Otherwise, `optionName` is used.
    */
-
   var getOption = function getOption(configOverrideOptions, optionName, configOptionName) {
     return configOverrideOptions && configOverrideOptions[optionName] !== undefined ? configOverrideOptions[optionName] : config[configOptionName || optionName];
   };
+
   /**
    * Finds the index of the container that contains the element.
    * @param {HTMLElement} element
@@ -723,16 +671,15 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
    *  `state.containerGroups` (the order/length of these lists are the same); -1
    *  if the element isn't found.
    */
-
-
   var findContainerIndex = function findContainerIndex(element) {
     // NOTE: search `containerGroups` because it's possible a group contains no tabbable
     //  nodes, but still contains focusable nodes (e.g. if they all have `tabindex=-1`)
     //  and we still need to find the element in there
     return state.containerGroups.findIndex(function (_ref) {
       var container = _ref.container,
-          tabbableNodes = _ref.tabbableNodes;
-      return container.contains(element) || // fall back to explicit tabbable search which will take into consideration any
+        tabbableNodes = _ref.tabbableNodes;
+      return container.contains(element) ||
+      // fall back to explicit tabbable search which will take into consideration any
       //  web components if the `tabbableOptions.getShadowRoot` option was used for
       //  the trap, enabling shadow DOM support in tabbable (`Node.contains()` doesn't
       //  look inside web components even if open)
@@ -741,6 +688,7 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
       });
     });
   };
+
   /**
    * 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`
@@ -754,19 +702,14 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
    * @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 (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);
     }
-
     if (optionValue === true) {
       optionValue = undefined; // use default value
     }
@@ -774,56 +717,51 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
     if (!optionValue) {
       if (optionValue === undefined || optionValue === false) {
         return optionValue;
-      } // else, empty string (invalid), null (invalid), 0 (invalid)
-
+      }
+      // else, empty string (invalid), null (invalid), 0 (invalid)
 
       throw new Error("`".concat(optionName, "` was specified but was not a node, or did not return a node"));
     }
-
     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, "` as selector refers to no known node"));
       }
     }
-
     return node;
   };
-
   var getInitialFocusNode = function getInitialFocusNode() {
-    var node = getNodeForOption('initialFocus'); // false explicitly indicates we want no initialFocus at all
+    var node = getNodeForOption('initialFocus');
 
+    // false explicitly indicates we want no initialFocus at all
     if (node === false) {
       return false;
     }
-
     if (node === undefined) {
       // option not specified: use fallback options
       if (findContainerIndex(doc.activeElement) >= 0) {
         node = doc.activeElement;
       } else {
         var firstTabbableGroup = state.tabbableGroups[0];
-        var firstTabbableNode = firstTabbableGroup && firstTabbableGroup.firstTabbableNode; // NOTE: `fallbackFocus` option function cannot return `false` (not supported)
+        var firstTabbableNode = firstTabbableGroup && firstTabbableGroup.firstTabbableNode;
 
+        // NOTE: `fallbackFocus` option function cannot return `false` (not supported)
         node = firstTabbableNode || getNodeForOption('fallbackFocus');
       }
     }
-
     if (!node) {
       throw new Error('Your focus-trap needs to have at least one focusable element');
     }
-
     return node;
   };
-
   var updateTabbableNodes = function updateTabbableNodes() {
     state.containerGroups = state.containers.map(function (container) {
-      var tabbableNodes = tabbable(container, config.tabbableOptions); // NOTE: if we have tabbable nodes, we must have focusable nodes; focusable nodes
-      //  are a superset of tabbable nodes
+      var tabbableNodes = tabbable(container, config.tabbableOptions);
 
+      // NOTE: if we have tabbable nodes, we must have focusable nodes; focusable nodes
+      //  are a superset of tabbable nodes
       var focusableNodes = focusable(container, config.tabbableOptions);
       return {
         container: container,
@@ -831,7 +769,6 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
         focusableNodes: focusableNodes,
         firstTabbableNode: tabbableNodes.length > 0 ? tabbableNodes[0] : null,
         lastTabbableNode: tabbableNodes.length > 0 ? tabbableNodes[tabbableNodes.length - 1] : null,
-
         /**
          * Finds the __tabbable__ node that follows the given node in the specified direction,
          *  in this container, if any.
@@ -855,17 +792,14 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
           var nodeIdx = focusableNodes.findIndex(function (n) {
             return n === node;
           });
-
           if (nodeIdx < 0) {
             return undefined;
           }
-
           if (forward) {
             return focusableNodes.slice(nodeIdx + 1).find(function (n) {
               return isTabbable(n, config.tabbableOptions);
             });
           }
-
           return focusableNodes.slice(0, nodeIdx).reverse().find(function (n) {
             return isTabbable(n, config.tabbableOptions);
           });
@@ -874,53 +808,46 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
     });
     state.tabbableGroups = state.containerGroups.filter(function (group) {
       return group.tabbableNodes.length > 0;
-    }); // throw if no groups have tabbable nodes and we don't have a fallback focus node either
+    });
 
+    // throw if no groups have tabbable nodes and we don't have a fallback focus node either
     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');
     }
   };
-
   var tryFocus = function tryFocus(node) {
     if (node === false) {
       return;
     }
-
     if (node === doc.activeElement) {
       return;
     }
-
     if (!node || !node.focus) {
       tryFocus(getInitialFocusNode());
       return;
     }
-
     node.focus({
       preventScroll: !!config.preventScroll
     });
     state.mostRecentlyFocusedNode = node;
-
     if (isSelectableInput(node)) {
       node.select();
     }
   };
-
   var getReturnFocusNode = function getReturnFocusNode(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.
-
+  };
 
+  // This needs to be done on mousedown and touchstart instead of click
+  // so that it precedes the focus event.
   var checkPointerDown = function checkPointerDown(e) {
     var target = getActualTarget(e);
-
     if (findContainerIndex(target) >= 0) {
       // allow the click since it ocurred inside the trap
       return;
     }
-
     if (valueOrHandler(config.clickOutsideDeactivates, e)) {
       // immediately deactivate the trap
       trap.deactivate({
@@ -938,25 +865,26 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
         returnFocus: config.returnFocusOnDeactivate && !isFocusable(target, config.tabbableOptions)
       });
       return;
-    } // This is needed for mobile devices.
+    }
+
+    // This is needed for mobile devices.
     // (If we'll only let `click` events through,
     // then on mobile they will be blocked anyways if `touchstart` is blocked.)
-
-
     if (valueOrHandler(config.allowOutsideClick, e)) {
       // allow the click outside the trap to take place
       return;
-    } // otherwise, prevent the click
-
+    }
 
+    // otherwise, prevent the click
     e.preventDefault();
-  }; // In case focus escapes the trap for some strange reason, pull it back in.
-
+  };
 
+  // In case focus escapes the trap for some strange reason, pull it back in.
   var checkFocusIn = function checkFocusIn(e) {
     var target = getActualTarget(e);
-    var targetContained = findContainerIndex(target) >= 0; // In Firefox when you Tab out of an iframe the Document is briefly focused.
+    var targetContained = findContainerIndex(target) >= 0;
 
+    // In Firefox when you Tab out of an iframe the Document is briefly focused.
     if (targetContained || target instanceof Document) {
       if (targetContained) {
         state.mostRecentlyFocusedNode = target;
@@ -966,42 +894,41 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
       e.stopImmediatePropagation();
       tryFocus(state.mostRecentlyFocusedNode || getInitialFocusNode());
     }
-  }; // Hijack Tab events on the first and last focusable nodes of the trap,
+  };
+
+  // Hijack key nav events on the first and last focusable nodes of the trap,
   // in order to prevent focus from escaping. If it escapes for even a
   // moment it can end up scrolling the page and causing confusion so we
   // kind of need to capture the action at the keydown phase.
-
-
-  var checkTab = function checkTab(e) {
-    var target = getActualTarget(e);
+  var checkKeyNav = function checkKeyNav(event) {
+    var isBackward = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var target = getActualTarget(event);
     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 focusable
       //  with tabIndex='-1' and was given initial focus
       var containerIndex = findContainerIndex(target);
       var containerGroup = containerIndex >= 0 ? state.containerGroups[containerIndex] : undefined;
-
       if (containerIndex < 0) {
         // target not found in any group: quite possible focus has escaped the trap,
-        //  so bring it back in to...
-        if (e.shiftKey) {
+        //  so bring it back into...
+        if (isBackward) {
           // ...the last node in the last group
           destinationNode = state.tabbableGroups[state.tabbableGroups.length - 1].lastTabbableNode;
         } else {
           // ...the first node in the first group
           destinationNode = state.tabbableGroups[0].firstTabbableNode;
         }
-      } else if (e.shiftKey) {
+      } else if (isBackward) {
         // REVERSE
+
         // is the target the first tabbable node in a group?
         var startOfGroupIndex = findIndex(state.tabbableGroups, function (_ref2) {
           var firstTabbableNode = _ref2.firstTabbableNode;
           return target === firstTabbableNode;
         });
-
         if (startOfGroupIndex < 0 && (containerGroup.container === target || isFocusable(target, config.tabbableOptions) && !isTabbable(target, config.tabbableOptions) && !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
@@ -1011,7 +938,6 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
           //  first tabbable node, and go to the last tabbable node of the LAST group
           startOfGroupIndex = containerIndex;
         }
-
         if (startOfGroupIndex >= 0) {
           // YES: then shift+tab should go to the last tabbable node in the
           //  previous group (and wrap around to the last tabbable node of
@@ -1019,15 +945,19 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
           var destinationGroupIndex = startOfGroupIndex === 0 ? state.tabbableGroups.length - 1 : startOfGroupIndex - 1;
           var destinationGroup = state.tabbableGroups[destinationGroupIndex];
           destinationNode = destinationGroup.lastTabbableNode;
+        } else if (!isTabEvent(event)) {
+          // user must have customized the nav keys so we have to move focus manually _within_
+          //  the active group: do this based on the order determined by tabbable()
+          destinationNode = containerGroup.nextTabbableNode(target, false);
         }
       } else {
         // FORWARD
+
         // is the target the last tabbable node in a group?
         var lastOfGroupIndex = findIndex(state.tabbableGroups, function (_ref3) {
           var lastTabbableNode = _ref3.lastTabbableNode;
           return target === lastTabbableNode;
         });
-
         if (lastOfGroupIndex < 0 && (containerGroup.container === target || isFocusable(target, config.tabbableOptions) && !isTabbable(target, config.tabbableOptions) && !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
@@ -1037,73 +967,76 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
           //  last tabbable node, and go to the first tabbable node of the FIRST group
           lastOfGroupIndex = containerIndex;
         }
-
         if (lastOfGroupIndex >= 0) {
           // YES: then tab should go to the first tabbable node in the next
           //  group (and wrap around to the first tabbable node of the FIRST
           //  group if it's the last tabbable node of the LAST group)
           var _destinationGroupIndex = lastOfGroupIndex === state.tabbableGroups.length - 1 ? 0 : lastOfGroupIndex + 1;
-
           var _destinationGroup = state.tabbableGroups[_destinationGroupIndex];
           destinationNode = _destinationGroup.firstTabbableNode;
+        } else if (!isTabEvent(event)) {
+          // user must have customized the nav keys so we have to move focus manually _within_
+          //  the active group: do this based on the order determined by tabbable()
+          destinationNode = containerGroup.nextTabbableNode(target);
         }
       }
     } else {
+      // no groups available
       // NOTE: the fallbackFocus option does not support returning false to opt-out
       destinationNode = getNodeForOption('fallbackFocus');
     }
-
     if (destinationNode) {
-      e.preventDefault();
+      if (isTabEvent(event)) {
+        // since tab natively moves focus, we wouldn't have a destination node unless we
+        //  were on the edge of a container and had to move to the next/previous edge, in
+        //  which case we want to prevent default to keep the browser from moving focus
+        //  to where it normally would
+        event.preventDefault();
+      }
       tryFocus(destinationNode);
-    } // else, let the browser take care of [shift+]tab and move the focus
-
+    }
+    // else, let the browser take care of [shift+]tab and move the focus
   };
 
-  var checkKey = function checkKey(e) {
-    if (isEscapeEvent(e) && valueOrHandler(config.escapeDeactivates, e) !== false) {
-      e.preventDefault();
+  var checkKey = function checkKey(event) {
+    if (isEscapeEvent(event) && valueOrHandler(config.escapeDeactivates, event) !== false) {
+      event.preventDefault();
       trap.deactivate();
       return;
     }
-
-    if (isTabEvent(e)) {
-      checkTab(e);
-      return;
+    if (config.isKeyForward(event) || config.isKeyBackward(event)) {
+      checkKeyNav(event, config.isKeyBackward(event));
     }
   };
-
   var checkClick = function checkClick(e) {
     var target = getActualTarget(e);
-
     if (findContainerIndex(target) >= 0) {
       return;
     }
-
     if (valueOrHandler(config.clickOutsideDeactivates, e)) {
       return;
     }
-
     if (valueOrHandler(config.allowOutsideClick, e)) {
       return;
     }
-
     e.preventDefault();
     e.stopImmediatePropagation();
-  }; //
+  };
+
+  //
   // EVENT LISTENERS
   //
 
-
   var addListeners = function addListeners() {
     if (!state.active) {
       return;
-    } // There can be only one listening focus trap at a time
+    }
 
+    // There can be only one listening focus trap at a time
+    activeFocusTraps.activateTrap(trapStack, trap);
 
-    activeFocusTraps.activateTrap(trap); // Delay ensures that the focused element doesn't capture the event
+    // Delay ensures that the focused element doesn't capture the event
     // that caused the focus trap activation.
-
     state.delayInitialFocusTimer = config.delayInitialFocus ? delay(function () {
       tryFocus(getInitialFocusNode());
     }) : tryFocus(getInitialFocusNode());
@@ -1126,70 +1059,58 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
     });
     return trap;
   };
-
   var removeListeners = function removeListeners() {
     if (!state.active) {
       return;
     }
-
     doc.removeEventListener('focusin', checkFocusIn, true);
     doc.removeEventListener('mousedown', checkPointerDown, true);
     doc.removeEventListener('touchstart', checkPointerDown, true);
     doc.removeEventListener('click', checkClick, true);
     doc.removeEventListener('keydown', checkKey, true);
     return trap;
-  }; //
+  };
+
+  //
   // TRAP DEFINITION
   //
 
-
   trap = {
     get active() {
       return state.active;
     },
-
     get paused() {
       return state.paused;
     },
-
     activate: function activate(activateOptions) {
       if (state.active) {
         return this;
       }
-
       var onActivate = getOption(activateOptions, 'onActivate');
       var onPostActivate = getOption(activateOptions, 'onPostActivate');
       var checkCanFocusTrap = getOption(activateOptions, 'checkCanFocusTrap');
-
       if (!checkCanFocusTrap) {
         updateTabbableNodes();
       }
-
       state.active = true;
       state.paused = false;
       state.nodeFocusedBeforeActivation = doc.activeElement;
-
       if (onActivate) {
         onActivate();
       }
-
       var finishActivation = function finishActivation() {
         if (checkCanFocusTrap) {
           updateTabbableNodes();
         }
-
         addListeners();
-
         if (onPostActivate) {
           onPostActivate();
         }
       };
-
       if (checkCanFocusTrap) {
         checkCanFocusTrap(state.containers.concat()).then(finishActivation, finishActivation);
         return this;
       }
-
       finishActivation();
       return this;
     },
@@ -1197,46 +1118,38 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
       if (!state.active) {
         return this;
       }
-
       var options = _objectSpread2({
         onDeactivate: config.onDeactivate,
         onPostDeactivate: config.onPostDeactivate,
         checkCanReturnFocus: config.checkCanReturnFocus
       }, deactivateOptions);
-
       clearTimeout(state.delayInitialFocusTimer); // noop if undefined
-
       state.delayInitialFocusTimer = undefined;
       removeListeners();
       state.active = false;
       state.paused = false;
-      activeFocusTraps.deactivateTrap(trap);
+      activeFocusTraps.deactivateTrap(trapStack, trap);
       var onDeactivate = getOption(options, 'onDeactivate');
       var onPostDeactivate = getOption(options, 'onPostDeactivate');
       var checkCanReturnFocus = getOption(options, 'checkCanReturnFocus');
       var returnFocus = getOption(options, 'returnFocus', 'returnFocusOnDeactivate');
-
       if (onDeactivate) {
         onDeactivate();
       }
-
       var finishDeactivation = function finishDeactivation() {
         delay(function () {
           if (returnFocus) {
             tryFocus(getReturnFocusNode(state.nodeFocusedBeforeActivation));
           }
-
           if (onPostDeactivate) {
             onPostDeactivate();
           }
         });
       };
-
       if (returnFocus && checkCanReturnFocus) {
         checkCanReturnFocus(getReturnFocusNode(state.nodeFocusedBeforeActivation)).then(finishDeactivation, finishDeactivation);
         return this;
       }
-
       finishDeactivation();
       return this;
     },
@@ -1244,7 +1157,6 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
       if (state.paused || !state.active) {
         return this;
       }
-
       state.paused = true;
       removeListeners();
       return this;
@@ -1253,7 +1165,6 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
       if (!state.paused || !state.active) {
         return this;
       }
-
       state.paused = false;
       updateTabbableNodes();
       addListeners();
@@ -1264,15 +1175,14 @@ var createFocusTrap = function createFocusTrap(elements, userOptions) {
       state.containers = elementsAsArray.map(function (element) {
         return typeof element === 'string' ? doc.querySelector(element) : element;
       });
-
       if (state.active) {
         updateTabbableNodes();
       }
-
       return this;
     }
-  }; // initialize container elements
+  };
 
+  // initialize container elements
   trap.updateContainerElements(elements);
   return trap;
 };