@salt-ds/lab 1.0.0-alpha.95 → 1.0.0-alpha.97

package/dist-cjs/mega-menu/MegaMenuListItem.js

@@ -0,0 +1,45 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var core = require('@salt-ds/core');
+var styles = require('@salt-ds/styles');
+var window = require('@salt-ds/window');
+var clsx = require('clsx');
+var react = require('react');
+var MegaMenuListItem$1 = require('./MegaMenuListItem.css.js');
+var useMegaMenu = require('./useMegaMenu.js');
+
+const withBaseName = core.makePrefixer("saltMegaMenuListItem");
+function MegaMenuListItemAction(props) {
+  return core.renderProps("a", props);
+}
+const MegaMenuListItem = react.forwardRef(function MegaMenuListItem2({ children, className, onClick, render, href, current, ...rest }, ref) {
+  const targetWindow = window.useWindow();
+  const megaMenu = useMegaMenu.useMegaMenu();
+  styles.useComponentCssInjection({
+    testId: "salt-mega-menu-list-item",
+    css: MegaMenuListItem$1,
+    window: targetWindow
+  });
+  const handleClick = (event) => {
+    onClick == null ? void 0 : onClick(event);
+    megaMenu.setOpen(false);
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx("li", { ref, className: clsx.clsx(withBaseName(), className), ...rest, children: /* @__PURE__ */ jsxRuntime.jsx(
+    MegaMenuListItemAction,
+    {
+      className: withBaseName("wrapper"),
+      href,
+      onClick: handleClick,
+      "aria-current": current ? "page" : void 0,
+      render,
+      children: react.Children.map(
+        children,
+        (child) => typeof child === "string" || typeof child === "number" ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: withBaseName("content"), children: child }) : child
+      )
+    }
+  ) });
+});
+
+exports.MegaMenuListItem = MegaMenuListItem;
+//# sourceMappingURL=MegaMenuListItem.js.map

package/dist-cjs/mega-menu/MegaMenuListItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MegaMenuListItem.js","sources":["../src/mega-menu/MegaMenuListItem.tsx"],"sourcesContent":["import { makePrefixer, type RenderPropsType, renderProps } from \"@salt-ds/core\";\nimport { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport {\n  Children,\n  type ComponentPropsWithoutRef,\n  forwardRef,\n  type MouseEventHandler,\n  type ReactNode,\n} from \"react\";\nimport megaMenuListItemCss from \"./MegaMenuListItem.css\";\nimport { useMegaMenu } from \"./useMegaMenu\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuListItem\");\n\n// biome-ignore lint/suspicious/noExplicitAny: We don't know the exact type here\nfunction MegaMenuListItemAction(props: ComponentPropsWithoutRef<any>) {\n  return renderProps(\"a\", props);\n}\n\nexport interface MegaMenuListItemProps\n  extends Omit<ComponentPropsWithoutRef<\"li\">, \"onClick\"> {\n  /**\n   * The content of the mega menu item.\n   */\n  children?: ReactNode;\n  /**\n   * Whether the item is the current page. Sets `aria-current=\"page\"`\n   */\n  current?: boolean;\n  /**\n   * Href passed to the link action element.\n   */\n  href?: string;\n  /**\n   * Called when the item's action is activated, before the menu closes.\n   */\n  onClick?: MouseEventHandler<HTMLAnchorElement>;\n  /**\n   * Render prop to enable customization of the underlying action element (e.g. a router `Link`).\n   */\n  render?: RenderPropsType[\"render\"];\n}\n\nexport const MegaMenuListItem = forwardRef<\n  HTMLLIElement,\n  MegaMenuListItemProps\n>(function MegaMenuListItem(\n  { children, className, onClick, render, href, current, ...rest },\n  ref,\n) {\n  const targetWindow = useWindow();\n  const megaMenu = useMegaMenu();\n\n  useComponentCssInjection({\n    testId: \"salt-mega-menu-list-item\",\n    css: megaMenuListItemCss,\n    window: targetWindow,\n  });\n\n  const handleClick: MouseEventHandler<HTMLAnchorElement> = (event) => {\n    onClick?.(event);\n    megaMenu.setOpen(false);\n  };\n\n  return (\n    <li ref={ref} className={clsx(withBaseName(), className)} {...rest}>\n      <MegaMenuListItemAction\n        className={withBaseName(\"wrapper\")}\n        href={href}\n        onClick={handleClick}\n        aria-current={current ? \"page\" : undefined}\n        render={render}\n      >\n        {Children.map(children, (child) =>\n          typeof child === \"string\" || typeof child === \"number\" ? (\n            <span className={withBaseName(\"content\")}>{child}</span>\n          ) : (\n            child\n          ),\n        )}\n      </MegaMenuListItemAction>\n    </li>\n  );\n});\n"],"names":["makePrefixer","renderProps","forwardRef","MegaMenuListItem","useWindow","useMegaMenu","useComponentCssInjection","megaMenuListItemCss","jsx","clsx","Children"],"mappings":";;;;;;;;;;;AAcA,MAAM,YAAA,GAAeA,kBAAa,sBAAsB,CAAA;AAGxD,SAAS,uBAAuB,KAAA,EAAsC;AACpE,EAAA,OAAOC,gBAAA,CAAY,KAAK,KAAK,CAAA;AAC/B;AA0BO,MAAM,gBAAA,GAAmBC,gBAAA,CAG9B,SAASC,iBAAAA,CACT,EAAE,QAAA,EAAU,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,IAAA,EAAM,OAAA,EAAS,GAAG,IAAA,IAC1D,GAAA,EACA;AACA,EAAA,MAAM,eAAeC,gBAAA,EAAU;AAC/B,EAAA,MAAM,WAAWC,uBAAA,EAAY;AAE7B,EAAAC,+BAAA,CAAyB;AAAA,IACvB,MAAA,EAAQ,0BAAA;AAAA,IACR,GAAA,EAAKC,kBAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACT,CAAA;AAED,EAAA,MAAM,WAAA,GAAoD,CAAC,KAAA,KAAU;AACnE,IAAA,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAU,KAAA,CAAA;AACV,IAAA,QAAA,CAAS,QAAQ,KAAK,CAAA;AAAA,EACxB,CAAA;AAEA,EAAA,uBACEC,cAAA,CAAC,IAAA,EAAA,EAAG,GAAA,EAAU,SAAA,EAAWC,SAAA,CAAK,cAAa,EAAG,SAAS,CAAA,EAAI,GAAG,IAAA,EAC5D,QAAA,kBAAAD,cAAA;AAAA,IAAC,sBAAA;AAAA,IAAA;AAAA,MACC,SAAA,EAAW,aAAa,SAAS,CAAA;AAAA,MACjC,IAAA;AAAA,MACA,OAAA,EAAS,WAAA;AAAA,MACT,cAAA,EAAc,UAAU,MAAA,GAAS,MAAA;AAAA,MACjC,MAAA;AAAA,MAEC,QAAA,EAAAE,cAAA,CAAS,GAAA;AAAA,QAAI,QAAA;AAAA,QAAU,CAAC,KAAA,KACvB,OAAO,KAAA,KAAU,YAAY,OAAO,KAAA,KAAU,QAAA,mBAC5CF,cAAA,CAAC,UAAK,SAAA,EAAW,YAAA,CAAa,SAAS,CAAA,EAAI,iBAAM,CAAA,GAEjD;AAAA;AAEJ;AAAA,GACF,EACF,CAAA;AAEJ,CAAC;;;;"}

