@skdx/react 0.26.0 → 0.28.0

package/dist/combobox/Combobox.cjs

@@ -1 +1 @@
-"use strict";var Ue=Object.create;var L=Object.defineProperty;var Be=Object.getOwnPropertyDescriptor;var Je=Object.getOwnPropertyNames;var Qe=Object.getPrototypeOf,Xe=Object.prototype.hasOwnProperty;var Ye=(t,r)=>{for(var e in r)L(t,e,{get:r[e],enumerable:!0})},oe=(t,r,e,l)=>{if(r&&typeof r=="object"||typeof r=="function")for(let u of Je(r))!Xe.call(t,u)&&u!==e&&L(t,u,{get:()=>r[u],enumerable:!(l=Be(r,u))||l.enumerable});return t};var O=(t,r,e)=>(e=t!=null?Ue(Qe(t)):{},oe(r||!t||!t.__esModule?L(e,"default",{value:t,enumerable:!0}):e,t)),Ze=t=>oe(L({},"__esModule",{value:!0}),t);var je={};Ye(je,{Combobox:()=>ce,ComboboxContent:()=>U,ComboboxEmpty:()=>J,ComboboxInput:()=>z,ComboboxItem:()=>B,ComboboxPortal:()=>G,ComboboxProvider:()=>ue,OPTION_SELECTOR:()=>y,defaultGetResultCountLabel:()=>me,useComboboxContext:()=>R});module.exports=Ze(je);var n=O(require("react"),1),ne=require("../utils/createContext.cjs"),V=require("../utils/formControl.cjs"),re=require("../utils/hiddenInput.cjs"),ae=require("../utils/liveAnnouncer.cjs"),ie=require("../utils/popper.cjs"),_=require("../utils/useControllableState.cjs"),se=require("../utils/useOpenChangeComplete.cjs"),le=require("../utils/useSelection.cjs"),k=require("react/jsx-runtime"),y='[role="option"]:not([data-disabled])';function me(t){return`${t} result${t===1?"":"s"} available`}var[ue,R]=(0,ne.createSafeContext)("Combobox"),ce=n.forwardRef(function({children:r,value:e,defaultValue:l,onValueChange:u,multiple:m=!1,allowCustomValue:o=!1,filter:C="manual",autoHighlight:c=!1,loading:g=!1,inputValue:a,defaultInputValue:p="",onInputValueChange:f,open:I,defaultOpen:N=!1,onOpenChange:h,onOpenChangeComplete:Me,invalid:Se=!1,readOnly:Te=!1,getResultCountLabel:Q=me,name:X,required:Y=!1},Le){let Z=n.useRef(null),j=n.useRef(null),P=n.useRef(null),[v,E]=n.useState(null),[q,ee]=n.useState(()=>new Map),F=n.useRef(null),{selectedValues:W,isSelected:Ve,selectItem:te,setSelection:Ne}=(0,le.useSelection)({value:e,defaultValue:l,onValueChange:u,multiple:m}),[K="",w]=(0,_.useControllableState)({prop:a,defaultProp:p,onChange:f}),[d=!1,H]=(0,_.useControllableState)({prop:I,defaultProp:N,onChange:h});(0,se.useOpenChangeComplete)(d,P,Me);let[qe,Fe]=n.useState(d);d!==qe&&(Fe(d),d||E(null)),n.useEffect(()=>{if(!d)return;let i=requestAnimationFrame(()=>{let s=F.current;if(F.current=null,!s)return;let b=P.current?.querySelectorAll(y);if(!b||b.length===0)return;let S=s==="last"?b[b.length-1]:b[0];E(T=>T??S.id)});return()=>cancelAnimationFrame(i)},[d]);let M=q.size;n.useLayoutEffect(()=>{if(v===null)return;let i=Array.from(P.current?.querySelectorAll(y)??[]);i.some(s=>s.id===v)||E(i[0]?.id??null)}),n.useEffect(()=>{if(!c||!d||v!==null)return;let i=requestAnimationFrame(()=>{let s=P.current?.querySelector(y);s&&E(s.id)});return()=>cancelAnimationFrame(i)},[c,d,v,M]),n.useEffect(()=>{!d||g||(0,ae.announce)(Q(M))},[d,g,M,Q]);let We=n.useCallback(i=>{F.current=i,H(!0)},[H]),Ke=n.useCallback((i,s)=>{ee(b=>{let S=b.get(i);if(S?.value===s.value&&S.text===s.text)return b;let T=new Map(b);return T.set(i,s),T})},[]),_e=n.useCallback(i=>{ee(s=>{if(!s.has(i))return s;let b=new Map(s);return b.delete(i),b})},[]),$e=n.useCallback(i=>q.get(i),[q]),ze=n.useCallback(i=>C==="manual"||C(i,K),[C,K]),Ge=n.useCallback((i,s)=>{if(te(i),!m){w(s),H(!1);return}w("")},[te,m,w,H]);return n.useImperativeHandle(Le,()=>(0,V.formValidityHandle)(j),[]),(0,V.useFormReset)(Z,()=>{l!==void 0&&Ne(l),w(p)}),(0,k.jsx)(ie.PopperRoot,{children:(0,k.jsxs)(ue,{inputRef:Z,contentRef:P,contentId:n.useId(),multiple:m,selectedValues:W,isSelected:Ve,selectItem:Ge,inputValue:K,onInputValueChange:w,open:d,onOpenChange:H,activeId:v,setActiveId:E,openWithHighlight:We,itemCount:M,registerItem:Ke,unregisterItem:_e,getItem:$e,matchesFilter:ze,invalid:Se,readOnly:Te,loading:g,allowCustomValue:o,required:Y,children:[r,X&&(W.length>0?W:[""]).map((i,s)=>(0,k.jsx)(re.HiddenInput,{ref:s===0?j:void 0,type:"text",name:X,value:i,required:Y},i||s))]})})});ce.displayName="Combobox";var fe=O(require("react"),1),pe=require("../utils/composeRefs.cjs"),de=require("../utils/part.cjs"),be=require("../utils/popper.cjs"),D=require("../utils/primitive.cjs");var $=require("react/jsx-runtime"),z=fe.forwardRef((t,r)=>{let e=R("ComboboxInput"),l=(0,pe.useComposedRefs)(r,e.inputRef),u=o=>{let C=e.contentRef.current;if(!C)return;let c=Array.from(C.querySelectorAll(y));if(c.length===0)return;let a=c.findIndex(p=>p.id===e.activeId)+o;a<0&&(a=0),a>=c.length&&(a=c.length-1),e.setActiveId(c[a].id)},m=()=>{if(!e.activeId)return;let o=e.getItem(e.activeId);o&&e.selectItem(o.value,o.text||o.value)};return(0,$.jsx)(be.PopperAnchor,{asChild:!0,children:(0,$.jsx)(D.Primitive.input,{type:"text",role:"combobox","aria-expanded":e.open,"aria-controls":e.contentId,"aria-autocomplete":"list","aria-activedescendant":e.activeId??void 0,autoComplete:"off",readOnly:e.readOnly,"aria-invalid":e.invalid?!0:void 0,"aria-required":e.required?!0:void 0,"aria-readonly":e.readOnly?!0:void 0,"aria-busy":e.loading?!0:void 0,"data-invalid":e.invalid?"":void 0,"data-readonly":e.readOnly?"":void 0,"data-loading":e.loading?"":void 0,"data-multiple":e.multiple?"":void 0,...t,...(0,de.skdxPart)("combobox","input",t.className),ref:l,value:e.inputValue,onChange:(0,D.composeEventHandlers)(t.onChange,o=>{e.onInputValueChange(o.target.value),e.open||e.onOpenChange(!0)}),onKeyDown:(0,D.composeEventHandlers)(t.onKeyDown,o=>{o.key==="ArrowDown"?(o.preventDefault(),e.open?u(1):e.openWithHighlight("first")):o.key==="ArrowUp"?(o.preventDefault(),e.open?u(-1):e.openWithHighlight("last")):o.key==="Enter"?e.activeId?(o.preventDefault(),m()):e.allowCustomValue&&e.inputValue!==""&&(o.preventDefault(),e.selectItem(e.inputValue,e.inputValue)):o.key==="Escape"&&e.open&&!e.contentRef.current&&(o.preventDefault(),e.onOpenChange(!1))})})})});z.displayName="ComboboxInput";var xe=require("../utils/portal.cjs");var Ce=require("react/jsx-runtime"),G=({forceMount:t,children:r,...e})=>{let l=R("ComboboxPortal");return t||l.open?(0,Ce.jsx)(xe.Portal,{...e,children:r}):null};G.displayName="ComboboxPortal";var Re=O(require("react"),1),ge=require("../utils/composeRefs.cjs"),ye=require("../utils/part.cjs"),Ie=require("../utils/popper.cjs"),he=require("../utils/primitive.cjs"),Pe=require("../utils/useDismiss.cjs");var ve=require("react/jsx-runtime"),U=Re.forwardRef(({forceMount:t,side:r="bottom",align:e="start",sideOffset:l=4,onEscapeKeyDown:u,onPointerDownOutside:m,onFocusOutside:o,onInteractOutside:C,...c},g)=>{let a=R("ComboboxContent"),p=(0,ge.useComposedRefs)(g,a.contentRef);return(0,Pe.useDismiss)({enabled:a.open,onEscapeKeyDown:f=>{u?.(f),f.defaultPrevented||a.onOpenChange(!1)},onInteractOutside:C,onPointerDownOutside:f=>{m?.(f),f.defaultPrevented||a.onOpenChange(!1)},onFocusOutside:f=>{o?.(f),f.defaultPrevented||a.onOpenChange(!1)}},[a.contentRef,a.inputRef]),t||a.open?(0,ve.jsx)(Ie.PopperContent,{component:"combobox",role:"listbox",id:a.contentId,"aria-multiselectable":a.multiple?!0:void 0,"aria-busy":a.loading?!0:void 0,"data-state":a.open?"open":"closed","data-loading":a.loading?"":void 0,"data-multiple":a.multiple?"":void 0,side:r,align:e,sideOffset:l,...c,...(0,ye.skdxPart)("combobox","content",c.className),ref:p,onMouseDown:(0,he.composeEventHandlers)(c.onMouseDown,f=>f.preventDefault())}):null});U.displayName="ComboboxContent";var x=O(require("react"),1),Ee=require("../utils/composeRefs.cjs"),we=require("../utils/part.cjs"),A=require("../utils/primitive.cjs");var He=require("react/jsx-runtime"),B=x.forwardRef(({value:t,disabled:r,textValue:e,...l},u)=>{let m=R("ComboboxItem"),o=x.useId(),C=x.useRef(null),c=(0,Ee.useComposedRefs)(u,C),g=m.isSelected(t),a=m.activeId===o,[p,f]=x.useState(e??null);x.useLayoutEffect(()=>{let h=e??C.current?.textContent;h!=null&&h!==p&&f(h)});let I=p===null||m.matchesFilter(p);x.useEffect(()=>{if(I)return m.registerItem(o,{value:t,text:p??""}),()=>m.unregisterItem(o)},[o,I,t,p]);let N=()=>{r||(m.selectItem(t,p??t),m.inputRef.current?.focus())};return I?(0,He.jsx)(A.Primitive.div,{role:"option",id:o,"data-value":t,"aria-selected":g,"data-state":g?"checked":"unchecked","data-highlighted":a?"":void 0,"data-disabled":r?"":void 0,...l,...(0,we.skdxPart)("combobox","item",l.className),ref:c,onClick:(0,A.composeEventHandlers)(l.onClick,N),onPointerEnter:(0,A.composeEventHandlers)(l.onPointerEnter,()=>{r||m.setActiveId(o)})}):null});B.displayName="ComboboxItem";var Oe=O(require("react"),1),ke=require("../utils/part.cjs"),De=require("../utils/primitive.cjs");var Ae=require("react/jsx-runtime"),J=Oe.forwardRef((t,r)=>R("ComboboxEmpty").itemCount===0?(0,Ae.jsx)(De.Primitive.div,{role:"presentation",...t,...(0,ke.skdxPart)("combobox","empty",t.className),ref:r}):null);J.displayName="ComboboxEmpty";0&&(module.exports={Combobox,ComboboxContent,ComboboxEmpty,ComboboxInput,ComboboxItem,ComboboxPortal,ComboboxProvider,OPTION_SELECTOR,defaultGetResultCountLabel,useComboboxContext});
+"use strict";var Jo=Object.create;var U=Object.defineProperty;var Qo=Object.getOwnPropertyDescriptor;var Xo=Object.getOwnPropertyNames;var Zo=Object.getPrototypeOf,jo=Object.prototype.hasOwnProperty;var et=(o,n)=>{for(var e in n)U(o,e,{get:n[e],enumerable:!0})},Pe=(o,n,e,l)=>{if(n&&typeof n=="object"||typeof n=="function")for(let u of Xo(n))!jo.call(o,u)&&u!==e&&U(o,u,{get:()=>n[u],enumerable:!(l=Qo(n,u))||l.enumerable});return o};var I=(o,n,e)=>(e=o!=null?Jo(Zo(o)):{},Pe(n||!o||!o.__esModule?U(e,"default",{value:o,enumerable:!0}):e,o)),ot=o=>Pe(U({},"__esModule",{value:!0}),o);var at={};et(at,{Combobox:()=>uo,ComboboxAnatomy:()=>ce,ComboboxClear:()=>Ro,ComboboxContent:()=>_,ComboboxEmpty:()=>$,ComboboxGroup:()=>Y,ComboboxGroupLabel:()=>J,ComboboxGroupProvider:()=>Be,ComboboxInput:()=>Q,ComboboxItem:()=>Z,ComboboxPortal:()=>j,ComboboxProvider:()=>mo,ComboboxTrigger:()=>fo,OPTION_SELECTOR:()=>X,defaultGetResultCountLabel:()=>so,defaultOptionsFilter:()=>ee,useComboboxContext:()=>f,useComboboxGroupContext:()=>me});module.exports=ot(at);var r=I(require("react"),1),to=require("../utils/createContext.cjs"),oe=require("../utils/formControl.cjs"),no=require("../utils/hiddenInput.cjs"),ro=require("../utils/liveAnnouncer.cjs"),ao=require("../utils/popper.cjs"),H=require("../utils/scoredFilter.cjs"),be=require("../utils/useControllableState.cjs"),io=require("../utils/useOpenChangeComplete.cjs"),lo=require("../utils/useSelection.cjs");var ke=I(require("react"),1),Ee=require("../utils/composeRefs.cjs"),we=require("../utils/part.cjs"),Te=require("../utils/popper.cjs"),He=require("../utils/primitive.cjs"),De=require("../utils/useDismiss.cjs");var Me=require("react/jsx-runtime"),_=ke.forwardRef(({forceMount:o,side:n="bottom",align:e="start",sideOffset:l=4,onEscapeKeyDown:u,onPointerDownOutside:s,onFocusOutside:p,onInteractOutside:x,...t},c)=>{let m=f("ComboboxContent"),y=(0,Ee.useComposedRefs)(c,m.contentRef);return(0,De.useDismiss)({enabled:m.open,onEscapeKeyDown:b=>{u?.(b),b.defaultPrevented||m.onOpenChange(!1)},onInteractOutside:x,onPointerDownOutside:b=>{s?.(b),b.defaultPrevented||m.onOpenChange(!1)},onFocusOutside:b=>{p?.(b),b.defaultPrevented||m.onOpenChange(!1)}},[m.contentRef,m.inputRef,m.triggerRef]),o||m.open?(0,Me.jsx)(Te.PopperContent,{component:"combobox",role:"listbox",id:m.contentId,"aria-multiselectable":m.multiple?!0:void 0,"aria-busy":m.loading?!0:void 0,"data-state":m.open?"open":"closed","data-loading":m.loading?"":void 0,"data-multiple":m.multiple?"":void 0,side:n,align:e,sideOffset:l,...t,...(0,we.skdxPart)("combobox","content",t.className),ref:y,onMouseDown:(0,He.composeEventHandlers)(t.onMouseDown,b=>b.preventDefault())}):null});_.displayName="ComboboxContent";var Le=I(require("react"),1),Ve=require("../utils/part.cjs"),Ge=require("../utils/primitive.cjs");var Se=require("react/jsx-runtime"),$=Le.forwardRef((o,n)=>f("ComboboxEmpty").itemCount===0?(0,Se.jsx)(Ge.Primitive.div,{role:"presentation",...o,...(0,Ve.skdxPart)("combobox","empty",o.className),ref:n}):null);$.displayName="ComboboxEmpty";var z=I(require("react"),1),Ae=require("../utils/createContext.cjs"),Ne=require("../utils/part.cjs"),Fe=require("../utils/primitive.cjs"),se=require("react/jsx-runtime"),[Be,me]=(0,Ae.createSafeContext)("ComboboxGroup"),Y=z.forwardRef((o,n)=>{let e=z.useId();return(0,se.jsx)(Be,{labelId:e,children:(0,se.jsx)(Fe.Primitive.div,{role:"group","aria-labelledby":e,...o,...(0,Ne.skdxPart)("combobox","group",o.className),ref:n})})});Y.displayName="ComboboxGroup";var qe=I(require("react"),1),Ke=require("../utils/part.cjs"),We=require("../utils/primitive.cjs");var Ue=require("react/jsx-runtime"),J=qe.forwardRef((o,n)=>{let e=me("ComboboxGroupLabel");return(0,Ue.jsx)(We.Primitive.div,{id:e.labelId,...o,...(0,Ke.skdxPart)("combobox","label",o.className),ref:n})});J.displayName="ComboboxGroupLabel";var _e=I(require("react"),1),$e=require("../utils/composeRefs.cjs"),ze=require("../utils/part.cjs"),Ye=require("../utils/popper.cjs"),O=require("../utils/primitive.cjs"),Je=require("../utils/scoredFilter.cjs");var ue=require("react/jsx-runtime"),tt=new Set(["Home","End","PageUp","PageDown"]),Q=_e.forwardRef((o,n)=>{let e=f("ComboboxInput"),l=(0,$e.useComposedRefs)(n,e.inputRef),u=t=>{t&&(e.setActiveId(t.id,"keyboard"),t.scrollIntoView?.({block:"nearest"}))},s=()=>{let t=e.contentRef.current;return t?(0,Je.sortByOrder)(Array.from(t.querySelectorAll(X)),e.itemOrder):[]},p=t=>{let c=s();if(c.length===0)return;let m=c.findIndex(D=>D.id===e.activeId),y=m===-1?t===1?-1:0:m,b=e.loop?(y+t+c.length)%c.length:Math.min(c.length-1,Math.max(0,y+t));u(c[b])},x=()=>{if(!e.activeId)return;let t=e.getItem(e.activeId);t&&e.selectItem(t.value,t.text||t.value,"keyboard")};return(0,ue.jsx)(Ye.PopperAnchor,{asChild:!0,children:(0,ue.jsx)(O.Primitive.input,{type:"text",role:"combobox","aria-expanded":e.open,"aria-controls":e.contentId,"aria-autocomplete":"list","aria-activedescendant":e.activeId??void 0,autoComplete:"off",readOnly:e.readOnly,disabled:e.disabled,"data-disabled":e.disabled?"":void 0,"aria-invalid":e.invalid?!0:void 0,"aria-required":e.required?!0:void 0,"aria-readonly":e.readOnly?!0:void 0,"aria-busy":e.loading?!0:void 0,"data-invalid":e.invalid?"":void 0,"data-readonly":e.readOnly?"":void 0,"data-loading":e.loading?"":void 0,"data-multiple":e.multiple?"":void 0,...o,...(0,ze.skdxPart)("combobox","input",o.className),ref:l,value:e.inputValue,onChange:(0,O.composeEventHandlers)(o.onChange,t=>{e.onInputValueChange(t.target.value),e.open||e.onOpenChange(!0)}),onClick:(0,O.composeEventHandlers)(o.onClick,()=>{e.openOn==="type"||e.readOnly||e.open||e.onOpenChange(!0)}),onFocus:(0,O.composeEventHandlers)(o.onFocus,()=>{e.openOn!=="focus"||e.readOnly||e.open||e.onOpenChange(!0)}),onBlur:(0,O.composeEventHandlers)(o.onBlur,t=>{let c=t.relatedTarget;c&&(c===t.currentTarget||e.contentRef.current?.contains(c))||e.reconcileDraftText()}),onKeyDown:(0,O.composeEventHandlers)(o.onKeyDown,t=>{if(t.altKey&&t.key==="ArrowDown")t.preventDefault(),e.open||e.onOpenChange(!0);else if(t.altKey&&t.key==="ArrowUp")t.preventDefault(),e.activeId&&x(),e.open&&e.onOpenChange(!1);else if(t.key==="ArrowDown")t.preventDefault(),e.open?p(1):e.openWithHighlight("first");else if(t.key==="ArrowUp")t.preventDefault(),e.open?p(-1):e.openWithHighlight("last");else if(tt.has(t.key)&&e.open){t.preventDefault();let c=s(),m=t.key==="Home"||t.key==="PageUp";u(m?c[0]:c[c.length-1])}else t.key==="Enter"?e.activeId?(t.preventDefault(),x()):e.allowCustomValue&&e.inputValue!==""?(t.preventDefault(),e.selectItem(e.inputValue,e.inputValue,"keyboard")):e.open&&e.onOpenChange(!1):t.key==="Escape"&&e.open&&!e.contentRef.current&&(t.preventDefault(),e.onOpenChange(!1))})})})});Q.displayName="ComboboxInput";var w=I(require("react"),1),Qe=require("../utils/composeRefs.cjs"),Xe=require("../utils/part.cjs"),N=require("../utils/primitive.cjs"),Ze=require("../utils/useOptionCollection.cjs");var je=require("react/jsx-runtime"),Z=w.forwardRef(({value:o,disabled:n,textValue:e,...l},u)=>{let s=f("ComboboxItem"),p=w.useId(),x=w.useRef(null),t=(0,Qe.useComposedRefs)(u,x),c=s.isSelected(o),m=s.activeId===p,y=s.itemOrder?.get(p),{text:b,visible:D}=(0,Ze.useOptionEntry)({id:p,value:o,textValue:e,itemRef:x,matchesFilter:s.matchesFilter,registerItem:s.registerItem,unregisterItem:s.unregisterItem}),q=()=>{n||(s.selectItem(o,b??o,"pointer"),s.inputRef.current?.focus())};return D?(0,je.jsx)(N.Primitive.div,{role:"option",id:p,"data-value":o,"aria-selected":c,"data-state":c?"checked":"unchecked","data-highlighted":m?"":void 0,"aria-disabled":n||void 0,"data-disabled":n?"":void 0,...l,...(0,Xe.skdxPart)("combobox","item",l.className),ref:t,onClick:(0,N.composeEventHandlers)(l.onClick,q),onPointerEnter:(0,N.composeEventHandlers)(l.onPointerEnter,()=>{n||s.setActiveId(p,"pointer")}),style:y!==void 0?{order:y,...l.style}:l.style}):null});Z.displayName="ComboboxItem";var eo=require("../utils/portal.cjs");var oo=require("react/jsx-runtime"),j=({forceMount:o,children:n,...e})=>{let l=f("ComboboxPortal");return o||l.open?(0,oo.jsx)(eo.Portal,{...e,children:n}):null};j.displayName="ComboboxPortal";var R=require("react/jsx-runtime"),nt=o=>"options"in o;function ee(o,n){return o.toLowerCase().includes(n.trim().toLowerCase())}var ce=({options:o,renderOption:n,placeholder:e,ariaLabel:l,passThrough:u})=>{let s=f("Combobox"),p=l??e,x=t=>(0,R.jsx)(Z,{value:t.value,disabled:t.disabled,textValue:t.label,children:n?n(t,{selected:s.isSelected(t.value)}):t.label??t.value},t.value);return(0,R.jsxs)(R.Fragment,{children:[(0,R.jsx)(Q,{...u,"aria-label":p,placeholder:e}),(0,R.jsx)(j,{children:(0,R.jsxs)(_,{"aria-label":p,children:[o.map(t=>nt(t)?(0,R.jsxs)(Y,{children:[(0,R.jsx)(J,{children:t.label}),t.options.map(x)]},t.label):x(t)),(0,R.jsx)($,{children:"No results"})]})})]})};var T=require("react/jsx-runtime"),X='[role="option"]:not([data-disabled])';function rt(o,n){let e=o.querySelector('[data-part="viewport"]')??o;if(e===n||!e.contains(n))return;let l=e.getBoundingClientRect(),u=n.getBoundingClientRect();e.scrollTop+=u.top-l.top-(l.height-u.height)/2}function so(o){return`${o} result${o===1?"":"s"} available`}var[mo,f]=(0,to.createSafeContext)("Combobox"),uo=r.forwardRef(function({children:n,value:e,defaultValue:l,onValueChange:u,multiple:s=!1,allowCustomValue:p=!1,filter:x,autoHighlight:t=!1,loop:c=!0,openOn:m="type",onHighlightChange:y,loading:b=!1,inputValue:D,defaultInputValue:q="",onInputValueChange:yo,open:vo,defaultOpen:Io=!1,onOpenChange:Oo,onOpenChangeComplete:Po,invalid:ko=!1,readOnly:Eo=!1,disabled:pe=!1,getResultCountLabel:fe=so,name:wo,form:To,required:de=!1,options:xe,renderOption:Ho,placeholder:Do,"aria-label":Mo,...Lo},Vo){let E=x??(xe?ee:"manual"),Ce=r.useRef(null),Go=r.useRef(null),ge=r.useRef(null),M=r.useRef(null),[P,L]=r.useState(null),[v,Re]=r.useState(()=>new Map),te=r.useRef(null),ne=r.useRef("programmatic"),re=r.useRef(null),{selectedValues:C,isSelected:So,selectItem:he,setSelection:ye}=(0,lo.useSelection)({value:e,defaultValue:l,onValueChange:a=>u?.({value:a.value,previousValue:re.current,reason:ne.current,selectedValue:a.selectedValue}),multiple:s,label:"Combobox"}),ve=r.useCallback((a,i)=>{re.current=C.length===0?null:C,ne.current=i,he(a)},[he,C]),ae=r.useCallback((a,i)=>{re.current=C.length===0?null:C,ne.current=i,ye(a)},[ye,C]),[V="",h]=(0,be.useControllableState)({prop:D,defaultProp:q,onChange:yo}),[g=!1,G]=(0,be.useControllableState)({prop:vo,defaultProp:Io,onChange:Oo});(0,io.useOpenChangeComplete)(g,M,Po);let[Ao,No]=r.useState(g);g!==Ao&&(No(g),g||L(null));let ie=r.useMemo(()=>E==="manual"?null:(0,H.rankByScore)([...v.keys()],a=>{let i=v.get(a);if(!i)return null;let d=E(i.text,V);return typeof d=="number"?d:null}),[E,V,v]),S=r.useCallback(a=>(0,H.sortByOrder)(Array.from(a?.querySelectorAll(X)??[]),ie),[ie]);r.useEffect(()=>{if(!g)return;let a=requestAnimationFrame(()=>{let i=te.current;if(te.current=null,!i)return;let d=M.current,k=S(d);if(!d||k.length===0)return;let A=i==="last"?k[k.length-1]:k[0];L(Yo=>Yo??A.id),rt(d,A)});return()=>cancelAnimationFrame(a)},[g,S]);let K=v.size,Ie=r.useRef("auto"),Oe=r.useRef(null),Fo=r.useCallback((a,i="auto")=>{Ie.current=i,L(a)},[]),W=P?v.get(P)?.value??null:null;r.useEffect(()=>{let a=Oe.current;W!==a&&(Oe.current=W,y?.({value:W,previousValue:a,reason:Ie.current}))},[W,y]),r.useLayoutEffect(()=>{if(P===null)return;let a=S(M.current);a.some(i=>i.id===P)||L(a[0]?.id??null)}),r.useEffect(()=>{if(!t||!g||P!==null)return;let a=requestAnimationFrame(()=>{let i=S(M.current)[0];i&&L(i.id)});return()=>cancelAnimationFrame(a)},[t,g,P,K,S]),r.useEffect(()=>{!g||b||(0,ro.announce)(fe(K))},[g,b,K,fe]);let Bo=r.useCallback(a=>{te.current=a,G(!0)},[G]),qo=r.useCallback((a,i)=>{Re(d=>{let k=d.get(a);if(k?.value===i.value&&k.text===i.text)return d;let A=new Map(d);return A.set(a,i),A})},[]),Ko=r.useCallback(a=>{Re(i=>{if(!i.has(a))return i;let d=new Map(i);return d.delete(a),d})},[]),Wo=r.useCallback(a=>v.get(a),[v]),Uo=r.useCallback(a=>E==="manual"||(0,H.filterKeeps)(E(a,V)),[E,V]),le=r.useRef(null),_o=r.useCallback((a,i,d)=>{if(ve(a,d),!s){le.current=i,h(i),G(!1);return}h("")},[ve,s,h,G]),$o=r.useCallback(()=>{C.length>0&&ae([],"pointer"),le.current=null,h("")},[C.length,ae,h]),zo=r.useCallback(()=>{if(p)return;let a=s?void 0:C[0];if(a===void 0){h("");return}for(let i of v.values())if(i.value===a){h(i.text||i.value);return}h(le.current??a)},[p,s,C,v,h]);return r.useImperativeHandle(Vo,()=>(0,oe.formValidityHandle)(ge),[]),(0,oe.useFormReset)(Ce,()=>{l!==void 0&&ae(l,"programmatic"),h(q)}),(0,T.jsx)(ao.PopperRoot,{children:(0,T.jsxs)(mo,{inputRef:Ce,triggerRef:Go,contentRef:M,contentId:r.useId(),multiple:s,selectedValues:C,isSelected:So,selectItem:_o,clear:$o,inputValue:V,onInputValueChange:h,open:g,onOpenChange:G,activeId:P,itemOrder:ie,setActiveId:Fo,openWithHighlight:Bo,loop:c,openOn:m,reconcileDraftText:zo,itemCount:K,registerItem:qo,unregisterItem:Ko,getItem:Wo,matchesFilter:Uo,invalid:ko,readOnly:Eo,disabled:pe,loading:b,allowCustomValue:p,required:de,children:[n??(0,T.jsx)(ce,{options:xe??[],renderOption:Ho,placeholder:Do,ariaLabel:Mo,passThrough:Lo}),(0,T.jsx)(no.MirroredValues,{name:wo,values:C,required:de,disabled:pe,form:To,singleValued:!s,controlRef:ge})]})})});uo.displayName="Combobox";var co=I(require("react"),1),bo=require("../utils/composeRefs.cjs"),po=require("../utils/part.cjs"),F=require("../utils/primitive.cjs");var xo=require("react/jsx-runtime"),fo=co.forwardRef((o,n)=>{let e=f("ComboboxTrigger"),l=(0,bo.useComposedRefs)(n,e.triggerRef);return(0,xo.jsx)(F.Primitive.button,{type:"button",tabIndex:-1,"aria-expanded":e.open,"aria-controls":e.open?e.contentId:void 0,disabled:e.disabled,"data-disabled":e.disabled?"":void 0,"data-readonly":e.readOnly?"":void 0,"data-state":e.open?"open":"closed",...o,...(0,po.skdxPart)("combobox","trigger",o.className),ref:l,onMouseDown:(0,F.composeEventHandlers)(o.onMouseDown,u=>u.preventDefault()),onClick:(0,F.composeEventHandlers)(o.onClick,()=>{e.readOnly||(e.onOpenChange(!e.open),e.inputRef.current?.focus())})})});fo.displayName="ComboboxTrigger";var Co=I(require("react"),1),go=require("../utils/part.cjs"),B=require("../utils/primitive.cjs");var ho=require("react/jsx-runtime"),Ro=Co.forwardRef((o,n)=>{let e=f("ComboboxClear"),l=e.selectedValues.length===0&&e.inputValue==="";return(0,ho.jsx)(B.Primitive.button,{type:"button",tabIndex:-1,disabled:e.disabled||e.readOnly||l,"data-disabled":e.disabled?"":void 0,"data-readonly":e.readOnly?"":void 0,...o,...(0,go.skdxPart)("combobox","clear",o.className),ref:n,onMouseDown:(0,B.composeEventHandlers)(o.onMouseDown,u=>u.preventDefault()),onClick:(0,B.composeEventHandlers)(o.onClick,()=>{e.clear(),e.inputRef.current?.focus()})})});Ro.displayName="ComboboxClear";0&&(module.exports={Combobox,ComboboxAnatomy,ComboboxClear,ComboboxContent,ComboboxEmpty,ComboboxGroup,ComboboxGroupLabel,ComboboxGroupProvider,ComboboxInput,ComboboxItem,ComboboxPortal,ComboboxProvider,ComboboxTrigger,OPTION_SELECTOR,defaultGetResultCountLabel,defaultOptionsFilter,useComboboxContext,useComboboxGroupContext});

