@skdx/react 0.26.0 → 0.28.0

package/dist/table/Table.cjs

@@ -1 +1 @@
-"use strict";var Ut=Object.create;var O=Object.defineProperty;var Yt=Object.getOwnPropertyDescriptor;var qt=Object.getOwnPropertyNames;var Gt=Object.getPrototypeOf,Jt=Object.prototype.hasOwnProperty;var Qt=(e,t)=>{for(var n in t)O(e,n,{get:t[n],enumerable:!0})},ye=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let l of qt(t))!Jt.call(e,l)&&l!==n&&O(e,l,{get:()=>t[l],enumerable:!(o=Yt(t,l))||o.enumerable});return e};var u=(e,t,n)=>(n=e!=null?Ut(Gt(e)):{},ye(t||!e||!e.__esModule?O(n,"default",{value:e,enumerable:!0}):n,e)),Zt=e=>ye(O({},"__esModule",{value:!0}),e);var no={};Qt(no,{Table:()=>Ae,TableBody:()=>re,TableCaption:()=>se,TableCell:()=>ie,TableColumnHeaderSortTrigger:()=>K,TableColumnResizeTrigger:()=>X,TableEmpty:()=>fe,TableExpandTrigger:()=>de,TableExpandedRow:()=>me,TableFooter:()=>ae,TableHeader:()=>oe,TableHeaderCell:()=>le,TableHeaderCellProvider:()=>te,TableProvider:()=>Me,TableRow:()=>ne,TableRowSelectCheckbox:()=>ge,TableSelectAllCheckbox:()=>Te,TableSortIndicator:()=>be,defaultGetSortLabel:()=>Ne,defaultSelectAllLabel:()=>ue,tableDetailRowId:()=>V,useTableContext:()=>p,useTableHeaderCellContext:()=>D});module.exports=Zt(no);var s=u(require("react"),1),ke=require("../utils/composeRefs.cjs"),ee=require("../utils/createContext.cjs"),Ee=require("../utils/liveAnnouncer.cjs"),He=require("../utils/part.cjs"),Le=require("../utils/primitive.cjs"),$=require("../utils/useControllableState.cjs"),j=require("react/jsx-runtime");function we(e){return e===void 0?new Set:e instanceof Set?e:new Set(e)}var he=[],Z={};function jt(e){return e?Array.isArray(e)?e:[e]:[]}function eo(e,t,n){let o=e.find(r=>r.columnKey===t),l=o===void 0?"asc":o.direction==="asc"?"desc":null;return n?l===null?e.filter(r=>r.columnKey!==t):o===void 0?[...e,{columnKey:t,direction:l}]:e.map(r=>r.columnKey===t?{columnKey:t,direction:l}:r):l===null?[]:[{columnKey:t,direction:l}]}function Ne(e,t){return t===null?`${e} not sorted`:`${e} sorted ${t==="asc"?"ascending":"descending"}`}var[Me,p]=(0,ee.createSafeContext)("Table"),[te,D]=(0,ee.createSafeContext)("TableHeaderCell",{});function V(e,t){return`${e}-detail-${t}`}var Ae=s.forwardRef(({sort:e,defaultSort:t=null,onSortChange:n,multiSort:o=!1,selected:l,defaultSelected:r,onSelectedChange:d,selectionMode:m="none",getSortLabel:b=Ne,expandedRowIds:N,defaultExpandedRowIds:M=he,onExpandedRowIdsChange:z,columnWidths:S,defaultColumnWidths:w,onColumnWidthsChange:v,...T},R)=>{let P=s.useId(),A=s.useRef(null),_=(0,ke.useComposedRefs)(R,A),[h=null,I]=(0,$.useControllableState)({prop:e,defaultProp:t,onChange:n}),E=s.useMemo(()=>jt(h),[h]),i=E[0]??null,g=s.useMemo(()=>l===void 0?void 0:we(l),[l]),[x=new Set,W]=(0,$.useControllableState)({prop:g,defaultProp:we(r??[]),onChange:a=>d?.([...a])}),zt=s.useCallback((a,c=a)=>{let f=eo(E,a,o);I(o?f:f[0]??null);let C=f.find(y=>y.columnKey===a)?.direction??null;(0,Ee.announce)(b(c,C))},[E,o,I,b]),Re=s.useCallback(()=>{let a=A.current?.querySelectorAll(":scope > tbody > tr[data-row-id]");return a?[...a].map(c=>c.dataset.rowId):[]},[]),xe=s.useRef(null),vt=s.useCallback((a,c=!1)=>{if(m==="none")return;let f=xe.current;if(c&&m==="multiple"&&f!==null&&f!==a){let C=Re(),y=C.indexOf(f),Q=C.indexOf(a);if(y!==-1&&Q!==-1){let Xt=C.slice(Math.min(y,Q),Math.max(y,Q)+1);W((Ot=new Set)=>new Set([...Ot,...Xt]));return}}xe.current=a,W((C=new Set)=>{if(m==="single")return C.has(a)&&C.size===1?new Set:new Set([a]);let y=new Set(C);return y.has(a)?y.delete(a):y.add(a),y})},[m,W,Re]),[Ce=he,Se]=(0,$.useControllableState)({prop:N,defaultProp:M,onChange:z}),G=s.useMemo(()=>new Set(Ce),[Ce]),[It=Z,Pe]=(0,$.useControllableState)({prop:S,defaultProp:w??Z,onChange:v}),Kt=s.useCallback(a=>{Se((c=[])=>c.includes(a)?c.filter(f=>f!==a):[...c,a])},[Se]),Bt=s.useCallback(a=>G.has(a),[G]),Ft=s.useCallback((a,c)=>{Pe((f=Z)=>f[a]===c?f:{...f,[a]:c})},[Pe]),_t=s.useCallback(a=>x.has(a),[x]),J=s.useCallback(a=>a.length>0&&a.every(c=>x.has(c)),[x]),$t=s.useCallback(a=>a.some(c=>x.has(c))&&!J(a),[x,J]),Vt=s.useCallback(a=>{m!=="none"&&W((c=new Set)=>{if(a.length>0&&a.every(f=>c.has(f))){let f=new Set(c);return a.forEach(C=>f.delete(C)),f}return new Set([...c,...a])})},[m,W]);return(0,j.jsx)(Me,{tableId:P,sort:i,sortList:E,multiSort:o,selected:x,selectionMode:m,toggleSort:zt,toggleRow:vt,isRowSelected:_t,toggleAll:Vt,isAllSelected:J,isSomeSelected:$t,expandedRows:G,toggleRowExpanded:Kt,isRowExpanded:Bt,columnWidths:It,setColumnWidth:Ft,children:(0,j.jsx)(Le.Primitive.table,{...T,...(0,He.skdxPart)("table","root",T.className),ref:_})})});Ae.displayName="Table";var We=u(require("react"),1),De=require("../utils/part.cjs"),ze=require("../utils/primitive.cjs"),ve=require("react/jsx-runtime"),oe=We.forwardRef((e,t)=>(0,ve.jsx)(ze.Primitive.thead,{...e,...(0,De.skdxPart)("table","header",e.className),ref:t}));oe.displayName="TableHeader";var Ie=u(require("react"),1),Ke=require("../utils/part.cjs"),Be=require("../utils/primitive.cjs"),Fe=require("react/jsx-runtime"),re=Ie.forwardRef((e,t)=>(0,Fe.jsx)(Be.Primitive.tbody,{...e,...(0,Ke.skdxPart)("table","body",e.className),ref:t}));re.displayName="TableBody";var _e=u(require("react"),1),$e=require("../utils/part.cjs"),Ve=require("../utils/primitive.cjs"),Xe=require("react/jsx-runtime"),ae=_e.forwardRef((e,t)=>(0,Xe.jsx)(Ve.Primitive.tfoot,{...e,...(0,$e.skdxPart)("table","footer",e.className),ref:t}));ae.displayName="TableFooter";var Oe=u(require("react"),1),Ue=require("../utils/part.cjs"),U=require("../utils/primitive.cjs");var Ye=require("react/jsx-runtime"),to='button, a, input, [role="button"]',ne=Oe.forwardRef(({rowId:e,...t},n)=>{let o=p("TableRow"),l=e!==void 0&&o.isRowSelected(e),r=o.selectionMode!=="none"&&e!==void 0;return(0,Ye.jsx)(U.Primitive.tr,{"aria-selected":r?l:void 0,"data-state":l?"selected":void 0,"data-row-id":r?e:void 0,...t,...(0,Ue.skdxPart)("table","row",t.className),ref:n,onClick:(0,U.composeEventHandlers)(t.onClick,d=>{!r||d.target.closest(to)||o.toggleRow(e,d.shiftKey)})})});ne.displayName="TableRow";var L=u(require("react"),1),tt=require("../utils/part.cjs"),ot=require("../utils/primitive.cjs");var qe=u(require("react"),1),Ge=require("../utils/part.cjs"),Y=require("../utils/primitive.cjs");var Je=require("react/jsx-runtime"),K=qe.forwardRef(({sortKey:e,...t},n)=>{let o=p("TableColumnHeaderSortTrigger"),l=D("TableColumnHeaderSortTrigger"),r=e??l.sortKey;if(r===void 0)return null;let d=o.sortList.findIndex(b=>b.columnKey===r),m=o.sortList[d]?.direction;return(0,Je.jsx)(Y.Primitive.button,{type:"button","data-skdx-table-sort-trigger":"","data-sort-direction":m,"data-sort-index":o.multiSort&&d!==-1?d:void 0,...t,...(0,Ge.skdxPart)("table","column-header-sort-trigger",t.className),ref:n,onClick:(0,Y.composeEventHandlers)(t.onClick,b=>{o.toggleSort(r,b.currentTarget.textContent?.trim()||r)})})});K.displayName="TableColumnHeaderSortTrigger";var k=u(require("react"),1),Qe=require("../utils/clamp.cjs"),Ze=require("../utils/composeRefs.cjs"),B=require("../utils/direction.cjs"),je=require("../utils/part.cjs"),H=require("../utils/primitive.cjs");var et=require("react/jsx-runtime"),oo=40,ro=1e3,ao=8,X=k.forwardRef(({columnKey:e,minWidth:t,maxWidth:n,step:o,label:l,...r},d)=>{let m=p("TableColumnResizeTrigger"),b=D("TableColumnResizeTrigger"),N=(0,B.useDirection)(),M=k.useRef(null),z=(0,Ze.useComposedRefs)(d,M),S=k.useRef(null),[w,v]=k.useState(!1),T=e??b.columnKey,R=t??b.minWidth??oo,P=n??b.maxWidth??ro,A=o??b.resizeStep??ao,_=T===void 0?void 0:m.columnWidths[T],h=i=>{T!==void 0&&m.setColumnWidth(T,(0,Qe.clamp)(Math.round(i),R,P))},I=()=>_!==void 0?_:(M.current?.closest("th")?.getBoundingClientRect().width??0)||R,E=()=>{let i=S.current;if(!i)return null;S.current=null,v(!1);let g=M.current;return g?.hasPointerCapture?.(i.pointerId)&&g.releasePointerCapture(i.pointerId),i};return k.useEffect(()=>{if(!w)return;let i=g=>{if(g.key!=="Escape")return;let x=E();x&&h(x.startWidth)};return document.addEventListener("keydown",i),()=>document.removeEventListener("keydown",i)},[w,T,R,P]),T===void 0?null:(0,et.jsx)(H.Primitive.span,{role:"separator","aria-orientation":"vertical","aria-label":l??b.resizeLabel??"Resize column","aria-valuenow":Math.round(_??R),"aria-valuemin":R,"aria-valuemax":P,tabIndex:0,"data-skdx-table-resizer":"","data-dragging":w?"":void 0,...r,...(0,je.skdxPart)("table","column-resize-trigger",r.className),ref:z,onPointerDown:(0,H.composeEventHandlers)(r.onPointerDown,i=>{i.button===0&&(i.preventDefault(),i.stopPropagation(),S.current={startX:i.clientX,startWidth:I(),pointerId:i.pointerId},v(!0),i.currentTarget.setPointerCapture?.(i.pointerId))}),onPointerMove:(0,H.composeEventHandlers)(r.onPointerMove,i=>{let g=S.current;if(!g)return;let W=(0,B.resolveDirection)(i.currentTarget,N)==="rtl"?g.startX-i.clientX:i.clientX-g.startX;h(g.startWidth+W)}),onPointerUp:(0,H.composeEventHandlers)(r.onPointerUp,E),onPointerCancel:(0,H.composeEventHandlers)(r.onPointerCancel,E),onKeyDown:(0,H.composeEventHandlers)(r.onKeyDown,i=>{let g=(0,B.directionalKey)(i.key,i.currentTarget,N);if(g==="ArrowRight")h(I()+A);else if(g==="ArrowLeft")h(I()-A);else if(i.key==="Home")h(R);else if(i.key==="End")h(P);else return;i.preventDefault(),i.stopPropagation()})})});X.displayName="TableColumnResizeTrigger";var F=require("react/jsx-runtime");function rt(e){return L.Children.toArray(e).some(t=>L.isValidElement(t)?t.type===K?!0:t.type===L.Fragment&&rt(t.props.children):!1)}var le=L.forwardRef(({sortKey:e,columnKey:t,resizable:n=!1,minWidth:o=40,maxWidth:l=1e3,resizeLabel:r="Resize column",resizeStep:d=8,children:m,style:b,...N},M)=>{let z=p("TableHeaderCell"),S=e!==void 0,w=S?z.sortList.find(A=>A.columnKey===e)?.direction:void 0,v=S?w==="asc"?"ascending":w==="desc"?"descending":"none":void 0,T=t??e,R=n&&T!==void 0,P=T===void 0?void 0:z.columnWidths[T];return(0,F.jsx)(te,{sortKey:e,columnKey:T,minWidth:o,maxWidth:l,resizeLabel:r,resizeStep:d,children:(0,F.jsxs)(ot.Primitive.th,{"aria-sort":v,"data-sort-direction":w,"data-resizable":R?"":void 0,style:P===void 0?b:{...b,width:P,"--skdx-table-column-width":`${P}px`},...N,...(0,tt.skdxPart)("table","header-cell",N.className),ref:M,children:[S&&!rt(m)?(0,F.jsx)(K,{children:m}):m,R?(0,F.jsx)(X,{}):null]})})});le.displayName="TableHeaderCell";var at=u(require("react"),1),nt=require("../utils/part.cjs"),lt=require("../utils/primitive.cjs"),it=require("react/jsx-runtime"),ie=at.forwardRef((e,t)=>(0,it.jsx)(lt.Primitive.td,{...e,...(0,nt.skdxPart)("table","cell",e.className),ref:t}));ie.displayName="TableCell";var st=u(require("react"),1),dt=require("../utils/part.cjs"),ct=require("../utils/primitive.cjs"),mt=require("react/jsx-runtime"),se=st.forwardRef((e,t)=>(0,mt.jsx)(ct.Primitive.caption,{...e,...(0,dt.skdxPart)("table","caption",e.className),ref:t}));se.displayName="TableCaption";var pt=u(require("react"),1),ft=require("../utils/part.cjs"),q=require("../utils/primitive.cjs");var bt=require("react/jsx-runtime"),de=pt.forwardRef(({rowId:e,...t},n)=>{let o=p("TableExpandTrigger"),l=o.isRowExpanded(e);return(0,bt.jsx)(q.Primitive.button,{type:"button","aria-expanded":l,"aria-controls":V(o.tableId,e),"data-state":l?"expanded":"collapsed","data-skdx-table-expand-trigger":"",...t,...(0,ft.skdxPart)("table","expand-trigger",t.className),ref:n,onClick:(0,q.composeEventHandlers)(t.onClick,r=>{r.stopPropagation(),o.toggleRowExpanded(e)})})});de.displayName="TableExpandTrigger";var ut=u(require("react"),1),Tt=require("../utils/part.cjs"),gt=require("../utils/primitive.cjs");var ce=require("react/jsx-runtime"),me=ut.forwardRef(({rowId:e,colSpan:t=1,children:n,...o},l)=>{let r=p("TableExpandedRow"),d=r.isRowExpanded(e);return(0,ce.jsx)(gt.Primitive.tr,{id:V(r.tableId,e),"data-state":d?"expanded":"collapsed","data-skdx-table-detail-row":"",hidden:!d,...o,...(0,Tt.skdxPart)("table","expanded-row",o.className),ref:l,children:(0,ce.jsx)("td",{colSpan:t,children:n})})});me.displayName="TableExpandedRow";var Rt=u(require("react"),1),xt=require("../utils/part.cjs"),Ct=require("../utils/primitive.cjs"),pe=require("react/jsx-runtime"),fe=Rt.forwardRef(({colSpan:e=1,children:t,...n},o)=>(0,pe.jsx)(Ct.Primitive.tr,{"data-state":"empty","data-skdx-table-empty":"",...n,...(0,xt.skdxPart)("table","empty",n.className),ref:o,children:(0,pe.jsx)("td",{colSpan:e,children:t})}));fe.displayName="TableEmpty";var St=u(require("react"),1),Pt=require("../utils/part.cjs"),yt=require("../utils/primitive.cjs");var wt=require("react/jsx-runtime"),be=St.forwardRef(({sortKey:e,...t},n)=>{let o=p("TableSortIndicator"),l=D("TableSortIndicator"),r=e??l.sortKey,d=r===void 0?-1:o.sortList.findIndex(b=>b.columnKey===r),m=o.sortList[d]?.direction??"none";return(0,wt.jsx)(yt.Primitive.span,{"aria-hidden":"true","data-skdx-table-sort-indicator":"","data-sort-direction":m,"data-sort-index":o.multiSort&&d!==-1?d:void 0,...t,...(0,Pt.skdxPart)("table","sort-indicator",t.className),ref:n})});be.displayName="TableSortIndicator";var ht=u(require("react"),1),kt=require("../checkbox/Checkbox.cjs"),Et=require("../utils/part.cjs"),Ht=require("../utils/primitive.cjs");var Lt=require("react/jsx-runtime");function ue(e,t){let n=`${t} ${t===1?"row":"rows"}`;return e==="page"?`Select all ${n} on this page`:`Select all ${n}`}var Te=ht.forwardRef(({rowIds:e,scope:t,getSelectAllLabel:n=ue,...o},l)=>{let r=p("TableSelectAllCheckbox"),d=r.isAllSelected(e)?!0:r.isSomeSelected(e)?"indeterminate":!1;return(0,Lt.jsx)(kt.Checkbox,{"aria-label":n(t,e.length),...o,...(0,Et.skdxPart)("table","select-all-checkbox",o.className),ref:l,checked:d,"data-skdx-table-select-all":"","data-scope":t,onClick:(0,Ht.composeEventHandlers)(o.onClick,()=>r.toggleAll(e))})});Te.displayName="TableSelectAllCheckbox";var Nt=u(require("react"),1),Mt=require("../checkbox/Checkbox.cjs"),At=require("../utils/part.cjs"),Wt=require("../utils/primitive.cjs");var Dt=require("react/jsx-runtime"),ge=Nt.forwardRef(({rowId:e,...t},n)=>{let o=p("TableRowSelectCheckbox");return(0,Dt.jsx)(Mt.Checkbox,{...t,...(0,At.skdxPart)("table","row-select-checkbox",t.className),ref:n,checked:o.isRowSelected(e),"data-skdx-table-row-select":"",onClick:(0,Wt.composeEventHandlers)(t.onClick,l=>{o.toggleRow(e,l.shiftKey)})})});ge.displayName="TableRowSelectCheckbox";0&&(module.exports={Table,TableBody,TableCaption,TableCell,TableColumnHeaderSortTrigger,TableColumnResizeTrigger,TableEmpty,TableExpandTrigger,TableExpandedRow,TableFooter,TableHeader,TableHeaderCell,TableHeaderCellProvider,TableProvider,TableRow,TableRowSelectCheckbox,TableSelectAllCheckbox,TableSortIndicator,defaultGetSortLabel,defaultSelectAllLabel,tableDetailRowId,useTableContext,useTableHeaderCellContext});
+"use strict";var no=Object.create;var ee=Object.defineProperty;var lo=Object.getOwnPropertyDescriptor;var io=Object.getOwnPropertyNames;var so=Object.getPrototypeOf,co=Object.prototype.hasOwnProperty;var mo=(e,t)=>{for(var r in t)ee(e,r,{get:t[r],enumerable:!0})},Le=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of io(t))!co.call(e,a)&&a!==r&&ee(e,a,{get:()=>t[a],enumerable:!(o=lo(t,a))||o.enumerable});return e};var g=(e,t,r)=>(r=e!=null?no(so(e)):{},Le(t||!e||!e.__esModule?ee(r,"default",{value:e,enumerable:!0}):r,e)),fo=e=>Le(ee({},"__esModule",{value:!0}),e);var ho={};mo(ho,{Table:()=>he,TableBody:()=>te,TableCaption:()=>oe,TableCell:()=>$,TableColumnHeaderSortTrigger:()=>q,TableColumnResizeTrigger:()=>ce,TableEmpty:()=>re,TableExpandTrigger:()=>le,TableExpandedRow:()=>ae,TableFooter:()=>$t,TableHeader:()=>ie,TableHeaderCell:()=>O,TableHeaderCellProvider:()=>Ce,TableProvider:()=>zt,TableRoot:()=>Se,TableRow:()=>U,TableRowSelectCheckbox:()=>fe,TableSelectAllCheckbox:()=>pe,TableSortIndicator:()=>Xt,defaultGetSortLabel:()=>vt,defaultSelectAllLabel:()=>wt,tableDetailRowId:()=>Y,useTableContext:()=>p,useTableHeaderCellContext:()=>V});module.exports=fo(ho);var m=g(require("react"),1),Wt=require("../utils/composeRefs.cjs"),ye=require("../utils/createContext.cjs"),Mt=require("../utils/liveAnnouncer.cjs"),At=require("../utils/part.cjs"),Dt=require("../utils/primitive.cjs"),It=require("../utils/useCallbackRef.cjs"),Z=require("../utils/useControllableState.cjs");var G=g(require("react"),1);var We=g(require("react"),1),Me=require("../utils/part.cjs"),Ae=require("../utils/primitive.cjs"),De=require("react/jsx-runtime"),te=We.forwardRef((e,t)=>(0,De.jsx)(Ae.Primitive.tbody,{...e,...(0,Me.skdxPart)("table","body",e.className),ref:t}));te.displayName="TableBody";var Ie=g(require("react"),1),ve=require("../utils/part.cjs"),ze=require("../utils/primitive.cjs"),Ke=require("react/jsx-runtime"),oe=Ie.forwardRef((e,t)=>(0,Ke.jsx)(ze.Primitive.caption,{...e,...(0,ve.skdxPart)("table","caption",e.className),ref:t}));oe.displayName="TableCaption";var Fe=g(require("react"),1),_e=require("../utils/part.cjs"),$e=require("../utils/primitive.cjs"),Ve=require("react/jsx-runtime"),$=Fe.forwardRef((e,t)=>(0,Ve.jsx)($e.Primitive.td,{...e,...(0,_e.skdxPart)("table","cell",e.className),ref:t}));$.displayName="TableCell";var Be=g(require("react"),1),Oe=require("../utils/part.cjs"),Ue=require("../utils/primitive.cjs"),ge=require("react/jsx-runtime"),re=Be.forwardRef(({colSpan:e=1,children:t,...r},o)=>(0,ge.jsx)(Ue.Primitive.tr,{"data-state":"empty","data-skdx-table-empty":"",...r,...(0,Oe.skdxPart)("table","empty",r.className),ref:o,children:r.asChild?t:(0,ge.jsx)("td",{colSpan:e,children:t})}));re.displayName="TableEmpty";var Xe=g(require("react"),1),Ye=require("../utils/part.cjs"),qe=require("../utils/primitive.cjs");var xe=require("react/jsx-runtime"),ae=Xe.forwardRef(({rowId:e,colSpan:t=1,children:r,...o},a)=>{let n=p("TableExpandedRow"),s=n.isRowExpanded(e);return(0,xe.jsx)(qe.Primitive.tr,{id:Y(n.tableId,e),"data-state":s?"expanded":"collapsed","data-skdx-table-detail-row":"",hidden:!s,...o,...(0,Ye.skdxPart)("table","expanded-row",o.className),ref:a,children:o.asChild?r:(0,xe.jsx)("td",{colSpan:t,children:r})})});ae.displayName="TableExpandedRow";var Ge=g(require("react"),1),Ze=require("../utils/part.cjs"),ne=require("../utils/primitive.cjs");var Je=require("react/jsx-runtime"),le=Ge.forwardRef(({rowId:e,...t},r)=>{let o=p("TableExpandTrigger"),a=o.isRowExpanded(e);return(0,Je.jsx)(ne.Primitive.button,{type:"button","aria-expanded":a,"aria-controls":Y(o.tableId,e),"data-state":a?"expanded":"collapsed","data-skdx-table-expand-trigger":"",...t,...(0,Ze.skdxPart)("table","expand-trigger",t.className),ref:r,onClick:(0,ne.composeEventHandlers)(t.onClick,n=>{n.stopPropagation(),o.toggleRowExpanded(e)})})});le.displayName="TableExpandTrigger";var Qe=g(require("react"),1),je=require("../utils/part.cjs"),et=require("../utils/primitive.cjs"),tt=require("react/jsx-runtime"),ie=Qe.forwardRef((e,t)=>(0,tt.jsx)(et.Primitive.thead,{...e,...(0,je.skdxPart)("table","header",e.className),ref:t}));ie.displayName="TableHeader";var N=g(require("react"),1),dt=require("../utils/part.cjs"),ct=require("../utils/primitive.cjs");var ot=g(require("react"),1),rt=require("../utils/part.cjs"),se=require("../utils/primitive.cjs");var at=require("react/jsx-runtime"),q=ot.forwardRef(({columnKey:e,...t},r)=>{let o=p("TableColumnHeaderSortTrigger"),a=V("TableColumnHeaderSortTrigger"),n=e??(a.sortable?a.columnKey:void 0);if(n===void 0)return null;let s=o.sortList.findIndex(f=>f.columnKey===n),c=o.sortList[s]?.direction;return(0,at.jsx)(se.Primitive.button,{type:"button","data-skdx-table-sort-trigger":"","data-sort-direction":c,"data-sort-index":o.multiSort&&s!==-1?s:void 0,...t,...(0,rt.skdxPart)("table","column-header-sort-trigger",t.className),ref:r,onClick:(0,se.composeEventHandlers)(t.onClick,f=>{o.toggleSort(n,f.currentTarget.textContent?.trim()||n)})})});q.displayName="TableColumnHeaderSortTrigger";var W=g(require("react"),1),nt=require("../utils/clamp.cjs"),lt=require("../utils/composeRefs.cjs"),B=require("../utils/direction.cjs"),it=require("../utils/part.cjs"),I=require("../utils/primitive.cjs"),de=require("../utils/useCallbackRef.cjs");var st=require("react/jsx-runtime"),po=40,bo=1e3,uo=8,To=new Set(["ArrowLeft","ArrowRight","Home","End"]),ce=W.forwardRef(({columnKey:e,minWidth:t,maxWidth:r,step:o,label:a,...n},s)=>{let c=p("TableColumnResizeTrigger"),f=V("TableColumnResizeTrigger"),P=(0,B.useDirection)(),k=W.useRef(null),E=(0,lt.useComposedRefs)(s,k),x=W.useRef(null),[C,M]=W.useState(!1),d=e??f.columnKey,S=t??f.minWidth??po,T=r??f.maxWidth??bo,h=o??f.resizeStep??uo,A=d===void 0?void 0:c.columnWidths[d],F=W.useRef(!1),D=(0,de.useCallbackRef)(i=>{if(d===void 0)return;let R=(0,nt.clamp)(Math.round(i),S,T);R!==c.columnWidths[d]&&(F.current=!0),c.setColumnWidth(d,R)}),z=(0,de.useCallbackRef)(()=>{F.current&&(F.current=!1,c.commitColumnWidths())}),X=()=>A!==void 0?A:(k.current?.closest("th")?.getBoundingClientRect().width??0)||S,K=(0,de.useCallbackRef)(()=>{let i=x.current;if(!i)return null;x.current=null,M(!1);let R=k.current;return R?.hasPointerCapture?.(i.pointerId)&&R.releasePointerCapture(i.pointerId),i});return W.useEffect(()=>{if(!C)return;let i=R=>{if(R.key!=="Escape")return;let H=K();H&&(D(H.startWidth),z())};return document.addEventListener("keydown",i),()=>document.removeEventListener("keydown",i)},[C,K,D,z]),d===void 0?null:(0,st.jsx)(I.Primitive.span,{role:"separator","aria-orientation":"vertical","aria-label":a??f.resizeLabel??"Resize column","aria-valuenow":Math.round(A??S),"aria-valuemin":S,"aria-valuemax":T,tabIndex:0,"data-skdx-table-resizer":"","data-dragging":C?"":void 0,...n,...(0,it.skdxPart)("table","column-resize-trigger",n.className),ref:E,onPointerDown:(0,I.composeEventHandlers)(n.onPointerDown,i=>{i.button===0&&(i.preventDefault(),i.stopPropagation(),x.current={startX:i.clientX,startWidth:X(),pointerId:i.pointerId},M(!0),i.currentTarget.setPointerCapture?.(i.pointerId))}),onPointerMove:(0,I.composeEventHandlers)(n.onPointerMove,i=>{let R=x.current;if(!R)return;let _=(0,B.resolveDirection)(i.currentTarget,P)==="rtl"?R.startX-i.clientX:i.clientX-R.startX;D(R.startWidth+_)}),onPointerUp:(0,I.composeEventHandlers)(n.onPointerUp,()=>{K()&&z()}),onPointerCancel:(0,I.composeEventHandlers)(n.onPointerCancel,()=>{K()&&z()}),onKeyDown:(0,I.composeEventHandlers)(n.onKeyDown,i=>{let R=(0,B.directionalKey)(i.key,i.currentTarget,P);if(R==="ArrowRight")D(X()+h);else if(R==="ArrowLeft")D(X()-h);else if(i.key==="Home")D(S);else if(i.key==="End")D(T);else return;i.preventDefault(),i.stopPropagation()}),onKeyUp:(0,I.composeEventHandlers)(n.onKeyUp,i=>{To.has(i.key)&&z()})})});ce.displayName="TableColumnResizeTrigger";var v=require("react/jsx-runtime");function mt(e){return N.Children.toArray(e).some(t=>N.isValidElement(t)?t.type===q?!0:t.type===N.Fragment&&mt(t.props.children):!1)}var O=N.forwardRef(({columnKey:e,sortable:t,resizable:r=!1,minWidth:o=40,maxWidth:a=1e3,resizeLabel:n="Resize column",resizeStep:s=8,children:c,style:f,...P},k)=>{let E=p("TableHeaderCell"),x=t&&e!==void 0,C=x?E.sortList.find(F=>F.columnKey===e)?.direction:void 0,M=x?C==="asc"?"ascending":C==="desc"?"descending":"none":void 0,d=r&&e!==void 0,S=e===void 0?void 0:E.columnWidths[e],T=P.asChild&&N.isValidElement(c)?c:null,h=T?T.props.children:c,A=(0,v.jsxs)(v.Fragment,{children:[x&&!mt(h)?(0,v.jsx)(q,{children:h}):h,d?(0,v.jsx)(ce,{}):null]});return(0,v.jsx)(Ce,{columnKey:e,sortable:x,minWidth:o,maxWidth:a,resizeLabel:n,resizeStep:s,children:(0,v.jsx)(ct.Primitive.th,{"aria-sort":M,"data-sort-direction":C,"data-resizable":d?"":void 0,style:S===void 0?f:{...f,width:S,"--skdx-table-column-width":`${S}px`},...P,...(0,dt.skdxPart)("table","header-cell",P.className),ref:k,children:T?N.cloneElement(T,void 0,A):A})})});O.displayName="TableHeaderCell";var ft=g(require("react"),1),pt=require("../utils/part.cjs"),me=require("../utils/primitive.cjs");var bt=require("react/jsx-runtime"),Ro='button, a, input, [role="button"]',U=ft.forwardRef(({rowId:e,...t},r)=>{let o=p("TableRow"),a=e!==void 0&&o.isRowSelected(e),n=o.selectionMode!=="none"&&e!==void 0;return(0,bt.jsx)(me.Primitive.tr,{"data-state":a?"selected":void 0,"data-row-id":n?e:void 0,...t,...(0,pt.skdxPart)("table","row",t.className),ref:r,onClick:(0,me.composeEventHandlers)(t.onClick,s=>{!n||s.target.closest(Ro)||o.toggleRow(e,s.shiftKey)})})});U.displayName="TableRow";var ut=g(require("react"),1),Tt=require("../checkbox/Checkbox.cjs"),Rt=require("../utils/part.cjs"),gt=require("../utils/primitive.cjs");var xt=require("react/jsx-runtime"),fe=ut.forwardRef(({rowId:e,...t},r)=>{let o=p("TableRowSelectCheckbox");return(0,xt.jsx)(Tt.Checkbox,{...t,...(0,Rt.skdxPart)("table","row-select-checkbox",t.className),ref:r,checked:o.isRowSelected(e),"data-skdx-table-row-select":"",onClick:(0,gt.composeEventHandlers)(t.onClick,a=>{t.readOnly||o.toggleRow(e,a.shiftKey)})})});fe.displayName="TableRowSelectCheckbox";var Ct=g(require("react"),1),yt=require("../checkbox/Checkbox.cjs"),St=require("../utils/part.cjs"),ht=require("../utils/primitive.cjs");var Pt=require("react/jsx-runtime");function wt(e,t){let r=`${t} ${t===1?"row":"rows"}`;return e==="page"?`Select all ${r} on this page`:`Select all ${r}`}var pe=Ct.forwardRef(({rowIds:e,scope:t,getSelectAllLabel:r=wt,...o},a)=>{let n=p("TableSelectAllCheckbox"),s=n.isAllSelected(e)?!0:n.isSomeSelected(e)?"indeterminate":!1;return(0,Pt.jsx)(yt.Checkbox,{"aria-label":r(t,e.length),...o,...(0,St.skdxPart)("table","select-all-checkbox",o.className),ref:a,checked:s,"data-skdx-table-select-all":"","data-scope":t,onClick:(0,ht.composeEventHandlers)(o.onClick,()=>{o.readOnly||n.toggleAll(e)})})});pe.displayName="TableSelectAllCheckbox";var b=require("react/jsx-runtime");function be(e,t){return e&&typeof e=="object"?e[t]:void 0}function go(e,t){return typeof e=="number"&&typeof t=="number"?e-t:e instanceof Date&&t instanceof Date?e.getTime()-t.getTime():String(e??"").localeCompare(String(t??""))}function xo(e,t){return t.length===0?[...e]:[...e].sort((r,o)=>{for(let{columnKey:a,direction:n}of t){let s=go(be(r,a),be(o,a));if(s!==0)return n==="desc"?-s:s}return 0})}function Co(e,t){let r=be(e,"id");return String(typeof r=="string"||typeof r=="number"?r:t)}function kt({columns:e,data:t,sortable:r,selectable:o,expandable:a,renderExpanded:n,resizable:s,empty:c,caption:f,renderCell:P,rowId:k=Co}){let E=p("Table"),x=Math.max(e.length+(o?1:0)+(a?1:0),1),C=G.useMemo(()=>xo(t,E.sortList),[t,E.sortList]),M=G.useMemo(()=>C.map((d,S)=>k(d,S)),[C,k]);return(0,b.jsxs)(b.Fragment,{children:[f?(0,b.jsx)(oe,{children:f}):null,(0,b.jsx)(ie,{children:(0,b.jsxs)(U,{children:[o?(0,b.jsx)(O,{children:(0,b.jsx)(pe,{scope:"page",rowIds:M})}):null,a?(0,b.jsx)(O,{"aria-hidden":"true"}):null,e.map(d=>(0,b.jsx)(O,{columnKey:d.key,sortable:d.sortable??r,resizable:d.resizable??s,minWidth:d.minWidth,maxWidth:d.maxWidth,children:d.header??d.key},d.key))]})}),(0,b.jsx)(te,{children:C.length===0?c?(0,b.jsx)(re,{colSpan:x,children:c}):null:C.map((d,S)=>{let T=M[S];return(0,b.jsxs)(G.Fragment,{children:[(0,b.jsxs)(U,{rowId:T,children:[o?(0,b.jsx)($,{children:(0,b.jsx)(fe,{rowId:T,"aria-label":`Select row ${T}`})}):null,a?(0,b.jsx)($,{children:(0,b.jsx)(le,{rowId:T,"aria-label":`Details for row ${T}`})}):null,e.map(h=>(0,b.jsx)($,{children:h.cell?h.cell(d):P?P(d,h):String(be(d,h.key)??"")},h.key))]}),a?(0,b.jsx)(ae,{rowId:T,colSpan:x,children:n?.(d)}):null]},T)})})]})}var J=require("react/jsx-runtime");function Et(e){return e===void 0?new Set:e instanceof Set?e:new Set(e)}var Ht=[],Nt={},Lt=[];function yo(e,t,r){let o=e.find(n=>n.columnKey===t),a=o===void 0?"asc":o.direction==="asc"?"desc":null;return r?a===null?e.filter(n=>n.columnKey!==t):o===void 0?[...e,{columnKey:t,direction:a}]:e.map(n=>n.columnKey===t?{columnKey:t,direction:a}:n):a===null?[]:[{columnKey:t,direction:a}]}function vt(e,t){return t===null?`${e} not sorted`:`${e} sorted ${t==="asc"?"ascending":"descending"}`}var[zt,p]=(0,ye.createSafeContext)("Table"),[Ce,V]=(0,ye.createSafeContext)("TableHeaderCell",{});function Y(e,t){return`${e}-detail-${t}`}var Se=m.forwardRef(({sort:e,defaultSort:t=Lt,onSortChange:r,multiSort:o=!1,selected:a,defaultSelected:n,onSelectedChange:s,selectionMode:c="none",getSortLabel:f=vt,expandedRowIds:P,defaultExpandedRowIds:k=Ht,onExpandedRowIdsChange:E,columnWidths:x,defaultColumnWidths:C,onColumnWidthsChange:M,onColumnWidthsCommit:d,rowCount:S,columnCount:T,children:h,...A},F)=>{let D=m.useId(),z=m.useRef(null),X=(0,Wt.useComposedRefs)(F,z),[K=Lt,i]=(0,Z.useControllableState)({prop:e,defaultProp:t,onChange:r}),R=m.useMemo(()=>a===void 0?void 0:Et(a),[a]),[H=new Set,_]=(0,Z.useControllableState)({prop:R,defaultProp:Et(n??[]),onChange:l=>s?.([...l])}),qt=m.useCallback((l,u=l)=>{let y=yo(K,l,o);i(y);let w=y.find(L=>L.columnKey===l)?.direction??null;(0,Mt.announce)(f(u,w))},[K,o,i,f]),we=m.useCallback(()=>{let l=z.current?.querySelectorAll(":scope > tbody > tr[data-row-id]");return l?[...l].map(u=>u.dataset.rowId):[]},[]),Pe=m.useRef(null),Gt=m.useCallback((l,u=!1)=>{if(c==="none")return;let y=Pe.current;if(u&&c==="multiple"&&y!==null&&y!==l){let w=we(),L=w.indexOf(y),Re=w.indexOf(l);if(L!==-1&&Re!==-1){let ro=w.slice(Math.min(L,Re),Math.max(L,Re)+1);_((ao=new Set)=>new Set([...ao,...ro]));return}}Pe.current=l,_((w=new Set)=>{if(c==="single")return w.has(l)&&w.size===1?new Set:new Set([l]);let L=new Set(w);return L.has(l)?L.delete(l):L.add(l),L})},[c,_,we]),[ke=Ht,Ee]=(0,Z.useControllableState)({prop:P,defaultProp:k,onChange:E}),ue=m.useMemo(()=>new Set(ke),[ke]),[Q=Nt,He]=(0,Z.useControllableState)({prop:x,defaultProp:C??Nt,onChange:M}),Zt=m.useCallback(l=>{Ee((u=[])=>u.includes(l)?u.filter(y=>y!==l):[...u,l])},[Ee]),Jt=m.useCallback(l=>ue.has(l),[ue]),j=m.useRef(Q);m.useLayoutEffect(()=>{j.current=Q},[Q]);let Qt=m.useCallback((l,u)=>{let y=j.current;if(y[l]===u)return;let w={...y,[l]:u};j.current=w,He(w)},[He]),Ne=(0,It.useCallbackRef)(d),jt=m.useCallback(()=>{Ne(j.current)},[Ne]),eo=m.useCallback(l=>H.has(l),[H]),Te=m.useCallback(l=>l.length>0&&l.every(u=>H.has(u)),[H]),to=m.useCallback(l=>l.some(u=>H.has(u))&&!Te(l),[H,Te]),oo=m.useCallback(l=>{c!=="none"&&_((u=new Set)=>{if(l.length>0&&l.every(y=>u.has(y))){let y=new Set(u);return l.forEach(w=>y.delete(w)),y}return new Set([...u,...l])})},[c,_]);return(0,J.jsx)(zt,{tableId:D,sortList:K,multiSort:o,selected:H,selectionMode:c,toggleSort:qt,toggleRow:Gt,isRowSelected:eo,toggleAll:oo,isAllSelected:Te,isSomeSelected:to,expandedRows:ue,toggleRowExpanded:Zt,isRowExpanded:Jt,columnWidths:Q,setColumnWidth:Qt,commitColumnWidths:jt,children:(0,J.jsx)(Dt.Primitive.table,{"aria-rowcount":S,"aria-colcount":T,...A,...(0,At.skdxPart)("table","root",A.className),ref:X,children:h})})});Se.displayName="TableRoot";function So({columns:e,data:t,sortable:r=!1,selectable:o=!1,expandable:a=!1,renderExpanded:n,resizable:s=!1,empty:c,caption:f,renderCell:P,rowId:k,selectionMode:E,...x},C){return(0,J.jsx)(Se,{...x,selectionMode:E??(o?"multiple":"none"),ref:C,children:(0,J.jsx)(kt,{columns:e,data:t,sortable:r,selectable:o,expandable:a,renderExpanded:n,resizable:s,empty:c,caption:f,renderCell:P,rowId:k})})}var he=m.forwardRef(So);he.displayName="Table";var Kt=g(require("react"),1),Ft=require("../utils/part.cjs"),_t=require("../utils/primitive.cjs"),Vt=require("react/jsx-runtime"),$t=Kt.forwardRef((e,t)=>(0,Vt.jsx)(_t.Primitive.tfoot,{...e,...(0,Ft.skdxPart)("table","footer",e.className),ref:t}));$t.displayName="TableFooter";var Bt=g(require("react"),1),Ot=require("../utils/part.cjs"),Ut=require("../utils/primitive.cjs");var Yt=require("react/jsx-runtime"),Xt=Bt.forwardRef(({columnKey:e,...t},r)=>{let o=p("TableSortIndicator"),a=V("TableSortIndicator"),n=e??a.columnKey,s=n===void 0?-1:o.sortList.findIndex(f=>f.columnKey===n),c=o.sortList[s]?.direction??"none";return(0,Yt.jsx)(Ut.Primitive.span,{"aria-hidden":"true","data-skdx-table-sort-indicator":"","data-sort-direction":c,"data-sort-index":o.multiSort&&s!==-1?s:void 0,...t,...(0,Ot.skdxPart)("table","sort-indicator",t.className),ref:r})});Xt.displayName="TableSortIndicator";0&&(module.exports={Table,TableBody,TableCaption,TableCell,TableColumnHeaderSortTrigger,TableColumnResizeTrigger,TableEmpty,TableExpandTrigger,TableExpandedRow,TableFooter,TableHeader,TableHeaderCell,TableHeaderCellProvider,TableProvider,TableRoot,TableRow,TableRowSelectCheckbox,TableSelectAllCheckbox,TableSortIndicator,defaultGetSortLabel,defaultSelectAllLabel,tableDetailRowId,useTableContext,useTableHeaderCellContext});

