@skdx/react 0.26.0 → 0.28.0

package/dist/tree/Tree.js

@@ -1 +1 @@
-import*as s from"react";import{createSafeContext as be}from"../utils/createContext.js";import{directionalKey as Ie,useDirection as Se}from"../utils/direction.js";import{announce as Me}from"../utils/liveAnnouncer.js";import{skdxPart as we}from"../utils/part.js";import{composeEventHandlers as ne,Primitive as Ae}from"../utils/primitive.js";import{useControllableState as oe}from"../utils/useControllableState.js";import{useRovingFocus as Ne,useRovingTabStop as ve}from"../utils/useRovingFocus.js";import{isTypeaheadKey as Le,useTypeahead as He}from"../utils/useTypeahead.js";import{jsx as ie}from"react/jsx-runtime";var Q='[role="treeitem"]:not([data-disabled])',ae='[role="treeitem"]';function De(t){return`${t} loaded`}var[Ke,G]=be("Tree"),O=s.createContext({depth:1,parentId:null});function P(t){return Array.from(t.querySelectorAll(Q))}function C(t){return t.getAttribute("data-skdx-tree-node-id")??""}function Ge(t){let i=t.getAttribute("data-text-value");if(i!==null)return i;let d="";for(let o of t.childNodes){let a=o.nodeType===1?o:null;a&&(a.getAttribute("role")==="group"||a.getAttribute("aria-hidden")==="true")||(d+=o.textContent??"")}return d}function Oe(t){let i=new Map;for(let o of t.querySelectorAll(ae)){let a=C(o);if(!a)continue;let c=o.getAttribute("data-skdx-tree-parent-id")??"",m=i.get(c);m?m.push(a):i.set(c,[a])}let d=new Map;for(let o of i.values())o.forEach((a,c)=>{d.set(a,{posinset:c+1,setsize:o.length})});return d}function ze(t,i){if(t.size!==i.size)return!1;for(let[d,o]of t){let a=i.get(d);if(!a||a.posinset!==o.posinset||a.setsize!==o.setsize)return!1}return!0}function se(t,i,d){let o=P(t),a=o.indexOf(i);if(a===-1)return;let c=o[a+d];return c?.focus(),c}var Fe=s.forwardRef(({selectionMode:t="single",expandedIds:i,defaultExpandedIds:d=[],onExpandedIdsChange:o,selectedIds:a,defaultSelectedIds:c=[],onSelectedIdsChange:m,selectionPropagation:T="none",loadChildren:g,getLoadedLabel:b=De,...x},R)=>{let h=s.useRef(null),A=Se(),[I,p]=s.useState(null),[N,k]=s.useState(()=>new Set),V=s.useRef(new Set),[W,X]=s.useState(()=>new Map),v=T==="descendants",[Z=[],L]=oe({prop:i,defaultProp:d,onChange:o}),[j=[],S]=oe({prop:a,defaultProp:c,onChange:m}),he=s.useMemo(()=>new Set(Z),[Z]),H=s.useMemo(()=>new Set(j),[j]),Te=s.useCallback((e,r)=>{X(n=>n.get(e)===r?n:new Map(n).set(e,r))},[]),xe=s.useCallback(e=>{X(r=>{if(!r.has(e))return r;let n=new Map(r);return n.delete(e),n})},[]),q=s.useMemo(()=>{let e=new Map;for(let[r,n]of W){if(n===null)continue;let l=e.get(n);l?l.push(r):e.set(n,[r])}return e},[W]),D=s.useCallback(e=>{let r=[],n=[...q.get(e)??[]];for(;n.length>0;){let l=n.pop();r.push(l),n.push(...q.get(l)??[])}return r},[q]),_=s.useCallback(e=>{if(!v)return!1;let r=D(e);if(r.length===0)return H.has(e);let n=r.filter(l=>H.has(l)).length;return n===0?!1:n===r.length?!0:"mixed"},[v,D,H]),K=s.useCallback(e=>{if(!g||V.current.has(e))return;V.current.add(e),k(n=>new Set(n).add(e));let r=()=>k(n=>{let l=new Set(n);return l.delete(e),l});Promise.resolve(g(e)).then(()=>{r(),Me(b(e))},()=>{V.current.delete(e),r()})},[g,b]),B=s.useCallback((e,r)=>{L((n=[])=>r?[...n,e]:n.filter(l=>l!==e)),r&&K(e)},[L,K]),ye=s.useCallback(e=>{if(e.length!==0){L((r=[])=>[...new Set([...r,...e])]);for(let r of e)K(r)}},[L,K]),U=s.useCallback(e=>{if(t!=="none"){if(t==="multiple"&&v){let r=_(e)!==!0,n=[e,...D(e)];S((l=[])=>{let E=new Set(l);for(let M of n)r?E.add(M):E.delete(M);return[...E]});return}S((r=[])=>t==="single"?[e]:r.includes(e)?r.filter(n=>n!==e):[...r,e])}},[t,v,_,D,S]),ee=s.useCallback(e=>{t==="multiple"&&S((r=[])=>[...new Set([...r,...e])])},[t,S]);ve(h,Q,"data-skdx-tree-node-id",I,p);let[te,Ce]=s.useState(()=>new Map);s.useLayoutEffect(()=>{let e=h.current;if(!e)return;let r=Oe(e);Ce(n=>ze(n,r)?n:r)});let Re=s.useCallback(e=>te.get(e),[te]),ke=Ne({orientation:"vertical",loop:!1,itemSelector:Q,typeahead:!1}),Ee=He(s.useCallback(()=>h.current?P(h.current).map(Ge):[],[])),Pe=e=>{let r=e.currentTarget,n=e.target;if(!n.matches('[role="treeitem"]'))return;let l=C(n),E=n.getAttribute("aria-expanded"),M=E!==null,re=E==="true",Y=n.getAttribute("data-skdx-tree-parent-id")||"",$=t==="multiple",w=Ie(e.key,e.currentTarget,A);if($&&e.shiftKey&&(w==="ArrowDown"||w==="ArrowUp")){e.preventDefault();let u=se(r,n,w==="ArrowDown"?1:-1);u&&U(C(u));return}if($&&e.shiftKey&&(e.key==="Home"||e.key==="End")){e.preventDefault();let u=P(r),y=u.indexOf(n),J=e.key==="Home"?0:u.length-1;ee(u.slice(Math.min(y,J),Math.max(y,J)+1).map(C)),u[J]?.focus();return}if($&&(e.ctrlKey||e.metaKey)&&e.key.toLowerCase()==="a"){e.preventDefault(),ee(P(r).map(C));return}if(w==="ArrowRight")e.preventDefault(),M&&!re?B(l,!0):se(r,n,1);else if(w==="ArrowLeft")e.preventDefault(),M&&re?B(l,!1):Y&&P(r).find(y=>C(y)===Y)?.focus();else if(e.key==="Enter"||e.key===" ")e.preventDefault(),U(l);else if(e.key==="*")e.preventDefault(),ye(Array.from(r.querySelectorAll(ae)).filter(u=>(u.getAttribute("data-skdx-tree-parent-id")||"")===Y&&u.getAttribute("aria-expanded")==="false").map(C));else if(Le(e)){let u=P(r),y=Ee(e.key,u.indexOf(n));if(y===-1)return;e.preventDefault(),u[y].focus()}};return ie(Ke,{selectionMode:t,selectionPropagation:T,expandedIds:he,selectedIds:H,loadingIds:N,activeNodeId:I,setActiveNodeId:p,onExpandedChange:B,onSelectedChange:U,checkedState:_,positionOf:Re,registerNode:Te,unregisterNode:xe,children:ie(Ae.div,{role:"tree","aria-multiselectable":t==="multiple"?!0:void 0,...x,...we("tree","root",x.className),ref:e=>{h.current=e,typeof R=="function"?R(e):R&&(R.current=e)},onKeyDown:ne(x.onKeyDown,ne(Pe,ke))})})});Fe.displayName="Tree";import*as f from"react";import{createSafeContext as _e}from"../utils/createContext.js";import{skdxPart as Be}from"../utils/part.js";import{composeEventHandlers as le,Primitive as Ue}from"../utils/primitive.js";import{rovingTabIndex as Ye}from"../utils/useRovingFocus.js";import*as de from"react";import{skdxPart as Ve}from"../utils/part.js";import{Primitive as qe}from"../utils/primitive.js";import{jsx as ce}from"react/jsx-runtime";var z=de.forwardRef(({forceMount:t,children:i,...d},o)=>{let a=F("TreeGroup");return t||a.expanded?ce(O.Provider,{value:{depth:a.depth+1,parentId:a.nodeId},children:ce(qe.div,{role:"group",...d,...Ve("tree","group",d.className),ref:o,children:i})}):null});z.displayName="TreeGroup";import{jsx as fe}from"react/jsx-runtime";var[$e,F]=_e("TreeItem");function ue(t){return t.target.closest('[role="treeitem"]')!==t.currentTarget}function Je(t){return f.Children.toArray(t).some(i=>f.isValidElement(i)&&i.type===z)}var me=f.forwardRef(({nodeId:t,disabled:i=!1,children:d,...o},a)=>{let c=G("TreeItem"),m=f.useContext(O),T=Je(d),g=c.expandedIds.has(t),b=c.selectedIds.has(t),x=c.loadingIds.has(t),R=Ye(c.activeNodeId!==null,c.activeNodeId===t,i),{registerNode:h,unregisterNode:A}=c,I=m.parentId;f.useEffect(()=>(h(t,I),()=>A(t)),[t,I,h,A]);let p=c.selectionPropagation==="descendants"?c.checkedState(t):void 0,N=c.positionOf(t);return fe($e,{nodeId:t,depth:m.depth,expanded:g,selected:b,disabled:i,hasChildren:T,loading:x,children:fe(Ue.div,{role:"treeitem","aria-level":m.depth,"aria-posinset":N?.posinset,"aria-setsize":N?.setsize,"aria-selected":c.selectionMode==="none"?void 0:b,"aria-expanded":T?g:void 0,"aria-checked":p===void 0?void 0:p==="mixed"?"mixed":p,"aria-busy":x||void 0,"aria-disabled":i||void 0,"data-state":T?g?"expanded":"collapsed":void 0,"data-checked":p===void 0?void 0:p==="mixed"?"indeterminate":p?"checked":"unchecked","data-loading":x?"":void 0,"data-disabled":i?"":void 0,"data-skdx-tree-node-id":t,"data-skdx-tree-parent-id":m.parentId??void 0,tabIndex:R,...o,...Be("tree","item",o.className),ref:a,onClick:le(o.onClick,k=>{i||ue(k)||(c.onSelectedChange(t),T&&c.onExpandedChange(t,!g))}),onFocus:le(o.onFocus,k=>{!i&&!ue(k)&&c.setActiveNodeId(t)}),children:d})})});me.displayName="TreeItem";import*as pe from"react";import{skdxPart as Qe}from"../utils/part.js";import{composeEventHandlers as We,Primitive as Xe}from"../utils/primitive.js";import{jsx as Ze}from"react/jsx-runtime";var ge=pe.forwardRef((t,i)=>{let d=G("TreeItemIndicator"),o=F("TreeItemIndicator");return Ze(Xe.span,{"aria-hidden":"true","data-state":o.hasChildren?o.expanded?"expanded":"collapsed":void 0,...t,...Qe("tree","item-indicator",t.className),ref:i,onClick:We(t.onClick,a=>{a.stopPropagation(),o.hasChildren&&d.onExpandedChange(o.nodeId,!o.expanded)})})});ge.displayName="TreeItemIndicator";export{Fe as Tree,O as TreeAmbientContext,z as TreeGroup,me as TreeItem,ge as TreeItemIndicator,Ke as TreeProvider,De as defaultGetLoadedLabel,G as useTreeContext};
+import*as s from"react";import{createSafeContext as lt}from"../utils/createContext.js";import{directionalKey as dt,useDirection as ut}from"../utils/direction.js";import{announce as ft}from"../utils/liveAnnouncer.js";import{skdxPart as mt}from"../utils/part.js";import{composeEventHandlers as Oe,Primitive as pt}from"../utils/primitive.js";import{useControllableState as ge}from"../utils/useControllableState.js";import{useRovingFocus as gt}from"../utils/useRovingFocus.js";import{isTypeaheadKey as ht,useTypeahead as xt}from"../utils/useTypeahead.js";import*as re from"react";import{skdxPart as ot}from"../utils/part.js";import{Primitive as it}from"../utils/primitive.js";import*as x from"react";import{createSafeContext as je}from"../utils/createContext.js";import{skdxPart as et}from"../utils/part.js";import{composeEventHandlers as ve,Primitive as tt}from"../utils/primitive.js";import{rovingTabIndex as nt}from"../utils/useRovingFocus.js";import{jsx as Le}from"react/jsx-runtime";var[rt,te]=je("TreeItem");function He(n){return n.target.closest('[role="treeitem"]')!==n.currentTarget}function st(n){return x.Children.toArray(n).some(o=>x.isValidElement(o)&&o.type===V)}var fe=x.forwardRef(({nodeId:n,disabled:o=!1,hasChildren:i,textValue:c,children:a,...f},T)=>{let d=ne("TreeItem"),y=x.useContext(q),F=o&&d.disabledBehavior==="all",A=i??st(a),k=d.expandedIds.has(n),L=d.selectedIds.has(n),M=d.loadingIds.has(n),U=nt(d.activeNodeId!==null,d.activeNodeId===n,F),{registerNode:I,unregisterNode:_}=d,D=y.parentId;x.useEffect(()=>(I(n,D),()=>_(n)),[n,D,I,_]);let R=d.checkedAxisActive||d.selectionPropagation==="descendants"?d.checkedState(n):void 0,O=!d.checkedAxisActive&&d.selectionPropagation==="descendants",N=d.positionOf(n);return Le(rt,{nodeId:n,depth:y.depth,expanded:k,selected:L,disabled:o,hasChildren:A,loading:M,children:Le(tt.div,{role:"treeitem","aria-level":y.depth,"aria-posinset":N?.posinset,"aria-setsize":N?.setsize,"aria-selected":d.selectionMode==="none"||O?void 0:L,"aria-expanded":A?k:void 0,"aria-checked":R===void 0?void 0:R==="mixed"?"mixed":R,"aria-busy":M||void 0,"aria-disabled":o||void 0,"data-state":A?k?"expanded":"collapsed":void 0,"data-checked":R===void 0?void 0:R==="mixed"?"indeterminate":R?"checked":"unchecked","data-loading":M?"":void 0,"data-disabled":o?"":void 0,"data-text-value":c,"data-skdx-tree-node-id":n,"data-skdx-tree-parent-id":y.parentId??void 0,tabIndex:U,...f,...et("tree","item",f.className),style:{"--skdx-tree-node-depth":y.depth,...f.style},ref:T,onClick:ve(f.onClick,K=>{o||He(K)||(d.onSelectedChange(n),d.onActivate(n),A&&d.expandOnClick&&d.onExpandedChange(n,!k))}),onFocus:ve(f.onFocus,K=>{!F&&!He(K)&&d.setActiveNodeId(n)}),children:a})})});fe.displayName="TreeItem";import{jsx as De}from"react/jsx-runtime";var V=re.forwardRef(({forceMount:n,children:o,...i},c)=>{let a=te("TreeGroup"),f=re.useMemo(()=>({depth:a.depth+1,parentId:a.nodeId,siblingIds:me(o)}),[a.depth,a.nodeId,o]);return n||a.expanded?De(q.Provider,{value:f,children:De(it.div,{role:"group",...i,...ot("tree","group",i.className),ref:c,children:o})}):null});V.displayName="TreeGroup";import{jsx as at,jsxs as ct}from"react/jsx-runtime";function pe(n,o){return n.map(i=>ct(fe,{nodeId:i.nodeId,disabled:i.disabled,textValue:i.textValue,hasChildren:i.hasChildren,children:[o?o(i):i.label??i.nodeId,i.children&&i.children.length>0?at(V,{children:pe(i.children,o)}):null]},i.nodeId))}import{jsx as xe}from"react/jsx-runtime";var ye='[role="treeitem"]:not([data-disabled])',Te='[role="treeitem"]';function Tt(n){return`${n} loaded`}var[yt,ne]=lt("Tree"),q=s.createContext({depth:1,parentId:null,siblingIds:null});function me(n){let o=s.Children.toArray(n).filter(s.isValidElement);if(o.length===0)return null;let i=[];for(let c of o){let a=c.props.nodeId;if(typeof a!="string"||a==="")return null;i.push(a)}return i}function nn(n,o){if(n===null)return;let i=n.indexOf(o);if(i!==-1)return{posinset:i+1,setsize:n.length}}function C(n,o=ye){return Array.from(n.querySelectorAll(o))}function b(n){return n.getAttribute("data-skdx-tree-node-id")??""}function kt(n){let o=n.getAttribute("data-text-value");if(o!==null)return o;let i="";for(let c of n.childNodes){let a=c.nodeType===1?c:null;a&&(a.getAttribute("role")==="group"||a.getAttribute("aria-hidden")==="true")||(i+=c.textContent??"")}return i}function Rt(n){let o=new Map;for(let c of n.querySelectorAll(Te)){let a=b(c);if(!a)continue;let f=c.getAttribute("data-skdx-tree-parent-id")??"",T=o.get(f);T?T.push(a):o.set(f,[a])}let i=new Map;for(let c of o.values())c.forEach((a,f)=>{i.set(a,{posinset:f+1,setsize:c.length})});return i}function Ct(n,o){return n.length===o.length&&n.every((i,c)=>i===o[c])}function bt(n,o){if(n.size!==o.size)return!1;for(let[i,c]of n){let a=o.get(i);if(!a||a.posinset!==c.posinset||a.setsize!==c.setsize)return!1}return!0}function he(n,o,i,c=ye){let a=C(n,c),f=a.indexOf(o);if(f===-1)return;let T=a[f+i];return T?.focus(),T}var Ke=s.forwardRef(({selectionMode:n="single",expandedIds:o,defaultExpandedIds:i=[],onExpandedIdsChange:c,selectedIds:a,defaultSelectedIds:f=[],onSelectedIdsChange:T,checkedIds:d,defaultCheckedIds:y,onCheckedIdsChange:F,selectionPropagation:A="none",loadChildren:k,getLoadedLabel:L=Tt,onLoadError:M,onActivate:U,disabledBehavior:I="all",expandOnClick:_=!0,collection:D,renderLabel:R,children:O,...N},K)=>{let w=s.useRef(null),m=I==="selection"?Te:ye,ze=ut(),[se,ke]=s.useState(null),[Ve,Re]=s.useState(()=>new Set),v=s.useRef(new Set),[B,Ce]=s.useState(()=>new Map),W=A==="descendants",[be=[],Y]=ge({prop:o,defaultProp:i,onChange:c}),[Ae=[],oe]=ge({prop:a,defaultProp:f,onChange:T}),E=d!==void 0||y!==void 0,[we=[],qe]=ge({prop:d,defaultProp:y??[],onChange:F}),P=E?qe:oe,ie=s.useMemo(()=>new Set(be),[be]),$=s.useMemo(()=>new Set(Ae),[Ae]),Ee=s.useMemo(()=>new Set(we),[we]),Fe=s.useCallback((e,t)=>{Ce(r=>r.get(e)===t?r:new Map(r).set(e,t))},[]),Ue=s.useCallback(e=>{Ce(t=>{if(!t.has(e))return t;let r=new Map(t);return r.delete(e),r})},[]),J=s.useMemo(()=>{let e=new Map;for(let[t,r]of B){if(r===null)continue;let l=e.get(r);l?l.push(t):e.set(r,[t])}return e},[B]),[G,_e]=s.useState(()=>new Map),Q=s.useMemo(()=>{let e=null;for(let t of B.keys()){if(!ie.has(t))continue;let r=J.get(t)??[],l=G.get(t);l&&Ct(l,r)||(e??(e=new Map(G)),e.set(t,r))}return e??G},[B,ie,J,G]);Q!==G&&_e(Q);let ae=s.useCallback(e=>J.get(e)??Q.get(e)??[],[J,Q]),H=s.useCallback(e=>{let t=[],r=new Set([e]),l=[...ae(e)];for(;l.length>0;){let p=l.pop();r.has(p)||(r.add(p),t.push(p),l.push(...ae(p)))}return t},[ae]),ce=s.useCallback(e=>{let t=E?Ee:$;if(!W)return E?t.has(e):!1;let r=H(e);if(r.length===0)return t.has(e);let l=r.filter(p=>t.has(p)).length;return l===0?!1:l===r.length?!0:"mixed"},[E,W,H,Ee,$]),X=s.useCallback(e=>{if(!k||v.current.has(e))return;v.current.add(e),Re(r=>new Set(r).add(e));let t=()=>Re(r=>{let l=new Set(r);return l.delete(e),l});Promise.resolve(k(e)).then(()=>{t(),ft(L(e))},r=>{v.current.delete(e),t(),M?.({nodeId:e,error:r})})},[k,L,M]),Pe=s.useCallback(e=>{if(e===void 0){v.current.clear();return}v.current.delete(e);for(let t of H(e))v.current.delete(t)},[H]),le=s.useCallback((e,t)=>{Y((r=[])=>t?[...r,e]:r.filter(l=>l!==e)),t&&X(e)},[Y,X]),Be=s.useCallback(e=>{if(e.length!==0){Y((t=[])=>[...new Set([...t,...e])]);for(let t of e)X(t)}},[Y,X]),Z=s.useRef(null),j=s.useCallback(e=>{if(n!=="none"){if(Z.current=e,n==="multiple"&&W){let t=ce(e)!==!0,r=[e,...H(e)];P((l=[])=>{let p=new Set(l);for(let z of r)t?p.add(z):p.delete(z);return[...p]});return}if(E){P((t=[])=>t.includes(e)?t.filter(r=>r!==e):[...t,e]);return}oe((t=[])=>n==="single"?[e]:t.includes(e)?t.filter(r=>r!==e):[...t,e])}},[n,W,E,ce,H,P,oe]),Se=s.useCallback(e=>{if(n!=="multiple")return;let t=e[e.length-1];t!==void 0&&(Z.current=t),P((r=[])=>[...new Set([...r,...e])])},[n,P]),We=s.useCallback(e=>{n!=="multiple"||e.length===0||P((t=[])=>{let r=new Set(t);return e.every(l=>r.has(l))?t.filter(l=>!e.includes(l)):[...new Set([...t,...e])]})},[n,P]),Me=s.useCallback(e=>{U?.(e)},[U]);s.useLayoutEffect(()=>{let e=Array.from(w.current?.querySelectorAll(m)??[],t=>t.getAttribute("data-skdx-tree-node-id")).filter(t=>t!==null&&t!=="");e.length===0||se!==null&&e.includes(se)||ke(e.find(t=>$.has(t))??e[0])});let[Ie,Ye]=s.useState(()=>new Map);s.useLayoutEffect(()=>{let e=w.current;if(!e)return;let t=Rt(e);Ye(r=>bt(r,t)?r:t)});let $e=s.useCallback(e=>Ie.get(e),[Ie]),Je=s.useMemo(()=>({depth:1,parentId:null,siblingIds:me(O)}),[O]),Qe=gt({orientation:"vertical",loop:!1,itemSelector:m,typeahead:!1});s.useImperativeHandle(K,()=>w.current?Object.assign(w.current,{invalidate:Pe}):{invalidate:Pe});let Xe=xt(s.useCallback(()=>w.current?C(w.current,m).map(kt):[],[m])),Ze=e=>{let t=e.currentTarget,r=e.target;if(!r.matches('[role="treeitem"]'))return;let l=b(r),p=r.getAttribute("aria-expanded"),z=p!==null,Ne=p==="true",de=r.getAttribute("data-skdx-tree-parent-id")||"",ee=n==="multiple",h=dt(e.key,e.currentTarget,ze);if(ee&&e.shiftKey&&(h==="ArrowDown"||h==="ArrowUp")){e.preventDefault();let u=he(t,r,h==="ArrowDown"?1:-1,m);u&&j(b(u));return}if(ee&&e.shiftKey&&e.key===" "){e.preventDefault();let g=C(t,m).map(b),S=Z.current===null?-1:g.indexOf(Z.current),ue=g.indexOf(l);S===-1||ue===-1?j(l):Se(g.slice(Math.min(S,ue),Math.max(S,ue)+1));return}if(ee&&e.shiftKey&&(e.key==="Home"||e.key==="End")){e.preventDefault();let u=C(t,m),g=u.indexOf(r),S=e.key==="Home"?0:u.length-1;Se(u.slice(Math.min(g,S),Math.max(g,S)+1).map(b)),u[S]?.focus();return}if(ee&&(e.ctrlKey||e.metaKey)&&e.key.toLowerCase()==="a"){e.preventDefault(),We(C(t,m).map(b));return}if(I==="selection"&&(h==="ArrowDown"||h==="ArrowUp"||e.key==="Home"||e.key==="End")){if(e.preventDefault(),h==="ArrowDown"||h==="ArrowUp")he(t,r,h==="ArrowDown"?1:-1,m);else{let u=C(t,m);(e.key==="Home"?u[0]:u[u.length-1])?.focus()}return}if(h==="ArrowRight")e.preventDefault(),z&&!Ne?le(l,!0):he(t,r,1,m);else if(h==="ArrowLeft")e.preventDefault(),z&&Ne?le(l,!1):de&&C(t,m).find(g=>b(g)===de)?.focus();else if(e.key==="Enter"||e.key===" "){if(e.preventDefault(),r.hasAttribute("data-disabled"))return;j(l),e.key==="Enter"&&Me(l)}else if(e.key==="*")e.preventDefault(),Be(Array.from(t.querySelectorAll(Te)).filter(u=>(u.getAttribute("data-skdx-tree-parent-id")||"")===de&&u.getAttribute("aria-expanded")==="false").map(b));else if(ht(e)){let u=C(t,m),g=Xe(e.key,u.indexOf(r));if(g===-1)return;e.preventDefault(),u[g].focus()}};return xe(yt,{selectionMode:n,selectionPropagation:A,expandedIds:ie,selectedIds:$,loadingIds:Ve,activeNodeId:se,setActiveNodeId:ke,disabledBehavior:I,expandOnClick:_,onExpandedChange:le,onSelectedChange:j,onActivate:Me,checkedAxisActive:E,checkedState:ce,positionOf:$e,registerNode:Fe,unregisterNode:Ue,children:xe(q.Provider,{value:Je,children:xe(pt.div,{role:"tree","aria-multiselectable":n==="multiple"?!0:void 0,...N,...mt("tree","root",N.className),ref:w,onKeyDown:Oe(N.onKeyDown,Oe(Ze,Qe)),children:D?pe(D,R):O})})})});Ke.displayName="Tree";import*as Ge from"react";import{skdxPart as At}from"../utils/part.js";import{composeEventHandlers as wt,Primitive as Et}from"../utils/primitive.js";import{jsx as St}from"react/jsx-runtime";var Pt=Ge.forwardRef((n,o)=>{let i=ne("TreeItemIndicator"),c=te("TreeItemIndicator");return St(Et.span,{"aria-hidden":"true","data-state":c.hasChildren?c.expanded?"expanded":"collapsed":void 0,...n,...At("tree","item-indicator",n.className),ref:o,onClick:wt(n.onClick,a=>{a.stopPropagation(),c.hasChildren&&i.onExpandedChange(c.nodeId,!c.expanded)})})});Pt.displayName="TreeItemIndicator";export{Ke as Tree,q as TreeAmbientContext,V as TreeGroup,fe as TreeItem,Pt as TreeItemIndicator,rt as TreeItemProvider,yt as TreeProvider,Tt as defaultGetLoadedLabel,nn as staticPosition,me as staticSiblingIds,ne as useTreeContext,te as useTreeItemContext};

