@skdx/web-components 0.26.0 → 0.28.0

package/dist/transfer/types.cjs

@@ -1 +1 @@
-"use strict";var n=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var T=(r,e,i,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of s(e))!f.call(r,t)&&t!==i&&n(r,t,{get:()=>e[t],enumerable:!(a=o(e,t))||a.enumerable});return r};var l=r=>T(n({},"__esModule",{value:!0}),r);var m={};module.exports=l(m);
+"use strict";var a=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var l=(r,e,i,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of o(e))!f.call(r,t)&&t!==i&&a(r,t,{get:()=>e[t],enumerable:!(n=s(e,t))||n.enumerable});return r};var p=r=>l(a({},"__esModule",{value:!0}),r);var T={};module.exports=p(T);

package/dist/transfer/types.d.cts

@@ -5,22 +5,28 @@ export interface TransferItemData {
     /** Human-readable text: rendered as the option's content and matched by the filter. */
     label: string;
     /**
-     * Excludes the item from being moved, from the move triggers' counts, and
-     * from keyboard navigation. It stays rendered and announced.
+     * Excludes the item from moves and navigation; stays rendered and announced.
      * @default false
      */
     disabled?: boolean;
 }
 /** Which of a transfer's two lists: the pool (`'source'`) or the chosen set (`'target'`). */
 export type TransferSide = 'source' | 'target';
-/**
- * Which way a move goes, named logically rather than physically: under
- * `dir="rtl"` the target list is on the left, so "right" would be wrong half
- * the time.
- */
+/** Direction of a move, named logically not physically (works under `dir="rtl"`). */
 export type TransferDirection = 'toTarget' | 'toSource';
 /** Predicate deciding whether an item matches a list's filter text. */
 export type TransferFilter = (item: TransferItemData, query: string) => boolean;
+/**
+ * How the built-in matcher compares a query against an item's label.
+ * `'contains'` is the default. Declarative half of {@link TransferFilter}
+ * (a function cannot be an HTML attribute).
+ */
+export type TransferFilterMatchMode = 'startsWith' | 'contains' | 'endsWith';
+/**
+ * Item placement on target when moved: `'items'` keeps collection order;
+ * `'append'` and `'prepend'` follow move order.
+ */
+export type TransferTargetOrder = 'items' | 'append' | 'prepend';
 /**
  * What a move just did, handed to `<skdx-transfer>`'s `getMoveAnnouncement` so
  * it can word the live-region message.
@@ -37,3 +43,28 @@ export interface TransferMoveDetail {
     /** The side they landed on. */
     to: TransferSide;
 }
+/**
+ * What a settled search query left visible, handed to `<skdx-transfer>`'s
+ * `getSearchResultsAnnouncement` so it can word the live-region message.
+ */
+export interface TransferSearchResultsDetail {
+    /** How many items on this side survive the query. */
+    shown: number;
+    /** How many items are on this side in total, before the query. */
+    total: number;
+    /** Which side was filtered. */
+    side: TransferSide;
+    /** The query that produced this count. Empty once the user clears the box. */
+    query: string;
+}
+/** One list's scroll geometry, carried by `<skdx-transfer>`'s `list-scroll` event. */
+export interface TransferListScrollDetail {
+    /** Which of the two lists scrolled. */
+    side: TransferSide;
+    /** How far the list is scrolled from its top, in pixels. */
+    scrollTop: number;
+    /** The full scrollable height of the list, in pixels. */
+    scrollHeight: number;
+    /** The visible height of the list, in pixels. */
+    clientHeight: number;
+}

package/dist/transfer/types.d.ts

@@ -5,22 +5,28 @@ export interface TransferItemData {
     /** Human-readable text: rendered as the option's content and matched by the filter. */
     label: string;
     /**
-     * Excludes the item from being moved, from the move triggers' counts, and
-     * from keyboard navigation. It stays rendered and announced.
+     * Excludes the item from moves and navigation; stays rendered and announced.
      * @default false
      */
     disabled?: boolean;
 }
 /** Which of a transfer's two lists: the pool (`'source'`) or the chosen set (`'target'`). */
 export type TransferSide = 'source' | 'target';
-/**
- * Which way a move goes, named logically rather than physically: under
- * `dir="rtl"` the target list is on the left, so "right" would be wrong half
- * the time.
- */
+/** Direction of a move, named logically not physically (works under `dir="rtl"`). */
 export type TransferDirection = 'toTarget' | 'toSource';
 /** Predicate deciding whether an item matches a list's filter text. */
 export type TransferFilter = (item: TransferItemData, query: string) => boolean;
+/**
+ * How the built-in matcher compares a query against an item's label.
+ * `'contains'` is the default. Declarative half of {@link TransferFilter}
+ * (a function cannot be an HTML attribute).
+ */
+export type TransferFilterMatchMode = 'startsWith' | 'contains' | 'endsWith';
+/**
+ * Item placement on target when moved: `'items'` keeps collection order;
+ * `'append'` and `'prepend'` follow move order.
+ */
+export type TransferTargetOrder = 'items' | 'append' | 'prepend';
 /**
  * What a move just did, handed to `<skdx-transfer>`'s `getMoveAnnouncement` so
  * it can word the live-region message.
@@ -37,3 +43,28 @@ export interface TransferMoveDetail {
     /** The side they landed on. */
     to: TransferSide;
 }
+/**
+ * What a settled search query left visible, handed to `<skdx-transfer>`'s
+ * `getSearchResultsAnnouncement` so it can word the live-region message.
+ */
+export interface TransferSearchResultsDetail {
+    /** How many items on this side survive the query. */
+    shown: number;
+    /** How many items are on this side in total, before the query. */
+    total: number;
+    /** Which side was filtered. */
+    side: TransferSide;
+    /** The query that produced this count. Empty once the user clears the box. */
+    query: string;
+}
+/** One list's scroll geometry, carried by `<skdx-transfer>`'s `list-scroll` event. */
+export interface TransferListScrollDetail {
+    /** Which of the two lists scrolled. */
+    side: TransferSide;
+    /** How far the list is scrolled from its top, in pixels. */
+    scrollTop: number;
+    /** The full scrollable height of the list, in pixels. */
+    scrollHeight: number;
+    /** The visible height of the list, in pixels. */
+    clientHeight: number;
+}

package/dist/tree/Tree.cjs

