@mortenbrudvik/waveui 0.10.0 → 0.11.0

package/dist/components/navigation/Hamburger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hamburger.mjs","names":["React","GLYPH_SIZES","Hamburger","rest","drawer","NavDrawerContext","iconButton","unwrapButtonGlyph","icon","glyphRenders","slotRendersContent","glyph","iconEmpty","warnOnce","label","materialiseSlotContent","children","named","toggle","event","stateProps","Button","withPartClass","NavigationIcon","size","hamburgerClassNames","composeEventHandlers","onClick","cn","className"],"sources":["../../../src/components/navigation/Hamburger.tsx"],"sourcesContent":["import * as React from 'react';\nimport { cn } from '../../lib/cn';\nimport { hamburgerClassNames } from '../../lib/classNames';\nimport { composeEventHandlers } from '../../lib/composeEventHandlers';\nimport { warnOnce } from '../../lib/dev';\nimport { NavigationIcon } from '../../lib/icons';\nimport { materialiseSlotContent, slotRendersContent, type Slot } from '../../lib/slot';\nimport type { Appearance, Size } from '../../lib/types';\nimport { Button } from '../button/Button';\nimport { unwrapButtonGlyph, withPartClass } from '../button/Button.slots';\nimport { NavDrawerContext } from './NavDrawer.context';\n\n/*\n * Hamburger: a Button with the navigation glyph that toggles the NavDrawer it sits in. Reads only\n * the NavDrawer's context module (never `NavDrawer.tsx`), so it holds no drawer machinery.\n */\n\n/** Properties for the Hamburger component. */\nexport interface HamburgerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  /**\n   * Visual style. Fluent's `transparent` look is WaveUI's `subtle` (WaveUI's `transparent` is\n   * link-coloured).\n   * @default 'subtle'\n   */\n  appearance?: Appearance;\n  /**\n   * Size: the button's height and the glyph (12, 16, 20, 24 or 28px).\n   * @default 'medium'\n   */\n  size?: Size;\n  /**\n   * Replaces the navigation glyph (three bars). Decorative (`aria-hidden`). Unlike Button's `icon`,\n   * a Hamburger always shows a glyph: `null`, `undefined` and a value that renders nothing keep\n   * the default (the last warns in development). A `<button>` or `Button` passed here is not\n   * nested: its children become the glyph and its props are dropped, with a warning.\n   */\n  icon?: Slot<'span'>;\n  /**\n   * The button's name. Without `aria-label`, `aria-labelledby`, `title` or a visible label\n   * (children), the Hamburger is named \"Navigation\"; localize it here. The name stays the same\n   * while the drawer opens and closes (the state is `aria-expanded`).\n   * @default 'Navigation'\n   */\n  'aria-label'?: string;\n  /**\n   * Unavailable but focusable (see `Button.disabledFocusable`): no toggle, no `onClick`.\n   * @default false\n   */\n  disabledFocusable?: boolean;\n  /** Ref to the `<button>`. */\n  ref?: React.Ref<HTMLButtonElement>;\n}\n\n/** The default glyph's size per button size. */\nconst GLYPH_SIZES: Readonly<Record<Size, number>> = {\n  'extra-small': 12,\n  small: 16,\n  medium: 20,\n  large: 24,\n  'extra-large': 28,\n};\n\n/**\n * A button that opens and closes a navigation drawer: a `Button` (`subtle`, icon-only) with the\n * navigation glyph, named \"Navigation\" by default. Inside a `NavDrawer` (in its header) it toggles\n * that drawer and reports it with `aria-expanded` and `aria-controls`. Elsewhere (your page\n * header) it is a plain button: pass `aria-expanded={open}`, `aria-controls` (while the drawer's\n * panel is rendered) and, for an overlay drawer, `aria-haspopup=\"dialog\"`, and toggle your state\n * in `onClick`. Fluent's `Hamburger`.\n *\n * @example\n * <Hamburger\n *   aria-expanded={open}\n *   aria-controls={open ? 'main-nav' : undefined}\n *   aria-haspopup=\"dialog\"\n *   onClick={() => setOpen(!open)}\n * />\n */\nexport const Hamburger = ({\n  appearance = 'subtle',\n  size = 'medium',\n  icon,\n  onClick,\n  className,\n  children,\n  ref,\n  ...rest\n}: HamburgerProps) => {\n  const drawer = React.useContext(NavDrawerContext);\n\n  // A required indicator (C-SLOTS): a button passed as `icon` is unwrapped, never nested, and a\n  // value that renders nothing keeps the default glyph.\n  const { glyph, button: iconButton } = unwrapButtonGlyph(icon);\n  const glyphRenders = slotRendersContent(glyph);\n  // An unwrapped button reports its own warning only.\n  const iconEmpty = iconButton === null && icon != null && !glyphRenders;\n  React.useEffect(() => {\n    if (iconEmpty) {\n      warnOnce(\n        'Hamburger:icon-empty',\n        'Hamburger: `icon` renders nothing, so the default navigation glyph shows. Unlike `Button`, a Hamburger always shows a glyph: pass an icon, or leave `icon` unset.',\n      );\n    }\n  }, [iconEmpty]);\n  React.useEffect(() => {\n    if (iconButton) {\n      warnOnce(\n        'Hamburger:icon-button',\n        `Hamburger: \\`icon\\` received ${iconButton}; its children render as the glyph and its props were dropped (buttons cannot be nested). Pass icon content instead, e.g. \\`icon={<MyIcon />}\\`.`,\n      );\n    }\n  }, [iconButton]);\n\n  // The default name, while nothing else names the button. A generator label is read once; its\n  // items are what renders.\n  const label = materialiseSlotContent(children);\n  const named =\n    Boolean(rest['aria-label']) ||\n    Boolean(rest['aria-labelledby']) ||\n    Boolean(rest.title) ||\n    slotRendersContent(label);\n\n  // Inside a NavDrawer: the toggle, after the consumer's onClick (`preventDefault()` skips it). A\n  // click that bubbles through the React tree from a portal opened inside it is not its own\n  // (C-COMPOSE).\n  const toggle = drawer\n    ? (event: React.MouseEvent<HTMLButtonElement>) => {\n        if (!(event.target instanceof Node) || !event.currentTarget.contains(event.target)) return;\n        drawer.requestOpen(!drawer.open, { reason: 'trigger', event: event.nativeEvent });\n      }\n    : undefined;\n  // The drawer's state wins over a consumer's (the modal triggers' rule); no `aria-haspopup`, as\n  // the Hamburger is inside the surface it toggles.\n  const stateProps = drawer\n    ? {\n        'aria-expanded': drawer.open,\n        'aria-controls': drawer.panelId,\n        'aria-haspopup': undefined,\n      }\n    : undefined;\n\n  return (\n    <Button\n      {...rest}\n      aria-label={named ? rest['aria-label'] : 'Navigation'}\n      {...stateProps}\n      ref={ref}\n      appearance={appearance}\n      size={size}\n      icon={withPartClass(\n        glyphRenders ? glyph : <NavigationIcon size={GLYPH_SIZES[size]} />,\n        hamburgerClassNames.icon,\n      )}\n      onClick={composeEventHandlers(onClick, toggle)}\n      className={cn(hamburgerClassNames.root, className)}\n    >\n      {label}\n    </Button>\n  );\n};\nHamburger.displayName = 'Hamburger';\n"],"mappings":";;;;;;;;;;;;;AAsDA,IAAMC,IAA8C;CAClD,eAAe;CACf,OAAO;CACP,QAAQ;CACR,OAAO;CACP,eAAe;AACjB,GAkBaC,KAAa,EACxB,gBAAa,UACb,UAAO,UACP,SACA,YACA,cACA,aACA,QACA,GAAGC,QACiB;CACpB,IAAMC,IAASJ,EAAM,WAAWK,CAAgB,GAI1C,EAAE,UAAO,QAAQC,MAAeC,EAAkBC,CAAI,GACtDC,IAAeC,EAAmBC,CAAK,GAEvCC,IAAYN,MAAe,QAAQE,KAAQ,QAAQ,CAACC;CAS1D,AARAT,EAAM,gBAAgB;EACpB,AAAIY,KACFC,EACE,wBACA,mKACF;CAEJ,GAAG,CAACD,CAAS,CAAC,GACdZ,EAAM,gBAAgB;EACpB,AAAIM,KACFO,EACE,yBACA,gCAAgCP,EAAW,iJAC7C;CAEJ,GAAG,CAACA,CAAU,CAAC;CAIf,IAAMQ,IAAQC,EAAuBC,CAAQ,GACvCC,IACJ,EAAQd,EAAK,iBACb,EAAQA,EAAK,sBACb,EAAQA,EAAK,SACbO,EAAmBI,CAAK,GAKpBI,IAASd,KACV,MAA+C;EAC9C,AAAMe,EAAM,kBAAkB,QAAUA,EAAM,cAAc,SAASA,EAAM,MAAM,KACjFf,EAAO,YAAY,CAACA,EAAO,MAAM;GAAE,QAAQ;GAAW,OAAOe,EAAM;EAAY,CAAC;CAClF,IACA,KAAA,GAGEC,IAAahB,IACf;EACE,iBAAiBA,EAAO;EACxB,iBAAiBA,EAAO;EACxB,iBAAiB,KAAA;CACnB,IACA,KAAA;CAEJ,OACE,kBAACiB,GAAD;EACE,GAAIlB;EACJ,cAAYc,IAAQd,EAAK,gBAAgB;EACzC,GAAIiB;EACC;EACO;EACN;EACN,MAAME,EACJb,IAAeE,IAAQ,kBAACY,GAAD,EAAgB,MAAMtB,EAAYuB,GAAQ,CAAA,GACjEC,EAAoB,IACtB;EACA,SAASC,EAAqBC,GAAST,CAAM;EAC7C,WAAWU,EAAGH,EAAoB,MAAMI,CAAS;EAEhD,UAAAf;CACK,CAAA;AAEZ;AACA,EAAU,cAAc"}

package/dist/components/navigation/Nav.cjs

@@ -1,2 +1,2 @@
-"use client";const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("../../lib/cn.cjs"),n=require("../../lib/children.cjs"),r=require("../../lib/dev.cjs"),i=require("../../lib/slot.cjs"),a=require("../../lib/classNames.cjs"),o=require("../../hooks/useEventCallback.cjs"),s=require("../../hooks/useControllable.cjs"),c=require("../../hooks/useId.cjs"),l=require("../../lib/styles.cjs"),u=require("../../lib/icons.cjs");let d=require("react");d=e.__toESM(d,1);let f=require("react/jsx-runtime");function p(){let e=new Map,t=new Set,n=()=>t.forEach(e=>e());return{record(t,r){(e.get(t)??null)!==r&&(r===null?e.delete(t):e.set(t,r),n())},forget(t,r){e.get(t)===r&&(e.delete(t),n())},get:t=>e.get(t),subscribe(e){return t.add(e),()=>{t.delete(e)}}}}var m=d.createContext(null);m.displayName=`NavContext`;var h=()=>{},g={value:``,select:h,openCategories:[],toggleCategory:h,registerValue:()=>h,currentCategory:void 0,categoryStore:{record:h,forget:h,get:()=>void 0,subscribe:()=>h}},_=d.createContext(null);_.displayName=`NavCategoryValueContext`;function v(e){return d.useContext(m)||(r.reportMissingContext(e,`Nav`),g)}function y(e,t){r.warnOnce(`Nav:duplicate-${e}:${t}`,e===`item`?`Nav: several items share the value "${t}". Nav.Item and Nav.SubItem values must be unique within a Nav; every item with the current value is marked as the current page.`:`Nav: several categories share the value "${t}". Nav.Category values must be unique within a Nav; they open and close together.`)}function b(e,t,n){let{registerValue:r}=e;d.useEffect(()=>r(t,n),[r,t,n])}function x(e,t){let n=d.useContext(_),{categoryStore:r}=e;d.useLayoutEffect(()=>{r.record(t,n)},[r,t,n])}var S=`flex h-5 w-5 shrink-0 items-center justify-center`;function C(e,n){return e&&i.slotRendersContent(e)?i.renderSlot(e,`span`,t.cn(n,S),{"aria-hidden":!0}):null}var w={base:t.cn(`flex w-full items-center gap-2 px-4 py-2 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none`,l.focusRingInset,l.disabledStyles),selected:`bg-subtle-selected text-primary font-semibold border-s-2 border-s-primary`,idle:`text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover`},T={base:t.cn(`flex w-full items-center ps-11 pe-4 py-1.5 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none`,l.focusRingInset,l.disabledStyles),selected:`text-primary font-semibold`,idle:`text-muted-foreground not-disabled:not-aria-disabled:hover:text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover`},E=t.cn(`flex w-full items-center gap-2 px-4 py-2 text-body-1 font-semibold text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover transition-colors motion-reduce:transition-none`,`data-[contains-current]:bg-subtle-selected data-[contains-current]:text-primary data-[contains-current]:border-s-2 data-[contains-current]:border-s-primary`,l.focusRingInset);function D(e){let{children:t}=e.props;return typeof t==`function`?void 0:t}function O(e){return(typeof e==`object`||typeof e==`function`)&&e!==null&&typeof e.then==`function`}function k(e,t){if(Array.isArray(e)){for(let n of e)k(n,t);return}try{d.Children.forEach(e,e=>{d.isValidElement(e)&&t(e)})}catch(e){if(!O(e))throw e}}function A(e,...t){return t.includes(n.getElementType(e,{suspend:!1}))}function j(e,t){let n=!1;return k(e,e=>{n||=A(e,I,L)&&e.props.value===t?!0:j(D(e),t)}),n}function M(e,t){let n=[];if(!t)return n;let r=e=>{k(e,e=>{let i=D(e);A(e,F)&&typeof e.props.value==`string`&&j(i,t)&&n.push(e.props.value),r(i)})};return r(e),n}function N(e){if(e.button!==0||e.metaKey||e.ctrlKey||e.shiftKey||e.altKey)return!0;let t=e.currentTarget,n=t.getAttribute(`target`);return!!n&&n.toLowerCase()!==`_self`||t.hasAttribute(`download`)}function P(e,n,r,i,a){let{value:o,icon:s,disabled:c=!1,href:l,className:u,children:d,onClick:p,ref:m,...h}=e,g=n.value===o,_=l!==void 0,v=e=>{if(c){e.preventDefault();return}p?.(e),!(_?!e.defaultPrevented&&N(e):e.defaultPrevented)&&n.select(o)},y=(0,f.jsxs)(f.Fragment,{children:[a&&C(s,i.icon),a?(0,f.jsx)(`span`,{className:t.cn(i.content,`flex-1 text-start`),children:d}):d]}),b=t.cn(i.root,r.base,g?r.selected:r.idle,u);if(_)return(0,f.jsx)(`li`,{className:i.listItem,children:(0,f.jsx)(`a`,{...h,ref:m,href:c?void 0:l,role:c?`link`:h.role,"aria-disabled":c?!0:h[`aria-disabled`],"aria-current":g?`page`:void 0,onClick:v,className:b,children:y})});let{rel:x,...S}=h;return(0,f.jsx)(`li`,{className:i.listItem,children:(0,f.jsx)(`button`,{type:`button`,...S,ref:m,disabled:c,"aria-current":g?`page`:void 0,onClick:v,className:b,children:y})})}var F=({value:e,label:n,icon:i,className:o,children:s,ref:l,...p})=>{let m=v(`Nav.Category`),{value:h,openCategories:g,toggleCategory:y,currentCategory:x,categoryStore:S}=m;b(m,`category`,e);let w=c.useId(`wave-nav-category`),T=g.includes(e),D=!T&&h!==``&&j(s,h),O=d.useSyncExternalStore(S.subscribe,()=>h!==``&&S.get(h)===e,()=>!1);d.useLayoutEffect(()=>{if(D)return S.record(h,e),()=>S.forget(h,e)},[S,D,h,e]);let k=!T&&(x===e||O||D),A=n,M=s;if(n===void 0){r.warnDeprecated(`Nav.Category`,`text children as the label`,`label`,"Pass the category label in `label` and only the sub-items as children.");let e=d.Children.toArray(s),t=e=>typeof e==`string`||typeof e==`number`;A=e.filter(t).join(``),M=e.filter(e=>!t(e))}return(0,f.jsxs)(`li`,{ref:l,...p,className:t.cn(a.navCategoryClassNames.root,o),children:[(0,f.jsxs)(`button`,{type:`button`,"aria-expanded":T,"aria-controls":T?w:void 0,"aria-current":k?!0:void 0,"data-contains-current":k?``:void 0,onClick:()=>y(e),className:t.cn(a.navCategoryClassNames.button,E),children:[C(i,a.navCategoryClassNames.icon),(0,f.jsx)(`span`,{className:t.cn(a.navCategoryClassNames.label,`flex-1 text-start`),children:A}),(0,f.jsx)(u.ChevronDownIcon,{className:t.cn(a.navCategoryClassNames.expandIcon,`shrink-0 transition-transform motion-reduce:transition-none`,T&&`rotate-180`)})]}),T&&(0,f.jsx)(_.Provider,{value:e,children:(0,f.jsx)(`ul`,{id:w,className:t.cn(a.navCategoryClassNames.list,`m-0 list-none p-0`),children:M})})]})};F.displayName=`NavCategory`;function I(e){let t=v(`Nav.Item`);return b(t,`item`,e.value),x(t,e.value),P(e,t,w,{root:a.navItemClassNames.root,listItem:a.navItemClassNames.listItem,icon:a.navItemClassNames.icon,content:a.navItemClassNames.content},!0)}I.displayName=`NavItem`;function L(e){let t=v(`Nav.SubItem`);return b(t,`item`,e.value),x(t,e.value),P(e,t,T,{root:a.navSubItemClassNames.root,listItem:a.navSubItemClassNames.listItem},!1)}L.displayName=`NavSubItem`;var R=({value:e,defaultValue:n,onValueChange:i,selectedValue:c,defaultSelectedValue:l,onNavItemSelect:u,openCategories:h,defaultOpenCategories:g,onOpenCategoriesChange:_,currentCategory:v,className:b,children:x,ref:S,...C})=>{let w=r.resolveDeprecatedProp(`Nav`,e,c,`selectedValue`,`value`),T=r.resolveDeprecatedProp(`Nav`,n,l,`defaultSelectedValue`,`defaultValue`)??``;u!==void 0&&r.warnDeprecated(`Nav`,`onNavItemSelect`,`onValueChange`);let[E,D]=s.useControllable(w,T,i),O=o.useEventCallback(u),k=d.useCallback(e=>{D(e),O(e)},[D,O]),[A]=d.useState(()=>g??M(x,w??T)),[j,N]=s.useControllable(h,A,e=>_?.([...e])),P=d.useCallback(e=>{N(t=>t.includes(e)?t.filter(t=>t!==e):[...t,e])},[N]),F=d.useRef(null),I=d.useCallback((e,t)=>{let n=F.current??=new Map,r=`${e}:${t}`,i=(n.get(r)??0)+1;return n.set(r,i),i>1&&y(e,t),()=>{let e=(n.get(r)??1)-1;e>0?n.set(r,e):n.delete(r)}},[]),[L]=d.useState(p),R=d.useMemo(()=>({value:E,select:k,openCategories:j,toggleCategory:P,registerValue:I,currentCategory:v,categoryStore:L}),[E,k,j,P,I,v,L]);return(0,f.jsx)(m.Provider,{value:R,children:(0,f.jsx)(`nav`,{"aria-label":`Navigation`,...C,ref:S,className:t.cn(a.navClassNames.root,`w-60 border-e border-border bg-background py-2`,b),children:(0,f.jsx)(`ul`,{className:t.cn(a.navClassNames.list,`m-0 list-none p-0`),children:x})})})};R.displayName=`Nav`;var z=Object.assign(R,{Category:F,Item:I,SubItem:L});exports.Nav=z,exports.NavCategory=F,exports.NavItem=I,exports.NavSubItem=L;
+"use client";const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("../../lib/cn.cjs"),n=require("../../lib/dev.cjs"),r=require("../../lib/slot.cjs"),i=require("../../lib/classNames.cjs"),a=require("../../hooks/useId.cjs"),o=require("../../lib/styles.cjs"),s=require("../../lib/icons.cjs"),c=require("./Nav.context.cjs"),l=require("./Nav.parts.cjs"),u=require("./Nav.root.cjs");let d=require("react");d=e.__toESM(d,1);let f=require("react/jsx-runtime");var p=`flex h-5 w-5 shrink-0 items-center justify-center`;function m(e,n){return e&&r.slotRendersContent(e)?r.renderSlot(e,`span`,t.cn(n,p),{"aria-hidden":!0}):null}var h={base:t.cn(`flex w-full items-center gap-2 px-4 py-2 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none`,o.focusRingInset,o.disabledStyles),selected:`bg-subtle-selected text-primary font-semibold border-s-2 border-s-primary`,idle:`text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover`,selectedInRow:`text-primary font-semibold`,rowSelected:`bg-subtle-selected border-s-2 border-s-primary`},g={base:t.cn(`flex w-full items-center ps-11 pe-4 py-1.5 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none`,o.focusRingInset,o.disabledStyles),selected:`text-primary font-semibold`,idle:`text-muted-foreground not-disabled:not-aria-disabled:hover:text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover`,selectedInRow:`text-primary font-semibold`,rowSelected:void 0},_=`group/nav-row flex items-center transition-colors motion-reduce:transition-none`,v=`hover:bg-subtle-hover`,y=t.cn(`flex shrink-0 items-center gap-1 pe-2`,`*:opacity-0 group-hover/nav-row:*:opacity-100 group-focus-within/nav-row:*:opacity-100`,`forced-colors:*:opacity-100 [@media(hover:none)]:*:opacity-100`,`*:has-[[aria-pressed=true]]:opacity-100 *:has-[[aria-expanded=true]]:opacity-100`,`[&>[aria-pressed=true]]:opacity-100 [&>[aria-expanded=true]]:opacity-100`),b=t.cn(`flex w-full items-center gap-2 px-4 py-2 text-body-1 font-semibold text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover transition-colors motion-reduce:transition-none`,`data-[contains-current]:bg-subtle-selected data-[contains-current]:text-primary data-[contains-current]:border-s-2 data-[contains-current]:border-s-primary`,o.focusRingInset);function x(e){if(e.button!==0||e.metaKey||e.ctrlKey||e.shiftKey||e.altKey)return!0;let t=e.currentTarget,n=t.getAttribute(`target`);return!!n&&n.toLowerCase()!==`_self`||t.hasAttribute(`download`)}function S(e,n,i,a,o,s,c){let{value:l,icon:u,disabled:d=!1,href:p,className:h,children:g,onClick:b,actions:S,ref:C,...w}=e,T=n.value===l,E=p!==void 0,D=i?{"data-roving-value":l}:void 0,O=r.slotRendersContent(S),k=w.id??c,A=O?{id:k}:void 0,j=e=>{if(d){e.preventDefault();return}b?.(e),!(E?!e.defaultPrevented&&x(e):e.defaultPrevented)&&n.select(l)},M=(0,f.jsxs)(f.Fragment,{children:[s&&m(u,o.icon),s?(0,f.jsx)(`span`,{className:t.cn(o.content,`flex-1 text-start`),children:g}):g]}),N=t.cn(o.root,a.base,T?O?a.selectedInRow:a.selected:a.idle,O&&`min-w-0 flex-1`,h),P=O?t.cn(o.listItem,_,T&&a.rowSelected?a.rowSelected:!d&&v):o.listItem,F=O?(0,f.jsx)(`span`,{role:`group`,"aria-labelledby":k,"data-wave-nav-actions":``,className:t.cn(o.actions,y),children:r.materialiseSlotContent(S)}):null;if(E)return(0,f.jsxs)(`li`,{className:P,children:[(0,f.jsx)(`a`,{...w,...A,...D,ref:C,href:d?void 0:p,role:d?`link`:w.role,"aria-disabled":d?!0:w[`aria-disabled`],"aria-current":T?`page`:void 0,onClick:j,className:N,children:M}),F]});let{rel:I,...L}=w;return(0,f.jsxs)(`li`,{className:P,children:[(0,f.jsx)(`button`,{type:`button`,...L,...A,...D,ref:C,disabled:d,"aria-current":T?`page`:void 0,onClick:j,className:N,children:M}),F]})}var C=({value:e,label:r,icon:o,className:l,children:u,ref:p,...h})=>{let g=c.useNavContext(`Nav.Category`),_=d.useContext(c.NavRovingContext),{value:v,openCategories:y,toggleCategory:x,currentCategory:S,categoryStore:C}=g;c.useNavValue(g,`category`,e);let w=a.useId(`wave-nav-category`),T=y.includes(e),E=!T&&v!==``&&c.containsValue(u,v),D=d.useSyncExternalStore(C.subscribe,()=>v!==``&&C.get(v)===e,()=>!1);d.useLayoutEffect(()=>{if(E)return C.record(v,e),()=>C.forget(v,e)},[C,E,v,e]);let O=!T&&(S===e||D||E);d.useLayoutEffect(()=>{if(_)return _.reportCurrentCategory(e,O),()=>_.reportCurrentCategory(e,!1)},[_,e,O]);let k=d.useRef(null);c.useNavListChildCheck(k,`Nav.Category`,`sub-items`);let A=r,j=u;if(r===void 0){n.warnDeprecated(`Nav.Category`,`text children as the label`,`label`,"Pass the category label in `label` and only the sub-items as children.");let e=d.Children.toArray(u),t=e=>typeof e==`string`||typeof e==`number`;A=e.filter(t).join(``),j=e.filter(e=>!t(e))}return(0,f.jsxs)(`li`,{ref:p,...h,className:t.cn(i.navCategoryClassNames.root,l),children:[(0,f.jsxs)(`button`,{type:`button`,"aria-expanded":T,"aria-controls":T?w:void 0,"aria-current":O?!0:void 0,"data-contains-current":O?``:void 0,"data-roving-value":_?`wave-nav-category:${e}`:void 0,onClick:()=>x(e),className:t.cn(i.navCategoryClassNames.button,b),children:[m(o,i.navCategoryClassNames.icon),(0,f.jsx)(`span`,{className:t.cn(i.navCategoryClassNames.label,`flex-1 text-start`),children:A}),(0,f.jsx)(s.ChevronDownIcon,{className:t.cn(i.navCategoryClassNames.expandIcon,`shrink-0 transition-transform motion-reduce:transition-none`,T&&`rotate-180`)})]}),T&&(0,f.jsx)(c.NavCategoryValueContext.Provider,{value:e,children:(0,f.jsx)(`ul`,{ref:k,id:w,className:t.cn(i.navCategoryClassNames.list,`m-0 list-none p-0`),children:j})})]})};C.displayName=`NavCategory`,c.markNavPart(C,`category`);function w(e){let t=c.useNavContext(`Nav.Item`);c.useNavValue(t,`item`,e.value),c.useRecordCategory(t,e.value);let n=d.useContext(c.NavRovingContext),r=a.useId(`wave-nav-item`);return S(e,t,n,h,{root:i.navItemClassNames.root,listItem:i.navItemClassNames.listItem,actions:i.navItemClassNames.actions,icon:i.navItemClassNames.icon,content:i.navItemClassNames.content},!0,r)}w.displayName=`NavItem`,c.markNavPart(w,`entry`);function T(e){let t=c.useNavContext(`Nav.SubItem`);c.useNavValue(t,`item`,e.value),c.useRecordCategory(t,e.value);let n=d.useContext(c.NavRovingContext),r=a.useId(`wave-nav-item`);return S(e,t,n,g,{root:i.navSubItemClassNames.root,listItem:i.navSubItemClassNames.listItem,actions:i.navSubItemClassNames.actions},!1,r)}T.displayName=`NavSubItem`,c.markNavPart(T,`entry`);var E=Object.assign(u.NavRoot,{Category:C,Item:w,SubItem:T,SectionHeader:l.NavSectionHeader,Divider:l.NavDivider,AppItem:l.NavAppItem,AppItemStatic:l.NavAppItemStatic});exports.Nav=E,exports.NavAppItem=l.NavAppItem,exports.NavAppItemStatic=l.NavAppItemStatic,exports.NavCategory=C,exports.NavDivider=l.NavDivider,exports.NavItem=w,exports.NavSectionHeader=l.NavSectionHeader,exports.NavSubItem=T;
 //# sourceMappingURL=Nav.cjs.map

package/dist/components/navigation/Nav.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Nav.cjs","names":["React","slotRendersContent","renderSlot","cn","focusRingInset","disabledStyles","getElementType","_Fragment","useId","navCategoryClassNames","ChevronDownIcon","navItemClassNames","navSubItemClassNames","resolveDeprecatedProp","useControllable","useEventCallback","navClassNames","require_runtime","require_cn","require_children","require_dev","require_slot","require_classNames","require_useEventCallback","require_useControllable","require_useId","require_styles","require_icons","react","react_jsx_runtime","createCategoryStore","categories","listeners","notify","listener","value","category","NavContext","noop","INERT_NAV_CONTEXT","NavCategoryValueContext","useNavContext","componentName","warnDuplicateValue","kind","useNavValue","context","registerValue","useRecordCategory","categoryStore","iconClasses","renderIcon","icon","className","itemClasses","subItemClasses","categoryButtonClasses","childrenOf","element","children","isThenable","forEachElement","nodes","node","visit","child","error","isPart","types","containsValue","found","NavItem","NavSubItem","selected","findCategoriesContaining","result","current","inner","NavCategory","opensElsewhere","event","link","target","renderNavEntry","rest","props","isSelected","isLink","href","handleClick","disabled","onClick","content","withIcon","stable","entryClassName","classes","buttonRest","currentValue","listId","isOpen","openCategories","holdsCurrentChild","holdsShownCurrent","containsCurrent","currentCategory","buttonLabel","label","items","parts","isText","part","toggleCategory","NavRoot","valueProp","defaultValueProp","openCategoriesProp","controlledValue","selectedValue","defaultValue","defaultSelectedValue","onNavItemSelect","setValue","onValueChange","notifyNavItemSelect","select","next","initialOpenCategories","defaultOpenCategories","setOpenCategories","onOpenCategoriesChange","previous","entry","valueCountsRef","counts","key","count","remaining","contextValue","Nav"],"sources":["../../../src/components/navigation/Nav.tsx"],"sourcesContent":["import * as React from 'react';\nimport { cn } from '../../lib/cn';\nimport {\n  navCategoryClassNames,\n  navClassNames,\n  navItemClassNames,\n  navSubItemClassNames,\n} from '../../lib/classNames';\nimport type { Slot } from '../../lib/types';\nimport { renderSlot, slotRendersContent } from '../../lib/slot';\nimport {\n  reportMissingContext,\n  resolveDeprecatedProp,\n  warnDeprecated,\n  warnOnce,\n} from '../../lib/dev';\nimport { getElementType } from '../../lib/children';\nimport { ChevronDownIcon } from '../../lib/icons';\nimport { disabledStyles, focusRingInset } from '../../lib/styles';\nimport { useControllable } from '../../hooks/useControllable';\nimport { useEventCallback } from '../../hooks/useEventCallback';\nimport { useId } from '../../hooks/useId';\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\n/** The two value namespaces of a Nav: items (Nav.Item and Nav.SubItem) and categories. */\ntype NavValueKind = 'item' | 'category';\n\n/**\n * The category each sub-item was last shown in, by sub-item value: written from layout effects by\n * the mounted sub-items and by a closed category whose children hold the current value, read by\n * the categories with `useSyncExternalStore`. An entry outlives its sub-item, so a category closed\n * after its current sub-item was shown still knows it contains the current page.\n */\ninterface NavCategoryStore {\n  /**\n   * Records the category a mounted item renders in, or a closed category whose children hold the\n   * value; `null` (an item outside any category) forgets an earlier entry, so a value moved out of\n   * a category no longer marks it.\n   */\n  record: (value: string, category: string | null) => void;\n  /** Forgets the entry of `value` while it is still `category`. */\n  forget: (value: string, category: string) => void;\n  /** The category last recorded for a sub-item value. */\n  get: (value: string) => string | undefined;\n  subscribe: (listener: () => void) => () => void;\n}\n\nfunction createCategoryStore(): NavCategoryStore {\n  const categories = new Map<string, string>();\n  const listeners = new Set<() => void>();\n  const notify = () => listeners.forEach((listener) => listener());\n  return {\n    record(value, category) {\n      if ((categories.get(value) ?? null) === category) return;\n      if (category === null) categories.delete(value);\n      else categories.set(value, category);\n      notify();\n    },\n    forget(value, category) {\n      if (categories.get(value) !== category) return;\n      categories.delete(value);\n      notify();\n    },\n    get: (value) => categories.get(value),\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\ninterface NavContextValue {\n  /** The selected item value (`''` when nothing is selected). */\n  value: string;\n  /** Selects an item (activation handler: also fires the deprecated `onNavItemSelect`). */\n  select: (value: string) => void;\n  openCategories: readonly string[];\n  toggleCategory: (value: string) => void;\n  /** Registers a mounted item or category value (duplicate warning); returns the cleanup. */\n  registerValue: (kind: NavValueKind, value: string) => () => void;\n  /** The `currentCategory` hint of the Nav. */\n  currentCategory: string | undefined;\n  categoryStore: NavCategoryStore;\n}\n\nconst NavContext = React.createContext<NavContextValue | null>(null);\nNavContext.displayName = 'NavContext';\n\nconst noop = () => {};\nconst INERT_NAV_CONTEXT: NavContextValue = {\n  value: '',\n  select: noop,\n  openCategories: [],\n  toggleCategory: noop,\n  registerValue: () => noop,\n  currentCategory: undefined,\n  categoryStore: { record: noop, forget: noop, get: () => undefined, subscribe: () => noop },\n};\n\n/**\n * The value of the Nav.Category a sub-item renders in (`null` outside a category). It renders no\n * element; a sub-item outside a category is valid, so there is no missing-context error.\n */\nconst NavCategoryValueContext = React.createContext<string | null>(null);\nNavCategoryValueContext.displayName = 'NavCategoryValueContext';\n\n/** C-CONTEXT: throws in development, logs once and returns an inert value in production. */\nfunction useNavContext(componentName: string): NavContextValue {\n  const context = React.useContext(NavContext);\n  if (context) return context;\n  reportMissingContext(componentName, 'Nav');\n  return INERT_NAV_CONTEXT;\n}\n\nfunction warnDuplicateValue(kind: NavValueKind, value: string): void {\n  warnOnce(\n    `Nav:duplicate-${kind}:${value}`,\n    kind === 'item'\n      ? `Nav: several items share the value \"${value}\". Nav.Item and Nav.SubItem values must be unique within a Nav; every item with the current value is marked as the current page.`\n      : `Nav: several categories share the value \"${value}\". Nav.Category values must be unique within a Nav; they open and close together.`,\n  );\n}\n\n/** Registers the value of a mounted item or category, so Nav can warn about duplicates. */\nfunction useNavValue(context: NavContextValue, kind: NavValueKind, value: string): void {\n  const { registerValue } = context;\n  React.useEffect(() => registerValue(kind, value), [registerValue, kind, value]);\n}\n\n/**\n * Records the category a mounted item renders in, which the category reads once closed (`null`\n * outside a category, which forgets a stale entry for the value).\n */\nfunction useRecordCategory(context: NavContextValue, value: string): void {\n  const category = React.useContext(NavCategoryValueContext);\n  const { categoryStore } = context;\n  React.useLayoutEffect(() => {\n    categoryStore.record(value, category);\n  }, [categoryStore, value, category]);\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Properties for the Nav component. */\nexport interface NavProps extends Omit<React.HTMLAttributes<HTMLElement>, 'defaultValue'> {\n  /** Controlled value of the selected nav item. */\n  value?: string;\n  /**\n   * Selected nav item value for uncontrolled usage.\n   * @default ''\n   */\n  defaultValue?: string;\n  /** Called with the new value when the selection changes (not when the current item is re-selected). */\n  onValueChange?: (value: string) => void;\n  /** @deprecated Use `value`. */\n  selectedValue?: string;\n  /** @deprecated Use `defaultValue`. */\n  defaultSelectedValue?: string;\n  /**\n   * @deprecated Use `onValueChange`. Unlike `onValueChange`, it fires on every activation,\n   * re-selecting the current item included (0.4 behaviour).\n   */\n  onNavItemSelect?: (value: string) => void;\n  /** Controlled list of open category values. */\n  openCategories?: readonly string[];\n  /**\n   * Categories open initially (uncontrolled). Without it, the categories that contain the\n   * selected item (`value`, else `defaultValue`) start open, so the current page is visible on the\n   * first render; an empty list keeps every category closed.\n   */\n  defaultOpenCategories?: readonly string[];\n  /** Called with the new list of open category values (a new array) when a category is toggled. */\n  onOpenCategoriesChange?: (openCategories: string[]) => void;\n  /**\n   * The `value` of the category that contains the current item, for sub-items Nav cannot find by\n   * itself (rendered by your own component inside a closed category). Usually not needed: Nav\n   * finds sub-items among a category's children (through Fragments and wrapper elements) and\n   * remembers the category of the current sub-item once it has been shown. A hint, not state:\n   * unlike Fluent's `selectedCategoryValue` it has no default or change callback.\n   */\n  currentCategory?: string;\n  /** Ref to the `<nav>` element. */\n  ref?: React.Ref<HTMLElement>;\n}\n\n/** Properties for the NavCategory sub-component. */\nexport interface NavCategoryProps extends React.HTMLAttributes<HTMLLIElement> {\n  /**\n   * Value identifying this category (used by `openCategories`), unique among the categories of\n   * the Nav (a duplicate warns in development).\n   */\n  value: string;\n  /**\n   * Label of the category's toggle button (any content). Without it, the text children are used\n   * as the label — deprecated: pass the label here and only the sub-items as children.\n   */\n  label?: React.ReactNode;\n  /**\n   * Icon displayed before the category label. Rendered with `aria-hidden=\"true\"`. A falsy icon\n   * (`''`, `0`) or a list of nothing renders no icon box.\n   */\n  icon?: Slot<'span'>;\n  /** The category's sub-items (`Nav.SubItem`), rendered in its list while it is open. */\n  children?: React.ReactNode;\n  /** Ref to the category's `<li>` element. */\n  ref?: React.Ref<HTMLLIElement>;\n}\n\n/**\n * The props of Nav.Item that every branch shares ({@link NavItemAnchorProps},\n * {@link NavItemButtonProps}, {@link NavItemDynamicProps}).\n */\nexport interface NavItemOwnProps {\n  /**\n   * Value identifying this nav item, unique among the items and sub-items of the Nav (a duplicate\n   * warns in development).\n   */\n  value: string;\n  /**\n   * Icon displayed before the item label. Rendered with `aria-hidden=\"true\"`. A falsy icon (`''`,\n   * `0`) or a list of nothing renders no icon box.\n   */\n  icon?: Slot<'span'>;\n  /**\n   * Whether the item is disabled: a native `disabled` button, or an `aria-disabled` link without\n   * `href`. Activating a disabled item never selects it; a disabled item whose value is the\n   * current `value` still shows as current (`aria-current=\"page\"` and the selected look), because\n   * the current value belongs to the app.\n   */\n  disabled?: boolean;\n  /** Label content. */\n  children?: React.ReactNode;\n}\n\n/**\n * The attributes only a link has (`target`, `download`, `hrefLang`, `ping`, …). Button items\n * declare them as `undefined`, so they are a type error without `href` instead of landing on the\n * `<button>`. `rel` cannot be listed (React types it on every element, RDFa); a button item drops\n * it at run time instead.\n */\ntype NoAnchorOnlyAttributes = {\n  [\n    K in Exclude<\n      keyof React.AnchorHTMLAttributes<HTMLAnchorElement>,\n      keyof React.ButtonHTMLAttributes<HTMLButtonElement>\n    >\n  ]?: undefined;\n};\n\n/**\n * Nav.Item rendered as a link (`href` given): anchor attributes, and handlers typed on\n * `HTMLAnchorElement`. 0.4 typed every item's handlers on `HTMLButtonElement`, so with a string\n * `href` an unannotated 0.4 handler that reads a button-only member (such as\n * `e.currentTarget.form`) no longer compiles; a handler already typed as\n * `React.MouseEventHandler<HTMLButtonElement>` still does (React handler types are bivariant).\n */\nexport interface NavItemAnchorProps\n  extends\n    NavItemOwnProps,\n    Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof NavItemOwnProps> {\n  /**\n   * URL to navigate to; renders an `<a>`. Required in this branch, so `href` discriminates the\n   * union and handlers without `href` are typed as button handlers.\n   */\n  href: string;\n  /** Ref to the `<a>` element. */\n  ref?: React.Ref<HTMLAnchorElement>;\n}\n\n/** Nav.Item rendered as a button (no `href`): button attributes (a `rel` is not rendered). */\nexport interface NavItemButtonProps\n  extends\n    NavItemOwnProps,\n    NoAnchorOnlyAttributes,\n    Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof NavItemOwnProps> {\n  /** Button items have no `href`. */\n  href?: undefined;\n  /** Ref to the `<button>` element. */\n  ref?: React.Ref<HTMLButtonElement>;\n}\n\n/**\n * Properties for the NavItem sub-component: link props with `href`, button props without.\n *\n * A union type (0.4 had an interface): an interface cannot extend it, so extend one branch\n * (`interface X extends NavItemButtonProps`) or intersect (`type X = NavItemProps & { … }`).\n * `React.ComponentProps<typeof Nav.Item>` resolves to the last overload,\n * {@link NavItemDynamicProps}.\n */\nexport type NavItemProps = NavItemAnchorProps | NavItemButtonProps;\n\n/**\n * Nav.Item with an `href` known only at run time (`string | undefined`): a link when it is a\n * string, a button otherwise. Resolved after the button and link signatures.\n *\n * Only the attributes both elements share are accepted (no `target`, `download`, `type`, `form`,\n * …), and handlers receive events of either element (`HTMLAnchorElement | HTMLButtonElement`).\n * 0.4 typed them as button events (`HTMLAttributes<HTMLButtonElement>`), so an unannotated 0.4\n * handler that reads a button-only member (such as `e.currentTarget.form`) no longer compiles here;\n * narrow `e.currentTarget` first. (A string `href` types handlers on `HTMLAnchorElement`, see\n * {@link NavItemAnchorProps}; no `href` keeps `HTMLButtonElement`.)\n */\nexport interface NavItemDynamicProps\n  extends\n    NavItemOwnProps,\n    Omit<React.HTMLAttributes<HTMLAnchorElement | HTMLButtonElement>, keyof NavItemOwnProps> {\n  /** URL to navigate to; renders an `<a>` when defined, a `<button>` otherwise. */\n  href?: string;\n  /** Ref to the rendered `<a>` or `<button>` element. */\n  ref?: React.Ref<HTMLAnchorElement | HTMLButtonElement>;\n}\n\n/**\n * The props of Nav.SubItem that every branch shares: those of {@link NavItemOwnProps} without\n * `icon`.\n */\nexport type NavSubItemOwnProps = Omit<NavItemOwnProps, 'icon'>;\n\n/**\n * Nav.SubItem rendered as a link (`href` given): anchor attributes, and handlers typed on\n * `HTMLAnchorElement` (0.4: `HTMLButtonElement`); see {@link NavItemAnchorProps}.\n */\nexport interface NavSubItemAnchorProps\n  extends\n    NavSubItemOwnProps,\n    Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof NavSubItemOwnProps> {\n  /**\n   * URL to navigate to; renders an `<a>`. Required in this branch, so `href` discriminates the\n   * union and handlers without `href` are typed as button handlers.\n   */\n  href: string;\n  /** Ref to the `<a>` element. */\n  ref?: React.Ref<HTMLAnchorElement>;\n}\n\n/** Nav.SubItem rendered as a button (no `href`): button attributes (a `rel` is not rendered). */\nexport interface NavSubItemButtonProps\n  extends\n    NavSubItemOwnProps,\n    NoAnchorOnlyAttributes,\n    Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof NavSubItemOwnProps> {\n  /** Button sub-items have no `href`. */\n  href?: undefined;\n  /** Ref to the `<button>` element. */\n  ref?: React.Ref<HTMLButtonElement>;\n}\n\n/**\n * Properties for the NavSubItem sub-component: link props with `href`, button props without.\n * A union type like {@link NavItemProps} (extend a branch or intersect; `React.ComponentProps`\n * resolves to {@link NavSubItemDynamicProps}).\n */\nexport type NavSubItemProps = NavSubItemAnchorProps | NavSubItemButtonProps;\n\n/**\n * Nav.SubItem with an `href` known only at run time (`string | undefined`): a link when it is a\n * string, a button otherwise. Only the attributes both elements share are accepted, and handlers\n * receive events of either element (0.4 typed them as button events); see\n * {@link NavItemDynamicProps}.\n */\nexport interface NavSubItemDynamicProps\n  extends\n    NavSubItemOwnProps,\n    Omit<React.HTMLAttributes<HTMLAnchorElement | HTMLButtonElement>, keyof NavSubItemOwnProps> {\n  /** URL to navigate to; renders an `<a>` when defined, a `<button>` otherwise. */\n  href?: string;\n  /** Ref to the rendered `<a>` or `<button>` element. */\n  ref?: React.Ref<HTMLAnchorElement | HTMLButtonElement>;\n}\n\n/** The props both entry kinds share at runtime (the union narrowed by `href`). */\ntype NavEntryProps = NavItemOwnProps &\n  Omit<React.AllHTMLAttributes<HTMLElement>, keyof NavItemOwnProps | 'ref'> & {\n    ref?: React.Ref<HTMLElement>;\n  };\n\n// ---------------------------------------------------------------------------\n// Styles\n// ---------------------------------------------------------------------------\n\nconst iconClasses = 'flex h-5 w-5 shrink-0 items-center justify-center';\n\n/**\n * The `icon` slot of Nav.Item and Nav.Category, or `null` when it renders nothing. A falsy icon\n * (`icon={name && <Icon />}` with `name` '' or a count of 0) is no icon, as in 0.4 and as in\n * Avatar, and so is a collection whose items render nothing, so no empty 20px box is rendered\n * before the label. The check does not consume a generator: renderSlot still renders its items.\n */\nfunction renderIcon(\n  icon: Slot<'span'> | undefined,\n  className: string | undefined,\n): React.ReactElement | null {\n  return icon && slotRendersContent(icon)\n    ? renderSlot(icon, 'span', cn(className, iconClasses), { 'aria-hidden': true })\n    : null;\n}\n\nconst itemClasses = {\n  base: cn(\n    'flex w-full items-center gap-2 px-4 py-2 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none',\n    focusRingInset,\n    disabledStyles,\n  ),\n  selected: 'bg-subtle-selected text-primary font-semibold border-s-2 border-s-primary',\n  idle: 'text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover',\n};\n\nconst subItemClasses = {\n  base: cn(\n    'flex w-full items-center ps-11 pe-4 py-1.5 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none',\n    focusRingInset,\n    disabledStyles,\n  ),\n  selected: 'text-primary font-semibold',\n  idle: 'text-muted-foreground not-disabled:not-aria-disabled:hover:text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover',\n};\n\nconst categoryButtonClasses = cn(\n  'flex w-full items-center gap-2 px-4 py-2 text-body-1 font-semibold text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover transition-colors motion-reduce:transition-none',\n  // A closed category that contains the current page shows the selected look of an item.\n  'data-[contains-current]:bg-subtle-selected data-[contains-current]:text-primary data-[contains-current]:border-s-2 data-[contains-current]:border-s-primary',\n  focusRingInset,\n);\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\ntype ElementWithChildren = React.ReactElement<{ value?: unknown; children?: React.ReactNode }>;\n\nfunction childrenOf(element: ElementWithChildren): React.ReactNode {\n  const { children } = element.props;\n  return typeof children === 'function' ? undefined : children;\n}\n\n/** Whether a thrown value suspends rendering (a loading lazy chunk, a pending promise). */\nfunction isThenable(value: unknown): boolean {\n  return (\n    (typeof value === 'object' || typeof value === 'function') &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\n/*\n * The walks below run during Nav's render and reach consumer content at any depth. Content that\n * is still loading inside the consumer's own <Suspense> (a promise child, a lazy node, a\n * `React.lazy` component) suspends that boundary when React renders it; walking it must never\n * suspend Nav itself, which would hide the whole Nav behind an outer boundary. So a child that\n * cannot be read yet is skipped, and a lazy type that is still loading is not a part (its\n * children are still walked). Parts written in a Server Component arrive as loaded client\n * references and are recognized.\n */\n\n/** Calls `visit` with each element of `nodes` (as `React.Children.forEach`), skipping pending ones. */\nfunction forEachElement(nodes: React.ReactNode, visit: (child: ElementWithChildren) => void): void {\n  if (Array.isArray(nodes)) {\n    for (const node of nodes as React.ReactNode[]) forEachElement(node, visit);\n    return;\n  }\n  try {\n    React.Children.forEach(nodes, (child) => {\n      if (React.isValidElement<ElementWithChildren['props']>(child)) visit(child);\n    });\n  } catch (error) {\n    if (!isThenable(error)) throw error;\n  }\n}\n\n/** Whether `element` is one of `types`; a lazy type still loading is none (it never suspends). */\nfunction isPart(element: ElementWithChildren, ...types: unknown[]): boolean {\n  return types.includes(getElementType(element, { suspend: false }));\n}\n\n/**\n * Whether `nodes` contain a Nav.Item/Nav.SubItem element with `value === selected` (parts written\n * in a Server Component, lazy client references, included). Called during render only.\n */\nfunction containsValue(nodes: React.ReactNode, selected: string): boolean {\n  let found = false;\n  forEachElement(nodes, (child) => {\n    if (found) return;\n    if (isPart(child, NavItem, NavSubItem) && child.props.value === selected) {\n      found = true;\n    } else {\n      found = containsValue(childrenOf(child), selected);\n    }\n  });\n  return found;\n}\n\n/** The values of the Nav.Category elements (at any depth of JSX) that contain `selected`. */\nfunction findCategoriesContaining(nodes: React.ReactNode, selected: string): string[] {\n  const result: string[] = [];\n  if (!selected) return result;\n  const visit = (current: React.ReactNode) => {\n    forEachElement(current, (child) => {\n      const inner = childrenOf(child);\n      if (\n        isPart(child, NavCategory) &&\n        typeof child.props.value === 'string' &&\n        containsValue(inner, selected)\n      ) {\n        result.push(child.props.value);\n      }\n      visit(inner);\n    });\n  };\n  visit(nodes);\n  return result;\n}\n\n/**\n * Whether a click on a link opens it somewhere other than the current page, checked as routers\n * do: a modifier key (a new tab or window, a download), a mouse button other than the main one, a\n * `target` other than `_self`, or a `download` link. Only when the default is not prevented does\n * the browser actually open it there.\n */\nfunction opensElsewhere(event: React.MouseEvent<HTMLElement>): boolean {\n  if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {\n    return true;\n  }\n  const link = event.currentTarget;\n  const target = link.getAttribute('target');\n  return (!!target && target.toLowerCase() !== '_self') || link.hasAttribute('download');\n}\n\n/** The stable classes of an entry, written literally by Nav.Item and Nav.SubItem. */\ninterface NavEntryClassNames {\n  root: string;\n  listItem: string;\n  icon?: string;\n  content?: string;\n}\n\n/** Shared rendering of Nav.Item and Nav.SubItem (link or button). */\nfunction renderNavEntry(\n  props: NavEntryProps,\n  context: NavContextValue,\n  classes: { base: string; selected: string; idle: string },\n  stable: NavEntryClassNames,\n  withIcon: boolean,\n): React.ReactElement {\n  const { value, icon, disabled = false, href, className, children, onClick, ref, ...rest } = props;\n  const isSelected = context.value === value;\n  const isLink = href !== undefined;\n\n  const handleClick = (event: React.MouseEvent<HTMLElement>) => {\n    if (disabled) {\n      event.preventDefault();\n      return;\n    }\n    onClick?.(event);\n    // A link is still selected when the consumer prevents its default (client-side routing:\n    // `preventDefault()` + `router.push(href)`, whatever the modifier keys: the browser then opens\n    // nothing elsewhere), but not when the browser opens it elsewhere (the current page does not\n    // change); a button honours `preventDefault()` (C-COMPOSE).\n    if (isLink ? !event.defaultPrevented && opensElsewhere(event) : event.defaultPrevented) return;\n    context.select(value);\n  };\n\n  const content = (\n    <>\n      {withIcon && renderIcon(icon, stable.icon)}\n      {withIcon ? (\n        <span className={cn(stable.content, 'flex-1 text-start')}>{children}</span>\n      ) : (\n        children\n      )}\n    </>\n  );\n\n  const entryClassName = cn(\n    stable.root,\n    classes.base,\n    isSelected ? classes.selected : classes.idle,\n    className,\n  );\n\n  if (isLink) {\n    return (\n      <li className={stable.listItem}>\n        <a\n          {...(rest as React.AnchorHTMLAttributes<HTMLAnchorElement>)}\n          ref={ref as React.Ref<HTMLAnchorElement>}\n          href={disabled ? undefined : href}\n          role={disabled ? 'link' : rest.role}\n          aria-disabled={disabled ? true : rest['aria-disabled']}\n          aria-current={isSelected ? 'page' : undefined}\n          onClick={handleClick}\n          className={entryClassName}\n        >\n          {content}\n        </a>\n      </li>\n    );\n  }\n\n  // `rel` only belongs on a link: a button item drops it (React types it on every element).\n  const { rel, ...buttonRest } = rest;\n  return (\n    <li className={stable.listItem}>\n      <button\n        type=\"button\"\n        {...(buttonRest as React.ButtonHTMLAttributes<HTMLButtonElement>)}\n        ref={ref as React.Ref<HTMLButtonElement>}\n        disabled={disabled}\n        aria-current={isSelected ? 'page' : undefined}\n        onClick={handleClick}\n        className={entryClassName}\n      >\n        {content}\n      </button>\n    </li>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Nav.Category\n// ---------------------------------------------------------------------------\n\n/**\n * A collapsible group of sub-items. Its toggle button shows `label` and reports `aria-expanded`\n * (and `aria-controls` while open); the sub-items render in a nested list while it is open.\n * Open state lives on `Nav` (`openCategories`/`defaultOpenCategories`).\n *\n * A closed category that contains the current item marks its toggle button with\n * `aria-current=\"true\"` (the button is not the page's link, so not `\"page\"`),\n * `data-contains-current` and the selected look of `Nav.Item`. It contains the current item when\n * a `Nav.SubItem` with the current value is among its children (through Fragments and wrapper\n * elements, also in the server HTML), when the current sub-item was last shown in it (and has not\n * moved among another category's children since), or when it is the Nav's `currentCategory`. An\n * open category is not marked: its sub-item shows the current page.\n *\n * Also exported as `NavCategory` (import the flat name from React Server Components).\n */\nconst NavCategory = ({\n  value,\n  label,\n  icon,\n  className,\n  children,\n  ref,\n  ...rest\n}: NavCategoryProps) => {\n  const context = useNavContext('Nav.Category');\n  const {\n    value: currentValue,\n    openCategories,\n    toggleCategory,\n    currentCategory,\n    categoryStore,\n  } = context;\n  useNavValue(context, 'category', value);\n  const listId = useId('wave-nav-category');\n  const isOpen = openCategories.includes(value);\n\n  // The current sub-item is among the children of this closed category (also on the server).\n  const holdsCurrentChild = !isOpen && currentValue !== '' && containsValue(children, currentValue);\n  // The current sub-item was last shown in this category (none on the server).\n  const holdsShownCurrent = React.useSyncExternalStore(\n    categoryStore.subscribe,\n    () => currentValue !== '' && categoryStore.get(currentValue) === value,\n    () => false,\n  );\n  // Children that hold the current sub-item make this the category the Nav remembers for it, so a\n  // category it was shown in before it moved here is no longer marked. The entry is forgotten when\n  // they stop holding it (an open category records through its mounted sub-item instead).\n  React.useLayoutEffect(() => {\n    if (!holdsCurrentChild) return;\n    categoryStore.record(currentValue, value);\n    return () => categoryStore.forget(currentValue, value);\n  }, [categoryStore, holdsCurrentChild, currentValue, value]);\n  const containsCurrent =\n    !isOpen && (currentCategory === value || holdsShownCurrent || holdsCurrentChild);\n\n  let buttonLabel: React.ReactNode = label;\n  let items: React.ReactNode = children;\n  if (label === undefined) {\n    // Deprecated 0.4 path: the text children are the label, the other children the sub-items.\n    warnDeprecated(\n      'Nav.Category',\n      'text children as the label',\n      'label',\n      'Pass the category label in `label` and only the sub-items as children.',\n    );\n    const parts = React.Children.toArray(children);\n    const isText = (part: unknown) => typeof part === 'string' || typeof part === 'number';\n    buttonLabel = parts.filter(isText).join('');\n    items = parts.filter((part) => !isText(part));\n  }\n\n  return (\n    <li ref={ref} {...rest} className={cn(navCategoryClassNames.root, className)}>\n      <button\n        type=\"button\"\n        aria-expanded={isOpen}\n        aria-controls={isOpen ? listId : undefined}\n        aria-current={containsCurrent ? true : undefined}\n        data-contains-current={containsCurrent ? '' : undefined}\n        onClick={() => toggleCategory(value)}\n        className={cn(navCategoryClassNames.button, categoryButtonClasses)}\n      >\n        {renderIcon(icon, navCategoryClassNames.icon)}\n        <span className={cn(navCategoryClassNames.label, 'flex-1 text-start')}>{buttonLabel}</span>\n        <ChevronDownIcon\n          className={cn(\n            navCategoryClassNames.expandIcon,\n            'shrink-0 transition-transform motion-reduce:transition-none',\n            isOpen && 'rotate-180',\n          )}\n        />\n      </button>\n      {isOpen && (\n        <NavCategoryValueContext.Provider value={value}>\n          <ul id={listId} className={cn(navCategoryClassNames.list, 'm-0 list-none p-0')}>\n            {items}\n          </ul>\n        </NavCategoryValueContext.Provider>\n      )}\n    </li>\n  );\n};\nNavCategory.displayName = 'NavCategory';\n\n// ---------------------------------------------------------------------------\n// Nav.Item / Nav.SubItem\n// ---------------------------------------------------------------------------\n\n/**\n * A top-level navigation entry: a link when `href` is given (anchor props), a button otherwise\n * (button props). Clicking selects it (`aria-current=\"page\"`); activating a disabled entry never\n * selects it (a disabled entry whose value is the current value still shows as current).\n *\n * A click that opens a link somewhere other than the current page selects nothing (the consumer's\n * `onClick` still runs, and the browser opens the link): Ctrl/Cmd/Shift/Alt-click, a mouse button\n * other than the main one, a `target` other than `_self`, or a `download` link. When the consumer's\n * `onClick` calls `preventDefault()` (client-side routing), the browser opens nothing, so the item\n * is selected whatever the keys, button or `target`.\n *\n * Typed by overloads, resolved in order: without `href` (button props, button events), with a\n * string `href` (anchor props, anchor events), then an `href` that may be `undefined` at run time\n * ({@link NavItemDynamicProps}: events of either element).\n *\n * Also exported as `NavItem` (import the flat name from React Server Components).\n */\nfunction NavItem(props: NavItemButtonProps): React.ReactElement;\nfunction NavItem(props: NavItemAnchorProps): React.ReactElement;\nfunction NavItem(props: NavItemDynamicProps): React.ReactElement;\nfunction NavItem(props: NavItemProps | NavItemDynamicProps): React.ReactElement {\n  const context = useNavContext('Nav.Item');\n  useNavValue(context, 'item', props.value);\n  useRecordCategory(context, props.value);\n  return renderNavEntry(\n    props as NavEntryProps,\n    context,\n    itemClasses,\n    {\n      root: navItemClassNames.root,\n      listItem: navItemClassNames.listItem,\n      icon: navItemClassNames.icon,\n      content: navItemClassNames.content,\n    },\n    true,\n  );\n}\nNavItem.displayName = 'NavItem';\n\n/**\n * An indented entry inside a `Nav.Category`: a link when `href` is given, a button otherwise.\n * Selected like `Nav.Item` (a click that the browser opens somewhere else selects nothing; one\n * whose default your `onClick` prevents is selected), and typed by overloads like `Nav.Item`\n * (button, link, then {@link NavSubItemDynamicProps}).\n *\n * Also exported as `NavSubItem` (import the flat name from React Server Components).\n */\nfunction NavSubItem(props: NavSubItemButtonProps): React.ReactElement;\nfunction NavSubItem(props: NavSubItemAnchorProps): React.ReactElement;\nfunction NavSubItem(props: NavSubItemDynamicProps): React.ReactElement;\nfunction NavSubItem(props: NavSubItemProps | NavSubItemDynamicProps): React.ReactElement {\n  const context = useNavContext('Nav.SubItem');\n  useNavValue(context, 'item', props.value);\n  useRecordCategory(context, props.value);\n  return renderNavEntry(\n    props as NavEntryProps,\n    context,\n    subItemClasses,\n    { root: navSubItemClassNames.root, listItem: navSubItemClassNames.listItem },\n    false,\n  );\n}\nNavSubItem.displayName = 'NavSubItem';\n\n// ---------------------------------------------------------------------------\n// Nav (root)\n// ---------------------------------------------------------------------------\n\nconst NavRoot = ({\n  value: valueProp,\n  defaultValue: defaultValueProp,\n  onValueChange,\n  selectedValue,\n  defaultSelectedValue,\n  onNavItemSelect,\n  openCategories: openCategoriesProp,\n  defaultOpenCategories,\n  onOpenCategoriesChange,\n  currentCategory,\n  className,\n  children,\n  ref,\n  ...rest\n}: NavProps) => {\n  const controlledValue = resolveDeprecatedProp(\n    'Nav',\n    valueProp,\n    selectedValue,\n    'selectedValue',\n    'value',\n  );\n  const defaultValue =\n    resolveDeprecatedProp(\n      'Nav',\n      defaultValueProp,\n      defaultSelectedValue,\n      'defaultSelectedValue',\n      'defaultValue',\n    ) ?? '';\n  if (onNavItemSelect !== undefined) warnDeprecated('Nav', 'onNavItemSelect', 'onValueChange');\n\n  const [value, setValue] = useControllable(controlledValue, defaultValue, onValueChange);\n  const notifyNavItemSelect = useEventCallback(onNavItemSelect);\n  const select = React.useCallback(\n    (next: string) => {\n      setValue(next);\n      // Deprecated event-named alias: every activation, re-selection included (C-NAMING).\n      notifyNavItemSelect(next);\n    },\n    [setValue, notifyNavItemSelect],\n  );\n\n  const [initialOpenCategories] = React.useState<readonly string[]>(\n    () =>\n      defaultOpenCategories ?? findCategoriesContaining(children, controlledValue ?? defaultValue),\n  );\n  const [openCategories, setOpenCategories] = useControllable<readonly string[]>(\n    openCategoriesProp,\n    initialOpenCategories,\n    (next) => onOpenCategoriesChange?.([...next]),\n  );\n  const toggleCategory = React.useCallback(\n    (category: string) => {\n      setOpenCategories((previous) =>\n        previous.includes(category)\n          ? previous.filter((entry) => entry !== category)\n          : [...previous, category],\n      );\n    },\n    [setOpenCategories],\n  );\n\n  // Duplicate values (C-DEV): the mounted items and categories per value (written from their\n  // effects only); a second one with a value already in use warns once per value.\n  const valueCountsRef = React.useRef<Map<string, number> | null>(null);\n  const registerValue = React.useCallback((kind: NavValueKind, entry: string) => {\n    const counts = (valueCountsRef.current ??= new Map<string, number>());\n    const key = `${kind}:${entry}`;\n    const count = (counts.get(key) ?? 0) + 1;\n    counts.set(key, count);\n    if (count > 1) warnDuplicateValue(kind, entry);\n    return () => {\n      const remaining = (counts.get(key) ?? 1) - 1;\n      if (remaining > 0) counts.set(key, remaining);\n      else counts.delete(key);\n    };\n  }, []);\n\n  const [categoryStore] = React.useState(createCategoryStore);\n\n  const contextValue = React.useMemo<NavContextValue>(\n    () => ({\n      value,\n      select,\n      openCategories,\n      toggleCategory,\n      registerValue,\n      currentCategory,\n      categoryStore,\n    }),\n    [value, select, openCategories, toggleCategory, registerValue, currentCategory, categoryStore],\n  );\n\n  return (\n    <NavContext.Provider value={contextValue}>\n      <nav\n        aria-label=\"Navigation\"\n        {...rest}\n        ref={ref}\n        className={cn(\n          navClassNames.root,\n          'w-60 border-e border-border bg-background py-2',\n          className,\n        )}\n      >\n        <ul className={cn(navClassNames.list, 'm-0 list-none p-0')}>{children}</ul>\n      </nav>\n    </NavContext.Provider>\n  );\n};\nNavRoot.displayName = 'Nav';\n\n/**\n * A vertical side navigation (`<nav>` landmark, default name \"Navigation\") with items, links and\n * collapsible categories.\n *\n * - **Selection**: `value`/`defaultValue`/`onValueChange` (`onValueChange` fires only when the\n *   value changes). The deprecated `selectedValue`/`defaultSelectedValue`/`onNavItemSelect` still\n *   work; `onNavItemSelect` keeps firing on every activation, re-selection included. A click that\n *   opens a link in another tab or window (or downloads it) selects nothing, unless the item's\n *   `onClick` prevents the default (client-side routing: then nothing opens elsewhere).\n * - **Categories**: `openCategories`/`defaultOpenCategories`/`onOpenCategoriesChange`. Without\n *   `defaultOpenCategories`, the categories containing the selected item (`value` or\n *   `defaultValue`) start open. A closed category that contains the selected item marks its toggle\n *   (`aria-current=\"true\"`, `data-contains-current`, the selected look); pass `currentCategory`\n *   for sub-items your own component renders inside a closed category.\n * - **Values** are unique: among the items and sub-items, and among the categories (a duplicate\n *   warns in development).\n *\n * Sub-components are also exported under flat names (`NavCategory`, `NavItem`, `NavSubItem`):\n * React Server Components import those, because dotted access (`Nav.Item`) needs a client file.\n */\nexport const Nav = /* @__PURE__ */ Object.assign(NavRoot, {\n  Category: NavCategory,\n  Item: NavItem,\n  SubItem: NavSubItem,\n});\n\nexport { NavCategory, NavItem, NavSubItem };\n"],"mappings":"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"}
+{"version":3,"file":"Nav.cjs","names":["slotRendersContent","renderSlot","cn","focusRingInset","disabledStyles","_Fragment","materialiseSlotContent","useNavContext","React","NavRovingContext","useId","containsValue","navCategoryClassNames","ChevronDownIcon","NavCategoryValueContext","markNavPart","navItemClassNames","navSubItemClassNames","NavRoot","NavSectionHeader","NavDivider","NavAppItem","NavAppItemStatic","require_runtime","require_cn","require_dev","require_slot","require_classNames","require_useId","require_styles","require_icons","require_Nav_context","require_Nav_parts","require_Nav_root","react","react_jsx_runtime","iconClasses","renderIcon","icon","className","itemClasses","subItemClasses","rowClasses","rowHoverClasses","actionsClasses","categoryButtonClasses","opensElsewhere","event","link","target","renderNavEntry","rest","props","isSelected","context","value","isLink","href","rovingProps","roving","hasActions","actions","itemId","generatedId","idProps","handleClick","disabled","onClick","content","withIcon","stable","children","entryClassName","classes","listItemClassName","actionsGroup","buttonRest","NavCategory","currentValue","listId","isOpen","openCategories","holdsCurrentChild","holdsShownCurrent","categoryStore","containsCurrent","currentCategory","listRef","buttonLabel","label","items","parts","isText","part","toggleCategory","NavItem","NavSubItem","Nav"],"sources":["../../../src/components/navigation/Nav.tsx"],"sourcesContent":["import * as React from 'react';\nimport { cn } from '../../lib/cn';\nimport {\n  navCategoryClassNames,\n  navItemClassNames,\n  navSubItemClassNames,\n} from '../../lib/classNames';\nimport type { Slot } from '../../lib/types';\nimport { materialiseSlotContent, renderSlot, slotRendersContent } from '../../lib/slot';\nimport { warnDeprecated } from '../../lib/dev';\nimport { ChevronDownIcon } from '../../lib/icons';\nimport { disabledStyles, focusRingInset } from '../../lib/styles';\nimport { useId } from '../../hooks/useId';\nimport {\n  NavCategoryValueContext,\n  NavRovingContext,\n  containsValue,\n  markNavPart,\n  useNavContext,\n  useNavListChildCheck,\n  useNavValue,\n  useRecordCategory,\n  type NavContextValue,\n  type NavRovingContextValue,\n  type NoAnchorOnlyAttributes,\n} from './Nav.context';\nimport { NavAppItem, NavAppItemStatic, NavDivider, NavSectionHeader } from './Nav.parts';\nimport { NavRoot } from './Nav.root';\n\n/*\n * The Nav compound: the item types, styles and rendering of Nav.Item and Nav.SubItem, Nav.Category,\n * the `Object.assign` with its JSDoc, the flat names and the type re-exports. Nothing imports this\n * module but the barrel: the root (`Nav.root.tsx`) and the contexts (`Nav.context.ts`) recognise\n * the parts by the markers set next to each `displayName` below; the structural parts live in\n * `Nav.parts.tsx`.\n */\n\nexport type { NavProps } from './Nav.root';\nexport type {\n  NavSectionHeaderProps,\n  NavDividerProps,\n  NavAppItemOwnProps,\n  NavAppItemAnchorProps,\n  NavAppItemButtonProps,\n  NavAppItemProps,\n  NavAppItemDynamicProps,\n  NavAppItemStaticProps,\n} from './Nav.parts';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Properties for the NavCategory sub-component. */\nexport interface NavCategoryProps extends React.HTMLAttributes<HTMLLIElement> {\n  /**\n   * Value identifying this category (used by `openCategories`), unique among the categories of\n   * the Nav (a duplicate warns in development).\n   */\n  value: string;\n  /**\n   * Label of the category's toggle button (any content). Without it, the text children are used\n   * as the label — deprecated: pass the label here and only the sub-items as children.\n   */\n  label?: React.ReactNode;\n  /**\n   * Icon displayed before the category label. Rendered with `aria-hidden=\"true\"`. A falsy icon\n   * (`''`, `0`) or a list of nothing renders no icon box.\n   */\n  icon?: Slot<'span'>;\n  /**\n   * The category's sub-items (`Nav.SubItem`), and `Nav.SectionHeader` and `Nav.Divider`, rendered\n   * in its list while it is open.\n   */\n  children?: React.ReactNode;\n  /** Ref to the category's `<li>` element. */\n  ref?: React.Ref<HTMLLIElement>;\n}\n\n/**\n * The props of Nav.Item that every branch shares ({@link NavItemAnchorProps},\n * {@link NavItemButtonProps}, {@link NavItemDynamicProps}).\n */\nexport interface NavItemOwnProps {\n  /**\n   * Value identifying this nav item, unique among the items and sub-items of the Nav (a duplicate\n   * warns in development).\n   */\n  value: string;\n  /**\n   * Icon displayed before the item label. Rendered with `aria-hidden=\"true\"`. A falsy icon (`''`,\n   * `0`) or a list of nothing renders no icon box.\n   */\n  icon?: Slot<'span'>;\n  /**\n   * Whether the item is disabled: a native `disabled` button, or an `aria-disabled` link without\n   * `href`. Activating a disabled item never selects it; a disabled item whose value is the\n   * current `value` still shows as current (`aria-current=\"page\"` and the selected look), because\n   * the current value belongs to the app.\n   */\n  disabled?: boolean;\n  /** Label content. */\n  children?: React.ReactNode;\n  /**\n   * Controls beside the item in its row (Fluent's SplitNavItem): a ToggleButton that pins the\n   * page, a MenuButton with more commands, each with its own name (a Tooltip with\n   * `relationship=\"label\"` names an icon-only one). They render after the item's link or button,\n   * never inside it, in a group named by the item; each is a Tab stop after the item, and a click\n   * or key on one never selects the item. They are drawn while the row is hovered or has focus,\n   * while one of them is pressed or has its popup open, and always in forced colours and on touch\n   * screens; otherwise they are transparent and still focusable. They stay enabled when the item\n   * is `disabled`. With actions, the selected background and indicator are drawn on the row (the\n   * item's list item, `.wave-nav-item__list-item`), so a `className` on the item no longer covers\n   * them. Content that renders nothing renders no group. Fluent's `actionButton`, `toggleButton`\n   * and `menuButton` slots and their tooltips are your own controls here.\n   */\n  actions?: React.ReactNode;\n}\n\n/**\n * Nav.Item rendered as a link (`href` given): anchor attributes, and handlers typed on\n * `HTMLAnchorElement`. 0.4 typed every item's handlers on `HTMLButtonElement`, so with a string\n * `href` an unannotated 0.4 handler that reads a button-only member (such as\n * `e.currentTarget.form`) no longer compiles; a handler already typed as\n * `React.MouseEventHandler<HTMLButtonElement>` still does (React handler types are bivariant).\n */\nexport interface NavItemAnchorProps\n  extends\n    NavItemOwnProps,\n    Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof NavItemOwnProps> {\n  /**\n   * URL to navigate to; renders an `<a>`. Required in this branch, so `href` discriminates the\n   * union and handlers without `href` are typed as button handlers.\n   */\n  href: string;\n  /** Ref to the `<a>` element. */\n  ref?: React.Ref<HTMLAnchorElement>;\n}\n\n/** Nav.Item rendered as a button (no `href`): button attributes (a `rel` is not rendered). */\nexport interface NavItemButtonProps\n  extends\n    NavItemOwnProps,\n    NoAnchorOnlyAttributes,\n    Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof NavItemOwnProps> {\n  /** Button items have no `href`. */\n  href?: undefined;\n  /** Ref to the `<button>` element. */\n  ref?: React.Ref<HTMLButtonElement>;\n}\n\n/**\n * Properties for the NavItem sub-component: link props with `href`, button props without.\n *\n * A union type (0.4 had an interface): an interface cannot extend it, so extend one branch\n * (`interface X extends NavItemButtonProps`) or intersect (`type X = NavItemProps & { … }`).\n * `React.ComponentProps<typeof Nav.Item>` resolves to the last overload,\n * {@link NavItemDynamicProps}.\n */\nexport type NavItemProps = NavItemAnchorProps | NavItemButtonProps;\n\n/**\n * Nav.Item with an `href` known only at run time (`string | undefined`): a link when it is a\n * string, a button otherwise. Resolved after the button and link signatures.\n *\n * Only the attributes both elements share are accepted (no `target`, `download`, `type`, `form`,\n * …), and handlers receive events of either element (`HTMLAnchorElement | HTMLButtonElement`).\n * 0.4 typed them as button events (`HTMLAttributes<HTMLButtonElement>`), so an unannotated 0.4\n * handler that reads a button-only member (such as `e.currentTarget.form`) no longer compiles here;\n * narrow `e.currentTarget` first. (A string `href` types handlers on `HTMLAnchorElement`, see\n * {@link NavItemAnchorProps}; no `href` keeps `HTMLButtonElement`.)\n */\nexport interface NavItemDynamicProps\n  extends\n    NavItemOwnProps,\n    Omit<React.HTMLAttributes<HTMLAnchorElement | HTMLButtonElement>, keyof NavItemOwnProps> {\n  /** URL to navigate to; renders an `<a>` when defined, a `<button>` otherwise. */\n  href?: string;\n  /** Ref to the rendered `<a>` or `<button>` element. */\n  ref?: React.Ref<HTMLAnchorElement | HTMLButtonElement>;\n}\n\n/**\n * The props of Nav.SubItem that every branch shares: those of {@link NavItemOwnProps} without\n * `icon`.\n */\nexport type NavSubItemOwnProps = Omit<NavItemOwnProps, 'icon'>;\n\n/**\n * Nav.SubItem rendered as a link (`href` given): anchor attributes, and handlers typed on\n * `HTMLAnchorElement` (0.4: `HTMLButtonElement`); see {@link NavItemAnchorProps}.\n */\nexport interface NavSubItemAnchorProps\n  extends\n    NavSubItemOwnProps,\n    Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof NavSubItemOwnProps> {\n  /**\n   * URL to navigate to; renders an `<a>`. Required in this branch, so `href` discriminates the\n   * union and handlers without `href` are typed as button handlers.\n   */\n  href: string;\n  /** Ref to the `<a>` element. */\n  ref?: React.Ref<HTMLAnchorElement>;\n}\n\n/** Nav.SubItem rendered as a button (no `href`): button attributes (a `rel` is not rendered). */\nexport interface NavSubItemButtonProps\n  extends\n    NavSubItemOwnProps,\n    NoAnchorOnlyAttributes,\n    Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof NavSubItemOwnProps> {\n  /** Button sub-items have no `href`. */\n  href?: undefined;\n  /** Ref to the `<button>` element. */\n  ref?: React.Ref<HTMLButtonElement>;\n}\n\n/**\n * Properties for the NavSubItem sub-component: link props with `href`, button props without.\n * A union type like {@link NavItemProps} (extend a branch or intersect; `React.ComponentProps`\n * resolves to {@link NavSubItemDynamicProps}).\n */\nexport type NavSubItemProps = NavSubItemAnchorProps | NavSubItemButtonProps;\n\n/**\n * Nav.SubItem with an `href` known only at run time (`string | undefined`): a link when it is a\n * string, a button otherwise. Only the attributes both elements share are accepted, and handlers\n * receive events of either element (0.4 typed them as button events); see\n * {@link NavItemDynamicProps}.\n */\nexport interface NavSubItemDynamicProps\n  extends\n    NavSubItemOwnProps,\n    Omit<React.HTMLAttributes<HTMLAnchorElement | HTMLButtonElement>, keyof NavSubItemOwnProps> {\n  /** URL to navigate to; renders an `<a>` when defined, a `<button>` otherwise. */\n  href?: string;\n  /** Ref to the rendered `<a>` or `<button>` element. */\n  ref?: React.Ref<HTMLAnchorElement | HTMLButtonElement>;\n}\n\n/** The props both entry kinds share at runtime (the union narrowed by `href`). */\ntype NavEntryProps = NavItemOwnProps &\n  Omit<React.AllHTMLAttributes<HTMLElement>, keyof NavItemOwnProps | 'ref'> & {\n    ref?: React.Ref<HTMLElement>;\n  };\n\n// ---------------------------------------------------------------------------\n// Styles\n// ---------------------------------------------------------------------------\n\nconst iconClasses = 'flex h-5 w-5 shrink-0 items-center justify-center';\n\n/**\n * The `icon` slot of Nav.Item and Nav.Category, or `null` when it renders nothing. A falsy icon\n * (`icon={name && <Icon />}` with `name` '' or a count of 0) is no icon, as in 0.4 and as in\n * Avatar, and so is a collection whose items render nothing, so no empty 20px box is rendered\n * before the label. The check does not consume a generator: renderSlot still renders its items.\n */\nfunction renderIcon(\n  icon: Slot<'span'> | undefined,\n  className: string | undefined,\n): React.ReactElement | null {\n  return icon && slotRendersContent(icon)\n    ? renderSlot(icon, 'span', cn(className, iconClasses), { 'aria-hidden': true })\n    : null;\n}\n\nconst itemClasses = {\n  base: cn(\n    'flex w-full items-center gap-2 px-4 py-2 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none',\n    focusRingInset,\n    disabledStyles,\n  ),\n  selected: 'bg-subtle-selected text-primary font-semibold border-s-2 border-s-primary',\n  idle: 'text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover',\n  // With actions, the selected background and indicator move to the row (D121).\n  selectedInRow: 'text-primary font-semibold',\n  rowSelected: 'bg-subtle-selected border-s-2 border-s-primary',\n};\n\nconst subItemClasses = {\n  base: cn(\n    'flex w-full items-center ps-11 pe-4 py-1.5 text-body-1 text-start no-underline transition-colors motion-reduce:transition-none',\n    focusRingInset,\n    disabledStyles,\n  ),\n  selected: 'text-primary font-semibold',\n  idle: 'text-muted-foreground not-disabled:not-aria-disabled:hover:text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover',\n  // Sub-items have no selected background: a sub-item row gets only the hover.\n  selectedInRow: 'text-primary font-semibold',\n  rowSelected: undefined,\n};\n\n/** The classes an entry's link or button and its row share. */\ninterface NavEntryClasses {\n  base: string;\n  selected: string;\n  idle: string;\n  selectedInRow: string;\n  rowSelected: string | undefined;\n}\n\n/**\n * The row of an entry with actions (D121): the list item lays out the link or button and the\n * actions side by side and carries the selected look, or the hover of an enabled entry. A list\n * item cannot be disabled, so its hover needs no gate.\n */\nconst rowClasses =\n  'group/nav-row flex items-center transition-colors motion-reduce:transition-none';\nconst rowHoverClasses = 'hover:bg-subtle-hover';\n\n/**\n * The actions element (D120). Each direct child is transparent until the row is hovered or has\n * focus inside it, and is always drawn in forced colours and on devices without hover; a child\n * that is or holds a pressed toggle or an expanded trigger stays drawn (the first pair covers an\n * action wrapped in a Tooltip's span, the second a bare one). Opacity keeps every action\n * focusable, so Shift+Tab and a focus return reach it. No motion.\n */\nconst actionsClasses = cn(\n  'flex shrink-0 items-center gap-1 pe-2',\n  '*:opacity-0 group-hover/nav-row:*:opacity-100 group-focus-within/nav-row:*:opacity-100',\n  'forced-colors:*:opacity-100 [@media(hover:none)]:*:opacity-100',\n  '*:has-[[aria-pressed=true]]:opacity-100 *:has-[[aria-expanded=true]]:opacity-100',\n  '[&>[aria-pressed=true]]:opacity-100 [&>[aria-expanded=true]]:opacity-100',\n);\n\nconst categoryButtonClasses = cn(\n  'flex w-full items-center gap-2 px-4 py-2 text-body-1 font-semibold text-foreground not-disabled:not-aria-disabled:hover:bg-subtle-hover transition-colors motion-reduce:transition-none',\n  // A closed category that contains the current page shows the selected look of an item.\n  'data-[contains-current]:bg-subtle-selected data-[contains-current]:text-primary data-[contains-current]:border-s-2 data-[contains-current]:border-s-primary',\n  focusRingInset,\n);\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Whether a click on a link opens it somewhere other than the current page, checked as routers\n * do: a modifier key (a new tab or window, a download), a mouse button other than the main one, a\n * `target` other than `_self`, or a `download` link. Only when the default is not prevented does\n * the browser actually open it there.\n */\nfunction opensElsewhere(event: React.MouseEvent<HTMLElement>): boolean {\n  if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {\n    return true;\n  }\n  const link = event.currentTarget;\n  const target = link.getAttribute('target');\n  return (!!target && target.toLowerCase() !== '_self') || link.hasAttribute('download');\n}\n\n/** The stable classes of an entry, written literally by Nav.Item and Nav.SubItem. */\ninterface NavEntryClassNames {\n  root: string;\n  listItem: string;\n  actions: string;\n  icon?: string;\n  content?: string;\n}\n\n/**\n * Shared rendering of Nav.Item and Nav.SubItem (link or button). Inside an arrow-key body\n * (`roving` provided) the link or button also carries `data-roving-value={value}`, after the\n * consumer's attributes; in a plain Nav nothing is added. With `actions` that render content, the\n * list item becomes the row (D121) and holds the link or button, then the actions in a group named\n * by it through `generatedId` (unless the consumer gave an `id`), siblings, never nested (D119).\n */\nfunction renderNavEntry(\n  props: NavEntryProps,\n  context: NavContextValue,\n  roving: NavRovingContextValue | null,\n  classes: NavEntryClasses,\n  stable: NavEntryClassNames,\n  withIcon: boolean,\n  generatedId: string,\n): React.ReactElement {\n  const {\n    value,\n    icon,\n    disabled = false,\n    href,\n    className,\n    children,\n    onClick,\n    actions,\n    ref,\n    ...rest\n  } = props;\n  const isSelected = context.value === value;\n  const isLink = href !== undefined;\n  const rovingProps = roving ? { 'data-roving-value': value } : undefined;\n  // No empty group (`actions={cond && <Button />}` with `cond` false); the id is rendered only\n  // while the group points at it, so an item without actions keeps its 0.10 HTML.\n  const hasActions = slotRendersContent(actions);\n  const itemId = rest.id ?? generatedId;\n  const idProps = hasActions ? { id: itemId } : undefined;\n\n  const handleClick = (event: React.MouseEvent<HTMLElement>) => {\n    if (disabled) {\n      event.preventDefault();\n      return;\n    }\n    onClick?.(event);\n    // A link is still selected when the consumer prevents its default (client-side routing:\n    // `preventDefault()` + `router.push(href)`, whatever the modifier keys: the browser then opens\n    // nothing elsewhere), but not when the browser opens it elsewhere (the current page does not\n    // change); a button honours `preventDefault()` (C-COMPOSE).\n    if (isLink ? !event.defaultPrevented && opensElsewhere(event) : event.defaultPrevented) return;\n    context.select(value);\n  };\n\n  const content = (\n    <>\n      {withIcon && renderIcon(icon, stable.icon)}\n      {withIcon ? (\n        <span className={cn(stable.content, 'flex-1 text-start')}>{children}</span>\n      ) : (\n        children\n      )}\n    </>\n  );\n\n  const entryClassName = cn(\n    stable.root,\n    classes.base,\n    isSelected ? (hasActions ? classes.selectedInRow : classes.selected) : classes.idle,\n    hasActions && 'min-w-0 flex-1',\n    className,\n  );\n\n  const listItemClassName = hasActions\n    ? cn(\n        stable.listItem,\n        rowClasses,\n        isSelected && classes.rowSelected ? classes.rowSelected : !disabled && rowHoverClasses,\n      )\n    : stable.listItem;\n\n  const actionsGroup = hasActions ? (\n    <span\n      role=\"group\"\n      aria-labelledby={itemId}\n      data-wave-nav-actions=\"\"\n      className={cn(stable.actions, actionsClasses)}\n    >\n      {materialiseSlotContent(actions)}\n    </span>\n  ) : null;\n\n  if (isLink) {\n    return (\n      <li className={listItemClassName}>\n        <a\n          {...(rest as React.AnchorHTMLAttributes<HTMLAnchorElement>)}\n          {...idProps}\n          {...rovingProps}\n          ref={ref as React.Ref<HTMLAnchorElement>}\n          href={disabled ? undefined : href}\n          role={disabled ? 'link' : rest.role}\n          aria-disabled={disabled ? true : rest['aria-disabled']}\n          aria-current={isSelected ? 'page' : undefined}\n          onClick={handleClick}\n          className={entryClassName}\n        >\n          {content}\n        </a>\n        {actionsGroup}\n      </li>\n    );\n  }\n\n  // `rel` only belongs on a link: a button item drops it (React types it on every element).\n  const { rel, ...buttonRest } = rest;\n  return (\n    <li className={listItemClassName}>\n      <button\n        type=\"button\"\n        {...(buttonRest as React.ButtonHTMLAttributes<HTMLButtonElement>)}\n        {...idProps}\n        {...rovingProps}\n        ref={ref as React.Ref<HTMLButtonElement>}\n        disabled={disabled}\n        aria-current={isSelected ? 'page' : undefined}\n        onClick={handleClick}\n        className={entryClassName}\n      >\n        {content}\n      </button>\n      {actionsGroup}\n    </li>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Nav.Category\n// ---------------------------------------------------------------------------\n\n/**\n * A collapsible group of sub-items. Its toggle button shows `label` and reports `aria-expanded`\n * (and `aria-controls` while open); the sub-items render in a nested list while it is open.\n * Open state lives on `Nav` (`openCategories`/`defaultOpenCategories`).\n *\n * A closed category that contains the current item marks its toggle button with\n * `aria-current=\"true\"` (the button is not the page's link, so not `\"page\"`),\n * `data-contains-current` and the selected look of `Nav.Item`. It contains the current item when\n * a `Nav.SubItem` with the current value is among its children (through Fragments and wrapper\n * elements, also in the server HTML), when the current sub-item was last shown in it (and has not\n * moved among another category's children since), or when it is the Nav's `currentCategory`. An\n * open category is not marked: its sub-item shows the current page.\n *\n * Also exported as `NavCategory` (import the flat name from React Server Components).\n */\nconst NavCategory = ({\n  value,\n  label,\n  icon,\n  className,\n  children,\n  ref,\n  ...rest\n}: NavCategoryProps) => {\n  const context = useNavContext('Nav.Category');\n  const roving = React.useContext(NavRovingContext);\n  const {\n    value: currentValue,\n    openCategories,\n    toggleCategory,\n    currentCategory,\n    categoryStore,\n  } = context;\n  useNavValue(context, 'category', value);\n  const listId = useId('wave-nav-category');\n  const isOpen = openCategories.includes(value);\n\n  // The current sub-item is among the children of this closed category (also on the server).\n  const holdsCurrentChild = !isOpen && currentValue !== '' && containsValue(children, currentValue);\n  // The current sub-item was last shown in this category (none on the server).\n  const holdsShownCurrent = React.useSyncExternalStore(\n    categoryStore.subscribe,\n    () => currentValue !== '' && categoryStore.get(currentValue) === value,\n    () => false,\n  );\n  // Children that hold the current sub-item make this the category the Nav remembers for it, so a\n  // category it was shown in before it moved here is no longer marked. The entry is forgotten when\n  // they stop holding it (an open category records through its mounted sub-item instead).\n  React.useLayoutEffect(() => {\n    if (!holdsCurrentChild) return;\n    categoryStore.record(currentValue, value);\n    return () => categoryStore.forget(currentValue, value);\n  }, [categoryStore, holdsCurrentChild, currentValue, value]);\n  const containsCurrent =\n    !isOpen && (currentCategory === value || holdsShownCurrent || holdsCurrentChild);\n  // Inside an arrow-key body: whether this is a closed category that holds the current page (the\n  // body's first Tab stop), before paint; nothing is reported in a plain Nav.\n  React.useLayoutEffect(() => {\n    if (!roving) return;\n    roving.reportCurrentCategory(value, containsCurrent);\n    return () => roving.reportCurrentCategory(value, false);\n  }, [roving, value, containsCurrent]);\n  // Development only: every child of the open list is an <li> (`Nav.Category:list-child`).\n  const listRef = React.useRef<HTMLUListElement>(null);\n  useNavListChildCheck(listRef, 'Nav.Category', 'sub-items');\n\n  let buttonLabel: React.ReactNode = label;\n  let items: React.ReactNode = children;\n  if (label === undefined) {\n    // Deprecated 0.4 path: the text children are the label, the other children the sub-items.\n    warnDeprecated(\n      'Nav.Category',\n      'text children as the label',\n      'label',\n      'Pass the category label in `label` and only the sub-items as children.',\n    );\n    const parts = React.Children.toArray(children);\n    const isText = (part: unknown) => typeof part === 'string' || typeof part === 'number';\n    buttonLabel = parts.filter(isText).join('');\n    items = parts.filter((part) => !isText(part));\n  }\n\n  return (\n    <li ref={ref} {...rest} className={cn(navCategoryClassNames.root, className)}>\n      <button\n        type=\"button\"\n        aria-expanded={isOpen}\n        aria-controls={isOpen ? listId : undefined}\n        aria-current={containsCurrent ? true : undefined}\n        data-contains-current={containsCurrent ? '' : undefined}\n        data-roving-value={roving ? `wave-nav-category:${value}` : undefined}\n        onClick={() => toggleCategory(value)}\n        className={cn(navCategoryClassNames.button, categoryButtonClasses)}\n      >\n        {renderIcon(icon, navCategoryClassNames.icon)}\n        <span className={cn(navCategoryClassNames.label, 'flex-1 text-start')}>{buttonLabel}</span>\n        <ChevronDownIcon\n          className={cn(\n            navCategoryClassNames.expandIcon,\n            'shrink-0 transition-transform motion-reduce:transition-none',\n            isOpen && 'rotate-180',\n          )}\n        />\n      </button>\n      {isOpen && (\n        <NavCategoryValueContext.Provider value={value}>\n          <ul\n            ref={listRef}\n            id={listId}\n            className={cn(navCategoryClassNames.list, 'm-0 list-none p-0')}\n          >\n            {items}\n          </ul>\n        </NavCategoryValueContext.Provider>\n      )}\n    </li>\n  );\n};\nNavCategory.displayName = 'NavCategory';\nmarkNavPart(NavCategory, 'category');\n\n// ---------------------------------------------------------------------------\n// Nav.Item / Nav.SubItem\n// ---------------------------------------------------------------------------\n\n/**\n * A top-level navigation entry: a link when `href` is given (anchor props), a button otherwise\n * (button props). Clicking selects it (`aria-current=\"page\"`); activating a disabled entry never\n * selects it (a disabled entry whose value is the current value still shows as current).\n *\n * A click that opens a link somewhere other than the current page selects nothing (the consumer's\n * `onClick` still runs, and the browser opens the link): Ctrl/Cmd/Shift/Alt-click, a mouse button\n * other than the main one, a `target` other than `_self`, or a `download` link. When the consumer's\n * `onClick` calls `preventDefault()` (client-side routing), the browser opens nothing, so the item\n * is selected whatever the keys, button or `target`.\n *\n * `actions` puts your own controls (a pin toggle, a menu button) beside the item in its row, in a\n * group named by the item; they never select it.\n *\n * Typed by overloads, resolved in order: without `href` (button props, button events), with a\n * string `href` (anchor props, anchor events), then an `href` that may be `undefined` at run time\n * ({@link NavItemDynamicProps}: events of either element).\n *\n * Also exported as `NavItem` (import the flat name from React Server Components).\n */\nfunction NavItem(props: NavItemButtonProps): React.ReactElement;\nfunction NavItem(props: NavItemAnchorProps): React.ReactElement;\nfunction NavItem(props: NavItemDynamicProps): React.ReactElement;\nfunction NavItem(props: NavItemProps | NavItemDynamicProps): React.ReactElement {\n  const context = useNavContext('Nav.Item');\n  useNavValue(context, 'item', props.value);\n  useRecordCategory(context, props.value);\n  const roving = React.useContext(NavRovingContext);\n  // Called always, rendered only while the item's actions render (D119).\n  const generatedId = useId('wave-nav-item');\n  return renderNavEntry(\n    props as NavEntryProps,\n    context,\n    roving,\n    itemClasses,\n    {\n      root: navItemClassNames.root,\n      listItem: navItemClassNames.listItem,\n      actions: navItemClassNames.actions,\n      icon: navItemClassNames.icon,\n      content: navItemClassNames.content,\n    },\n    true,\n    generatedId,\n  );\n}\nNavItem.displayName = 'NavItem';\nmarkNavPart(NavItem, 'entry');\n\n/**\n * An indented entry inside a `Nav.Category`: a link when `href` is given, a button otherwise.\n * Selected like `Nav.Item` (a click that the browser opens somewhere else selects nothing; one\n * whose default your `onClick` prevents is selected), and typed by overloads like `Nav.Item`\n * (button, link, then {@link NavSubItemDynamicProps}). Takes `actions` like `Nav.Item`.\n *\n * Also exported as `NavSubItem` (import the flat name from React Server Components).\n */\nfunction NavSubItem(props: NavSubItemButtonProps): React.ReactElement;\nfunction NavSubItem(props: NavSubItemAnchorProps): React.ReactElement;\nfunction NavSubItem(props: NavSubItemDynamicProps): React.ReactElement;\nfunction NavSubItem(props: NavSubItemProps | NavSubItemDynamicProps): React.ReactElement {\n  const context = useNavContext('Nav.SubItem');\n  useNavValue(context, 'item', props.value);\n  useRecordCategory(context, props.value);\n  const roving = React.useContext(NavRovingContext);\n  // Called always, rendered only while the sub-item's actions render (D119).\n  const generatedId = useId('wave-nav-item');\n  return renderNavEntry(\n    props as NavEntryProps,\n    context,\n    roving,\n    subItemClasses,\n    {\n      root: navSubItemClassNames.root,\n      listItem: navSubItemClassNames.listItem,\n      actions: navSubItemClassNames.actions,\n    },\n    false,\n    generatedId,\n  );\n}\nNavSubItem.displayName = 'NavSubItem';\nmarkNavPart(NavSubItem, 'entry');\n\n/**\n * A vertical side navigation (`<nav>` landmark, default name \"Navigation\") with items, links and\n * collapsible categories.\n *\n * - **Selection**: `value`/`defaultValue`/`onValueChange` (`onValueChange` fires only when the\n *   value changes). The deprecated `selectedValue`/`defaultSelectedValue`/`onNavItemSelect` still\n *   work; `onNavItemSelect` keeps firing on every activation, re-selection included. A click that\n *   opens a link in another tab or window (or downloads it) selects nothing, unless the item's\n *   `onClick` prevents the default (client-side routing: then nothing opens elsewhere).\n * - **Categories**: `openCategories`/`defaultOpenCategories`/`onOpenCategoriesChange`. Without\n *   `defaultOpenCategories`, the categories containing the selected item (`value` or\n *   `defaultValue`) start open. A closed category that contains the selected item marks its toggle\n *   (`aria-current=\"true\"`, `data-contains-current`, the selected look); pass `currentCategory`\n *   for sub-items your own component renders inside a closed category.\n * - **Values** are unique: among the items and sub-items, and among the categories (a duplicate\n *   warns in development).\n * - **Structure**: every child of the Nav, and of a category, is a part or your own `<li>`; a\n *   development warning names anything else (a `<div>`, text, the wrapper of a Tooltip around an\n *   item). `Nav.SectionHeader` is a heading between groups of items (`<h3>` unless\n *   `headingLevel`, which stands for the `as` of Fluent's NavSectionHeader), and `Nav.Divider` a\n *   line between groups, hidden from assistive technology (Fluent's NavDivider is a separator).\n * - **App identity**: `Nav.AppItem` shows the app's name and logo at the top, as a link with\n *   `href` or a button; it is never selected. `Nav.AppItemStatic` shows them as plain text.\n * - **Item actions**: `actions` on `Nav.Item` and `Nav.SubItem` (Fluent's SplitNavItem) puts your\n *   own controls beside the item, in a group named by it; each is a Tab stop after the item, and\n *   none selects it. They are drawn while the row is hovered or has focus, while one is pressed or\n *   has its menu open, and always on touch screens and in forced colours. With actions, a selected\n *   item's background and indicator are drawn on its row (`.wave-nav-item__list-item`).\n *\n * Sub-components are also exported under flat names (`NavCategory`, `NavItem`, `NavSubItem`,\n * `NavSectionHeader`, `NavDivider`, `NavAppItem`, `NavAppItemStatic`): React Server Components\n * import those, because dotted access (`Nav.Item`) needs a client file.\n */\nexport const Nav = /* @__PURE__ */ Object.assign(NavRoot, {\n  Category: NavCategory,\n  Item: NavItem,\n  SubItem: NavSubItem,\n  SectionHeader: NavSectionHeader,\n  Divider: NavDivider,\n  AppItem: NavAppItem,\n  AppItemStatic: NavAppItemStatic,\n});\n\nexport {\n  NavCategory,\n  NavItem,\n  NavSubItem,\n  NavSectionHeader,\n  NavDivider,\n  NavAppItem,\n  NavAppItemStatic,\n};\n"],"mappings":"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"}

package/dist/components/navigation/Nav.context.cjs

@@ -0,0 +1,2 @@
+"use client";const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("../../lib/children.cjs"),n=require("../../lib/dev.cjs");let r=require("react");r=e.__toESM(r,1);function i(){let e=new Map,t=new Set,n=()=>t.forEach(e=>e());return{record(t,r){(e.get(t)??null)!==r&&(r===null?e.delete(t):e.set(t,r),n())},forget(t,r){e.get(t)===r&&(e.delete(t),n())},get:t=>e.get(t),subscribe(e){return t.add(e),()=>{t.delete(e)}}}}var a=r.createContext(null);a.displayName=`NavContext`;var o=()=>{},s={value:``,select:o,openCategories:[],toggleCategory:o,registerValue:()=>o,currentCategory:void 0,categoryStore:{record:o,forget:o,get:()=>void 0,subscribe:()=>o}},c=r.createContext(null);c.displayName=`NavCategoryValueContext`;function l(e){return r.useContext(a)||(n.reportMissingContext(e,`Nav`),s)}function u(e,t,n){let{registerValue:i}=e;r.useEffect(()=>i(t,n),[i,t,n])}function d(e,t){let n=r.useContext(c),{categoryStore:i}=e;r.useLayoutEffect(()=>{i.record(t,n)},[i,t,n])}var f=r.createContext(null);f.displayName=`NavRovingContext`;var p=Symbol.for(`wave.navPart`);function m(e,t){return e[p]=t,e}function h(e){let n=t.getElementType(e,{suspend:!1});if(typeof n!=`function`&&typeof n!=`object`||n===null)return null;let r=n[p];return r===`entry`||r===`category`?r:null}function g(e){let{children:t}=e.props;return typeof t==`function`?void 0:t}function _(e){return(typeof e==`object`||typeof e==`function`)&&e!==null&&typeof e.then==`function`}function v(e,t){if(Array.isArray(e)){for(let n of e)v(n,t);return}try{r.Children.forEach(e,e=>{r.isValidElement(e)&&t(e)})}catch(e){if(!_(e))throw e}}function y(e,t){let n=!1;return v(e,e=>{n||=h(e)===`entry`&&e.props.value===t||y(g(e),t)}),n}function b(e,t){let n=[];if(!t)return n;let r=e=>{v(e,e=>{let i=g(e);h(e)===`category`&&typeof e.props.value==`string`&&y(i,t)&&n.push(e.props.value),r(i)})};return r(e),n}var x={items:`Use the Nav parts (Nav.Item, Nav.Category, Nav.SectionHeader, Nav.Divider, Nav.AppItem, Nav.AppItemStatic) as its children, or wrap your own content in an <li>.`,"sub-items":`Use Nav.SubItem, Nav.SectionHeader and Nav.Divider as its children, or wrap your own content in an <li>.`},S=new Set([`li`,`script`,`template`]);function C(e){for(let t of Array.from(e.childNodes))if(t.nodeType===Node.ELEMENT_NODE){let e=t.localName.toLowerCase();if(!S.has(e))return`a <${e}> element`}else if(t.nodeType===Node.TEXT_NODE&&(t.textContent??``).trim()!==``)return`text`;return null}function w(e,t,i){r.useEffect(()=>{if(!n.isDev)return;let r=`${t}:list-child`,a=e.current;if(!a||n.hasWarned(r))return;let o=C(a);o!==null&&n.warnOnce(r,`${t}: its list holds ${o}, but a list can hold only <li> elements. ${x[i]}`)})}exports.NavCategoryValueContext=c,exports.NavContext=a,exports.NavRovingContext=f,exports.containsValue=y,exports.createCategoryStore=i,exports.findCategoriesContaining=b,exports.getNavPartKind=h,exports.markNavPart=m,exports.useNavContext=l,exports.useNavListChildCheck=w,exports.useNavValue=u,exports.useRecordCategory=d;
+//# sourceMappingURL=Nav.context.cjs.map

package/dist/components/navigation/Nav.context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nav.context.cjs","names":["React","getElementType","isDev","hasWarned","require_runtime","require_children","require_dev","react","createCategoryStore","categories","listeners","notify","listener","value","category","NavContext","noop","INERT_NAV_CONTEXT","NavCategoryValueContext","useNavContext","componentName","useNavValue","context","registerValue","kind","useRecordCategory","categoryStore","NavRovingContext","NAV_PART","markNavPart","component","getNavPartKind","type","node","childrenOf","element","children","isThenable","forEachElement","nodes","visit","child","error","containsValue","found","selected","findCategoriesContaining","result","current","inner","LIST_CHILD_ADVICE","ALLOWED_LIST_CHILDREN","describeInvalidListChild","list","tag","useNavListChildCheck","key","owner","invalid","contents"],"sources":["../../../src/components/navigation/Nav.context.ts"],"sourcesContent":["import * as React from 'react';\nimport { getElementType } from '../../lib/children';\nimport { hasWarned, isDev, reportMissingContext, warnOnce } from '../../lib/dev';\n\n/*\n * The contexts of a Nav root (Nav, NavDrawer) and its parts: the root's state (`NavContext`), the\n * category a sub-item renders in and the roving bookkeeping of an arrow-key body; the category\n * store; the part markers and the children walks that find the current page; the development check\n * of a Nav list's children; and the link-only attributes mask of the button items. Internal; it\n * imports no component, so a root reaches the parts through their markers, never through an import.\n */\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\n/** The two value namespaces of a Nav: items (Nav.Item and Nav.SubItem) and categories. */\nexport type NavValueKind = 'item' | 'category';\n\n/**\n * The category each sub-item was last shown in, by sub-item value: written from layout effects by\n * the mounted sub-items and by a closed category whose children hold the current value, read by\n * the categories with `useSyncExternalStore`. An entry outlives its sub-item, so a category closed\n * after its current sub-item was shown still knows it contains the current page.\n */\nexport interface NavCategoryStore {\n  /**\n   * Records the category a mounted item renders in, or a closed category whose children hold the\n   * value; `null` (an item outside any category) forgets an earlier entry, so a value moved out of\n   * a category no longer marks it.\n   */\n  record(value: string, category: string | null): void;\n  /** Forgets the entry of `value` while it is still `category`. */\n  forget(value: string, category: string): void;\n  /** The category last recorded for a sub-item value. */\n  get(value: string): string | undefined;\n  /** Subscribes to every change of an entry; returns the unsubscribe function. */\n  subscribe(listener: () => void): () => void;\n}\n\n/** A new, empty category store (one per Nav root, created once). */\nexport function createCategoryStore(): NavCategoryStore {\n  const categories = new Map<string, string>();\n  const listeners = new Set<() => void>();\n  const notify = () => listeners.forEach((listener) => listener());\n  return {\n    record(value, category) {\n      if ((categories.get(value) ?? null) === category) return;\n      if (category === null) categories.delete(value);\n      else categories.set(value, category);\n      notify();\n    },\n    forget(value, category) {\n      if (categories.get(value) !== category) return;\n      categories.delete(value);\n      notify();\n    },\n    get: (value) => categories.get(value),\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\n/** The context a Nav root (Nav, NavDrawer) provides to its parts (0.10's fields, unchanged). */\nexport interface NavContextValue {\n  /** The selected item value (`''` when nothing is selected). */\n  value: string;\n  /**\n   * Activation of an item: sets the value, then calls the root's `onActivate` (every activation,\n   * re-selection included; Nav's deprecated `onNavItemSelect`).\n   */\n  select: (value: string) => void;\n  /** The values of the open categories. */\n  openCategories: readonly string[];\n  /** Opens a closed category, closes an open one. */\n  toggleCategory: (value: string) => void;\n  /** Registers a mounted item or category value (duplicate warning); returns the cleanup. */\n  registerValue: (kind: NavValueKind, value: string) => () => void;\n  /** The `currentCategory` hint of the root. */\n  currentCategory: string | undefined;\n  /** The categories the sub-items were last shown in. */\n  categoryStore: NavCategoryStore;\n}\n\n/** The state of the Nav root around a part (`null` outside one). */\nexport const NavContext = React.createContext<NavContextValue | null>(null);\nNavContext.displayName = 'NavContext';\n\nconst noop = () => {};\nconst INERT_NAV_CONTEXT: NavContextValue = {\n  value: '',\n  select: noop,\n  openCategories: [],\n  toggleCategory: noop,\n  registerValue: () => noop,\n  currentCategory: undefined,\n  categoryStore: { record: noop, forget: noop, get: () => undefined, subscribe: () => noop },\n};\n\n/**\n * The value of the Nav.Category a sub-item renders in (`null` outside a category). It renders no\n * element; a sub-item outside a category is valid, so there is no missing-context error.\n */\nexport const NavCategoryValueContext = React.createContext<string | null>(null);\nNavCategoryValueContext.displayName = 'NavCategoryValueContext';\n\n/**\n * The Nav root's context for the part `componentName` (C-CONTEXT): outside a Nav it throws\n * `[WaveUI] <componentName> must be used within Nav` in development, and in production logs once\n * and returns an inert value.\n */\nexport function useNavContext(componentName: string): NavContextValue {\n  const context = React.useContext(NavContext);\n  if (context) return context;\n  reportMissingContext(componentName, 'Nav');\n  return INERT_NAV_CONTEXT;\n}\n\n/** Registers the value of a mounted item or category, so the root can warn about duplicates. */\nexport function useNavValue(context: NavContextValue, kind: NavValueKind, value: string): void {\n  const { registerValue } = context;\n  React.useEffect(() => registerValue(kind, value), [registerValue, kind, value]);\n}\n\n/**\n * Records the category a mounted item renders in, which the category reads once closed (`null`\n * outside a category, which forgets a stale entry for the value).\n */\nexport function useRecordCategory(context: NavContextValue, value: string): void {\n  const category = React.useContext(NavCategoryValueContext);\n  const { categoryStore } = context;\n  React.useLayoutEffect(() => {\n    categoryStore.record(value, category);\n  }, [categoryStore, value, category]);\n}\n\n// ---------------------------------------------------------------------------\n// Roving bookkeeping (an arrow-key body)\n// ---------------------------------------------------------------------------\n\n/** What an arrow-key body (NavDrawer.Body `focusMode=\"arrow\"`) gives the Nav parts inside it. */\nexport interface NavRovingContextValue {\n  /**\n   * Called by every Nav.Category from a layout effect keyed on `[context, value, containsCurrent]`:\n   * `(value, true)` while it is a closed category that holds the current page, `(value, false)`\n   * when it stops being one and in the effect's cleanup (an unmount, StrictMode's double mount).\n   * Must be stable (memoised by the provider).\n   */\n  reportCurrentCategory: (category: string, holdsCurrent: boolean) => void;\n}\n\n/**\n * Provided (non-null) inside an arrow-key body: every Nav.Item and Nav.SubItem renders\n * `data-roving-value={value}` on its link or button (after the consumer's attributes: the\n * bookkeeping wins), and every category toggle `data-roving-value={'wave-nav-category:' + value}`\n * (stable, also while open), and reports as {@link NavRovingContextValue} says. `null` (the\n * default, every plain Nav): nothing is rendered or reported, so a Nav's server HTML is 0.10's.\n */\nexport const NavRovingContext = React.createContext<NavRovingContextValue | null>(null);\nNavRovingContext.displayName = 'NavRovingContext';\n\n// ---------------------------------------------------------------------------\n// Part markers and the children walks\n// ---------------------------------------------------------------------------\n\n/** What a marked Nav part is to the walks: an entry (Nav.Item, Nav.SubItem) or a category. */\nexport type NavPartKind = 'entry' | 'category';\n\n/**\n * The marker property of a Nav part, read only by {@link getNavPartKind}. A registry symbol\n * (`Symbol.for`), as Field's label marker (`fieldLabel.ts`): the ESM and CJS copies of the package\n * share it, so a part marked by one copy is recognised by the other.\n */\nconst NAV_PART: symbol = Symbol.for('wave.navPart');\n\n/**\n * Marks `component` as a Nav part of `kind`, so the walks of a Nav root recognise its elements\n * without importing it; call it next to `displayName`. Returns `component`.\n */\nexport function markNavPart<T extends object>(component: T, kind: NavPartKind): T {\n  (component as Record<symbol, unknown>)[NAV_PART] = kind;\n  return component;\n}\n\n/**\n * The kind of Nav part `node` is an element of, or `null` for anything else. The type is resolved\n * with `getElementType(node, { suspend: false })`: a lazy client reference (a part written in a\n * Server Component) is recognised, and a lazy type still loading is no part (it never suspends).\n */\nexport function getNavPartKind(node: React.ReactNode): NavPartKind | null {\n  const type = getElementType(node, { suspend: false });\n  if ((typeof type !== 'function' && typeof type !== 'object') || type === null) return null;\n  const kind = (type as Record<symbol, unknown>)[NAV_PART];\n  return kind === 'entry' || kind === 'category' ? kind : null;\n}\n\ntype ElementWithChildren = React.ReactElement<{ value?: unknown; children?: React.ReactNode }>;\n\nfunction childrenOf(element: ElementWithChildren): React.ReactNode {\n  const { children } = element.props;\n  return typeof children === 'function' ? undefined : children;\n}\n\n/** Whether a thrown value suspends rendering (a loading lazy chunk, a pending promise). */\nfunction isThenable(value: unknown): boolean {\n  return (\n    (typeof value === 'object' || typeof value === 'function') &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\n/*\n * The walks below run during the render of a Nav root and of a category, and reach consumer\n * content at any depth. Content that is still loading inside the consumer's own <Suspense> (a\n * promise child, a lazy node, a `React.lazy` component) suspends that boundary when React renders\n * it; walking it must never suspend the Nav itself, which would hide the whole Nav behind an outer\n * boundary. So a child that cannot be read yet is skipped, and a lazy type that is still loading is\n * not a part (its children are still walked). Parts written in a Server Component arrive as loaded\n * client references and are recognized.\n */\n\n/** Calls `visit` with each element of `nodes` (as `React.Children.forEach`), skipping pending ones. */\nfunction forEachElement(nodes: React.ReactNode, visit: (child: ElementWithChildren) => void): void {\n  if (Array.isArray(nodes)) {\n    for (const node of nodes as React.ReactNode[]) forEachElement(node, visit);\n    return;\n  }\n  try {\n    React.Children.forEach(nodes, (child) => {\n      if (React.isValidElement<ElementWithChildren['props']>(child)) visit(child);\n    });\n  } catch (error) {\n    if (!isThenable(error)) throw error;\n  }\n}\n\n/**\n * Whether `nodes` contain a Nav.Item/Nav.SubItem element with `value === selected` (parts written\n * in a Server Component, lazy client references, included). Called during render only; never\n * suspends.\n */\nexport function containsValue(nodes: React.ReactNode, selected: string): boolean {\n  let found = false;\n  forEachElement(nodes, (child) => {\n    if (found) return;\n    if (getNavPartKind(child) === 'entry' && child.props.value === selected) {\n      found = true;\n    } else {\n      found = containsValue(childrenOf(child), selected);\n    }\n  });\n  return found;\n}\n\n/** The values of the Nav.Category elements (at any depth of JSX) that contain `selected`. */\nexport function findCategoriesContaining(nodes: React.ReactNode, selected: string): string[] {\n  const result: string[] = [];\n  if (!selected) return result;\n  const visit = (current: React.ReactNode) => {\n    forEachElement(current, (child) => {\n      const inner = childrenOf(child);\n      if (\n        getNavPartKind(child) === 'category' &&\n        typeof child.props.value === 'string' &&\n        containsValue(inner, selected)\n      ) {\n        result.push(child.props.value);\n      }\n      visit(inner);\n    });\n  };\n  visit(nodes);\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// The list-child check\n// ---------------------------------------------------------------------------\n\n/** The advice of the list-child warning, by what the list holds. */\nconst LIST_CHILD_ADVICE = {\n  items:\n    'Use the Nav parts (Nav.Item, Nav.Category, Nav.SectionHeader, Nav.Divider, Nav.AppItem, Nav.AppItemStatic) as its children, or wrap your own content in an <li>.',\n  'sub-items':\n    'Use Nav.SubItem, Nav.SectionHeader and Nav.Divider as its children, or wrap your own content in an <li>.',\n} as const;\n\n/** Element children a list may hold besides `<li>`: script-supporting elements (React's streaming placeholders). */\nconst ALLOWED_LIST_CHILDREN = new Set(['li', 'script', 'template']);\n\n/**\n * What the first child node of `list` that a list cannot hold is (`a <div> element`, `text`), or\n * `null` when every child is an `<li>`, a script-supporting element, whitespace text or a comment.\n */\nfunction describeInvalidListChild(list: HTMLElement): string | null {\n  for (const node of Array.from(list.childNodes)) {\n    if (node.nodeType === Node.ELEMENT_NODE) {\n      const tag = (node as Element).localName.toLowerCase();\n      if (!ALLOWED_LIST_CHILDREN.has(tag)) return `a <${tag}> element`;\n    } else if (node.nodeType === Node.TEXT_NODE && (node.textContent ?? '').trim() !== '') {\n      return 'text';\n    }\n  }\n  return null;\n}\n\n/**\n * Development only: after every commit of the calling component, warns once per `owner`\n * (`${owner}:list-child`) at the first child node of `list` that is neither an `<li>`, `<script>`\n * nor `<template>` element nor whitespace text (comments, and the nothing that `null`, Fragments\n * and Suspense boundaries render, never warn). `contents` picks the advice: `'items'` the Nav\n * parts, `'sub-items'` Nav.SubItem, Nav.SectionHeader and Nav.Divider.\n */\nexport function useNavListChildCheck(\n  list: React.RefObject<HTMLUListElement | null>,\n  owner: string,\n  contents: 'items' | 'sub-items',\n): void {\n  React.useEffect(() => {\n    if (!isDev) return;\n    const key = `${owner}:list-child`;\n    const element = list.current;\n    if (!element || hasWarned(key)) return;\n    const invalid = describeInvalidListChild(element);\n    if (invalid === null) return;\n    warnOnce(\n      key,\n      `${owner}: its list holds ${invalid}, but a list can hold only <li> elements. ${LIST_CHILD_ADVICE[contents]}`,\n    );\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * The attributes only a link has (`target`, `download`, `hrefLang`, `ping`, …). Button items\n * declare them as `undefined`, so they are a type error without `href` instead of landing on the\n * `<button>`. `rel` cannot be listed (React types it on every element, RDFa); a button item drops\n * it at run time instead.\n */\nexport type NoAnchorOnlyAttributes = {\n  [\n    K in Exclude<\n      keyof React.AnchorHTMLAttributes<HTMLAnchorElement>,\n      keyof React.ButtonHTMLAttributes<HTMLButtonElement>\n    >\n  ]?: undefined;\n};\n"],"mappings":"gLAyCA,SAAgBQ,GAAwC,CACtD,IAAMC,EAAa,IAAI,IACjBC,EAAY,IAAI,IAChBC,MAAeD,EAAU,QAAS,GAAaE,EAAS,CAAC,EAC/D,MAAO,CACL,OAAO,EAAO,EAAU,EACjBH,EAAW,IAAII,CAAK,GAAK,QAAUC,IACpCA,IAAa,KAAML,EAAW,OAAOI,CAAK,EACzCJ,EAAW,IAAII,EAAOC,CAAQ,EACnCH,EAAO,EACT,EACA,OAAO,EAAO,EAAU,CAClBF,EAAW,IAAII,CAAK,IAAMC,IAC9BL,EAAW,OAAOI,CAAK,EACvBF,EAAO,EACT,EACA,IAAM,GAAUF,EAAW,IAAII,CAAK,EACpC,UAAU,EAAU,CAElB,OADAH,EAAU,IAAIE,CAAQ,MACT,CACXF,EAAU,OAAOE,CAAQ,CAC3B,CACF,CACF,CACF,CAwBA,IAAaG,EAAaf,EAAM,cAAsC,IAAI,EAC1E,EAAW,YAAc,aAEzB,IAAMgB,MAAa,CAAC,EACdC,EAAqC,CACzC,MAAO,GACP,OAAQD,EACR,eAAgB,CAAC,EACjB,eAAgBA,EAChB,kBAAqBA,EACrB,gBAAiB,IAAA,GACjB,cAAe,CAAE,OAAQA,EAAM,OAAQA,EAAM,QAAW,IAAA,GAAW,cAAiBA,CAAK,CAC3F,EAMaE,EAA0BlB,EAAM,cAA6B,IAAI,EAC9E,EAAwB,YAAc,0BAOtC,SAAgBmB,EAAc,EAAwC,CAIpE,OAHgBnB,EAAM,WAAWe,CAC7B,IACJT,EAAA,qBAAqBc,EAAe,KAAK,EAClCH,EACT,CAGA,SAAgBI,EAAY,EAA0B,EAAoB,EAAqB,CAC7F,GAAM,CAAE,iBAAkBC,EAC1Bf,EAAM,cAAgBgB,EAAcC,EAAMX,CAAK,EAAG,CAACU,EAAeC,EAAMX,CAAK,CAAC,CAChF,CAMA,SAAgBY,EAAkB,EAA0B,EAAqB,CAC/E,IAAMX,EAAWd,EAAM,WAAWkB,CAAuB,EACnD,CAAE,iBAAkBI,EAC1Bf,EAAM,oBAAsB,CAC1BmB,EAAc,OAAOb,EAAOC,CAAQ,CACtC,EAAG,CAACY,EAAeb,EAAOC,CAAQ,CAAC,CACrC,CAwBA,IAAaa,EAAmB3B,EAAM,cAA4C,IAAI,EACtF,EAAiB,YAAc,mBAc/B,IAAM4B,EAAmB,OAAO,IAAI,cAAc,EAMlD,SAAgBC,EAA8B,EAAc,EAAsB,CAEhF,MADA,GAAuCD,GAAYJ,EAC5CM,CACT,CAOA,SAAgBC,EAAe,EAA2C,CACxE,IAAMC,EAAO/B,EAAAA,eAAegC,EAAM,CAAE,QAAS,EAAM,CAAC,EACpD,GAAK,OAAOD,GAAS,YAAc,OAAOA,GAAS,UAAaA,IAAS,KAAM,OAAO,KACtF,IAAMR,EAAQQ,EAAiCJ,GAC/C,OAAOJ,IAAS,SAAWA,IAAS,WAAaA,EAAO,IAC1D,CAIA,SAASU,EAAW,EAA+C,CACjE,GAAM,CAAE,YAAaC,EAAQ,MAC7B,OAAO,OAAOC,GAAa,WAAa,IAAA,GAAYA,CACtD,CAGA,SAASC,EAAW,EAAyB,CAC3C,OACG,OAAOxB,GAAU,UAAY,OAAOA,GAAU,aAC/CA,IAAU,MACV,OAAQA,EAA6B,MAAS,UAElD,CAaA,SAASyB,EAAe,EAAwB,EAAmD,CACjG,GAAI,MAAM,QAAQC,CAAK,EAAG,CACxB,IAAK,IAAMN,KAAQM,EAA4BD,EAAeL,EAAMO,CAAK,EACzE,MACF,CACA,GAAI,CACFjC,EAAM,SAAS,QAAQgC,EAAQ,GAAU,CACnCvC,EAAM,eAA6CyC,CAAK,GAAGD,EAAMC,CAAK,CAC5E,CAAC,CACH,OAASC,EAAO,CACd,GAAI,CAACL,EAAWK,CAAK,EAAG,MAAMA,CAChC,CACF,CAOA,SAAgBC,EAAc,EAAwB,EAA2B,CAC/E,IAAIC,EAAQ,GASZ,OARAN,EAAeC,EAAQ,GAAU,CAC/B,AAIEK,IAHEb,EAAeU,CAAK,IAAM,SAAWA,EAAM,MAAM,QAAUI,GAGrDF,EAAcT,EAAWO,CAAK,EAAGI,CAAQ,CAErD,CAAC,EACMD,CACT,CAGA,SAAgBE,EAAyB,EAAwB,EAA4B,CAC3F,IAAMC,EAAmB,CAAC,EAC1B,GAAI,CAACF,EAAU,OAAOE,EACtB,IAAMP,EAAS,GAA6B,CAC1CF,EAAeU,EAAU,GAAU,CACjC,IAAMC,EAAQf,EAAWO,CAAK,EAE5BV,EAAeU,CAAK,IAAM,YAC1B,OAAOA,EAAM,MAAM,OAAU,UAC7BE,EAAcM,EAAOJ,CAAQ,GAE7BE,EAAO,KAAKN,EAAM,MAAM,KAAK,EAE/BD,EAAMS,CAAK,CACb,CAAC,CACH,EAEA,OADAT,EAAMD,CAAK,EACJQ,CACT,CAOA,IAAMG,EAAoB,CACxB,MACE,mKACF,YACE,0GACJ,EAGMC,EAAwB,IAAI,IAAI,CAAC,KAAM,SAAU,UAAU,CAAC,EAMlE,SAASC,EAAyB,EAAkC,CAClE,IAAK,IAAMnB,KAAQ,MAAM,KAAKoB,EAAK,UAAU,EAC3C,GAAIpB,EAAK,WAAa,KAAK,aAAc,CACvC,IAAMqB,EAAOrB,EAAiB,UAAU,YAAY,EACpD,GAAI,CAACkB,EAAsB,IAAIG,CAAG,EAAG,MAAO,MAAMA,EAAI,UACxD,MAAO,GAAIrB,EAAK,WAAa,KAAK,YAAcA,EAAK,aAAe,GAAA,CAAI,KAAK,IAAM,GACjF,MAAO,OAGX,OAAO,IACT,CASA,SAAgBsB,EACd,EACA,EACA,EACM,CACNhD,EAAM,cAAgB,CACpB,GAAI,CAACL,EAAAA,MAAO,OACZ,IAAMsD,EAAM,GAAGC,EAAM,aACftB,EAAUkB,EAAK,QACrB,GAAI,CAAClB,GAAWhC,EAAAA,UAAUqD,CAAG,EAAG,OAChC,IAAME,EAAUN,EAAyBjB,CAAO,EAC5CuB,IAAY,MAChBpD,EAAA,SACEkD,EACA,GAAGC,EAAM,mBAAmBC,EAAQ,4CAA4CR,EAAkBS,IACpG,CACF,CAAC,CACH"}

package/dist/components/navigation/Nav.context.mjs

@@ -0,0 +1,137 @@
+"use client";
+import { getElementType as e } from "../../lib/children.mjs";
+import { hasWarned as t, isDev as n, reportMissingContext as r, warnOnce as i } from "../../lib/dev.mjs";
+import * as a from "react";
+//#region src/components/navigation/Nav.context.ts
+function o() {
+	let e = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Set(), n = () => t.forEach((e) => e());
+	return {
+		record(t, r) {
+			(e.get(t) ?? null) !== r && (r === null ? e.delete(t) : e.set(t, r), n());
+		},
+		forget(t, r) {
+			e.get(t) === r && (e.delete(t), n());
+		},
+		get: (t) => e.get(t),
+		subscribe(e) {
+			return t.add(e), () => {
+				t.delete(e);
+			};
+		}
+	};
+}
+var s = a.createContext(null);
+s.displayName = "NavContext";
+var c = () => {}, l = {
+	value: "",
+	select: c,
+	openCategories: [],
+	toggleCategory: c,
+	registerValue: () => c,
+	currentCategory: void 0,
+	categoryStore: {
+		record: c,
+		forget: c,
+		get: () => void 0,
+		subscribe: () => c
+	}
+}, u = a.createContext(null);
+u.displayName = "NavCategoryValueContext";
+function d(e) {
+	return a.useContext(s) || (r(e, "Nav"), l);
+}
+function f(e, t, n) {
+	let { registerValue: r } = e;
+	a.useEffect(() => r(t, n), [
+		r,
+		t,
+		n
+	]);
+}
+function p(e, t) {
+	let n = a.useContext(u), { categoryStore: r } = e;
+	a.useLayoutEffect(() => {
+		r.record(t, n);
+	}, [
+		r,
+		t,
+		n
+	]);
+}
+var m = a.createContext(null);
+m.displayName = "NavRovingContext";
+var h = Symbol.for("wave.navPart");
+function g(e, t) {
+	return e[h] = t, e;
+}
+function _(t) {
+	let n = e(t, { suspend: !1 });
+	if (typeof n != "function" && typeof n != "object" || n === null) return null;
+	let r = n[h];
+	return r === "entry" || r === "category" ? r : null;
+}
+function v(e) {
+	let { children: t } = e.props;
+	return typeof t == "function" ? void 0 : t;
+}
+function y(e) {
+	return (typeof e == "object" || typeof e == "function") && e !== null && typeof e.then == "function";
+}
+function b(e, t) {
+	if (Array.isArray(e)) {
+		for (let n of e) b(n, t);
+		return;
+	}
+	try {
+		a.Children.forEach(e, (e) => {
+			a.isValidElement(e) && t(e);
+		});
+	} catch (e) {
+		if (!y(e)) throw e;
+	}
+}
+function x(e, t) {
+	let n = !1;
+	return b(e, (e) => {
+		n ||= _(e) === "entry" && e.props.value === t || x(v(e), t);
+	}), n;
+}
+function S(e, t) {
+	let n = [];
+	if (!t) return n;
+	let r = (e) => {
+		b(e, (e) => {
+			let i = v(e);
+			_(e) === "category" && typeof e.props.value == "string" && x(i, t) && n.push(e.props.value), r(i);
+		});
+	};
+	return r(e), n;
+}
+var C = {
+	items: "Use the Nav parts (Nav.Item, Nav.Category, Nav.SectionHeader, Nav.Divider, Nav.AppItem, Nav.AppItemStatic) as its children, or wrap your own content in an <li>.",
+	"sub-items": "Use Nav.SubItem, Nav.SectionHeader and Nav.Divider as its children, or wrap your own content in an <li>."
+}, w = /* @__PURE__ */ new Set([
+	"li",
+	"script",
+	"template"
+]);
+function T(e) {
+	for (let t of Array.from(e.childNodes)) if (t.nodeType === Node.ELEMENT_NODE) {
+		let e = t.localName.toLowerCase();
+		if (!w.has(e)) return `a <${e}> element`;
+	} else if (t.nodeType === Node.TEXT_NODE && (t.textContent ?? "").trim() !== "") return "text";
+	return null;
+}
+function E(e, r, o) {
+	a.useEffect(() => {
+		if (!n) return;
+		let a = `${r}:list-child`, s = e.current;
+		if (!s || t(a)) return;
+		let c = T(s);
+		c !== null && i(a, `${r}: its list holds ${c}, but a list can hold only <li> elements. ${C[o]}`);
+	});
+}
+//#endregion
+export { u as NavCategoryValueContext, s as NavContext, m as NavRovingContext, x as containsValue, o as createCategoryStore, S as findCategoriesContaining, _ as getNavPartKind, g as markNavPart, d as useNavContext, E as useNavListChildCheck, f as useNavValue, p as useRecordCategory };
+
+//# sourceMappingURL=Nav.context.mjs.map

package/dist/components/navigation/Nav.context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nav.context.mjs","names":["React","createCategoryStore","categories","listeners","notify","listener","value","category","NavContext","noop","INERT_NAV_CONTEXT","NavCategoryValueContext","useNavContext","reportMissingContext","componentName","useNavValue","context","registerValue","kind","useRecordCategory","categoryStore","NavRovingContext","NAV_PART","markNavPart","component","getNavPartKind","type","getElementType","node","childrenOf","element","children","isThenable","forEachElement","nodes","visit","child","error","containsValue","found","selected","findCategoriesContaining","result","current","inner","LIST_CHILD_ADVICE","ALLOWED_LIST_CHILDREN","describeInvalidListChild","list","tag","useNavListChildCheck","isDev","key","owner","hasWarned","invalid","warnOnce","contents"],"sources":["../../../src/components/navigation/Nav.context.ts"],"sourcesContent":["import * as React from 'react';\nimport { getElementType } from '../../lib/children';\nimport { hasWarned, isDev, reportMissingContext, warnOnce } from '../../lib/dev';\n\n/*\n * The contexts of a Nav root (Nav, NavDrawer) and its parts: the root's state (`NavContext`), the\n * category a sub-item renders in and the roving bookkeeping of an arrow-key body; the category\n * store; the part markers and the children walks that find the current page; the development check\n * of a Nav list's children; and the link-only attributes mask of the button items. Internal; it\n * imports no component, so a root reaches the parts through their markers, never through an import.\n */\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\n/** The two value namespaces of a Nav: items (Nav.Item and Nav.SubItem) and categories. */\nexport type NavValueKind = 'item' | 'category';\n\n/**\n * The category each sub-item was last shown in, by sub-item value: written from layout effects by\n * the mounted sub-items and by a closed category whose children hold the current value, read by\n * the categories with `useSyncExternalStore`. An entry outlives its sub-item, so a category closed\n * after its current sub-item was shown still knows it contains the current page.\n */\nexport interface NavCategoryStore {\n  /**\n   * Records the category a mounted item renders in, or a closed category whose children hold the\n   * value; `null` (an item outside any category) forgets an earlier entry, so a value moved out of\n   * a category no longer marks it.\n   */\n  record(value: string, category: string | null): void;\n  /** Forgets the entry of `value` while it is still `category`. */\n  forget(value: string, category: string): void;\n  /** The category last recorded for a sub-item value. */\n  get(value: string): string | undefined;\n  /** Subscribes to every change of an entry; returns the unsubscribe function. */\n  subscribe(listener: () => void): () => void;\n}\n\n/** A new, empty category store (one per Nav root, created once). */\nexport function createCategoryStore(): NavCategoryStore {\n  const categories = new Map<string, string>();\n  const listeners = new Set<() => void>();\n  const notify = () => listeners.forEach((listener) => listener());\n  return {\n    record(value, category) {\n      if ((categories.get(value) ?? null) === category) return;\n      if (category === null) categories.delete(value);\n      else categories.set(value, category);\n      notify();\n    },\n    forget(value, category) {\n      if (categories.get(value) !== category) return;\n      categories.delete(value);\n      notify();\n    },\n    get: (value) => categories.get(value),\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\n/** The context a Nav root (Nav, NavDrawer) provides to its parts (0.10's fields, unchanged). */\nexport interface NavContextValue {\n  /** The selected item value (`''` when nothing is selected). */\n  value: string;\n  /**\n   * Activation of an item: sets the value, then calls the root's `onActivate` (every activation,\n   * re-selection included; Nav's deprecated `onNavItemSelect`).\n   */\n  select: (value: string) => void;\n  /** The values of the open categories. */\n  openCategories: readonly string[];\n  /** Opens a closed category, closes an open one. */\n  toggleCategory: (value: string) => void;\n  /** Registers a mounted item or category value (duplicate warning); returns the cleanup. */\n  registerValue: (kind: NavValueKind, value: string) => () => void;\n  /** The `currentCategory` hint of the root. */\n  currentCategory: string | undefined;\n  /** The categories the sub-items were last shown in. */\n  categoryStore: NavCategoryStore;\n}\n\n/** The state of the Nav root around a part (`null` outside one). */\nexport const NavContext = React.createContext<NavContextValue | null>(null);\nNavContext.displayName = 'NavContext';\n\nconst noop = () => {};\nconst INERT_NAV_CONTEXT: NavContextValue = {\n  value: '',\n  select: noop,\n  openCategories: [],\n  toggleCategory: noop,\n  registerValue: () => noop,\n  currentCategory: undefined,\n  categoryStore: { record: noop, forget: noop, get: () => undefined, subscribe: () => noop },\n};\n\n/**\n * The value of the Nav.Category a sub-item renders in (`null` outside a category). It renders no\n * element; a sub-item outside a category is valid, so there is no missing-context error.\n */\nexport const NavCategoryValueContext = React.createContext<string | null>(null);\nNavCategoryValueContext.displayName = 'NavCategoryValueContext';\n\n/**\n * The Nav root's context for the part `componentName` (C-CONTEXT): outside a Nav it throws\n * `[WaveUI] <componentName> must be used within Nav` in development, and in production logs once\n * and returns an inert value.\n */\nexport function useNavContext(componentName: string): NavContextValue {\n  const context = React.useContext(NavContext);\n  if (context) return context;\n  reportMissingContext(componentName, 'Nav');\n  return INERT_NAV_CONTEXT;\n}\n\n/** Registers the value of a mounted item or category, so the root can warn about duplicates. */\nexport function useNavValue(context: NavContextValue, kind: NavValueKind, value: string): void {\n  const { registerValue } = context;\n  React.useEffect(() => registerValue(kind, value), [registerValue, kind, value]);\n}\n\n/**\n * Records the category a mounted item renders in, which the category reads once closed (`null`\n * outside a category, which forgets a stale entry for the value).\n */\nexport function useRecordCategory(context: NavContextValue, value: string): void {\n  const category = React.useContext(NavCategoryValueContext);\n  const { categoryStore } = context;\n  React.useLayoutEffect(() => {\n    categoryStore.record(value, category);\n  }, [categoryStore, value, category]);\n}\n\n// ---------------------------------------------------------------------------\n// Roving bookkeeping (an arrow-key body)\n// ---------------------------------------------------------------------------\n\n/** What an arrow-key body (NavDrawer.Body `focusMode=\"arrow\"`) gives the Nav parts inside it. */\nexport interface NavRovingContextValue {\n  /**\n   * Called by every Nav.Category from a layout effect keyed on `[context, value, containsCurrent]`:\n   * `(value, true)` while it is a closed category that holds the current page, `(value, false)`\n   * when it stops being one and in the effect's cleanup (an unmount, StrictMode's double mount).\n   * Must be stable (memoised by the provider).\n   */\n  reportCurrentCategory: (category: string, holdsCurrent: boolean) => void;\n}\n\n/**\n * Provided (non-null) inside an arrow-key body: every Nav.Item and Nav.SubItem renders\n * `data-roving-value={value}` on its link or button (after the consumer's attributes: the\n * bookkeeping wins), and every category toggle `data-roving-value={'wave-nav-category:' + value}`\n * (stable, also while open), and reports as {@link NavRovingContextValue} says. `null` (the\n * default, every plain Nav): nothing is rendered or reported, so a Nav's server HTML is 0.10's.\n */\nexport const NavRovingContext = React.createContext<NavRovingContextValue | null>(null);\nNavRovingContext.displayName = 'NavRovingContext';\n\n// ---------------------------------------------------------------------------\n// Part markers and the children walks\n// ---------------------------------------------------------------------------\n\n/** What a marked Nav part is to the walks: an entry (Nav.Item, Nav.SubItem) or a category. */\nexport type NavPartKind = 'entry' | 'category';\n\n/**\n * The marker property of a Nav part, read only by {@link getNavPartKind}. A registry symbol\n * (`Symbol.for`), as Field's label marker (`fieldLabel.ts`): the ESM and CJS copies of the package\n * share it, so a part marked by one copy is recognised by the other.\n */\nconst NAV_PART: symbol = Symbol.for('wave.navPart');\n\n/**\n * Marks `component` as a Nav part of `kind`, so the walks of a Nav root recognise its elements\n * without importing it; call it next to `displayName`. Returns `component`.\n */\nexport function markNavPart<T extends object>(component: T, kind: NavPartKind): T {\n  (component as Record<symbol, unknown>)[NAV_PART] = kind;\n  return component;\n}\n\n/**\n * The kind of Nav part `node` is an element of, or `null` for anything else. The type is resolved\n * with `getElementType(node, { suspend: false })`: a lazy client reference (a part written in a\n * Server Component) is recognised, and a lazy type still loading is no part (it never suspends).\n */\nexport function getNavPartKind(node: React.ReactNode): NavPartKind | null {\n  const type = getElementType(node, { suspend: false });\n  if ((typeof type !== 'function' && typeof type !== 'object') || type === null) return null;\n  const kind = (type as Record<symbol, unknown>)[NAV_PART];\n  return kind === 'entry' || kind === 'category' ? kind : null;\n}\n\ntype ElementWithChildren = React.ReactElement<{ value?: unknown; children?: React.ReactNode }>;\n\nfunction childrenOf(element: ElementWithChildren): React.ReactNode {\n  const { children } = element.props;\n  return typeof children === 'function' ? undefined : children;\n}\n\n/** Whether a thrown value suspends rendering (a loading lazy chunk, a pending promise). */\nfunction isThenable(value: unknown): boolean {\n  return (\n    (typeof value === 'object' || typeof value === 'function') &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\n/*\n * The walks below run during the render of a Nav root and of a category, and reach consumer\n * content at any depth. Content that is still loading inside the consumer's own <Suspense> (a\n * promise child, a lazy node, a `React.lazy` component) suspends that boundary when React renders\n * it; walking it must never suspend the Nav itself, which would hide the whole Nav behind an outer\n * boundary. So a child that cannot be read yet is skipped, and a lazy type that is still loading is\n * not a part (its children are still walked). Parts written in a Server Component arrive as loaded\n * client references and are recognized.\n */\n\n/** Calls `visit` with each element of `nodes` (as `React.Children.forEach`), skipping pending ones. */\nfunction forEachElement(nodes: React.ReactNode, visit: (child: ElementWithChildren) => void): void {\n  if (Array.isArray(nodes)) {\n    for (const node of nodes as React.ReactNode[]) forEachElement(node, visit);\n    return;\n  }\n  try {\n    React.Children.forEach(nodes, (child) => {\n      if (React.isValidElement<ElementWithChildren['props']>(child)) visit(child);\n    });\n  } catch (error) {\n    if (!isThenable(error)) throw error;\n  }\n}\n\n/**\n * Whether `nodes` contain a Nav.Item/Nav.SubItem element with `value === selected` (parts written\n * in a Server Component, lazy client references, included). Called during render only; never\n * suspends.\n */\nexport function containsValue(nodes: React.ReactNode, selected: string): boolean {\n  let found = false;\n  forEachElement(nodes, (child) => {\n    if (found) return;\n    if (getNavPartKind(child) === 'entry' && child.props.value === selected) {\n      found = true;\n    } else {\n      found = containsValue(childrenOf(child), selected);\n    }\n  });\n  return found;\n}\n\n/** The values of the Nav.Category elements (at any depth of JSX) that contain `selected`. */\nexport function findCategoriesContaining(nodes: React.ReactNode, selected: string): string[] {\n  const result: string[] = [];\n  if (!selected) return result;\n  const visit = (current: React.ReactNode) => {\n    forEachElement(current, (child) => {\n      const inner = childrenOf(child);\n      if (\n        getNavPartKind(child) === 'category' &&\n        typeof child.props.value === 'string' &&\n        containsValue(inner, selected)\n      ) {\n        result.push(child.props.value);\n      }\n      visit(inner);\n    });\n  };\n  visit(nodes);\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// The list-child check\n// ---------------------------------------------------------------------------\n\n/** The advice of the list-child warning, by what the list holds. */\nconst LIST_CHILD_ADVICE = {\n  items:\n    'Use the Nav parts (Nav.Item, Nav.Category, Nav.SectionHeader, Nav.Divider, Nav.AppItem, Nav.AppItemStatic) as its children, or wrap your own content in an <li>.',\n  'sub-items':\n    'Use Nav.SubItem, Nav.SectionHeader and Nav.Divider as its children, or wrap your own content in an <li>.',\n} as const;\n\n/** Element children a list may hold besides `<li>`: script-supporting elements (React's streaming placeholders). */\nconst ALLOWED_LIST_CHILDREN = new Set(['li', 'script', 'template']);\n\n/**\n * What the first child node of `list` that a list cannot hold is (`a <div> element`, `text`), or\n * `null` when every child is an `<li>`, a script-supporting element, whitespace text or a comment.\n */\nfunction describeInvalidListChild(list: HTMLElement): string | null {\n  for (const node of Array.from(list.childNodes)) {\n    if (node.nodeType === Node.ELEMENT_NODE) {\n      const tag = (node as Element).localName.toLowerCase();\n      if (!ALLOWED_LIST_CHILDREN.has(tag)) return `a <${tag}> element`;\n    } else if (node.nodeType === Node.TEXT_NODE && (node.textContent ?? '').trim() !== '') {\n      return 'text';\n    }\n  }\n  return null;\n}\n\n/**\n * Development only: after every commit of the calling component, warns once per `owner`\n * (`${owner}:list-child`) at the first child node of `list` that is neither an `<li>`, `<script>`\n * nor `<template>` element nor whitespace text (comments, and the nothing that `null`, Fragments\n * and Suspense boundaries render, never warn). `contents` picks the advice: `'items'` the Nav\n * parts, `'sub-items'` Nav.SubItem, Nav.SectionHeader and Nav.Divider.\n */\nexport function useNavListChildCheck(\n  list: React.RefObject<HTMLUListElement | null>,\n  owner: string,\n  contents: 'items' | 'sub-items',\n): void {\n  React.useEffect(() => {\n    if (!isDev) return;\n    const key = `${owner}:list-child`;\n    const element = list.current;\n    if (!element || hasWarned(key)) return;\n    const invalid = describeInvalidListChild(element);\n    if (invalid === null) return;\n    warnOnce(\n      key,\n      `${owner}: its list holds ${invalid}, but a list can hold only <li> elements. ${LIST_CHILD_ADVICE[contents]}`,\n    );\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * The attributes only a link has (`target`, `download`, `hrefLang`, `ping`, …). Button items\n * declare them as `undefined`, so they are a type error without `href` instead of landing on the\n * `<button>`. `rel` cannot be listed (React types it on every element, RDFa); a button item drops\n * it at run time instead.\n */\nexport type NoAnchorOnlyAttributes = {\n  [\n    K in Exclude<\n      keyof React.AnchorHTMLAttributes<HTMLAnchorElement>,\n      keyof React.ButtonHTMLAttributes<HTMLButtonElement>\n    >\n  ]?: undefined;\n};\n"],"mappings":"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"}