package/dist/combobox/Combobox.d.cts

@@ -1,12 +1,5 @@
 import * as React from 'react';
 import type { ComboboxContextValue, ComboboxProps } from './types.cjs';
-/**
- * WAI-ARIA 1.2 "combobox with list autocomplete": real DOM focus always
- * stays on the input; the highlighted option is tracked as virtual focus
- * via `aria-activedescendant`. Filtering is the consumer's responsibility by
- * default (`filter: 'manual'`) and moves inside the component as soon as a
- * `filter` predicate is supplied.
- */
 export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
 /** Default `getResultCountLabel`: `"1 result available"` / `"3 results available"`. */
 export declare function defaultGetResultCountLabel(count: number): string;
@@ -17,21 +10,22 @@ export declare const ComboboxProvider: {
     displayName: string;
 }, useComboboxContext: (consumerName: string) => ComboboxContextValue;
 /**
- * Root of a WAI-ARIA 1.2 "combobox with list autocomplete": real DOM focus
- * always stays on `ComboboxInput`; the highlighted option is tracked as
- * virtual focus via `aria-activedescendant` rather than moved with `tabIndex`.
- * Owns the selected value, the input's draft text, and the popup's open
- * state, handing all three down to every other `Combobox*` part via context.
- * Renders no DOM of its own.
- *
- * Filtering is the consumer's job by default (`filter: 'manual'`): you filter
- * your data by `inputValue` and render only the `ComboboxItem`s that match,
- * which is what an async or server-side search needs. Pass a `filter`
- * predicate instead and the component filters its own children.
+ * WAI-ARIA 1.2 "combobox with list autocomplete": real DOM focus stays on the input,
+ * highlighted option is virtual focus via aria-activedescendant. Filtering is
+ * consumer-driven by default or moves inside with a `filter` predicate.
+ * Works controlled or uncontrolled.
  *
- * Works controlled (`value` + `onValueChange`, `inputValue` +
- * `onInputValueChange`, `open` + `onOpenChange`) or uncontrolled
- * (`defaultValue`, `defaultInputValue`, `defaultOpen`).
+ * @example
+ * ```tsx
+ * <Combobox inputValue={query} onInputValueChange={setQuery}>
+ *   <ComboboxInput placeholder="Search…" />
+ *   <ComboboxPortal>
+ *     <ComboboxContent>
+ *       {filtered.map((item) => <ComboboxItem value={item} key={item} />)}
+ *     </ComboboxContent>
+ *   </ComboboxPortal>
+ * </Combobox>
+ * ```
  *
  * @example Consumer-side (default) filtering:
  * ```tsx

package/dist/combobox/Combobox.d.ts

@@ -1,12 +1,5 @@
 import * as React from 'react';
 import type { ComboboxContextValue, ComboboxProps } from './types.js';
-/**
- * WAI-ARIA 1.2 "combobox with list autocomplete": real DOM focus always
- * stays on the input; the highlighted option is tracked as virtual focus
- * via `aria-activedescendant`. Filtering is the consumer's responsibility by
- * default (`filter: 'manual'`) and moves inside the component as soon as a
- * `filter` predicate is supplied.
- */
 export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
 /** Default `getResultCountLabel`: `"1 result available"` / `"3 results available"`. */
 export declare function defaultGetResultCountLabel(count: number): string;
