@primer/behaviors 0.0.0-2023818155639 → 0.0.0-20240229000302

package/dist/cjs/anchored-position.d.ts

@@ -1,5 +1,5 @@
-export declare type AnchorAlignment = 'start' | 'center' | 'end';
-export declare type AnchorSide = 'inside-top' | 'inside-bottom' | 'inside-left' | 'inside-right' | 'inside-center' | 'outside-top' | 'outside-bottom' | 'outside-left' | 'outside-right';
+export type AnchorAlignment = 'start' | 'center' | 'end';
+export type AnchorSide = 'inside-top' | 'inside-bottom' | 'inside-left' | 'inside-right' | 'inside-center' | 'outside-top' | 'outside-bottom' | 'outside-left' | 'outside-right';
 export interface PositionSettings {
     side: AnchorSide;
     align: AnchorAlignment;

package/dist/cjs/anchored-position.js

@@ -5,12 +5,12 @@ const alternateOrders = {
     'outside-top': ['outside-bottom', 'outside-right', 'outside-left', 'outside-bottom'],
     'outside-bottom': ['outside-top', 'outside-right', 'outside-left', 'outside-bottom'],
     'outside-left': ['outside-right', 'outside-bottom', 'outside-top', 'outside-bottom'],
-    'outside-right': ['outside-left', 'outside-bottom', 'outside-top', 'outside-bottom']
+    'outside-right': ['outside-left', 'outside-bottom', 'outside-top', 'outside-bottom'],
 };
 const alternateAlignments = {
     start: ['end', 'center'],
     end: ['start', 'center'],
-    center: ['end', 'start']
+    center: ['end', 'start'],
 };
 function getAnchoredPosition(floatingElement, anchorElement, settings = {}) {
     const parentElement = getPositionedParent(floatingElement);
@@ -20,12 +20,14 @@ function getAnchoredPosition(floatingElement, anchorElement, settings = {}) {
     const [borderTop, borderLeft] = [parentElementStyle.borderTopWidth, parentElementStyle.borderLeftWidth].map(v => parseInt(v, 10) || 0);
     const relativeRect = {
         top: parentElementRect.top + borderTop,
-        left: parentElementRect.left + borderLeft
+        left: parentElementRect.left + borderLeft,
     };
     return pureCalculateAnchoredPosition(clippingRect, relativeRect, floatingElement.getBoundingClientRect(), anchorElement instanceof Element ? anchorElement.getBoundingClientRect() : anchorElement, getDefaultSettings(settings));
 }
 exports.getAnchoredPosition = getAnchoredPosition;
 function getPositionedParent(element) {
+    if (isOnTopLayer(element))
+        return document.body;
     let parentNode = element.parentNode;
     while (parentNode !== null) {
         if (parentNode instanceof HTMLElement && getComputedStyle(parentNode).position !== 'static') {
@@ -35,10 +37,30 @@ function getPositionedParent(element) {
     }
     return document.body;
 }
-function getClippingRect(element) {
+function isModalDialog(element) {
+    return element.matches('dialog:modal');
+}
+function isFullscreen(element) {
+    return element.matches(':fullscreen');
+}
+function isPopover(element) {
+    var _a;
+    try {
+        return (element.matches(':popover-open') && /native code/.test((_a = document.body.showPopover) === null || _a === void 0 ? void 0 : _a.toString()));
+    }
+    catch (_b) {
+        return false;
+    }
+}
+function isOnTopLayer(element) {
+    return isModalDialog(element) || isFullscreen(element) || isPopover(element);
+}
+function getClippingParent(element) {
+    if (element === document.body)
+        return element;
     let parentNode = element;
     while (parentNode !== null) {
-        if (parentNode === document.body) {
+        if (!(parentNode instanceof Element)) {
             break;
         }
         const parentNodeStyle = getComputedStyle(parentNode);
@@ -47,20 +69,23 @@ function getClippingRect(element) {
         }
         parentNode = parentNode.parentNode;
     }
-    const clippingNode = parentNode === document.body || !(parentNode instanceof HTMLElement) ? document.body : parentNode;
+    return parentNode === document.body || !(parentNode instanceof HTMLElement) ? document.body : parentNode;
+}
+function getClippingRect(element) {
+    const clippingNode = getClippingParent(element);
     const elemRect = clippingNode.getBoundingClientRect();
     const elemStyle = getComputedStyle(clippingNode);
     const [borderTop, borderLeft, borderRight, borderBottom] = [
         elemStyle.borderTopWidth,
         elemStyle.borderLeftWidth,
         elemStyle.borderRightWidth,
-        elemStyle.borderBottomWidth
+        elemStyle.borderBottomWidth,
     ].map(v => parseInt(v, 10) || 0);
     return {
         top: elemRect.top + borderTop,
         left: elemRect.left + borderLeft,
         width: elemRect.width - borderRight - borderLeft,
-        height: Math.max(elemRect.height - borderTop - borderBottom, clippingNode === document.body ? window.innerHeight : -Infinity)
+        height: Math.max(elemRect.height - borderTop - borderBottom, clippingNode === document.body ? window.innerHeight : -Infinity),
     };
 }
 const positionDefaults = {
@@ -68,7 +93,7 @@ const positionDefaults = {
     align: 'start',
     anchorOffset: 4,
     alignmentOffset: 4,
-    allowOutOfBounds: false
+    allowOutOfBounds: false,
 };
 function getDefaultSettings(settings = {}) {
     var _a, _b, _c, _d, _e;
@@ -79,7 +104,7 @@ function getDefaultSettings(settings = {}) {
         align,
         anchorOffset: (_c = settings.anchorOffset) !== null && _c !== void 0 ? _c : (side === 'inside-center' ? 0 : positionDefaults.anchorOffset),
         alignmentOffset: (_d = settings.alignmentOffset) !== null && _d !== void 0 ? _d : (align !== 'center' && side.startsWith('inside') ? positionDefaults.alignmentOffset : 0),
-        allowOutOfBounds: (_e = settings.allowOutOfBounds) !== null && _e !== void 0 ? _e : positionDefaults.allowOutOfBounds
+        allowOutOfBounds: (_e = settings.allowOutOfBounds) !== null && _e !== void 0 ? _e : positionDefaults.allowOutOfBounds,
     };
 }
 function pureCalculateAnchoredPosition(viewportRect, relativePosition, floatingRect, anchorRect, { side, align, allowOutOfBounds, anchorOffset, alignmentOffset }) {
@@ -87,7 +112,7 @@ function pureCalculateAnchoredPosition(viewportRect, relativePosition, floatingR
         top: viewportRect.top - relativePosition.top,
         left: viewportRect.left - relativePosition.left,
         width: viewportRect.width,
-        height: viewportRect.height
+        height: viewportRect.height,
     };
     let pos = calculatePosition(floatingRect, anchorRect, side, align, anchorOffset, alignmentOffset);
     let anchorSide = side;

package/dist/cjs/dimensions.d.ts

@@ -1,4 +1,4 @@
-declare type Dimensions = {
+type Dimensions = {
     top: number;
     left: number;
     bottom: number;
@@ -6,7 +6,7 @@ declare type Dimensions = {
     height?: number;
     width?: number;
 };
-declare type Offset = {
+type Offset = {
     top: number;
     left: number;
 };

package/dist/cjs/dimensions.js

@@ -5,7 +5,7 @@ function offset(element) {
     const rect = element.getBoundingClientRect();
     return {
         top: rect.top + window.pageYOffset,
-        left: rect.left + window.pageXOffset
+        left: rect.left + window.pageXOffset,
     };
 }
 exports.offset = offset;
@@ -62,11 +62,11 @@ function overflowOffset(element, targetContainer) {
     const scroll = container === document.documentElement && document.defaultView
         ? {
             top: document.defaultView.pageYOffset,
-            left: document.defaultView.pageXOffset
+            left: document.defaultView.pageXOffset,
         }
         : {
             top: container.scrollTop,
-            left: container.scrollLeft
+            left: container.scrollLeft,
         };
     const top = elementOffset.top - scroll.top;
     const left = elementOffset.left - scroll.left;

package/dist/cjs/focus-trap.js

@@ -94,7 +94,7 @@ function focusTrap(container, initialFocus, abortSignal) {
         container,
         controller: wrappingController,
         initialFocus,
-        originalSignal: signal
+        originalSignal: signal,
     };
     const suspendedTrapIndex = suspendedTrapStack.findIndex(t => t.container === container);
     if (suspendedTrapIndex >= 0) {

package/dist/cjs/focus-zone.d.ts

@@ -1,5 +1,5 @@
-export declare type Direction = 'previous' | 'next' | 'start' | 'end';
-export declare type FocusMovementKeys = 'ArrowLeft' | 'ArrowDown' | 'ArrowUp' | 'ArrowRight' | 'h' | 'j' | 'k' | 'l' | 'a' | 's' | 'w' | 'd' | 'Tab' | 'Home' | 'End' | 'PageUp' | 'PageDown';
+export type Direction = 'previous' | 'next' | 'start' | 'end';
+export type FocusMovementKeys = 'ArrowLeft' | 'ArrowDown' | 'ArrowUp' | 'ArrowRight' | 'h' | 'j' | 'k' | 'l' | 'a' | 's' | 'w' | 'd' | 'Tab' | 'Home' | 'End' | 'PageUp' | 'PageDown' | 'Backspace';
 export declare enum FocusKeys {
     ArrowHorizontal = 1,
     ArrowVertical = 2,
@@ -10,6 +10,7 @@ export declare enum FocusKeys {
     WS = 32,
     AD = 64,
     Tab = 128,
+    Backspace = 512,
     ArrowAll = 3,
     HJKL = 12,
     WASD = 96,

package/dist/cjs/focus-zone.js

@@ -17,11 +17,12 @@ var FocusKeys;
     FocusKeys[FocusKeys["WS"] = 32] = "WS";
     FocusKeys[FocusKeys["AD"] = 64] = "AD";
     FocusKeys[FocusKeys["Tab"] = 128] = "Tab";
+    FocusKeys[FocusKeys["Backspace"] = 512] = "Backspace";
     FocusKeys[FocusKeys["ArrowAll"] = 3] = "ArrowAll";
     FocusKeys[FocusKeys["HJKL"] = 12] = "HJKL";
     FocusKeys[FocusKeys["WASD"] = 96] = "WASD";
     FocusKeys[FocusKeys["All"] = 511] = "All";
-})(FocusKeys = exports.FocusKeys || (exports.FocusKeys = {}));
+})(FocusKeys || (exports.FocusKeys = FocusKeys = {}));
 const KEY_TO_BIT = {
     ArrowLeft: FocusKeys.ArrowHorizontal,
     ArrowDown: FocusKeys.ArrowVertical,
@@ -39,7 +40,8 @@ const KEY_TO_BIT = {
     Home: FocusKeys.HomeAndEnd,
     End: FocusKeys.HomeAndEnd,
     PageUp: FocusKeys.PageUpDown,
-    PageDown: FocusKeys.PageUpDown
+    PageDown: FocusKeys.PageUpDown,
+    Backspace: FocusKeys.Backspace,
 };
 const KEY_TO_DIRECTION = {
     ArrowLeft: 'previous',
@@ -58,7 +60,8 @@ const KEY_TO_DIRECTION = {
     Home: 'start',
     End: 'end',
     PageUp: 'start',
-    PageDown: 'end'
+    PageDown: 'end',
+    Backspace: 'previous',
 };
 function getDirection(keyboardEvent) {
     const direction = KEY_TO_DIRECTION[keyboardEvent.key];
@@ -187,8 +190,7 @@ function focusZone(container, settings) {
         if (filteredElements.length === 0) {
             return;
         }
-        const insertIndex = focusableElements.findIndex(e => (e.compareDocumentPosition(filteredElements[0]) & Node.DOCUMENT_POSITION_PRECEDING) > 0);
-        focusableElements.splice(insertIndex === -1 ? focusableElements.length : insertIndex, 0, ...filteredElements);
+        focusableElements.splice(findInsertionIndex(filteredElements), 0, ...filteredElements);
         for (const element of filteredElements) {
             if (!savedTabIndex.has(element)) {
                 savedTabIndex.set(element, element.getAttribute('tabindex'));
@@ -199,6 +201,27 @@ function focusZone(container, settings) {
             updateFocusedElement(getFirstFocusableElement());
         }
     }
+    function findInsertionIndex(elementsToInsert) {
+        const firstElementToInsert = elementsToInsert[0];
+        if (focusableElements.length === 0)
+            return 0;
+        let iMin = 0;
+        let iMax = focusableElements.length - 1;
+        while (iMin <= iMax) {
+            const i = Math.floor((iMin + iMax) / 2);
+            const element = focusableElements[i];
+            if (followsInDocument(firstElementToInsert, element)) {
+                iMax = i - 1;
+            }
+            else {
+                iMin = i + 1;
+            }
+        }
+        return iMin;
+    }
+    function followsInDocument(first, second) {
+        return (second.compareDocumentPosition(first) & Node.DOCUMENT_POSITION_PRECEDING) > 0;
+    }
     function endFocusManagement(...elements) {
         for (const element of elements) {
             const focusableElementIndex = focusableElements.indexOf(element);
@@ -222,7 +245,8 @@ function focusZone(container, settings) {
         }
     }
     beginFocusManagement(...(0, iterate_focusable_elements_js_1.iterateFocusableElements)(container));
-    updateFocusedElement(getFirstFocusableElement());
+    const initialElement = typeof focusInStrategy === 'function' ? focusInStrategy(document.body) : getFirstFocusableElement();
+    updateFocusedElement(initialElement);
     const observer = new MutationObserver(mutations => {
         for (const mutation of mutations) {
             for (const removedNode of mutation.removedNodes) {
@@ -241,7 +265,7 @@ function focusZone(container, settings) {
     });
     observer.observe(container, {
         subtree: true,
-        childList: true
+        childList: true,
     });
     const controller = new AbortController();
     const signal = (_e = settings === null || settings === void 0 ? void 0 : settings.abortSignal) !== null && _e !== void 0 ? _e : controller.signal;

package/dist/cjs/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/cjs/polyfills/event-listener-signal.js

@@ -8,8 +8,8 @@ try {
         signal: {
             get() {
                 signalSupported = true;
-            }
-        }
+            },
+        },
     });
     window.addEventListener('test', noop, options);
     window.removeEventListener('test', noop, options);

package/dist/cjs/utils/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/cjs/utils/iterate-focusable-elements.js

@@ -6,7 +6,7 @@ function* iterateFocusableElements(container, options = {}) {
     const strict = (_a = options.strict) !== null && _a !== void 0 ? _a : false;
     const acceptFn = ((_b = options.onlyTabbable) !== null && _b !== void 0 ? _b : false) ? isTabbable : isFocusable;
     const walker = document.createTreeWalker(container, NodeFilter.SHOW_ELEMENT, {
-        acceptNode: node => node instanceof HTMLElement && acceptFn(node, strict) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP
+        acceptNode: node => node instanceof HTMLElement && acceptFn(node, strict) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,
     });
     let nextNode = null;
     if (!options.reverse && acceptFn(container, strict)) {

package/dist/esm/anchored-position.d.ts

@@ -1,5 +1,5 @@
-export declare type AnchorAlignment = 'start' | 'center' | 'end';
-export declare type AnchorSide = 'inside-top' | 'inside-bottom' | 'inside-left' | 'inside-right' | 'inside-center' | 'outside-top' | 'outside-bottom' | 'outside-left' | 'outside-right';
+export type AnchorAlignment = 'start' | 'center' | 'end';
+export type AnchorSide = 'inside-top' | 'inside-bottom' | 'inside-left' | 'inside-right' | 'inside-center' | 'outside-top' | 'outside-bottom' | 'outside-left' | 'outside-right';
 export interface PositionSettings {
     side: AnchorSide;
     align: AnchorAlignment;

package/dist/esm/anchored-position.js

@@ -2,12 +2,12 @@ const alternateOrders = {
     'outside-top': ['outside-bottom', 'outside-right', 'outside-left', 'outside-bottom'],
     'outside-bottom': ['outside-top', 'outside-right', 'outside-left', 'outside-bottom'],
     'outside-left': ['outside-right', 'outside-bottom', 'outside-top', 'outside-bottom'],
-    'outside-right': ['outside-left', 'outside-bottom', 'outside-top', 'outside-bottom']
+    'outside-right': ['outside-left', 'outside-bottom', 'outside-top', 'outside-bottom'],
 };
 const alternateAlignments = {
     start: ['end', 'center'],
     end: ['start', 'center'],
-    center: ['end', 'start']
+    center: ['end', 'start'],
 };
 export function getAnchoredPosition(floatingElement, anchorElement, settings = {}) {
     const parentElement = getPositionedParent(floatingElement);
@@ -17,11 +17,13 @@ export function getAnchoredPosition(floatingElement, anchorElement, settings = {
     const [borderTop, borderLeft] = [parentElementStyle.borderTopWidth, parentElementStyle.borderLeftWidth].map(v => parseInt(v, 10) || 0);
     const relativeRect = {
         top: parentElementRect.top + borderTop,
-        left: parentElementRect.left + borderLeft
+        left: parentElementRect.left + borderLeft,
     };
     return pureCalculateAnchoredPosition(clippingRect, relativeRect, floatingElement.getBoundingClientRect(), anchorElement instanceof Element ? anchorElement.getBoundingClientRect() : anchorElement, getDefaultSettings(settings));
 }
 function getPositionedParent(element) {
+    if (isOnTopLayer(element))
+        return document.body;
     let parentNode = element.parentNode;
     while (parentNode !== null) {
         if (parentNode instanceof HTMLElement && getComputedStyle(parentNode).position !== 'static') {
@@ -31,10 +33,30 @@ function getPositionedParent(element) {
     }
     return document.body;
 }
-function getClippingRect(element) {
+function isModalDialog(element) {
+    return element.matches('dialog:modal');
+}
+function isFullscreen(element) {
+    return element.matches(':fullscreen');
+}
+function isPopover(element) {
+    var _a;
+    try {
+        return (element.matches(':popover-open') && /native code/.test((_a = document.body.showPopover) === null || _a === void 0 ? void 0 : _a.toString()));
+    }
+    catch (_b) {
+        return false;
+    }
+}
+function isOnTopLayer(element) {
+    return isModalDialog(element) || isFullscreen(element) || isPopover(element);
+}
+function getClippingParent(element) {
+    if (element === document.body)
+        return element;
     let parentNode = element;
     while (parentNode !== null) {
-        if (parentNode === document.body) {
+        if (!(parentNode instanceof Element)) {
             break;
         }
         const parentNodeStyle = getComputedStyle(parentNode);
@@ -43,20 +65,23 @@ function getClippingRect(element) {
         }
         parentNode = parentNode.parentNode;
     }
-    const clippingNode = parentNode === document.body || !(parentNode instanceof HTMLElement) ? document.body : parentNode;
+    return parentNode === document.body || !(parentNode instanceof HTMLElement) ? document.body : parentNode;
+}
+function getClippingRect(element) {
+    const clippingNode = getClippingParent(element);
     const elemRect = clippingNode.getBoundingClientRect();
     const elemStyle = getComputedStyle(clippingNode);
     const [borderTop, borderLeft, borderRight, borderBottom] = [
         elemStyle.borderTopWidth,
         elemStyle.borderLeftWidth,
         elemStyle.borderRightWidth,
-        elemStyle.borderBottomWidth
+        elemStyle.borderBottomWidth,
     ].map(v => parseInt(v, 10) || 0);
     return {
         top: elemRect.top + borderTop,
         left: elemRect.left + borderLeft,
         width: elemRect.width - borderRight - borderLeft,
-        height: Math.max(elemRect.height - borderTop - borderBottom, clippingNode === document.body ? window.innerHeight : -Infinity)
+        height: Math.max(elemRect.height - borderTop - borderBottom, clippingNode === document.body ? window.innerHeight : -Infinity),
     };
 }
 const positionDefaults = {
@@ -64,7 +89,7 @@ const positionDefaults = {
     align: 'start',
     anchorOffset: 4,
     alignmentOffset: 4,
-    allowOutOfBounds: false
+    allowOutOfBounds: false,
 };
 function getDefaultSettings(settings = {}) {
     var _a, _b, _c, _d, _e;
@@ -75,7 +100,7 @@ function getDefaultSettings(settings = {}) {
         align,
         anchorOffset: (_c = settings.anchorOffset) !== null && _c !== void 0 ? _c : (side === 'inside-center' ? 0 : positionDefaults.anchorOffset),
         alignmentOffset: (_d = settings.alignmentOffset) !== null && _d !== void 0 ? _d : (align !== 'center' && side.startsWith('inside') ? positionDefaults.alignmentOffset : 0),
-        allowOutOfBounds: (_e = settings.allowOutOfBounds) !== null && _e !== void 0 ? _e : positionDefaults.allowOutOfBounds
+        allowOutOfBounds: (_e = settings.allowOutOfBounds) !== null && _e !== void 0 ? _e : positionDefaults.allowOutOfBounds,
     };
 }
 function pureCalculateAnchoredPosition(viewportRect, relativePosition, floatingRect, anchorRect, { side, align, allowOutOfBounds, anchorOffset, alignmentOffset }) {
@@ -83,7 +108,7 @@ function pureCalculateAnchoredPosition(viewportRect, relativePosition, floatingR
         top: viewportRect.top - relativePosition.top,
         left: viewportRect.left - relativePosition.left,
         width: viewportRect.width,
-        height: viewportRect.height
+        height: viewportRect.height,
     };
     let pos = calculatePosition(floatingRect, anchorRect, side, align, anchorOffset, alignmentOffset);
     let anchorSide = side;

package/dist/esm/dimensions.d.ts

@@ -1,4 +1,4 @@
-declare type Dimensions = {
+type Dimensions = {
     top: number;
     left: number;
     bottom: number;
@@ -6,7 +6,7 @@ declare type Dimensions = {
     height?: number;
     width?: number;
 };
-declare type Offset = {
+type Offset = {
     top: number;
     left: number;
 };

package/dist/esm/dimensions.js

@@ -2,7 +2,7 @@ export function offset(element) {
     const rect = element.getBoundingClientRect();
     return {
         top: rect.top + window.pageYOffset,
-        left: rect.left + window.pageXOffset
+        left: rect.left + window.pageXOffset,
     };
 }
 export function overflowParent(targetElement) {
@@ -57,11 +57,11 @@ export function overflowOffset(element, targetContainer) {
     const scroll = container === document.documentElement && document.defaultView
         ? {
             top: document.defaultView.pageYOffset,
-            left: document.defaultView.pageXOffset
+            left: document.defaultView.pageXOffset,
         }
         : {
             top: container.scrollTop,
-            left: container.scrollLeft
+            left: container.scrollLeft,
         };
     const top = elementOffset.top - scroll.top;
     const left = elementOffset.left - scroll.left;

package/dist/esm/focus-trap.js

@@ -91,7 +91,7 @@ export function focusTrap(container, initialFocus, abortSignal) {
         container,
         controller: wrappingController,
         initialFocus,
-        originalSignal: signal
+        originalSignal: signal,
     };
     const suspendedTrapIndex = suspendedTrapStack.findIndex(t => t.container === container);
     if (suspendedTrapIndex >= 0) {

package/dist/esm/focus-zone.d.ts

@@ -1,5 +1,5 @@
-export declare type Direction = 'previous' | 'next' | 'start' | 'end';
-export declare type FocusMovementKeys = 'ArrowLeft' | 'ArrowDown' | 'ArrowUp' | 'ArrowRight' | 'h' | 'j' | 'k' | 'l' | 'a' | 's' | 'w' | 'd' | 'Tab' | 'Home' | 'End' | 'PageUp' | 'PageDown';
+export type Direction = 'previous' | 'next' | 'start' | 'end';
+export type FocusMovementKeys = 'ArrowLeft' | 'ArrowDown' | 'ArrowUp' | 'ArrowRight' | 'h' | 'j' | 'k' | 'l' | 'a' | 's' | 'w' | 'd' | 'Tab' | 'Home' | 'End' | 'PageUp' | 'PageDown' | 'Backspace';
 export declare enum FocusKeys {
     ArrowHorizontal = 1,
     ArrowVertical = 2,
@@ -10,6 +10,7 @@ export declare enum FocusKeys {
     WS = 32,
     AD = 64,
     Tab = 128,
+    Backspace = 512,
     ArrowAll = 3,
     HJKL = 12,
     WASD = 96,

package/dist/esm/focus-zone.js

@@ -14,6 +14,7 @@ export var FocusKeys;
     FocusKeys[FocusKeys["WS"] = 32] = "WS";
     FocusKeys[FocusKeys["AD"] = 64] = "AD";
     FocusKeys[FocusKeys["Tab"] = 128] = "Tab";
+    FocusKeys[FocusKeys["Backspace"] = 512] = "Backspace";
     FocusKeys[FocusKeys["ArrowAll"] = 3] = "ArrowAll";
     FocusKeys[FocusKeys["HJKL"] = 12] = "HJKL";
     FocusKeys[FocusKeys["WASD"] = 96] = "WASD";
@@ -36,7 +37,8 @@ const KEY_TO_BIT = {
     Home: FocusKeys.HomeAndEnd,
     End: FocusKeys.HomeAndEnd,
     PageUp: FocusKeys.PageUpDown,
-    PageDown: FocusKeys.PageUpDown
+    PageDown: FocusKeys.PageUpDown,
+    Backspace: FocusKeys.Backspace,
 };
 const KEY_TO_DIRECTION = {
     ArrowLeft: 'previous',
@@ -55,7 +57,8 @@ const KEY_TO_DIRECTION = {
     Home: 'start',
     End: 'end',
     PageUp: 'start',
-    PageDown: 'end'
+    PageDown: 'end',
+    Backspace: 'previous',
 };
 function getDirection(keyboardEvent) {
     const direction = KEY_TO_DIRECTION[keyboardEvent.key];
@@ -184,8 +187,7 @@ export function focusZone(container, settings) {
         if (filteredElements.length === 0) {
             return;
         }
-        const insertIndex = focusableElements.findIndex(e => (e.compareDocumentPosition(filteredElements[0]) & Node.DOCUMENT_POSITION_PRECEDING) > 0);
-        focusableElements.splice(insertIndex === -1 ? focusableElements.length : insertIndex, 0, ...filteredElements);
+        focusableElements.splice(findInsertionIndex(filteredElements), 0, ...filteredElements);
         for (const element of filteredElements) {
             if (!savedTabIndex.has(element)) {
                 savedTabIndex.set(element, element.getAttribute('tabindex'));
@@ -196,6 +198,27 @@ export function focusZone(container, settings) {
             updateFocusedElement(getFirstFocusableElement());
         }
     }
+    function findInsertionIndex(elementsToInsert) {
+        const firstElementToInsert = elementsToInsert[0];
+        if (focusableElements.length === 0)
+            return 0;
+        let iMin = 0;
+        let iMax = focusableElements.length - 1;
+        while (iMin <= iMax) {
+            const i = Math.floor((iMin + iMax) / 2);
+            const element = focusableElements[i];
+            if (followsInDocument(firstElementToInsert, element)) {
+                iMax = i - 1;
+            }
+            else {
+                iMin = i + 1;
+            }
+        }
+        return iMin;
+    }
+    function followsInDocument(first, second) {
+        return (second.compareDocumentPosition(first) & Node.DOCUMENT_POSITION_PRECEDING) > 0;
+    }
     function endFocusManagement(...elements) {
         for (const element of elements) {
             const focusableElementIndex = focusableElements.indexOf(element);
@@ -219,7 +242,8 @@ export function focusZone(container, settings) {
         }
     }
     beginFocusManagement(...iterateFocusableElements(container));
-    updateFocusedElement(getFirstFocusableElement());
+    const initialElement = typeof focusInStrategy === 'function' ? focusInStrategy(document.body) : getFirstFocusableElement();
+    updateFocusedElement(initialElement);
     const observer = new MutationObserver(mutations => {
         for (const mutation of mutations) {
             for (const removedNode of mutation.removedNodes) {
@@ -238,7 +262,7 @@ export function focusZone(container, settings) {
     });
     observer.observe(container, {
         subtree: true,
-        childList: true
+        childList: true,
     });
     const controller = new AbortController();
     const signal = (_e = settings === null || settings === void 0 ? void 0 : settings.abortSignal) !== null && _e !== void 0 ? _e : controller.signal;

package/dist/esm/polyfills/event-listener-signal.js

@@ -5,8 +5,8 @@ try {
         signal: {
             get() {
                 signalSupported = true;
-            }
-        }
+            },
+        },
     });
     window.addEventListener('test', noop, options);
     window.removeEventListener('test', noop, options);

package/dist/esm/utils/iterate-focusable-elements.js

@@ -3,7 +3,7 @@ export function* iterateFocusableElements(container, options = {}) {
     const strict = (_a = options.strict) !== null && _a !== void 0 ? _a : false;
     const acceptFn = ((_b = options.onlyTabbable) !== null && _b !== void 0 ? _b : false) ? isTabbable : isFocusable;
     const walker = document.createTreeWalker(container, NodeFilter.SHOW_ELEMENT, {
-        acceptNode: node => node instanceof HTMLElement && acceptFn(node, strict) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP
+        acceptNode: node => node instanceof HTMLElement && acceptFn(node, strict) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,
     });
     let nextNode = null;
     if (!options.reverse && acceptFn(container, strict)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primer/behaviors",
-  "version": "0.0.0-2023818155639",
+  "version": "0.0.0-20240229000302",
   "description": "Shared behaviors for JavaScript components",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -30,17 +30,17 @@
     "dist/cjs/focus-trap.js"
   ],
   "scripts": {
-    "lint": "eslint src/",
-    "test": "npm run jest && npm run lint",
-    "test:watch": "jest --watch",
-    "jest": "jest",
     "clean": "rm -rf dist",
-    "prebuild": "npm run clean",
     "build": "npm run build:esm && npm run build:cjs",
     "build:esm": "tsc",
     "build:cjs": "tsc --module commonjs --outDir dist/cjs",
+    "lint": "eslint src/",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prebuild": "npm run clean",
+    "release": "npm run build && changeset publish",
     "size-limit": "npm run build && size-limit",
-    "release": "npm run build && changeset publish"
+    "type-check": "tsc --noEmit"
   },
   "repository": {
     "type": "git",
@@ -68,21 +68,23 @@
   "devDependencies": {
     "@changesets/changelog-github": "^0.4.2",
     "@changesets/cli": "^2.18.1",
-    "@github/prettier-config": "0.0.4",
-    "@size-limit/preset-small-lib": "^7.0.3",
-    "@testing-library/react": "^12.1.2",
-    "@testing-library/user-event": "^13.5.0",
+    "@github/prettier-config": "^0.0.6",
+    "@size-limit/preset-small-lib": "^8.2.4",
+    "@testing-library/react": "^14.0.0",
+    "@testing-library/user-event": "^14.5.1",
     "@types/jest": "^27.0.3",
-    "@types/react": "^17.0.37",
-    "esbuild": "^0.14.1",
+    "@types/node": "^18.18.0",
+    "@types/react": "^18.2.23",
+    "esbuild": "^0.19.4",
     "esbuild-jest": "^0.5.0",
-    "eslint": "^8.3.0",
-    "eslint-plugin-github": "^4.3.5",
+    "eslint": "^8.50.0",
+    "eslint-plugin-github": "^4.10.0",
+    "eslint-plugin-prettier": "^5.0.0",
     "jest": "^27.4.3",
-    "prettier": "^2.5.0",
-    "react": "^17.0.2",
-    "react-dom": "^17.0.2",
-    "size-limit": "^7.0.3",
-    "typescript": "^4.5.2"
+    "prettier": "^3.0.3",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "size-limit": "^8.2.4",
+    "typescript": "^5.2.2"
   }
 }