@react-aria/landmark 3.0.0-nightly.3301

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2019 Adobe
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,3 @@
+# @react-aria/landmark
+
+This package is part of [react-spectrum](https://github.com/adobe/react-spectrum). See the repo for more details.

package/dist/main.js

@@ -0,0 +1,302 @@
+var $8Ore6$react = require("react");
+var $8Ore6$reactariautils = require("@react-aria/utils");
+
+function $parcel$exportWildcard(dest, source) {
+  Object.keys(source).forEach(function(key) {
+    if (key === 'default' || key === '__esModule' || dest.hasOwnProperty(key)) {
+      return;
+    }
+
+    Object.defineProperty(dest, key, {
+      enumerable: true,
+      get: function get() {
+        return source[key];
+      }
+    });
+  });
+
+  return dest;
+}
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+var $202c109aedff6705$exports = {};
+
+$parcel$export($202c109aedff6705$exports, "useLandmark", () => $202c109aedff6705$export$4cc632584fd87fae);
+
+
+class $202c109aedff6705$var$LandmarkManager {
+    static getInstance() {
+        if (!$202c109aedff6705$var$LandmarkManager.instance) $202c109aedff6705$var$LandmarkManager.instance = new $202c109aedff6705$var$LandmarkManager();
+        return $202c109aedff6705$var$LandmarkManager.instance;
+    }
+    setup() {
+        document.addEventListener('keydown', this.f6Handler, {
+            capture: true
+        });
+        document.addEventListener('focusin', this.focusinHandler, {
+            capture: true
+        });
+        document.addEventListener('focusout', this.focusoutHandler, {
+            capture: true
+        });
+        this.isListening = true;
+    }
+    teardown() {
+        document.removeEventListener('keydown', this.f6Handler, {
+            capture: true
+        });
+        document.removeEventListener('focusin', this.focusinHandler, {
+            capture: true
+        });
+        document.removeEventListener('focusout', this.focusoutHandler, {
+            capture: true
+        });
+        this.isListening = false;
+    }
+    focusLandmark(landmark) {
+        var ref;
+        (ref = this.landmarks.find((l)=>l.ref.current === landmark
+        )) === null || ref === void 0 ? void 0 : ref.focus();
+    }
+    /**
+   * Return set of landmarks with a specific role.
+   */ getLandmarksByRole(role) {
+        return new Set(this.landmarks.filter((l)=>l.role === role
+        ));
+    }
+    /**
+   * Return first landmark with a specific role.
+   */ getLandmarkByRole(role) {
+        return this.landmarks.find((l)=>l.role === role
+        );
+    }
+    addLandmark(newLandmark) {
+        if (!this.isListening) this.setup();
+        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
+            ];
+            return;
+        }
+        // Binary search to insert new landmark based on position in document relative to existing landmarks.
+        // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition
+        let start = 0;
+        let end = this.landmarks.length - 1;
+        while(start <= end){
+            let mid = Math.floor((start + end) / 2);
+            let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current);
+            let isNewAfterExisting = Boolean(comparedPosition & Node.DOCUMENT_POSITION_PRECEDING || comparedPosition & Node.DOCUMENT_POSITION_CONTAINS);
+            if (isNewAfterExisting) start = mid + 1;
+            else end = mid - 1;
+        }
+        this.landmarks.splice(start, 0, newLandmark);
+    }
+    updateLandmark(landmark) {
+        let index = this.landmarks.findIndex((l)=>l.ref === landmark.ref
+        );
+        if (index >= 0) {
+            this.landmarks[index] = {
+                ...this.landmarks[index],
+                ...landmark
+            };
+            this.checkLabels(this.landmarks[index].role);
+        }
+    }
+    removeLandmark(ref) {
+        this.landmarks = this.landmarks.filter((landmark)=>landmark.ref !== ref
+        );
+        if (this.landmarks.length === 0) this.teardown();
+    }
+    /**
+   * Warn if there are 2+ landmarks with the same role but no label.
+   * Labels for landmarks with the same role must also be unique.
+   *
+   * See https://www.w3.org/TR/wai-aria-practices/examples/landmarks/navigation.html.
+   */ checkLabels(role) {
+        let landmarksWithRole = this.getLandmarksByRole(role);
+        if (landmarksWithRole.size > 1) {
+            let duplicatesWithoutLabel = [
+                ...landmarksWithRole
+            ].filter((landmark)=>!landmark.label
+            );
+            if (duplicatesWithoutLabel.length > 0) console.warn(`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: `, duplicatesWithoutLabel.map((landmark)=>landmark.ref.current
+            ));
+            else {
+                let labels = [
+                    ...landmarksWithRole
+                ].map((landmark)=>landmark.label
+                );
+                let duplicateLabels = labels.filter((item, index)=>labels.indexOf(item) !== index
+                );
+                duplicateLabels.forEach((label)=>{
+                    console.warn(`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: `, [
+                        ...landmarksWithRole
+                    ].filter((landmark)=>landmark.label === label
+                    ).map((landmark)=>landmark.ref.current
+                    ));
+                });
+            }
+        }
+    }
+    /**
+   * Get the landmark that is the closest parent in the DOM.
+   * Returns undefined if no parent is a landmark.
+   */ closestLandmark(element) {
+        let landmarkMap = new Map(this.landmarks.map((l)=>[
+                l.ref.current,
+                l
+            ]
+        ));
+        let currentElement = element;
+        while(!landmarkMap.has(currentElement) && currentElement !== document.body)currentElement = currentElement.parentElement;
+        return landmarkMap.get(currentElement);
+    }
+    /**
+   * Gets the next landmark, in DOM focus order, or previous if backwards is specified.
+   * If last landmark, next should be the first landmark.
+   * 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;
+        return this.landmarks[nextLandmarkIndex];
+    }
+    /**
+   * Look at next landmark. If an element was previously focused inside, restore focus there.
+   * If not, focus the landmark itself.
+   * 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 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;
+                }
+            }
+            // Otherwise, focus the landmark itself
+            if (document.contains(nextLandmark.ref.current)) this.focusLandmark(nextLandmark.ref.current);
+        }
+    }
+    /**
+   * Sets lastFocused for a landmark, if focus is moved within that landmark.
+   * Lets the last focused landmark know it was blurred if something else is focused.
+   */ focusinHandler(e) {
+        let currentLandmark = this.closestLandmark(e.target);
+        if (currentLandmark && currentLandmark.ref.current !== e.target) this.updateLandmark({
+            ref: currentLandmark.ref,
+            lastFocused: e.target
+        });
+        let previousFocusedElement = e.relatedTarget;
+        if (previousFocusedElement) {
+            let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);
+            if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) closestPreviousLandmark.blur();
+        }
+    }
+    /**
+   * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.
+   */ focusoutHandler(e) {
+        let previousFocusedElement = e.target;
+        let nextFocusedElement = e.relatedTarget;
+        // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();
+        // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens
+        if (!nextFocusedElement || nextFocusedElement === document) {
+            let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);
+            if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) closestPreviousLandmark.blur();
+        }
+    }
+    constructor(){
+        this.landmarks = [];
+        this.isListening = false;
+        this.f6Handler = this.f6Handler.bind(this);
+        this.focusinHandler = this.focusinHandler.bind(this);
+        this.focusoutHandler = this.focusoutHandler.bind(this);
+    }
+}
+function $202c109aedff6705$export$4cc632584fd87fae(props, ref) {
+    const { role: role , 'aria-label': ariaLabel , 'aria-labelledby': ariaLabelledby  } = props;
+    let manager = $202c109aedff6705$var$LandmarkManager.getInstance();
+    let label = ariaLabel || ariaLabelledby;
+    let [isLandmarkFocused, setIsLandmarkFocused] = $8Ore6$react.useState(false);
+    let focus = $8Ore6$react.useCallback(()=>{
+        setIsLandmarkFocused(true);
+    }, [
+        setIsLandmarkFocused
+    ]);
+    let blur = $8Ore6$react.useCallback(()=>{
+        setIsLandmarkFocused(false);
+    }, [
+        setIsLandmarkFocused
+    ]);
+    $8Ore6$reactariautils.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
+    }, []);
+    $8Ore6$reactariautils.useLayoutEffect(()=>{
+        manager.updateLandmark({
+            ref: ref,
+            label: label,
+            role: role,
+            focus: focus,
+            blur: blur
+        });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        label,
+        ref,
+        role
+    ]);
+    $8Ore6$react.useEffect(()=>{
+        if (isLandmarkFocused) ref.current.focus();
+    }, [
+        isLandmarkFocused,
+        ref
+    ]);
+    return {
+        landmarkProps: {
+            role: role,
+            tabIndex: isLandmarkFocused ? -1 : undefined
+        }
+    };
+}
+
+
+$parcel$exportWildcard(module.exports, $202c109aedff6705$exports);
+
+
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +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 * 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} from '@react-types/shared';\nimport {HTMLAttributes, 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\ninterface LandmarkAria {\n  landmarkProps: HTMLAttributes<HTMLElement>\n}\n\ntype Landmark = {\n  ref: MutableRefObject<HTMLElement>,\n  role: AriaLandmarkRole,\n  label?: string,\n  lastFocused?: HTMLElement,\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: HTMLElement) {\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<HTMLElement>) {\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/TR/wai-aria-practices/examples/landmarks/navigation.html.\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: HTMLElement) {\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: HTMLElement, {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 HTMLElement, {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 HTMLElement);\n    if (currentLandmark && currentLandmark.ref.current !== e.target) {\n      this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as HTMLElement});\n    }\n    let previousFocusedElement = e.relatedTarget as HTMLElement;\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 HTMLElement;\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<HTMLElement>): 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":"main.js.map"}