package/dist/tree/TreeAnatomy.d.cts

@@ -0,0 +1,11 @@
+import type * as React from 'react';
+import type { TreeNode } from './types.cjs';
+/**
+ * The `collection` data path: the same `TreeItem` / `TreeGroup` structure a
+ * consumer writes by hand, built from `collection` instead. `TreeGroup` is
+ * rendered for every branch and unmounts itself while collapsed, which is
+ * why it is not gated on the expanded set here.
+ *
+ * @internal
+ */
+export declare function TreeAnatomy(nodes: readonly TreeNode[], renderLabel: ((node: TreeNode) => React.ReactNode) | undefined): React.ReactNode;

package/dist/tree/TreeAnatomy.d.ts

@@ -0,0 +1,11 @@
+import type * as React from 'react';
+import type { TreeNode } from './types.js';
+/**
+ * The `collection` data path: the same `TreeItem` / `TreeGroup` structure a
+ * consumer writes by hand, built from `collection` instead. `TreeGroup` is
+ * rendered for every branch and unmounts itself while collapsed, which is
+ * why it is not gated on the expanded set here.
+ *
+ * @internal
+ */
+export declare function TreeAnatomy(nodes: readonly TreeNode[], renderLabel: ((node: TreeNode) => React.ReactNode) | undefined): React.ReactNode;