@@ -17,21 +10,22 @@ export declare const ComboboxProvider: {
     displayName: string;
 }, useComboboxContext: (consumerName: string) => ComboboxContextValue;
 /**
- * Root of a WAI-ARIA 1.2 "combobox with list autocomplete": real DOM focus
- * always stays on `ComboboxInput`; the highlighted option is tracked as
- * virtual focus via `aria-activedescendant` rather than moved with `tabIndex`.
- * Owns the selected value, the input's draft text, and the popup's open
- * state, handing all three down to every other `Combobox*` part via context.
- * Renders no DOM of its own.
- *
- * Filtering is the consumer's job by default (`filter: 'manual'`): you filter
- * your data by `inputValue` and render only the `ComboboxItem`s that match,
- * which is what an async or server-side search needs. Pass a `filter`
- * predicate instead and the component filters its own children.
+ * WAI-ARIA 1.2 "combobox with list autocomplete": real DOM focus stays on the input,
+ * highlighted option is virtual focus via aria-activedescendant. Filtering is
+ * consumer-driven by default or moves inside with a `filter` predicate.
+ * Works controlled or uncontrolled.
  *
- * Works controlled (`value` + `onValueChange`, `inputValue` +
- * `onInputValueChange`, `open` + `onOpenChange`) or uncontrolled
- * (`defaultValue`, `defaultInputValue`, `defaultOpen`).
+ * @example
+ * ```tsx
+ * <Combobox inputValue={query} onInputValueChange={setQuery}>
+ *   <ComboboxInput placeholder="Search…" />
+ *   <ComboboxPortal>
+ *     <ComboboxContent>
+ *       {filtered.map((item) => <ComboboxItem value={item} key={item} />)}
+ *     </ComboboxContent>
+ *   </ComboboxPortal>
+ * </Combobox>
+ * ```
  *
  * @example Consumer-side (default) filtering:
  * ```tsx

package/dist/combobox/Combobox.js

@@ -1 +1 @@
-import*as o from"react";import{createSafeContext as xe}from"../utils/createContext.js";import{formValidityHandle as Ce,useFormReset as Re}from"../utils/formControl.js";import{HiddenInput as ge}from"../utils/hiddenInput.js";import{announce as ye}from"../utils/liveAnnouncer.js";import{PopperRoot as Ie}from"../utils/popper.js";import{useControllableState as $}from"../utils/useControllableState.js";import{useOpenChangeComplete as he}from"../utils/useOpenChangeComplete.js";import{useSelection as Pe}from"../utils/useSelection.js";import{jsx as z,jsxs as He}from"react/jsx-runtime";var H='[role="option"]:not([data-disabled])';function ve(a){return`${a} result${a===1?"":"s"} available`}var[Ee,C]=xe("Combobox"),we=o.forwardRef(function({children:c,value:e,defaultValue:l,onValueChange:g,multiple:s=!1,allowCustomValue:t=!1,filter:x="manual",autoHighlight:m=!1,loading:R=!1,inputValue:n,defaultInputValue:f="",onInputValueChange:u,open:y,defaultOpen:A=!1,onOpenChange:I,onOpenChangeComplete:oe,invalid:ne=!1,readOnly:re=!1,getResultCountLabel:V=ve,name:N,required:q=!1},ae){let F=o.useRef(null),W=o.useRef(null),h=o.useRef(null),[P,v]=o.useState(null),[M,K]=o.useState(()=>new Map),S=o.useRef(null),{selectedValues:T,isSelected:ie,selectItem:_,setSelection:se}=Pe({value:e,defaultValue:l,onValueChange:g,multiple:s}),[L="",E]=$({prop:n,defaultProp:f,onChange:u}),[p=!1,w]=$({prop:y,defaultProp:A,onChange:I});he(p,h,oe);let[le,me]=o.useState(p);p!==le&&(me(p),p||v(null)),o.useEffect(()=>{if(!p)return;let r=requestAnimationFrame(()=>{let i=S.current;if(S.current=null,!i)return;let d=h.current?.querySelectorAll(H);if(!d||d.length===0)return;let k=i==="last"?d[d.length-1]:d[0];v(D=>D??k.id)});return()=>cancelAnimationFrame(r)},[p]);let O=M.size;o.useLayoutEffect(()=>{if(P===null)return;let r=Array.from(h.current?.querySelectorAll(H)??[]);r.some(i=>i.id===P)||v(r[0]?.id??null)}),o.useEffect(()=>{if(!m||!p||P!==null)return;let r=requestAnimationFrame(()=>{let i=h.current?.querySelector(H);i&&v(i.id)});return()=>cancelAnimationFrame(r)},[m,p,P,O]),o.useEffect(()=>{!p||R||ye(V(O))},[p,R,O,V]);let ue=o.useCallback(r=>{S.current=r,w(!0)},[w]),ce=o.useCallback((r,i)=>{K(d=>{let k=d.get(r);if(k?.value===i.value&&k.text===i.text)return d;let D=new Map(d);return D.set(r,i),D})},[]),fe=o.useCallback(r=>{K(i=>{if(!i.has(r))return i;let d=new Map(i);return d.delete(r),d})},[]),pe=o.useCallback(r=>M.get(r),[M]),de=o.useCallback(r=>x==="manual"||x(r,L),[x,L]),be=o.useCallback((r,i)=>{if(_(r),!s){E(i),w(!1);return}E("")},[_,s,E,w]);return o.useImperativeHandle(ae,()=>Ce(W),[]),Re(F,()=>{l!==void 0&&se(l),E(f)}),z(Ie,{children:He(Ee,{inputRef:F,contentRef:h,contentId:o.useId(),multiple:s,selectedValues:T,isSelected:ie,selectItem:be,inputValue:L,onInputValueChange:E,open:p,onOpenChange:w,activeId:P,setActiveId:v,openWithHighlight:ue,itemCount:O,registerItem:ce,unregisterItem:fe,getItem:pe,matchesFilter:de,invalid:ne,readOnly:re,loading:R,allowCustomValue:t,required:q,children:[c,N&&(T.length>0?T:[""]).map((r,i)=>z(ge,{ref:i===0?W:void 0,type:"text",name:N,value:r,required:q},r||i))]})})});we.displayName="Combobox";import*as B from"react";import{useComposedRefs as Oe}from"../utils/composeRefs.js";import{skdxPart as ke}from"../utils/part.js";import{PopperAnchor as De}from"../utils/popper.js";import{composeEventHandlers as G,Primitive as Ae}from"../utils/primitive.js";import{jsx as U}from"react/jsx-runtime";var J=B.forwardRef((a,c)=>{let e=C("ComboboxInput"),l=Oe(c,e.inputRef),g=t=>{let x=e.contentRef.current;if(!x)return;let m=Array.from(x.querySelectorAll(H));if(m.length===0)return;let n=m.findIndex(f=>f.id===e.activeId)+t;n<0&&(n=0),n>=m.length&&(n=m.length-1),e.setActiveId(m[n].id)},s=()=>{if(!e.activeId)return;let t=e.getItem(e.activeId);t&&e.selectItem(t.value,t.text||t.value)};return U(De,{asChild:!0,children:U(Ae.input,{type:"text",role:"combobox","aria-expanded":e.open,"aria-controls":e.contentId,"aria-autocomplete":"list","aria-activedescendant":e.activeId??void 0,autoComplete:"off",readOnly:e.readOnly,"aria-invalid":e.invalid?!0:void 0,"aria-required":e.required?!0:void 0,"aria-readonly":e.readOnly?!0:void 0,"aria-busy":e.loading?!0:void 0,"data-invalid":e.invalid?"":void 0,"data-readonly":e.readOnly?"":void 0,"data-loading":e.loading?"":void 0,"data-multiple":e.multiple?"":void 0,...a,...ke("combobox","input",a.className),ref:l,value:e.inputValue,onChange:G(a.onChange,t=>{e.onInputValueChange(t.target.value),e.open||e.onOpenChange(!0)}),onKeyDown:G(a.onKeyDown,t=>{t.key==="ArrowDown"?(t.preventDefault(),e.open?g(1):e.openWithHighlight("first")):t.key==="ArrowUp"?(t.preventDefault(),e.open?g(-1):e.openWithHighlight("last")):t.key==="Enter"?e.activeId?(t.preventDefault(),s()):e.allowCustomValue&&e.inputValue!==""&&(t.preventDefault(),e.selectItem(e.inputValue,e.inputValue)):t.key==="Escape"&&e.open&&!e.contentRef.current&&(t.preventDefault(),e.onOpenChange(!1))})})})});J.displayName="ComboboxInput";import{Portal as Me}from"../utils/portal.js";import{jsx as Se}from"react/jsx-runtime";var Q=({forceMount:a,children:c,...e})=>{let l=C("ComboboxPortal");return a||l.open?Se(Me,{...e,children:c}):null};Q.displayName="ComboboxPortal";import*as X from"react";import{useComposedRefs as Te}from"../utils/composeRefs.js";import{skdxPart as Le}from"../utils/part.js";import{PopperContent as Ve}from"../utils/popper.js";import{composeEventHandlers as Ne}from"../utils/primitive.js";import{useDismiss as qe}from"../utils/useDismiss.js";import{jsx as Fe}from"react/jsx-runtime";var Y=X.forwardRef(({forceMount:a,side:c="bottom",align:e="start",sideOffset:l=4,onEscapeKeyDown:g,onPointerDownOutside:s,onFocusOutside:t,onInteractOutside:x,...m},R)=>{let n=C("ComboboxContent"),f=Te(R,n.contentRef);return qe({enabled:n.open,onEscapeKeyDown:u=>{g?.(u),u.defaultPrevented||n.onOpenChange(!1)},onInteractOutside:x,onPointerDownOutside:u=>{s?.(u),u.defaultPrevented||n.onOpenChange(!1)},onFocusOutside:u=>{t?.(u),u.defaultPrevented||n.onOpenChange(!1)}},[n.contentRef,n.inputRef]),a||n.open?Fe(Ve,{component:"combobox",role:"listbox",id:n.contentId,"aria-multiselectable":n.multiple?!0:void 0,"aria-busy":n.loading?!0:void 0,"data-state":n.open?"open":"closed","data-loading":n.loading?"":void 0,"data-multiple":n.multiple?"":void 0,side:c,align:e,sideOffset:l,...m,...Le("combobox","content",m.className),ref:f,onMouseDown:Ne(m.onMouseDown,u=>u.preventDefault())}):null});Y.displayName="ComboboxContent";import*as b from"react";import{useComposedRefs as We}from"../utils/composeRefs.js";import{skdxPart as Ke}from"../utils/part.js";import{composeEventHandlers as Z,Primitive as _e}from"../utils/primitive.js";import{jsx as $e}from"react/jsx-runtime";var j=b.forwardRef(({value:a,disabled:c,textValue:e,...l},g)=>{let s=C("ComboboxItem"),t=b.useId(),x=b.useRef(null),m=We(g,x),R=s.isSelected(a),n=s.activeId===t,[f,u]=b.useState(e??null);b.useLayoutEffect(()=>{let I=e??x.current?.textContent;I!=null&&I!==f&&u(I)});let y=f===null||s.matchesFilter(f);b.useEffect(()=>{if(y)return s.registerItem(t,{value:a,text:f??""}),()=>s.unregisterItem(t)},[t,y,a,f]);let A=()=>{c||(s.selectItem(a,f??a),s.inputRef.current?.focus())};return y?$e(_e.div,{role:"option",id:t,"data-value":a,"aria-selected":R,"data-state":R?"checked":"unchecked","data-highlighted":n?"":void 0,"data-disabled":c?"":void 0,...l,...Ke("combobox","item",l.className),ref:m,onClick:Z(l.onClick,A),onPointerEnter:Z(l.onPointerEnter,()=>{c||s.setActiveId(t)})}):null});j.displayName="ComboboxItem";import*as ee from"react";import{skdxPart as ze}from"../utils/part.js";import{Primitive as Ge}from"../utils/primitive.js";import{jsx as Ue}from"react/jsx-runtime";var te=ee.forwardRef((a,c)=>C("ComboboxEmpty").itemCount===0?Ue(Ge.div,{role:"presentation",...a,...ze("combobox","empty",a.className),ref:c}):null);te.displayName="ComboboxEmpty";export{we as Combobox,Y as ComboboxContent,te as ComboboxEmpty,J as ComboboxInput,j as ComboboxItem,Q as ComboboxPortal,Ee as ComboboxProvider,H as OPTION_SELECTOR,ve as defaultGetResultCountLabel,C as useComboboxContext};
+import*as n from"react";import{createSafeContext as Vo}from"../utils/createContext.js";import{formValidityHandle as Go,useFormReset as So}from"../utils/formControl.js";import{MirroredValues as Ao}from"../utils/hiddenInput.js";import{announce as No}from"../utils/liveAnnouncer.js";import{PopperRoot as Fo}from"../utils/popper.js";import{filterKeeps as Bo,rankByScore as qo,sortByOrder as Ko}from"../utils/scoredFilter.js";import{useControllableState as Ie}from"../utils/useControllableState.js";import{useOpenChangeComplete as Wo}from"../utils/useOpenChangeComplete.js";import{useSelection as Uo}from"../utils/useSelection.js";import*as fe from"react";import{useComposedRefs as to}from"../utils/composeRefs.js";import{skdxPart as no}from"../utils/part.js";import{PopperContent as ro}from"../utils/popper.js";import{composeEventHandlers as ao}from"../utils/primitive.js";import{useDismiss as io}from"../utils/useDismiss.js";import{jsx as lo}from"react/jsx-runtime";var _=fe.forwardRef(({forceMount:t,side:a="bottom",align:e="start",sideOffset:l=4,onEscapeKeyDown:b,onPointerDownOutside:s,onFocusOutside:p,onInteractOutside:x,...o},u)=>{let m=f("ComboboxContent"),h=to(u,m.contentRef);return io({enabled:m.open,onEscapeKeyDown:c=>{b?.(c),c.defaultPrevented||m.onOpenChange(!1)},onInteractOutside:x,onPointerDownOutside:c=>{s?.(c),c.defaultPrevented||m.onOpenChange(!1)},onFocusOutside:c=>{p?.(c),c.defaultPrevented||m.onOpenChange(!1)}},[m.contentRef,m.inputRef,m.triggerRef]),t||m.open?lo(ro,{component:"combobox",role:"listbox",id:m.contentId,"aria-multiselectable":m.multiple?!0:void 0,"aria-busy":m.loading?!0:void 0,"data-state":m.open?"open":"closed","data-loading":m.loading?"":void 0,"data-multiple":m.multiple?"":void 0,side:a,align:e,sideOffset:l,...o,...no("combobox","content",o.className),ref:h,onMouseDown:ao(o.onMouseDown,c=>c.preventDefault())}):null});_.displayName="ComboboxContent";import*as de from"react";import{skdxPart as so}from"../utils/part.js";import{Primitive as mo}from"../utils/primitive.js";import{jsx as uo}from"react/jsx-runtime";var $=de.forwardRef((t,a)=>f("ComboboxEmpty").itemCount===0?uo(mo.div,{role:"presentation",...t,...so("combobox","empty",t.className),ref:a}):null);$.displayName="ComboboxEmpty";import*as N from"react";import{createSafeContext as co}from"../utils/createContext.js";import{skdxPart as bo}from"../utils/part.js";import{Primitive as po}from"../utils/primitive.js";import{jsx as xe}from"react/jsx-runtime";var[fo,Ce]=co("ComboboxGroup"),z=N.forwardRef((t,a)=>{let e=N.useId();return xe(fo,{labelId:e,children:xe(po.div,{role:"group","aria-labelledby":e,...t,...bo("combobox","group",t.className),ref:a})})});z.displayName="ComboboxGroup";import*as ge from"react";import{skdxPart as xo}from"../utils/part.js";import{Primitive as Co}from"../utils/primitive.js";import{jsx as go}from"react/jsx-runtime";var Y=ge.forwardRef((t,a)=>{let e=Ce("ComboboxGroupLabel");return go(Co.div,{id:e.labelId,...t,...xo("combobox","label",t.className),ref:a})});Y.displayName="ComboboxGroupLabel";import*as he from"react";import{useComposedRefs as Ro}from"../utils/composeRefs.js";import{skdxPart as ho}from"../utils/part.js";import{PopperAnchor as yo}from"../utils/popper.js";import{composeEventHandlers as L,Primitive as vo}from"../utils/primitive.js";import{sortByOrder as Io}from"../utils/scoredFilter.js";import{jsx as Re}from"react/jsx-runtime";var Oo=new Set(["Home","End","PageUp","PageDown"]),J=he.forwardRef((t,a)=>{let e=f("ComboboxInput"),l=Ro(a,e.inputRef),b=o=>{o&&(e.setActiveId(o.id,"keyboard"),o.scrollIntoView?.({block:"nearest"}))},s=()=>{let o=e.contentRef.current;return o?Io(Array.from(o.querySelectorAll(Q)),e.itemOrder):[]},p=o=>{let u=s();if(u.length===0)return;let m=u.findIndex(k=>k.id===e.activeId),h=m===-1?o===1?-1:0:m,c=e.loop?(h+o+u.length)%u.length:Math.min(u.length-1,Math.max(0,h+o));b(u[c])},x=()=>{if(!e.activeId)return;let o=e.getItem(e.activeId);o&&e.selectItem(o.value,o.text||o.value,"keyboard")};return Re(yo,{asChild:!0,children:Re(vo.input,{type:"text",role:"combobox","aria-expanded":e.open,"aria-controls":e.contentId,"aria-autocomplete":"list","aria-activedescendant":e.activeId??void 0,autoComplete:"off",readOnly:e.readOnly,disabled:e.disabled,"data-disabled":e.disabled?"":void 0,"aria-invalid":e.invalid?!0:void 0,"aria-required":e.required?!0:void 0,"aria-readonly":e.readOnly?!0:void 0,"aria-busy":e.loading?!0:void 0,"data-invalid":e.invalid?"":void 0,"data-readonly":e.readOnly?"":void 0,"data-loading":e.loading?"":void 0,"data-multiple":e.multiple?"":void 0,...t,...ho("combobox","input",t.className),ref:l,value:e.inputValue,onChange:L(t.onChange,o=>{e.onInputValueChange(o.target.value),e.open||e.onOpenChange(!0)}),onClick:L(t.onClick,()=>{e.openOn==="type"||e.readOnly||e.open||e.onOpenChange(!0)}),onFocus:L(t.onFocus,()=>{e.openOn!=="focus"||e.readOnly||e.open||e.onOpenChange(!0)}),onBlur:L(t.onBlur,o=>{let u=o.relatedTarget;u&&(u===o.currentTarget||e.contentRef.current?.contains(u))||e.reconcileDraftText()}),onKeyDown:L(t.onKeyDown,o=>{if(o.altKey&&o.key==="ArrowDown")o.preventDefault(),e.open||e.onOpenChange(!0);else if(o.altKey&&o.key==="ArrowUp")o.preventDefault(),e.activeId&&x(),e.open&&e.onOpenChange(!1);else if(o.key==="ArrowDown")o.preventDefault(),e.open?p(1):e.openWithHighlight("first");else if(o.key==="ArrowUp")o.preventDefault(),e.open?p(-1):e.openWithHighlight("last");else if(Oo.has(o.key)&&e.open){o.preventDefault();let u=s(),m=o.key==="Home"||o.key==="PageUp";b(m?u[0]:u[u.length-1])}else o.key==="Enter"?e.activeId?(o.preventDefault(),x()):e.allowCustomValue&&e.inputValue!==""?(o.preventDefault(),e.selectItem(e.inputValue,e.inputValue,"keyboard")):e.open&&e.onOpenChange(!1):o.key==="Escape"&&e.open&&!e.contentRef.current&&(o.preventDefault(),e.onOpenChange(!1))})})})});J.displayName="ComboboxInput";import*as P from"react";import{useComposedRefs as Po}from"../utils/composeRefs.js";import{skdxPart as ko}from"../utils/part.js";import{composeEventHandlers as ye,Primitive as Eo}from"../utils/primitive.js";import{useOptionEntry as wo}from"../utils/useOptionCollection.js";import{jsx as To}from"react/jsx-runtime";var X=P.forwardRef(({value:t,disabled:a,textValue:e,...l},b)=>{let s=f("ComboboxItem"),p=P.useId(),x=P.useRef(null),o=Po(b,x),u=s.isSelected(t),m=s.activeId===p,h=s.itemOrder?.get(p),{text:c,visible:k}=wo({id:p,value:t,textValue:e,itemRef:x,matchesFilter:s.matchesFilter,registerItem:s.registerItem,unregisterItem:s.unregisterItem}),G=()=>{a||(s.selectItem(t,c??t,"pointer"),s.inputRef.current?.focus())};return k?To(Eo.div,{role:"option",id:p,"data-value":t,"aria-selected":u,"data-state":u?"checked":"unchecked","data-highlighted":m?"":void 0,"aria-disabled":a||void 0,"data-disabled":a?"":void 0,...l,...ko("combobox","item",l.className),ref:o,onClick:ye(l.onClick,G),onPointerEnter:ye(l.onPointerEnter,()=>{a||s.setActiveId(p,"pointer")}),style:h!==void 0?{order:h,...l.style}:l.style}):null});X.displayName="ComboboxItem";import{Portal as Ho}from"../utils/portal.js";import{jsx as Do}from"react/jsx-runtime";var Z=({forceMount:t,children:a,...e})=>{let l=f("ComboboxPortal");return t||l.open?Do(Ho,{...e,children:a}):null};Z.displayName="ComboboxPortal";import{Fragment as Lo,jsx as V,jsxs as j}from"react/jsx-runtime";var Mo=t=>"options"in t;function ee(t,a){return t.toLowerCase().includes(a.trim().toLowerCase())}var ve=({options:t,renderOption:a,placeholder:e,ariaLabel:l,passThrough:b})=>{let s=f("Combobox"),p=l??e,x=o=>V(X,{value:o.value,disabled:o.disabled,textValue:o.label,children:a?a(o,{selected:s.isSelected(o.value)}):o.label??o.value},o.value);return j(Lo,{children:[V(J,{...b,"aria-label":p,placeholder:e}),V(Z,{children:j(_,{"aria-label":p,children:[t.map(o=>Mo(o)?j(z,{children:[V(Y,{children:o.label}),o.options.map(x)]},o.label):x(o)),V($,{children:"No results"})]})})]})};import{jsx as oe,jsxs as Jo}from"react/jsx-runtime";var Q='[role="option"]:not([data-disabled])';function _o(t,a){let e=t.querySelector('[data-part="viewport"]')??t;if(e===a||!e.contains(a))return;let l=e.getBoundingClientRect(),b=a.getBoundingClientRect();e.scrollTop+=b.top-l.top-(l.height-b.height)/2}function $o(t){return`${t} result${t===1?"":"s"} available`}var[zo,f]=Vo("Combobox"),Yo=n.forwardRef(function({children:a,value:e,defaultValue:l,onValueChange:b,multiple:s=!1,allowCustomValue:p=!1,filter:x,autoHighlight:o=!1,loop:u=!0,openOn:m="type",onHighlightChange:h,loading:c=!1,inputValue:k,defaultInputValue:G="",onInputValueChange:we,open:Te,defaultOpen:He=!1,onOpenChange:De,onOpenChangeComplete:Me,invalid:Le=!1,readOnly:Ve=!1,disabled:te=!1,getResultCountLabel:ne=$o,name:Ge,form:Se,required:re=!1,options:ae,renderOption:Ae,placeholder:Ne,"aria-label":Fe,...Be},qe){let O=x??(ae?ee:"manual"),ie=n.useRef(null),Ke=n.useRef(null),le=n.useRef(null),E=n.useRef(null),[v,w]=n.useState(null),[y,se]=n.useState(()=>new Map),F=n.useRef(null),B=n.useRef("programmatic"),q=n.useRef(null),{selectedValues:C,isSelected:We,selectItem:me,setSelection:ue}=Uo({value:e,defaultValue:l,onValueChange:r=>b?.({value:r.value,previousValue:q.current,reason:B.current,selectedValue:r.selectedValue}),multiple:s,label:"Combobox"}),ce=n.useCallback((r,i)=>{q.current=C.length===0?null:C,B.current=i,me(r)},[me,C]),K=n.useCallback((r,i)=>{q.current=C.length===0?null:C,B.current=i,ue(r)},[ue,C]),[T="",R]=Ie({prop:k,defaultProp:G,onChange:we}),[g=!1,H]=Ie({prop:Te,defaultProp:He,onChange:De});Wo(g,E,Me);let[Ue,_e]=n.useState(g);g!==Ue&&(_e(g),g||w(null));let W=n.useMemo(()=>O==="manual"?null:qo([...y.keys()],r=>{let i=y.get(r);if(!i)return null;let d=O(i.text,T);return typeof d=="number"?d:null}),[O,T,y]),D=n.useCallback(r=>Ko(Array.from(r?.querySelectorAll(Q)??[]),W),[W]);n.useEffect(()=>{if(!g)return;let r=requestAnimationFrame(()=>{let i=F.current;if(F.current=null,!i)return;let d=E.current,I=D(d);if(!d||I.length===0)return;let M=i==="last"?I[I.length-1]:I[0];w(oo=>oo??M.id),_o(d,M)});return()=>cancelAnimationFrame(r)},[g,D]);let S=y.size,be=n.useRef("auto"),pe=n.useRef(null),$e=n.useCallback((r,i="auto")=>{be.current=i,w(r)},[]),A=v?y.get(v)?.value??null:null;n.useEffect(()=>{let r=pe.current;A!==r&&(pe.current=A,h?.({value:A,previousValue:r,reason:be.current}))},[A,h]),n.useLayoutEffect(()=>{if(v===null)return;let r=D(E.current);r.some(i=>i.id===v)||w(r[0]?.id??null)}),n.useEffect(()=>{if(!o||!g||v!==null)return;let r=requestAnimationFrame(()=>{let i=D(E.current)[0];i&&w(i.id)});return()=>cancelAnimationFrame(r)},[o,g,v,S,D]),n.useEffect(()=>{!g||c||No(ne(S))},[g,c,S,ne]);let ze=n.useCallback(r=>{F.current=r,H(!0)},[H]),Ye=n.useCallback((r,i)=>{se(d=>{let I=d.get(r);if(I?.value===i.value&&I.text===i.text)return d;let M=new Map(d);return M.set(r,i),M})},[]),Je=n.useCallback(r=>{se(i=>{if(!i.has(r))return i;let d=new Map(i);return d.delete(r),d})},[]),Qe=n.useCallback(r=>y.get(r),[y]),Xe=n.useCallback(r=>O==="manual"||Bo(O(r,T)),[O,T]),U=n.useRef(null),Ze=n.useCallback((r,i,d)=>{if(ce(r,d),!s){U.current=i,R(i),H(!1);return}R("")},[ce,s,R,H]),je=n.useCallback(()=>{C.length>0&&K([],"pointer"),U.current=null,R("")},[C.length,K,R]),eo=n.useCallback(()=>{if(p)return;let r=s?void 0:C[0];if(r===void 0){R("");return}for(let i of y.values())if(i.value===r){R(i.text||i.value);return}R(U.current??r)},[p,s,C,y,R]);return n.useImperativeHandle(qe,()=>Go(le),[]),So(ie,()=>{l!==void 0&&K(l,"programmatic"),R(G)}),oe(Fo,{children:Jo(zo,{inputRef:ie,triggerRef:Ke,contentRef:E,contentId:n.useId(),multiple:s,selectedValues:C,isSelected:We,selectItem:Ze,clear:je,inputValue:T,onInputValueChange:R,open:g,onOpenChange:H,activeId:v,itemOrder:W,setActiveId:$e,openWithHighlight:ze,loop:u,openOn:m,reconcileDraftText:eo,itemCount:S,registerItem:Ye,unregisterItem:Je,getItem:Qe,matchesFilter:Xe,invalid:Le,readOnly:Ve,disabled:te,loading:c,allowCustomValue:p,required:re,children:[a??oe(ve,{options:ae??[],renderOption:Ae,placeholder:Ne,ariaLabel:Fe,passThrough:Be}),oe(Ao,{name:Ge,values:C,required:re,disabled:te,form:Se,singleValued:!s,controlRef:le})]})})});Yo.displayName="Combobox";import*as Pe from"react";import{useComposedRefs as Qo}from"../utils/composeRefs.js";import{skdxPart as Xo}from"../utils/part.js";import{composeEventHandlers as Oe,Primitive as Zo}from"../utils/primitive.js";import{jsx as et}from"react/jsx-runtime";var jo=Pe.forwardRef((t,a)=>{let e=f("ComboboxTrigger"),l=Qo(a,e.triggerRef);return et(Zo.button,{type:"button",tabIndex:-1,"aria-expanded":e.open,"aria-controls":e.open?e.contentId:void 0,disabled:e.disabled,"data-disabled":e.disabled?"":void 0,"data-readonly":e.readOnly?"":void 0,"data-state":e.open?"open":"closed",...t,...Xo("combobox","trigger",t.className),ref:l,onMouseDown:Oe(t.onMouseDown,b=>b.preventDefault()),onClick:Oe(t.onClick,()=>{e.readOnly||(e.onOpenChange(!e.open),e.inputRef.current?.focus())})})});jo.displayName="ComboboxTrigger";import*as Ee from"react";import{skdxPart as ot}from"../utils/part.js";import{composeEventHandlers as ke,Primitive as tt}from"../utils/primitive.js";import{jsx as rt}from"react/jsx-runtime";var nt=Ee.forwardRef((t,a)=>{let e=f("ComboboxClear"),l=e.selectedValues.length===0&&e.inputValue==="";return rt(tt.button,{type:"button",tabIndex:-1,disabled:e.disabled||e.readOnly||l,"data-disabled":e.disabled?"":void 0,"data-readonly":e.readOnly?"":void 0,...t,...ot("combobox","clear",t.className),ref:a,onMouseDown:ke(t.onMouseDown,b=>b.preventDefault()),onClick:ke(t.onClick,()=>{e.clear(),e.inputRef.current?.focus()})})});nt.displayName="ComboboxClear";export{Yo as Combobox,ve as ComboboxAnatomy,nt as ComboboxClear,_ as ComboboxContent,$ as ComboboxEmpty,z as ComboboxGroup,Y as ComboboxGroupLabel,fo as ComboboxGroupProvider,J as ComboboxInput,X as ComboboxItem,Z as ComboboxPortal,zo as ComboboxProvider,jo as ComboboxTrigger,Q as OPTION_SELECTOR,$o as defaultGetResultCountLabel,ee as defaultOptionsFilter,f as useComboboxContext,Ce as useComboboxGroupContext};

package/dist/combobox/ComboboxAnatomy.d.cts

@@ -0,0 +1,18 @@
+import type * as React from 'react';
+import type { PassThroughProps } from '../utils/passThrough.cjs';
+import type { ComboboxOption, ComboboxOptionOrGroup } from './types.cjs';
+/** Case-insensitive substring match — the default filter for a derived `options` combobox or autocomplete. */
+export declare function defaultOptionsFilter(text: string, inputValue: string): boolean;
+/**
+ * Renders Combobox anatomy from `options`: input, portal, and listbox.
+ * @internal
+ */
+export declare const ComboboxAnatomy: ({ options, renderOption, placeholder, ariaLabel, passThrough, }: {
+    options: ComboboxOptionOrGroup[];
+    renderOption?: (option: ComboboxOption, state: {
+        selected: boolean;
+    }) => React.ReactNode;
+    placeholder?: string;
+    ariaLabel?: string;
+    passThrough?: PassThroughProps;
+}) => React.JSX.Element;