@@ -1,5 +1,15 @@
-"use strict";var f=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var H=(r,d)=>{for(var e in d)f(r,e,{get:d[e],enumerable:!0})},P=(r,d,e,s)=>{if(d&&typeof d=="object"||typeof d=="function")for(let t of k(d))!C.call(r,t)&&t!==e&&f(r,t,{get:()=>d[t],enumerable:!(s=_(d,t))||s.enumerable});return r};var D=r=>P(f({},"__esModule",{value:!0}),r),l=(r,d,e,s)=>{for(var t=s>1?void 0:s?_(d,e):d,i=r.length-1,n;i>=0;i--)(n=r[i])&&(t=(s?n(d,e,t):n(t))||t);return s&&t&&f(d,e,t),t};var N={};H(N,{SkdxTree:()=>a,defaultGetLoadedLabel:()=>M,treeNodeLabel:()=>I});module.exports=D(N);var p=require("lit"),c=require("lit/decorators.js"),S=require("../internal/define.cjs"),w=require("../internal/direction.cjs"),g=require("../internal/typeahead.cjs"),A=require("../utils/live-announcer.cjs");var E='[role="treeitem"]:not([data-disabled])',x='[role="treeitem"]';function h(r){return r.getAttribute("data-skdx-tree-node-id")??""}function I(r){let d=r.getAttribute("data-text-value");if(d!==null)return d;let e="";for(let s of Array.from(r.childNodes)){let t=s.nodeType===1?s:null;t&&(t.getAttribute("role")==="group"||t.getAttribute("aria-hidden")==="true")||(e+=s.textContent??"")}return e}function M(r){return`${r} loaded`}var a=class extends p.LitElement{constructor(){super(...arguments);this.selectionMode="single";this.defaultExpandedIds=[];this.defaultSelectedIds=[];this.selectionPropagation="none";this.getLoadedLabel=M;this._uncontrolledExpanded=new Set;this._uncontrolledSelected=new Set;this._activeNodeId=null;this._loadingIds=new Set;this._initialized=!1;this._requested=new Set;this._nodeParents=new Map;this._typeahead=new g.Typeahead;this.handleFocusIn=e=>{let t=e.target.closest?.('[role="treeitem"]');if(t&&!t.hasAttribute("data-disabled")){let i=t.getAttribute("data-skdx-tree-node-id");i&&this.setActiveNodeId(i)}};this.handleKeyDown=e=>{let s=e.target;if(!s.matches?.('[role="treeitem"]'))return;let t=Array.from(this.querySelectorAll(E)),i=t.indexOf(s),n=this.selectionMode==="multiple",u=(0,w.directionalKey)(e.key,this);if(n&&e.shiftKey&&(u==="ArrowDown"||u==="ArrowUp")){e.preventDefault();let o=t[i+(u==="ArrowDown"?1:-1)];o&&(o.focus(),this.toggleSelected(h(o)));return}if(n&&e.shiftKey&&(e.key==="Home"||e.key==="End")){e.preventDefault();let o=e.key==="Home"?0:t.length-1;this.selectMany(t.slice(Math.min(i,o),Math.max(i,o)+1).map(h)),t[o]?.focus();return}if(n&&(e.ctrlKey||e.metaKey)&&e.key.toLowerCase()==="a"){e.preventDefault(),this.selectMany(t.map(h));return}if(u==="ArrowDown"){e.preventDefault(),t[i+1]?.focus();return}if(u==="ArrowUp"){e.preventDefault(),t[i-1]?.focus();return}if(u==="Home"){e.preventDefault(),t[0]?.focus();return}if(u==="End"){e.preventDefault(),t[t.length-1]?.focus();return}let m=h(s),y=s.hasAttribute("aria-expanded"),v=s.getAttribute("aria-expanded")==="true",b=s.getAttribute("data-skdx-tree-parent-id")||"";if(u==="ArrowRight")e.preventDefault(),y&&!v?this.setExpanded(m,!0):t[i+1]?.focus();else if(u==="ArrowLeft")e.preventDefault(),y&&v?this.setExpanded(m,!1):b&&t.find(L=>h(L)===b)?.focus();else if(e.key==="Enter"||e.key===" ")e.preventDefault(),this.toggleSelected(m);else if(e.key==="*")e.preventDefault(),this.expandMany(Array.from(this.querySelectorAll(x)).filter(o=>(o.getAttribute("data-skdx-tree-parent-id")||"")===b&&o.getAttribute("aria-expanded")==="false").map(h));else if((0,g.isTypeaheadKey)(e)){let o=this._typeahead.match(e.key,t.map(I),i);if(o===-1)return;e.preventDefault(),t[o]?.focus()}}}connectedCallback(){super.connectedCallback(),this._initialized||(this._uncontrolledExpanded=new Set(this.defaultExpandedIds),this._uncontrolledSelected=new Set(this.defaultSelectedIds),this._initialized=!0),this.setAttribute("role","tree"),this.syncHostAttrs(),this.addEventListener("keydown",this.handleKeyDown),this.addEventListener("focusin",this.handleFocusIn)}disconnectedCallback(){this.removeEventListener("keydown",this.handleKeyDown),this.removeEventListener("focusin",this.handleFocusIn),this._typeahead.clear(),super.disconnectedCallback()}updated(e){(e.has("expandedIds")||e.has("selectedIds")||e.has("selectionMode")||e.has("selectionPropagation"))&&(this.syncHostAttrs(),this._broadcast())}syncHostAttrs(){this.selectionMode==="multiple"?this.setAttribute("aria-multiselectable","true"):this.removeAttribute("aria-multiselectable")}get expandedIdSet(){return this.expandedIds!==void 0?new Set(this.expandedIds):this._uncontrolledExpanded}get selectedIdSet(){return this.selectedIds!==void 0?new Set(this.selectedIds):this._uncontrolledSelected}get activeNodeId(){return this._activeNodeId}isLoading(e){return this._loadingIds.has(e)}registerNode(e,s){this._nodeParents.get(e)!==s&&(this._nodeParents.set(e,s),this._broadcastHierarchy())}unregisterNode(e){this._nodeParents.delete(e)&&this._broadcastHierarchy()}_broadcastHierarchy(){this.selectionPropagation==="descendants"&&this._broadcast()}get childrenByParent(){let e=new Map;for(let[s,t]of this._nodeParents){if(t===null)continue;let i=e.get(t);i?i.push(s):e.set(t,[s])}return e}descendantsOf(e){let s=this.childrenByParent,t=[],i=[...s.get(e)??[]];for(;i.length>0;){let n=i.pop();t.push(n),i.push(...s.get(n)??[])}return t}checkedState(e){if(this.selectionPropagation!=="descendants")return!1;let s=this.selectedIdSet,t=this.descendantsOf(e);if(t.length===0)return s.has(e);let i=t.filter(n=>s.has(n)).length;return i===0?!1:i===t.length?!0:"mixed"}setActiveNodeId(e){this._activeNodeId!==e&&(this._activeNodeId=e,this._broadcast())}ensureActiveNodeId(){let e=Array.from(this.querySelectorAll(E),t=>t.getAttribute("data-skdx-tree-node-id")).filter(t=>t!==null&&t!==""),s=e[0];s===void 0||this._activeNodeId!==null&&e.includes(this._activeNodeId)||this.setActiveNodeId(s)}syncNodePositions(){let e=new Map;for(let s of this.querySelectorAll(x)){let t=s.getAttribute("data-skdx-tree-parent-id")??"",i=e.get(t);i?i.push(s):e.set(t,[s])}for(let s of e.values())s.forEach((t,i)=>{t.setAttribute("aria-posinset",String(i+1)),t.setAttribute("aria-setsize",String(s.length))})}expandMany(e){if(e.length===0)return;let s=new Set(this.expandedIdSet);for(let t of e)s.add(t);this.expandedIds===void 0&&(this._uncontrolledExpanded=s),this.dispatchEvent(new CustomEvent("expanded-ids-change",{detail:[...s],bubbles:!0,composed:!0}));for(let t of e)this._startLoad(t,!0);this._broadcast()}selectMany(e){if(this.selectionMode!=="multiple")return;let s=new Set(this.selectedIdSet);for(let t of e)s.add(t);this.selectedIds===void 0&&(this._uncontrolledSelected=s),this.dispatchEvent(new CustomEvent("selected-ids-change",{detail:[...s],bubbles:!0,composed:!0})),this._broadcast()}setExpanded(e,s){let t=this.expandedIdSet,i=s?new Set(t).add(e):new Set([...t].filter(n=>n!==e));this.expandedIds===void 0&&(this._uncontrolledExpanded=i),this.dispatchEvent(new CustomEvent("expanded-ids-change",{detail:[...i],bubbles:!0,composed:!0})),this._startLoad(e,s),this._broadcast()}_startLoad(e,s){let t=this.loadChildren;if(!s||!t||this._requested.has(e))return;this._requested.add(e),this._loadingIds=new Set(this._loadingIds).add(e);let i=()=>{let n=new Set(this._loadingIds);n.delete(e),this._loadingIds=n,this._broadcast()};Promise.resolve(t(e)).then(()=>{i(),(0,A.announce)(this.getLoadedLabel(e))},()=>{this._requested.delete(e),i()})}toggleSelected(e){if(this.selectionMode==="none")return;let s=this.selectedIdSet,t;if(this.selectionMode==="multiple"&&this.selectionPropagation==="descendants"){let i=this.checkedState(e)!==!0;t=new Set(s);for(let n of[e,...this.descendantsOf(e)])i?t.add(n):t.delete(n)}else this.selectionMode==="single"?t=new Set([e]):(t=new Set(s),t.has(e)?t.delete(e):t.add(e));this.selectedIds===void 0&&(this._uncontrolledSelected=t),this.dispatchEvent(new CustomEvent("selected-ids-change",{detail:[...t],bubbles:!0,composed:!0})),this._broadcast()}_broadcast(){this.dispatchEvent(new CustomEvent("skdx-tree-internal-update"))}render(){return p.html`<slot></slot>`}};a.styles=p.css`
+"use strict";var m=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var P=(a,l)=>{for(var e in l)m(a,e,{get:l[e],enumerable:!0})},H=(a,l,e,i)=>{if(l&&typeof l=="object"||typeof l=="function")for(let t of N(l))!D.call(a,t)&&t!==e&&m(a,t,{get:()=>l[t],enumerable:!(i=k(l,t))||i.enumerable});return a};var T=a=>H(m({},"__esModule",{value:!0}),a),d=(a,l,e,i)=>{for(var t=i>1?void 0:i?k(l,e):l,s=a.length-1,r;s>=0;s--)(r=a[s])&&(t=(i?r(l,e,t):r(t))||t);return i&&t&&m(l,e,t),t};var K={};P(K,{SkdxTree:()=>n,defaultGetLoadedLabel:()=>L,treeNodeLabel:()=>M});module.exports=T(K);var u=require("lit"),o=require("lit/decorators.js"),A=require("lit/directives/repeat.js"),I=require("../internal/define.cjs"),E=require("../internal/direction.cjs"),w=require("../internal/positioning.cjs"),b=require("../internal/typeahead.cjs"),C=require("../utils/live-announcer.cjs"),B=require("./TreeGroup.cjs"),$=require("./TreeItem.cjs"),R=require("./TreeItemIndicator.cjs");var O='[role="treeitem"]:not([data-disabled])',x='[role="treeitem"]';function p(a){return a.getAttribute("data-skdx-tree-node-id")??""}function M(a){let l=a.getAttribute("data-text-value");if(l!==null)return l;let e="";for(let i of Array.from(a.childNodes)){let t=i.nodeType===1?i:null;t&&(t.getAttribute("role")==="group"||t.getAttribute("aria-hidden")==="true")||(e+=i.textContent??"")}return e}function L(a){return`${a} loaded`}var n=class extends u.LitElement{constructor(){super(...arguments);this.selectionMode="single";this.defaultExpandedIds=[];this.defaultSelectedIds=[];this.selectionPropagation="none";this.getLoadedLabel=L;this.disabledBehavior="all";this.expandOnClick=!0;this._uncontrolledExpanded=new Set;this._uncontrolledSelected=new Set;this._uncontrolledChecked=new Set;this._activeNodeId=null;this._loadingIds=new Set;this._initialized=!1;this._requested=new Set;this._nodeParents=new Map;this._typeahead=new b.Typeahead;this._collectionAdopted=!1;this._rememberedChildren=new Map;this._anchorNodeId=null;this.handleFocusIn=e=>{let t=e.target.closest?.('[role="treeitem"]');if(t&&(this.disabledBehavior==="selection"||!t.hasAttribute("data-disabled"))){let s=t.getAttribute("data-skdx-tree-node-id");s&&this.setActiveNodeId(s)}};this.handleKeyDown=e=>{let i=e.target;if(!i.matches?.('[role="treeitem"]'))return;let t=Array.from(this.querySelectorAll(this.itemSelector)),s=t.indexOf(i),r=this.selectionMode==="multiple",h=(0,E.directionalKey)(e.key,this);if(r&&e.shiftKey&&(h==="ArrowDown"||h==="ArrowUp")){e.preventDefault();let c=t[s+(h==="ArrowDown"?1:-1)];c&&(c.focus(),this.toggleSelected(p(c)));return}if(r&&e.shiftKey&&e.key===" "){e.preventDefault();let c=t.map(p),f=this._anchorNodeId===null?-1:c.indexOf(this._anchorNodeId),y=c.indexOf(p(i));f===-1||y===-1?this.toggleSelected(p(i)):this.selectMany(c.slice(Math.min(f,y),Math.max(f,y)+1));return}if(r&&e.shiftKey&&(e.key==="Home"||e.key==="End")){e.preventDefault();let c=e.key==="Home"?0:t.length-1;this.selectMany(t.slice(Math.min(s,c),Math.max(s,c)+1).map(p)),t[c]?.focus();return}if(r&&(e.ctrlKey||e.metaKey)&&e.key.toLowerCase()==="a"){e.preventDefault(),this.toggleSelectAll(t.map(p));return}if(h==="ArrowDown"){e.preventDefault(),t[s+1]?.focus();return}if(h==="ArrowUp"){e.preventDefault(),t[s-1]?.focus();return}if(h==="Home"){e.preventDefault(),t[0]?.focus();return}if(h==="End"){e.preventDefault(),t[t.length-1]?.focus();return}let g=p(i),_=i.hasAttribute("aria-expanded"),S=i.getAttribute("aria-expanded")==="true",v=i.getAttribute("data-skdx-tree-parent-id")||"";if(h==="ArrowRight")e.preventDefault(),_&&!S?this.setExpanded(g,!0):t[s+1]?.focus();else if(h==="ArrowLeft")e.preventDefault(),_&&S?this.setExpanded(g,!1):v&&t.find(f=>p(f)===v)?.focus();else if(e.key==="Enter"||e.key===" "){if(e.preventDefault(),i.hasAttribute("data-disabled"))return;this.toggleSelected(g),e.key==="Enter"&&this.emitActivate(g)}else if(e.key==="*")e.preventDefault(),this.expandMany(Array.from(this.querySelectorAll(x)).filter(c=>(c.getAttribute("data-skdx-tree-parent-id")||"")===v&&c.getAttribute("aria-expanded")==="false").map(p));else if((0,b.isTypeaheadKey)(e)){let c=this._typeahead.match(e.key,t.map(M),s);if(c===-1)return;e.preventDefault(),t[c]?.focus()}}}get itemSelector(){return this.disabledBehavior==="selection"?x:O}connectedCallback(){super.connectedCallback(),this._initialized||(this._uncontrolledExpanded=new Set(this.defaultExpandedIds),this._uncontrolledSelected=new Set(this.defaultSelectedIds),this._uncontrolledChecked=new Set(this.defaultCheckedIds),this._initialized=!0),this.setAttribute("role","tree"),this.syncHostAttrs(),this.addEventListener("keydown",this.handleKeyDown),this.addEventListener("focusin",this.handleFocusIn)}disconnectedCallback(){this.removeEventListener("keydown",this.handleKeyDown),this.removeEventListener("focusin",this.handleFocusIn),this._typeahead.clear(),super.disconnectedCallback()}updated(e){(e.has("expandedIds")||e.has("selectedIds")||e.has("checkedIds")||e.has("selectionMode")||e.has("selectionPropagation"))&&(this.syncHostAttrs(),this._broadcast()),this.collection&&this.renderCollection(this.collection)}renderCollection(e){this._collectionAdopted||(this._collectionAdopted=!0,this.replaceChildren()),(0,u.render)(this.renderNodes(e),this,{host:this})}renderNodes(e){return(0,A.repeat)(e,i=>i.nodeId,i=>{let t=i.children??[];return u.html`<skdx-tree-item
+          node-id=${i.nodeId}
+          ?disabled=${i.disabled===!0}
+          text-value=${i.textValue??u.nothing}
+          .hasChildren=${i.hasChildren}
+        >
+          ${this.renderLabel?.(i)??i.label??i.nodeId}
+          ${t.length>0?u.html`<skdx-tree-group
+                  >${this.expandedIdSet.has(i.nodeId)?this.renderNodes(t):u.nothing}</skdx-tree-group
+                >`:u.nothing}
+        </skdx-tree-item>`})}syncHostAttrs(){this.selectionMode==="multiple"?this.setAttribute("aria-multiselectable","true"):this.removeAttribute("aria-multiselectable")}get expandedIdSet(){return this.expandedIds!==void 0?new Set(this.expandedIds):this._uncontrolledExpanded}get selectedIdSet(){return this.selectedIds!==void 0?new Set(this.selectedIds):this._uncontrolledSelected}get checkedIdSet(){return this.checkedIds!==void 0?new Set(this.checkedIds):this._uncontrolledChecked}get hasCheckedAxis(){return this.checkedIds!==void 0||this.defaultCheckedIds!==void 0}get activeNodeId(){return this._activeNodeId}isLoading(e){return this._loadingIds.has(e)}registerNode(e,i){this._nodeParents.get(e)!==i&&(this._nodeParents.set(e,i),this._broadcastHierarchy())}unregisterNode(e){this._nodeParents.delete(e)&&this._broadcastHierarchy()}_broadcastHierarchy(){this.selectionPropagation==="descendants"&&this._broadcast()}get childrenByParent(){let e=new Map;for(let[i,t]of this._nodeParents){if(t===null)continue;let s=e.get(t);s?s.push(i):e.set(t,[i])}return e}_refreshKnownChildren(e){let i=this.expandedIdSet;for(let t of this._nodeParents.keys())i.has(t)&&this._rememberedChildren.set(t,[...e.get(t)??[]])}_childIdsOf(e,i){return i.get(e)??this._rememberedChildren.get(e)??[]}descendantsOf(e){let i=this.childrenByParent;this._refreshKnownChildren(i);let t=[],s=new Set([e]),r=[...this._childIdsOf(e,i)];for(;r.length>0;){let h=r.pop();s.has(h)||(s.add(h),t.push(h),r.push(...this._childIdsOf(h,i)))}return t}checkedState(e){if(this.selectionPropagation!=="descendants")return!1;let i=this.hasCheckedAxis?this.checkedIdSet:this.selectedIdSet,t=this.descendantsOf(e);if(t.length===0)return i.has(e);let s=t.filter(r=>i.has(r)).length;return s===0?!1:s===t.length?!0:"mixed"}setActiveNodeId(e){this._activeNodeId!==e&&(this._activeNodeId=e,this._broadcast())}ensureActiveNodeId(){let e=Array.from(this.querySelectorAll(this.itemSelector),t=>t.getAttribute("data-skdx-tree-node-id")).filter(t=>t!==null&&t!=="");if(e.length===0||this._activeNodeId!==null&&e.includes(this._activeNodeId))return;let i=this.selectedIdSet;this.setActiveNodeId(e.find(t=>i.has(t))??e[0])}syncNodePositions(){let e=new Map;for(let i of this.querySelectorAll(x)){let t=i.getAttribute("data-skdx-tree-parent-id")??"",s=e.get(t);s?s.push(i):e.set(t,[i])}for(let i of e.values())i.forEach((t,s)=>{t.syncPosition(s+1,i.length)})}expandMany(e){if(e.length===0)return;let i=new Set(this.expandedIdSet);for(let t of e)i.add(t);this.expandedIds===void 0&&(this._uncontrolledExpanded=i),this.dispatchEvent(new CustomEvent("expanded-ids-change",{detail:[...i],bubbles:!0,composed:!0}));for(let t of e)this._startLoad(t,!0);this._broadcast()}get activeAxis(){return this.hasCheckedAxis?"checked":"selected"}get activeIdSet(){return this.activeAxis==="checked"?this.checkedIdSet:this.selectedIdSet}commitActiveAxis(e){this.activeAxis==="checked"?(this.checkedIds===void 0&&(this._uncontrolledChecked=e),this.dispatchEvent(new CustomEvent("checked-ids-change",{detail:[...e],bubbles:!0,composed:!0}))):(this.selectedIds===void 0&&(this._uncontrolledSelected=e),this.dispatchEvent(new CustomEvent("selected-ids-change",{detail:[...e],bubbles:!0,composed:!0}))),this._broadcast()}selectMany(e){if(this.selectionMode!=="multiple")return;let i=e[e.length-1];i!==void 0&&(this._anchorNodeId=i);let t=new Set(this.activeIdSet);for(let s of e)t.add(s);this.commitActiveAxis(t)}toggleSelectAll(e){if(this.selectionMode!=="multiple"||e.length===0)return;let i=this.activeIdSet,t=new Set(i);if(e.every(s=>i.has(s)))for(let s of e)t.delete(s);else for(let s of e)t.add(s);this.commitActiveAxis(t)}emitActivate(e){this.dispatchEvent(new CustomEvent("activate",{detail:e,bubbles:!0,composed:!0}))}setExpanded(e,i){let t=this.expandedIdSet,s=i?new Set(t).add(e):new Set([...t].filter(r=>r!==e));this.expandedIds===void 0&&(this._uncontrolledExpanded=s),this.dispatchEvent(new CustomEvent("expanded-ids-change",{detail:[...s],bubbles:!0,composed:!0})),this._startLoad(e,i),this._broadcast()}_startLoad(e,i){let t=this.loadChildren;if(!i||!t||this._requested.has(e))return;this._requested.add(e),this._loadingIds=new Set(this._loadingIds).add(e);let s=()=>{let r=new Set(this._loadingIds);r.delete(e),this._loadingIds=r,this._broadcast()};Promise.resolve(t(e)).then(()=>{s(),(0,C.announce)(this.getLoadedLabel(e))},r=>{this._requested.delete(e),s(),this.dispatchEvent(new CustomEvent("load-error",{detail:{nodeId:e,error:r},bubbles:!0,composed:!0}))})}invalidate(e){if(e===void 0){this._requested.clear();return}this._requested.delete(e);for(let i of this.descendantsOf(e))this._requested.delete(i)}toggleSelected(e){if(this.selectionMode==="none")return;this._anchorNodeId=e;let i=this.activeIdSet,t;if(this.selectionMode==="multiple"&&this.selectionPropagation==="descendants"){let s=this.checkedState(e)!==!0;t=new Set(i);for(let r of[e,...this.descendantsOf(e)])s?t.add(r):t.delete(r)}else this.selectionMode==="single"?t=new Set([e]):(t=new Set(i),t.has(e)?t.delete(e):t.add(e));this.commitActiveAxis(t)}_broadcast(){this.dispatchEvent(new CustomEvent("skdx-tree-internal-update"))}render(){return u.html`<slot></slot>`}};n.styles=u.css`
     :host {
       display: block;
     }