package/dist/module.js

@@ -0,0 +1,286 @@
+import {useState as $TvsbU$useState, useCallback as $TvsbU$useCallback, useEffect as $TvsbU$useEffect} from "react";
+import {useLayoutEffect as $TvsbU$useLayoutEffect} from "@react-aria/utils";
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+var $a86207c5d7f7e1fb$exports = {};
+
+$parcel$export($a86207c5d7f7e1fb$exports, "useLandmark", () => $a86207c5d7f7e1fb$export$4cc632584fd87fae);
+
+
+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() {
+        document.addEventListener('keydown', this.f6Handler, {
+            capture: true
+        });
+        document.addEventListener('focusin', this.focusinHandler, {
+            capture: true
+        });
+        document.addEventListener('focusout', this.focusoutHandler, {
+            capture: true
+        });
+        this.isListening = true;
+    }
+    teardown() {
+        document.removeEventListener('keydown', this.f6Handler, {
+            capture: true
+        });
+        document.removeEventListener('focusin', this.focusinHandler, {
+            capture: true
+        });
+        document.removeEventListener('focusout', this.focusoutHandler, {
+            capture: true
+        });
+        this.isListening = false;
+    }
+    focusLandmark(landmark) {
+        var ref;
+        (ref = this.landmarks.find((l)=>l.ref.current === landmark
+        )) === null || ref === void 0 ? void 0 : ref.focus();
+    }
+    /**
+   * Return set of landmarks with a specific role.
+   */ getLandmarksByRole(role) {
+        return new Set(this.landmarks.filter((l)=>l.role === role
+        ));
+    }
+    /**
+   * Return first landmark with a specific role.
+   */ getLandmarkByRole(role) {
+        return this.landmarks.find((l)=>l.role === role
+        );
+    }
+    addLandmark(newLandmark) {
+        if (!this.isListening) this.setup();
+        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
+            ];
+            return;
+        }
+        // Binary search to insert new landmark based on position in document relative to existing landmarks.
+        // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition
+        let start = 0;
+        let end = this.landmarks.length - 1;
+        while(start <= end){
+            let mid = Math.floor((start + end) / 2);
+            let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current);
+            let isNewAfterExisting = Boolean(comparedPosition & Node.DOCUMENT_POSITION_PRECEDING || comparedPosition & Node.DOCUMENT_POSITION_CONTAINS);
+            if (isNewAfterExisting) start = mid + 1;
+            else end = mid - 1;
+        }
+        this.landmarks.splice(start, 0, newLandmark);
+    }
+    updateLandmark(landmark) {
+        let index = this.landmarks.findIndex((l)=>l.ref === landmark.ref
+        );
+        if (index >= 0) {
+            this.landmarks[index] = {
+                ...this.landmarks[index],
+                ...landmark
+            };
+            this.checkLabels(this.landmarks[index].role);
+        }
+    }
+    removeLandmark(ref) {
+        this.landmarks = this.landmarks.filter((landmark)=>landmark.ref !== ref
+        );
+        if (this.landmarks.length === 0) this.teardown();
+    }
+    /**
+   * Warn if there are 2+ landmarks with the same role but no label.
+   * Labels for landmarks with the same role must also be unique.
+   *
+   * See https://www.w3.org/TR/wai-aria-practices/examples/landmarks/navigation.html.
+   */ checkLabels(role) {
+        let landmarksWithRole = this.getLandmarksByRole(role);
+        if (landmarksWithRole.size > 1) {
+            let duplicatesWithoutLabel = [
+                ...landmarksWithRole
+            ].filter((landmark)=>!landmark.label
+            );
+            if (duplicatesWithoutLabel.length > 0) console.warn(`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: `, duplicatesWithoutLabel.map((landmark)=>landmark.ref.current
+            ));
+            else {
+                let labels = [
+                    ...landmarksWithRole
+                ].map((landmark)=>landmark.label
+                );
+                let duplicateLabels = labels.filter((item, index)=>labels.indexOf(item) !== index
+                );
+                duplicateLabels.forEach((label)=>{
+                    console.warn(`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: `, [
+                        ...landmarksWithRole
+                    ].filter((landmark)=>landmark.label === label
+                    ).map((landmark)=>landmark.ref.current
+                    ));
+                });
+            }
+        }
+    }
+    /**
+   * Get the landmark that is the closest parent in the DOM.
+   * Returns undefined if no parent is a landmark.
+   */ closestLandmark(element) {
+        let landmarkMap = new Map(this.landmarks.map((l)=>[
+                l.ref.current,
+                l
+            ]
+        ));
+        let currentElement = element;
+        while(!landmarkMap.has(currentElement) && currentElement !== document.body)currentElement = currentElement.parentElement;
+        return landmarkMap.get(currentElement);
+    }
+    /**
+   * Gets the next landmark, in DOM focus order, or previous if backwards is specified.
+   * If last landmark, next should be the first landmark.
+   * 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;
+        return this.landmarks[nextLandmarkIndex];
+    }
+    /**
+   * Look at next landmark. If an element was previously focused inside, restore focus there.
+   * If not, focus the landmark itself.
+   * 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 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;
+                }
+            }
+            // Otherwise, focus the landmark itself
+            if (document.contains(nextLandmark.ref.current)) this.focusLandmark(nextLandmark.ref.current);
+        }
+    }
+    /**
+   * Sets lastFocused for a landmark, if focus is moved within that landmark.
+   * Lets the last focused landmark know it was blurred if something else is focused.
+   */ focusinHandler(e) {
+        let currentLandmark = this.closestLandmark(e.target);
+        if (currentLandmark && currentLandmark.ref.current !== e.target) this.updateLandmark({
+            ref: currentLandmark.ref,
+            lastFocused: e.target
+        });
+        let previousFocusedElement = e.relatedTarget;
+        if (previousFocusedElement) {
+            let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);
+            if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) closestPreviousLandmark.blur();
+        }
+    }
+    /**
+   * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.
+   */ focusoutHandler(e) {
+        let previousFocusedElement = e.target;
+        let nextFocusedElement = e.relatedTarget;
+        // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();
+        // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens
+        if (!nextFocusedElement || nextFocusedElement === document) {
+            let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);
+            if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) closestPreviousLandmark.blur();
+        }
+    }
+    constructor(){
+        this.landmarks = [];
+        this.isListening = false;
+        this.f6Handler = this.f6Handler.bind(this);
+        this.focusinHandler = this.focusinHandler.bind(this);
+        this.focusoutHandler = this.focusoutHandler.bind(this);
+    }
+}
+function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
+    const { role: role , 'aria-label': ariaLabel , 'aria-labelledby': ariaLabelledby  } = props;
+    let manager = $a86207c5d7f7e1fb$var$LandmarkManager.getInstance();
+    let label = ariaLabel || ariaLabelledby;
+    let [isLandmarkFocused, setIsLandmarkFocused] = $TvsbU$useState(false);
+    let focus = $TvsbU$useCallback(()=>{
+        setIsLandmarkFocused(true);
+    }, [
+        setIsLandmarkFocused
+    ]);
+    let blur = $TvsbU$useCallback(()=>{
+        setIsLandmarkFocused(false);
+    }, [
+        setIsLandmarkFocused
+    ]);
+    $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
+    }, []);
+    $TvsbU$useLayoutEffect(()=>{
+        manager.updateLandmark({
+            ref: ref,
+            label: label,
+            role: role,
+            focus: focus,
+            blur: blur
+        });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        label,
+        ref,
+        role
+    ]);
+    $TvsbU$useEffect(()=>{
+        if (isLandmarkFocused) ref.current.focus();
+    }, [
+        isLandmarkFocused,
+        ref
+    ]);
+    return {
+        landmarkProps: {
+            role: role,
+            tabIndex: isLandmarkFocused ? -1 : undefined
+        }
+    };
+}
+
+
+
+
+export {$a86207c5d7f7e1fb$export$4cc632584fd87fae as useLandmark};
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +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 * 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} from '@react-types/shared';\nimport {HTMLAttributes, 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\ninterface LandmarkAria {\n  landmarkProps: HTMLAttributes<HTMLElement>\n}\n\ntype Landmark = {\n  ref: MutableRefObject<HTMLElement>,\n  role: AriaLandmarkRole,\n  label?: string,\n  lastFocused?: HTMLElement,\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: HTMLElement) {\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<HTMLElement>) {\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/TR/wai-aria-practices/examples/landmarks/navigation.html.\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: HTMLElement) {\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: HTMLElement, {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 HTMLElement, {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 HTMLElement);\n    if (currentLandmark && currentLandmark.ref.current !== e.target) {\n      this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as HTMLElement});\n    }\n    let previousFocusedElement = e.relatedTarget as HTMLElement;\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 HTMLElement;\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<HTMLElement>): 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"}

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+import { AriaLabelingProps } from "@react-types/shared";
+import { HTMLAttributes, MutableRefObject } from "react";
+export type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';
+export interface AriaLandmarkProps extends AriaLabelingProps {
+    role: AriaLandmarkRole;
+}
+interface LandmarkAria {
+    landmarkProps: HTMLAttributes<HTMLElement>;
+}
+/**
+ * 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.
+ * @param ref - Ref to the landmark.
+ */
+export function useLandmark(props: AriaLandmarkProps, ref: MutableRefObject<HTMLElement>): LandmarkAria;
+
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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,eAAe,WAAW,CAAC,CAAA;CAC3C;AAqQD;;;;GAIG;AACH,4BAA4B,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,WAAW,CAAC,GAAG,YAAY,CA4CtG","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 * from './useLandmark';\n"],"names":[],"version":3,"file":"types.d.ts.map"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@react-aria/landmark",
+  "version": "3.0.0-nightly.3301+1187fa3bf",
+  "description": "Spectrum UI components in React",
+  "license": "Apache-2.0",
+  "main": "dist/main.js",
+  "module": "dist/module.js",
+  "types": "dist/types.d.ts",
+  "source": "src/index.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adobe/react-spectrum"
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.6.2",
+    "@react-aria/focus": "3.0.0-nightly.1602+1187fa3bf",
+    "@react-aria/utils": "3.0.0-nightly.1602+1187fa3bf",
+    "@react-types/shared": "3.0.0-nightly.1602+1187fa3bf"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "1187fa3bfea1aed7b49d39a22b26944c7d017a82"
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+/*
+ * Copyright 2022 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+export * from './useLandmark';

package/src/useLandmark.ts

@@ -0,0 +1,335 @@
+/*
+ * Copyright 2022 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {AriaLabelingProps} from '@react-types/shared';
+import {HTMLAttributes, MutableRefObject, useCallback, useEffect, useState} from 'react';
+import {useLayoutEffect} from '@react-aria/utils';
+
+export type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';
+
+export interface AriaLandmarkProps extends AriaLabelingProps {
+  role: AriaLandmarkRole
+}
+
+interface LandmarkAria {
+  landmarkProps: HTMLAttributes<HTMLElement>
+}
+
+type Landmark = {
+  ref: MutableRefObject<HTMLElement>,
+  role: AriaLandmarkRole,
+  label?: string,
+  lastFocused?: HTMLElement,
+  focus: () => void,
+  blur: () => void
+};
+
+class LandmarkManager {
+  private landmarks: Array<Landmark> = [];
+  private static instance: LandmarkManager;
+  private isListening = false;
+
+  private constructor() {
+    this.f6Handler = this.f6Handler.bind(this);
+    this.focusinHandler = this.focusinHandler.bind(this);
+    this.focusoutHandler = this.focusoutHandler.bind(this);
+  }
+
+  public static getInstance(): LandmarkManager {
+    if (!LandmarkManager.instance) {
+      LandmarkManager.instance = new LandmarkManager();
+    }
+
+    return LandmarkManager.instance;
+  }
+
+  private setup() {
+    document.addEventListener('keydown', this.f6Handler, {capture: true});
+    document.addEventListener('focusin', this.focusinHandler, {capture: true});
+    document.addEventListener('focusout', this.focusoutHandler, {capture: true});
+    this.isListening = true;
+  }
+
+  private teardown() {
+    document.removeEventListener('keydown', this.f6Handler, {capture: true});
+    document.removeEventListener('focusin', this.focusinHandler, {capture: true});
+    document.removeEventListener('focusout', this.focusoutHandler, {capture: true});
+    this.isListening = false;
+  }
+
+  private focusLandmark(landmark: HTMLElement) {
+    this.landmarks.find(l => l.ref.current === landmark)?.focus();
+  }
+
+  /**
+   * Return set of landmarks with a specific role.
+   */
+  public getLandmarksByRole(role: AriaLandmarkRole) {
+    return new Set(this.landmarks.filter(l => l.role === role));
+  }
+
+  /**
+   * Return first landmark with a specific role.
+   */
+  public getLandmarkByRole(role: AriaLandmarkRole) {
+    return this.landmarks.find(l => l.role === role);
+  }
+
+  public addLandmark(newLandmark: Landmark) {
+    if (!this.isListening) {
+      this.setup();
+    }
+    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];
+      return;
+    }
+
+
+    // Binary search to insert new landmark based on position in document relative to existing landmarks.
+    // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition
+    let start = 0;
+    let end = this.landmarks.length - 1;
+    while (start <= end) {
+      let mid = Math.floor((start + end) / 2);
+      let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current as Node);
+      let isNewAfterExisting = Boolean((comparedPosition & Node.DOCUMENT_POSITION_PRECEDING) || (comparedPosition & Node.DOCUMENT_POSITION_CONTAINS));
+
+      if (isNewAfterExisting) {
+        start = mid + 1;
+      } else {
+        end = mid - 1;
+      }
+    }
+
+    this.landmarks.splice(start, 0, newLandmark);
+  }
+
+  public updateLandmark(landmark: Pick<Landmark, 'ref'> & Partial<Landmark>) {
+    let index = this.landmarks.findIndex(l => l.ref === landmark.ref);
+    if (index >= 0) {
+      this.landmarks[index] = {...this.landmarks[index], ...landmark};
+      this.checkLabels(this.landmarks[index].role);
+    }
+  }
+
+  public removeLandmark(ref: MutableRefObject<HTMLElement>) {
+    this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);
+    if (this.landmarks.length === 0) {
+      this.teardown();
+    }
+  }
+
+  /**
+   * Warn if there are 2+ landmarks with the same role but no label.
+   * Labels for landmarks with the same role must also be unique.
+   *
+   * See https://www.w3.org/TR/wai-aria-practices/examples/landmarks/navigation.html.
+   */
+  private checkLabels(role: AriaLandmarkRole) {
+    let landmarksWithRole = this.getLandmarksByRole(role);
+    if (landmarksWithRole.size > 1) {
+      let duplicatesWithoutLabel = [...landmarksWithRole].filter(landmark => !landmark.label);
+      if (duplicatesWithoutLabel.length > 0) {
+        console.warn(
+          `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: `,
+          duplicatesWithoutLabel.map(landmark => landmark.ref.current)
+        );
+      } else {
+        let labels = [...landmarksWithRole].map(landmark => landmark.label);
+        let duplicateLabels = labels.filter((item, index) => labels.indexOf(item) !== index);
+
+        duplicateLabels.forEach((label) => {
+          console.warn(
+            `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: `,
+            [...landmarksWithRole].filter(landmark => landmark.label === label).map(landmark => landmark.ref.current)
+          );
+        });
+      }
+    }
+  }
+
+  /**
+   * Get the landmark that is the closest parent in the DOM.
+   * Returns undefined if no parent is a landmark.
+   */
+  private closestLandmark(element: HTMLElement) {
+    let landmarkMap = new Map(this.landmarks.map(l => [l.ref.current, l]));
+    let currentElement = element;
+    while (!landmarkMap.has(currentElement) && currentElement !== document.body) {
+      currentElement = currentElement.parentElement;
+    }
+    return landmarkMap.get(currentElement);
+  }
+
+  /**
+   * Gets the next landmark, in DOM focus order, or previous if backwards is specified.
+   * If last landmark, next should be the first landmark.
+   * If not inside a landmark, will return first landmark.
+   * Returns undefined if there are no landmarks.
+   */
+  public getNextLandmark(element: HTMLElement, {backward}: {backward?: boolean }) {
+    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;
+    }
+
+    return this.landmarks[nextLandmarkIndex];
+  }
+
+  /**
+   * Look at next landmark. If an element was previously focused inside, restore focus there.
+   * If not, focus the landmark itself.
+   * If no landmarks at all, or none with focusable elements, don't move focus.
+   */
+  public f6Handler(e: KeyboardEvent) {
+    if (e.key === 'F6') {
+      e.preventDefault();
+      e.stopPropagation();
+
+      let backward = e.shiftKey;
+      let nextLandmark = this.getNextLandmark(e.target as HTMLElement, {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 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;
+        }
+      }
+
+      // Otherwise, focus the landmark itself
+      if (document.contains(nextLandmark.ref.current)) {
+        this.focusLandmark(nextLandmark.ref.current);
+      }
+    }
+  }
+
+  /**
+   * Sets lastFocused for a landmark, if focus is moved within that landmark.
+   * Lets the last focused landmark know it was blurred if something else is focused.
+   */
+  public focusinHandler(e: FocusEvent) {
+    let currentLandmark = this.closestLandmark(e.target as HTMLElement);
+    if (currentLandmark && currentLandmark.ref.current !== e.target) {
+      this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as HTMLElement});
+    }
+    let previousFocusedElement = e.relatedTarget as HTMLElement;
+    if (previousFocusedElement) {
+      let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);
+      if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {
+        closestPreviousLandmark.blur();
+      }
+    }
+  }
+
+  /**
+   * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.
+   */
+  public focusoutHandler(e: FocusEvent) {
+    let previousFocusedElement = e.target as HTMLElement;
+    let nextFocusedElement = e.relatedTarget;
+    // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();
+    // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens
+    if (!nextFocusedElement || nextFocusedElement === document) {
+      let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);
+      if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {
+        closestPreviousLandmark.blur();
+      }
+    }
+  }
+}
+
+/**
+ * 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.
+ * @param ref - Ref to the landmark.
+ */
+export function useLandmark(props: AriaLandmarkProps, ref: MutableRefObject<HTMLElement>): LandmarkAria {
+  const {
+    role,
+    'aria-label': ariaLabel,
+    'aria-labelledby': ariaLabelledby
+  } = props;
+  let manager = LandmarkManager.getInstance();
+  let label = ariaLabel || ariaLabelledby;
+  let [isLandmarkFocused, setIsLandmarkFocused] = useState(false);
+
+  let focus = useCallback(() => {
+    setIsLandmarkFocused(true);
+  }, [setIsLandmarkFocused]);
+
+  let blur = useCallback(() => {
+    setIsLandmarkFocused(false);
+  }, [setIsLandmarkFocused]);
+
+  useLayoutEffect(() => {
+    manager.addLandmark({ref, role, label, focus, blur});
+
+    return () => {
+      manager.removeLandmark(ref);
+    };
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  useLayoutEffect(() => {
+    manager.updateLandmark({ref, label, role, focus, blur});
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [label, ref, role]);
+
+  useEffect(() => {
+    if (isLandmarkFocused) {
+      ref.current.focus();
+    }
+  }, [isLandmarkFocused, ref]);
+
+  return {
+    landmarkProps: {
+      role,
+      tabIndex: isLandmarkFocused ? -1 : undefined
+    }
+  };
+}