package/dist/combobox/ComboboxAnatomy.d.ts

@@ -0,0 +1,18 @@
+import type * as React from 'react';
+import type { PassThroughProps } from '../utils/passThrough.js';
+import type { ComboboxOption, ComboboxOptionOrGroup } from './types.js';
+/** Case-insensitive substring match — the default filter for a derived `options` combobox or autocomplete. */
+export declare function defaultOptionsFilter(text: string, inputValue: string): boolean;
+/**
+ * Renders Combobox anatomy from `options`: input, portal, and listbox.
+ * @internal
+ */
+export declare const ComboboxAnatomy: ({ options, renderOption, placeholder, ariaLabel, passThrough, }: {
+    options: ComboboxOptionOrGroup[];
+    renderOption?: (option: ComboboxOption, state: {
+        selected: boolean;
+    }) => React.ReactNode;
+    placeholder?: string;
+    ariaLabel?: string;
+    passThrough?: PassThroughProps;
+}) => React.JSX.Element;

package/dist/combobox/ComboboxClear.d.cts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { ComboboxClearProps } from './types.cjs';
+/**
+ * Clears selection and draft text. Disabled when empty or root is `disabled`
+ * / `readOnly`. `tabIndex={-1}` keeps focus on input for whole interaction.
+ * Requires `aria-label`.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxClear aria-label="Clear selection">✕</ComboboxClear>
+ * ```
+ */
+export declare const ComboboxClear: React.ForwardRefExoticComponent<Omit<ComboboxClearProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/combobox/ComboboxClear.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { ComboboxClearProps } from './types.js';
+/**
+ * Clears selection and draft text. Disabled when empty or root is `disabled`
+ * / `readOnly`. `tabIndex={-1}` keeps focus on input for whole interaction.
+ * Requires `aria-label`.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxClear aria-label="Clear selection">✕</ComboboxClear>
+ * ```
+ */
+export declare const ComboboxClear: React.ForwardRefExoticComponent<Omit<ComboboxClearProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/combobox/ComboboxEmpty.d.cts