-  `,l([(0,c.property)({type:String,attribute:"selection-mode"})],a.prototype,"selectionMode",2),l([(0,c.property)({attribute:!1})],a.prototype,"expandedIds",2),l([(0,c.property)({type:Array,attribute:"default-expanded-ids"})],a.prototype,"defaultExpandedIds",2),l([(0,c.property)({attribute:!1})],a.prototype,"selectedIds",2),l([(0,c.property)({type:Array,attribute:"default-selected-ids"})],a.prototype,"defaultSelectedIds",2),l([(0,c.property)({type:String,attribute:"selection-propagation"})],a.prototype,"selectionPropagation",2),l([(0,c.property)({attribute:!1})],a.prototype,"loadChildren",2),l([(0,c.property)({attribute:!1})],a.prototype,"getLoadedLabel",2),l([(0,c.state)()],a.prototype,"_uncontrolledExpanded",2),l([(0,c.state)()],a.prototype,"_uncontrolledSelected",2),l([(0,c.state)()],a.prototype,"_activeNodeId",2),l([(0,c.state)()],a.prototype,"_loadingIds",2),a=l([(0,S.customElement)("skdx-tree","tree","root")],a);0&&(module.exports={SkdxTree,defaultGetLoadedLabel,treeNodeLabel});
+  `,d([(0,o.property)({type:String,attribute:"selection-mode"})],n.prototype,"selectionMode",2),d([(0,o.property)({attribute:!1})],n.prototype,"expandedIds",2),d([(0,o.property)({type:Array,attribute:"default-expanded-ids"})],n.prototype,"defaultExpandedIds",2),d([(0,o.property)({attribute:!1})],n.prototype,"selectedIds",2),d([(0,o.property)({type:Array,attribute:"default-selected-ids"})],n.prototype,"defaultSelectedIds",2),d([(0,o.property)({attribute:!1})],n.prototype,"checkedIds",2),d([(0,o.property)({type:Array,attribute:"default-checked-ids"})],n.prototype,"defaultCheckedIds",2),d([(0,o.property)({type:String,attribute:"selection-propagation"})],n.prototype,"selectionPropagation",2),d([(0,o.property)({attribute:!1})],n.prototype,"loadChildren",2),d([(0,o.property)({attribute:!1})],n.prototype,"getLoadedLabel",2),d([(0,o.property)({type:String,attribute:"disabled-behavior"})],n.prototype,"disabledBehavior",2),d([(0,o.property)({converter:w.optOutBoolean,attribute:"expand-on-click"})],n.prototype,"expandOnClick",2),d([(0,o.property)({attribute:!1})],n.prototype,"collection",2),d([(0,o.property)({attribute:!1})],n.prototype,"renderLabel",2),d([(0,o.state)()],n.prototype,"_uncontrolledExpanded",2),d([(0,o.state)()],n.prototype,"_uncontrolledSelected",2),d([(0,o.state)()],n.prototype,"_uncontrolledChecked",2),d([(0,o.state)()],n.prototype,"_activeNodeId",2),d([(0,o.state)()],n.prototype,"_loadingIds",2),n=d([(0,I.customElement)("skdx-tree","tree","root")],n);0&&(module.exports={SkdxTree,defaultGetLoadedLabel,treeNodeLabel});

