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

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @salt-ds/lab
 
+## 1.0.0-alpha.96
+
+### Minor Changes
+
+- 248982a: Reworked `MegaMenu` for more semantic, accessible markup and more predictable
+  keyboard navigation.
+
+  - **Renamed `MegaMenuHeader` to `MegaMenuGroupHeading`.** It now renders a real heading (`<h3>` by default; set the level with `as`, e.g. `as="h2"`) instead of a `<div>`, so each group appears in the document outline for assistive technology.
+  - **Renamed `MegaMenuItem` to `MegaMenuListItem`.** It renders an `<a>` by default — pass a `render` element such as `react-router`'s `Link` — and accepts a `current` prop that sets `aria-current="page"` for the active page.
+  - **Added `MegaMenuList`.** Wrap a group's items in it so they are announced as a list; `MegaMenuListItem` can no longer be placed directly inside `MegaMenuGroup`.
+  - **Renamed `MegaMenuSupportingContent` to `MegaMenuAside`.** It now renders an `<aside>` landmark, making the supporting region discoverable to screen-reader users.
+  - **Renamed `MegaMenuSupportingActions` to `MegaMenuActions`.**
+  - **Added `MegaMenuContent`.** It is the center navigation region holding the groups and an optional `MegaMenuActions` band; `MegaMenuAside` sits beside it, positioned by source order.
+  - **Narrowed `MegaMenu`'s `placement` prop** to `"bottom" | "bottom-start" | "bottom-end"` (the new `MegaMenuPlacement` type).
+  - **Menu columns now adapt to the available width** instead of overflowing, keeping panels usable on narrower viewports.
+  - **Keyboard navigation is more predictable** between the columns, the actions row, and the trigger;
+
+  ```diff
+    <MegaMenuPanel aria-label="Solutions menu">
+  +   <MegaMenuContent>
+        <MegaMenuGroups>
+          <MegaMenuGroup>
+  -         <MegaMenuHeader>Financial services</MegaMenuHeader>
+  -         <MegaMenuItem render={<Link to="/digital-banking" />}>Digital banking</MegaMenuItem>
+  +         <MegaMenuGroupHeading>Financial services</MegaMenuGroupHeading>
+  +         <MegaMenuList>
+  +           <MegaMenuListItem render={<Link to="/digital-banking" />}>Digital banking</MegaMenuListItem>
+  +         </MegaMenuList>
+          </MegaMenuGroup>
+        </MegaMenuGroups>
+  -     <MegaMenuSupportingActions>
+  +     <MegaMenuActions>
+          <Link href="#demo">Book a demo</Link>
+  -     </MegaMenuSupportingActions>
+  +     </MegaMenuActions>
+  +   </MegaMenuContent>
+  -   <MegaMenuSupportingContent>...</MegaMenuSupportingContent>
+  +   <MegaMenuAside>...</MegaMenuAside>
+    </MegaMenuPanel>
+  ```
+
+### Patch Changes
+
+- bab3b6c: Fixed `ToolbarNext` overflow calculations to preserve fractional browser measurements and avoid false overflow caused by subpixel rounding.
+- Updated dependencies [1a48c1a]
+  - @salt-ds/core@1.64.1
+
 ## 1.0.0-alpha.95
 
 ### Minor Changes

package/css/salt-lab.css

@@ -1893,51 +1893,81 @@
   border-right: var(--salt-size-fixed-100) var(--salt-borderStyle-solid) var(--salt-separable-primary-borderColor);
 }
 