package/dist/tree/TreeGroup.d.cts

@@ -1,10 +1,9 @@
 import * as React from 'react';
 import type { TreeGroupProps } from './types.cjs';
 /**
- * Collapsible container for a `TreeItem`'s child `TreeItem`s: renders a
- * `<div role="group">`, unmounted (unless `forceMount`) while the parent
- * item is collapsed. Increments depth (`aria-level`) and sets itself as the
- * parent node for the nested items via context.
+ * Collapsible container for child `TreeItem`s: renders a `<div role="group">`.
+ * Unmounted while the parent is collapsed (unless `forceMount`). Increments
+ * `aria-level` and sets parent via context.
  *
  * @example
  * ```tsx

package/dist/tree/TreeGroup.d.ts

@@ -1,10 +1,9 @@
 import * as React from 'react';
 import type { TreeGroupProps } from './types.js';
 /**
- * Collapsible container for a `TreeItem`'s child `TreeItem`s: renders a
- * `<div role="group">`, unmounted (unless `forceMount`) while the parent
- * item is collapsed. Increments depth (`aria-level`) and sets itself as the
- * parent node for the nested items via context.
+ * Collapsible container for child `TreeItem`s: renders a `<div role="group">`.
+ * Unmounted while the parent is collapsed (unless `forceMount`). Increments
+ * `aria-level` and sets parent via context.
  *
  * @example
  * ```tsx

package/dist/tree/TreeItem.d.cts

@@ -7,20 +7,14 @@ export declare const TreeItemProvider: {
     displayName: string;
 }, useTreeItemContext: (consumerName: string) => TreeItemContextValue;
 /**
- * A single node in the tree: renders a `<div role="treeitem">` with
- * `aria-level` (its depth), `aria-posinset`/`aria-setsize` (its place among
- * the siblings at its own level), `aria-selected` (unless `selectionMode` is
- * `"none"`), `aria-expanded` (only if it has a `TreeGroup` child),
- * `data-state` of `"expanded"`/`"collapsed"`, and `data-disabled`. Detects
- * whether it has children by checking for a `TreeGroup` among its
- * `children`. Clicking it selects the node and, if it has children, toggles
- * expansion; focusing it makes it the tree's active (tabbable) node.
+ * Single tree node: role=treeitem with aria-level, aria-posinset/aria-setsize, aria-selected.
+ * Detects children via TreeGroup child or hasChildren prop (enables lazy-loaded branches).
+ * Click: selects, fires onActivate, toggles expansion (if expandOnClick). Focus: becomes active node.
  *
- * While the tree's `loadChildren` is pending for this node it carries
- * `aria-busy="true"` and `data-loading`. Under
- * `selectionPropagation="descendants"` it also carries `aria-checked`
- * (`true`/`false`/`"mixed"`) and `data-checked`
- * (`checked`/`unchecked`/`indeterminate`) derived from its descendants.
+ * Publishes --skdx-tree-node-depth (CSS indent) and data-text-value (typeahead).
+ *
+ * aria-busy + data-loading while loadChildren pending.
+ * aria-checked + data-checked when checked axis active or selectionPropagation=descendants.
  *
  * @example
  * ```tsx

package/dist/tree/TreeItem.d.ts

@@ -7,20 +7,14 @@ export declare const TreeItemProvider: {
     displayName: string;
 }, useTreeItemContext: (consumerName: string) => TreeItemContextValue;
 /**
- * A single node in the tree: renders a `<div role="treeitem">` with
- * `aria-level` (its depth), `aria-posinset`/`aria-setsize` (its place among
- * the siblings at its own level), `aria-selected` (unless `selectionMode` is
- * `"none"`), `aria-expanded` (only if it has a `TreeGroup` child),
- * `data-state` of `"expanded"`/`"collapsed"`, and `data-disabled`. Detects
- * whether it has children by checking for a `TreeGroup` among its
- * `children`. Clicking it selects the node and, if it has children, toggles
- * expansion; focusing it makes it the tree's active (tabbable) node.
+ * Single tree node: role=treeitem with aria-level, aria-posinset/aria-setsize, aria-selected.
+ * Detects children via TreeGroup child or hasChildren prop (enables lazy-loaded branches).
+ * Click: selects, fires onActivate, toggles expansion (if expandOnClick). Focus: becomes active node.
  *
- * While the tree's `loadChildren` is pending for this node it carries
- * `aria-busy="true"` and `data-loading`. Under
- * `selectionPropagation="descendants"` it also carries `aria-checked`
- * (`true`/`false`/`"mixed"`) and `data-checked`
- * (`checked`/`unchecked`/`indeterminate`) derived from its descendants.
+ * Publishes --skdx-tree-node-depth (CSS indent) and data-text-value (typeahead).
+ *
+ * aria-busy + data-loading while loadChildren pending.
+ * aria-checked + data-checked when checked axis active or selectionPropagation=descendants.
  *
  * @example
  * ```tsx

package/dist/tree/TreeItemIndicator.d.cts

@@ -1,11 +1,9 @@
 import * as React from 'react';
 import type { TreeItemIndicatorProps } from './types.cjs';
 /**
- * Expand/collapse affordance (e.g. a chevron) within a `TreeItem`: renders a
- * `<span aria-hidden="true">` with `data-state` of `"expanded"`/`"collapsed"`
- * (unset if the item has no children). Clicking it toggles expansion and
- * stops propagation, so the enclosing `TreeItem`'s own click handler doesn't
- * double-toggle it.
+ * Expand/collapse affordance within a `TreeItem`: renders a `<span>` with
+ * `data-state` (`expanded`/`collapsed`). Clicking it toggles expansion and
+ * stops propagation.
  *
  * @example
  * ```tsx

package/dist/tree/TreeItemIndicator.d.ts

@@ -1,11 +1,9 @@
 import * as React from 'react';
 import type { TreeItemIndicatorProps } from './types.js';
 /**
- * Expand/collapse affordance (e.g. a chevron) within a `TreeItem`: renders a
- * `<span aria-hidden="true">` with `data-state` of `"expanded"`/`"collapsed"`
- * (unset if the item has no children). Clicking it toggles expansion and
- * stops propagation, so the enclosing `TreeItem`'s own click handler doesn't
- * double-toggle it.
+ * Expand/collapse affordance within a `TreeItem`: renders a `<span>` with
+ * `data-state` (`expanded`/`collapsed`). Clicking it toggles expansion and
+ * stops propagation.
  *
  * @example
  * ```tsx

package/dist/tree/index.d.cts

@@ -1,5 +1,2 @@
-export * from './Tree.cjs';
-export { TreeItem } from './TreeItem.cjs';
-export { TreeGroup } from './TreeGroup.cjs';
-export { TreeItemIndicator } from './TreeItemIndicator.cjs';
-export type { TreeProps, TreeItemProps, TreeGroupProps, TreeItemIndicatorProps, TreeSelectionPropagation, TreeCheckedState, } from './types.cjs';
+export { Tree } from './Tree.cjs';
+export type { TreeNode, TreeProps } from './types.cjs';

package/dist/tree/index.d.ts

@@ -1,5 +1,2 @@
-export * from './Tree.js';
-export { TreeItem } from './TreeItem.js';
-export { TreeGroup } from './TreeGroup.js';
-export { TreeItemIndicator } from './TreeItemIndicator.js';
-export type { TreeProps, TreeItemProps, TreeGroupProps, TreeItemIndicatorProps, TreeSelectionPropagation, TreeCheckedState, } from './types.js';
+export { Tree } from './Tree.js';
+export type { TreeNode, TreeProps } from './types.js';

package/dist/tree/primitives.d.cts

@@ -0,0 +1,24 @@
+/**
+ * Advanced primitives for `Tree` — the parts the recipe composes. Use
+ * for full manual composition.
+ *
+ * @example
+ * ```tsx
+ * import { Tree, TreeGroup, TreeItem, TreeItemIndicator } from '@skdx/react/primitives/tree';
+ *
+ * <Tree aria-label="Project files">
+ *   <TreeItem nodeId="src">
+ *     <TreeItemIndicator>▸</TreeItemIndicator>
+ *     src
+ *     <TreeGroup>
+ *       <TreeItem nodeId="src/index.ts">index.ts</TreeItem>
+ *     </TreeGroup>
+ *   </TreeItem>
+ * </Tree>
+ * ```
+ */
+export { Tree, defaultGetLoadedLabel } from './Tree.cjs';
+export { TreeItem } from './TreeItem.cjs';
+export { TreeGroup } from './TreeGroup.cjs';
+export { TreeItemIndicator } from './TreeItemIndicator.cjs';
+export type { TreeProps, TreeNode, TreeItemProps, TreeGroupProps, TreeItemIndicatorProps, TreeSelectionPropagation, TreeCheckedState, TreeHandle, TreeElementHandle, } from './types.cjs';