@@ -1,11 +1,7 @@
 import * as React from 'react';
 import type { ComboboxEmptyProps } from './types.cjs';
 /**
- * Fallback shown in place of the item list when no `ComboboxItem`s are
- * currently rendered — because the consumer's filtered results are empty, or
- * because the root's `filter` predicate rejected every item. Renders a
- * `<div role="presentation">`; renders nothing while at least one item is
- * registered.
+ * Fallback shown when no ComboboxItems are registered. Renders nothing while items exist.
  *
  * @example
  * ```tsx

package/dist/combobox/ComboboxEmpty.d.ts

@@ -1,11 +1,7 @@
 import * as React from 'react';
 import type { ComboboxEmptyProps } from './types.js';
 /**
- * Fallback shown in place of the item list when no `ComboboxItem`s are
- * currently rendered — because the consumer's filtered results are empty, or
- * because the root's `filter` predicate rejected every item. Renders a
- * `<div role="presentation">`; renders nothing while at least one item is
- * registered.
+ * Fallback shown when no ComboboxItems are registered. Renders nothing while items exist.
  *
  * @example
  * ```tsx

package/dist/combobox/ComboboxGroup.d.cts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { ComboboxGroupContextValue, ComboboxGroupProps } from './types.cjs';
+export declare const ComboboxGroupProvider: {
+    (props: ComboboxGroupContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useComboboxGroupContext: (consumerName: string) => ComboboxGroupContextValue;
+/**
+ * Groups related {@link ComboboxItem}s under `ComboboxGroupLabel` — automatic wiring with `aria-labelledby`.
+ *
+ * Critical for filtering listboxes where groups reorder/empty on every keystroke — named group is the only structure screen readers can hold on to.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxGroup>
+ *   <ComboboxGroupLabel>Frameworks</ComboboxGroupLabel>
+ *   <ComboboxItem value="react">React</ComboboxItem>
+ * </ComboboxGroup>
+ * ```
+ */
+export declare const ComboboxGroup: React.ForwardRefExoticComponent<Omit<ComboboxGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/combobox/ComboboxGroup.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { ComboboxGroupContextValue, ComboboxGroupProps } from './types.js';
+export declare const ComboboxGroupProvider: {
+    (props: ComboboxGroupContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useComboboxGroupContext: (consumerName: string) => ComboboxGroupContextValue;
+/**
+ * Groups related {@link ComboboxItem}s under `ComboboxGroupLabel` — automatic wiring with `aria-labelledby`.
+ *
+ * Critical for filtering listboxes where groups reorder/empty on every keystroke — named group is the only structure screen readers can hold on to.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxGroup>
+ *   <ComboboxGroupLabel>Frameworks</ComboboxGroupLabel>
+ *   <ComboboxItem value="react">React</ComboboxItem>
+ * </ComboboxGroup>
+ * ```
+ */
+export declare const ComboboxGroup: React.ForwardRefExoticComponent<Omit<ComboboxGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/combobox/ComboboxGroupLabel.d.cts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { ComboboxGroupLabelProps } from './types.cjs';
+/**
+ * Heading for a ComboboxGroup. Provides the id the group's `aria-labelledby` points to.
+ * Must be rendered inside a ComboboxGroup.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxGroup>
+ *   <ComboboxGroupLabel>Frameworks</ComboboxGroupLabel>
+ *   <ComboboxItem value="react">React</ComboboxItem>
+ * </ComboboxGroup>
+ * ```
+ */
+export declare const ComboboxGroupLabel: React.ForwardRefExoticComponent<Omit<ComboboxGroupLabelProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/combobox/ComboboxGroupLabel.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { ComboboxGroupLabelProps } from './types.js';
+/**
+ * Heading for a ComboboxGroup. Provides the id the group's `aria-labelledby` points to.
+ * Must be rendered inside a ComboboxGroup.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxGroup>
+ *   <ComboboxGroupLabel>Frameworks</ComboboxGroupLabel>
+ *   <ComboboxItem value="react">React</ComboboxItem>
+ * </ComboboxGroup>
+ * ```
+ */
+export declare const ComboboxGroupLabel: React.ForwardRefExoticComponent<Omit<ComboboxGroupLabelProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/combobox/ComboboxInput.d.cts

@@ -1,24 +1,10 @@
 import * as React from 'react';
 import type { ComboboxInputProps } from './types.cjs';
 /**
- * Text field that drives a {@link Combobox}'s filtering and keeps real DOM
- * focus for the whole interaction, and doubles as the popper anchor the
- * listbox positions against. Renders an `<input type="text" role="combobox">`
- * with `aria-expanded`, `aria-controls` pointing at the content,
- * `aria-autocomplete="list"`, `aria-activedescendant` tracking the
- * virtually-focused option, `autoComplete="off"`,
- * `aria-invalid`/`data-invalid`, `aria-required`, the native `readOnly` attribute with
- * `aria-readonly`/`data-readonly`, and `aria-busy`/`data-loading` from the
- * root's `invalid`/`readOnly`/`loading` props.
+ * Text field with real DOM focus and keyboard navigation. Renders input
+ * with role="combobox" and required ARIA attributes.
  *
- * Typing opens the listbox and updates the draft text; Arrow Down/Up open the
- * listbox (or move the highlight by one option when already open); Enter
- * commits the highlighted option — or, with `allowCustomValue` and nothing
- * highlighted, the draft text itself; Escape closes the listbox.
- *
- * @example
- * ```tsx
- * <ComboboxInput placeholder="Search a fruit…" />
- * ```
+ * Must be given an accessible name via `<label>`, `aria-label`, or
+ * `aria-labelledby` — role="combobox" takes no name from content.
  */
 export declare const ComboboxInput: React.ForwardRefExoticComponent<Omit<ComboboxInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/combobox/ComboboxInput.d.ts

@@ -1,24 +1,10 @@
 import * as React from 'react';
 import type { ComboboxInputProps } from './types.js';
 /**
- * Text field that drives a {@link Combobox}'s filtering and keeps real DOM
- * focus for the whole interaction, and doubles as the popper anchor the
- * listbox positions against. Renders an `<input type="text" role="combobox">`
- * with `aria-expanded`, `aria-controls` pointing at the content,
- * `aria-autocomplete="list"`, `aria-activedescendant` tracking the
- * virtually-focused option, `autoComplete="off"`,
- * `aria-invalid`/`data-invalid`, `aria-required`, the native `readOnly` attribute with
- * `aria-readonly`/`data-readonly`, and `aria-busy`/`data-loading` from the
- * root's `invalid`/`readOnly`/`loading` props.
+ * Text field with real DOM focus and keyboard navigation. Renders input
+ * with role="combobox" and required ARIA attributes.
  *
- * Typing opens the listbox and updates the draft text; Arrow Down/Up open the
- * listbox (or move the highlight by one option when already open); Enter
- * commits the highlighted option — or, with `allowCustomValue` and nothing
- * highlighted, the draft text itself; Escape closes the listbox.
- *
- * @example
- * ```tsx
- * <ComboboxInput placeholder="Search a fruit…" />
- * ```
+ * Must be given an accessible name via `<label>`, `aria-label`, or
+ * `aria-labelledby` — role="combobox" takes no name from content.
  */
 export declare const ComboboxInput: React.ForwardRefExoticComponent<Omit<ComboboxInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/combobox/ComboboxItem.d.cts

@@ -4,7 +4,8 @@ import type { ComboboxItemProps } from './types.cjs';
  * A single selectable option within {@link ComboboxContent}. Renders a
  * `<div role="option">` with `data-value`, `aria-selected`, `data-state`
  * (`"checked"` | `"unchecked"`), `data-highlighted` (virtual focus, mirrored
- * by the input's `aria-activedescendant`), and `data-disabled`. Registers
+ * by the input's `aria-activedescendant`), and `aria-disabled`/
+ * `data-disabled`. Registers
  * itself — and its text — with the root, so `ComboboxEmpty` knows when the
  * list is empty and Enter can commit the highlighted option. Click selects the
  * item, updates the input's draft text to its text, closes the listbox, and

package/dist/combobox/ComboboxItem.d.ts

@@ -4,7 +4,8 @@ import type { ComboboxItemProps } from './types.js';
  * A single selectable option within {@link ComboboxContent}. Renders a
  * `<div role="option">` with `data-value`, `aria-selected`, `data-state`
  * (`"checked"` | `"unchecked"`), `data-highlighted` (virtual focus, mirrored
- * by the input's `aria-activedescendant`), and `data-disabled`. Registers
+ * by the input's `aria-activedescendant`), and `aria-disabled`/
+ * `data-disabled`. Registers
  * itself — and its text — with the root, so `ComboboxEmpty` knows when the
  * list is empty and Enter can commit the highlighted option. Click selects the
  * item, updates the input's draft text to its text, closes the listbox, and

package/dist/combobox/ComboboxPortal.d.cts

@@ -1,9 +1,7 @@
 import type { ComboboxPortalProps } from './types.cjs';
 /**
- * Teleports its children (typically {@link ComboboxContent}) to
- * `document.body` (or `container`, via `PortalProps`) while the
- * {@link Combobox}'s listbox is open, so it escapes clipping/overflow from
- * ancestors. Renders nothing while closed unless `forceMount` is set.
+ * Teleports its children to `document.body` or `container`, escaping
+ * clipping/overflow while open. Renders nothing while closed unless `forceMount` is set.
  *
  * @example
  * ```tsx

package/dist/combobox/ComboboxPortal.d.ts

@@ -1,9 +1,7 @@
 import type { ComboboxPortalProps } from './types.js';
 /**
- * Teleports its children (typically {@link ComboboxContent}) to
- * `document.body` (or `container`, via `PortalProps`) while the
- * {@link Combobox}'s listbox is open, so it escapes clipping/overflow from
- * ancestors. Renders nothing while closed unless `forceMount` is set.
+ * Teleports its children to `document.body` or `container`, escaping
+ * clipping/overflow while open. Renders nothing while closed unless `forceMount` is set.
  *
  * @example
  * ```tsx

package/dist/combobox/ComboboxTrigger.d.cts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { ComboboxTriggerProps } from './types.cjs';
+/**
+ * Optional toggle button for the listbox ("▾" affordance). Not a Tab stop
+ * or focus destination — the combobox is a virtual-focus widget with real
+ * DOM focus on the input. Requires an `aria-label`.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxTrigger aria-label="Show options">▾</ComboboxTrigger>
+ * ```
+ */
+export declare const ComboboxTrigger: React.ForwardRefExoticComponent<Omit<ComboboxTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/combobox/ComboboxTrigger.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { ComboboxTriggerProps } from './types.js';
+/**
+ * Optional toggle button for the listbox ("▾" affordance). Not a Tab stop
+ * or focus destination — the combobox is a virtual-focus widget with real
+ * DOM focus on the input. Requires an `aria-label`.
+ *
+ * @example
+ * ```tsx
+ * <ComboboxTrigger aria-label="Show options">▾</ComboboxTrigger>
+ * ```
+ */
+export declare const ComboboxTrigger: React.ForwardRefExoticComponent<Omit<ComboboxTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/combobox/index.d.cts

@@ -1,7 +1,3 @@
 export * from './Combobox.cjs';
-export { ComboboxInput } from './ComboboxInput.cjs';
-export { ComboboxPortal } from './ComboboxPortal.cjs';
-export { ComboboxContent } from './ComboboxContent.cjs';
-export { ComboboxItem } from './ComboboxItem.cjs';
-export { ComboboxEmpty } from './ComboboxEmpty.cjs';
-export type { ComboboxFilter, ComboboxProps, ComboboxHandle, ComboboxInputProps, ComboboxPortalProps, ComboboxContentProps, ComboboxItemProps, ComboboxEmptyProps, } from './types.cjs';
+export type { ComboboxFilter, ComboboxOption, ComboboxOptionGroup, ComboboxOptionOrGroup, ComboboxValueChangeDetail, ComboboxValueChangeReason, ComboboxOpenOn, ComboboxHighlightReason, ComboboxHighlightChangeDetail, ComboboxProps, ComboboxHandle, } from './types.cjs';
+export { defaultOptionsFilter } from './ComboboxAnatomy.cjs';

package/dist/combobox/index.d.ts

@@ -1,7 +1,3 @@
 export * from './Combobox.js';
-export { ComboboxInput } from './ComboboxInput.js';
-export { ComboboxPortal } from './ComboboxPortal.js';
-export { ComboboxContent } from './ComboboxContent.js';
-export { ComboboxItem } from './ComboboxItem.js';
-export { ComboboxEmpty } from './ComboboxEmpty.js';
-export type { ComboboxFilter, ComboboxProps, ComboboxHandle, ComboboxInputProps, ComboboxPortalProps, ComboboxContentProps, ComboboxItemProps, ComboboxEmptyProps, } from './types.js';
+export type { ComboboxFilter, ComboboxOption, ComboboxOptionGroup, ComboboxOptionOrGroup, ComboboxValueChangeDetail, ComboboxValueChangeReason, ComboboxOpenOn, ComboboxHighlightReason, ComboboxHighlightChangeDetail, ComboboxProps, ComboboxHandle, } from './types.js';
+export { defaultOptionsFilter } from './ComboboxAnatomy.js';

package/dist/combobox/primitives.d.cts

@@ -0,0 +1,29 @@
+/**
+ * Advanced primitives for `Combobox` — the parts the recipe composes.
+ *
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxPortal } from '@skdx/react/primitives/combobox';
+ *
+ * <Combobox>
+ *   <ComboboxInput aria-label="Fruit" placeholder="Search a fruit…" />
+ *   <ComboboxPortal>
+ *     <ComboboxContent aria-label="Fruit">
+ *       <ComboboxItem value="apple">Apple</ComboboxItem>
+ *       <ComboboxEmpty>No results</ComboboxEmpty>
+ *     </ComboboxContent>
+ *   </ComboboxPortal>
+ * </Combobox>
+ * ```
+ */
+export { Combobox } from './Combobox.cjs';
+export { ComboboxInput } from './ComboboxInput.cjs';
+export { ComboboxTrigger } from './ComboboxTrigger.cjs';
+export { ComboboxClear } from './ComboboxClear.cjs';
+export { ComboboxPortal } from './ComboboxPortal.cjs';
+export { ComboboxContent } from './ComboboxContent.cjs';
+export { ComboboxItem } from './ComboboxItem.cjs';
+export { ComboboxEmpty } from './ComboboxEmpty.cjs';
+export { ComboboxGroup } from './ComboboxGroup.cjs';
+export { ComboboxGroupLabel } from './ComboboxGroupLabel.cjs';
+export type { ComboboxProps, ComboboxInputProps, ComboboxTriggerProps, ComboboxClearProps, ComboboxPortalProps, ComboboxContentProps, ComboboxItemProps, ComboboxEmptyProps, ComboboxGroupProps, ComboboxGroupLabelProps, } from './types.cjs';