package/dist-cjs/mega-menu/MegaMenuPanel.css.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var css_248z = ".saltMegaMenuPanel {\n  display: flex;\n  flex-wrap: wrap;\n  inline-size: var(--saltMegaMenuPanel-inlineSize, fit-content);\n  max-inline-size: var(--saltMegaMenuPanel-maxInlineSize, var(--saltMegaMenuPanel-availableWidth, calc(100vw - var(--salt-spacing-600))));\n  max-height: 90%;\n  overflow-x: hidden;\n  overflow-y: auto;\n  box-sizing: border-box;\n  border-radius: var(--salt-palette-corner);\n  border: var(--salt-size-fixed-100) var(--salt-borderStyle-solid) var(--salt-container-primary-borderColor);\n  background: var(--salt-container-primary-background);\n  box-shadow: var(--salt-overlayable-shadow-popout);\n}\n";
+var css_248z = ".saltMegaMenuPanel {\n  /* Single horizontal row: optional side content, the center navigation area,\n     optional side content. Position is derived from source order alone, so\n     authors need no wrapper scaffolding. */\n  --saltMegaMenuPanel-availableWidth: calc(100vw - var(--salt-spacing-600));\n  display: flex;\n  align-items: stretch;\n  inline-size: var(--saltMegaMenuPanel-inlineSize, fit-content);\n  max-inline-size: var(--saltMegaMenuPanel-maxInlineSize, var(--saltMegaMenuPanel-availableWidth));\n  max-block-size: 90vh;\n  overflow-x: hidden;\n  overflow-y: auto;\n  box-sizing: border-box;\n  border-radius: var(--salt-palette-corner, 0);\n  border: var(--salt-size-fixed-100) var(--salt-borderStyle-solid) var(--salt-container-primary-borderColor);\n  background: var(--salt-container-primary-background);\n  box-shadow: var(--salt-overlayable-shadow-modal);\n}\n";
 
 module.exports = css_248z;
 //# sourceMappingURL=MegaMenuPanel.css.js.map

package/dist-cjs/mega-menu/MegaMenuPanel.js

@@ -9,6 +9,8 @@ var clsx = require('clsx');
 var react = require('react');
 var MegaMenuPanel$1 = require('./MegaMenuPanel.css.js');
 var useMegaMenu = require('./useMegaMenu.js');