package/dist/tree/primitives.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Advanced primitives for `Tree` — the parts the recipe composes. Use
+ * for full manual composition.
+ *
+ * @example
+ * ```tsx
+ * import { Tree, TreeGroup, TreeItem, TreeItemIndicator } from '@skdx/react/primitives/tree';
+ *
+ * <Tree aria-label="Project files">
+ *   <TreeItem nodeId="src">
+ *     <TreeItemIndicator>▸</TreeItemIndicator>
+ *     src
+ *     <TreeGroup>
+ *       <TreeItem nodeId="src/index.ts">index.ts</TreeItem>
+ *     </TreeGroup>
+ *   </TreeItem>
+ * </Tree>
+ * ```
+ */
+export { Tree, defaultGetLoadedLabel } from './Tree.js';
+export { TreeItem } from './TreeItem.js';
+export { TreeGroup } from './TreeGroup.js';
+export { TreeItemIndicator } from './TreeItemIndicator.js';
+export type { TreeProps, TreeNode, TreeItemProps, TreeGroupProps, TreeItemIndicatorProps, TreeSelectionPropagation, TreeCheckedState, TreeHandle, TreeElementHandle, } from './types.js';

package/dist/tree/types.d.cts

@@ -1,20 +1,20 @@
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 /** How many nodes a {@link Tree} allows selected at once: one, many, or no selection. */
 export type SelectionMode = 'single' | 'multiple' | 'none';
