@react-aria/landmark 3.0.0-alpha.5 → 3.0.0-alpha.6

package/dist/module.js

@@ -1,6 +1,7 @@
 import $TvsbU$swchelperssrc_define_propertymjs from "@swc/helpers/src/_define_property.mjs";
 import {useState as $TvsbU$useState, useCallback as $TvsbU$useCallback, useEffect as $TvsbU$useEffect} from "react";
 import {useLayoutEffect as $TvsbU$useLayoutEffect} from "@react-aria/utils";
+import {useSyncExternalStore as $TvsbU$useSyncExternalStore} from "use-sync-external-store/shim";
 
 /*
  * Copyright 2022 Adobe. All rights reserved.
@@ -25,12 +26,33 @@ import {useLayoutEffect as $TvsbU$useLayoutEffect} from "@react-aria/utils";
  */ 
 
 
+
+// Increment this version number whenever the
+// LandmarkManagerApi or Landmark interfaces change.
+const $a86207c5d7f7e1fb$var$LANDMARK_API_VERSION = 1;
+// Symbol under which the singleton landmark manager instance is attached to the document.
+const $a86207c5d7f7e1fb$var$landmarkSymbol = Symbol.for("react-aria-landmark-manager");
+function $a86207c5d7f7e1fb$var$subscribe(fn) {
+    document.addEventListener("react-aria-landmark-manager-change", fn);
+    return ()=>document.removeEventListener("react-aria-landmark-manager-change", fn);
+}
+function $a86207c5d7f7e1fb$var$getLandmarkManager() {
+    // Reuse an existing instance if it has the same or greater version.
+    let instance = document[$a86207c5d7f7e1fb$var$landmarkSymbol];
+    if (instance && instance.version >= $a86207c5d7f7e1fb$var$LANDMARK_API_VERSION) return instance;
+    // Otherwise, create a new instance and dispatch an event so anything using the existing
+    // instance updates and re-registers their landmarks with the new one.
+    document[$a86207c5d7f7e1fb$var$landmarkSymbol] = new $a86207c5d7f7e1fb$var$LandmarkManager();
+    document.dispatchEvent(new CustomEvent("react-aria-landmark-manager-change"));
+    return document[$a86207c5d7f7e1fb$var$landmarkSymbol];
+}
+// Subscribes a React component to the current landmark manager instance.
+function $a86207c5d7f7e1fb$var$useLandmarkManager() {
+    return (0, $TvsbU$useSyncExternalStore)($a86207c5d7f7e1fb$var$subscribe, $a86207c5d7f7e1fb$var$getLandmarkManager);
+}
 class $a86207c5d7f7e1fb$var$LandmarkManager {
-    static getInstance() {
-        if (!$a86207c5d7f7e1fb$var$LandmarkManager.instance) $a86207c5d7f7e1fb$var$LandmarkManager.instance = new $a86207c5d7f7e1fb$var$LandmarkManager();
-        return $a86207c5d7f7e1fb$var$LandmarkManager.instance;
-    }
-    setup() {
+    setupIfNeeded() {
+        if (this.isListening) return;
         document.addEventListener("keydown", this.f6Handler, {
             capture: true
         });
@@ -42,7 +64,8 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
         });
         this.isListening = true;
     }
-    teardown() {
+    teardownIfNeeded() {
+        if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) return;
         document.removeEventListener("keydown", this.f6Handler, {
             capture: true
         });
@@ -54,9 +77,9 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
         });
         this.isListening = false;
     }