+var useMegaMenuNavigation = require('./useMegaMenuNavigation.js');
+var usePageMargin = require('./usePageMargin.js');
 
 const withBaseName = core.makePrefixer("saltMegaMenuPanel");
 const MegaMenuPanel = react.forwardRef(
@@ -26,51 +28,36 @@ const MegaMenuPanel = react.forwardRef(
       placement,
       getFloatingProps,
       setFloating,
-      focusFirstItemOnOpen,
+      focusFirstItemOnOpenRef,
       setPanelId
     } = useMegaMenu.useMegaMenu();
     const id = core.useId(idProp);
-    react.useEffect(() => {
-      setPanelId(id);
-      return () => setPanelId(void 0);
+    core.useIsomorphicLayoutEffect(() => {
+      if (id) setPanelId(id);
     }, [id, setPanelId]);
-    const [pageMargin, setPageMargin] = react.useState(0);
-    react.useEffect(() => {
-      if (!targetWindow) return;
-      const referenceEl = floatingRootContext.elements.domReference;
-      const host = referenceEl ?? targetWindow.document.body;
-      const doc = targetWindow.document;
-      const measure = () => {
-        const probe = doc.createElement("div");
-        probe.style.cssText = "position:absolute;visibility:hidden;pointer-events:none;width:var(--saltMegaMenuPanel-pageMargin, var(--salt-layout-page-margin));";
-        host.appendChild(probe);
-        const width = probe.getBoundingClientRect().width;
-        probe.remove();
-        setPageMargin((prev) => prev === width ? prev : width);
-      };
-      measure();
-      targetWindow.addEventListener("resize", measure);
-      return () => targetWindow.removeEventListener("resize", measure);
-    }, [targetWindow, floatingRootContext]);
+    const { domReference } = floatingRootContext.elements;
+    const referenceEl = domReference instanceof HTMLElement ? domReference : null;
+    const pageMargin = usePageMargin.usePageMargin(referenceEl);
     const floatingUIResult = core.useFloatingUI({
       rootContext: floatingRootContext,
+      open: isOpen,
       placement,
       middleware: [
         react$1.offset(1),
         react$1.flip({ padding: pageMargin }),
-        react$1.shift({ padding: pageMargin, limiter: react$1.limitShift() }),
-        react$1.size({
-          padding: pageMargin,
-          apply({ availableWidth, elements }) {
-            elements.floating.style.setProperty(
-              "--saltMegaMenuPanel-availableWidth",
-              `${availableWidth}px`
-            );
-          }
-        })
+        react$1.shift({ padding: pageMargin, limiter: react$1.limitShift() })
       ]
     });
-    const floatingProps = getFloatingProps();
+    const floatingEl = floatingRootContext.elements.floating;
+    const { isPositioned } = floatingUIResult;
+    react.useEffect(() => {
+      if (focusFirstItemOnOpenRef.current && isPositioned && floatingEl) {
+        useMegaMenuNavigation.focusFirstItem(floatingEl);
+        focusFirstItemOnOpenRef.current = false;
+      }
+    }, [focusFirstItemOnOpenRef, isPositioned, floatingEl]);
+    const floatingProps = getFloatingProps(rest);
+    const handleRef = core.useForkRef(setFloating, ref);
     return /* @__PURE__ */ jsxRuntime.jsx(
       FloatingComponent,
       {
@@ -81,24 +68,17 @@ const MegaMenuPanel = react.forwardRef(
         focusManagerProps: {
           context: floatingUIResult.context,
           modal: false,
-          initialFocus: focusFirstItemOnOpen ? 0 : -1,
+          initialFocus: -1,
           returnFocus: true,
           closeOnFocusOut: false,
           guards: false
         },
-        ref: setFloating,
-        children: /* @__PURE__ */ jsxRuntime.jsx(
-          "div",
-          {
-            className: clsx.clsx(withBaseName(), className),
-            id,
-            role: "region",
-            ref,
-            ...floatingProps,
-            ...rest,
-            children
-          }
-        )
+        className: clsx.clsx(withBaseName(), className),
+        id,
+        role: "region",
+        ...floatingProps,
+        ref: handleRef,
+        children
       }
     );
   }

package/dist-cjs/mega-menu/MegaMenuPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"MegaMenuPanel.js","sources":["../src/mega-menu/MegaMenuPanel.tsx"],"sourcesContent":["import { flip, limitShift, offset, shift, size } from \"@floating-ui/react\";\nimport {\n  makePrefixer,\n  useFloatingComponent,\n  useFloatingUI,\n  useId,\n} from \"@salt-ds/core\";\nimport { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport {\n  forwardRef,\n  type HTMLAttributes,\n  type ReactNode,\n  useEffect,\n  useState,\n} from \"react\";\nimport megaMenuPanelCss from \"./MegaMenuPanel.css\";\nimport { useMegaMenu } from \"./useMegaMenu\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuPanel\");\n\nexport interface MegaMenuPanelProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * The content of the mega menu panel.\n   */\n  children?: ReactNode;\n}\n\nexport const MegaMenuPanel = forwardRef<HTMLDivElement, MegaMenuPanelProps>(\n  function MegaMenuPanel({ children, className, id: idProp, ...rest }, ref) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-mega-menu-panel\",\n      css: megaMenuPanelCss,\n      window: targetWindow,\n    });\n\n    const { Component: FloatingComponent } = useFloatingComponent();\n    const {\n      openState: isOpen,\n      floatingRootContext,\n      placement,\n      getFloatingProps,\n      setFloating,\n      focusFirstItemOnOpen,\n      setPanelId,\n    } = useMegaMenu();\n\n    const id = useId(idProp);\n\n    // Register the panel id in context so the trigger can reference it via aria-controls.\n    useEffect(() => {\n      setPanelId(id);\n      return () => setPanelId(undefined);\n    }, [id, setPanelId]);\n\n    // Resolve the panel's page-margin to a pixel value to override the margin as required.\n    const [pageMargin, setPageMargin] = useState(0);\n    useEffect(() => {\n      if (!targetWindow) return;\n      const referenceEl = floatingRootContext.elements.domReference as\n        | HTMLElement\n        | null\n        | undefined;\n      const host = referenceEl ?? targetWindow.document.body;\n      const doc = targetWindow.document;\n      const measure = () => {\n        const probe = doc.createElement(\"div\");\n        probe.style.cssText =\n          \"position:absolute;visibility:hidden;pointer-events:none;width:var(--saltMegaMenuPanel-pageMargin, var(--salt-layout-page-margin));\";\n        host.appendChild(probe);\n        const width = probe.getBoundingClientRect().width;\n        probe.remove();\n        setPageMargin((prev) => (prev === width ? prev : width));\n      };\n      measure();\n      targetWindow.addEventListener(\"resize\", measure);\n      return () => targetWindow.removeEventListener(\"resize\", measure);\n    }, [targetWindow, floatingRootContext]);\n\n    const floatingUIResult = useFloatingUI({\n      rootContext: floatingRootContext,\n      placement,\n      middleware: [\n        offset(1),\n        flip({ padding: pageMargin }),\n        shift({ padding: pageMargin, limiter: limitShift() }),\n        size({\n          padding: pageMargin,\n          apply({ availableWidth, elements }) {\n            elements.floating.style.setProperty(\n              \"--saltMegaMenuPanel-availableWidth\",\n              `${availableWidth}px`,\n            );\n          },\n        }),\n      ],\n    });\n\n    const floatingProps = getFloatingProps();\n\n    return (\n      <FloatingComponent\n        open={isOpen}\n        position={floatingUIResult.strategy}\n        top={floatingUIResult.y ?? 0}\n        left={floatingUIResult.x ?? 0}\n        focusManagerProps={{\n          context: floatingUIResult.context,\n          modal: false,\n          initialFocus: focusFirstItemOnOpen ? 0 : -1,\n          returnFocus: true,\n          closeOnFocusOut: false,\n          guards: false,\n        }}\n        ref={setFloating}\n      >\n        <div\n          className={clsx(withBaseName(), className)}\n          id={id}\n          role=\"region\"\n          ref={ref}\n          {...floatingProps}\n          {...rest}\n        >\n          {children}\n        </div>\n      </FloatingComponent>\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","MegaMenuPanel","useWindow","useComponentCssInjection","megaMenuPanelCss","useFloatingComponent","useMegaMenu","useId","useEffect","useState","useFloatingUI","offset","flip","shift","limitShift","size","jsx","clsx"],"mappings":";;;;;;;;;;;;AAoBA,MAAM,YAAA,GAAeA,kBAAa,mBAAmB,CAAA;AAS9C,MAAM,aAAA,GAAgBC,gBAAA;AAAA,EAC3B,SAASC,cAAAA,CAAc,EAAE,QAAA,EAAU,SAAA,EAAW,IAAI,MAAA,EAAQ,GAAG,IAAA,EAAK,EAAG,GAAA,EAAK;AACxE,IAAA,MAAM,eAAeC,gBAAA,EAAU;AAC/B,IAAAC,+BAAA,CAAyB;AAAA,MACvB,MAAA,EAAQ,sBAAA;AAAA,MACR,GAAA,EAAKC,eAAA;AAAA,MACL,MAAA,EAAQ;AAAA,KACT,CAAA;AAED,IAAA,MAAM,EAAE,SAAA,EAAW,iBAAA,EAAkB,GAAIC,yBAAA,EAAqB;AAC9D,IAAA,MAAM;AAAA,MACJ,SAAA,EAAW,MAAA;AAAA,MACX,mBAAA;AAAA,MACA,SAAA;AAAA,MACA,gBAAA;AAAA,MACA,WAAA;AAAA,MACA,oBAAA;AAAA,MACA;AAAA,QACEC,uBAAA,EAAY;AAEhB,IAAA,MAAM,EAAA,GAAKC,WAAM,MAAM,CAAA;AAGvB,IAAAC,eAAA,CAAU,MAAM;AACd,MAAA,UAAA,CAAW,EAAE,CAAA;AACb,MAAA,OAAO,MAAM,WAAW,MAAS,CAAA;AAAA,IACnC,CAAA,EAAG,CAAC,EAAA,EAAI,UAAU,CAAC,CAAA;AAGnB,IAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAIC,eAAS,CAAC,CAAA;AAC9C,IAAAD,eAAA,CAAU,MAAM;AACd,MAAA,IAAI,CAAC,YAAA,EAAc;AACnB,MAAA,MAAM,WAAA,GAAc,oBAAoB,QAAA,CAAS,YAAA;AAIjD,MAAA,MAAM,IAAA,GAAO,WAAA,IAAe,YAAA,CAAa,QAAA,CAAS,IAAA;AAClD,MAAA,MAAM,MAAM,YAAA,CAAa,QAAA;AACzB,MAAA,MAAM,UAAU,MAAM;AACpB,QAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,aAAA,CAAc,KAAK,CAAA;AACrC,QAAA,KAAA,CAAM,MAAM,OAAA,GACV,oIAAA;AACF,QAAA,IAAA,CAAK,YAAY,KAAK,CAAA;AACtB,QAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,qBAAA,EAAsB,CAAE,KAAA;AAC5C,QAAA,KAAA,CAAM,MAAA,EAAO;AACb,QAAA,aAAA,CAAc,CAAC,IAAA,KAAU,IAAA,KAAS,KAAA,GAAQ,OAAO,KAAM,CAAA;AAAA,MACzD,CAAA;AACA,MAAA,OAAA,EAAQ;AACR,MAAA,YAAA,CAAa,gBAAA,CAAiB,UAAU,OAAO,CAAA;AAC/C,MAAA,OAAO,MAAM,YAAA,CAAa,mBAAA,CAAoB,QAAA,EAAU,OAAO,CAAA;AAAA,IACjE,CAAA,EAAG,CAAC,YAAA,EAAc,mBAAmB,CAAC,CAAA;AAEtC,IAAA,MAAM,mBAAmBE,kBAAA,CAAc;AAAA,MACrC,WAAA,EAAa,mBAAA;AAAA,MACb,SAAA;AAAA,MACA,UAAA,EAAY;AAAA,QACVC,eAAO,CAAC,CAAA;AAAA,QACRC,YAAA,CAAK,EAAE,OAAA,EAAS,UAAA,EAAY,CAAA;AAAA,QAC5BC,cAAM,EAAE,OAAA,EAAS,YAAY,OAAA,EAASC,kBAAA,IAAc,CAAA;AAAA,QACpDC,YAAA,CAAK;AAAA,UACH,OAAA,EAAS,UAAA;AAAA,UACT,KAAA,CAAM,EAAE,cAAA,EAAgB,QAAA,EAAS,EAAG;AAClC,YAAA,QAAA,CAAS,SAAS,KAAA,CAAM,WAAA;AAAA,cACtB,oCAAA;AAAA,cACA,GAAG,cAAc,CAAA,EAAA;AAAA,aACnB;AAAA,UACF;AAAA,SACD;AAAA;AACH,KACD,CAAA;AAED,IAAA,MAAM,gBAAgB,gBAAA,EAAiB;AAEvC,IAAA,uBACEC,cAAA;AAAA,MAAC,iBAAA;AAAA,MAAA;AAAA,QACC,IAAA,EAAM,MAAA;AAAA,QACN,UAAU,gBAAA,CAAiB,QAAA;AAAA,QAC3B,GAAA,EAAK,iBAAiB,CAAA,IAAK,CAAA;AAAA,QAC3B,IAAA,EAAM,iBAAiB,CAAA,IAAK,CAAA;AAAA,QAC5B,iBAAA,EAAmB;AAAA,UACjB,SAAS,gBAAA,CAAiB,OAAA;AAAA,UAC1B,KAAA,EAAO,KAAA;AAAA,UACP,YAAA,EAAc,uBAAuB,CAAA,GAAI,EAAA;AAAA,UACzC,WAAA,EAAa,IAAA;AAAA,UACb,eAAA,EAAiB,KAAA;AAAA,UACjB,MAAA,EAAQ;AAAA,SACV;AAAA,QACA,GAAA,EAAK,WAAA;AAAA,QAEL,QAAA,kBAAAA,cAAA;AAAA,UAAC,KAAA;AAAA,UAAA;AAAA,YACC,SAAA,EAAWC,SAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA;AAAA,YACzC,EAAA;AAAA,YACA,IAAA,EAAK,QAAA;AAAA,YACL,GAAA;AAAA,YACC,GAAG,aAAA;AAAA,YACH,GAAG,IAAA;AAAA,YAEH;AAAA;AAAA;AACH;AAAA,KACF;AAAA,EAEJ;AACF;;;;"}
+{"version":3,"file":"MegaMenuPanel.js","sources":["../src/mega-menu/MegaMenuPanel.tsx"],"sourcesContent":["import { flip, limitShift, offset, shift } from \"@floating-ui/react\";\nimport {\n  makePrefixer,\n  useFloatingComponent,\n  useFloatingUI,\n  useForkRef,\n  useId,\n  useIsomorphicLayoutEffect,\n} from \"@salt-ds/core\";\nimport { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport {\n  type ComponentPropsWithoutRef,\n  forwardRef,\n  type ReactNode,\n  useEffect,\n} from \"react\";\nimport megaMenuPanelCss from \"./MegaMenuPanel.css\";\nimport { useMegaMenu } from \"./useMegaMenu\";\nimport { focusFirstItem } from \"./useMegaMenuNavigation\";\nimport { usePageMargin } from \"./usePageMargin\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuPanel\");\n\nexport interface MegaMenuPanelProps extends ComponentPropsWithoutRef<\"div\"> {\n  /**\n   * The content of the mega menu panel.\n   */\n  children?: ReactNode;\n}\n\nexport const MegaMenuPanel = forwardRef<HTMLDivElement, MegaMenuPanelProps>(\n  function MegaMenuPanel({ children, className, id: idProp, ...rest }, ref) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-mega-menu-panel\",\n      css: megaMenuPanelCss,\n      window: targetWindow,\n    });\n\n    const { Component: FloatingComponent } = useFloatingComponent();\n    const {\n      openState: isOpen,\n      floatingRootContext,\n      placement,\n      getFloatingProps,\n      setFloating,\n      focusFirstItemOnOpenRef,\n      setPanelId,\n    } = useMegaMenu();\n\n    const id = useId(idProp);\n\n    // Register the panel's id so the trigger's aria-controls stays in sync.\n    useIsomorphicLayoutEffect(() => {\n      if (id) setPanelId(id);\n    }, [id, setPanelId]);\n\n    const { domReference } = floatingRootContext.elements;\n    const referenceEl =\n      domReference instanceof HTMLElement ? domReference : null;\n    const pageMargin = usePageMargin(referenceEl);\n\n    const floatingUIResult = useFloatingUI({\n      rootContext: floatingRootContext,\n      open: isOpen,\n      placement,\n      middleware: [\n        offset(1),\n        flip({ padding: pageMargin }),\n        shift({ padding: pageMargin, limiter: limitShift() }),\n      ],\n    });\n\n    // Focus the first item on ArrowDown open, after floating-ui has positioned the panel\n    const floatingEl = floatingRootContext.elements.floating;\n    const { isPositioned } = floatingUIResult;\n    useEffect(() => {\n      if (focusFirstItemOnOpenRef.current && isPositioned && floatingEl) {\n        focusFirstItem(floatingEl);\n        focusFirstItemOnOpenRef.current = false;\n      }\n    }, [focusFirstItemOnOpenRef, isPositioned, floatingEl]);\n\n    const floatingProps = getFloatingProps(rest);\n    const handleRef = useForkRef<HTMLDivElement>(setFloating, ref);\n\n    return (\n      <FloatingComponent\n        open={isOpen}\n        position={floatingUIResult.strategy}\n        top={floatingUIResult.y ?? 0}\n        left={floatingUIResult.x ?? 0}\n        focusManagerProps={{\n          context: floatingUIResult.context,\n          modal: false,\n          initialFocus: -1,\n          returnFocus: true,\n          closeOnFocusOut: false,\n          guards: false,\n        }}\n        className={clsx(withBaseName(), className)}\n        id={id}\n        role=\"region\"\n        {...floatingProps}\n        ref={handleRef}\n      >\n        {children}\n      </FloatingComponent>\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","MegaMenuPanel","useWindow","useComponentCssInjection","megaMenuPanelCss","useFloatingComponent","useMegaMenu","useId","useIsomorphicLayoutEffect","usePageMargin","useFloatingUI","offset","flip","shift","limitShift","useEffect","focusFirstItem","useForkRef","jsx","clsx"],"mappings":"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"}

package/dist-cjs/mega-menu/MegaMenuTrigger.js

@@ -4,25 +4,25 @@ var jsxRuntime = require('react/jsx-runtime');
 var core = require('@salt-ds/core');
 var react = require('react');
 var useMegaMenu = require('./useMegaMenu.js');
-var useMegaMenuKeyboard = require('./useMegaMenuKeyboard.js');
+var useMegaMenuNavigation = require('./useMegaMenuNavigation.js');
 
 function getAdjacentTrigger(currentTarget, direction) {
   const li = currentTarget.closest("li");
   if (!li) return null;
   const sibling = direction === "next" ? li.nextElementSibling : li.previousElementSibling;
   if (!(sibling instanceof HTMLElement)) return null;
-  return sibling.querySelector(useMegaMenuKeyboard.FOCUSABLE_SELECTOR);
+  return sibling.querySelector(useMegaMenuNavigation.FOCUSABLE_SELECTOR);
 }
 const MegaMenuTrigger = react.forwardRef(
   function MegaMenuTrigger2(props, ref) {
-    const { children, ...rest } = props;
+    const { children } = props;
     const megaMenu = useMegaMenu.useMegaMenu();
     const {
       getReferenceProps,
       setReference,
       setOpen,
       openState,
-      setFocusFirstItemOnOpen,
+      focusFirstItemOnOpenRef,
       floatingRootContext,
       panelId
     } = megaMenu;
@@ -35,7 +35,7 @@ const MegaMenuTrigger = react.forwardRef(
           const adjacent = getAdjacentTrigger(event.currentTarget, direction);
           if (adjacent) {
             if (openState) setOpen(false);
-            setFocusFirstItemOnOpen(false);
+            focusFirstItemOnOpenRef.current = false;
             adjacent.focus();
           }
           return;
@@ -43,22 +43,22 @@ const MegaMenuTrigger = react.forwardRef(
         if (openState && (key === "ArrowDown" || key === "Tab" && !shiftKey)) {
           event.preventDefault();
           const floating = floatingRootContext.elements.floating;
-          if (floating) useMegaMenuKeyboard.focusFirstItem(floating);
+          if (floating) useMegaMenuNavigation.focusFirstItem(floating);
+          return;
+        }
+        if (openState && key === "Tab" && shiftKey) {
+          focusFirstItemOnOpenRef.current = false;
+          setOpen(false);
           return;
         }
         if (!openState && key === "ArrowDown") {
           event.preventDefault();
-          setFocusFirstItemOnOpen(true);
+          focusFirstItemOnOpenRef.current = true;
           setOpen(true);
           return;
         }
       },
-      [
-        openState,
-        setOpen,
-        setFocusFirstItemOnOpen,
-        floatingRootContext.elements.floating
-      ]
+      [openState, setOpen, floatingRootContext.elements.floating]
     );
     const handleFloatingRef = core.useForkRef(
       core.getRefFromChildren(children),
@@ -74,12 +74,10 @@ const MegaMenuTrigger = react.forwardRef(
     return react.cloneElement(children, {
       ...core.mergeProps(
         getReferenceProps({
-          // For NavigationItem, sync via the `expanded` prop (which maps to aria-expanded internally).
-          // For all other elements, set aria-expanded directly.
+          // NavigationItem maps `expanded` to aria-expanded; others get it directly.
           ...shouldSyncExpanded ? { expanded: openState } : { "aria-expanded": openState },
-          ...panelId && openState ? { "aria-controls": panelId } : null,
-          onKeyDown: handleKeyDown,
-          ...rest
+          ...openState ? { "aria-controls": panelId } : null,
+          onKeyDown: handleKeyDown
         }),
         children.props
       ),

package/dist-cjs/mega-menu/MegaMenuTrigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"MegaMenuTrigger.js","sources":["../src/mega-menu/MegaMenuTrigger.tsx"],"sourcesContent":["import {\n  getRefFromChildren,\n  mergeProps,\n  NavigationItem,\n  useForkRef,\n} from \"@salt-ds/core\";\nimport {\n  cloneElement,\n  forwardRef,\n  isValidElement,\n  type KeyboardEvent,\n  type ReactNode,\n  type Ref,\n  useCallback,\n} from \"react\";\nimport { useMegaMenu } from \"./useMegaMenu\";\nimport { FOCUSABLE_SELECTOR, focusFirstItem } from \"./useMegaMenuKeyboard\";\n\nexport interface MegaMenuTriggerProps {\n  /**\n   * The trigger element for the mega menu, typically a `NavigationItem` or `Button`.\n   */\n  children?: ReactNode;\n}\n\nfunction getAdjacentTrigger(\n  currentTarget: HTMLElement,\n  direction: \"next\" | \"previous\",\n): HTMLElement | null {\n  const li = currentTarget.closest(\"li\");\n  if (!li) return null;\n  const sibling =\n    direction === \"next\" ? li.nextElementSibling : li.previousElementSibling;\n  if (!(sibling instanceof HTMLElement)) return null;\n  return sibling.querySelector<HTMLElement>(FOCUSABLE_SELECTOR);\n}\n\nexport const MegaMenuTrigger = forwardRef<HTMLElement, MegaMenuTriggerProps>(\n  function MegaMenuTrigger(props, ref) {\n    const { children, ...rest } = props;\n    const megaMenu = useMegaMenu();\n\n    const {\n      getReferenceProps,\n      setReference,\n      setOpen,\n      openState,\n      setFocusFirstItemOnOpen,\n      floatingRootContext,\n      panelId,\n    } = megaMenu;\n\n    const handleKeyDown = useCallback(\n      (event: KeyboardEvent<HTMLElement>) => {\n        const { key, shiftKey } = event;\n\n        // ArrowLeft/Right: move to adjacent trigger in nav bar\n        if (key === \"ArrowRight\" || key === \"ArrowLeft\") {\n          event.preventDefault();\n          const direction = key === \"ArrowRight\" ? \"next\" : \"previous\";\n          const adjacent = getAdjacentTrigger(event.currentTarget, direction);\n          if (adjacent) {\n            if (openState) setOpen(false);\n            setFocusFirstItemOnOpen(false);\n            adjacent.focus();\n          }\n          return;\n        }\n\n        // When menu is open: ArrowDown or Tab moves focus into the menu\n        if (\n          openState &&\n          (key === \"ArrowDown\" || (key === \"Tab\" && !shiftKey))\n        ) {\n          event.preventDefault();\n          const floating = floatingRootContext.elements\n            .floating as HTMLElement | null;\n          if (floating) focusFirstItem(floating);\n          return;\n        }\n\n        // When menu is closed: ArrowDown opens and focuses first item\n        if (!openState && key === \"ArrowDown\") {\n          event.preventDefault();\n          setFocusFirstItemOnOpen(true);\n          setOpen(true);\n          return;\n        }\n      },\n      [\n        openState,\n        setOpen,\n        setFocusFirstItemOnOpen,\n        floatingRootContext.elements.floating,\n      ],\n    );\n\n    const handleFloatingRef = useForkRef(\n      getRefFromChildren(children),\n      setReference,\n    );\n    const handleRef = useForkRef(handleFloatingRef, ref);\n\n    if (!children || !isValidElement<{ ref?: Ref<unknown> }>(children)) {\n      return <>{children}</>;\n    }\n\n    const childProps = children.props as Record<string, unknown>;\n    const isNavigationItemChild = children.type === NavigationItem;\n    const shouldSyncExpanded =\n      isNavigationItemChild || childProps.expanded !== undefined;\n\n    return cloneElement(children, {\n      ...mergeProps(\n        getReferenceProps({\n          // For NavigationItem, sync via the `expanded` prop (which maps to aria-expanded internally).\n          // For all other elements, set aria-expanded directly.\n          ...(shouldSyncExpanded\n            ? { expanded: openState }\n            : { \"aria-expanded\": openState }),\n          ...(panelId && openState ? { \"aria-controls\": panelId } : null),\n          onKeyDown: handleKeyDown,\n          ...rest,\n        }),\n        children.props,\n      ),\n      ref: handleRef,\n    });\n  },\n);\n"],"names":["FOCUSABLE_SELECTOR","forwardRef","MegaMenuTrigger","useMegaMenu","useCallback","useForkRef","getRefFromChildren","isValidElement","NavigationItem","cloneElement","mergeProps"],"mappings":"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"}
+{"version":3,"file":"MegaMenuTrigger.js","sources":["../src/mega-menu/MegaMenuTrigger.tsx"],"sourcesContent":["import {\n  getRefFromChildren,\n  mergeProps,\n  NavigationItem,\n  useForkRef,\n} from \"@salt-ds/core\";\nimport {\n  cloneElement,\n  forwardRef,\n  isValidElement,\n  type KeyboardEvent,\n  type ReactNode,\n  type Ref,\n  useCallback,\n} from \"react\";\nimport { useMegaMenu } from \"./useMegaMenu\";\nimport { FOCUSABLE_SELECTOR, focusFirstItem } from \"./useMegaMenuNavigation\";\n\nexport interface MegaMenuTriggerProps {\n  /**\n   * The trigger element for the mega menu, typically a `NavigationItem` or `Button`.\n   * Wrap each mega menu in its own `<li>` — arrow-key navigation between triggers depends on it.\n   */\n  children?: ReactNode;\n}\n\nfunction getAdjacentTrigger(\n  currentTarget: HTMLElement,\n  direction: \"next\" | \"previous\",\n): HTMLElement | null {\n  const li = currentTarget.closest(\"li\");\n  if (!li) return null;\n  const sibling =\n    direction === \"next\" ? li.nextElementSibling : li.previousElementSibling;\n  if (!(sibling instanceof HTMLElement)) return null;\n  return sibling.querySelector<HTMLElement>(FOCUSABLE_SELECTOR);\n}\n\nexport const MegaMenuTrigger = forwardRef<HTMLElement, MegaMenuTriggerProps>(\n  function MegaMenuTrigger(props, ref) {\n    const { children } = props;\n    const megaMenu = useMegaMenu();\n\n    const {\n      getReferenceProps,\n      setReference,\n      setOpen,\n      openState,\n      focusFirstItemOnOpenRef,\n      floatingRootContext,\n      panelId,\n    } = megaMenu;\n\n    const handleKeyDown = useCallback(\n      (event: KeyboardEvent<HTMLElement>) => {\n        const { key, shiftKey } = event;\n\n        // ArrowLeft/Right: move to adjacent trigger in nav bar\n        if (key === \"ArrowRight\" || key === \"ArrowLeft\") {\n          event.preventDefault();\n          const direction = key === \"ArrowRight\" ? \"next\" : \"previous\";\n          const adjacent = getAdjacentTrigger(event.currentTarget, direction);\n          if (adjacent) {\n            if (openState) setOpen(false);\n            focusFirstItemOnOpenRef.current = false;\n            adjacent.focus();\n          }\n          return;\n        }\n\n        // When menu is open: ArrowDown or Tab moves focus into the menu\n        if (\n          openState &&\n          (key === \"ArrowDown\" || (key === \"Tab\" && !shiftKey))\n        ) {\n          event.preventDefault();\n          const floating = floatingRootContext.elements\n            .floating as HTMLElement | null;\n          if (floating) focusFirstItem(floating);\n          return;\n        }\n\n        // When menu is open: Shift+Tab mirrors arrow left\n        if (openState && key === \"Tab\" && shiftKey) {\n          focusFirstItemOnOpenRef.current = false;\n          setOpen(false);\n          return;\n        }\n\n        // When menu is closed: ArrowDown opens and focuses first item\n        if (!openState && key === \"ArrowDown\") {\n          event.preventDefault();\n          focusFirstItemOnOpenRef.current = true;\n          setOpen(true);\n          return;\n        }\n      },\n      [openState, setOpen, floatingRootContext.elements.floating],\n    );\n\n    const handleFloatingRef = useForkRef(\n      getRefFromChildren(children),\n      setReference,\n    );\n    const handleRef = useForkRef(handleFloatingRef, ref);\n\n    if (!children || !isValidElement<{ ref?: Ref<unknown> }>(children)) {\n      return <>{children}</>;\n    }\n\n    const childProps = children.props as Record<string, unknown>;\n    const isNavigationItemChild = children.type === NavigationItem;\n    const shouldSyncExpanded =\n      isNavigationItemChild || childProps.expanded !== undefined;\n\n    return cloneElement(children, {\n      ...mergeProps(\n        getReferenceProps({\n          // NavigationItem maps `expanded` to aria-expanded; others get it directly.\n          ...(shouldSyncExpanded\n            ? { expanded: openState }\n            : { \"aria-expanded\": openState }),\n          ...(openState ? { \"aria-controls\": panelId } : null),\n          onKeyDown: handleKeyDown,\n        }),\n        children.props,\n      ),\n      ref: handleRef,\n    });\n  },\n);\n"],"names":["FOCUSABLE_SELECTOR","forwardRef","MegaMenuTrigger","useMegaMenu","useCallback","useForkRef","getRefFromChildren","isValidElement","NavigationItem","cloneElement","mergeProps"],"mappings":";;;;;;;;AA0BA,SAAS,kBAAA,CACP,eACA,SAAA,EACoB;AACpB,EAAA,MAAM,EAAA,GAAK,aAAA,CAAc,OAAA,CAAQ,IAAI,CAAA;AACrC,EAAA,IAAI,CAAC,IAAI,OAAO,IAAA;AAChB,EAAA,MAAM,OAAA,GACJ,SAAA,KAAc,MAAA,GAAS,EAAA,CAAG,qBAAqB,EAAA,CAAG,sBAAA;AACpD,EAAA,IAAI,EAAE,OAAA,YAAmB,WAAA,CAAA,EAAc,OAAO,IAAA;AAC9C,EAAA,OAAO,OAAA,CAAQ,cAA2BA,wCAAkB,CAAA;AAC9D;AAEO,MAAM,eAAA,GAAkBC,gBAAA;AAAA,EAC7B,SAASC,gBAAAA,CAAgB,KAAA,EAAO,GAAA,EAAK;AACnC,IAAA,MAAM,EAAE,UAAS,GAAI,KAAA;AACrB,IAAA,MAAM,WAAWC,uBAAA,EAAY;AAE7B,IAAA,MAAM;AAAA,MACJ,iBAAA;AAAA,MACA,YAAA;AAAA,MACA,OAAA;AAAA,MACA,SAAA;AAAA,MACA,uBAAA;AAAA,MACA,mBAAA;AAAA,MACA;AAAA,KACF,GAAI,QAAA;AAEJ,IAAA,MAAM,aAAA,GAAgBC,iBAAA;AAAA,MACpB,CAAC,KAAA,KAAsC;AACrC,QAAA,MAAM,EAAE,GAAA,EAAK,QAAA,EAAS,GAAI,KAAA;AAG1B,QAAA,IAAI,GAAA,KAAQ,YAAA,IAAgB,GAAA,KAAQ,WAAA,EAAa;AAC/C,UAAA,KAAA,CAAM,cAAA,EAAe;AACrB,UAAA,MAAM,SAAA,GAAY,GAAA,KAAQ,YAAA,GAAe,MAAA,GAAS,UAAA;AAClD,UAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,KAAA,CAAM,aAAA,EAAe,SAAS,CAAA;AAClE,UAAA,IAAI,QAAA,EAAU;AACZ,YAAA,IAAI,SAAA,UAAmB,KAAK,CAAA;AAC5B,YAAA,uBAAA,CAAwB,OAAA,GAAU,KAAA;AAClC,YAAA,QAAA,CAAS,KAAA,EAAM;AAAA,UACjB;AACA,UAAA;AAAA,QACF;AAGA,QAAA,IACE,cACC,GAAA,KAAQ,WAAA,IAAgB,GAAA,KAAQ,KAAA,IAAS,CAAC,QAAA,CAAA,EAC3C;AACA,UAAA,KAAA,CAAM,cAAA,EAAe;AACrB,UAAA,MAAM,QAAA,GAAW,oBAAoB,QAAA,CAClC,QAAA;AACH,UAAA,IAAI,QAAA,uCAAyB,QAAQ,CAAA;AACrC,UAAA;AAAA,QACF;AAGA,QAAA,IAAI,SAAA,IAAa,GAAA,KAAQ,KAAA,IAAS,QAAA,EAAU;AAC1C,UAAA,uBAAA,CAAwB,OAAA,GAAU,KAAA;AAClC,UAAA,OAAA,CAAQ,KAAK,CAAA;AACb,UAAA;AAAA,QACF;AAGA,QAAA,IAAI,CAAC,SAAA,IAAa,GAAA,KAAQ,WAAA,EAAa;AACrC,UAAA,KAAA,CAAM,cAAA,EAAe;AACrB,UAAA,uBAAA,CAAwB,OAAA,GAAU,IAAA;AAClC,UAAA,OAAA,CAAQ,IAAI,CAAA;AACZ,UAAA;AAAA,QACF;AAAA,MACF,CAAA;AAAA,MACA,CAAC,SAAA,EAAW,OAAA,EAAS,mBAAA,CAAoB,SAAS,QAAQ;AAAA,KAC5D;AAEA,IAAA,MAAM,iBAAA,GAAoBC,eAAA;AAAA,MACxBC,wBAAmB,QAAQ,CAAA;AAAA,MAC3B;AAAA,KACF;AACA,IAAA,MAAM,SAAA,GAAYD,eAAA,CAAW,iBAAA,EAAmB,GAAG,CAAA;AAEnD,IAAA,IAAI,CAAC,QAAA,IAAY,CAACE,oBAAA,CAAuC,QAAQ,CAAA,EAAG;AAClE,MAAA,6DAAU,QAAA,EAAS,CAAA;AAAA,IACrB;AAEA,IAAA,MAAM,aAAa,QAAA,CAAS,KAAA;AAC5B,IAAA,MAAM,qBAAA,GAAwB,SAAS,IAAA,KAASC,mBAAA;AAChD,IAAA,MAAM,kBAAA,GACJ,qBAAA,IAAyB,UAAA,CAAW,QAAA,KAAa,MAAA;AAEnD,IAAA,OAAOC,mBAAa,QAAA,EAAU;AAAA,MAC5B,GAAGC,eAAA;AAAA,QACD,iBAAA,CAAkB;AAAA;AAAA,UAEhB,GAAI,qBACA,EAAE,QAAA,EAAU,WAAU,GACtB,EAAE,iBAAiB,SAAA,EAAU;AAAA,UACjC,GAAI,SAAA,GAAY,EAAE,eAAA,EAAiB,SAAQ,GAAI,IAAA;AAAA,UAC/C,SAAA,EAAW;AAAA,SACZ,CAAA;AAAA,QACD,QAAA,CAAS;AAAA,OACX;AAAA,MACA,GAAA,EAAK;AAAA,KACN,CAAA;AAAA,EACH;AACF;;;;"}

package/dist-cjs/mega-menu/useMegaMenuNavigation.js

@@ -0,0 +1,282 @@
+'use strict';
+
+var react = require('react');
+
+const COLUMN_SELECTOR = "[data-mega-menu-column]";
+const ACTIONS_SELECTOR = "[data-mega-menu-actions]";
+const FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), [tabindex]:not([tabindex="-1"])';
+const SELF_CONSUMING_SELECTOR = 'input, textarea, select, [contenteditable], [role="combobox"], [role="listbox"], [role="slider"], [role="spinbutton"], [role="textbox"]';
+const HIDDEN_ANCESTOR_SELECTOR = '[aria-hidden="true"], [inert]';
+function queryFocusables(root) {
+  return Array.from(
+    root.querySelectorAll(FOCUSABLE_SELECTOR)
+  ).filter((el) => !el.closest(HIDDEN_ANCESTOR_SELECTOR));
+}
+function firstFocusable(root) {
+  return root ? queryFocusables(root)[0] ?? null : null;
+}
+function buildModel(panel) {
+  const columns = Array.from(
+    panel.querySelectorAll(COLUMN_SELECTOR)
+  ).filter((el) => queryFocusables(el).length > 0);
+  const actions = Array.from(
+    panel.querySelectorAll(ACTIONS_SELECTOR)
+  ).filter((el) => queryFocusables(el).length > 0);
+  return { columns, actions };
+}
+function focusTrigger(context) {
+  var _a;
+  const reference = context.elements.reference;
+  (_a = firstFocusable(reference) ?? reference) == null ? void 0 : _a.focus();
+}
+function focusNextTriggerAndClose(context) {
+  const reference = context.elements.reference;
+  const trigger = firstFocusable(reference) ?? reference;
+  const li = trigger == null ? void 0 : trigger.closest("li");
+  const next = (li == null ? void 0 : li.nextElementSibling) instanceof HTMLElement ? firstFocusable(li.nextElementSibling) : null;
+  if (next) {
+    context.onOpenChange(false);
+    next.focus();
+    return true;
+  }
+  return false;
+}
+function columnsStacked(columns) {
+  if (columns.length < 2) return false;
+  const first = columns[0].getBoundingClientRect();
+  const second = columns[1].getBoundingClientRect();
+  return second.top >= first.bottom - 1;
+}
+function handleLinear(key, cell, panel, context) {
+  var _a, _b;
+  const cells = queryFocusables(panel);
+  const index = cells.indexOf(cell);
+  if (index === -1) return false;
+  switch (key) {
+    case "ArrowDown":
+    case "ArrowRight": {
+      if (index < cells.length - 1) {
+        cells[index + 1].focus();
+      }
+      return true;
+    }
+    case "ArrowUp":
+    case "ArrowLeft": {
+      if (index > 0) {
+        cells[index - 1].focus();
+      } else {
+        focusTrigger(context);
+      }
+      return true;
+    }
+    case "Home": {
+      (_a = cells[0]) == null ? void 0 : _a.focus();
+      return true;
+    }
+    case "End": {
+      (_b = cells[cells.length - 1]) == null ? void 0 : _b.focus();
+      return true;
+    }
+    default:
+      return false;
+  }
+}
+function handleArrow(key, cell, panel, context) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  const { columns, actions } = buildModel(panel);
+  if (columnsStacked(columns)) {
+    return handleLinear(key, cell, panel, context);
+  }
+  const column = cell.closest(COLUMN_SELECTOR);
+  const actionsEl = cell.closest(ACTIONS_SELECTOR);
+  if (column) {
+    const colIndex = columns.indexOf(column);
+    const cells = queryFocusables(column);
+    const rowIndex = cells.indexOf(cell);
+    switch (key) {
+      case "ArrowDown": {
+        if (rowIndex < cells.length - 1) {
+          cells[rowIndex + 1].focus();
+        } else if (colIndex < columns.length - 1) {
+          (_a = firstFocusable(columns[colIndex + 1])) == null ? void 0 : _a.focus();
+        } else if (actions.length > 0) {
+          (_b = firstFocusable(actions[0])) == null ? void 0 : _b.focus();
+        } else {
+          focusNextTriggerAndClose(context);
+        }
+        return true;
+      }
+      case "ArrowUp": {
+        if (rowIndex > 0) {
+          cells[rowIndex - 1].focus();
+        } else {
+          focusTrigger(context);
+        }
+        return true;
+      }
+      case "ArrowRight": {
+        if (colIndex < columns.length - 1) {
+          (_c = firstFocusable(columns[colIndex + 1])) == null ? void 0 : _c.focus();
+          return true;
+        }
+        if (rowIndex === cells.length - 1 && focusNextTriggerAndClose(context)) {
+          return true;
+        }
+        focusTrigger(context);
+        return true;
+      }
+      case "ArrowLeft": {
+        if (colIndex > 0) {
+          (_d = firstFocusable(columns[colIndex - 1])) == null ? void 0 : _d.focus();
+        } else {
+          focusTrigger(context);
+        }
+        return true;
+      }
+      case "Home": {
+        (_e = cells[0]) == null ? void 0 : _e.focus();
+        return true;
+      }
+      case "End": {
+        (_f = cells[cells.length - 1]) == null ? void 0 : _f.focus();
+        return true;
+      }
+      default:
+        return false;
+    }
+  }
+  if (actionsEl) {
+    const cells = queryFocusables(actionsEl);
+    const index = cells.indexOf(cell);
+    switch (key) {
+      case "ArrowRight": {
+        if (index < cells.length - 1) {
+          cells[index + 1].focus();
+        } else if (!focusNextTriggerAndClose(context)) {
+          focusTrigger(context);
+        }
+        return true;
+      }
+      case "ArrowLeft": {
+        if (index > 0) {
+          cells[index - 1].focus();
+        } else if (cell === firstFocusable(panel)) {
+          focusTrigger(context);
+        }
+        return true;
+      }
+      case "ArrowUp": {
+        if (columns.length > 0) {
+          const lastColumnCells = queryFocusables(columns[columns.length - 1]);
+          (_g = lastColumnCells[lastColumnCells.length - 1]) == null ? void 0 : _g.focus();
+        } else {
+          focusTrigger(context);
+        }
+        return true;
+      }
+      case "ArrowDown": {
+        if (index === cells.length - 1) {
+          focusNextTriggerAndClose(context);
+        }
+        return true;
+      }
+      case "Home": {
+        (_h = cells[0]) == null ? void 0 : _h.focus();
+        return true;
+      }
+      case "End": {
+        (_i = cells[cells.length - 1]) == null ? void 0 : _i.focus();
+        return true;
+      }
+      default:
+        return false;
+    }
+  }
+  return false;
+}
+function focusNextAfterPanel(context, panel) {
+  var _a;
+  const reference = context.elements.reference;
+  const refFocusable = firstFocusable(reference) ?? reference;
+  const nextLi = (_a = refFocusable == null ? void 0 : refFocusable.closest("li")) == null ? void 0 : _a.nextElementSibling;
+  const nextSibling = nextLi instanceof HTMLElement ? firstFocusable(nextLi) : null;
+  const nextOutside = nextSibling || (() => {
+    const allFocusable = queryFocusables(
+      panel.ownerDocument.documentElement
+    ).filter((el) => !panel.contains(el));
+    const idx = refFocusable ? allFocusable.indexOf(refFocusable) : -1;
+    return idx >= 0 ? allFocusable[idx + 1] : void 0;
+  })();
+  if (nextOutside) {
+    const view = panel.ownerDocument.defaultView;
+    view == null ? void 0 : view.requestAnimationFrame(() => {
+      view == null ? void 0 : view.requestAnimationFrame(() => {
+        nextOutside.focus();
+      });
+    });
+  }
+}
+function useMegaMenuNavigation(context, props = {}) {
+  const { enabled = true } = props;
+  const { open, onOpenChange } = context;
+  return react.useMemo(() => {
+    if (!enabled) {
+      return {};
+    }
+    return {
+      floating: {
+        onKeyDown(event) {
+          var _a, _b;
+          if (!open) return;
+          const panel = event.currentTarget;
+          const target = event.target;
+          const { key } = event;
+          const isArrowOrEdge = key === "ArrowUp" || key === "ArrowDown" || key === "ArrowLeft" || key === "ArrowRight" || key === "Home" || key === "End";
+          if (isArrowOrEdge && target.closest(SELF_CONSUMING_SELECTOR)) {
+            return;
+          }
+          const cell = target.closest(FOCUSABLE_SELECTOR);
+          if (key === "Tab") {
+            const allCells = queryFocusables(panel);
+            const linearIndex = cell ? allCells.indexOf(cell) : -1;
+            if (linearIndex === -1) return;
+            event.preventDefault();
+            if (event.shiftKey) {
+              if (linearIndex === 0) {
+                focusTrigger(context);
+              } else {
+                (_a = allCells[linearIndex - 1]) == null ? void 0 : _a.focus();
+              }
+            } else if (linearIndex === allCells.length - 1) {
+              onOpenChange(false);
+              focusNextAfterPanel(context, panel);
+            } else {
+              (_b = allCells[linearIndex + 1]) == null ? void 0 : _b.focus();
+            }
+            return;
+          }
+          if (!cell || !isArrowOrEdge) return;
+          if (handleArrow(key, cell, panel, context)) {
+            event.preventDefault();
+          }
+        }
+      }
+    };
+  }, [enabled, open, context, onOpenChange]);
+}
+function focusFirstItem(panel, attempt = 0) {
+  const firstItem = firstFocusable(panel);
+  if (firstItem) {
+    firstItem.focus();
+    return;
+  }
+  const view = panel.ownerDocument.defaultView;
+  if (attempt < 3 && view) {
+    view.requestAnimationFrame(() => focusFirstItem(panel, attempt + 1));
+  }
+}
+
+exports.FOCUSABLE_SELECTOR = FOCUSABLE_SELECTOR;
+exports.focusFirstItem = focusFirstItem;
+exports.useMegaMenuNavigation = useMegaMenuNavigation;
+//# sourceMappingURL=useMegaMenuNavigation.js.map