-/**
- * Whether selecting a node also selects its subtree. `'descendants'` turns the
- * tree into a tri-state checkbox tree: toggling a node applies to every one of
- * its descendants, and a parent reports `aria-checked` of `true`, `false`, or
- * `"mixed"` derived from them.
- */
+/** Whether selecting a node also selects its subtree, turning the tree into a tri-state checkbox tree. */
 export type TreeSelectionPropagation = 'none' | 'descendants';
 /** A node's tri-state checkbox value, as reported on `aria-checked`. */
 export type TreeCheckedState = boolean | 'mixed';
-/**
- * A node's place among its siblings — the ones at its own level under its own
- * parent, not a flat index over the tree — as reported on `aria-posinset`
- * (1-based) and `aria-setsize`.
- */
+/** What a `TreeItem`'s `disabled` takes away: `'all'` makes it inert and unreachable, `'selection'` keeps it reachable but refusing selection. */
+export type TreeDisabledBehavior = 'all' | 'selection';
+/** Payload of {@link TreeProps.onLoadError} — the branch whose `loadChildren` rejected, and why. */
+export interface TreeLoadErrorDetail {
+    /** The node whose `loadChildren` call rejected. */
+    nodeId: string;
+    /** Whatever the rejected promise rejected with. Unknown by construction: `loadChildren` is the consumer's. */
+    error: unknown;
+}
+/** Node's position among siblings (reported as `aria-posinset` / `aria-setsize`, 1-based). */
 export interface TreeNodePosition {
     posinset: number;
     setsize: number;
@@ -29,21 +29,21 @@ export interface TreeContextValue {
     loadingIds: Set<string>;
     activeNodeId: string | null;
     setActiveNodeId: (nodeId: string) => void;
+    disabledBehavior: TreeDisabledBehavior;
+    /** Whether branch clicks toggle expansion and selection. */
+    expandOnClick: boolean;
     onExpandedChange: (nodeId: string, expanded: boolean) => void;
+    /** Toggles selection or checked state (depending on checked axis). */
     onSelectedChange: (nodeId: string) => void;
-    /**
-     * Tri-state value for a node: derived from its registered descendants when it
-     * has any, otherwise its own membership in `selectedIds`. Always `false` for
-     * every node unless `selectionPropagation` is `'descendants'`.
-     */
+    /** Fires root's `onActivate` (Enter and click, not Space). */
+    onActivate: (nodeId: string) => void;
+    /** Whether tree has own checked axis (from `checkedIds` / `defaultCheckedIds`). */
+    checkedAxisActive: boolean;
+    /** Node's checked value (from `checkedIds` or `selectedIds`; tri-state with propagation). */
     checkedState: (nodeId: string) => TreeCheckedState;
-    /**
-     * A node's `aria-posinset`/`aria-setsize`, measured off the rendered DOM in
-     * document order. `undefined` until the first measurement lands (one commit
-     * after mount) or for a node that isn't rendered.
-     */
+    /** Node's `aria-posinset` / `aria-setsize` (measured from DOM; undefined until first measurement). */
     positionOf: (nodeId: string) => TreeNodePosition | undefined;
-    /** Called by each `TreeItem` on mount so the root can walk the node hierarchy without touching the DOM. */
+    /** Called by each `TreeItem` on mount (lets root walk hierarchy without touching DOM). */
     registerNode: (nodeId: string, parentId: string | null) => void;
     unregisterNode: (nodeId: string) => void;
 }
@@ -58,95 +58,168 @@ export interface TreeItemContextValue {
     /** Whether this node's `loadChildren` call is still pending. */
     loading: boolean;
 }
-/** Props for the {@link Tree} root. */
+/** Collection node; `nodeId` must be unique and keys all state. */
+export interface TreeNode {
+    /** Node identity in `expandedIds`, `selectedIds`, `checkedIds`, active node and `loadChildren`. */
+    nodeId: string;
+    /**
+     * Text rendered as node content (falls back to `nodeId`).
+     * @default undefined
+     */
+    label?: string;
+    /**
+     * Excludes node from selection and activation (like `TreeItem`'s `disabled`).
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Declares node as branch with unloaded children (reports `aria-expanded="false"`).
+     * @default undefined — inferred from `children`.
+     */
+    hasChildren?: boolean;
+    /**
+     * Text typeahead matches against (falls back to rendered text).
+     * @default undefined
+     */
+    textValue?: string;
+    /**
+     * Child nodes (rendered in collapsible `TreeGroup`).
+     * @default undefined — leaf.
+     */
+    children?: TreeNode[];
+}
 export interface TreeProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaultValue'> {
     /**
-     * `"single"`, `"multiple"`, or `"none"` (not selectable, just expand/collapse).
+     * Hierarchical data the tree renders from (becomes source of truth; `children` ignored).
+     * @default undefined — renders `children`.
+     */
+    collection?: readonly TreeNode[];
+    /**
+     * Renders collection node content (ignored without `collection`).
+     * @default undefined — renders `label ?? nodeId`.
+     */
+    renderLabel?: (node: TreeNode) => React.ReactNode;
+    /**
+     * Selection mode (`'single'`, `'multiple'`, or `'none'` for expand/collapse only).
      * @default 'single'
      */
     selectionMode?: SelectionMode;
     /**
-     * Expanded node ids, for controlled usage. Pair with `onExpandedIdsChange`.
-     * @default undefined — uncontrolled, tracks its own expanded set internally.
+     * Expanded ids for controlled usage; pair with `onExpandedIdsChange`.
+     * @default undefined — uncontrolled.
      */
     expandedIds?: string[];
     /**
-     * Initially expanded node ids, for uncontrolled usage.
+     * Initial expanded ids for uncontrolled usage.
      * @default []
      */
     defaultExpandedIds?: string[];
     /**
-     * Fires with the new set of expanded ids whenever a node is expanded or collapsed, controlled or not.
-     * @default undefined — no-op if omitted.
+     * Fires with new expanded ids on expand/collapse.
+     * @default undefined — no-op.
      */
     onExpandedIdsChange?: (ids: string[]) => void;
     /**
-     * Selected node ids, for controlled usage. Pair with `onSelectedIdsChange`.
-     * @default undefined — uncontrolled, tracks its own selected set internally.
+     * Selected ids for controlled usage; pair with `onSelectedIdsChange`.
+     * @default undefined — uncontrolled.
      */
     selectedIds?: string[];
     /**
-     * Initially selected node ids, for uncontrolled usage.
+     * Initial selected ids for uncontrolled usage.
      * @default []
      */
     defaultSelectedIds?: string[];
     /**
-     * Fires with the new set of selected ids whenever selection changes, controlled or not.
-     * @default undefined — no-op if omitted.
+     * Fires with new selected ids on selection change.
+     * @default undefined — no-op.
      */
     onSelectedIdsChange?: (ids: string[]) => void;
     /**
-     * Turns the tree into a tri-state checkbox tree: toggling a node selects or
-     * deselects its whole subtree, and each node reports `aria-checked` of
-     * `true`/`false`/`"mixed"` derived from its descendants. Only meaningful with
-     * `selectionMode="multiple"`; ignored otherwise.
-     *
-     * Propagation reaches *rendered* descendants only — a collapsed `TreeGroup`
-     * is unmounted, so its nodes are not registered and cannot be toggled.
+     * Checked ids for controlled usage (second axis from `selectedIds`); pair with `onCheckedIdsChange`.
+     * @default undefined — uncontrolled; `aria-checked` derives from `selectedIds`.
+     */
+    checkedIds?: string[];
+    /**
+     * Initial checked ids for uncontrolled usage (gives tree own checked axis).
+     * @default undefined — no checked axis.
+     */
+    defaultCheckedIds?: string[];
+    /**
+     * Fires with new checked ids on check/uncheck.
+     * @default undefined — no-op.
+     */
+    onCheckedIdsChange?: (ids: string[]) => void;
+    /**
+     * Tri-state checkbox tree with selection propagation (toggle node selects/deselects subtree).
      * @default 'none'
      */
     selectionPropagation?: TreeSelectionPropagation;
     /**
-     * Loads a node's children the first time it is expanded. Return a promise to
-     * mark the node busy (`aria-busy="true"` plus `data-loading`) until it
-     * settles; when it resolves, `getLoadedLabel` is announced through the shared
-     * live region. A rejected promise clears the busy state, announces nothing,
-     * and leaves the node eligible to retry on the next expand.
-     *
-     * The node still needs a `TreeGroup` child to be expandable at all — render
-     * an empty one and fill it in when the promise resolves.
-     * @default undefined — children are always rendered eagerly.
+     * Loads node's children on first expansion (marks node busy until settled).
+     * @default undefined — children eager.
      */
     loadChildren?: (nodeId: string) => void | Promise<void>;
     /**
-     * Formats the message announced when a lazily-loaded node's children arrive —
-     * newly rendered children are otherwise silent. Return an empty string to
-     * announce nothing. Close over your own data if you want a count in it.
-     * @default defaultGetLoadedLabel — e.g. `"src loaded"`
+     * Formats announcement when lazily-loaded children arrive.
+     * @default defaultGetLoadedLabel — e.g. `"src loaded"`.
      */
     getLoadedLabel?: (nodeId: string) => string;
+    /**
+     * Fires when `loadChildren` rejects (swallowed silently if not fired).
+     * @default undefined — no-op.
+     */
+    onLoadError?: (detail: TreeLoadErrorDetail) => void;
+    /**
+     * Fires on Enter or click (not Space).
+     * @default undefined — no-op.
+     */
+    onActivate?: (nodeId: string) => void;
+    /**
+     * What node's `disabled` takes away (see {@link TreeDisabledBehavior}}).
+     * @default 'all'
+     */
+    disabledBehavior?: TreeDisabledBehavior;
+    /**
+     * Whether branch clicks toggle expansion and selection.
+     * @default true
+     */
+    expandOnClick?: boolean;
 }