-    focusLandmark(landmark) {
+    focusLandmark(landmark, direction) {
         var _this_landmarks_find;
-        (_this_landmarks_find = this.landmarks.find((l)=>l.ref.current === landmark)) === null || _this_landmarks_find === void 0 ? void 0 : _this_landmarks_find.focus();
+        (_this_landmarks_find = this.landmarks.find((l)=>l.ref.current === landmark)) === null || _this_landmarks_find === void 0 ? void 0 : _this_landmarks_find.focus(direction);
     }
     /**
    * Return set of landmarks with a specific role.
@@ -69,13 +92,14 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
         return this.landmarks.find((l)=>l.role === role);
     }
     addLandmark(newLandmark) {
-        if (!this.isListening) this.setup();
+        this.setupIfNeeded();
         if (this.landmarks.find((landmark)=>landmark.ref === newLandmark.ref)) return;
         if (this.landmarks.filter((landmark)=>landmark.role === "main").length > 1) console.error('Page can contain no more than one landmark with the role "main".');
         if (this.landmarks.length === 0) {
             this.landmarks = [
                 newLandmark
             ];
+            this.checkLabels(newLandmark.role);
             return;
         }
         // Binary search to insert new landmark based on position in document relative to existing landmarks.
@@ -90,6 +114,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
             else end = mid - 1;
         }
         this.landmarks.splice(start, 0, newLandmark);
+        this.checkLabels(newLandmark.role);
     }
     updateLandmark(landmark) {
         let index = this.landmarks.findIndex((l)=>l.ref === landmark.ref);
@@ -103,7 +128,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
     }
     removeLandmark(ref) {
         this.landmarks = this.landmarks.filter((landmark)=>landmark.ref !== ref);
-        if (this.landmarks.length === 0) this.teardown();
+        this.teardownIfNeeded();
     }
     /**
    * Warn if there are 2+ landmarks with the same role but no label.
@@ -139,7 +164,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
                 l
             ]));
         let currentElement = element;
-        while(!landmarkMap.has(currentElement) && currentElement !== document.body)currentElement = currentElement.parentElement;
+        while(currentElement && !landmarkMap.has(currentElement) && currentElement !== document.body)currentElement = currentElement.parentElement;
         return landmarkMap.get(currentElement);
     }
     /**
@@ -148,13 +173,42 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
    * If not inside a landmark, will return first landmark.
    * Returns undefined if there are no landmarks.
    */ getNextLandmark(element, { backward: backward  }) {
-        if (this.landmarks.length === 0) return undefined;
         let currentLandmark = this.closestLandmark(element);
-        let nextLandmarkIndex = backward ? -1 : 0;
-        if (currentLandmark) nextLandmarkIndex = this.landmarks.findIndex((landmark)=>landmark === currentLandmark) + (backward ? -1 : 1);
-        // Wrap if necessary
-        if (nextLandmarkIndex < 0) nextLandmarkIndex = this.landmarks.length - 1;
-        else if (nextLandmarkIndex >= this.landmarks.length) nextLandmarkIndex = 0;
+        let nextLandmarkIndex = backward ? this.landmarks.length - 1 : 0;
+        if (currentLandmark) nextLandmarkIndex = this.landmarks.indexOf(currentLandmark) + (backward ? -1 : 1);
+        let wrapIfNeeded = ()=>{
+            // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.
+            // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.
+            if (nextLandmarkIndex < 0) {
+                if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
+                    detail: {
+                        direction: "backward"
+                    },
+                    bubbles: true,
+                    cancelable: true
+                }))) return true;
+                nextLandmarkIndex = this.landmarks.length - 1;
+            } else if (nextLandmarkIndex >= this.landmarks.length) {
+                if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
+                    detail: {
+                        direction: "forward"
+                    },
+                    bubbles: true,
+                    cancelable: true
+                }))) return true;
+                nextLandmarkIndex = 0;
+            }
+            if (nextLandmarkIndex < 0 || nextLandmarkIndex >= this.landmarks.length) return true;
+            return false;
+        };
+        if (wrapIfNeeded()) return undefined;
+        // Skip over hidden landmarks.
+        let i = nextLandmarkIndex;
+        while(this.landmarks[nextLandmarkIndex].ref.current.closest("[aria-hidden=true]")){
+            nextLandmarkIndex += backward ? -1 : 1;
+            if (wrapIfNeeded()) return undefined;
+            if (nextLandmarkIndex === i) break;
+        }
         return this.landmarks[nextLandmarkIndex];
     }
     /**
@@ -163,31 +217,41 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
    * If no landmarks at all, or none with focusable elements, don't move focus.
    */ f6Handler(e) {
         if (e.key === "F6") {
-            e.preventDefault();
-            e.stopPropagation();
-            let backward = e.shiftKey;
-            let nextLandmark = this.getNextLandmark(e.target, {
-                backward: backward
-            });
-            // If no landmarks, return
-            if (!nextLandmark) return;
-            // If alt key pressed, focus main landmark
-            if (e.altKey) {
-                let main = this.getLandmarkByRole("main");
-                if (main && document.contains(main.ref.current)) this.focusLandmark(main.ref.current);
-                return;
+            // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.
+            let handled = e.altKey ? this.focusMain() : this.navigate(e.target, e.shiftKey);
+            if (handled) {
+                e.preventDefault();
+                e.stopPropagation();
             }
-            // If something was previously focused in the next landmark, then return focus to it
-            if (nextLandmark.lastFocused) {
-                let lastFocused = nextLandmark.lastFocused;
-                if (document.body.contains(lastFocused)) {
-                    lastFocused.focus();
-                    return;
-                }
+        }
+    }
+    focusMain() {
+        let main = this.getLandmarkByRole("main");
+        if (main && document.contains(main.ref.current)) {
+            this.focusLandmark(main.ref.current, "forward");
+            return true;
+        }
+        return false;
+    }
+    navigate(from, backward) {
+        let nextLandmark = this.getNextLandmark(from, {
+            backward: backward
+        });
+        if (!nextLandmark) return false;
+        // If something was previously focused in the next landmark, then return focus to it
+        if (nextLandmark.lastFocused) {
+            let lastFocused = nextLandmark.lastFocused;
+            if (document.body.contains(lastFocused)) {
+                lastFocused.focus();
+                return true;
             }
-            // Otherwise, focus the landmark itself
-            if (document.contains(nextLandmark.ref.current)) this.focusLandmark(nextLandmark.ref.current);
         }
+        // Otherwise, focus the landmark itself
+        if (document.contains(nextLandmark.ref.current)) {
+            this.focusLandmark(nextLandmark.ref.current, backward ? "backward" : "forward");
+            return true;
+        }
+        return false;
     }
     /**
    * Sets lastFocused for a landmark, if focus is moved within that landmark.
@@ -216,20 +280,84 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
             if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) closestPreviousLandmark.blur();
         }
     }
+    createLandmarkController() {
+        let instance = this;
+        instance.refCount++;
+        instance.setupIfNeeded();
+        return {
+            navigate (direction, opts) {
+                return instance.navigate((opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement, direction === "backward");
+            },
+            focusNext (opts) {
+                return instance.navigate((opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement, false);
+            },
+            focusPrevious (opts) {
+                return instance.navigate((opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement, true);
+            },
+            focusMain () {
+                return instance.focusMain();
+            },
+            dispose () {
+                instance.refCount--;
+                instance.teardownIfNeeded();
+                instance = null;
+            }
+        };
+    }
+    registerLandmark(landmark) {
+        if (this.landmarks.find((l)=>l.ref === landmark.ref)) this.updateLandmark(landmark);
+        else this.addLandmark(landmark);
+        return ()=>this.removeLandmark(landmark.ref);
+    }
     constructor(){
         (0, $TvsbU$swchelperssrc_define_propertymjs)(this, "landmarks", []);
         (0, $TvsbU$swchelperssrc_define_propertymjs)(this, "isListening", false);
+        (0, $TvsbU$swchelperssrc_define_propertymjs)(this, "refCount", 0);
+        (0, $TvsbU$swchelperssrc_define_propertymjs)(this, "version", $a86207c5d7f7e1fb$var$LANDMARK_API_VERSION);
         this.f6Handler = this.f6Handler.bind(this);
         this.focusinHandler = this.focusinHandler.bind(this);
         this.focusoutHandler = this.focusoutHandler.bind(this);
     }
 }
+function $a86207c5d7f7e1fb$export$f50151dbd51cd1d9() {
+    // Get the current landmark manager and create a controller using it.
+    let instance = $a86207c5d7f7e1fb$var$getLandmarkManager();
+    let controller = instance.createLandmarkController();
+    let unsubscribe = $a86207c5d7f7e1fb$var$subscribe(()=>{
+        // If the landmark manager changes, dispose the old
+        // controller and create a new one.
+        controller.dispose();
+        instance = $a86207c5d7f7e1fb$var$getLandmarkManager();
+        controller = instance.createLandmarkController();
+    });
+    // Return a wrapper that proxies requests to the current controller instance.
+    return {
+        navigate (direction, opts) {
+            return controller.navigate(direction, opts);
+        },
+        focusNext (opts) {
+            return controller.focusNext(opts);
+        },
+        focusPrevious (opts) {
+            return controller.focusPrevious(opts);
+        },
+        focusMain () {
+            return controller.focusMain();
+        },
+        dispose () {
+            controller.dispose();
+            unsubscribe();
+            controller = null;
+            instance = null;
+        }
+    };
+}
 function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
-    const { role: role , "aria-label": ariaLabel , "aria-labelledby": ariaLabelledby  } = props;
-    let manager = $a86207c5d7f7e1fb$var$LandmarkManager.getInstance();
+    const { role: role , "aria-label": ariaLabel , "aria-labelledby": ariaLabelledby , focus: focus  } = props;
+    let manager = $a86207c5d7f7e1fb$var$useLandmarkManager();
     let label = ariaLabel || ariaLabelledby;
     let [isLandmarkFocused, setIsLandmarkFocused] = (0, $TvsbU$useState)(false);
-    let focus = (0, $TvsbU$useCallback)(()=>{
+    let defaultFocus = (0, $TvsbU$useCallback)(()=>{
         setIsLandmarkFocused(true);
     }, [
         setIsLandmarkFocused
@@ -240,31 +368,21 @@ function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
         setIsLandmarkFocused
     ]);
     (0, $TvsbU$useLayoutEffect)(()=>{
-        manager.addLandmark({
-            ref: ref,
-            role: role,
-            label: label,
-            focus: focus,
-            blur: blur
-        });
-        return ()=>{
-            manager.removeLandmark(ref);
-        };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
-    (0, $TvsbU$useLayoutEffect)(()=>{
-        manager.updateLandmark({
+        return manager.registerLandmark({
             ref: ref,
             label: label,
             role: role,
-            focus: focus,
+            focus: focus || defaultFocus,
             blur: blur
         });
-    // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [
+        manager,
         label,
         ref,
-        role
+        role,
+        focus,
+        defaultFocus,
+        blur
     ]);
     (0, $TvsbU$useEffect)(()=>{
         if (isLandmarkFocused) ref.current.focus();
@@ -275,7 +393,9 @@ function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
     return {
         landmarkProps: {
             role: role,
-            tabIndex: isLandmarkFocused ? -1 : undefined
+            tabIndex: isLandmarkFocused ? -1 : undefined,
+            "aria-label": ariaLabel,
+            "aria-labelledby": ariaLabelledby
         }
     };
 }
@@ -283,5 +403,5 @@ function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
 
 
 
-export {$a86207c5d7f7e1fb$export$4cc632584fd87fae as useLandmark};
+export {$a86207c5d7f7e1fb$export$4cc632584fd87fae as useLandmark, $a86207c5d7f7e1fb$export$f50151dbd51cd1d9 as createLandmarkController};
 //# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -1 +1 @@
-{"mappings":"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","sources":["packages/@react-aria/landmark/src/index.ts","packages/@react-aria/landmark/src/useLandmark.ts"],"sourcesContent":["/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria} from './useLandmark';\nexport {useLandmark} from './useLandmark';\n","/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaLabelingProps, DOMAttributes, FocusableElement} from '@react-types/shared';\nimport {MutableRefObject, useCallback, useEffect, useState} from 'react';\nimport {useLayoutEffect} from '@react-aria/utils';\n\nexport type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';\n\nexport interface AriaLandmarkProps extends AriaLabelingProps {\n  role: AriaLandmarkRole\n}\n\nexport interface LandmarkAria {\n  landmarkProps: DOMAttributes\n}\n\ntype Landmark = {\n  ref: MutableRefObject<Element>,\n  role: AriaLandmarkRole,\n  label?: string,\n  lastFocused?: FocusableElement,\n  focus: () => void,\n  blur: () => void\n};\n\nclass LandmarkManager {\n  private landmarks: Array<Landmark> = [];\n  private static instance: LandmarkManager;\n  private isListening = false;\n\n  private constructor() {\n    this.f6Handler = this.f6Handler.bind(this);\n    this.focusinHandler = this.focusinHandler.bind(this);\n    this.focusoutHandler = this.focusoutHandler.bind(this);\n  }\n\n  public static getInstance(): LandmarkManager {\n    if (!LandmarkManager.instance) {\n      LandmarkManager.instance = new LandmarkManager();\n    }\n\n    return LandmarkManager.instance;\n  }\n\n  private setup() {\n    document.addEventListener('keydown', this.f6Handler, {capture: true});\n    document.addEventListener('focusin', this.focusinHandler, {capture: true});\n    document.addEventListener('focusout', this.focusoutHandler, {capture: true});\n    this.isListening = true;\n  }\n\n  private teardown() {\n    document.removeEventListener('keydown', this.f6Handler, {capture: true});\n    document.removeEventListener('focusin', this.focusinHandler, {capture: true});\n    document.removeEventListener('focusout', this.focusoutHandler, {capture: true});\n    this.isListening = false;\n  }\n\n  private focusLandmark(landmark: Element) {\n    this.landmarks.find(l => l.ref.current === landmark)?.focus();\n  }\n\n  /**\n   * Return set of landmarks with a specific role.\n   */\n  public getLandmarksByRole(role: AriaLandmarkRole) {\n    return new Set(this.landmarks.filter(l => l.role === role));\n  }\n\n  /**\n   * Return first landmark with a specific role.\n   */\n  public getLandmarkByRole(role: AriaLandmarkRole) {\n    return this.landmarks.find(l => l.role === role);\n  }\n\n  public addLandmark(newLandmark: Landmark) {\n    if (!this.isListening) {\n      this.setup();\n    }\n    if (this.landmarks.find(landmark => landmark.ref === newLandmark.ref)) {\n      return;\n    }\n\n    if (this.landmarks.filter(landmark => landmark.role === 'main').length > 1) {\n      console.error('Page can contain no more than one landmark with the role \"main\".');\n    }\n\n    if (this.landmarks.length === 0) {\n      this.landmarks = [newLandmark];\n      return;\n    }\n\n\n    // Binary search to insert new landmark based on position in document relative to existing landmarks.\n    // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition\n    let start = 0;\n    let end = this.landmarks.length - 1;\n    while (start <= end) {\n      let mid = Math.floor((start + end) / 2);\n      let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current as Node);\n      let isNewAfterExisting = Boolean((comparedPosition & Node.DOCUMENT_POSITION_PRECEDING) || (comparedPosition & Node.DOCUMENT_POSITION_CONTAINS));\n\n      if (isNewAfterExisting) {\n        start = mid + 1;\n      } else {\n        end = mid - 1;\n      }\n    }\n\n    this.landmarks.splice(start, 0, newLandmark);\n  }\n\n  public updateLandmark(landmark: Pick<Landmark, 'ref'> & Partial<Landmark>) {\n    let index = this.landmarks.findIndex(l => l.ref === landmark.ref);\n    if (index >= 0) {\n      this.landmarks[index] = {...this.landmarks[index], ...landmark};\n      this.checkLabels(this.landmarks[index].role);\n    }\n  }\n\n  public removeLandmark(ref: MutableRefObject<Element>) {\n    this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);\n    if (this.landmarks.length === 0) {\n      this.teardown();\n    }\n  }\n\n  /**\n   * Warn if there are 2+ landmarks with the same role but no label.\n   * Labels for landmarks with the same role must also be unique.\n   *\n   * See https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/.\n   */\n  private checkLabels(role: AriaLandmarkRole) {\n    let landmarksWithRole = this.getLandmarksByRole(role);\n    if (landmarksWithRole.size > 1) {\n      let duplicatesWithoutLabel = [...landmarksWithRole].filter(landmark => !landmark.label);\n      if (duplicatesWithoutLabel.length > 0) {\n        console.warn(\n          `Page contains more than one landmark with the '${role}' role. If two or more landmarks on a page share the same role, all must be labeled with an aria-label or aria-labelledby attribute: `,\n          duplicatesWithoutLabel.map(landmark => landmark.ref.current)\n        );\n      } else {\n        let labels = [...landmarksWithRole].map(landmark => landmark.label);\n        let duplicateLabels = labels.filter((item, index) => labels.indexOf(item) !== index);\n\n        duplicateLabels.forEach((label) => {\n          console.warn(\n            `Page contains more than one landmark with the '${role}' role and '${label}' label. If two or more landmarks on a page share the same role, they must have unique labels: `,\n            [...landmarksWithRole].filter(landmark => landmark.label === label).map(landmark => landmark.ref.current)\n          );\n        });\n      }\n    }\n  }\n\n  /**\n   * Get the landmark that is the closest parent in the DOM.\n   * Returns undefined if no parent is a landmark.\n   */\n  private closestLandmark(element: Element) {\n    let landmarkMap = new Map(this.landmarks.map(l => [l.ref.current, l]));\n    let currentElement = element;\n    while (!landmarkMap.has(currentElement) && currentElement !== document.body) {\n      currentElement = currentElement.parentElement;\n    }\n    return landmarkMap.get(currentElement);\n  }\n\n  /**\n   * Gets the next landmark, in DOM focus order, or previous if backwards is specified.\n   * If last landmark, next should be the first landmark.\n   * If not inside a landmark, will return first landmark.\n   * Returns undefined if there are no landmarks.\n   */\n  public getNextLandmark(element: Element, {backward}: {backward?: boolean }) {\n    if (this.landmarks.length === 0) {\n      return undefined;\n    }\n\n    let currentLandmark = this.closestLandmark(element);\n    let nextLandmarkIndex = backward ? -1 : 0;\n    if (currentLandmark) {\n      nextLandmarkIndex = this.landmarks.findIndex(landmark => landmark === currentLandmark) + (backward ? -1 : 1);\n    }\n\n    // Wrap if necessary\n    if (nextLandmarkIndex < 0) {\n      nextLandmarkIndex = this.landmarks.length - 1;\n    } else if (nextLandmarkIndex >= this.landmarks.length) {\n      nextLandmarkIndex = 0;\n    }\n\n    return this.landmarks[nextLandmarkIndex];\n  }\n\n  /**\n   * Look at next landmark. If an element was previously focused inside, restore focus there.\n   * If not, focus the landmark itself.\n   * If no landmarks at all, or none with focusable elements, don't move focus.\n   */\n  public f6Handler(e: KeyboardEvent) {\n    if (e.key === 'F6') {\n      e.preventDefault();\n      e.stopPropagation();\n\n      let backward = e.shiftKey;\n      let nextLandmark = this.getNextLandmark(e.target as Element, {backward});\n\n      // If no landmarks, return\n      if (!nextLandmark) {\n        return;\n      }\n\n      // If alt key pressed, focus main landmark\n      if (e.altKey) {\n        let main = this.getLandmarkByRole('main');\n        if (main && document.contains(main.ref.current)) {\n          this.focusLandmark(main.ref.current);\n        }\n        return;\n      }\n\n      // If something was previously focused in the next landmark, then return focus to it\n      if (nextLandmark.lastFocused) {\n        let lastFocused = nextLandmark.lastFocused;\n        if (document.body.contains(lastFocused)) {\n          lastFocused.focus();\n          return;\n        }\n      }\n\n      // Otherwise, focus the landmark itself\n      if (document.contains(nextLandmark.ref.current)) {\n        this.focusLandmark(nextLandmark.ref.current);\n      }\n    }\n  }\n\n  /**\n   * Sets lastFocused for a landmark, if focus is moved within that landmark.\n   * Lets the last focused landmark know it was blurred if something else is focused.\n   */\n  public focusinHandler(e: FocusEvent) {\n    let currentLandmark = this.closestLandmark(e.target as Element);\n    if (currentLandmark && currentLandmark.ref.current !== e.target) {\n      this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as FocusableElement});\n    }\n    let previousFocusedElement = e.relatedTarget as Element;\n    if (previousFocusedElement) {\n      let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n      if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n        closestPreviousLandmark.blur();\n      }\n    }\n  }\n\n  /**\n   * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.\n   */\n  public focusoutHandler(e: FocusEvent) {\n    let previousFocusedElement = e.target as Element;\n    let nextFocusedElement = e.relatedTarget;\n    // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();\n    // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens\n    if (!nextFocusedElement || nextFocusedElement === document) {\n      let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n      if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n        closestPreviousLandmark.blur();\n      }\n    }\n  }\n}\n\n/**\n * Provides landmark navigation in an application. Call this with a role and label to register a landmark navigable with F6.\n * @param props - Props for the landmark.\n * @param ref - Ref to the landmark.\n */\nexport function useLandmark(props: AriaLandmarkProps, ref: MutableRefObject<FocusableElement>): LandmarkAria {\n  const {\n    role,\n    'aria-label': ariaLabel,\n    'aria-labelledby': ariaLabelledby\n  } = props;\n  let manager = LandmarkManager.getInstance();\n  let label = ariaLabel || ariaLabelledby;\n  let [isLandmarkFocused, setIsLandmarkFocused] = useState(false);\n\n  let focus = useCallback(() => {\n    setIsLandmarkFocused(true);\n  }, [setIsLandmarkFocused]);\n\n  let blur = useCallback(() => {\n    setIsLandmarkFocused(false);\n  }, [setIsLandmarkFocused]);\n\n  useLayoutEffect(() => {\n    manager.addLandmark({ref, role, label, focus, blur});\n\n    return () => {\n      manager.removeLandmark(ref);\n    };\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  useLayoutEffect(() => {\n    manager.updateLandmark({ref, label, role, focus, blur});\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [label, ref, role]);\n\n  useEffect(() => {\n    if (isLandmarkFocused) {\n      ref.current.focus();\n    }\n  }, [isLandmarkFocused, ref]);\n\n  return {\n    landmarkProps: {\n      role,\n      tabIndex: isLandmarkFocused ? -1 : undefined\n    }\n  };\n}\n"],"names":[],"version":3,"file":"module.js.map"}
+{"mappings":"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","sources":["packages/@react-aria/landmark/src/index.ts","packages/@react-aria/landmark/src/useLandmark.ts"],"sourcesContent":["/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria, LandmarkController} from './useLandmark';\nexport {useLandmark, createLandmarkController} from './useLandmark';\n","/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaLabelingProps, DOMAttributes, FocusableElement} from '@react-types/shared';\nimport {MutableRefObject, useCallback, useEffect, useState} from 'react';\nimport {useLayoutEffect} from '@react-aria/utils';\nimport {useSyncExternalStore} from 'use-sync-external-store/shim';\n\nexport type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';\n\nexport interface AriaLandmarkProps extends AriaLabelingProps {\n  role: AriaLandmarkRole,\n  focus?: (direction: 'forward' | 'backward') => void\n}\n\nexport interface LandmarkAria {\n  landmarkProps: DOMAttributes\n}\n\n// Increment this version number whenever the\n// LandmarkManagerApi or Landmark interfaces change.\nconst LANDMARK_API_VERSION = 1;\n\n// Minimal API for LandmarkManager that must continue to work between versions.\n// Changes to this interface are considered breaking. New methods/properties are\n// safe to add, but changes or removals are not allowed (same as public APIs).\ninterface LandmarkManagerApi {\n  version: number,\n  createLandmarkController(): LandmarkController,\n  registerLandmark(landmark: Landmark): () => void\n}\n\n// Changes to this interface are considered breaking.\n// New properties MUST be optional so that registering a landmark\n// from an older version of useLandmark against a newer version of\n// LandmarkManager does not crash.\ninterface Landmark {\n  ref: MutableRefObject<Element>,\n  role: AriaLandmarkRole,\n  label?: string,\n  lastFocused?: FocusableElement,\n  focus: (direction: 'forward' | 'backward') => void,\n  blur: () => void\n}\n\nexport interface LandmarkControllerOptions {\n  /**\n   * The element from which to start navigating.\n   * @default document.activeElement\n   */\n  from?: Element\n}\n\n/** A LandmarkController allows programmatic navigation of landmarks. */\nexport interface LandmarkController {\n  /** Moves focus to the next landmark. */\n  focusNext(opts?: LandmarkControllerOptions): boolean,\n  /** Moves focus to the previous landmark. */\n  focusPrevious(opts?: LandmarkControllerOptions): boolean,\n  /** Moves focus to the main landmark. */\n  focusMain(): boolean,\n  /** Moves focus either forward or backward in the landmark sequence. */\n  navigate(direction: 'forward' | 'backward', opts?: LandmarkControllerOptions): boolean,\n  /**\n   * Disposes the landmark controller. When no landmarks are registered, and no\n   * controllers are active, the landmark keyboard listeners are removed from the page.\n   */\n  dispose(): void\n}\n\n// Symbol under which the singleton landmark manager instance is attached to the document.\nconst landmarkSymbol = Symbol.for('react-aria-landmark-manager');\n\nfunction subscribe(fn: () => void) {\n  document.addEventListener('react-aria-landmark-manager-change', fn);\n  return () => document.removeEventListener('react-aria-landmark-manager-change', fn);\n}\n\nfunction getLandmarkManager(): LandmarkManagerApi {\n  // Reuse an existing instance if it has the same or greater version.\n  let instance = document[landmarkSymbol];\n  if (instance && instance.version >= LANDMARK_API_VERSION) {\n    return instance;\n  }\n\n  // Otherwise, create a new instance and dispatch an event so anything using the existing\n  // instance updates and re-registers their landmarks with the new one.\n  document[landmarkSymbol] = new LandmarkManager();\n  document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));\n  return document[landmarkSymbol];\n}\n\n// Subscribes a React component to the current landmark manager instance.\nfunction useLandmarkManager(): LandmarkManagerApi {\n  return useSyncExternalStore(subscribe, getLandmarkManager);\n}\n\nclass LandmarkManager implements LandmarkManagerApi {\n  private landmarks: Array<Landmark> = [];\n  private isListening = false;\n  private refCount = 0;\n  public version = LANDMARK_API_VERSION;\n\n  constructor() {\n    this.f6Handler = this.f6Handler.bind(this);\n    this.focusinHandler = this.focusinHandler.bind(this);\n    this.focusoutHandler = this.focusoutHandler.bind(this);\n  }\n\n  private setupIfNeeded() {\n    if (this.isListening) {\n      return;\n    }\n    document.addEventListener('keydown', this.f6Handler, {capture: true});\n    document.addEventListener('focusin', this.focusinHandler, {capture: true});\n    document.addEventListener('focusout', this.focusoutHandler, {capture: true});\n    this.isListening = true;\n  }\n\n  private teardownIfNeeded() {\n    if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) {\n      return;\n    }\n    document.removeEventListener('keydown', this.f6Handler, {capture: true});\n    document.removeEventListener('focusin', this.focusinHandler, {capture: true});\n    document.removeEventListener('focusout', this.focusoutHandler, {capture: true});\n    this.isListening = false;\n  }\n\n  private focusLandmark(landmark: Element, direction: 'forward' | 'backward') {\n    this.landmarks.find(l => l.ref.current === landmark)?.focus(direction);\n  }\n\n  /**\n   * Return set of landmarks with a specific role.\n   */\n  private getLandmarksByRole(role: AriaLandmarkRole) {\n    return new Set(this.landmarks.filter(l => l.role === role));\n  }\n\n  /**\n   * Return first landmark with a specific role.\n   */\n  private getLandmarkByRole(role: AriaLandmarkRole) {\n    return this.landmarks.find(l => l.role === role);\n  }\n\n  private addLandmark(newLandmark: Landmark) {\n    this.setupIfNeeded();\n    if (this.landmarks.find(landmark => landmark.ref === newLandmark.ref)) {\n      return;\n    }\n\n    if (this.landmarks.filter(landmark => landmark.role === 'main').length > 1) {\n      console.error('Page can contain no more than one landmark with the role \"main\".');\n    }\n\n    if (this.landmarks.length === 0) {\n      this.landmarks = [newLandmark];\n      this.checkLabels(newLandmark.role);\n      return;\n    }\n\n\n    // Binary search to insert new landmark based on position in document relative to existing landmarks.\n    // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition\n    let start = 0;\n    let end = this.landmarks.length - 1;\n    while (start <= end) {\n      let mid = Math.floor((start + end) / 2);\n      let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current as Node);\n      let isNewAfterExisting = Boolean((comparedPosition & Node.DOCUMENT_POSITION_PRECEDING) || (comparedPosition & Node.DOCUMENT_POSITION_CONTAINS));\n\n      if (isNewAfterExisting) {\n        start = mid + 1;\n      } else {\n        end = mid - 1;\n      }\n    }\n\n    this.landmarks.splice(start, 0, newLandmark);\n    this.checkLabels(newLandmark.role);\n  }\n\n  private updateLandmark(landmark: Pick<Landmark, 'ref'> & Partial<Landmark>) {\n    let index = this.landmarks.findIndex(l => l.ref === landmark.ref);\n    if (index >= 0) {\n      this.landmarks[index] = {...this.landmarks[index], ...landmark};\n      this.checkLabels(this.landmarks[index].role);\n    }\n  }\n\n  private removeLandmark(ref: MutableRefObject<Element>) {\n    this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);\n    this.teardownIfNeeded();\n  }\n\n  /**\n   * Warn if there are 2+ landmarks with the same role but no label.\n   * Labels for landmarks with the same role must also be unique.\n   *\n   * See https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/.\n   */\n  private checkLabels(role: AriaLandmarkRole) {\n    let landmarksWithRole = this.getLandmarksByRole(role);\n    if (landmarksWithRole.size > 1) {\n      let duplicatesWithoutLabel = [...landmarksWithRole].filter(landmark => !landmark.label);\n      if (duplicatesWithoutLabel.length > 0) {\n        console.warn(\n          `Page contains more than one landmark with the '${role}' role. If two or more landmarks on a page share the same role, all must be labeled with an aria-label or aria-labelledby attribute: `,\n          duplicatesWithoutLabel.map(landmark => landmark.ref.current)\n        );\n      } else {\n        let labels = [...landmarksWithRole].map(landmark => landmark.label);\n        let duplicateLabels = labels.filter((item, index) => labels.indexOf(item) !== index);\n\n        duplicateLabels.forEach((label) => {\n          console.warn(\n            `Page contains more than one landmark with the '${role}' role and '${label}' label. If two or more landmarks on a page share the same role, they must have unique labels: `,\n            [...landmarksWithRole].filter(landmark => landmark.label === label).map(landmark => landmark.ref.current)\n          );\n        });\n      }\n    }\n  }\n\n  /**\n   * Get the landmark that is the closest parent in the DOM.\n   * Returns undefined if no parent is a landmark.\n   */\n  private closestLandmark(element: Element) {\n    let landmarkMap = new Map(this.landmarks.map(l => [l.ref.current, l]));\n    let currentElement = element;\n    while (currentElement && !landmarkMap.has(currentElement) && currentElement !== document.body) {\n      currentElement = currentElement.parentElement;\n    }\n    return landmarkMap.get(currentElement);\n  }\n\n  /**\n   * Gets the next landmark, in DOM focus order, or previous if backwards is specified.\n   * If last landmark, next should be the first landmark.\n   * If not inside a landmark, will return first landmark.\n   * Returns undefined if there are no landmarks.\n   */\n  private getNextLandmark(element: Element, {backward}: {backward?: boolean }) {\n    let currentLandmark = this.closestLandmark(element);\n    let nextLandmarkIndex = backward ? this.landmarks.length - 1 : 0;\n    if (currentLandmark) {\n      nextLandmarkIndex = this.landmarks.indexOf(currentLandmark) + (backward ? -1 : 1);\n    }\n\n    let wrapIfNeeded = () => {\n      // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.\n      // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.\n      if (nextLandmarkIndex < 0) {\n        if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'backward'}, bubbles: true, cancelable: true}))) {\n          return true;\n        }\n\n        nextLandmarkIndex = this.landmarks.length - 1;\n      } else if (nextLandmarkIndex >= this.landmarks.length) {\n        if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'forward'}, bubbles: true, cancelable: true}))) {\n          return true;\n        }\n\n        nextLandmarkIndex = 0;\n      }\n\n      if (nextLandmarkIndex < 0 || nextLandmarkIndex >= this.landmarks.length) {\n        return true;\n      }\n\n      return false;\n    };\n\n    if (wrapIfNeeded()) {\n      return undefined;\n    }\n\n    // Skip over hidden landmarks.\n    let i = nextLandmarkIndex;\n    while (this.landmarks[nextLandmarkIndex].ref.current.closest('[aria-hidden=true]')) {\n      nextLandmarkIndex += backward ? -1 : 1;\n      if (wrapIfNeeded()) {\n        return undefined;\n      }\n\n      if (nextLandmarkIndex === i) {\n        break;\n      }\n    }\n\n    return this.landmarks[nextLandmarkIndex];\n  }\n\n  /**\n   * Look at next landmark. If an element was previously focused inside, restore focus there.\n   * If not, focus the landmark itself.\n   * If no landmarks at all, or none with focusable elements, don't move focus.\n   */\n  private f6Handler(e: KeyboardEvent) {\n    if (e.key === 'F6') {\n      // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.\n      let handled = e.altKey ? this.focusMain() : this.navigate(e.target as Element, e.shiftKey);\n      if (handled) {\n        e.preventDefault();\n        e.stopPropagation();\n      }\n    }\n  }\n\n  private focusMain() {\n    let main = this.getLandmarkByRole('main');\n    if (main && document.contains(main.ref.current)) {\n      this.focusLandmark(main.ref.current, 'forward');\n      return true;\n    }\n\n    return false;\n  }\n\n  private navigate(from: Element, backward: boolean) {\n    let nextLandmark = this.getNextLandmark(from, {\n      backward\n    });\n\n    if (!nextLandmark) {\n      return false;\n    }\n\n    // If something was previously focused in the next landmark, then return focus to it\n    if (nextLandmark.lastFocused) {\n      let lastFocused = nextLandmark.lastFocused;\n      if (document.body.contains(lastFocused)) {\n        lastFocused.focus();\n        return true;\n      }\n    }\n\n    // Otherwise, focus the landmark itself\n    if (document.contains(nextLandmark.ref.current)) {\n      this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Sets lastFocused for a landmark, if focus is moved within that landmark.\n   * Lets the last focused landmark know it was blurred if something else is focused.\n   */\n  private focusinHandler(e: FocusEvent) {\n    let currentLandmark = this.closestLandmark(e.target as Element);\n    if (currentLandmark && currentLandmark.ref.current !== e.target) {\n      this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as FocusableElement});\n    }\n    let previousFocusedElement = e.relatedTarget as Element;\n    if (previousFocusedElement) {\n      let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n      if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n        closestPreviousLandmark.blur();\n      }\n    }\n  }\n\n  /**\n   * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.\n   */\n  private focusoutHandler(e: FocusEvent) {\n    let previousFocusedElement = e.target as Element;\n    let nextFocusedElement = e.relatedTarget;\n    // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();\n    // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens\n    if (!nextFocusedElement || nextFocusedElement === document) {\n      let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n      if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n        closestPreviousLandmark.blur();\n      }\n    }\n  }\n\n  public createLandmarkController(): LandmarkController {\n    let instance = this;\n    instance.refCount++;\n    instance.setupIfNeeded();\n    return {\n      navigate(direction, opts) {\n        return instance.navigate(opts?.from || document.activeElement, direction === 'backward');\n      },\n      focusNext(opts) {\n        return instance.navigate(opts?.from || document.activeElement, false);\n      },\n      focusPrevious(opts) {\n        return instance.navigate(opts?.from || document.activeElement, true);\n      },\n      focusMain() {\n        return instance.focusMain();\n      },\n      dispose() {\n        instance.refCount--;\n        instance.teardownIfNeeded();\n        instance = null;\n      }\n    };\n  }\n\n  public registerLandmark(landmark: Landmark): () => void {\n    if (this.landmarks.find(l => l.ref === landmark.ref)) {\n      this.updateLandmark(landmark);\n    } else {\n      this.addLandmark(landmark);\n    }\n\n    return () => this.removeLandmark(landmark.ref);\n  }\n}\n\n/** Creates a LandmarkController, which allows programmatic navigation of landmarks. */\nexport function createLandmarkController(): LandmarkController {\n  // Get the current landmark manager and create a controller using it.\n  let instance = getLandmarkManager();\n  let controller = instance.createLandmarkController();\n\n  let unsubscribe = subscribe(() => {\n    // If the landmark manager changes, dispose the old\n    // controller and create a new one.\n    controller.dispose();\n    instance = getLandmarkManager();\n    controller = instance.createLandmarkController();\n  });\n\n  // Return a wrapper that proxies requests to the current controller instance.\n  return {\n    navigate(direction, opts) {\n      return controller.navigate(direction, opts);\n    },\n    focusNext(opts) {\n      return controller.focusNext(opts);\n    },\n    focusPrevious(opts) {\n      return controller.focusPrevious(opts);\n    },\n    focusMain() {\n      return controller.focusMain();\n    },\n    dispose() {\n      controller.dispose();\n      unsubscribe();\n      controller = null;\n      instance = null;\n    }\n  };\n}\n\n/**\n * Provides landmark navigation in an application. Call this with a role and label to register a landmark navigable with F6.\n * @param props - Props for the landmark.\n * @param ref - Ref to the landmark.\n */\nexport function useLandmark(props: AriaLandmarkProps, ref: MutableRefObject<FocusableElement>): LandmarkAria {\n  const {\n    role,\n    'aria-label': ariaLabel,\n    'aria-labelledby': ariaLabelledby,\n    focus\n  } = props;\n  let manager = useLandmarkManager();\n  let label = ariaLabel || ariaLabelledby;\n  let [isLandmarkFocused, setIsLandmarkFocused] = useState(false);\n\n  let defaultFocus = useCallback(() => {\n    setIsLandmarkFocused(true);\n  }, [setIsLandmarkFocused]);\n\n  let blur = useCallback(() => {\n    setIsLandmarkFocused(false);\n  }, [setIsLandmarkFocused]);\n\n  useLayoutEffect(() => {\n    return manager.registerLandmark({ref, label, role, focus: focus || defaultFocus, blur});\n  }, [manager, label, ref, role, focus, defaultFocus, blur]);\n\n  useEffect(() => {\n    if (isLandmarkFocused) {\n      ref.current.focus();\n    }\n  }, [isLandmarkFocused, ref]);\n\n  return {\n    landmarkProps: {\n      role,\n      tabIndex: isLandmarkFocused ? -1 : undefined,\n      'aria-label': ariaLabel,\n      'aria-labelledby': ariaLabelledby\n    }\n  };\n}\n"],"names":[],"version":3,"file":"module.js.map"}

package/dist/types.d.ts

@@ -3,10 +3,36 @@ import { MutableRefObject } from "react";
 export type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';
 export interface AriaLandmarkProps extends AriaLabelingProps {
     role: AriaLandmarkRole;
+    focus?: (direction: 'forward' | 'backward') => void;
 }
 export interface LandmarkAria {
     landmarkProps: DOMAttributes;
 }
+interface LandmarkControllerOptions {
+    /**
+     * The element from which to start navigating.
+     * @default document.activeElement
+     */
+    from?: Element;
+}
+/** A LandmarkController allows programmatic navigation of landmarks. */
+export interface LandmarkController {
+    /** Moves focus to the next landmark. */
+    focusNext(opts?: LandmarkControllerOptions): boolean;
+    /** Moves focus to the previous landmark. */
+    focusPrevious(opts?: LandmarkControllerOptions): boolean;
+    /** Moves focus to the main landmark. */
+    focusMain(): boolean;
+    /** Moves focus either forward or backward in the landmark sequence. */
+    navigate(direction: 'forward' | 'backward', opts?: LandmarkControllerOptions): boolean;
+    /**
+     * Disposes the landmark controller. When no landmarks are registered, and no
+     * controllers are active, the landmark keyboard listeners are removed from the page.
+     */
+    dispose(): void;
+}
+/** Creates a LandmarkController, which allows programmatic navigation of landmarks. */
+export function createLandmarkController(): LandmarkController;
 /**
  * Provides landmark navigation in an application. Call this with a role and label to register a landmark navigable with F6.
  * @param props - Props for the landmark.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"mappings":";;AAgBA,+BAA+B,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;AAEjI,kCAAmC,SAAQ,iBAAiB;IAC1D,IAAI,EAAE,gBAAgB,CAAA;CACvB;AAED;IACE,aAAa,EAAE,aAAa,CAAA;CAC7B;AAqQD;;;;GAIG;AACH,4BAA4B,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,gBAAgB,CAAC,GAAG,YAAY,CA4C3G","sources":["packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/useLandmark.ts","packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/index.ts","packages/@react-aria/landmark/src/index.ts"],"sourcesContent":[null,null,"/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria} from './useLandmark';\nexport {useLandmark} from './useLandmark';\n"],"names":[],"version":3,"file":"types.d.ts.map"}
+{"mappings":";;AAiBA,+BAA+B,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;AAEjI,kCAAmC,SAAQ,iBAAiB;IAC1D,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,KAAK,IAAI,CAAA;CACpD;AAED;IACE,aAAa,EAAE,aAAa,CAAA;CAC7B;AA4BD;IACE;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wEAAwE;AACxE;IACE,wCAAwC;IACxC,SAAS,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACrD,4CAA4C;IAC5C,aAAa,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACzD,wCAAwC;IACxC,SAAS,IAAI,OAAO,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACvF;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AA+VD,uFAAuF;AACvF,4CAA4C,kBAAkB,CAkC7D;AAED;;;;GAIG;AACH,4BAA4B,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,gBAAgB,CAAC,GAAG,YAAY,CAqC3G","sources":["packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/useLandmark.ts","packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/index.ts","packages/@react-aria/landmark/src/index.ts"],"sourcesContent":[null,null,"/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria, LandmarkController} from './useLandmark';\nexport {useLandmark, createLandmarkController} from './useLandmark';\n"],"names":[],"version":3,"file":"types.d.ts.map"}

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@react-aria/landmark",
-  "version": "3.0.0-alpha.5",
+  "version": "3.0.0-alpha.6",
   "description": "Spectrum UI components in React",
   "license": "Apache-2.0",
   "main": "dist/main.js",
   "module": "dist/module.js",
+  "exports": {
+    "types": "./dist/types.d.ts",
+    "import": "./dist/import.mjs",
+    "require": "./dist/main.js"
+  },
   "types": "dist/types.d.ts",
   "source": "src/index.ts",
   "files": [
@@ -17,10 +22,11 @@
     "url": "https://github.com/adobe/react-spectrum"
   },
   "dependencies": {
-    "@react-aria/focus": "^3.10.1",
-    "@react-aria/utils": "^3.14.2",
-    "@react-types/shared": "^3.16.0",
-    "@swc/helpers": "^0.4.14"
+    "@react-aria/focus": "^3.11.0",
+    "@react-aria/utils": "^3.15.0",
+    "@react-types/shared": "^3.17.0",
+    "@swc/helpers": "^0.4.14",
+    "use-sync-external-store": "^1.2.0"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0"
@@ -28,5 +34,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "5480d76bd815e239366f92852c76b6831ad2a4fd"
+  "gitHead": "a0efee84aa178cb1a202951dfd6d8de02b292307"
 }

package/src/index.ts

@@ -10,5 +10,5 @@
  * governing permissions and limitations under the License.
  */
 
-export type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria} from './useLandmark';
-export {useLandmark} from './useLandmark';
+export type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria, LandmarkController} from './useLandmark';
+export {useLandmark, createLandmarkController} from './useLandmark';