@royaloperahouse/harmonic 0.13.2-d → 0.13.3-a

package/dist/harmonic.esm.js

@@ -3735,6 +3735,7 @@ var Tab = function Tab(_ref) {
     ariaLabel = _ref.ariaLabel,
     tabLinkId = _ref.tabLinkId,
     color = _ref.color,
+    dataTestId = _ref.dataTestId,
     isOpen = _ref.isOpen;
   var clickHandler = function clickHandler() {
     if (onClick) {
@@ -3764,7 +3765,8 @@ var Tab = function Tab(_ref) {
     onFocus: onFocusHandler,
     onKeyDown: onKeyDownHandler,
     tabIndex: 0,
-    className: className
+    className: className,
+    "data-testid": dataTestId
   }, /*#__PURE__*/React__default.createElement(TabText, {
     id: tabLinkId,
     trimText: trimText,
@@ -10594,11 +10596,27 @@ var AnchorBar = function AnchorBar(_ref) {
 
 var _templateObject$1e, _templateObject2$Y;
 var FocusableTab = /*#__PURE__*/styled(Tab)(_templateObject$1e || (_templateObject$1e = /*#__PURE__*/_taggedTemplateLiteralLoose(["\n  ", "\n  &:not(:active):not(:focus) {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    margin: 0;\n    padding: 0;\n    overflow: hidden;\n    clip: rect(0 0 0 0);\n    clip-path: inset(50%);\n    border: 0;\n    white-space: nowrap;\n    user-select: none;\n  }\n\n  @media ", " {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    margin: 0;\n    padding: 0;\n    overflow: hidden;\n    clip: rect(0 0 0 0);\n    clip-path: inset(50%);\n    border: 0;\n    white-space: nowrap;\n    user-select: none;\n  }\n"])), function (_ref) {
-  var $hide = _ref.$hide;
-  return $hide && "\n    display: none;\n  ";
+  var hide = _ref.hide;
+  return hide && "display: none;";
 }, devices.mobileAndTablet);
 var HiddenBlock = /*#__PURE__*/styled.div(_templateObject2$Y || (_templateObject2$Y = /*#__PURE__*/_taggedTemplateLiteralLoose(["\n  padding: 29px 50px;\n  display: inline-block;\n  width: 100%;\n  height: fit-content;\n  border-bottom: solid 2px gray;\n  overflow: hidden;\n  &:not(:has(div:focus)) {\n    border-bottom: 0;\n  }\n  @media ", " {\n    border-bottom: 0;\n  }\n"])), devices.mobileAndTablet);
 
+/**
+ * An accessible component which allows Assistive Technology users to move the focus
+ * to main content, skipping the Nav bar. On desktop, it will remain invisible until focused.
+ * On mobile, it will remain invisible even when focused.
+ *
+ * It's default functionality is to skip to the <main> tag.
+ * However, skipToId may be passed as a prop to target any element with corresponding id.
+ * If neither of those is found in the document, the component will be hidden and not focusable.
+ *
+ * To prevent SSR errors, the component will return `null` when document object is undefined.
+ * In practice, testing reveals that this component renders correctly on most SSR'd pages,
+ * but this check serves as an additional safeguard.
+ *
+ * @param skipToId - an optional id of the element to be skipped to, instead of the default <main> tag target.
+ * @returns JSX.Element | null
+ */
 var SkipToMain = function SkipToMain(_ref) {
   var skipToId = _ref.skipToId;
   var _useState = useState(null),
@@ -10606,21 +10624,43 @@ var SkipToMain = function SkipToMain(_ref) {
     setTargetElement = _useState[1];
   if (typeof document === 'undefined') return null;
   useEffect(function () {
+    var observer = null;
+    var timeoutId;
+    var stopObserving = function stopObserving() {
+      if (observer) {
+        observer.disconnect();
+        observer = null;
+      }
+      clearTimeout(timeoutId);
+    };
     var checkForTarget = function checkForTarget() {
-      var element = document.getElementById(skipToId != null ? skipToId : '');
-      if (!element) {
-        element = document.querySelector('main');
+      var _document$getElementB;
+      var element = (_document$getElementB = document.getElementById(skipToId != null ? skipToId : '')) != null ? _document$getElementB : document.querySelector('main');
+      if (element) {
+        setTargetElement(element);
+        if (observer) {
+          observer.disconnect();
+          observer = null;
+        }
       }
-      setTargetElement(element);
     };
     checkForTarget();
-    var observer = new MutationObserver(checkForTarget);
-    observer.observe(document.body, {
-      childList: true,
-      subtree: true
-    });
+    // NOTE: Potential performance degradation risk from observing the whole document.
+    // Partially mitigated by conditional connecting/disconnecting of observer and the timeout.
+    if (!targetElement) {
+      observer = new MutationObserver(checkForTarget);
+      observer.observe(document.body, {
+        childList: true,
+        subtree: true
+      });
+      var timeoutDuration = 60000;
+      timeoutId = setTimeout(function () {
+        console.warn("SkipToMain: Target element with id \"" + skipToId + "\" not found after " + timeoutDuration / 1000 + " seconds. Stopping observation.");
+        stopObserving();
+      }, timeoutDuration);
+    }
     return function () {
-      return observer.disconnect();
+      stopObserving();
     };
   }, []);
   var clickHandler = function clickHandler() {
@@ -10644,9 +10684,10 @@ var SkipToMain = function SkipToMain(_ref) {
     withIcon: "none",
     title: "Skip to main content",
     onClick: clickHandler,
-    "$hide": !targetElement,
+    hide: !targetElement,
     ariaLabel: "Skip to main content, in-page",
-    role: "link"
+    role: "link",
+    dataTestId: "skip-to-main-button"
   }));
 };