+/** Imperative Tree contract (assigned on root `<div>`). */
+export interface TreeHandle {
+    /** Clears load marker (or node + subtree with `nodeId`) for refetch on next expansion. */
+    invalidate(nodeId?: string): void;
+}
+/** {@link Tree}}'s forwarded ref (root `<div>` plus `invalidate()`). */
+export type TreeElementHandle = HTMLDivElement & TreeHandle;
 /** Props for a single {@link TreeItem} node. */
 export interface TreeItemProps extends PrimitivePropsWithRef<'div'> {
     /** Unique identifier tracked in the tree's expanded/selected/active state. */
     nodeId: string;
     /**
-     * Excludes this node (and its subtree's roving-focus/typeahead reach) from
-     * selection and keyboard activation.
+     * Excludes node from selection and activation (not inherited by descendants).
      * @default false
      */
     disabled?: boolean;
+    /**
+     * Typeahead text (published as `data-text-value`; falls back to rendered text).
+     * @default undefined
+     */
+    textValue?: string;
+    /**
+     * Declares node as branch, overriding `TreeGroup` scan (true makes it expandable before group mounts).
+     * @default undefined — inferred from `TreeGroup`.
+     */
+    hasChildren?: boolean;
 }
-/** Props for {@link TreeGroup}, the collapsible container of a `TreeItem`'s children. */
+/** Props for {@link TreeGroup}}, collapsible container of `TreeItem`'s children. */
 export interface TreeGroupProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep this group mounted even while its parent `TreeItem` is collapsed,
-     * instead of unmounting it. Useful for animation libraries that need the
-     * outgoing content present in the DOM during an exit transition.
+     * Keep group mounted while parent `TreeItem` collapsed.
      * @default false
      */
     forceMount?: boolean;
 }
-/** Props for {@link TreeItemIndicator}, the expand/collapse affordance (e.g. a chevron) within a `TreeItem`. */
+/** Props for {@link TreeItemIndicator}}, the expand/collapse affordance. */
 export interface TreeItemIndicatorProps extends PrimitivePropsWithRef<'span'> {
 }