package/dist/tree/Tree.d.cts

@@ -1,67 +1,58 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
+import './TreeGroup.cjs';
+import './TreeItem.cjs';
+import './TreeItemIndicator.cjs';
 /**
- * The text typeahead matches a node against: its `data-text-value` if it has
- * one, else its *own* label text.
- *
- * `internal/typeahead`'s shared `itemText` is the wrong tool for a tree: a node
- * renders its `<skdx-tree-item-indicator>` before its label, so a chevron would
- * read as `"▸src"` and typing `s` would match nothing; and an expanded node
- * contains its whole subtree, so its text would trail every descendant's.
- * Skipping the `aria-hidden` indicator and the nested `role="group"` leaves
- * exactly the label — with the same `data-text-value` precedence that every
- * matcher in this repo honours first.
- *
+ * Matches against a node's `data-text-value` if set, else its own label text,
+ * skipping indicators and nested groups.
  * @internal
  */
 export declare function treeNodeLabel(item: HTMLElement): string;
 /** How many nodes a {@link SkdxTree} allows selected at once: one, many, or no selection. */
 export type SkdxTreeSelectionMode = '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 entire subtree, enabling tri-state checkbox behavior. */
 export type SkdxTreeSelectionPropagation = 'none' | 'descendants';
 /** A node's tri-state checkbox value, as reported on `aria-checked`. */
 export type SkdxTreeCheckedState = boolean | 'mixed';