package/dist/table/Table.d.cts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { SortDirection, TableContextValue, TableHeaderCellContextValue, TableProps } from './types.cjs';
+import type { SortDirection, TableContextValue, TableHeaderCellContextValue, TableProps, TableRootProps } from './types.cjs';
 /** Default `getSortLabel`: `"Amount sorted ascending"` / `"Amount not sorted"`. */
 export declare function defaultGetSortLabel(column: string, direction: SortDirection | null): string;
 /**
@@ -26,7 +26,7 @@ export declare const TableProvider: {
  * Column-scoped defaults published by a `TableHeaderCell` to the sort and
  * resize parts nested inside it. Defaulted to an empty object rather than
  * throwing, because those parts are also legal outside a header cell — they
- * just need their own `sortKey`/`columnKey` there.
+ * just need their own `columnKey` there.
  */
 export declare const TableHeaderCellProvider: {
     (props: TableHeaderCellContextValue & {
@@ -46,33 +46,62 @@ export declare function tableDetailRowId(tableId: string, rowId: string): string
  * `TableHeaderCell` / `TableRow` via context. Renders a plain `<table>`.
  * Consumers map over their own row data to render `TableRow`/`TableCell`s.
  *
+ * This is the primitive the `Table` recipe (`Table.tsx`'s default export) is
+ * built from — reach for it directly, via `TableRoot` from
+ * `@skdx/react/primitives/table`, for full manual composition of the parts.
+ *
  * Sort and selection each work controlled (`sort`/`selected` +
  * `onSortChange`/`onSelectedChange`) or uncontrolled (`defaultSort`/`defaultSelected`),
  * as do expanded detail rows (`expandedRowIds`) and column widths (`columnWidths`).
  *
- * `multiSort` lets several columns be sorted at once, at which point `sort`
- * becomes an array ordered most-significant-first. **The table never reorders
- * your rows** — it publishes sort state and you sort the data.
+ * `sort` is always a `TableSortState[]`, ordered most-significant-first and
+ * empty when nothing is sorted; `multiSort` decides only whether it may hold
+ * more than one entry. **The table never reorders your rows** — it publishes
+ * sort state and you sort the data.
+ *
+ * **A `selectionMode` other than `'none'` obliges you to render a
+ * `TableRowSelectCheckbox` in every selectable row.** Clicking the row is a
+ * pointer shortcut, and the `<tr>` is deliberately not focusable — in a
+ * `role="table"` every focusable element joins the page tab sequence, so
+ * focusable rows would put the whole table body in it. The checkbox is the
+ * keyboard path, and `assertTableSelectionContract` from `@skdx/shared/testing`
+ * fails a table that omits it.
  *
  * @example
  * ```tsx
- * <Table selectionMode="multiple">
+ * import { TableBody, TableCaption, TableCell, TableHeader, TableHeaderCell, TableRoot, TableRow, TableRowSelectCheckbox, TableSelectAllCheckbox } from '@skdx/react/primitives/table';
+ *
+ * <TableRoot selectionMode="multiple">
  *   <TableCaption>A list of recent invoices.</TableCaption>
  *   <TableHeader>
  *     <TableRow>
- *       <TableHeaderCell sortKey="name">Name</TableHeaderCell>
- *       <TableHeaderCell sortKey="amount">Amount</TableHeaderCell>
+ *       <TableHeaderCell>
+ *         <TableSelectAllCheckbox scope="page" rowIds={rows.map((row) => row.id)} />
+ *       </TableHeaderCell>
+ *       <TableHeaderCell columnKey="name" sortable>Name</TableHeaderCell>
+ *       <TableHeaderCell columnKey="amount" sortable>Amount</TableHeaderCell>
  *     </TableRow>
  *   </TableHeader>
  *   <TableBody>
  *     {rows.map((row) => (
  *       <TableRow key={row.id} rowId={row.id}>
+ *         <TableCell>
+ *           <TableRowSelectCheckbox rowId={row.id} aria-label={`Select ${row.name}`} />
+ *         </TableCell>
  *         <TableCell>{row.name}</TableCell>
  *         <TableCell>{row.amount}</TableCell>
  *       </TableRow>
  *     ))}
  *   </TableBody>
- * </Table>
+ * </TableRoot>
  * ```
  */
-export declare const Table: React.ForwardRefExoticComponent<Omit<TableProps, "ref"> & React.RefAttributes<HTMLTableElement>>;
+export declare const TableRoot: React.ForwardRefExoticComponent<Omit<TableRootProps, "ref"> & React.RefAttributes<HTMLTableElement>>;
+/** @internal Cast for the generic-over-`T` `forwardRef` pattern — `React.forwardRef` itself cannot express a generic component. */
+type TableComponent = (<T>(props: TableProps<T> & {
+    ref?: React.ForwardedRef<HTMLTableElement>;
+}) => React.ReactElement | null) & {
+    displayName?: string;
+};
+export declare const Table: TableComponent;
+export {};

package/dist/table/Table.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { SortDirection, TableContextValue, TableHeaderCellContextValue, TableProps } from './types.js';
+import type { SortDirection, TableContextValue, TableHeaderCellContextValue, TableProps, TableRootProps } from './types.js';
 /** Default `getSortLabel`: `"Amount sorted ascending"` / `"Amount not sorted"`. */
 export declare function defaultGetSortLabel(column: string, direction: SortDirection | null): string;
 /**
@@ -26,7 +26,7 @@ export declare const TableProvider: {
  * Column-scoped defaults published by a `TableHeaderCell` to the sort and
  * resize parts nested inside it. Defaulted to an empty object rather than
  * throwing, because those parts are also legal outside a header cell — they
- * just need their own `sortKey`/`columnKey` there.
+ * just need their own `columnKey` there.
  */
 export declare const TableHeaderCellProvider: {
     (props: TableHeaderCellContextValue & {
@@ -46,33 +46,62 @@ export declare function tableDetailRowId(tableId: string, rowId: string): string
  * `TableHeaderCell` / `TableRow` via context. Renders a plain `<table>`.
  * Consumers map over their own row data to render `TableRow`/`TableCell`s.
  *
+ * This is the primitive the `Table` recipe (`Table.tsx`'s default export) is
+ * built from — reach for it directly, via `TableRoot` from
+ * `@skdx/react/primitives/table`, for full manual composition of the parts.
+ *
  * Sort and selection each work controlled (`sort`/`selected` +
  * `onSortChange`/`onSelectedChange`) or uncontrolled (`defaultSort`/`defaultSelected`),
  * as do expanded detail rows (`expandedRowIds`) and column widths (`columnWidths`).
  *
- * `multiSort` lets several columns be sorted at once, at which point `sort`
- * becomes an array ordered most-significant-first. **The table never reorders
- * your rows** — it publishes sort state and you sort the data.
+ * `sort` is always a `TableSortState[]`, ordered most-significant-first and
+ * empty when nothing is sorted; `multiSort` decides only whether it may hold
+ * more than one entry. **The table never reorders your rows** — it publishes
+ * sort state and you sort the data.
+ *
+ * **A `selectionMode` other than `'none'` obliges you to render a
+ * `TableRowSelectCheckbox` in every selectable row.** Clicking the row is a
+ * pointer shortcut, and the `<tr>` is deliberately not focusable — in a
+ * `role="table"` every focusable element joins the page tab sequence, so
+ * focusable rows would put the whole table body in it. The checkbox is the
+ * keyboard path, and `assertTableSelectionContract` from `@skdx/shared/testing`
+ * fails a table that omits it.
  *
  * @example
  * ```tsx
- * <Table selectionMode="multiple">
+ * import { TableBody, TableCaption, TableCell, TableHeader, TableHeaderCell, TableRoot, TableRow, TableRowSelectCheckbox, TableSelectAllCheckbox } from '@skdx/react/primitives/table';
+ *
+ * <TableRoot selectionMode="multiple">
  *   <TableCaption>A list of recent invoices.</TableCaption>
  *   <TableHeader>
  *     <TableRow>
- *       <TableHeaderCell sortKey="name">Name</TableHeaderCell>
- *       <TableHeaderCell sortKey="amount">Amount</TableHeaderCell>
+ *       <TableHeaderCell>
+ *         <TableSelectAllCheckbox scope="page" rowIds={rows.map((row) => row.id)} />
+ *       </TableHeaderCell>
+ *       <TableHeaderCell columnKey="name" sortable>Name</TableHeaderCell>
+ *       <TableHeaderCell columnKey="amount" sortable>Amount</TableHeaderCell>
  *     </TableRow>
  *   </TableHeader>
  *   <TableBody>
  *     {rows.map((row) => (
  *       <TableRow key={row.id} rowId={row.id}>
+ *         <TableCell>
+ *           <TableRowSelectCheckbox rowId={row.id} aria-label={`Select ${row.name}`} />
+ *         </TableCell>
  *         <TableCell>{row.name}</TableCell>
  *         <TableCell>{row.amount}</TableCell>
  *       </TableRow>
  *     ))}
  *   </TableBody>
- * </Table>
+ * </TableRoot>
  * ```
  */
-export declare const Table: React.ForwardRefExoticComponent<Omit<TableProps, "ref"> & React.RefAttributes<HTMLTableElement>>;
+export declare const TableRoot: React.ForwardRefExoticComponent<Omit<TableRootProps, "ref"> & React.RefAttributes<HTMLTableElement>>;
+/** @internal Cast for the generic-over-`T` `forwardRef` pattern — `React.forwardRef` itself cannot express a generic component. */
+type TableComponent = (<T>(props: TableProps<T> & {
+    ref?: React.ForwardedRef<HTMLTableElement>;
+}) => React.ReactElement | null) & {
+    displayName?: string;
+};
+export declare const Table: TableComponent;
+export {};

package/dist/table/Table.js

@@ -1 +1 @@
-import*as s from"react";import{useComposedRefs as Xe}from"../utils/composeRefs.js";import{createSafeContext as te}from"../utils/createContext.js";import{announce as Oe}from"../utils/liveAnnouncer.js";import{skdxPart as Ue}from"../utils/part.js";import{Primitive as Ye}from"../utils/primitive.js";import{useControllableState as B}from"../utils/useControllableState.js";import{jsx as ee}from"react/jsx-runtime";function Z(e){return e===void 0?new Set:e instanceof Set?e:new Set(e)}var j=[],O={};function qe(e){return e?Array.isArray(e)?e:[e]:[]}function Ge(e,t,i){let o=e.find(r=>r.columnKey===t),l=o===void 0?"asc":o.direction==="asc"?"desc":null;return i?l===null?e.filter(r=>r.columnKey!==t):o===void 0?[...e,{columnKey:t,direction:l}]:e.map(r=>r.columnKey===t?{columnKey:t,direction:l}:r):l===null?[]:[{columnKey:t,direction:l}]}function Je(e,t){return t===null?`${e} not sorted`:`${e} sorted ${t==="asc"?"ascending":"descending"}`}var[Qe,f]=te("Table"),[oe,z]=te("TableHeaderCell",{});function F(e,t){return`${e}-detail-${t}`}var Ze=s.forwardRef(({sort:e,defaultSort:t=null,onSortChange:i,multiSort:o=!1,selected:l,defaultSelected:r,onSelectedChange:d,selectionMode:m="none",getSortLabel:b=Je,expandedRowIds:H,defaultExpandedRowIds:L=j,onExpandedRowIdsChange:A,columnWidths:C,defaultColumnWidths:y,onColumnWidthsChange:W,...u},g)=>{let S=s.useId(),N=s.useRef(null),v=Xe(g,N),[w=null,D]=B({prop:e,defaultProp:t,onChange:i}),k=s.useMemo(()=>qe(w),[w]),n=k[0]??null,T=s.useMemo(()=>l===void 0?void 0:Z(l),[l]),[R=new Set,M]=B({prop:T,defaultProp:Z(r??[]),onChange:a=>d?.([...a])}),We=s.useCallback((a,c=a)=>{let p=Ge(k,a,o);D(o?p:p[0]??null);let x=p.find(P=>P.columnKey===a)?.direction??null;Oe(b(c,x))},[k,o,D,b]),Y=s.useCallback(()=>{let a=N.current?.querySelectorAll(":scope > tbody > tr[data-row-id]");return a?[...a].map(c=>c.dataset.rowId):[]},[]),q=s.useRef(null),De=s.useCallback((a,c=!1)=>{if(m==="none")return;let p=q.current;if(c&&m==="multiple"&&p!==null&&p!==a){let x=Y(),P=x.indexOf(p),X=x.indexOf(a);if(P!==-1&&X!==-1){let $e=x.slice(Math.min(P,X),Math.max(P,X)+1);M((Ve=new Set)=>new Set([...Ve,...$e]));return}}q.current=a,M((x=new Set)=>{if(m==="single")return x.has(a)&&x.size===1?new Set:new Set([a]);let P=new Set(x);return P.has(a)?P.delete(a):P.add(a),P})},[m,M,Y]),[G=j,J]=B({prop:H,defaultProp:L,onChange:A}),$=s.useMemo(()=>new Set(G),[G]),[ze=O,Q]=B({prop:C,defaultProp:y??O,onChange:W}),ve=s.useCallback(a=>{J((c=[])=>c.includes(a)?c.filter(p=>p!==a):[...c,a])},[J]),Ie=s.useCallback(a=>$.has(a),[$]),Ke=s.useCallback((a,c)=>{Q((p=O)=>p[a]===c?p:{...p,[a]:c})},[Q]),Be=s.useCallback(a=>R.has(a),[R]),V=s.useCallback(a=>a.length>0&&a.every(c=>R.has(c)),[R]),Fe=s.useCallback(a=>a.some(c=>R.has(c))&&!V(a),[R,V]),_e=s.useCallback(a=>{m!=="none"&&M((c=new Set)=>{if(a.length>0&&a.every(p=>c.has(p))){let p=new Set(c);return a.forEach(x=>p.delete(x)),p}return new Set([...c,...a])})},[m,M]);return ee(Qe,{tableId:S,sort:n,sortList:k,multiSort:o,selected:R,selectionMode:m,toggleSort:We,toggleRow:De,isRowSelected:Be,toggleAll:_e,isAllSelected:V,isSomeSelected:Fe,expandedRows:$,toggleRowExpanded:ve,isRowExpanded:Ie,columnWidths:ze,setColumnWidth:Ke,children:ee(Ye.table,{...u,...Ue("table","root",u.className),ref:v})})});Ze.displayName="Table";import*as re from"react";import{skdxPart as je}from"../utils/part.js";import{Primitive as et}from"../utils/primitive.js";import{jsx as tt}from"react/jsx-runtime";var ae=re.forwardRef((e,t)=>tt(et.thead,{...e,...je("table","header",e.className),ref:t}));ae.displayName="TableHeader";import*as ne from"react";import{skdxPart as ot}from"../utils/part.js";import{Primitive as rt}from"../utils/primitive.js";import{jsx as at}from"react/jsx-runtime";var le=ne.forwardRef((e,t)=>at(rt.tbody,{...e,...ot("table","body",e.className),ref:t}));le.displayName="TableBody";import*as ie from"react";import{skdxPart as nt}from"../utils/part.js";import{Primitive as lt}from"../utils/primitive.js";import{jsx as it}from"react/jsx-runtime";var se=ie.forwardRef((e,t)=>it(lt.tfoot,{...e,...nt("table","footer",e.className),ref:t}));se.displayName="TableFooter";import*as de from"react";import{skdxPart as st}from"../utils/part.js";import{composeEventHandlers as dt,Primitive as ct}from"../utils/primitive.js";import{jsx as pt}from"react/jsx-runtime";var mt='button, a, input, [role="button"]',ce=de.forwardRef(({rowId:e,...t},i)=>{let o=f("TableRow"),l=e!==void 0&&o.isRowSelected(e),r=o.selectionMode!=="none"&&e!==void 0;return pt(ct.tr,{"aria-selected":r?l:void 0,"data-state":l?"selected":void 0,"data-row-id":r?e:void 0,...t,...st("table","row",t.className),ref:i,onClick:dt(t.onClick,d=>{!r||d.target.closest(mt)||o.toggleRow(e,d.shiftKey)})})});ce.displayName="TableRow";import*as E from"react";import{skdxPart as Ht}from"../utils/part.js";import{Primitive as Lt}from"../utils/primitive.js";import*as me from"react";import{skdxPart as ft}from"../utils/part.js";import{composeEventHandlers as bt,Primitive as ut}from"../utils/primitive.js";import{jsx as Tt}from"react/jsx-runtime";var I=me.forwardRef(({sortKey:e,...t},i)=>{let o=f("TableColumnHeaderSortTrigger"),l=z("TableColumnHeaderSortTrigger"),r=e??l.sortKey;if(r===void 0)return null;let d=o.sortList.findIndex(b=>b.columnKey===r),m=o.sortList[d]?.direction;return Tt(ut.button,{type:"button","data-skdx-table-sort-trigger":"","data-sort-direction":m,"data-sort-index":o.multiSort&&d!==-1?d:void 0,...t,...ft("table","column-header-sort-trigger",t.className),ref:i,onClick:bt(t.onClick,b=>{o.toggleSort(r,b.currentTarget.textContent?.trim()||r)})})});I.displayName="TableColumnHeaderSortTrigger";import*as h from"react";import{clamp as gt}from"../utils/clamp.js";import{useComposedRefs as Rt}from"../utils/composeRefs.js";import{directionalKey as xt,resolveDirection as Ct,useDirection as St}from"../utils/direction.js";import{skdxPart as Pt}from"../utils/part.js";import{composeEventHandlers as K,Primitive as yt}from"../utils/primitive.js";import{jsx as Et}from"react/jsx-runtime";var wt=40,ht=1e3,kt=8,_=h.forwardRef(({columnKey:e,minWidth:t,maxWidth:i,step:o,label:l,...r},d)=>{let m=f("TableColumnResizeTrigger"),b=z("TableColumnResizeTrigger"),H=St(),L=h.useRef(null),A=Rt(d,L),C=h.useRef(null),[y,W]=h.useState(!1),u=e??b.columnKey,g=t??b.minWidth??wt,S=i??b.maxWidth??ht,N=o??b.resizeStep??kt,v=u===void 0?void 0:m.columnWidths[u],w=n=>{u!==void 0&&m.setColumnWidth(u,gt(Math.round(n),g,S))},D=()=>v!==void 0?v:(L.current?.closest("th")?.getBoundingClientRect().width??0)||g,k=()=>{let n=C.current;if(!n)return null;C.current=null,W(!1);let T=L.current;return T?.hasPointerCapture?.(n.pointerId)&&T.releasePointerCapture(n.pointerId),n};return h.useEffect(()=>{if(!y)return;let n=T=>{if(T.key!=="Escape")return;let R=k();R&&w(R.startWidth)};return document.addEventListener("keydown",n),()=>document.removeEventListener("keydown",n)},[y,u,g,S]),u===void 0?null:Et(yt.span,{role:"separator","aria-orientation":"vertical","aria-label":l??b.resizeLabel??"Resize column","aria-valuenow":Math.round(v??g),"aria-valuemin":g,"aria-valuemax":S,tabIndex:0,"data-skdx-table-resizer":"","data-dragging":y?"":void 0,...r,...Pt("table","column-resize-trigger",r.className),ref:A,onPointerDown:K(r.onPointerDown,n=>{n.button===0&&(n.preventDefault(),n.stopPropagation(),C.current={startX:n.clientX,startWidth:D(),pointerId:n.pointerId},W(!0),n.currentTarget.setPointerCapture?.(n.pointerId))}),onPointerMove:K(r.onPointerMove,n=>{let T=C.current;if(!T)return;let M=Ct(n.currentTarget,H)==="rtl"?T.startX-n.clientX:n.clientX-T.startX;w(T.startWidth+M)}),onPointerUp:K(r.onPointerUp,k),onPointerCancel:K(r.onPointerCancel,k),onKeyDown:K(r.onKeyDown,n=>{let T=xt(n.key,n.currentTarget,H);if(T==="ArrowRight")w(D()+N);else if(T==="ArrowLeft")w(D()-N);else if(n.key==="Home")w(g);else if(n.key==="End")w(S);else return;n.preventDefault(),n.stopPropagation()})})});_.displayName="TableColumnResizeTrigger";import{jsx as U,jsxs as Nt}from"react/jsx-runtime";function pe(e){return E.Children.toArray(e).some(t=>E.isValidElement(t)?t.type===I?!0:t.type===E.Fragment&&pe(t.props.children):!1)}var fe=E.forwardRef(({sortKey:e,columnKey:t,resizable:i=!1,minWidth:o=40,maxWidth:l=1e3,resizeLabel:r="Resize column",resizeStep:d=8,children:m,style:b,...H},L)=>{let A=f("TableHeaderCell"),C=e!==void 0,y=C?A.sortList.find(N=>N.columnKey===e)?.direction:void 0,W=C?y==="asc"?"ascending":y==="desc"?"descending":"none":void 0,u=t??e,g=i&&u!==void 0,S=u===void 0?void 0:A.columnWidths[u];return U(oe,{sortKey:e,columnKey:u,minWidth:o,maxWidth:l,resizeLabel:r,resizeStep:d,children:Nt(Lt.th,{"aria-sort":W,"data-sort-direction":y,"data-resizable":g?"":void 0,style:S===void 0?b:{...b,width:S,"--skdx-table-column-width":`${S}px`},...H,...Ht("table","header-cell",H.className),ref:L,children:[C&&!pe(m)?U(I,{children:m}):m,g?U(_,{}):null]})})});fe.displayName="TableHeaderCell";import*as be from"react";import{skdxPart as Mt}from"../utils/part.js";import{Primitive as At}from"../utils/primitive.js";import{jsx as Wt}from"react/jsx-runtime";var ue=be.forwardRef((e,t)=>Wt(At.td,{...e,...Mt("table","cell",e.className),ref:t}));ue.displayName="TableCell";import*as Te from"react";import{skdxPart as Dt}from"../utils/part.js";import{Primitive as zt}from"../utils/primitive.js";import{jsx as vt}from"react/jsx-runtime";var ge=Te.forwardRef((e,t)=>vt(zt.caption,{...e,...Dt("table","caption",e.className),ref:t}));ge.displayName="TableCaption";import*as Re from"react";import{skdxPart as It}from"../utils/part.js";import{composeEventHandlers as Kt,Primitive as Bt}from"../utils/primitive.js";import{jsx as Ft}from"react/jsx-runtime";var xe=Re.forwardRef(({rowId:e,...t},i)=>{let o=f("TableExpandTrigger"),l=o.isRowExpanded(e);return Ft(Bt.button,{type:"button","aria-expanded":l,"aria-controls":F(o.tableId,e),"data-state":l?"expanded":"collapsed","data-skdx-table-expand-trigger":"",...t,...It("table","expand-trigger",t.className),ref:i,onClick:Kt(t.onClick,r=>{r.stopPropagation(),o.toggleRowExpanded(e)})})});xe.displayName="TableExpandTrigger";import*as Se from"react";import{skdxPart as _t}from"../utils/part.js";import{Primitive as $t}from"../utils/primitive.js";import{jsx as Ce}from"react/jsx-runtime";var Pe=Se.forwardRef(({rowId:e,colSpan:t=1,children:i,...o},l)=>{let r=f("TableExpandedRow"),d=r.isRowExpanded(e);return Ce($t.tr,{id:F(r.tableId,e),"data-state":d?"expanded":"collapsed","data-skdx-table-detail-row":"",hidden:!d,...o,..._t("table","expanded-row",o.className),ref:l,children:Ce("td",{colSpan:t,children:i})})});Pe.displayName="TableExpandedRow";import*as we from"react";import{skdxPart as Vt}from"../utils/part.js";import{Primitive as Xt}from"../utils/primitive.js";import{jsx as ye}from"react/jsx-runtime";var he=we.forwardRef(({colSpan:e=1,children:t,...i},o)=>ye(Xt.tr,{"data-state":"empty","data-skdx-table-empty":"",...i,...Vt("table","empty",i.className),ref:o,children:ye("td",{colSpan:e,children:t})}));he.displayName="TableEmpty";import*as ke from"react";import{skdxPart as Ot}from"../utils/part.js";import{Primitive as Ut}from"../utils/primitive.js";import{jsx as Yt}from"react/jsx-runtime";var Ee=ke.forwardRef(({sortKey:e,...t},i)=>{let o=f("TableSortIndicator"),l=z("TableSortIndicator"),r=e??l.sortKey,d=r===void 0?-1:o.sortList.findIndex(b=>b.columnKey===r),m=o.sortList[d]?.direction??"none";return Yt(Ut.span,{"aria-hidden":"true","data-skdx-table-sort-indicator":"","data-sort-direction":m,"data-sort-index":o.multiSort&&d!==-1?d:void 0,...t,...Ot("table","sort-indicator",t.className),ref:i})});Ee.displayName="TableSortIndicator";import*as He from"react";import{Checkbox as qt}from"../checkbox/Checkbox.js";import{skdxPart as Gt}from"../utils/part.js";import{composeEventHandlers as Jt}from"../utils/primitive.js";import{jsx as Qt}from"react/jsx-runtime";function Le(e,t){let i=`${t} ${t===1?"row":"rows"}`;return e==="page"?`Select all ${i} on this page`:`Select all ${i}`}var Ne=He.forwardRef(({rowIds:e,scope:t,getSelectAllLabel:i=Le,...o},l)=>{let r=f("TableSelectAllCheckbox"),d=r.isAllSelected(e)?!0:r.isSomeSelected(e)?"indeterminate":!1;return Qt(qt,{"aria-label":i(t,e.length),...o,...Gt("table","select-all-checkbox",o.className),ref:l,checked:d,"data-skdx-table-select-all":"","data-scope":t,onClick:Jt(o.onClick,()=>r.toggleAll(e))})});Ne.displayName="TableSelectAllCheckbox";import*as Me from"react";import{Checkbox as Zt}from"../checkbox/Checkbox.js";import{skdxPart as jt}from"../utils/part.js";import{composeEventHandlers as eo}from"../utils/primitive.js";import{jsx as to}from"react/jsx-runtime";var Ae=Me.forwardRef(({rowId:e,...t},i)=>{let o=f("TableRowSelectCheckbox");return to(Zt,{...t,...jt("table","row-select-checkbox",t.className),ref:i,checked:o.isRowSelected(e),"data-skdx-table-row-select":"",onClick:eo(t.onClick,l=>{o.toggleRow(e,l.shiftKey)})})});Ae.displayName="TableRowSelectCheckbox";export{Ze as Table,le as TableBody,ge as TableCaption,ue as TableCell,I as TableColumnHeaderSortTrigger,_ as TableColumnResizeTrigger,he as TableEmpty,xe as TableExpandTrigger,Pe as TableExpandedRow,se as TableFooter,ae as TableHeader,fe as TableHeaderCell,oe as TableHeaderCellProvider,Qe as TableProvider,ce as TableRow,Ae as TableRowSelectCheckbox,Ne as TableSelectAllCheckbox,Ee as TableSortIndicator,Je as defaultGetSortLabel,Le as defaultSelectAllLabel,F as tableDetailRowId,f as useTableContext,z as useTableHeaderCellContext};
+import*as m from"react";import{useComposedRefs as no}from"../utils/composeRefs.js";import{createSafeContext as Fe}from"../utils/createContext.js";import{announce as lo}from"../utils/liveAnnouncer.js";import{skdxPart as io}from"../utils/part.js";import{Primitive as so}from"../utils/primitive.js";import{useCallbackRef as co}from"../utils/useCallbackRef.js";import{useControllableState as Q}from"../utils/useControllableState.js";import*as O from"react";import*as xe from"react";import{skdxPart as tt}from"../utils/part.js";import{Primitive as ot}from"../utils/primitive.js";import{jsx as rt}from"react/jsx-runtime";var re=xe.forwardRef((e,t)=>rt(ot.tbody,{...e,...tt("table","body",e.className),ref:t}));re.displayName="TableBody";import*as Ce from"react";import{skdxPart as at}from"../utils/part.js";import{Primitive as nt}from"../utils/primitive.js";import{jsx as lt}from"react/jsx-runtime";var ae=Ce.forwardRef((e,t)=>lt(nt.caption,{...e,...at("table","caption",e.className),ref:t}));ae.displayName="TableCaption";import*as ye from"react";import{skdxPart as it}from"../utils/part.js";import{Primitive as st}from"../utils/primitive.js";import{jsx as dt}from"react/jsx-runtime";var K=ye.forwardRef((e,t)=>dt(st.td,{...e,...it("table","cell",e.className),ref:t}));K.displayName="TableCell";import*as he from"react";import{skdxPart as ct}from"../utils/part.js";import{Primitive as mt}from"../utils/primitive.js";import{jsx as Se}from"react/jsx-runtime";var ne=he.forwardRef(({colSpan:e=1,children:t,...a},o)=>Se(mt.tr,{"data-state":"empty","data-skdx-table-empty":"",...a,...ct("table","empty",a.className),ref:o,children:a.asChild?t:Se("td",{colSpan:e,children:t})}));ne.displayName="TableEmpty";import*as Pe from"react";import{skdxPart as ft}from"../utils/part.js";import{Primitive as pt}from"../utils/primitive.js";import{jsx as we}from"react/jsx-runtime";var le=Pe.forwardRef(({rowId:e,colSpan:t=1,children:a,...o},n)=>{let r=p("TableExpandedRow"),s=r.isRowExpanded(e);return we(pt.tr,{id:Y(r.tableId,e),"data-state":s?"expanded":"collapsed","data-skdx-table-detail-row":"",hidden:!s,...o,...ft("table","expanded-row",o.className),ref:n,children:o.asChild?a:we("td",{colSpan:t,children:a})})});le.displayName="TableExpandedRow";import*as ke from"react";import{skdxPart as bt}from"../utils/part.js";import{composeEventHandlers as ut,Primitive as Tt}from"../utils/primitive.js";import{jsx as Rt}from"react/jsx-runtime";var ie=ke.forwardRef(({rowId:e,...t},a)=>{let o=p("TableExpandTrigger"),n=o.isRowExpanded(e);return Rt(Tt.button,{type:"button","aria-expanded":n,"aria-controls":Y(o.tableId,e),"data-state":n?"expanded":"collapsed","data-skdx-table-expand-trigger":"",...t,...bt("table","expand-trigger",t.className),ref:a,onClick:ut(t.onClick,r=>{r.stopPropagation(),o.toggleRowExpanded(e)})})});ie.displayName="TableExpandTrigger";import*as Ee from"react";import{skdxPart as gt}from"../utils/part.js";import{Primitive as xt}from"../utils/primitive.js";import{jsx as Ct}from"react/jsx-runtime";var se=Ee.forwardRef((e,t)=>Ct(xt.thead,{...e,...gt("table","header",e.className),ref:t}));se.displayName="TableHeader";import*as H from"react";import{skdxPart as zt}from"../utils/part.js";import{Primitive as Kt}from"../utils/primitive.js";import*as He from"react";import{skdxPart as yt}from"../utils/part.js";import{composeEventHandlers as St,Primitive as ht}from"../utils/primitive.js";import{jsx as wt}from"react/jsx-runtime";var q=He.forwardRef(({columnKey:e,...t},a)=>{let o=p("TableColumnHeaderSortTrigger"),n=F("TableColumnHeaderSortTrigger"),r=e??(n.sortable?n.columnKey:void 0);if(r===void 0)return null;let s=o.sortList.findIndex(f=>f.columnKey===r),c=o.sortList[s]?.direction;return wt(ht.button,{type:"button","data-skdx-table-sort-trigger":"","data-sort-direction":c,"data-sort-index":o.multiSort&&s!==-1?s:void 0,...t,...yt("table","column-header-sort-trigger",t.className),ref:a,onClick:St(t.onClick,f=>{o.toggleSort(r,f.currentTarget.textContent?.trim()||r)})})});q.displayName="TableColumnHeaderSortTrigger";import*as L from"react";import{clamp as Pt}from"../utils/clamp.js";import{useComposedRefs as kt}from"../utils/composeRefs.js";import{directionalKey as Et,resolveDirection as Ht,useDirection as Nt}from"../utils/direction.js";import{skdxPart as Lt}from"../utils/part.js";import{composeEventHandlers as _,Primitive as Wt}from"../utils/primitive.js";import{useCallbackRef as de}from"../utils/useCallbackRef.js";import{jsx as vt}from"react/jsx-runtime";var Mt=40,At=1e3,Dt=8,It=new Set(["ArrowLeft","ArrowRight","Home","End"]),ce=L.forwardRef(({columnKey:e,minWidth:t,maxWidth:a,step:o,label:n,...r},s)=>{let c=p("TableColumnResizeTrigger"),f=F("TableColumnResizeTrigger"),w=Nt(),P=L.useRef(null),k=kt(s,P),R=L.useRef(null),[g,W]=L.useState(!1),d=e??f.columnKey,C=t??f.minWidth??Mt,u=a??f.maxWidth??At,y=o??f.resizeStep??Dt,M=d===void 0?void 0:c.columnWidths[d],v=L.useRef(!1),A=de(i=>{if(d===void 0)return;let T=Pt(Math.round(i),C,u);T!==c.columnWidths[d]&&(v.current=!0),c.setColumnWidth(d,T)}),D=de(()=>{v.current&&(v.current=!1,c.commitColumnWidths())}),$=()=>M!==void 0?M:(P.current?.closest("th")?.getBoundingClientRect().width??0)||C,I=de(()=>{let i=R.current;if(!i)return null;R.current=null,W(!1);let T=P.current;return T?.hasPointerCapture?.(i.pointerId)&&T.releasePointerCapture(i.pointerId),i});return L.useEffect(()=>{if(!g)return;let i=T=>{if(T.key!=="Escape")return;let E=I();E&&(A(E.startWidth),D())};return document.addEventListener("keydown",i),()=>document.removeEventListener("keydown",i)},[g,I,A,D]),d===void 0?null:vt(Wt.span,{role:"separator","aria-orientation":"vertical","aria-label":n??f.resizeLabel??"Resize column","aria-valuenow":Math.round(M??C),"aria-valuemin":C,"aria-valuemax":u,tabIndex:0,"data-skdx-table-resizer":"","data-dragging":g?"":void 0,...r,...Lt("table","column-resize-trigger",r.className),ref:k,onPointerDown:_(r.onPointerDown,i=>{i.button===0&&(i.preventDefault(),i.stopPropagation(),R.current={startX:i.clientX,startWidth:$(),pointerId:i.pointerId},W(!0),i.currentTarget.setPointerCapture?.(i.pointerId))}),onPointerMove:_(r.onPointerMove,i=>{let T=R.current;if(!T)return;let z=Ht(i.currentTarget,w)==="rtl"?T.startX-i.clientX:i.clientX-T.startX;A(T.startWidth+z)}),onPointerUp:_(r.onPointerUp,()=>{I()&&D()}),onPointerCancel:_(r.onPointerCancel,()=>{I()&&D()}),onKeyDown:_(r.onKeyDown,i=>{let T=Et(i.key,i.currentTarget,w);if(T==="ArrowRight")A($()+y);else if(T==="ArrowLeft")A($()-y);else if(i.key==="Home")A(C);else if(i.key==="End")A(u);else return;i.preventDefault(),i.stopPropagation()}),onKeyUp:_(r.onKeyUp,i=>{It.has(i.key)&&D()})})});ce.displayName="TableColumnResizeTrigger";import{Fragment as Ft,jsx as G,jsxs as _t}from"react/jsx-runtime";function Ne(e){return H.Children.toArray(e).some(t=>H.isValidElement(t)?t.type===q?!0:t.type===H.Fragment&&Ne(t.props.children):!1)}var V=H.forwardRef(({columnKey:e,sortable:t,resizable:a=!1,minWidth:o=40,maxWidth:n=1e3,resizeLabel:r="Resize column",resizeStep:s=8,children:c,style:f,...w},P)=>{let k=p("TableHeaderCell"),R=t&&e!==void 0,g=R?k.sortList.find(v=>v.columnKey===e)?.direction:void 0,W=R?g==="asc"?"ascending":g==="desc"?"descending":"none":void 0,d=a&&e!==void 0,C=e===void 0?void 0:k.columnWidths[e],u=w.asChild&&H.isValidElement(c)?c:null,y=u?u.props.children:c,M=_t(Ft,{children:[R&&!Ne(y)?G(q,{children:y}):y,d?G(ce,{}):null]});return G(Le,{columnKey:e,sortable:R,minWidth:o,maxWidth:n,resizeLabel:r,resizeStep:s,children:G(Kt.th,{"aria-sort":W,"data-sort-direction":g,"data-resizable":d?"":void 0,style:C===void 0?f:{...f,width:C,"--skdx-table-column-width":`${C}px`},...w,...zt("table","header-cell",w.className),ref:P,children:u?H.cloneElement(u,void 0,M):M})})});V.displayName="TableHeaderCell";import*as We from"react";import{skdxPart as $t}from"../utils/part.js";import{composeEventHandlers as Vt,Primitive as Bt}from"../utils/primitive.js";import{jsx as Ut}from"react/jsx-runtime";var Ot='button, a, input, [role="button"]',B=We.forwardRef(({rowId:e,...t},a)=>{let o=p("TableRow"),n=e!==void 0&&o.isRowSelected(e),r=o.selectionMode!=="none"&&e!==void 0;return Ut(Bt.tr,{"data-state":n?"selected":void 0,"data-row-id":r?e:void 0,...t,...$t("table","row",t.className),ref:a,onClick:Vt(t.onClick,s=>{!r||s.target.closest(Ot)||o.toggleRow(e,s.shiftKey)})})});B.displayName="TableRow";import*as Me from"react";import{Checkbox as Xt}from"../checkbox/Checkbox.js";import{skdxPart as Yt}from"../utils/part.js";import{composeEventHandlers as qt}from"../utils/primitive.js";import{jsx as Gt}from"react/jsx-runtime";var me=Me.forwardRef(({rowId:e,...t},a)=>{let o=p("TableRowSelectCheckbox");return Gt(Xt,{...t,...Yt("table","row-select-checkbox",t.className),ref:a,checked:o.isRowSelected(e),"data-skdx-table-row-select":"",onClick:qt(t.onClick,n=>{t.readOnly||o.toggleRow(e,n.shiftKey)})})});me.displayName="TableRowSelectCheckbox";import*as Ae from"react";import{Checkbox as Zt}from"../checkbox/Checkbox.js";import{skdxPart as Jt}from"../utils/part.js";import{composeEventHandlers as Qt}from"../utils/primitive.js";import{jsx as eo}from"react/jsx-runtime";function jt(e,t){let a=`${t} ${t===1?"row":"rows"}`;return e==="page"?`Select all ${a} on this page`:`Select all ${a}`}var fe=Ae.forwardRef(({rowIds:e,scope:t,getSelectAllLabel:a=jt,...o},n)=>{let r=p("TableSelectAllCheckbox"),s=r.isAllSelected(e)?!0:r.isSomeSelected(e)?"indeterminate":!1;return eo(Zt,{"aria-label":a(t,e.length),...o,...Jt("table","select-all-checkbox",o.className),ref:n,checked:s,"data-skdx-table-select-all":"","data-scope":t,onClick:Qt(o.onClick,()=>{o.readOnly||r.toggleAll(e)})})});fe.displayName="TableSelectAllCheckbox";import{Fragment as ao,jsx as h,jsxs as Z}from"react/jsx-runtime";function J(e,t){return e&&typeof e=="object"?e[t]:void 0}function to(e,t){return typeof e=="number"&&typeof t=="number"?e-t:e instanceof Date&&t instanceof Date?e.getTime()-t.getTime():String(e??"").localeCompare(String(t??""))}function oo(e,t){return t.length===0?[...e]:[...e].sort((a,o)=>{for(let{columnKey:n,direction:r}of t){let s=to(J(a,n),J(o,n));if(s!==0)return r==="desc"?-s:s}return 0})}function ro(e,t){let a=J(e,"id");return String(typeof a=="string"||typeof a=="number"?a:t)}function De({columns:e,data:t,sortable:a,selectable:o,expandable:n,renderExpanded:r,resizable:s,empty:c,caption:f,renderCell:w,rowId:P=ro}){let k=p("Table"),R=Math.max(e.length+(o?1:0)+(n?1:0),1),g=O.useMemo(()=>oo(t,k.sortList),[t,k.sortList]),W=O.useMemo(()=>g.map((d,C)=>P(d,C)),[g,P]);return Z(ao,{children:[f?h(ae,{children:f}):null,h(se,{children:Z(B,{children:[o?h(V,{children:h(fe,{scope:"page",rowIds:W})}):null,n?h(V,{"aria-hidden":"true"}):null,e.map(d=>h(V,{columnKey:d.key,sortable:d.sortable??a,resizable:d.resizable??s,minWidth:d.minWidth,maxWidth:d.maxWidth,children:d.header??d.key},d.key))]})}),h(re,{children:g.length===0?c?h(ne,{colSpan:R,children:c}):null:g.map((d,C)=>{let u=W[C];return Z(O.Fragment,{children:[Z(B,{rowId:u,children:[o?h(K,{children:h(me,{rowId:u,"aria-label":`Select row ${u}`})}):null,n?h(K,{children:h(ie,{rowId:u,"aria-label":`Details for row ${u}`})}):null,e.map(y=>h(K,{children:y.cell?y.cell(d):w?w(d,y):String(J(d,y.key)??"")},y.key))]}),n?h(le,{rowId:u,colSpan:R,children:r?.(d)}):null]},u)})})]})}import{jsx as j}from"react/jsx-runtime";function Ie(e){return e===void 0?new Set:e instanceof Set?e:new Set(e)}var ve=[],ze={},Ke=[];function mo(e,t,a){let o=e.find(r=>r.columnKey===t),n=o===void 0?"asc":o.direction==="asc"?"desc":null;return a?n===null?e.filter(r=>r.columnKey!==t):o===void 0?[...e,{columnKey:t,direction:n}]:e.map(r=>r.columnKey===t?{columnKey:t,direction:n}:r):n===null?[]:[{columnKey:t,direction:n}]}function fo(e,t){return t===null?`${e} not sorted`:`${e} sorted ${t==="asc"?"ascending":"descending"}`}var[po,p]=Fe("Table"),[Le,F]=Fe("TableHeaderCell",{});function Y(e,t){return`${e}-detail-${t}`}var _e=m.forwardRef(({sort:e,defaultSort:t=Ke,onSortChange:a,multiSort:o=!1,selected:n,defaultSelected:r,onSelectedChange:s,selectionMode:c="none",getSortLabel:f=fo,expandedRowIds:w,defaultExpandedRowIds:P=ve,onExpandedRowIdsChange:k,columnWidths:R,defaultColumnWidths:g,onColumnWidthsChange:W,onColumnWidthsCommit:d,rowCount:C,columnCount:u,children:y,...M},v)=>{let A=m.useId(),D=m.useRef(null),$=no(v,D),[I=Ke,i]=Q({prop:e,defaultProp:t,onChange:a}),T=m.useMemo(()=>n===void 0?void 0:Ie(n),[n]),[E=new Set,z]=Q({prop:T,defaultProp:Ie(r??[]),onChange:l=>s?.([...l])}),Oe=m.useCallback((l,b=l)=>{let x=mo(I,l,o);i(x);let S=x.find(N=>N.columnKey===l)?.direction??null;lo(f(b,S))},[I,o,i,f]),pe=m.useCallback(()=>{let l=D.current?.querySelectorAll(":scope > tbody > tr[data-row-id]");return l?[...l].map(b=>b.dataset.rowId):[]},[]),be=m.useRef(null),Ue=m.useCallback((l,b=!1)=>{if(c==="none")return;let x=be.current;if(b&&c==="multiple"&&x!==null&&x!==l){let S=pe(),N=S.indexOf(x),oe=S.indexOf(l);if(N!==-1&&oe!==-1){let je=S.slice(Math.min(N,oe),Math.max(N,oe)+1);z((et=new Set)=>new Set([...et,...je]));return}}be.current=l,z((S=new Set)=>{if(c==="single")return S.has(l)&&S.size===1?new Set:new Set([l]);let N=new Set(S);return N.has(l)?N.delete(l):N.add(l),N})},[c,z,pe]),[ue=ve,Te]=Q({prop:w,defaultProp:P,onChange:k}),ee=m.useMemo(()=>new Set(ue),[ue]),[U=ze,Re]=Q({prop:R,defaultProp:g??ze,onChange:W}),Xe=m.useCallback(l=>{Te((b=[])=>b.includes(l)?b.filter(x=>x!==l):[...b,l])},[Te]),Ye=m.useCallback(l=>ee.has(l),[ee]),X=m.useRef(U);m.useLayoutEffect(()=>{X.current=U},[U]);let qe=m.useCallback((l,b)=>{let x=X.current;if(x[l]===b)return;let S={...x,[l]:b};X.current=S,Re(S)},[Re]),ge=co(d),Ge=m.useCallback(()=>{ge(X.current)},[ge]),Ze=m.useCallback(l=>E.has(l),[E]),te=m.useCallback(l=>l.length>0&&l.every(b=>E.has(b)),[E]),Je=m.useCallback(l=>l.some(b=>E.has(b))&&!te(l),[E,te]),Qe=m.useCallback(l=>{c!=="none"&&z((b=new Set)=>{if(l.length>0&&l.every(x=>b.has(x))){let x=new Set(b);return l.forEach(S=>x.delete(S)),x}return new Set([...b,...l])})},[c,z]);return j(po,{tableId:A,sortList:I,multiSort:o,selected:E,selectionMode:c,toggleSort:Oe,toggleRow:Ue,isRowSelected:Ze,toggleAll:Qe,isAllSelected:te,isSomeSelected:Je,expandedRows:ee,toggleRowExpanded:Xe,isRowExpanded:Ye,columnWidths:U,setColumnWidth:qe,commitColumnWidths:Ge,children:j(so.table,{"aria-rowcount":C,"aria-colcount":u,...M,...io("table","root",M.className),ref:$,children:y})})});_e.displayName="TableRoot";function bo({columns:e,data:t,sortable:a=!1,selectable:o=!1,expandable:n=!1,renderExpanded:r,resizable:s=!1,empty:c,caption:f,renderCell:w,rowId:P,selectionMode:k,...R},g){return j(_e,{...R,selectionMode:k??(o?"multiple":"none"),ref:g,children:j(De,{columns:e,data:t,sortable:a,selectable:o,expandable:n,renderExpanded:r,resizable:s,empty:c,caption:f,renderCell:w,rowId:P})})}var $e=m.forwardRef(bo);$e.displayName="Table";import*as Ve from"react";import{skdxPart as uo}from"../utils/part.js";import{Primitive as To}from"../utils/primitive.js";import{jsx as go}from"react/jsx-runtime";var Ro=Ve.forwardRef((e,t)=>go(To.tfoot,{...e,...uo("table","footer",e.className),ref:t}));Ro.displayName="TableFooter";import*as Be from"react";import{skdxPart as xo}from"../utils/part.js";import{Primitive as Co}from"../utils/primitive.js";import{jsx as So}from"react/jsx-runtime";var yo=Be.forwardRef(({columnKey:e,...t},a)=>{let o=p("TableSortIndicator"),n=F("TableSortIndicator"),r=e??n.columnKey,s=r===void 0?-1:o.sortList.findIndex(f=>f.columnKey===r),c=o.sortList[s]?.direction??"none";return So(Co.span,{"aria-hidden":"true","data-skdx-table-sort-indicator":"","data-sort-direction":c,"data-sort-index":o.multiSort&&s!==-1?s:void 0,...t,...xo("table","sort-indicator",t.className),ref:a})});yo.displayName="TableSortIndicator";export{$e as Table,re as TableBody,ae as TableCaption,K as TableCell,q as TableColumnHeaderSortTrigger,ce as TableColumnResizeTrigger,ne as TableEmpty,ie as TableExpandTrigger,le as TableExpandedRow,Ro as TableFooter,se as TableHeader,V as TableHeaderCell,Le as TableHeaderCellProvider,po as TableProvider,_e as TableRoot,B as TableRow,me as TableRowSelectCheckbox,fe as TableSelectAllCheckbox,yo as TableSortIndicator,fo as defaultGetSortLabel,jt as defaultSelectAllLabel,Y as tableDetailRowId,p as useTableContext,F as useTableHeaderCellContext};

package/dist/table/TableAnatomy.d.cts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+import type { TableColumn } from './types.cjs';
+/**
+ * Renders table anatomy from `columns` and `data` — caption, header, body, or `TableEmpty` when data is empty.
+ *
+ * @internal
+ */
+export declare function TableAnatomy<T>({ columns, data, sortable, selectable, expandable, renderExpanded, resizable, empty, caption, renderCell, rowId, }: {
+    columns: TableColumn<T>[];
+    data: T[];
+    sortable?: boolean;
+    selectable?: boolean;
+    expandable?: boolean;
+    renderExpanded?: (row: T) => React.ReactNode;
+    resizable?: boolean;
+    empty?: React.ReactNode;
+    caption?: React.ReactNode;
+    renderCell?: (row: T, column: TableColumn<T>) => React.ReactNode;
+    rowId?: (row: T, index: number) => string;
+}): React.JSX.Element;

package/dist/table/TableAnatomy.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+import type { TableColumn } from './types.js';
+/**
+ * Renders table anatomy from `columns` and `data` — caption, header, body, or `TableEmpty` when data is empty.
+ *
+ * @internal
+ */
+export declare function TableAnatomy<T>({ columns, data, sortable, selectable, expandable, renderExpanded, resizable, empty, caption, renderCell, rowId, }: {
+    columns: TableColumn<T>[];
+    data: T[];
+    sortable?: boolean;
+    selectable?: boolean;
+    expandable?: boolean;
+    renderExpanded?: (row: T) => React.ReactNode;
+    resizable?: boolean;
+    empty?: React.ReactNode;
+    caption?: React.ReactNode;
+    renderCell?: (row: T, column: TableColumn<T>) => React.ReactNode;
+    rowId?: (row: T, index: number) => string;
+}): React.JSX.Element;

package/dist/table/TableColumnHeaderSortTrigger.d.cts

@@ -1,24 +1,13 @@
 import * as React from 'react';
 import type { TableColumnHeaderSortTriggerProps } from './types.cjs';
 /**
- * The button inside a sortable `<th>` that cycles its column through
- * ascending → descending → unsorted — the APG sortable-table pattern, so the
- * sort control announces as a button and activates on Enter/Space natively
- * while the `<th>` itself stays out of the tab order.
- *
- * A `TableHeaderCell` with a `sortKey` renders one of these around its children
- * for you. Render it yourself when the header needs more than a label inside
- * the button (a sort indicator, an icon, a count) — the cell notices a
- * `TableColumnHeaderSortTrigger` among its children and stops adding its own,
- * so exactly one sort button exists per column either way.
- *
- * Carries `data-sort-direction` (`"asc"`/`"desc"`, absent while unsorted) and,
- * under `multiSort`, `data-sort-index` — the column's 0-based position in the
- * sort, which is what a "1, 2, 3" badge on a multi-sorted header is drawn from.
+ * Cycles column through ascending → descending → unsorted (APG pattern).
+ * `TableHeaderCell` renders one for you; render it yourself for complex headers.
+ * Carries `data-sort-direction` and `data-sort-index` under `multiSort`.
  *
  * @example
  * ```tsx
- * <TableHeaderCell sortKey="amount">
+ * <TableHeaderCell columnKey="amount" sortable>
  *   <TableColumnHeaderSortTrigger>
  *     Amount
  *     <TableSortIndicator>↑</TableSortIndicator>

package/dist/table/TableColumnHeaderSortTrigger.d.ts

@@ -1,24 +1,13 @@
 import * as React from 'react';
 import type { TableColumnHeaderSortTriggerProps } from './types.js';
 /**
- * The button inside a sortable `<th>` that cycles its column through
- * ascending → descending → unsorted — the APG sortable-table pattern, so the
- * sort control announces as a button and activates on Enter/Space natively
- * while the `<th>` itself stays out of the tab order.
- *
- * A `TableHeaderCell` with a `sortKey` renders one of these around its children
- * for you. Render it yourself when the header needs more than a label inside
- * the button (a sort indicator, an icon, a count) — the cell notices a
- * `TableColumnHeaderSortTrigger` among its children and stops adding its own,
- * so exactly one sort button exists per column either way.
- *
- * Carries `data-sort-direction` (`"asc"`/`"desc"`, absent while unsorted) and,
- * under `multiSort`, `data-sort-index` — the column's 0-based position in the
- * sort, which is what a "1, 2, 3" badge on a multi-sorted header is drawn from.
+ * Cycles column through ascending → descending → unsorted (APG pattern).
+ * `TableHeaderCell` renders one for you; render it yourself for complex headers.
+ * Carries `data-sort-direction` and `data-sort-index` under `multiSort`.
  *
  * @example
  * ```tsx
- * <TableHeaderCell sortKey="amount">
+ * <TableHeaderCell columnKey="amount" sortable>
  *   <TableColumnHeaderSortTrigger>
  *     Amount
  *     <TableSortIndicator>↑</TableSortIndicator>

package/dist/table/TableColumnResizeTrigger.d.cts

@@ -1,21 +1,7 @@
 import * as React from 'react';
 import type { TableColumnResizeTriggerProps } from './types.cjs';
 /**
- * The column edge you drag — or focus and step with the keyboard — to resize a
- * column. A `role="separator"` with `aria-orientation="vertical"`, its own
- * accessible name, and `aria-valuenow`/`valuemin`/`valuemax`, because a
- * focusable separator is a widget and must expose all four.
- *
- * `TableHeaderCell`'s `resizable` renders one of these for you; render it
- * yourself to place it differently or to give one column a different `step`.
- *
- * Keyboard, mirrored under `dir="rtl"` so the arrow that visually widens always
- * widens: **Arrow Left/Right** step by `step`px, **Home** and **End** snap to
- * `minWidth` and `maxWidth`. Pointer: drag the handle; **Escape** mid-drag reverts
- * the column to the width it had when the drag started. Every write is clamped
- * to the bounds, and the resulting width is published on the `<th>` as both an
- * inline `width` and the `--skdx-table-column-width` custom property.
- *
+ * The column edge you drag, or focus and step with arrow keys, to resize a column; mirrored under `dir="rtl"`.
  * @example
  * ```tsx
  * <TableHeaderCell columnKey="name" minWidth={120}>

package/dist/table/TableColumnResizeTrigger.d.ts

@@ -1,21 +1,7 @@
 import * as React from 'react';
 import type { TableColumnResizeTriggerProps } from './types.js';
 /**
- * The column edge you drag — or focus and step with the keyboard — to resize a
- * column. A `role="separator"` with `aria-orientation="vertical"`, its own
- * accessible name, and `aria-valuenow`/`valuemin`/`valuemax`, because a
- * focusable separator is a widget and must expose all four.
- *
- * `TableHeaderCell`'s `resizable` renders one of these for you; render it
- * yourself to place it differently or to give one column a different `step`.
- *
- * Keyboard, mirrored under `dir="rtl"` so the arrow that visually widens always
- * widens: **Arrow Left/Right** step by `step`px, **Home** and **End** snap to
- * `minWidth` and `maxWidth`. Pointer: drag the handle; **Escape** mid-drag reverts
- * the column to the width it had when the drag started. Every write is clamped
- * to the bounds, and the resulting width is published on the `<th>` as both an
- * inline `width` and the `--skdx-table-column-width` custom property.
- *
+ * The column edge you drag, or focus and step with arrow keys, to resize a column; mirrored under `dir="rtl"`.
  * @example
  * ```tsx
  * <TableHeaderCell columnKey="name" minWidth={120}>

package/dist/table/TableEmpty.d.cts

@@ -1,10 +1,7 @@
 import * as React from 'react';
 import type { TableEmptyProps } from './types.cjs';
 /**
- * The row rendered in place of body rows when there is no data: a `<tr>` with
- * `data-state="empty"` whose single `<td colspan>` holds the empty-state
- * message. Render it inside `TableBody` when your row array is empty — the
- * table has no data model of its own, so only you know when that is.
+ * Row rendered when there is no data. Render inside TableBody when rows are empty.
  *
  * @example
  * ```tsx

package/dist/table/TableEmpty.d.ts

@@ -1,10 +1,7 @@
 import * as React from 'react';
 import type { TableEmptyProps } from './types.js';
 /**
- * The row rendered in place of body rows when there is no data: a `<tr>` with
- * `data-state="empty"` whose single `<td colspan>` holds the empty-state
- * message. Render it inside `TableBody` when your row array is empty — the
- * table has no data model of its own, so only you know when that is.
+ * Row rendered when there is no data. Render inside TableBody when rows are empty.
  *
  * @example
  * ```tsx

package/dist/table/TableExpandTrigger.d.cts

@@ -1,15 +1,7 @@
 import * as React from 'react';
 import type { TableExpandTriggerProps } from './types.cjs';
 /**
- * Disclosure button that opens the `TableExpandedRow` for `rowId`: a
- * `<button aria-expanded>` with `aria-controls` pointing at that detail row,
- * plus `data-state` of `"expanded"`/`"collapsed"`. Place it inside a
- * `TableCell` of the row it belongs to — the trigger *cell* stays a plain
- * `<td>`, so the button (not the cell) is the thing screen readers announce as
- * expandable.
- *
- * Clicking it stops propagation, so a selectable `TableRow` doesn't also
- * toggle its selection.
+ * Disclosure button for `TableExpandedRow`. Button (not cell) is what screen readers announce as expandable. Stops click propagation to prevent toggling row selection.
  *
  * @example
  * ```tsx

package/dist/table/TableExpandTrigger.d.ts

@@ -1,15 +1,7 @@
 import * as React from 'react';
 import type { TableExpandTriggerProps } from './types.js';
 /**
- * Disclosure button that opens the `TableExpandedRow` for `rowId`: a
- * `<button aria-expanded>` with `aria-controls` pointing at that detail row,
- * plus `data-state` of `"expanded"`/`"collapsed"`. Place it inside a
- * `TableCell` of the row it belongs to — the trigger *cell* stays a plain
- * `<td>`, so the button (not the cell) is the thing screen readers announce as
- * expandable.
- *
- * Clicking it stops propagation, so a selectable `TableRow` doesn't also
- * toggle its selection.
+ * Disclosure button for `TableExpandedRow`. Button (not cell) is what screen readers announce as expandable. Stops click propagation to prevent toggling row selection.
  *
  * @example
  * ```tsx

package/dist/table/TableExpandedRow.d.cts

@@ -1,14 +1,7 @@
 import * as React from 'react';
 import type { TableExpandedRowProps } from './types.cjs';
 /**
- * The full-width detail row a `TableExpandTrigger` reveals: a `<tr>` whose
- * single `<td colspan>` holds the row's expanded content, with `data-state` of
- * `"expanded"`/`"collapsed"`. Render it as the next sibling of the row it
- * belongs to, inside the same `TableBody`.
- *
- * It stays mounted while collapsed and is `hidden` instead — the trigger's
- * `aria-controls` has to resolve to a real element for assistive tech to follow
- * it, which an unmounted row could not do.
+ * Full-width detail row revealed by a TableExpandTrigger. Stays mounted while hidden for `aria-controls`.
  *
  * @example
  * ```tsx

package/dist/table/TableExpandedRow.d.ts

@@ -1,14 +1,7 @@
 import * as React from 'react';
 import type { TableExpandedRowProps } from './types.js';
 /**
- * The full-width detail row a `TableExpandTrigger` reveals: a `<tr>` whose
- * single `<td colspan>` holds the row's expanded content, with `data-state` of
- * `"expanded"`/`"collapsed"`. Render it as the next sibling of the row it
- * belongs to, inside the same `TableBody`.
- *
- * It stays mounted while collapsed and is `hidden` instead — the trigger's
- * `aria-controls` has to resolve to a real element for assistive tech to follow
- * it, which an unmounted row could not do.
+ * Full-width detail row revealed by a TableExpandTrigger. Stays mounted while hidden for `aria-controls`.
  *
  * @example
  * ```tsx

package/dist/table/TableHeader.d.cts

@@ -7,7 +7,7 @@ import type { TableHeaderProps } from './types.cjs';
  * ```tsx
  * <TableHeader>
  *   <TableRow>
- *     <TableHeaderCell sortKey="name">Name</TableHeaderCell>
+ *     <TableHeaderCell columnKey="name" sortable>Name</TableHeaderCell>
  *   </TableRow>
  * </TableHeader>
  * ```

package/dist/table/TableHeader.d.ts

@@ -7,7 +7,7 @@ import type { TableHeaderProps } from './types.js';
  * ```tsx
  * <TableHeader>
  *   <TableRow>
- *     <TableHeaderCell sortKey="name">Name</TableHeaderCell>
+ *     <TableHeaderCell columnKey="name" sortable>Name</TableHeaderCell>
  *   </TableRow>
  * </TableHeader>
  * ```