-/* src/mega-menu/MegaMenuGroup.css */
-.saltMegaMenuGroup {
+/* src/mega-menu/MegaMenuActions.css */
+.saltMegaMenuActions {
   display: flex;
-  flex-direction: column;
+  flex-wrap: wrap;
+  margin-block-start: auto;
 }
-.saltMegaMenuGroup-list {
-  list-style: none;
-  margin: 0;
-  padding: 0;
+
+/* src/mega-menu/MegaMenuAside.css */
+.saltMegaMenuAside {
+  flex: 0 0 auto;
   display: flex;
-  gap: var(--salt-spacing-fixed-100);
   flex-direction: column;
+  padding: var(--salt-spacing-300);
 }
 
-/* src/mega-menu/MegaMenuGroups.css */
-.saltMegaMenuGroups {
-  display: grid;
-  grid-template-columns: repeat(auto-fit, var(--saltMegaMenuGroups-columnWidth, 12rem));
+/* src/mega-menu/MegaMenuContent.css */
+.saltMegaMenuContent {
+  display: flex;
+  flex-direction: column;
   gap: var(--salt-spacing-300);
   padding: var(--salt-spacing-300);
-  max-inline-size: var(--saltMegaMenuPanel-availableWidth, calc(100vw - var(--salt-spacing-600)));
+  min-width: 0;
+  flex: 0 1 auto;
+  max-inline-size: var(--saltMegaMenuPanel-availableWidth);
+  box-sizing: border-box;
 }
 
-/* src/mega-menu/MegaMenuHeader.css */
-.saltMegaMenuHeader-content {
+/* src/mega-menu/MegaMenuGroup.css */
+.saltMegaMenuGroup {
+  display: flex;
+  flex-direction: column;
+}
+
+/* src/mega-menu/MegaMenuGroupHeading.css */
+.saltMegaMenuGroupHeading {
   display: flex;
   align-items: center;
+  margin: 0 0 var(--salt-spacing-50);
   padding: var(--salt-spacing-50) var(--salt-spacing-100);
+  border-bottom: var(--salt-size-fixed-100) var(--salt-borderStyle-solid) var(--salt-separable-tertiary-borderColor);
+  min-height: var(--salt-size-base);
   font-family: var(--salt-text-label-fontFamily);
   font-size: var(--salt-text-label-fontSize);
   font-weight: var(--salt-text-fontWeight-strong);
   line-height: var(--salt-text-label-lineHeight);
-  min-height: var(--salt-size-base);
   color: var(--salt-content-secondary-foreground);
 }
-.saltMegaMenuHeader {
-  margin-bottom: var(--salt-spacing-50);
-  border-bottom: var(--salt-size-fixed-100) var(--salt-borderStyle-solid) var(--salt-separable-tertiary-borderColor);
+
+/* src/mega-menu/MegaMenuGroups.css */
+.saltMegaMenuGroups {
+  align-self: start;
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(0, var(--saltMegaMenuGroups-columnWidth, 12rem)));
+  gap: var(--salt-spacing-300);
+  min-width: 0;
+  max-inline-size: var(--saltMegaMenuPanel-availableWidth);
 }
 
-/* src/mega-menu/MegaMenuItem.css */
-.saltMegaMenuItem {
+/* src/mega-menu/MegaMenuList.css */
+.saltMegaMenuList {
   list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  gap: var(--salt-spacing-fixed-100);
+  flex-direction: column;
 }
-.saltMegaMenuItem > a {
+
+/* src/mega-menu/MegaMenuListItem.css */
+.saltMegaMenuListItem {
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+}
+.saltMegaMenuListItem-wrapper {
   display: flex;
   padding: var(--salt-spacing-50) var(--salt-spacing-100);
   align-items: flex-start;
@@ -1948,15 +1978,18 @@
   box-sizing: border-box;
   gap: var(--salt-spacing-100);
   position: relative;
-  border-radius: var(--salt-palette-corner-weak);
+  border-radius: var(--salt-palette-corner-weak, 0);
   text-decoration: none;
+  border: none;
+  font: inherit;
+  text-align: start;
 }
-.saltMegaMenuItem > a > .saltIcon {
+.saltMegaMenuListItem-wrapper > .saltIcon {
   display: flex;
   height: var(--salt-size-base);
   align-items: center;
 }
-.saltMegaMenuItem-content {
+.saltMegaMenuListItem-content {
   flex: 1 0;
   margin: var(--salt-spacing-75) 0;
   font-family: var(--salt-text-fontFamily);
@@ -1964,18 +1997,18 @@
   font-weight: var(--salt-text-fontWeight);
   line-height: var(--salt-text-lineHeight);
 }
-.saltMegaMenuItem > a:focus-visible {
+.saltMegaMenuListItem-wrapper:focus-visible {
   outline: var(--salt-focused-outline);
   outline-offset: calc(var(--salt-size-fixed-100) * -2);
 }
-.saltMegaMenuItem > a:hover {
+.saltMegaMenuListItem-wrapper:hover:not(:focus-visible) {
   outline: none;
-  background: var(--salt-navigable-background-hover);
+  background: var(--salt-overlayable-background-hover);
 }
-.saltMegaMenuItem > a:active {
+.saltMegaMenuListItem-wrapper:active {
   background: var(--salt-navigable-accent-background-active);
 }
-.saltMegaMenuItem > a:active::before {
+.saltMegaMenuListItem-wrapper:active::before {
   content: "";
   position: absolute;
   inset: 0;
@@ -1987,31 +2020,19 @@
 
 /* src/mega-menu/MegaMenuPanel.css */
 .saltMegaMenuPanel {
+  --saltMegaMenuPanel-availableWidth: calc(100vw - var(--salt-spacing-600));
   display: flex;
-  flex-wrap: wrap;
+  align-items: stretch;
   inline-size: var(--saltMegaMenuPanel-inlineSize, fit-content);
-  max-inline-size: var(--saltMegaMenuPanel-maxInlineSize, var(--saltMegaMenuPanel-availableWidth, calc(100vw - var(--salt-spacing-600))));
-  max-height: 90%;
+  max-inline-size: var(--saltMegaMenuPanel-maxInlineSize, var(--saltMegaMenuPanel-availableWidth));
+  max-block-size: 90vh;
   overflow-x: hidden;
   overflow-y: auto;
   box-sizing: border-box;
-  border-radius: var(--salt-palette-corner);
+  border-radius: var(--salt-palette-corner, 0);
   border: var(--salt-size-fixed-100) var(--salt-borderStyle-solid) var(--salt-container-primary-borderColor);
   background: var(--salt-container-primary-background);
-  box-shadow: var(--salt-overlayable-shadow-popout);
-}
-
-/* src/mega-menu/MegaMenuSupportingActions.css */
-.saltMegaMenuSupportingActions {
-  display: flex;
-  flex-wrap: wrap;
-  width: fit-content;
-  padding-bottom: var(--salt-spacing-300);
-}
-
-/* src/mega-menu/MegaMenuSupportingContent.css */
-.saltMegaMenuSupportingContent {
-  padding: var(--salt-spacing-300);
+  box-shadow: var(--salt-overlayable-shadow-modal);
 }
 
 /* src/menu-button/MenuButton.css */
@@ -3437,4 +3458,4 @@
   margin: calc(var(--salt-size-unit) / 2) 0;
 }
 
-/* src/0af170c9-7e3f-4fb8-8504-21af9780540e.css */
+/* src/e4ab0e63-880d-4ad2-9759-4acceca8a38d.css */

package/dist-cjs/index.js

@@ -79,13 +79,15 @@ var Logo = require('./logo/Logo.js');
 var LogoImage = require('./logo/LogoImage.js');
 var LogoSeparator = require('./logo/LogoSeparator.js');
 var MegaMenu = require('./mega-menu/MegaMenu.js');
+var MegaMenuActions = require('./mega-menu/MegaMenuActions.js');
+var MegaMenuAside = require('./mega-menu/MegaMenuAside.js');
+var MegaMenuContent = require('./mega-menu/MegaMenuContent.js');
 var MegaMenuGroup = require('./mega-menu/MegaMenuGroup.js');
+var MegaMenuGroupHeading = require('./mega-menu/MegaMenuGroupHeading.js');
 var MegaMenuGroups = require('./mega-menu/MegaMenuGroups.js');
-var MegaMenuHeader = require('./mega-menu/MegaMenuHeader.js');
-var MegaMenuItem = require('./mega-menu/MegaMenuItem.js');
+var MegaMenuList = require('./mega-menu/MegaMenuList.js');
+var MegaMenuListItem = require('./mega-menu/MegaMenuListItem.js');
 var MegaMenuPanel = require('./mega-menu/MegaMenuPanel.js');
-var MegaMenuSupportingActions = require('./mega-menu/MegaMenuSupportingActions.js');
-var MegaMenuSupportingContent = require('./mega-menu/MegaMenuSupportingContent.js');
 var MegaMenuTrigger = require('./mega-menu/MegaMenuTrigger.js');
 var MenuButton = require('./menu-button/MenuButton.js');
 var Metric = require('./metric/Metric.js');
@@ -216,13 +218,15 @@ exports.Logo = Logo.Logo;
 exports.LogoImage = LogoImage.LogoImage;
 exports.LogoSeparator = LogoSeparator.LogoSeparator;
 exports.MegaMenu = MegaMenu.MegaMenu;
+exports.MegaMenuActions = MegaMenuActions.MegaMenuActions;
+exports.MegaMenuAside = MegaMenuAside.MegaMenuAside;
+exports.MegaMenuContent = MegaMenuContent.MegaMenuContent;
 exports.MegaMenuGroup = MegaMenuGroup.MegaMenuGroup;
+exports.MegaMenuGroupHeading = MegaMenuGroupHeading.MegaMenuGroupHeading;
 exports.MegaMenuGroups = MegaMenuGroups.MegaMenuGroups;
-exports.MegaMenuHeader = MegaMenuHeader.MegaMenuHeader;
-exports.MegaMenuItem = MegaMenuItem.MegaMenuItem;
+exports.MegaMenuList = MegaMenuList.MegaMenuList;
+exports.MegaMenuListItem = MegaMenuListItem.MegaMenuListItem;
 exports.MegaMenuPanel = MegaMenuPanel.MegaMenuPanel;
-exports.MegaMenuSupportingActions = MegaMenuSupportingActions.MegaMenuSupportingActions;
-exports.MegaMenuSupportingContent = MegaMenuSupportingContent.MegaMenuSupportingContent;
 exports.MegaMenuTrigger = MegaMenuTrigger.MegaMenuTrigger;
 exports.MenuButton = MenuButton.MenuButton;
 exports.Metric = Metric.Metric;

package/dist-cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

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

@@ -5,7 +5,7 @@ var react$1 = require('@floating-ui/react');
 var core = require('@salt-ds/core');
 var react = require('react');
 var MegaMenuContext = require('./MegaMenuContext.js');
-var useMegaMenuKeyboard = require('./useMegaMenuKeyboard.js');
+var useMegaMenuNavigation = require('./useMegaMenuNavigation.js');
 
 function MegaMenu({
   children,
@@ -22,12 +22,12 @@ function MegaMenu({
   });
   const [reference, setReference] = react.useState(null);
   const [floating, setFloating] = react.useState(null);
-  const [focusFirstItemOnOpen, setFocusFirstItemOnOpen] = react.useState(false);
-  const [panelId, setPanelId] = react.useState(void 0);
+  const focusFirstItemOnOpenRef = react.useRef(false);
+  const [panelId, setPanelId] = react.useState();
   const setOpen = react.useCallback(
     (newOpen) => {
       if (!newOpen) {
-        setFocusFirstItemOnOpen(false);
+        focusFirstItemOnOpenRef.current = false;
       }
       setOpenState(newOpen);
       onOpenChange == null ? void 0 : onOpenChange(newOpen);
@@ -39,11 +39,11 @@ function MegaMenu({
     onOpenChange: setOpen,
     elements: { reference, floating }
   });
-  const megaMenuKeyboard = useMegaMenuKeyboard.useMegaMenuKeyboard(floatingRootContext);
+  const megaMenuNavigation = useMegaMenuNavigation.useMegaMenuNavigation(floatingRootContext);
   const { getReferenceProps, getFloatingProps } = react$1.useInteractions([
     react$1.useClick(floatingRootContext),
     react$1.useDismiss(floatingRootContext),
-    megaMenuKeyboard
+    megaMenuNavigation
   ]);
   const contextValue = react.useMemo(
     () => ({
@@ -55,8 +55,7 @@ function MegaMenu({
       setFloating,
       setReference,
       setOpen,
-      focusFirstItemOnOpen,
-      setFocusFirstItemOnOpen,
+      focusFirstItemOnOpenRef,
       panelId,
       setPanelId
     }),
@@ -66,13 +65,8 @@ function MegaMenu({
       placement,
       getFloatingProps,
       getReferenceProps,
-      setFloating,
-      setReference,
       setOpen,
-      focusFirstItemOnOpen,
-      setFocusFirstItemOnOpen,
-      panelId,
-      setPanelId
+      panelId
     ]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(MegaMenuContext.MegaMenuContext.Provider, { value: contextValue, children });

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

@@ -1 +1 @@
-{"version":3,"file":"MegaMenu.js","sources":["../src/mega-menu/MegaMenu.tsx"],"sourcesContent":["import {\n  type Placement,\n  useClick,\n  useDismiss,\n  useFloatingRootContext,\n  useInteractions,\n} from \"@floating-ui/react\";\nimport { useControlled } from \"@salt-ds/core\";\nimport { type ReactNode, useCallback, useMemo, useState } from \"react\";\nimport { MegaMenuContext } from \"./MegaMenuContext\";\nimport { useMegaMenuKeyboard } from \"./useMegaMenuKeyboard\";\n\nexport interface MegaMenuProps {\n  /**\n   * The content of the mega menu, typically `MegaMenuTrigger` and `MegaMenuPanel`.\n   */\n  children?: ReactNode;\n  /**\n   * Whether the mega menu is open. Use for controlled mode.\n   */\n  open?: boolean;\n  /**\n   * Whether the mega menu is initially open. Use for uncontrolled mode.\n   * @default false\n   */\n  defaultOpen?: boolean;\n  /**\n   * Callback fired when the open state changes.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * The placement of the mega menu panel relative to the trigger.\n   * @default \"bottom\"\n   */\n  placement?: Placement;\n}\n\nexport function MegaMenu({\n  children,\n  open,\n  defaultOpen = false,\n  onOpenChange,\n  placement = \"bottom\",\n}: MegaMenuProps) {\n  const [openState, setOpenState] = useControlled({\n    controlled: open,\n    default: defaultOpen,\n    name: \"MegaMenu\",\n    state: \"open\",\n  });\n\n  const [reference, setReference] = useState<HTMLElement | null>(null);\n  const [floating, setFloating] = useState<HTMLElement | null>(null);\n  const [focusFirstItemOnOpen, setFocusFirstItemOnOpen] = useState(false);\n  const [panelId, setPanelId] = useState<string | undefined>(undefined);\n\n  const setOpen = useCallback(\n    (newOpen: boolean) => {\n      if (!newOpen) {\n        setFocusFirstItemOnOpen(false);\n      }\n      setOpenState(newOpen);\n      onOpenChange?.(newOpen);\n    },\n    [onOpenChange],\n  );\n\n  const floatingRootContext = useFloatingRootContext({\n    open: openState,\n    onOpenChange: setOpen,\n    elements: { reference, floating },\n  });\n\n  const megaMenuKeyboard = useMegaMenuKeyboard(floatingRootContext);\n\n  const { getReferenceProps, getFloatingProps } = useInteractions([\n    useClick(floatingRootContext),\n    useDismiss(floatingRootContext),\n    megaMenuKeyboard,\n  ]);\n\n  const contextValue = useMemo(\n    () => ({\n      openState,\n      floatingRootContext,\n      placement,\n      getFloatingProps,\n      getReferenceProps,\n      setFloating,\n      setReference,\n      setOpen,\n      focusFirstItemOnOpen,\n      setFocusFirstItemOnOpen,\n      panelId,\n      setPanelId,\n    }),\n    [\n      openState,\n      floatingRootContext,\n      placement,\n      getFloatingProps,\n      getReferenceProps,\n      setFloating,\n      setReference,\n      setOpen,\n      focusFirstItemOnOpen,\n      setFocusFirstItemOnOpen,\n      panelId,\n      setPanelId,\n    ],\n  );\n\n  return (\n    <MegaMenuContext.Provider value={contextValue}>\n      {children}\n    </MegaMenuContext.Provider>\n  );\n}\n"],"names":["useControlled","useState","useCallback","useFloatingRootContext","useMegaMenuKeyboard","useInteractions","useClick","useDismiss","useMemo","MegaMenuContext"],"mappings":";;;;;;;;;AAqCO,SAAS,QAAA,CAAS;AAAA,EACvB,QAAA;AAAA,EACA,IAAA;AAAA,EACA,WAAA,GAAc,KAAA;AAAA,EACd,YAAA;AAAA,EACA,SAAA,GAAY;AACd,CAAA,EAAkB;AAChB,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIA,kBAAA,CAAc;AAAA,IAC9C,UAAA,EAAY,IAAA;AAAA,IACZ,OAAA,EAAS,WAAA;AAAA,IACT,IAAA,EAAM,UAAA;AAAA,IACN,KAAA,EAAO;AAAA,GACR,CAAA;AAED,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIC,eAA6B,IAAI,CAAA;AACnE,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIA,eAA6B,IAAI,CAAA;AACjE,EAAA,MAAM,CAAC,oBAAA,EAAsB,uBAAuB,CAAA,GAAIA,eAAS,KAAK,CAAA;AACtE,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAA6B,MAAS,CAAA;AAEpE,EAAA,MAAM,OAAA,GAAUC,iBAAA;AAAA,IACd,CAAC,OAAA,KAAqB;AACpB,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA,uBAAA,CAAwB,KAAK,CAAA;AAAA,MAC/B;AACA,MAAA,YAAA,CAAa,OAAO,CAAA;AACpB,MAAA,YAAA,IAAA,IAAA,GAAA,MAAA,GAAA,YAAA,CAAe,OAAA,CAAA;AAAA,IACjB,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,sBAAsBC,8BAAA,CAAuB;AAAA,IACjD,IAAA,EAAM,SAAA;AAAA,IACN,YAAA,EAAc,OAAA;AAAA,IACd,QAAA,EAAU,EAAE,SAAA,EAAW,QAAA;AAAS,GACjC,CAAA;AAED,EAAA,MAAM,gBAAA,GAAmBC,wCAAoB,mBAAmB,CAAA;AAEhE,EAAA,MAAM,EAAE,iBAAA,EAAmB,gBAAA,EAAiB,GAAIC,uBAAA,CAAgB;AAAA,IAC9DC,iBAAS,mBAAmB,CAAA;AAAA,IAC5BC,mBAAW,mBAAmB,CAAA;AAAA,IAC9B;AAAA,GACD,CAAA;AAED,EAAA,MAAM,YAAA,GAAeC,aAAA;AAAA,IACnB,OAAO;AAAA,MACL,SAAA;AAAA,MACA,mBAAA;AAAA,MACA,SAAA;AAAA,MACA,gBAAA;AAAA,MACA,iBAAA;AAAA,MACA,WAAA;AAAA,MACA,YAAA;AAAA,MACA,OAAA;AAAA,MACA,oBAAA;AAAA,MACA,uBAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA;AAAA,MACE,SAAA;AAAA,MACA,mBAAA;AAAA,MACA,SAAA;AAAA,MACA,gBAAA;AAAA,MACA,iBAAA;AAAA,MACA,WAAA;AAAA,MACA,YAAA;AAAA,MACA,OAAA;AAAA,MACA,oBAAA;AAAA,MACA,uBAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA;AACF,GACF;AAEA,EAAA,sCACGC,+BAAA,CAAgB,QAAA,EAAhB,EAAyB,KAAA,EAAO,cAC9B,QAAA,EACH,CAAA;AAEJ;;;;"}
+{"version":3,"file":"MegaMenu.js","sources":["../src/mega-menu/MegaMenu.tsx"],"sourcesContent":["import {\n  useClick,\n  useDismiss,\n  useFloatingRootContext,\n  useInteractions,\n} from \"@floating-ui/react\";\nimport { useControlled } from \"@salt-ds/core\";\nimport { type ReactNode, useCallback, useMemo, useRef, useState } from \"react\";\nimport { MegaMenuContext } from \"./MegaMenuContext\";\nimport { useMegaMenuNavigation } from \"./useMegaMenuNavigation\";\n\n/**\n * Supported placements for the mega menu panel.\n */\nexport type MegaMenuPlacement = \"bottom\" | \"bottom-start\" | \"bottom-end\";\n\nexport interface MegaMenuProps {\n  /**\n   * The content of the mega menu, typically `MegaMenuTrigger` and `MegaMenuPanel`.\n   */\n  children?: ReactNode;\n  /**\n   * Whether the mega menu is open. Use for controlled mode.\n   */\n  open?: boolean;\n  /**\n   * Whether the mega menu is initially open. Use for uncontrolled mode.\n   * @default false\n   */\n  defaultOpen?: boolean;\n  /**\n   * Callback fired when the open state changes.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * The placement of the mega menu panel relative to the trigger.\n   * @default \"bottom\"\n   */\n  placement?: MegaMenuPlacement;\n}\n\n/**\n * Root of a mega menu, coordinating its trigger and panel.\n *\n * Not intended to be nested inside another floating overlay (e.g. a dialog or\n * popover): the mega menu does not participate in floating-ui's `FloatingTree`\n */\nexport function MegaMenu({\n  children,\n  open,\n  defaultOpen = false,\n  onOpenChange,\n  placement = \"bottom\",\n}: MegaMenuProps) {\n  const [openState, setOpenState] = useControlled({\n    controlled: open,\n    default: defaultOpen,\n    name: \"MegaMenu\",\n    state: \"open\",\n  });\n\n  const [reference, setReference] = useState<HTMLElement | null>(null);\n  const [floating, setFloating] = useState<HTMLElement | null>(null);\n  const focusFirstItemOnOpenRef = useRef(false);\n  const [panelId, setPanelId] = useState<string>();\n\n  const setOpen = useCallback(\n    (newOpen: boolean) => {\n      if (!newOpen) {\n        focusFirstItemOnOpenRef.current = false;\n      }\n      setOpenState(newOpen);\n      onOpenChange?.(newOpen);\n    },\n    [onOpenChange],\n  );\n\n  const floatingRootContext = useFloatingRootContext({\n    open: openState,\n    onOpenChange: setOpen,\n    elements: { reference, floating },\n  });\n\n  const megaMenuNavigation = useMegaMenuNavigation(floatingRootContext);\n\n  const { getReferenceProps, getFloatingProps } = useInteractions([\n    useClick(floatingRootContext),\n    useDismiss(floatingRootContext),\n    megaMenuNavigation,\n  ]);\n\n  const contextValue = useMemo(\n    () => ({\n      openState,\n      floatingRootContext,\n      placement,\n      getFloatingProps,\n      getReferenceProps,\n      setFloating,\n      setReference,\n      setOpen,\n      focusFirstItemOnOpenRef,\n      panelId,\n      setPanelId,\n    }),\n    [\n      openState,\n      floatingRootContext,\n      placement,\n      getFloatingProps,\n      getReferenceProps,\n      setOpen,\n      panelId,\n    ],\n  );\n\n  return (\n    <MegaMenuContext.Provider value={contextValue}>\n      {children}\n    </MegaMenuContext.Provider>\n  );\n}\n"],"names":["useControlled","useState","useRef","useCallback","useFloatingRootContext","useMegaMenuNavigation","useInteractions","useClick","useDismiss","useMemo","MegaMenuContext"],"mappings":";;;;;;;;;AA+CO,SAAS,QAAA,CAAS;AAAA,EACvB,QAAA;AAAA,EACA,IAAA;AAAA,EACA,WAAA,GAAc,KAAA;AAAA,EACd,YAAA;AAAA,EACA,SAAA,GAAY;AACd,CAAA,EAAkB;AAChB,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIA,kBAAA,CAAc;AAAA,IAC9C,UAAA,EAAY,IAAA;AAAA,IACZ,OAAA,EAAS,WAAA;AAAA,IACT,IAAA,EAAM,UAAA;AAAA,IACN,KAAA,EAAO;AAAA,GACR,CAAA;AAED,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIC,eAA6B,IAAI,CAAA;AACnE,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIA,eAA6B,IAAI,CAAA;AACjE,EAAA,MAAM,uBAAA,GAA0BC,aAAO,KAAK,CAAA;AAC5C,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAID,cAAA,EAAiB;AAE/C,EAAA,MAAM,OAAA,GAAUE,iBAAA;AAAA,IACd,CAAC,OAAA,KAAqB;AACpB,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA,uBAAA,CAAwB,OAAA,GAAU,KAAA;AAAA,MACpC;AACA,MAAA,YAAA,CAAa,OAAO,CAAA;AACpB,MAAA,YAAA,IAAA,IAAA,GAAA,MAAA,GAAA,YAAA,CAAe,OAAA,CAAA;AAAA,IACjB,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,sBAAsBC,8BAAA,CAAuB;AAAA,IACjD,IAAA,EAAM,SAAA;AAAA,IACN,YAAA,EAAc,OAAA;AAAA,IACd,QAAA,EAAU,EAAE,SAAA,EAAW,QAAA;AAAS,GACjC,CAAA;AAED,EAAA,MAAM,kBAAA,GAAqBC,4CAAsB,mBAAmB,CAAA;AAEpE,EAAA,MAAM,EAAE,iBAAA,EAAmB,gBAAA,EAAiB,GAAIC,uBAAA,CAAgB;AAAA,IAC9DC,iBAAS,mBAAmB,CAAA;AAAA,IAC5BC,mBAAW,mBAAmB,CAAA;AAAA,IAC9B;AAAA,GACD,CAAA;AAED,EAAA,MAAM,YAAA,GAAeC,aAAA;AAAA,IACnB,OAAO;AAAA,MACL,SAAA;AAAA,MACA,mBAAA;AAAA,MACA,SAAA;AAAA,MACA,gBAAA;AAAA,MACA,iBAAA;AAAA,MACA,WAAA;AAAA,MACA,YAAA;AAAA,MACA,OAAA;AAAA,MACA,uBAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA;AAAA,MACE,SAAA;AAAA,MACA,mBAAA;AAAA,MACA,SAAA;AAAA,MACA,gBAAA;AAAA,MACA,iBAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA;AACF,GACF;AAEA,EAAA,sCACGC,+BAAA,CAAgB,QAAA,EAAhB,EAAyB,KAAA,EAAO,cAC9B,QAAA,EACH,CAAA;AAEJ;;;;"}

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

@@ -0,0 +1,6 @@
+'use strict';
+
+var css_248z = ".saltMegaMenuActions {\n  display: flex;\n  flex-wrap: wrap;\n  margin-block-start: auto;\n}\n";
+
+module.exports = css_248z;
+//# sourceMappingURL=MegaMenuActions.css.js.map

package/dist-cjs/mega-menu/MegaMenuActions.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MegaMenuActions.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

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

@@ -0,0 +1,33 @@
+'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 MegaMenuActions$1 = require('./MegaMenuActions.css.js');
+
+const withBaseName = core.makePrefixer("saltMegaMenuActions");
+const MegaMenuActions = react.forwardRef(
+  function MegaMenuActions2({ className, ...rest }, ref) {
+    const targetWindow = window.useWindow();
+    styles.useComponentCssInjection({
+      testId: "salt-mega-menu-actions",
+      css: MegaMenuActions$1,
+      window: targetWindow
+    });
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        "data-mega-menu-actions": "",
+        className: clsx.clsx(withBaseName(), className),
+        ref,
+        ...rest
+      }
+    );
+  }
+);
+
+exports.MegaMenuActions = MegaMenuActions;
+//# sourceMappingURL=MegaMenuActions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MegaMenuActions.js","sources":["../src/mega-menu/MegaMenuActions.tsx"],"sourcesContent":["import { makePrefixer } 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} from \"react\";\nimport megaMenuActionsCss from \"./MegaMenuActions.css\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuActions\");\n\nexport interface MegaMenuActionsProps extends ComponentPropsWithoutRef<\"div\"> {\n  /**\n   * The content of the actions. Place `MegaMenuActions` inside\n   * `MegaMenuContent`, after `MegaMenuGroups`; it renders as a band beneath the\n   * groups, spanning their width.\n   */\n  children?: ReactNode;\n}\n\nexport const MegaMenuActions = forwardRef<HTMLDivElement, MegaMenuActionsProps>(\n  function MegaMenuActions({ className, ...rest }, ref) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-mega-menu-actions\",\n      css: megaMenuActionsCss,\n      window: targetWindow,\n    });\n\n    return (\n      <div\n        data-mega-menu-actions=\"\"\n        className={clsx(withBaseName(), className)}\n        ref={ref}\n        {...rest}\n      />\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","MegaMenuActions","useWindow","useComponentCssInjection","megaMenuActionsCss","jsx","clsx"],"mappings":";;;;;;;;;;AAWA,MAAM,YAAA,GAAeA,kBAAa,qBAAqB,CAAA;AAWhD,MAAM,eAAA,GAAkBC,gBAAA;AAAA,EAC7B,SAASC,gBAAAA,CAAgB,EAAE,WAAW,GAAG,IAAA,IAAQ,GAAA,EAAK;AACpD,IAAA,MAAM,eAAeC,gBAAA,EAAU;AAC/B,IAAAC,+BAAA,CAAyB;AAAA,MACvB,MAAA,EAAQ,wBAAA;AAAA,MACR,GAAA,EAAKC,iBAAA;AAAA,MACL,MAAA,EAAQ;AAAA,KACT,CAAA;AAED,IAAA,uBACEC,cAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,wBAAA,EAAuB,EAAA;AAAA,QACvB,SAAA,EAAWC,SAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA;AAAA,QACzC,GAAA;AAAA,QACC,GAAG;AAAA;AAAA,KACN;AAAA,EAEJ;AACF;;;;"}

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

@@ -0,0 +1,6 @@
+'use strict';
+
+var css_248z = ".saltMegaMenuAside {\n  flex: 0 0 auto;\n  display: flex;\n  flex-direction: column;\n  padding: var(--salt-spacing-300);\n}\n";
+
+module.exports = css_248z;
+//# sourceMappingURL=MegaMenuAside.css.js.map

package/dist-cjs/mega-menu/MegaMenuAside.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MegaMenuAside.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

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

@@ -0,0 +1,33 @@
+'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 MegaMenuAside$1 = require('./MegaMenuAside.css.js');
+
+const withBaseName = core.makePrefixer("saltMegaMenuAside");
+const MegaMenuAside = react.forwardRef(
+  function MegaMenuAside2({ className, ...rest }, ref) {
+    const targetWindow = window.useWindow();
+    styles.useComponentCssInjection({
+      testId: "salt-mega-menu-aside",
+      css: MegaMenuAside$1,
+      window: targetWindow
+    });
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "aside",
+      {
+        "data-mega-menu-column": "",
+        className: clsx.clsx(withBaseName(), className),
+        ref,
+        ...rest
+      }
+    );
+  }
+);
+
+exports.MegaMenuAside = MegaMenuAside;
+//# sourceMappingURL=MegaMenuAside.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MegaMenuAside.js","sources":["../src/mega-menu/MegaMenuAside.tsx"],"sourcesContent":["import { makePrefixer } 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} from \"react\";\nimport megaMenuAsideCss from \"./MegaMenuAside.css\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuAside\");\n\nexport interface MegaMenuAsideProps extends ComponentPropsWithoutRef<\"aside\"> {\n  /**\n   * The content. Renders to the left of `MegaMenuContent` when placed before\n   * it, and to the right when placed after.\n   */\n  children?: ReactNode;\n}\n\nexport const MegaMenuAside = forwardRef<HTMLElement, MegaMenuAsideProps>(\n  function MegaMenuAside({ className, ...rest }, ref) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-mega-menu-aside\",\n      css: megaMenuAsideCss,\n      window: targetWindow,\n    });\n\n    // Side content is also a navigation column (`data-mega-menu-column`).\n    return (\n      <aside\n        data-mega-menu-column=\"\"\n        className={clsx(withBaseName(), className)}\n        ref={ref}\n        {...rest}\n      />\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","MegaMenuAside","useWindow","useComponentCssInjection","megaMenuAsideCss","jsx","clsx"],"mappings":";;;;;;;;;;AAWA,MAAM,YAAA,GAAeA,kBAAa,mBAAmB,CAAA;AAU9C,MAAM,aAAA,GAAgBC,gBAAA;AAAA,EAC3B,SAASC,cAAAA,CAAc,EAAE,WAAW,GAAG,IAAA,IAAQ,GAAA,EAAK;AAClD,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;AAGD,IAAA,uBACEC,cAAA;AAAA,MAAC,OAAA;AAAA,MAAA;AAAA,QACC,uBAAA,EAAsB,EAAA;AAAA,QACtB,SAAA,EAAWC,SAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA;AAAA,QACzC,GAAA;AAAA,QACC,GAAG;AAAA;AAAA,KACN;AAAA,EAEJ;AACF;;;;"}

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

@@ -0,0 +1,6 @@
+'use strict';
+
+var css_248z = ".saltMegaMenuContent {\n  display: flex;\n  flex-direction: column;\n  gap: var(--salt-spacing-300);\n  padding: var(--salt-spacing-300);\n  min-width: 0;\n  flex: 0 1 auto;\n  max-inline-size: var(--saltMegaMenuPanel-availableWidth);\n  box-sizing: border-box;\n}\n";
+
+module.exports = css_248z;
+//# sourceMappingURL=MegaMenuContent.css.js.map

package/dist-cjs/mega-menu/MegaMenuContent.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MegaMenuContent.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

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

@@ -0,0 +1,25 @@
+'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 MegaMenuContent$1 = require('./MegaMenuContent.css.js');
+
+const withBaseName = core.makePrefixer("saltMegaMenuContent");
+const MegaMenuContent = react.forwardRef(
+  function MegaMenuContent2({ children, className, ...rest }, ref) {
+    const targetWindow = window.useWindow();
+    styles.useComponentCssInjection({
+      testId: "salt-mega-menu-content",
+      css: MegaMenuContent$1,
+      window: targetWindow
+    });
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: clsx.clsx(withBaseName(), className), ref, ...rest, children });
+  }
+);
+
+exports.MegaMenuContent = MegaMenuContent;
+//# sourceMappingURL=MegaMenuContent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MegaMenuContent.js","sources":["../src/mega-menu/MegaMenuContent.tsx"],"sourcesContent":["import { makePrefixer } 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} from \"react\";\nimport megaMenuContentCss from \"./MegaMenuContent.css\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuContent\");\n\nexport interface MegaMenuContentProps extends ComponentPropsWithoutRef<\"div\"> {\n  /**\n   * The content of the mega menu navigation area, typically a `MegaMenuGroups`\n   * and an optional `MegaMenuActions`.\n   */\n  children?: ReactNode;\n}\n\nexport const MegaMenuContent = forwardRef<HTMLDivElement, MegaMenuContentProps>(\n  function MegaMenuContent({ children, className, ...rest }, ref) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-mega-menu-content\",\n      css: megaMenuContentCss,\n      window: targetWindow,\n    });\n\n    return (\n      <div className={clsx(withBaseName(), className)} ref={ref} {...rest}>\n        {children}\n      </div>\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","MegaMenuContent","useWindow","useComponentCssInjection","megaMenuContentCss","jsx","clsx"],"mappings":";;;;;;;;;;AAWA,MAAM,YAAA,GAAeA,kBAAa,qBAAqB,CAAA;AAUhD,MAAM,eAAA,GAAkBC,gBAAA;AAAA,EAC7B,SAASC,iBAAgB,EAAE,QAAA,EAAU,WAAW,GAAG,IAAA,IAAQ,GAAA,EAAK;AAC9D,IAAA,MAAM,eAAeC,gBAAA,EAAU;AAC/B,IAAAC,+BAAA,CAAyB;AAAA,MACvB,MAAA,EAAQ,wBAAA;AAAA,MACR,GAAA,EAAKC,iBAAA;AAAA,MACL,MAAA,EAAQ;AAAA,KACT,CAAA;AAED,IAAA,uBACEC,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAWC,SAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA,EAAG,GAAA,EAAW,GAAG,IAAA,EAC5D,QAAA,EACH,CAAA;AAAA,EAEJ;AACF;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"MegaMenuContext.js","sources":["../src/mega-menu/MegaMenuContext.ts"],"sourcesContent":["import type { FloatingRootContext, Placement } from \"@floating-ui/react\";\nimport { createContext } from \"@salt-ds/core\";\nimport type { Dispatch, HTMLProps, SetStateAction } from \"react\";\n\nexport interface MegaMenuContextValue {\n  /** Whether the mega menu is currently open. */\n  openState: boolean;\n  /** Toggle or set the open state of the mega menu. */\n  setOpen: (open: boolean) => void;\n  /** The floating-ui root context for coordinating interactions. */\n  floatingRootContext: FloatingRootContext;\n  /** The placement of the mega menu panel relative to the trigger. */\n  placement: Placement;\n  /** Props getter for the trigger (reference) element. Merges floating-ui interaction props with user props. */\n  getReferenceProps: (\n    userProps?: HTMLProps<Element> | undefined,\n  ) => Record<string, unknown>;\n  /** Props getter for the floating panel element. Merges floating-ui interaction props with user props. */\n  getFloatingProps: (\n    userProps?: HTMLProps<HTMLElement> | undefined,\n  ) => Record<string, unknown>;\n  /** Ref setter for the floating panel element. */\n  setFloating: Dispatch<SetStateAction<HTMLElement | null>>;\n  /** Ref setter for the trigger (reference) element. */\n  setReference: Dispatch<SetStateAction<HTMLElement | null>>;\n  /** Whether the first item should receive focus when the panel opens. */\n  focusFirstItemOnOpen: boolean;\n  /** Toggle the focus-first-item-on-open flag. */\n  setFocusFirstItemOnOpen: Dispatch<SetStateAction<boolean>>;\n  /** The id of the mega menu panel, used for aria-controls on the trigger. */\n  panelId: string | undefined;\n  /** Set the panel id when the panel mounts. */\n  setPanelId: Dispatch<SetStateAction<string | undefined>>;\n}\n\nexport const MegaMenuContext = createContext<MegaMenuContextValue | undefined>(\n  \"MegaMenuContext\",\n  undefined,\n);\n"],"names":["createContext"],"mappings":";;;;AAmCO,MAAM,eAAA,GAAkBA,kBAAA;AAAA,EAC7B,iBAAA;AAAA,EACA;AACF;;;;"}
+{"version":3,"file":"MegaMenuContext.js","sources":["../src/mega-menu/MegaMenuContext.ts"],"sourcesContent":["import type { FloatingRootContext } from \"@floating-ui/react\";\nimport { createContext } from \"@salt-ds/core\";\nimport type {\n  Dispatch,\n  HTMLProps,\n  MutableRefObject,\n  SetStateAction,\n} from \"react\";\nimport type { MegaMenuPlacement } from \"./MegaMenu\";\n\nexport interface MegaMenuContextValue {\n  /** Whether the mega menu is currently open. */\n  openState: boolean;\n  /** Toggle or set the open state of the mega menu. */\n  setOpen: (open: boolean) => void;\n  /** The floating-ui root context for coordinating interactions. */\n  floatingRootContext: FloatingRootContext;\n  /** The placement of the mega menu panel relative to the trigger. */\n  placement: MegaMenuPlacement;\n  /** Props getter for the trigger (reference) element. Merges floating-ui interaction props with user props. */\n  getReferenceProps: (\n    userProps?: HTMLProps<Element> | undefined,\n  ) => Record<string, unknown>;\n  /** Props getter for the floating panel element. Merges floating-ui interaction props with user props. */\n  getFloatingProps: (\n    userProps?: HTMLProps<HTMLElement> | undefined,\n  ) => Record<string, unknown>;\n  /** Ref setter for the floating panel element. */\n  setFloating: Dispatch<SetStateAction<HTMLElement | null>>;\n  /** Ref setter for the trigger (reference) element. */\n  setReference: Dispatch<SetStateAction<HTMLElement | null>>;\n  /** Whether the first item should receive focus when the panel opens. */\n  focusFirstItemOnOpenRef: MutableRefObject<boolean>;\n  /** The id of the mega menu panel, used for aria-controls on the trigger. */\n  panelId: string | undefined;\n  /** Registers the panel's id so the trigger's aria-controls stays in sync. */\n  setPanelId: Dispatch<SetStateAction<string | undefined>>;\n}\n\nexport const MegaMenuContext = createContext<MegaMenuContextValue | undefined>(\n  \"MegaMenuContext\",\n  undefined,\n);\n"],"names":["createContext"],"mappings":";;;;AAuCO,MAAM,eAAA,GAAkBA,kBAAA;AAAA,EAC7B,iBAAA;AAAA,EACA;AACF;;;;"}

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

@@ -1,6 +1,6 @@
 'use strict';
 
-var css_248z = ".saltMegaMenuGroup {\n  display: flex;\n  flex-direction: column;\n}\n\n.saltMegaMenuGroup-list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  gap: var(--salt-spacing-fixed-100);\n  flex-direction: column;\n}\n";
+var css_248z = ".saltMegaMenuGroup {\n  display: flex;\n  flex-direction: column;\n}\n";
 
 module.exports = css_248z;
 //# sourceMappingURL=MegaMenuGroup.css.js.map

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

@@ -7,7 +7,7 @@ var window = require('@salt-ds/window');
 var clsx = require('clsx');
 var react = require('react');
 var MegaMenuGroup$1 = require('./MegaMenuGroup.css.js');
-var MegaMenuHeader = require('./MegaMenuHeader.js');
+var MegaMenuGroupContext = require('./MegaMenuGroupContext.js');
 
 const withBaseName = core.makePrefixer("saltMegaMenuGroup");
 const MegaMenuGroup = react.forwardRef(
@@ -18,36 +18,21 @@ const MegaMenuGroup = react.forwardRef(
       css: MegaMenuGroup$1,
       window: targetWindow
     });
-    const headerId = core.useId();
-    let header = null;
-    const items = [];
-    react.Children.forEach(children, (child) => {
-      if (react.isValidElement(child) && child.type === MegaMenuHeader.MegaMenuHeader && !header) {
-        header = react.cloneElement(child, { id: headerId });
-      } else {
-        items.push(child);
-      }
-    });
-    return /* @__PURE__ */ jsxRuntime.jsxs(
+    const [headingId, setHeadingId] = react.useState(void 0);
+    const contextValue = react.useMemo(
+      () => ({ headingId, setHeadingId }),
+      [headingId]
+    );
+    return /* @__PURE__ */ jsxRuntime.jsx(MegaMenuGroupContext.MegaMenuGroupContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsxRuntime.jsx(
       "div",
       {
-        className: clsx.clsx(withBaseName(), className),
         "data-mega-menu-column": "",
+        className: clsx.clsx(withBaseName(), className),
         ref,
         ...rest,
-        children: [
-          header,
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "ol",
-            {
-              className: withBaseName("list"),
-              "aria-labelledby": header ? headerId : void 0,
-              children: items
-            }
-          )
-        ]
+        children
       }
-    );
+    ) });
   }
 );
 

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

@@ -1 +1 @@
-{"version":3,"file":"MegaMenuGroup.js","sources":["../src/mega-menu/MegaMenuGroup.tsx"],"sourcesContent":["import { makePrefixer, useId } from \"@salt-ds/core\";\nimport { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport {\n  Children,\n  cloneElement,\n  forwardRef,\n  type HTMLAttributes,\n  isValidElement,\n  type ReactNode,\n} from \"react\";\nimport megaMenuGroupCss from \"./MegaMenuGroup.css\";\nimport { MegaMenuHeader } from \"./MegaMenuHeader\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuGroup\");\n\nexport interface MegaMenuGroupProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * The content of the mega menu group, typically MegaMenuHeader and MegaMenuItem components.\n   */\n  children?: ReactNode;\n}\n\nexport const MegaMenuGroup = forwardRef<HTMLDivElement, MegaMenuGroupProps>(\n  function MegaMenuGroup({ children, className, ...rest }, ref) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-mega-menu-group\",\n      css: megaMenuGroupCss,\n      window: targetWindow,\n    });\n\n    const headerId = useId();\n    let header: ReactNode = null;\n    const items: ReactNode[] = [];\n\n    Children.forEach(children, (child) => {\n      if (isValidElement(child) && child.type === MegaMenuHeader && !header) {\n        header = cloneElement(child, { id: headerId });\n      } else {\n        items.push(child);\n      }\n    });\n\n    return (\n      <div\n        className={clsx(withBaseName(), className)}\n        data-mega-menu-column=\"\"\n        ref={ref}\n        {...rest}\n      >\n        {header}\n        <ol\n          className={withBaseName(\"list\")}\n          aria-labelledby={header ? headerId : undefined}\n        >\n          {items}\n        </ol>\n      </div>\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","MegaMenuGroup","useWindow","useComponentCssInjection","megaMenuGroupCss","useId","Children","isValidElement","MegaMenuHeader","cloneElement","jsxs","clsx","jsx"],"mappings":";;;;;;;;;;;AAeA,MAAM,YAAA,GAAeA,kBAAa,mBAAmB,CAAA;AAS9C,MAAM,aAAA,GAAgBC,gBAAA;AAAA,EAC3B,SAASC,eAAc,EAAE,QAAA,EAAU,WAAW,GAAG,IAAA,IAAQ,GAAA,EAAK;AAC5D,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,WAAWC,UAAA,EAAM;AACvB,IAAA,IAAI,MAAA,GAAoB,IAAA;AACxB,IAAA,MAAM,QAAqB,EAAC;AAE5B,IAAAC,cAAA,CAAS,OAAA,CAAQ,QAAA,EAAU,CAAC,KAAA,KAAU;AACpC,MAAA,IAAIC,qBAAe,KAAK,CAAA,IAAK,MAAM,IAAA,KAASC,6BAAA,IAAkB,CAAC,MAAA,EAAQ;AACrE,QAAA,MAAA,GAASC,kBAAA,CAAa,KAAA,EAAO,EAAE,EAAA,EAAI,UAAU,CAAA;AAAA,MAC/C,CAAA,MAAO;AACL,QAAA,KAAA,CAAM,KAAK,KAAK,CAAA;AAAA,MAClB;AAAA,IACF,CAAC,CAAA;AAED,IAAA,uBACEC,eAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,SAAA,EAAWC,SAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA;AAAA,QACzC,uBAAA,EAAsB,EAAA;AAAA,QACtB,GAAA;AAAA,QACC,GAAG,IAAA;AAAA,QAEH,QAAA,EAAA;AAAA,UAAA,MAAA;AAAA,0BACDC,cAAA;AAAA,YAAC,IAAA;AAAA,YAAA;AAAA,cACC,SAAA,EAAW,aAAa,MAAM,CAAA;AAAA,cAC9B,iBAAA,EAAiB,SAAS,QAAA,GAAW,MAAA;AAAA,cAEpC,QAAA,EAAA;AAAA;AAAA;AACH;AAAA;AAAA,KACF;AAAA,EAEJ;AACF;;;;"}
+{"version":3,"file":"MegaMenuGroup.js","sources":["../src/mega-menu/MegaMenuGroup.tsx"],"sourcesContent":["import { makePrefixer } 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  useMemo,\n  useState,\n} from \"react\";\nimport megaMenuGroupCss from \"./MegaMenuGroup.css\";\nimport { MegaMenuGroupContext } from \"./MegaMenuGroupContext\";\n\nconst withBaseName = makePrefixer(\"saltMegaMenuGroup\");\n\nexport interface MegaMenuGroupProps extends ComponentPropsWithoutRef<\"div\"> {\n  /**\n   * The content of the mega menu group: a `MegaMenuGroupHeading` and a\n   * `MegaMenuList` of `MegaMenuListItem`s.\n   */\n  children?: ReactNode;\n}\n\nexport const MegaMenuGroup = forwardRef<HTMLDivElement, MegaMenuGroupProps>(\n  function MegaMenuGroup({ children, className, ...rest }, ref) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-mega-menu-group\",\n      css: megaMenuGroupCss,\n      window: targetWindow,\n    });\n\n    // The heading registers its id so the list can label itself; `undefined`\n    // with no heading. The group is also a navigation column.\n    const [headingId, setHeadingId] = useState<string | undefined>(undefined);\n    const contextValue = useMemo(\n      () => ({ headingId, setHeadingId }),\n      [headingId],\n    );\n\n    return (\n      <MegaMenuGroupContext.Provider value={contextValue}>\n        <div\n          data-mega-menu-column=\"\"\n          className={clsx(withBaseName(), className)}\n          ref={ref}\n          {...rest}\n        >\n          {children}\n        </div>\n      </MegaMenuGroupContext.Provider>\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","MegaMenuGroup","useWindow","useComponentCssInjection","megaMenuGroupCss","useState","useMemo","jsx","MegaMenuGroupContext","clsx"],"mappings":";;;;;;;;;;;AAcA,MAAM,YAAA,GAAeA,kBAAa,mBAAmB,CAAA;AAU9C,MAAM,aAAA,GAAgBC,gBAAA;AAAA,EAC3B,SAASC,eAAc,EAAE,QAAA,EAAU,WAAW,GAAG,IAAA,IAAQ,GAAA,EAAK;AAC5D,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;AAID,IAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIC,eAA6B,MAAS,CAAA;AACxE,IAAA,MAAM,YAAA,GAAeC,aAAA;AAAA,MACnB,OAAO,EAAE,SAAA,EAAW,YAAA,EAAa,CAAA;AAAA,MACjC,CAAC,SAAS;AAAA,KACZ;AAEA,IAAA,uBACEC,cAAA,CAACC,yCAAA,CAAqB,QAAA,EAArB,EAA8B,OAAO,YAAA,EACpC,QAAA,kBAAAD,cAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,uBAAA,EAAsB,EAAA;AAAA,QACtB,SAAA,EAAWE,SAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA;AAAA,QACzC,GAAA;AAAA,QACC,GAAG,IAAA;AAAA,QAEH;AAAA;AAAA,KACH,EACF,CAAA;AAAA,EAEJ;AACF;;;;"}