+/** Whether disabled node is inert (`'all'`) or keyboard-accessible (`'selection'`). */
+export type SkdxTreeDisabledBehavior = 'all' | 'selection';
+/** `load-error` event detail: branch whose `loadChildren` rejected, and why. */
+export interface SkdxTreeLoadErrorDetail {
+    /** Node whose `loadChildren` rejected. */
+    nodeId: string;
+    /** Rejection reason (unknown: consumer-supplied function). */
+    error: unknown;
+}
 /** Default `getLoadedLabel`: `"src loaded"`. */
 export declare function defaultGetLoadedLabel(nodeId: string): string;
+/** Node in tree's hierarchical collection. */
+export interface SkdxTreeNode {
+    /** Unique key across collection (used in expandedIds, selectedIds, checkedIds). */
+    nodeId: string;
+    /** Text when no `renderLabel`; defaults to `nodeId`. */
+    label?: string;
+    /** Exclude from selection/activation. */
+    disabled?: boolean;
+    /** Marks branch with unloaded children. */
+    hasChildren?: boolean;
+    /** Typeahead match text; falls back to rendered label. */
+    textValue?: string;
+    /** Child nodes. */
+    children?: SkdxTreeNode[];
+}
 /**
- * `<skdx-tree>` — the Web Components implementation of the shared Tree
- * contract (see `@skdx/shared`'s `treeContract`). Follows the WAI-ARIA
- * `treeview` pattern: renders `role="tree"` with `aria-multiselectable` when
- * `selection-mode` is `"multiple"`. Owns expanded/selected/active-node
- * state and hands it down to `<skdx-tree-item>` / `<skdx-tree-group>` /
- * `<skdx-tree-item-indicator>` via `this.closest('skdx-tree')` (there is no
- * cross-shadow-root context mechanism in Web Components), re-syncing them
- * via an internal broadcast event.
- *
- * A single tab stop uses roving tabindex over the currently *visible* items
- * only — `<skdx-tree-group>` physically removes its children from the DOM
- * while collapsed (true unmounting, not just hiding), so they're naturally
- * excluded. Arrow Up/Down/Home/End move focus; Arrow Right expands a
- * collapsed node (or moves to its first child if already expanded); Arrow
- * Left collapses an expanded node (or moves focus to its parent); Enter/
- * Space select the focused node; printable characters run typeahead over the
- * visible nodes' labels; `*` expands every collapsed sibling of the focused
- * node. Under `selection-mode="multiple"`, Shift+Arrow Up/Down moves focus
- * and toggles the node it lands on, Shift+Home/End selects through to the
- * first/last node, Ctrl+A selects every visible node, and Ctrl+Arrow Up/Down
- * moves focus without touching the selection.
+ * Tree root (WAI-ARIA treeview pattern). Owns expanded/selected/active state, dispatches to items via `closest()`.
  *
- * Expansion and selection each work controlled (`expanded-ids`/
- * `selected-ids` properties + listening for `expanded-ids-change`/
- * `selected-ids-change`) or uncontrolled (`default-expanded-ids`/
- * `default-selected-ids`).
+ * Single roving tab stop over visible items (collapsed unmounted, not hidden). Arrow keys navigate/expand,
+ * Enter/Space select, typeahead over labels. Controlled or uncontrolled expansion/selection.
+ * `loadChildren` lazy-populates branch on first expand. `selection-propagation="descendants"` enables
+ * tri-state checkboxes with `aria-checked`.
  *
- * `loadChildren` lazily populates a branch the first time it expands, marking
- * the node `aria-busy` meanwhile and announcing when its children arrive.
- * `selection-propagation="descendants"` turns it into a tri-state checkbox tree.
+ * **Requires accessible name** — `aria-label`/`aria-labelledby` (APG requirement).
  *
  * @example
  * ```html
- * <skdx-tree default-expanded-ids='["src"]'>
+ * <skdx-tree aria-label="Project files" default-expanded-ids='["src"]'>
  *   <skdx-tree-item node-id="src">
  *     <skdx-tree-item-indicator>▸</skdx-tree-item-indicator>
  *     src
@@ -72,8 +63,11 @@ export declare function defaultGetLoadedLabel(nodeId: string): string;
  * </skdx-tree>
  * ```
  *
- * @fires expanded-ids-change - Fired with the whole new expanded set as an `string[]` whenever a node is expanded or collapsed.
- * @fires selected-ids-change - Fired with the whole new selected set as an `string[]` whenever the selection changes.
+ * @fires expanded-ids-change - Emitted when the set of expanded node IDs changes.
+ * @fires selected-ids-change - Emitted when the set of selected node IDs changes.
+ * @fires checked-ids-change - New checked set (`string[]`) when checked axis exists.
+ * @fires activate - Node id on Enter or pointer activation.
+ * @fires load-error - `{ nodeId, error }` when `loadChildren` rejects.
  */
 export declare class SkdxTree extends LitElement {
     static styles: import("lit").CSSResult;
@@ -81,170 +75,119 @@ export declare class SkdxTree extends LitElement {
     selectionMode: SkdxTreeSelectionMode;
     /** Expanded node ids, for controlled usage. Listen for `expanded-ids-change`. */
     expandedIds?: string[];
-    /**
-     * Initially expanded node ids, for uncontrolled usage. A JSON array
-     * attribute (Lit's default `Array` converter — same convention as
-     * `<skdx-tags-input>`'s `value`), e.g. `default-expanded-ids='["src"]'`.
-     */
+    /** Initially expanded ids, uncontrolled; JSON array. */
     defaultExpandedIds: string[];
     /** Selected node ids, for controlled usage. Listen for `selected-ids-change`. */
     selectedIds?: string[];
-    /**
-     * Initially selected node ids, for uncontrolled usage. A JSON array
-     * attribute (Lit's default `Array` converter), e.g. `default-selected-ids='["src"]'`.
-     */
+    /** Initially selected ids, uncontrolled; JSON array. */
     defaultSelectedIds: string[];
     /**
-     * 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 `selection-mode="multiple"`; ignored otherwise.
-     *
-     * Propagation reaches *rendered* descendants only — `<skdx-tree-group>`
-     * detaches its children while collapsed, so their `<skdx-tree-item>`s
-     * disconnect, unregister, and cannot be toggled.
+     * Checked node ids for controlled usage; a separate axis from selection when
+     * supplied. `aria-checked` derives from `selectedIds` when omitted.
+     * @default undefined — `aria-checked` derives from `selectedIds`.
      */
+    checkedIds?: string[];
+    /** Initially checked ids, uncontrolled; JSON array. Omit to derive `aria-checked` from selection. @default undefined. */
+    defaultCheckedIds?: string[];
+    /** When `"descendants"`, toggle selects entire subtree, reports tri-state `aria-checked` (applies to all descendants including collapsed, lazy-loaded). */
     selectionPropagation: SkdxTreeSelectionPropagation;
-    /**
-     * 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 announcer. 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 `<skdx-tree-group>` child to be expandable at all —
-     * render an empty one and fill it in when the promise resolves. Set as a
-     * property, not an attribute.
-     */
+    /** Load node's children on first expand. Return promise to mark busy; rejection allows retry. */
     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. Set as a property, not an attribute.
-     */
+    /** Announcement when lazy-loaded children arrive; return empty string for silent. */
     getLoadedLabel: (nodeId: string) => string;
+    /** Disabled node behavior: inert (`"all"`) or keyboard-accessible, selection refused (`"selection"`). */
+    disabledBehavior: SkdxTreeDisabledBehavior;
+    /** Branch click expands (and selects); false limits to chevron and keyboard. @default true */
+    expandOnClick: boolean;
+    /** Hierarchical data to render (replaces light-DOM composition). Rendered structure identical either way. @default undefined — render light-DOM. */
+    collection?: readonly SkdxTreeNode[];
+    /** Render collection node's label and inline content (inside `treeitem`); ignored without `collection`. @default undefined — `label ?? nodeId` as text. */
+    renderLabel?: (node: SkdxTreeNode) => TemplateResult | string;
+    /** @internal */
+    get itemSelector(): string;
     private _uncontrolledExpanded;
     private _uncontrolledSelected;
+    private _uncontrolledChecked;
     private _activeNodeId;
     private _loadingIds;
     private _initialized;
-    /**
-     * Nodes whose `loadChildren` has already been kicked off. Not `@state`:
-     * nothing renders from it, and it must be readable synchronously inside the
-     * same `setExpanded` call that writes it.
-     */
+    /** Nodes with invoked loadChildren (not @state). */
     private readonly _requested;
-    /** `nodeId` → its parent's id (or `null` at the top level), for the tri-state tree only. */
+    /** `nodeId` → parent id (null at top), tri-state tree only. */
     private readonly _nodeParents;
-    /** The letter-key search buffer behind the treeview typeahead. */
+    /** Letter-key search buffer for typeahead. */
     private readonly _typeahead;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected updated(changed: Map<string, unknown>): void;
+    private _collectionAdopted;
+    /** Render to light DOM so closest('skdx-tree') finds all parts. */
+    private renderCollection;
+    private renderNodes;
     private syncHostAttrs;
-    /** @internal Resolved expanded node ids, controlled or uncontrolled. */
+    /** @internal Expanded ids. */
     get expandedIdSet(): Set<string>;
-    /** @internal Resolved selected node ids, controlled or uncontrolled. */
+    /** @internal Selected ids. */
     get selectedIdSet(): Set<string>;
-    /** @internal Currently active (roving-tabindex) node id, or `null`. */
+    /** @internal Checked ids. */
+    get checkedIdSet(): Set<string>;
+    /** @internal Separate checked axis exists. */
+    get hasCheckedAxis(): boolean;
+    /** @internal Current roving-tabindex node id or null. */
     get activeNodeId(): string | null;
-    /** @internal Whether `nodeId`'s `loadChildren` call is still pending. */
+    /** @internal loadChildren pending. */
     isLoading(nodeId: string): boolean;
-    /**
-     * @internal Called by each `<skdx-tree-item>` on connect so the root can walk
-     * the node hierarchy without touching the DOM. Unconditional even though only
-     * the tri-state checkbox tree reads the hierarchy: gating it on
-     * `selection-propagation` would leave every already-connected item
-     * unregistered when the attribute flips after mount, and the tri-state would
-     * silently derive from an empty hierarchy.
-     */
+    /** @internal Track node hierarchy (called on item connect). */
     registerNode(nodeId: string, parentId: string | null): void;
-    /** @internal Called by each `<skdx-tree-item>` on disconnect. */
+    /** @internal Called on item disconnect. */
     unregisterNode(nodeId: string): void;
-    /**
-     * Re-renders every item after the hierarchy moved — but only when something
-     * renders from it. Registration itself is unconditional (see
-     * {@link registerNode}); telling the items about it is not, because a
-     * broadcast re-runs every item's `sync()`, which re-fires the group's
-     * mount/unmount, which connects and disconnects items, which registers and
-     * unregisters them again. Only the tri-state tree reads the hierarchy, so
-     * only it pays for that round trip.
-     */
+    /** Re-broadcasts only if tri-state tree reads the hierarchy. */
     private _broadcastHierarchy;
-    /** Parent id → its registered child ids. */
+    /** Map: parent id → child ids. */
     private get childrenByParent();
-    /**
-     * @internal Every registered descendant of `nodeId`.
-     *
-     * ponytail: only *rendered* descendants count — `<skdx-tree-group>` detaches
-     * its children while collapsed, so a collapsed subtree's items disconnect and
-     * unregister. That is the intended ceiling. Persist the full hierarchy in
-     * your own data and drive `selectedIds` controlled if collapsed branches must
-     * participate.
-     */
+    /** Children snapshot per parent, persisted across collapse. */
+    private readonly _rememberedChildren;
+    /** Update remembered children snapshots for expanded parents. */
+    private _refreshKnownChildren;
+    /** Children: live registrations or snapshot; lazy nodes use own membership. */
+    private _childIdsOf;
+    /** @internal All descendants ever rendered (including disconnected). */
     descendantsOf(nodeId: string): string[];
-    /**
-     * @internal Tri-state value for a node: derived from its registered
-     * descendants when it has any, otherwise its own membership in the selected
-     * set. Always `false` unless `selection-propagation` is `"descendants"`.
-     */
+    /** @internal Tri-state checkbox value from descendants or node's membership. */
     checkedState(nodeId: string): SkdxTreeCheckedState;
-    /** @internal Marks `nodeId` as the roving-tabindex stop. */
+    /** @internal Make node the roving-tabindex stop. */
     setActiveNodeId(nodeId: string): void;
-    /**
-     * @internal Keeps the roving tab stop on a node that actually exists: seeds
-     * the first currently-visible item unless one of them still claims the active
-     * id.
-     *
-     * The check is "does any visible item claim the id", not "is the id unset":
-     * the item holding the stop can go away — collapsing its branch unmounts it —
-     * leaving the id pointing at a node that is no longer rendered, which an
-     * `activeNodeId !== null` guard reads as nothing to do. No item would then
-     * carry `tabindex="0"` and the whole tree would drop out of the tab order,
-     * with nothing on screen to explain it. Called by every `<skdx-tree-item>` on
-     * connect *and* disconnect, so it re-runs whenever the item set changes.
-     */
+    /** @internal Seeds first visible item or first selected, unless an item still claims active id. Called on every item connect/disconnect (re-runs when set changes). */
     ensureActiveNodeId(): void;
-    /**
-     * @internal Writes `aria-posinset`/`aria-setsize` onto every rendered item,
-     * counting the siblings under each `data-skdx-tree-parent-id` in document
-     * order — siblings at one level, not a flat index over the tree. Required
-     * rather than optional here because `<skdx-tree-group>` *detaches* a collapsed
-     * subtree: assistive tech cannot infer a set it cannot see.
-     *
-     * Written straight onto the elements, like every other attribute an item
-     * carries in this package, and driven from `<skdx-tree-item>`'s connect and
-     * disconnect — the one pair of moments the sibling set can change. A root
-     * broadcast is deliberately not used: it re-runs every item's `sync()`, which
-     * re-fires a group's mount/unmount, which connects and disconnects items
-     * again.
-     */
+    /** @internal Write `aria-posinset`/`aria-setsize` (sibling position, not tree-wide). Needed: collapsed subtrees detached. Skips author-overridden attributes. */
     syncNodePositions(): void;
-    /**
-     * @internal Expands every id in one update, for `*`. Not a loop over
-     * {@link setExpanded}, which would dispatch one `expanded-ids-change` per
-     * sibling and, while `expandedIds` is set from outside, resolve each call
-     * against the same unchanged array. Each node still gets its own
-     * `loadChildren` kickoff.
-     */
+    /** @internal Expands all ids in one update (for `*`), not loop over setExpanded. Each node gets own loadChildren kickoff. */
     expandMany(nodeIds: string[]): void;
-    /**
-     * @internal Adds every id to the selection in one update, for the range keys
-     * (Shift+Home/End, Ctrl+A) that would otherwise dispatch one change event per
-     * node. Plain union — `selection-propagation` deliberately doesn't apply: a
-     * range is already an explicit list of nodes, not one node standing in for
-     * its subtree.
-     */
+    /** @internal Toggle axis: checked or selected. */
+    private get activeAxis();
+    /** @internal Ids on active axis. */
+    private get activeIdSet();
+    /** Write to active axis, dispatch change. */
+    private commitActiveAxis;
+    /** @internal Add ids to active axis in one update (range keys). */
     selectMany(nodeIds: string[]): void;
-    /** @internal Expands or collapses `nodeId`, kicking off `loadChildren` the first time it expands. */
+    /** @internal Ctrl+A: toggle all rendered nodes on active axis. */
+    toggleSelectAll(nodeIds: string[]): void;
+    /** @internal Dispatch `activate` (Enter or click, never Space). */
+    emitActivate(nodeId: string): void;
+    /** APG anchor for Shift+Space range selection. */
+    private _anchorNodeId;
+    /** @internal Expand/collapse node; invoke loadChildren on first expand. */
     setExpanded(nodeId: string, expand: boolean): void;
     private _startLoad;
-    /** @internal Toggles `nodeId`'s selection, respecting `selectionMode` and `selectionPropagation`. */
+    /** Clear requested-load marker for retry. With nodeId, clear node and descendants; omit for whole tree. */
+    invalidate(nodeId?: string): void;
+    /** @internal Toggle node on active axis with subtree propagation. */
     toggleSelected(nodeId: string): void;
     private _broadcast;
     private readonly handleFocusIn;
     private readonly handleKeyDown;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {