@primer/behaviors 0.0.0-20251203212431 → 0.0.0-20251203213711

package/README.md

@@ -7,10 +7,10 @@ Shared behaviors for JavaScript components
 
 ## Documentation
 
-- [Anchored Position](/docs/anchored-position.md)
-- [Focus Trap](/docs/focus-trap.md)
-- [Focus Zone](/docs/focus-zone.md)
-- [Scroll Into View](/docs/scroll-into-view.md)
+* [Anchored Position](/docs/anchored-position.md)
+* [Focus Trap](/docs/focus-trap.md)
+* [Focus Zone](/docs/focus-zone.md)
+* [Scroll Into View](/docs/scroll-into-view.md)
 
 ## Installation
 
@@ -18,14 +18,8 @@ Shared behaviors for JavaScript components
 npm install @primer/behaviors
 ```
 
-or
+or 
 
 ```bash
 yarn add @primer/behaviors
 ```
-
-## Storybook
-
-```bash
-npm run storybook
-```

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

@@ -25,8 +25,9 @@ export type FocusZoneSettings = IterateFocusableElements & {
     abortSignal?: AbortSignal;
     activeDescendantControl?: HTMLElement;
     onActiveDescendantChanged?: (newActiveDescendant: HTMLElement | undefined, previousActiveDescendant: HTMLElement | undefined, directlyActivated: boolean) => void;
-    focusInStrategy?: 'first' | 'closest' | 'previous' | 'initial' | ((previousFocusedElement: Element) => HTMLElement | undefined);
+    focusInStrategy?: 'first' | 'closest' | 'previous' | ((previousFocusedElement: Element) => HTMLElement | undefined);
     preventScroll?: boolean;
+    ignoreHoverEvents?: boolean;
 };
 export declare const isActiveDescendantAttribute = "data-is-active-descendant";
 export declare const activeDescendantActivatedDirectly = "activated-directly";

package/dist/cjs/focus-zone.js

@@ -129,7 +129,7 @@ const activeDescendantActivatedDirectly = 'activated-directly';
 const activeDescendantActivatedIndirectly = 'activated-indirectly';
 const hasActiveDescendantAttribute = 'data-has-active-descendant';
 function focusZone(container, settings) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     const focusableElements = [];
     const savedTabIndex = new WeakMap();
     const bindKeys = (_a = settings === null || settings === void 0 ? void 0 : settings.bindKeys) !== null && _a !== void 0 ? _a : ((settings === null || settings === void 0 ? void 0 : settings.getNextFocusable) ? exports.FocusKeys.ArrowAll : exports.FocusKeys.ArrowVertical) | exports.FocusKeys.HomeAndEnd;
@@ -137,9 +137,9 @@ function focusZone(container, settings) {
     const focusInStrategy = (_c = settings === null || settings === void 0 ? void 0 : settings.focusInStrategy) !== null && _c !== void 0 ? _c : 'previous';
     const activeDescendantControl = settings === null || settings === void 0 ? void 0 : settings.activeDescendantControl;
     const activeDescendantCallback = settings === null || settings === void 0 ? void 0 : settings.onActiveDescendantChanged;
+    const ignoreHoverEvents = (_d = settings === null || settings === void 0 ? void 0 : settings.ignoreHoverEvents) !== null && _d !== void 0 ? _d : false;
     let currentFocusedElement;
-    const preventScroll = (_d = settings === null || settings === void 0 ? void 0 : settings.preventScroll) !== null && _d !== void 0 ? _d : false;
-    const preventInitialFocus = focusInStrategy === 'initial' && (settings === null || settings === void 0 ? void 0 : settings.activeDescendantControl);
+    const preventScroll = (_e = settings === null || settings === void 0 ? void 0 : settings.preventScroll) !== null && _e !== void 0 ? _e : false;
     function getFirstFocusableElement() {
         return focusableElements[0];
     }
@@ -203,7 +203,7 @@ function focusZone(container, settings) {
             }
             element.setAttribute('tabindex', '-1');
         }
-        if (!currentFocusedElement && !preventInitialFocus) {
+        if (!currentFocusedElement) {
             updateFocusedElement(getFirstFocusableElement());
         }
     }
@@ -257,8 +257,7 @@ function focusZone(container, settings) {
     };
     beginFocusManagement(...iterateFocusableElements.iterateFocusableElements(container, iterateFocusableElementsOptions));
     const initialElement = typeof focusInStrategy === 'function' ? focusInStrategy(document.body) : getFirstFocusableElement();
-    if (!preventInitialFocus)
-        updateFocusedElement(initialElement);
+    updateFocusedElement(initialElement);
     const observer = new MutationObserver(mutations => {
         for (const mutation of mutations) {
             for (const removedNode of mutation.removedNodes) {
@@ -292,7 +291,7 @@ function focusZone(container, settings) {
         attributeOldValue: true,
     });
     const controller = new AbortController();
-    const signal = (_e = settings === null || settings === void 0 ? void 0 : settings.abortSignal) !== null && _e !== void 0 ? _e : controller.signal;
+    const signal = (_f = settings === null || settings === void 0 ? void 0 : settings.abortSignal) !== null && _f !== void 0 ? _f : controller.signal;
     signal.addEventListener('abort', () => {
         endFocusManagement(...focusableElements);
     });
@@ -309,19 +308,20 @@ function focusZone(container, settings) {
                 updateFocusedElement(event.target);
             }
         }, { signal });
-        container.addEventListener('mousemove', ({ target }) => {
-            if (!(target instanceof Node)) {
-                return;
-            }
-            const focusableElement = focusableElements.find(element => element.contains(target));
-            if (focusableElement) {
-                updateFocusedElement(focusableElement);
-            }
-        }, { signal, capture: true });
+        if (!ignoreHoverEvents) {
+            container.addEventListener('mousemove', ({ target }) => {
+                if (!(target instanceof Node)) {
+                    return;
+                }
+                const focusableElement = focusableElements.find(element => element.contains(target));
+                if (focusableElement) {
+                    updateFocusedElement(focusableElement);
+                }
+            }, { signal, capture: true });
+        }
         activeDescendantControl.addEventListener('focusin', () => {
             if (!currentFocusedElement) {
-                if (!preventInitialFocus)
-                    updateFocusedElement(getFirstFocusableElement());
+                updateFocusedElement(getFirstFocusableElement());
             }
             else {
                 setActiveDescendant(undefined, currentFocusedElement);
@@ -389,7 +389,7 @@ function focusZone(container, settings) {
     }
     function getCurrentFocusedIndex() {
         if (!currentFocusedElement) {
-            return preventInitialFocus ? -1 : 0;
+            return 0;
         }
         const focusedIndex = focusableElements.indexOf(currentFocusedElement);
         const fallbackIndex = currentFocusedElement === container ? -1 : 0;

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

@@ -25,8 +25,9 @@ export type FocusZoneSettings = IterateFocusableElements & {
     abortSignal?: AbortSignal;
     activeDescendantControl?: HTMLElement;
     onActiveDescendantChanged?: (newActiveDescendant: HTMLElement | undefined, previousActiveDescendant: HTMLElement | undefined, directlyActivated: boolean) => void;
-    focusInStrategy?: 'first' | 'closest' | 'previous' | 'initial' | ((previousFocusedElement: Element) => HTMLElement | undefined);
+    focusInStrategy?: 'first' | 'closest' | 'previous' | ((previousFocusedElement: Element) => HTMLElement | undefined);
     preventScroll?: boolean;
+    ignoreHoverEvents?: boolean;
 };
 export declare const isActiveDescendantAttribute = "data-is-active-descendant";
 export declare const activeDescendantActivatedDirectly = "activated-directly";

package/dist/esm/focus-zone.mjs

@@ -127,7 +127,7 @@ const activeDescendantActivatedDirectly = 'activated-directly';
 const activeDescendantActivatedIndirectly = 'activated-indirectly';
 const hasActiveDescendantAttribute = 'data-has-active-descendant';
 function focusZone(container, settings) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     const focusableElements = [];
     const savedTabIndex = new WeakMap();
     const bindKeys = (_a = settings === null || settings === void 0 ? void 0 : settings.bindKeys) !== null && _a !== void 0 ? _a : ((settings === null || settings === void 0 ? void 0 : settings.getNextFocusable) ? FocusKeys.ArrowAll : FocusKeys.ArrowVertical) | FocusKeys.HomeAndEnd;
@@ -135,9 +135,9 @@ function focusZone(container, settings) {
     const focusInStrategy = (_c = settings === null || settings === void 0 ? void 0 : settings.focusInStrategy) !== null && _c !== void 0 ? _c : 'previous';
     const activeDescendantControl = settings === null || settings === void 0 ? void 0 : settings.activeDescendantControl;
     const activeDescendantCallback = settings === null || settings === void 0 ? void 0 : settings.onActiveDescendantChanged;
+    const ignoreHoverEvents = (_d = settings === null || settings === void 0 ? void 0 : settings.ignoreHoverEvents) !== null && _d !== void 0 ? _d : false;
     let currentFocusedElement;
-    const preventScroll = (_d = settings === null || settings === void 0 ? void 0 : settings.preventScroll) !== null && _d !== void 0 ? _d : false;
-    const preventInitialFocus = focusInStrategy === 'initial' && (settings === null || settings === void 0 ? void 0 : settings.activeDescendantControl);
+    const preventScroll = (_e = settings === null || settings === void 0 ? void 0 : settings.preventScroll) !== null && _e !== void 0 ? _e : false;
     function getFirstFocusableElement() {
         return focusableElements[0];
     }
@@ -201,7 +201,7 @@ function focusZone(container, settings) {
             }
             element.setAttribute('tabindex', '-1');
         }
-        if (!currentFocusedElement && !preventInitialFocus) {
+        if (!currentFocusedElement) {
             updateFocusedElement(getFirstFocusableElement());
         }
     }
@@ -255,8 +255,7 @@ function focusZone(container, settings) {
     };
     beginFocusManagement(...iterateFocusableElements(container, iterateFocusableElementsOptions));
     const initialElement = typeof focusInStrategy === 'function' ? focusInStrategy(document.body) : getFirstFocusableElement();
-    if (!preventInitialFocus)
-        updateFocusedElement(initialElement);
+    updateFocusedElement(initialElement);
     const observer = new MutationObserver(mutations => {
         for (const mutation of mutations) {
             for (const removedNode of mutation.removedNodes) {
@@ -290,7 +289,7 @@ function focusZone(container, settings) {
         attributeOldValue: true,
     });
     const controller = new AbortController();
-    const signal = (_e = settings === null || settings === void 0 ? void 0 : settings.abortSignal) !== null && _e !== void 0 ? _e : controller.signal;
+    const signal = (_f = settings === null || settings === void 0 ? void 0 : settings.abortSignal) !== null && _f !== void 0 ? _f : controller.signal;
     signal.addEventListener('abort', () => {
         endFocusManagement(...focusableElements);
     });
@@ -307,19 +306,20 @@ function focusZone(container, settings) {
                 updateFocusedElement(event.target);
             }
         }, { signal });
-        container.addEventListener('mousemove', ({ target }) => {
-            if (!(target instanceof Node)) {
-                return;
-            }
-            const focusableElement = focusableElements.find(element => element.contains(target));
-            if (focusableElement) {
-                updateFocusedElement(focusableElement);
-            }
-        }, { signal, capture: true });
+        if (!ignoreHoverEvents) {
+            container.addEventListener('mousemove', ({ target }) => {
+                if (!(target instanceof Node)) {
+                    return;
+                }
+                const focusableElement = focusableElements.find(element => element.contains(target));
+                if (focusableElement) {
+                    updateFocusedElement(focusableElement);
+                }
+            }, { signal, capture: true });
+        }
         activeDescendantControl.addEventListener('focusin', () => {
             if (!currentFocusedElement) {
-                if (!preventInitialFocus)
-                    updateFocusedElement(getFirstFocusableElement());
+                updateFocusedElement(getFirstFocusableElement());
             }
             else {
                 setActiveDescendant(undefined, currentFocusedElement);
@@ -387,7 +387,7 @@ function focusZone(container, settings) {
     }
     function getCurrentFocusedIndex() {
         if (!currentFocusedElement) {
-            return preventInitialFocus ? -1 : 0;
+            return 0;
         }
         const focusedIndex = focusableElements.indexOf(currentFocusedElement);
         const fallbackIndex = currentFocusedElement === container ? -1 : 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primer/behaviors",
-  "version": "0.0.0-20251203212431",
+  "version": "0.0.0-20251203213711",
   "description": "Shared behaviors for JavaScript components",
   "type": "commonjs",
   "main": "dist/cjs/index.js",
@@ -43,9 +43,7 @@
     "prebuild": "npm run clean",
     "release": "npm run build && changeset publish",
     "size-limit": "npm run build && size-limit",
-    "type-check": "tsc --noEmit",
-    "storybook": "storybook dev -p 6006 --no-open",
-    "build-storybook": "storybook build"
+    "type-check": "tsc --noEmit"
   },
   "repository": {
     "type": "git",
@@ -77,21 +75,17 @@
     "@github/prettier-config": "^0.0.6",
     "@rollup/plugin-typescript": "^12.1.0",
     "@rollup/wasm-node": "^4.19.1",
-    "@size-limit/preset-small-lib": "^12.0.0",
-    "@storybook/react-vite": "^10.0.8",
+    "@size-limit/preset-small-lib": "^11.1.4",
     "@testing-library/react": "^16.0.0",
     "@testing-library/user-event": "^14.5.1",
     "@types/jest": "^30.0.0",
     "@types/node": "^24.0.10",
     "@types/react": "^19.0.1",
-    "@types/react-dom": "^19.2.3",
-    "clsx": "^2.1.1",
     "esbuild": "^0.27.0",
     "esbuild-jest": "^0.5.0",
     "eslint": "^8.50.0",
     "eslint-plugin-github": "^5.0.0",
     "eslint-plugin-prettier": "^5.0.0",
-    "eslint-plugin-storybook": "^10.0.8",
     "jest": "^30.0.4",
     "jest-environment-jsdom": "^30.0.4",
     "prettier": "^3.0.3",
@@ -99,8 +93,7 @@
     "react-dom": "^19.0.0",
     "rimraf": "^6.0.1",
     "rollup": "^4.18.0",
-    "size-limit": "^12.0.0",
-    "storybook": "^10.0.8",
+    "size-limit": "^11.1.4",
     "tslib": "^2.8.1",
     "typescript": "^5.2.2"
   }