@skdx/vue 0.27.0 → 0.28.0

package/dist/tree/Tree.vue.d.cts

@@ -1,33 +1,18 @@
-import { type TreeSelectionMode, type TreeSelectionPropagation } from './context.cjs';
+import { type TreeDisabledBehavior, type TreeLoadErrorDetail, type TreeNode, type TreeRenderLabel, type TreeSelectionMode, type TreeSelectionPropagation } from './context.cjs';
 /**
- * The Vue implementation of the shared Tree contract (see `@skdx/shared`'s
- * `treeContract`). WAI-ARIA `treeview` pattern: a single tab stop with
- * roving tabindex over the currently *visible* items (collapsed subtrees
- * aren't rendered, so they fall out of the roving set for free). Renders
- * `<div role="tree">`, owning expanded/selected/active-node state and
- * handing it down to `SkdxTreeItem` / `SkdxTreeGroup` / `SkdxTreeItemIndicator`
- * via context.
- *
- * ArrowUp/ArrowDown/Home/End move focus; ArrowRight expands a collapsed node
- * (or moves to its first child if already expanded); ArrowLeft 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+ArrowUp/ArrowDown 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+ArrowUp/ArrowDown moves focus without touching the selection.
- * Expansion and selection each work controlled
- * (`v-model:expanded-ids`/`v-model:selected-ids`) or uncontrolled
- * (`default-expanded-ids`/`default-selected-ids`).
- *
- * `load-children` 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.
+ * WAI-ARIA treeview: single tab stop with roving tabindex, keyboard
+ * navigation (arrows, Home/End, typeahead, `*`), and selection modes
+ * (none/single/multiple with Shift + Ctrl+A). Owns expanded/selected state
+ * for child items via context. Supports lazy-loading branches and tri-state
+ * checkbox propagation. Requires `aria-label` or `aria-labelledby`.
  */
 type __VLS_Props = {
     /** `"single"`, `"multiple"`, or `"none"` (not selectable, just expand/collapse). */
     selectionMode?: TreeSelectionMode;
+    /** Collection data; becomes source of truth, ignoring default slot. */
+    collection?: readonly TreeNode[];
+    /** Renders collection node content; ignored without `collection`. */
+    renderLabel?: TreeRenderLabel;
     /** Expanded node ids, for controlled usage. Pair with `v-model:expanded-ids`. */
     expandedIds?: string[];
     /** Initially expanded node ids, for uncontrolled usage. */
@@ -36,54 +21,74 @@ type __VLS_Props = {
     selectedIds?: string[];
     /** Initially selected node ids, for uncontrolled usage. */
     defaultSelectedIds?: string[];
+    /** Checked node ids, for controlled usage — a second axis from `selectedIds`, enabled once this or `defaultCheckedIds` is supplied. Pair with `v-model:checked-ids`. */
+    checkedIds?: string[];
+    /** Initially checked node ids, for uncontrolled usage; supplying it (even `[]`) gives the tree its own checked axis. */
+    defaultCheckedIds?: 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.
+     * Turns the tree into a tri-state checkbox tree: toggling a node
+     * selects/deselects its whole subtree, and each node reports
+     * `aria-checked` derived from its descendants. Only meaningful with
+     * `selection-mode="multiple"`.
      */
     selectionPropagation?: TreeSelectionPropagation;
     /**
-     * Loads a node's children the first time it is expanded. Return a promise
-     * to mark the node busy (`aria-busy="true"` plus `data-loading`) until it
-     * settles; when it resolves, `getLoadedLabel` is announced through the
-     * shared live region. A rejected promise clears the busy state, announces
-     * nothing, and leaves the node eligible to retry on the next expand.
-     *
-     * The node still needs an `SkdxTreeGroup` child to be expandable at all —
-     * render an empty one and fill it in when the promise resolves.
+     * Loads a node's children the first time it expands. A returned promise
+     * marks the node busy until it settles, announcing `getLoadedLabel` on
+     * success; a rejection clears the busy state and leaves the node retryable.
      */
     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.
-     */
+    /** Formats the announcement when lazy-loaded children arrive. */
     getLoadedLabel?: (nodeId: string) => string;
+    /** Controls how disabled nodes behave in navigation and selection. */
+    disabledBehavior?: TreeDisabledBehavior;
+    /** Whether clicking a branch expands and collapses it. */
+    expandOnClick?: boolean;
 };
-declare var __VLS_1: {};
+/** Clears load marker for node and descendants, whole tree if omitted. */
+declare function invalidate(nodeId?: string): void;
+declare var __VLS_5: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+    default?: (props: typeof __VLS_5) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /** Root `<div role="tree">` element. */
+    el: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+    /** Clears load marker; omit nodeId to clear whole tree. */
+    invalidate: typeof invalidate;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:expandedIds": (ids: string[]) => any;
     "expanded-ids-change": (ids: string[]) => any;
     "update:selectedIds": (ids: string[]) => any;
     "selected-ids-change": (ids: string[]) => any;
+    "update:checkedIds": (ids: string[]) => any;
+    "checked-ids-change": (ids: string[]) => any;
+    activate: (nodeId: string) => any;
+    "load-error": (detail: TreeLoadErrorDetail) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:expandedIds"?: ((ids: string[]) => any) | undefined;
     "onExpanded-ids-change"?: ((ids: string[]) => any) | undefined;
     "onUpdate:selectedIds"?: ((ids: string[]) => any) | undefined;
     "onSelected-ids-change"?: ((ids: string[]) => any) | undefined;
+    "onUpdate:checkedIds"?: ((ids: string[]) => any) | undefined;
+    "onChecked-ids-change"?: ((ids: string[]) => any) | undefined;
+    onActivate?: ((nodeId: string) => any) | undefined;
+    "onLoad-error"?: ((detail: TreeLoadErrorDetail) => any) | undefined;
 }>, {
+    collection: readonly TreeNode[];
     selectionMode: TreeSelectionMode;
+    selectionPropagation: TreeSelectionPropagation;
+    expandOnClick: boolean;
+    renderLabel: TreeRenderLabel;
     expandedIds: string[];
     defaultExpandedIds: string[];
     selectedIds: string[];
     defaultSelectedIds: string[];
-    selectionPropagation: TreeSelectionPropagation;
+    checkedIds: string[];
+    defaultCheckedIds: string[];
     loadChildren: (nodeId: string) => void | Promise<void>;
     getLoadedLabel: (nodeId: string) => string;
+    disabledBehavior: TreeDisabledBehavior;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/tree/Tree.vue.d.ts

@@ -1,33 +1,18 @@
-import { type TreeSelectionMode, type TreeSelectionPropagation } from './context.js';
+import { type TreeDisabledBehavior, type TreeLoadErrorDetail, type TreeNode, type TreeRenderLabel, type TreeSelectionMode, type TreeSelectionPropagation } from './context.js';
 /**
- * The Vue implementation of the shared Tree contract (see `@skdx/shared`'s
- * `treeContract`). WAI-ARIA `treeview` pattern: a single tab stop with
- * roving tabindex over the currently *visible* items (collapsed subtrees
- * aren't rendered, so they fall out of the roving set for free). Renders
- * `<div role="tree">`, owning expanded/selected/active-node state and
- * handing it down to `SkdxTreeItem` / `SkdxTreeGroup` / `SkdxTreeItemIndicator`
- * via context.
- *
- * ArrowUp/ArrowDown/Home/End move focus; ArrowRight expands a collapsed node
- * (or moves to its first child if already expanded); ArrowLeft 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+ArrowUp/ArrowDown 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+ArrowUp/ArrowDown moves focus without touching the selection.
- * Expansion and selection each work controlled
- * (`v-model:expanded-ids`/`v-model:selected-ids`) or uncontrolled
- * (`default-expanded-ids`/`default-selected-ids`).
- *
- * `load-children` 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.
+ * WAI-ARIA treeview: single tab stop with roving tabindex, keyboard
+ * navigation (arrows, Home/End, typeahead, `*`), and selection modes
+ * (none/single/multiple with Shift + Ctrl+A). Owns expanded/selected state
+ * for child items via context. Supports lazy-loading branches and tri-state
+ * checkbox propagation. Requires `aria-label` or `aria-labelledby`.
  */
 type __VLS_Props = {
     /** `"single"`, `"multiple"`, or `"none"` (not selectable, just expand/collapse). */
     selectionMode?: TreeSelectionMode;
+    /** Collection data; becomes source of truth, ignoring default slot. */
+    collection?: readonly TreeNode[];
+    /** Renders collection node content; ignored without `collection`. */
+    renderLabel?: TreeRenderLabel;
     /** Expanded node ids, for controlled usage. Pair with `v-model:expanded-ids`. */
     expandedIds?: string[];
     /** Initially expanded node ids, for uncontrolled usage. */
@@ -36,54 +21,74 @@ type __VLS_Props = {
     selectedIds?: string[];
     /** Initially selected node ids, for uncontrolled usage. */
     defaultSelectedIds?: string[];
+    /** Checked node ids, for controlled usage — a second axis from `selectedIds`, enabled once this or `defaultCheckedIds` is supplied. Pair with `v-model:checked-ids`. */
+    checkedIds?: string[];
+    /** Initially checked node ids, for uncontrolled usage; supplying it (even `[]`) gives the tree its own checked axis. */
+    defaultCheckedIds?: 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.
+     * Turns the tree into a tri-state checkbox tree: toggling a node
+     * selects/deselects its whole subtree, and each node reports
+     * `aria-checked` derived from its descendants. Only meaningful with
+     * `selection-mode="multiple"`.
      */
     selectionPropagation?: TreeSelectionPropagation;
     /**
-     * Loads a node's children the first time it is expanded. Return a promise
-     * to mark the node busy (`aria-busy="true"` plus `data-loading`) until it
-     * settles; when it resolves, `getLoadedLabel` is announced through the
-     * shared live region. A rejected promise clears the busy state, announces
-     * nothing, and leaves the node eligible to retry on the next expand.
-     *
-     * The node still needs an `SkdxTreeGroup` child to be expandable at all —
-     * render an empty one and fill it in when the promise resolves.
+     * Loads a node's children the first time it expands. A returned promise
+     * marks the node busy until it settles, announcing `getLoadedLabel` on
+     * success; a rejection clears the busy state and leaves the node retryable.
      */
     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.
-     */
+    /** Formats the announcement when lazy-loaded children arrive. */
     getLoadedLabel?: (nodeId: string) => string;
+    /** Controls how disabled nodes behave in navigation and selection. */
+    disabledBehavior?: TreeDisabledBehavior;
+    /** Whether clicking a branch expands and collapses it. */
+    expandOnClick?: boolean;
 };
-declare var __VLS_1: {};
+/** Clears load marker for node and descendants, whole tree if omitted. */
+declare function invalidate(nodeId?: string): void;
+declare var __VLS_5: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+    default?: (props: typeof __VLS_5) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /** Root `<div role="tree">` element. */
+    el: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+    /** Clears load marker; omit nodeId to clear whole tree. */
+    invalidate: typeof invalidate;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:expandedIds": (ids: string[]) => any;
     "expanded-ids-change": (ids: string[]) => any;
     "update:selectedIds": (ids: string[]) => any;
     "selected-ids-change": (ids: string[]) => any;
+    "update:checkedIds": (ids: string[]) => any;
+    "checked-ids-change": (ids: string[]) => any;
+    activate: (nodeId: string) => any;
+    "load-error": (detail: TreeLoadErrorDetail) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:expandedIds"?: ((ids: string[]) => any) | undefined;
     "onExpanded-ids-change"?: ((ids: string[]) => any) | undefined;
     "onUpdate:selectedIds"?: ((ids: string[]) => any) | undefined;
     "onSelected-ids-change"?: ((ids: string[]) => any) | undefined;
+    "onUpdate:checkedIds"?: ((ids: string[]) => any) | undefined;
+    "onChecked-ids-change"?: ((ids: string[]) => any) | undefined;
+    onActivate?: ((nodeId: string) => any) | undefined;
+    "onLoad-error"?: ((detail: TreeLoadErrorDetail) => any) | undefined;
 }>, {
+    collection: readonly TreeNode[];
     selectionMode: TreeSelectionMode;
+    selectionPropagation: TreeSelectionPropagation;
+    expandOnClick: boolean;
+    renderLabel: TreeRenderLabel;
     expandedIds: string[];
     defaultExpandedIds: string[];
     selectedIds: string[];
     defaultSelectedIds: string[];
-    selectionPropagation: TreeSelectionPropagation;
+    checkedIds: string[];
+    defaultCheckedIds: string[];
     loadChildren: (nodeId: string) => void | Promise<void>;
     getLoadedLabel: (nodeId: string) => string;
+    disabledBehavior: TreeDisabledBehavior;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/tree/Tree.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const B=require("../utils/direction.cjs"),re=require("../utils/useRovingFocus.cjs"),F=require("../utils/useTypeahead.cjs"),se=require("../utils/liveAnnouncer.cjs"),H=require("./context.cjs");let s=require("vue");var ae=["aria-multiselectable"],U='[role="treeitem"]:not([data-disabled])',G='[role="treeitem"]',ie=(0,s.defineComponent)({__name:"Tree",props:{selectionMode:{default:"single"},expandedIds:{default:void 0},defaultExpandedIds:{default:()=>[]},selectedIds:{default:void 0},defaultSelectedIds:{default:()=>[]},selectionPropagation:{default:"none"},loadChildren:{type:Function,default:void 0},getLoadedLabel:{type:Function,default:H.defaultGetLoadedLabel}},emits:["update:expandedIds","expanded-ids-change","update:selectedIds","selected-ids-change"],setup(E,{emit:X}){function d(e){return e.getAttribute("data-skdx-tree-node-id")??""}function Y(e){const t=e.getAttribute("data-text-value");if(t!==null)return t;let r="";for(const n of e.childNodes){const o=n.nodeType===1?n:null;o&&(o.getAttribute("role")==="group"||o.getAttribute("aria-hidden")==="true")||(r+=n.textContent??"")}return r}function $(e){const t=new Map;for(const n of e.querySelectorAll(G)){const o=d(n);if(!o)continue;const u=n.getAttribute("data-skdx-tree-parent-id")??"",f=t.get(u);f?f.push(o):t.set(u,[o])}const r=new Map;for(const n of t.values())n.forEach((o,u)=>{r.set(o,{posinset:u+1,setsize:n.length})});return r}function j(e,t){if(e.size!==t.size)return!1;for(const[r,n]of e){const o=t.get(r);if(!o||o.posinset!==n.posinset||o.setsize!==n.setsize)return!1}return!0}const a=E,h=X,p=(0,s.ref)(null),v=(0,s.ref)(null),J=B.useDirection(),D=(0,s.ref)(a.defaultExpandedIds),c=(0,s.computed)(()=>a.expandedIds??D.value),Q=(0,s.computed)(()=>new Set(c.value)),T=(0,s.ref)(a.defaultSelectedIds),m=(0,s.computed)(()=>a.selectedIds??T.value),y=(0,s.computed)(()=>new Set(m.value)),q=(0,s.computed)(()=>a.selectionPropagation==="descendants"),x=new Set,g=(0,s.ref)(new Set),l=(0,s.ref)(new Map);function V(e,t){l.value.get(e)!==t&&(l.value=new Map(l.value).set(e,t))}function W(e){if(!l.value.has(e))return;const t=new Map(l.value);t.delete(e),l.value=t}const C=(0,s.computed)(()=>{const e=new Map;for(const[t,r]of l.value){if(r===null)continue;const n=e.get(r);n?n.push(t):e.set(r,[t])}return e});function L(e){const t=[],r=[...C.value.get(e)??[]];for(;r.length>0;){const n=r.pop();t.push(n),r.push(...C.value.get(n)??[])}return t}function P(e){if(!q.value)return!1;const t=L(e);if(t.length===0)return y.value.has(e);const r=t.filter(n=>y.value.has(n)).length;return r===0?!1:r===t.length?!0:"mixed"}function I(e){a.expandedIds===void 0&&(D.value=e),h("update:expandedIds",e),h("expanded-ids-change",e)}function w(e){a.selectedIds===void 0&&(T.value=e),h("update:selectedIds",e),h("selected-ids-change",e)}function K(e){const t=a.loadChildren;if(!t||x.has(e))return;x.add(e),g.value=new Set(g.value).add(e);const r=()=>{const n=new Set(g.value);n.delete(e),g.value=n};Promise.resolve(t(e)).then(()=>{r(),se.announce(a.getLoadedLabel(e))},()=>{x.delete(e),r()})}function A(e,t){I(t?[...c.value,e]:c.value.filter(r=>r!==e)),t&&K(e)}function Z(e){if(e.length!==0){I([...new Set([...c.value,...e])]);for(const t of e)K(t)}}function M(e){if(a.selectionMode==="none")return;const t=m.value;if(a.selectionMode==="multiple"&&q.value){const r=P(e)!==!0,n=new Set(t);for(const o of[e,...L(e)])r?n.add(o):n.delete(o);w([...n]);return}w(a.selectionMode==="single"?[e]:t.includes(e)?t.filter(r=>r!==e):[...t,e])}function R(e){a.selectionMode==="multiple"&&w([...new Set([...m.value,...e])])}function ee(e){v.value=e}const k=(0,s.ref)(new Map);function S(){if(!p.value)return;const e=$(p.value);j(k.value,e)||(k.value=e)}function te(e){return k.value.get(e)}(0,s.onMounted)(S),(0,s.onUpdated)(S),(0,s.watch)([c,l],S,{flush:"post"}),(0,s.watch)(c,re.useRovingTabStop(p,U,"data-skdx-tree-node-id",v),{flush:"post"});const ne=F.useTypeahead();function oe(e){const t=B.directionalKey(e.key,e.currentTarget,J()),r=p.value,n=e.target;if(!r||!n.matches('[role="treeitem"]'))return;const o=Array.from(r.querySelectorAll(U)),u=o.indexOf(n),f=d(n),_=n.getAttribute("data-skdx-tree-parent-id")||"",b=a.selectionMode==="multiple";if(b&&e.shiftKey&&(t==="ArrowDown"||t==="ArrowUp")){e.preventDefault();const i=o[u+(t==="ArrowDown"?1:-1)];i&&(i.focus(),M(d(i)));return}if(b&&e.shiftKey&&(e.key==="Home"||e.key==="End")){e.preventDefault();const i=e.key==="Home"?0:o.length-1;R(o.slice(Math.min(u,i),Math.max(u,i)+1).map(d)),o[i]?.focus();return}if(b&&(e.ctrlKey||e.metaKey)&&e.key.toLowerCase()==="a"){e.preventDefault(),R(o.map(d));return}if(t==="ArrowDown"){e.preventDefault(),o[u+1]?.focus();return}if(t==="ArrowUp"){e.preventDefault(),o[u-1]?.focus();return}if(t==="Home"){e.preventDefault(),o[0]?.focus();return}if(t==="End"){e.preventDefault(),o[o.length-1]?.focus();return}const N=n.getAttribute("aria-expanded"),O=N!==null,z=N==="true";if(t==="ArrowRight")e.preventDefault(),O&&!z?A(f,!0):o[u+1]?.focus();else if(t==="ArrowLeft")e.preventDefault(),O&&z?A(f,!1):_&&o.find(i=>d(i)===_)?.focus();else if(e.key==="Enter"||e.key===" ")e.preventDefault(),M(f);else if(e.key==="*")e.preventDefault(),Z(Array.from(r.querySelectorAll(G)).filter(i=>(i.getAttribute("data-skdx-tree-parent-id")||"")===_&&i.getAttribute("aria-expanded")==="false").map(d));else if(F.isTypeaheadKey(e)){const i=ne(e.key,o.map(Y),u);if(i===-1)return;e.preventDefault(),o[i]?.focus()}}return(0,s.provide)(H.TREE_CONTEXT,{get selectionMode(){return a.selectionMode},get selectionPropagation(){return a.selectionPropagation},expandedIds:Q,selectedIds:y,loadingIds:g,activeNodeId:v,setActiveNodeId:ee,onExpandedChange:A,onSelectedChange:M,checkedState:P,positionOf:te,registerNode:V,unregisterNode:W}),(e,t)=>((0,s.openBlock)(),(0,s.createElementBlock)("div",{class:"skdx-tree","data-part":"root","data-skdx-component":"tree",ref_key:"rootRef",ref:p,role:"tree","aria-multiselectable":E.selectionMode==="multiple"?!0:void 0,onKeydown:oe},[(0,s.renderSlot)(e.$slots,"default")],40,ae))}});exports.default=ie;
+const ee=require("../utils/direction.cjs"),te=require("../utils/useTypeahead.cjs"),be=require("../utils/liveAnnouncer.cjs"),ne=require("./context.cjs"),Se=require("./nodes.cjs");let a=require("vue");var Me=["aria-multiselectable"],Ce='[role="treeitem"]:not([data-disabled])',P='[role="treeitem"]',Ee=(0,a.defineComponent)({__name:"Tree",props:{selectionMode:{default:"single"},collection:{default:void 0},renderLabel:{type:Function,default:void 0},expandedIds:{default:void 0},defaultExpandedIds:{default:()=>[]},selectedIds:{default:void 0},defaultSelectedIds:{default:()=>[]},checkedIds:{default:void 0},defaultCheckedIds:{default:void 0},selectionPropagation:{default:"none"},loadChildren:{type:Function,default:void 0},getLoadedLabel:{type:Function,default:ne.defaultGetLoadedLabel},disabledBehavior:{default:"all"},expandOnClick:{type:Boolean,default:!0}},emits:["update:expandedIds","expanded-ids-change","update:selectedIds","selected-ids-change","update:checkedIds","checked-ids-change","activate","load-error"],setup(g,{expose:oe,emit:re}){function d(e){return e.getAttribute("data-skdx-tree-node-id")??""}function ae(e){const t=e.getAttribute("data-text-value");if(t!==null)return t;let r="";for(const n of e.childNodes){const o=n.nodeType===1?n:null;o&&(o.getAttribute("role")==="group"||o.getAttribute("aria-hidden")==="true")||(r+=n.textContent??"")}return r}function le(e){const t=new Map;for(const n of e.querySelectorAll(P)){const o=d(n);if(!o)continue;const i=n.getAttribute("data-skdx-tree-parent-id")??"",c=t.get(i);c?c.push(o):t.set(i,[o])}const r=new Map;for(const n of t.values())n.forEach((o,i)=>{r.set(o,{posinset:i+1,setsize:n.length})});return r}function se(e,t){if(e.size!==t.size)return!1;for(const[r,n]of e){const o=t.get(r);if(!o||o.posinset!==n.posinset||o.setsize!==n.setsize)return!1}return!0}const l=g,f=re,p=(0,a.ref)(null),x=(0,a.ref)(null),ie=ee.useDirection(),B=(0,a.computed)(()=>l.disabledBehavior==="selection"?P:Ce),K=(0,a.ref)(l.defaultExpandedIds),h=(0,a.computed)(()=>l.expandedIds??K.value),N=(0,a.computed)(()=>new Set(h.value)),R=(0,a.ref)(l.defaultSelectedIds),S=(0,a.computed)(()=>l.selectedIds??R.value),M=(0,a.computed)(()=>new Set(S.value)),C=(0,a.computed)(()=>l.checkedIds!==void 0||l.defaultCheckedIds!==void 0),z=(0,a.ref)(l.defaultCheckedIds??[]),U=(0,a.computed)(()=>l.checkedIds??z.value),ue=(0,a.computed)(()=>new Set(U.value)),m=(0,a.computed)(()=>C.value?U.value:S.value),ce=(0,a.computed)(()=>C.value?ue.value:M.value),F=(0,a.computed)(()=>l.selectionPropagation==="descendants"),v=new Set,k=(0,a.ref)(new Set),u=(0,a.ref)(new Map);function de(e,t){u.value.get(e)!==t&&(u.value=new Map(u.value).set(e,t))}function fe(e){if(!u.value.has(e))return;const t=new Map(u.value);t.delete(e),u.value=t}const H=(0,a.computed)(()=>{const e=new Map;for(const[t,r]of u.value){if(r===null)continue;const n=e.get(r);n?n.push(t):e.set(r,[t])}return e}),G=new Map,pe=(0,a.computed)(()=>{for(const e of u.value.keys())N.value.has(e)&&G.set(e,[...H.value.get(e)??[]]);return G});function X(e){return H.value.get(e)??pe.value.get(e)??[]}function E(e){const t=[],r=new Set([e]),n=[...X(e)];for(;n.length>0;){const o=n.pop();r.has(o)||(r.add(o),t.push(o),n.push(...X(o)))}return t}function Y(e){if(!F.value)return!1;const t=ce.value,r=E(e);if(r.length===0)return t.has(e);const n=r.filter(o=>t.has(o)).length;return n===0?!1:n===r.length?!0:"mixed"}function $(e){l.expandedIds===void 0&&(K.value=e),f("update:expandedIds",e),f("expanded-ids-change",e)}function he(e){l.selectedIds===void 0&&(R.value=e),f("update:selectedIds",e),f("selected-ids-change",e)}function ve(e){l.checkedIds===void 0&&(z.value=e),f("update:checkedIds",e),f("checked-ids-change",e)}function y(e){C.value?ve(e):he(e)}function j(e){const t=l.loadChildren;if(!t||v.has(e))return;v.add(e),k.value=new Set(k.value).add(e);const r=()=>{const n=new Set(k.value);n.delete(e),k.value=n};Promise.resolve(t(e)).then(()=>{r(),be.announce(l.getLoadedLabel(e))},n=>{v.delete(e),r(),f("load-error",{nodeId:e,error:n})})}function ge(e){if(e===void 0){v.clear();return}v.delete(e);for(const t of E(e))v.delete(t)}function D(e,t){$(t?[...h.value,e]:h.value.filter(r=>r!==e)),t&&j(e)}function me(e){if(e.length!==0){$([...new Set([...h.value,...e])]);for(const t of e)j(t)}}let w=null;function A(e){if(l.selectionMode==="none")return;w=e;const t=m.value;if(l.selectionMode==="multiple"&&F.value){const r=Y(e)!==!0,n=new Set(t);for(const o of[e,...E(e)])r?n.add(o):n.delete(o);y([...n]);return}y(l.selectionMode==="single"?[e]:t.includes(e)?t.filter(r=>r!==e):[...t,e])}function J(e){if(l.selectionMode!=="multiple")return;const t=e[e.length-1];t!==void 0&&(w=t),y([...new Set([...m.value,...e])])}function ke(e){if(l.selectionMode!=="multiple"||e.length===0)return;const t=new Set(m.value);if(e.every(r=>t.has(r))){y(m.value.filter(r=>!e.includes(r)));return}y([...new Set([...m.value,...e])])}function Q(e){f("activate",e)}function ye(e){x.value=e}const q=(0,a.ref)(new Map);function T(){if(!p.value)return;const e=le(p.value);se(q.value,e)||(q.value=e)}function xe(e){return q.value.get(e)}(0,a.onMounted)(T),(0,a.onUpdated)(T),(0,a.watch)([h,u],T,{flush:"post"});function _(){const e=p.value;if(!e)return;const t=Array.from(e.querySelectorAll(B.value),n=>n.getAttribute("data-skdx-tree-node-id")).filter(n=>n!==null&&n!=="");if(t.length===0)return;const r=x.value;r!==null&&t.includes(r)||(x.value=t.find(n=>M.value.has(n))??t[0])}(0,a.onMounted)(_),(0,a.onUpdated)(_),(0,a.watch)([h,S,u],_,{flush:"post"});const we=te.useTypeahead();function Ae(e){const t=ee.directionalKey(e.key,e.currentTarget,ie()),r=p.value,n=e.target;if(!r||!n.matches('[role="treeitem"]'))return;const o=Array.from(r.querySelectorAll(B.value)),i=o.indexOf(n),c=d(n),L=n.getAttribute("data-skdx-tree-parent-id")||"",b=l.selectionMode==="multiple";if(b&&e.shiftKey&&(t==="ArrowDown"||t==="ArrowUp")){e.preventDefault();const s=o[i+(t==="ArrowDown"?1:-1)];s&&(s.focus(),A(d(s)));return}if(b&&e.shiftKey&&e.key===" "){e.preventDefault();const s=o.map(d),I=w===null?-1:s.indexOf(w),O=s.indexOf(c);I===-1||O===-1?A(c):J(s.slice(Math.min(I,O),Math.max(I,O)+1));return}if(b&&e.shiftKey&&(e.key==="Home"||e.key==="End")){e.preventDefault();const s=e.key==="Home"?0:o.length-1;J(o.slice(Math.min(i,s),Math.max(i,s)+1).map(d)),o[s]?.focus();return}if(b&&(e.ctrlKey||e.metaKey)&&e.key.toLowerCase()==="a"){e.preventDefault(),ke(o.map(d));return}if(t==="ArrowDown"){e.preventDefault(),o[i+1]?.focus();return}if(t==="ArrowUp"){e.preventDefault(),o[i-1]?.focus();return}if(t==="Home"){e.preventDefault(),o[0]?.focus();return}if(t==="End"){e.preventDefault(),o[o.length-1]?.focus();return}const V=n.getAttribute("aria-expanded"),W=V!==null,Z=V==="true";if(t==="ArrowRight")e.preventDefault(),W&&!Z?D(c,!0):o[i+1]?.focus();else if(t==="ArrowLeft")e.preventDefault(),W&&Z?D(c,!1):L&&o.find(s=>d(s)===L)?.focus();else if(e.key==="Enter"||e.key===" "){if(e.preventDefault(),n.hasAttribute("data-disabled"))return;A(c),e.key==="Enter"&&Q(c)}else if(e.key==="*")e.preventDefault(),me(Array.from(r.querySelectorAll(P)).filter(s=>(s.getAttribute("data-skdx-tree-parent-id")||"")===L&&s.getAttribute("aria-expanded")==="false").map(d));else if(te.isTypeaheadKey(e)){const s=we(e.key,o.map(ae),i);if(s===-1)return;e.preventDefault(),o[s]?.focus()}}return oe({el:p,invalidate:ge}),(0,a.provide)(ne.TREE_CONTEXT,{get selectionMode(){return l.selectionMode},get selectionPropagation(){return l.selectionPropagation},expandedIds:N,selectedIds:M,loadingIds:k,activeNodeId:x,setActiveNodeId:ye,get disabledBehavior(){return l.disabledBehavior},get expandOnClick(){return l.expandOnClick},onExpandedChange:D,onSelectedChange:A,onActivate:Q,checkedState:Y,positionOf:xe,registerNode:de,unregisterNode:fe}),(e,t)=>((0,a.openBlock)(),(0,a.createElementBlock)("div",{class:"skdx-tree","data-part":"root","data-skdx-component":"tree",ref_key:"rootRef",ref:p,role:"tree","aria-multiselectable":g.selectionMode==="multiple"?!0:void 0,onKeydown:Ae},[g.collection?((0,a.openBlock)(),(0,a.createBlock)((0,a.unref)(Se.default),{key:0,nodes:g.collection,"render-label":g.renderLabel},null,8,["nodes","render-label"])):(0,a.renderSlot)(e.$slots,"default",{key:1})],40,Me))}});exports.default=Ee;

package/dist/tree/Tree.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{directionalKey as e,useDirection as t}from"../utils/direction.js";import{useRovingTabStop as n}from"../utils/useRovingFocus.js";import{isTypeaheadKey as o,useTypeahead as a}from"../utils/useTypeahead.js";import{announce as r}from"../utils/liveAnnouncer.js";import{TREE_CONTEXT as s,defaultGetLoadedLabel as u}from"./context.js";import{computed as d,createElementBlock as l,defineComponent as i,onMounted as c,onUpdated as f,openBlock as p,provide as v,ref as g,renderSlot as m,watch as h}from"vue";var w=["aria-multiselectable"],y='[role="treeitem"]:not([data-disabled])',x='[role="treeitem"]',A=/* @__PURE__ */i({__name:"Tree",props:{selectionMode:{default:"single"},expandedIds:{default:void 0},defaultExpandedIds:{default:()=>[]},selectedIds:{default:void 0},defaultSelectedIds:{default:()=>[]},selectionPropagation:{default:"none"},loadChildren:{type:Function,default:void 0},getLoadedLabel:{type:Function,default:u}},emits:["update:expandedIds","expanded-ids-change","update:selectedIds","selected-ids-change"],setup(u,{emit:i}){function A(e){return e.getAttribute("data-skdx-tree-node-id")??""}function k(e){const t=e.getAttribute("data-text-value");if(null!==t)return t;let n="";for(const t of e.childNodes){const e=1===t.nodeType?t:null;e&&("group"===e.getAttribute("role")||"true"===e.getAttribute("aria-hidden"))||(n+=t.textContent??"")}return n}const I=u,M=i,S=g(null),b=g(null),D=t(),E=g(I.defaultExpandedIds),T=d(()=>I.expandedIds??E.value),C=d(()=>new Set(T.value)),L=g(I.defaultSelectedIds),K=d(()=>I.selectedIds??L.value),N=d(()=>new Set(K.value)),j=d(()=>"descendants"===I.selectionPropagation),z=/* @__PURE__ */new Set,P=g(/* @__PURE__ */new Set),R=g(/* @__PURE__ */new Map),_=d(()=>{const e=/* @__PURE__ */new Map;for(const[t,n]of R.value){if(null===n)continue;const o=e.get(n);o?o.push(t):e.set(n,[t])}return e});function q(e){const t=[],n=[..._.value.get(e)??[]];for(;n.length>0;){const e=n.pop();t.push(e),n.push(..._.value.get(e)??[])}return t}function F(e){if(!j.value)return!1;const t=q(e);if(0===t.length)return N.value.has(e);const n=t.filter(e=>N.value.has(e)).length;return 0!==n&&(n===t.length||"mixed")}function H(e){void 0===I.expandedIds&&(E.value=e),M("update:expandedIds",e),M("expanded-ids-change",e)}function O(e){void 0===I.selectedIds&&(L.value=e),M("update:selectedIds",e),M("selected-ids-change",e)}function U(e){const t=I.loadChildren;if(!t||z.has(e))return;z.add(e),P.value=new Set(P.value).add(e);const n=()=>{const t=new Set(P.value);t.delete(e),P.value=t};Promise.resolve(t(e)).then(()=>{n(),r(I.getLoadedLabel(e))},()=>{z.delete(e),n()})}function B(e,t){H(t?[...T.value,e]:T.value.filter(t=>t!==e)),t&&U(e)}function G(e){if("none"===I.selectionMode)return;const t=K.value;if("multiple"===I.selectionMode&&j.value){const n=!0!==F(e),o=new Set(t);for(const t of[e,...q(e)])n?o.add(t):o.delete(t);return void O([...o])}O("single"===I.selectionMode?[e]:t.includes(e)?t.filter(t=>t!==e):[...t,e])}function X(e){"multiple"===I.selectionMode&&O([.../* @__PURE__ */new Set([...K.value,...e])])}const $=g(/* @__PURE__ */new Map);function J(){if(!S.value)return;const e=function(e){const t=/* @__PURE__ */new Map;for(const n of e.querySelectorAll(x)){const e=A(n);if(!e)continue;const o=n.getAttribute("data-skdx-tree-parent-id")??"",a=t.get(o);a?a.push(e):t.set(o,[e])}const n=/* @__PURE__ */new Map;for(const e of t.values())e.forEach((t,o)=>{n.set(t,{posinset:o+1,setsize:e.length})});return n}(S.value);(function(e,t){if(e.size!==t.size)return!1;for(const[n,o]of e){const e=t.get(n);if(!e||e.posinset!==o.posinset||e.setsize!==o.setsize)return!1}return!0})($.value,e)||($.value=e)}c(J),f(J),h([T,R],J,{flush:"post"}),h(T,n(S,y,"data-skdx-tree-node-id",b),{flush:"post"});const Q=a();function V(t){const n=e(t.key,t.currentTarget,D()),a=S.value,r=t.target;if(!a||!r.matches('[role="treeitem"]'))return;const s=Array.from(a.querySelectorAll(y)),u=s.indexOf(r),d=A(r),l=r.getAttribute("data-skdx-tree-parent-id")||"",i="multiple"===I.selectionMode;if(i&&t.shiftKey&&("ArrowDown"===n||"ArrowUp"===n)){t.preventDefault();const e=s[u+("ArrowDown"===n?1:-1)];return void(e&&(e.focus(),G(A(e))))}if(i&&t.shiftKey&&("Home"===t.key||"End"===t.key)){t.preventDefault();const e="Home"===t.key?0:s.length-1;return X(s.slice(Math.min(u,e),Math.max(u,e)+1).map(A)),void s[e]?.focus()}if(i&&(t.ctrlKey||t.metaKey)&&"a"===t.key.toLowerCase())return t.preventDefault(),void X(s.map(A));if("ArrowDown"===n)return t.preventDefault(),void s[u+1]?.focus();if("ArrowUp"===n)return t.preventDefault(),void s[u-1]?.focus();if("Home"===n)return t.preventDefault(),void s[0]?.focus();if("End"===n)return t.preventDefault(),void s[s.length-1]?.focus();const c=r.getAttribute("aria-expanded"),f=null!==c,p="true"===c;if("ArrowRight"===n)t.preventDefault(),f&&!p?B(d,!0):s[u+1]?.focus();else if("ArrowLeft"===n)t.preventDefault(),f&&p?B(d,!1):l&&s.find(e=>A(e)===l)?.focus();else if("Enter"===t.key||" "===t.key)t.preventDefault(),G(d);else if("*"===t.key)t.preventDefault(),function(e){if(0!==e.length){H([.../* @__PURE__ */new Set([...T.value,...e])]);for(const t of e)U(t)}}(Array.from(a.querySelectorAll(x)).filter(e=>(e.getAttribute("data-skdx-tree-parent-id")||"")===l&&"false"===e.getAttribute("aria-expanded")).map(A));else if(o(t)){const e=Q(t.key,s.map(k),u);if(-1===e)return;t.preventDefault(),s[e]?.focus()}}return v(s,{get selectionMode(){return I.selectionMode},get selectionPropagation(){return I.selectionPropagation},expandedIds:C,selectedIds:N,loadingIds:P,activeNodeId:b,setActiveNodeId:function(e){b.value=e},onExpandedChange:B,onSelectedChange:G,checkedState:F,positionOf:function(e){return $.value.get(e)},registerNode:function(e,t){R.value.get(e)!==t&&(R.value=new Map(R.value).set(e,t))},unregisterNode:function(e){if(!R.value.has(e))return;const t=new Map(R.value);t.delete(e),R.value=t}}),(e,t)=>(p(),l("div",{class:"skdx-tree","data-part":"root","data-skdx-component":"tree",ref_key:"rootRef",ref:S,role:"tree","aria-multiselectable":"multiple"===u.selectionMode||void 0,onKeydown:V},[m(e.$slots,"default")],40,w))}});export{A as default};
+import{directionalKey as e,useDirection as t}from"../utils/direction.js";import{isTypeaheadKey as n,useTypeahead as a}from"../utils/useTypeahead.js";import{announce as o}from"../utils/liveAnnouncer.js";import{TREE_CONTEXT as l,defaultGetLoadedLabel as d}from"./context.js";import r from"./nodes.js";import{computed as u,createBlock as i,createElementBlock as s,defineComponent as c,onMounted as f,onUpdated as v,openBlock as p,provide as h,ref as g,renderSlot as m,unref as k,watch as y}from"vue";var w=["aria-multiselectable"],x='[role="treeitem"]',I=/* @__PURE__ */c({__name:"Tree",props:{selectionMode:{default:"single"},collection:{default:void 0},renderLabel:{type:Function,default:void 0},expandedIds:{default:void 0},defaultExpandedIds:{default:()=>[]},selectedIds:{default:void 0},defaultSelectedIds:{default:()=>[]},checkedIds:{default:void 0},defaultCheckedIds:{default:void 0},selectionPropagation:{default:"none"},loadChildren:{type:Function,default:void 0},getLoadedLabel:{type:Function,default:d},disabledBehavior:{default:"all"},expandOnClick:{type:Boolean,default:!0}},emits:["update:expandedIds","expanded-ids-change","update:selectedIds","selected-ids-change","update:checkedIds","checked-ids-change","activate","load-error"],setup(d,{expose:c,emit:I}){function A(e){return e.getAttribute("data-skdx-tree-node-id")??""}function b(e){const t=e.getAttribute("data-text-value");if(null!==t)return t;let n="";for(const t of e.childNodes){const e=1===t.nodeType?t:null;e&&("group"===e.getAttribute("role")||"true"===e.getAttribute("aria-hidden"))||(n+=t.textContent??"")}return n}const M=d,S=I,D=g(null),C=g(null),E=t(),L=u(()=>"selection"===M.disabledBehavior?x:'[role="treeitem"]:not([data-disabled])'),T=g(M.defaultExpandedIds),B=u(()=>M.expandedIds??T.value),K=u(()=>new Set(B.value)),O=g(M.defaultSelectedIds),N=u(()=>M.selectedIds??O.value),j=u(()=>new Set(N.value)),z=u(()=>void 0!==M.checkedIds||void 0!==M.defaultCheckedIds),P=g(M.defaultCheckedIds??[]),q=u(()=>M.checkedIds??P.value),_=u(()=>new Set(q.value)),F=u(()=>z.value?q.value:N.value),H=u(()=>z.value?_.value:j.value),R=u(()=>"descendants"===M.selectionPropagation),U=/* @__PURE__ */new Set,G=g(/* @__PURE__ */new Set),X=g(/* @__PURE__ */new Map),$=u(()=>{const e=/* @__PURE__ */new Map;for(const[t,n]of X.value){if(null===n)continue;const a=e.get(n);a?a.push(t):e.set(n,[t])}return e}),J=/* @__PURE__ */new Map,Q=u(()=>{for(const e of X.value.keys())K.value.has(e)&&J.set(e,[...$.value.get(e)??[]]);return J});function V(e){return $.value.get(e)??Q.value.get(e)??[]}function W(e){const t=[],n=/* @__PURE__ */new Set([e]),a=[...V(e)];for(;a.length>0;){const e=a.pop();n.has(e)||(n.add(e),t.push(e),a.push(...V(e)))}return t}function Y(e){if(!R.value)return!1;const t=H.value,n=W(e);if(0===n.length)return t.has(e);const a=n.filter(e=>t.has(e)).length;return 0!==a&&(a===n.length||"mixed")}function Z(e){void 0===M.expandedIds&&(T.value=e),S("update:expandedIds",e),S("expanded-ids-change",e)}function ee(e){z.value?function(e){void 0===M.checkedIds&&(P.value=e),S("update:checkedIds",e),S("checked-ids-change",e)}(e):function(e){void 0===M.selectedIds&&(O.value=e),S("update:selectedIds",e),S("selected-ids-change",e)}(e)}function te(e){const t=M.loadChildren;if(!t||U.has(e))return;U.add(e),G.value=new Set(G.value).add(e);const n=()=>{const t=new Set(G.value);t.delete(e),G.value=t};Promise.resolve(t(e)).then(()=>{n(),o(M.getLoadedLabel(e))},t=>{U.delete(e),n(),S("load-error",{nodeId:e,error:t})})}function ne(e,t){Z(t?[...B.value,e]:B.value.filter(t=>t!==e)),t&&te(e)}let ae=null;function oe(e){if("none"===M.selectionMode)return;ae=e;const t=F.value;if("multiple"===M.selectionMode&&R.value){const n=!0!==Y(e),a=new Set(t);for(const t of[e,...W(e)])n?a.add(t):a.delete(t);return void ee([...a])}ee("single"===M.selectionMode?[e]:t.includes(e)?t.filter(t=>t!==e):[...t,e])}function le(e){if("multiple"!==M.selectionMode)return;const t=e[e.length-1];void 0!==t&&(ae=t),ee([.../* @__PURE__ */new Set([...F.value,...e])])}function de(e){S("activate",e)}const re=g(/* @__PURE__ */new Map);function ue(){if(!D.value)return;const e=function(e){const t=/* @__PURE__ */new Map;for(const n of e.querySelectorAll(x)){const e=A(n);if(!e)continue;const a=n.getAttribute("data-skdx-tree-parent-id")??"",o=t.get(a);o?o.push(e):t.set(a,[e])}const n=/* @__PURE__ */new Map;for(const e of t.values())e.forEach((t,a)=>{n.set(t,{posinset:a+1,setsize:e.length})});return n}(D.value);(function(e,t){if(e.size!==t.size)return!1;for(const[n,a]of e){const e=t.get(n);if(!e||e.posinset!==a.posinset||e.setsize!==a.setsize)return!1}return!0})(re.value,e)||(re.value=e)}function ie(){const e=D.value;if(!e)return;const t=Array.from(e.querySelectorAll(L.value),e=>e.getAttribute("data-skdx-tree-node-id")).filter(e=>null!==e&&""!==e);if(0===t.length)return;const n=C.value;null!==n&&t.includes(n)||(C.value=t.find(e=>j.value.has(e))??t[0])}f(ue),v(ue),y([B,X],ue,{flush:"post"}),f(ie),v(ie),y([B,N,X],ie,{flush:"post"});const se=a();function ce(t){const a=e(t.key,t.currentTarget,E()),o=D.value,l=t.target;if(!o||!l.matches('[role="treeitem"]'))return;const d=Array.from(o.querySelectorAll(L.value)),r=d.indexOf(l),u=A(l),i=l.getAttribute("data-skdx-tree-parent-id")||"",s="multiple"===M.selectionMode;if(s&&t.shiftKey&&("ArrowDown"===a||"ArrowUp"===a)){t.preventDefault();const e=d[r+("ArrowDown"===a?1:-1)];return void(e&&(e.focus(),oe(A(e))))}if(s&&t.shiftKey&&" "===t.key){t.preventDefault();const e=d.map(A),n=null===ae?-1:e.indexOf(ae),a=e.indexOf(u);return void(-1===n||-1===a?oe(u):le(e.slice(Math.min(n,a),Math.max(n,a)+1)))}if(s&&t.shiftKey&&("Home"===t.key||"End"===t.key)){t.preventDefault();const e="Home"===t.key?0:d.length-1;return le(d.slice(Math.min(r,e),Math.max(r,e)+1).map(A)),void d[e]?.focus()}if(s&&(t.ctrlKey||t.metaKey)&&"a"===t.key.toLowerCase())return t.preventDefault(),void function(e){if("multiple"!==M.selectionMode||0===e.length)return;const t=new Set(F.value);e.every(e=>t.has(e))?ee(F.value.filter(t=>!e.includes(t))):ee([.../* @__PURE__ */new Set([...F.value,...e])])}(d.map(A));if("ArrowDown"===a)return t.preventDefault(),void d[r+1]?.focus();if("ArrowUp"===a)return t.preventDefault(),void d[r-1]?.focus();if("Home"===a)return t.preventDefault(),void d[0]?.focus();if("End"===a)return t.preventDefault(),void d[d.length-1]?.focus();const c=l.getAttribute("aria-expanded"),f=null!==c,v="true"===c;if("ArrowRight"===a)t.preventDefault(),f&&!v?ne(u,!0):d[r+1]?.focus();else if("ArrowLeft"===a)t.preventDefault(),f&&v?ne(u,!1):i&&d.find(e=>A(e)===i)?.focus();else if("Enter"===t.key||" "===t.key){if(t.preventDefault(),l.hasAttribute("data-disabled"))return;oe(u),"Enter"===t.key&&de(u)}else if("*"===t.key)t.preventDefault(),function(e){if(0!==e.length){Z([.../* @__PURE__ */new Set([...B.value,...e])]);for(const t of e)te(t)}}(Array.from(o.querySelectorAll(x)).filter(e=>(e.getAttribute("data-skdx-tree-parent-id")||"")===i&&"false"===e.getAttribute("aria-expanded")).map(A));else if(n(t)){const e=se(t.key,d.map(b),r);if(-1===e)return;t.preventDefault(),d[e]?.focus()}}return c({el:D,invalidate:function(e){if(void 0!==e){U.delete(e);for(const t of W(e))U.delete(t)}else U.clear()}}),h(l,{get selectionMode(){return M.selectionMode},get selectionPropagation(){return M.selectionPropagation},expandedIds:K,selectedIds:j,loadingIds:G,activeNodeId:C,setActiveNodeId:function(e){C.value=e},get disabledBehavior(){return M.disabledBehavior},get expandOnClick(){return M.expandOnClick},onExpandedChange:ne,onSelectedChange:oe,onActivate:de,checkedState:Y,positionOf:function(e){return re.value.get(e)},registerNode:function(e,t){X.value.get(e)!==t&&(X.value=new Map(X.value).set(e,t))},unregisterNode:function(e){if(!X.value.has(e))return;const t=new Map(X.value);t.delete(e),X.value=t}}),(e,t)=>(p(),s("div",{class:"skdx-tree","data-part":"root","data-skdx-component":"tree",ref_key:"rootRef",ref:D,role:"tree","aria-multiselectable":"multiple"===d.selectionMode||void 0,onKeydown:ce},[d.collection?(p(),i(k(r),{key:0,nodes:d.collection,"render-label":d.renderLabel},null,8,["nodes","render-label"])):m(e.$slots,"default",{key:1})],40,w))}});export{I as default};

package/dist/tree/TreeGroup.vue.d.cts

@@ -1,9 +1,7 @@
 /**
- * Collapsible container for a `SkdxTreeItem`'s child `SkdxTreeItem`s: renders
- * a `<div role="group">`, unmounted (unless `forceMount`) while the parent
- * item is collapsed. Increments depth (`aria-level`) and sets itself as the
- * parent node for the nested items via context. Must be used inside an
- * `SkdxTreeItem`.
+ * Container for nested `SkdxTreeItem`s: unmounted while parent collapsed (unless
+ * `forceMount`). Increments depth (`aria-level`) and sets as parent node via context.
+ * Must be used in `SkdxTreeItem`.
  */
 type __VLS_Props = {
     /** Keep this group mounted even while its parent item is collapsed, instead of unmounting it. */

package/dist/tree/TreeGroup.vue.d.ts

@@ -1,9 +1,7 @@
 /**
- * Collapsible container for a `SkdxTreeItem`'s child `SkdxTreeItem`s: renders
- * a `<div role="group">`, unmounted (unless `forceMount`) while the parent
- * item is collapsed. Increments depth (`aria-level`) and sets itself as the
- * parent node for the nested items via context. Must be used inside an
- * `SkdxTreeItem`.
+ * Container for nested `SkdxTreeItem`s: unmounted while parent collapsed (unless
+ * `forceMount`). Increments depth (`aria-level`) and sets as parent node via context.
+ * Must be used in `SkdxTreeItem`.
  */
 type __VLS_Props = {
     /** Keep this group mounted even while its parent item is collapsed, instead of unmounting it. */

package/dist/tree/TreeItem.vue.d.cts

@@ -1,25 +1,26 @@
 /**
- * A single node in the tree: renders a `<div role="treeitem">` with
- * `aria-level` (its depth), `aria-posinset`/`aria-setsize` (its place among
- * the siblings at its own level), `aria-selected` (unless the tree's
- * selectionMode is "none"), `aria-expanded` (only if it has a nested
- * `SkdxTreeGroup`), `data-state` of `"expanded"`/`"collapsed"`, and
- * `data-disabled`. Detects whether it has children by checking its default
- * slot for an `SkdxTreeGroup`. Clicking it selects the node and, if it has
- * children, toggles expansion; focusing it makes it the tree's active
- * (tabbable) node. Must be used inside `SkdxTree`.
- *
- * While the tree's `load-children` is pending for this node it carries
- * `aria-busy="true"` and `data-loading`. Under
- * `selection-propagation="descendants"` it also carries `aria-checked`
- * (`true`/`false`/`"mixed"`) and `data-checked`
- * (`checked`/`unchecked`/`indeterminate`) derived from its descendants.
+ * Tree node: role="treeitem" with aria-level, aria-posinset / aria-setsize,
+ * aria-selected (or aria-checked under descendants mode), aria-expanded (if has
+ * children), data-state (expanded / collapsed), data-disabled. Click selects
+ * and toggles expansion; focus makes it active. Lazy branches declare
+ * has-children=true before loading.
  */
 type __VLS_Props = {
-    /** Unique identifier tracked in the tree's expanded/selected/active state. */
+    /** Node identity (tracked in tree state). */
     nodeId: string;
-    /** Excludes this node (and its subtree) from selection and keyboard activation. */
+    /**
+     * Excludes node from selection / activation (not inherited; subtree navigable).
+     */
     disabled?: boolean;
+    /**
+     * Typeahead text (instead of rendered label).
+     */
+    textValue?: string;
+    /**
+     * Declare as branch (overrides nested-group scan). True for lazy loading
+     * (aria-expanded, ArrowRight accept without group mounted).
+     */
+    hasChildren?: boolean;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -27,6 +28,8 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     disabled: boolean;
+    textValue: string;
+    hasChildren: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/tree/TreeItem.vue.d.ts

@@ -1,25 +1,26 @@
 /**
- * A single node in the tree: renders a `<div role="treeitem">` with
- * `aria-level` (its depth), `aria-posinset`/`aria-setsize` (its place among
- * the siblings at its own level), `aria-selected` (unless the tree's
- * selectionMode is "none"), `aria-expanded` (only if it has a nested
- * `SkdxTreeGroup`), `data-state` of `"expanded"`/`"collapsed"`, and
- * `data-disabled`. Detects whether it has children by checking its default
- * slot for an `SkdxTreeGroup`. Clicking it selects the node and, if it has
- * children, toggles expansion; focusing it makes it the tree's active
- * (tabbable) node. Must be used inside `SkdxTree`.
- *
- * While the tree's `load-children` is pending for this node it carries
- * `aria-busy="true"` and `data-loading`. Under
- * `selection-propagation="descendants"` it also carries `aria-checked`
- * (`true`/`false`/`"mixed"`) and `data-checked`
- * (`checked`/`unchecked`/`indeterminate`) derived from its descendants.
+ * Tree node: role="treeitem" with aria-level, aria-posinset / aria-setsize,
+ * aria-selected (or aria-checked under descendants mode), aria-expanded (if has
+ * children), data-state (expanded / collapsed), data-disabled. Click selects
+ * and toggles expansion; focus makes it active. Lazy branches declare
+ * has-children=true before loading.
  */
 type __VLS_Props = {
-    /** Unique identifier tracked in the tree's expanded/selected/active state. */
+    /** Node identity (tracked in tree state). */
     nodeId: string;
-    /** Excludes this node (and its subtree) from selection and keyboard activation. */
+    /**
+     * Excludes node from selection / activation (not inherited; subtree navigable).
+     */
     disabled?: boolean;
+    /**
+     * Typeahead text (instead of rendered label).
+     */
+    textValue?: string;
+    /**
+     * Declare as branch (overrides nested-group scan). True for lazy loading
+     * (aria-expanded, ArrowRight accept without group mounted).
+     */
+    hasChildren?: boolean;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -27,6 +28,8 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     disabled: boolean;
+    textValue: string;
+    hasChildren: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/tree/TreeItem.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const l=require("./context.cjs"),T=require("./TreeGroup.vue.cjs");let e=require("vue");var b=["aria-level","aria-posinset","aria-setsize","aria-selected","aria-expanded","aria-checked","aria-busy","aria-disabled","data-state","data-checked","data-loading","data-disabled","data-skdx-tree-node-id","data-skdx-tree-parent-id","tabindex"],x=(0,e.defineComponent)({__name:"TreeItem",props:{nodeId:{},disabled:{type:Boolean,default:!1}},setup(n){const d=n,a=(0,e.inject)(l.TREE_CONTEXT);if(!a)throw new Error("SkdxTreeItem must be used within SkdxTree.");const o=(0,e.inject)(l.TREE_AMBIENT_CONTEXT,l.TREE_AMBIENT_DEFAULT),p=(0,e.useSlots)(),i=(0,e.computed)(()=>(p.default?.()??[]).some(t=>t.type===T.default)),r=(0,e.computed)(()=>a.expandedIds.value.has(d.nodeId)),c=(0,e.computed)(()=>a.selectedIds.value.has(d.nodeId)),u=(0,e.computed)(()=>a.loadingIds.value.has(d.nodeId)),I=(0,e.computed)(()=>d.disabled?-1:a.activeNodeId.value===d.nodeId?0:-1);(0,e.onMounted)(()=>a.registerNode(d.nodeId,o.parentId)),(0,e.onUnmounted)(()=>a.unregisterNode(d.nodeId));const v=(0,e.computed)(()=>a.positionOf(d.nodeId)),s=(0,e.computed)(()=>a.selectionPropagation==="descendants"?a.checkedState(d.nodeId):void 0),h=(0,e.computed)(()=>s.value),m=(0,e.computed)(()=>s.value===void 0?void 0:s.value==="mixed"?"indeterminate":s.value?"checked":"unchecked");function k(t){d.disabled||t.target.closest('[role="treeitem"]')!==t.currentTarget||(a.onSelectedChange(d.nodeId),i.value&&a.onExpandedChange(d.nodeId,!r.value))}function g(){d.disabled||a.setActiveNodeId(d.nodeId)}return(0,e.provide)(l.TREE_ITEM_CONTEXT,{get nodeId(){return d.nodeId},get depth(){return o.depth},get expanded(){return r.value},get selected(){return c.value},get disabled(){return d.disabled},get hasChildren(){return i.value},get loading(){return u.value}}),(t,f)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-tree__item","data-part":"item",role:"treeitem","aria-level":(0,e.unref)(o).depth,"aria-posinset":v.value?.posinset,"aria-setsize":v.value?.setsize,"aria-selected":(0,e.unref)(a).selectionMode==="none"?void 0:c.value,"aria-expanded":i.value?r.value:void 0,"aria-checked":h.value,"aria-busy":u.value||void 0,"aria-disabled":n.disabled||void 0,"data-state":i.value?r.value?"expanded":"collapsed":void 0,"data-checked":m.value,"data-loading":u.value?"":void 0,"data-disabled":n.disabled?"":void 0,"data-skdx-tree-node-id":n.nodeId,"data-skdx-tree-parent-id":(0,e.unref)(o).parentId??void 0,tabindex:I.value,onClick:k,onFocus:g},[(0,e.renderSlot)(t.$slots,"default")],40,b))}});exports.default=x;
+const s=require("./context.cjs"),g=require("./TreeGroup.vue.cjs");let e=require("vue");var T=["aria-level","aria-posinset","aria-setsize","aria-selected","aria-expanded","aria-checked","aria-busy","aria-disabled","data-state","data-checked","data-loading","data-disabled","data-text-value","data-skdx-tree-node-id","data-skdx-tree-parent-id","tabindex"],b=(0,e.defineComponent)({__name:"TreeItem",props:{nodeId:{},disabled:{type:Boolean,default:!1},textValue:{default:void 0},hasChildren:{type:Boolean,default:void 0}},setup(n){const d=n,a=(0,e.inject)(s.TREE_CONTEXT);if(!a)throw new Error("SkdxTreeItem must be used within SkdxTree.");const o=(0,e.inject)(s.TREE_AMBIENT_CONTEXT,s.TREE_AMBIENT_DEFAULT),h=(0,e.useSlots)(),l=(0,e.computed)(()=>d.hasChildren??(h.default?.()??[]).some(t=>t.type===g.default)),r=(0,e.computed)(()=>a.expandedIds.value.has(d.nodeId)),c=(0,e.computed)(()=>a.selectedIds.value.has(d.nodeId)),u=(0,e.computed)(()=>a.loadingIds.value.has(d.nodeId)),v=(0,e.computed)(()=>d.disabled&&a.disabledBehavior==="all"),I=(0,e.computed)(()=>v.value?-1:a.activeNodeId.value===d.nodeId?0:-1);(0,e.onMounted)(()=>a.registerNode(d.nodeId,o.parentId)),(0,e.onUnmounted)(()=>a.unregisterNode(d.nodeId));const p=(0,e.computed)(()=>a.positionOf(d.nodeId)),i=(0,e.computed)(()=>a.selectionPropagation==="descendants"?a.checkedState(d.nodeId):void 0),m=(0,e.computed)(()=>i.value),x=(0,e.computed)(()=>i.value===void 0?void 0:i.value==="mixed"?"indeterminate":i.value?"checked":"unchecked");function k(t){d.disabled||t.target.closest('[role="treeitem"]')!==t.currentTarget||(a.onSelectedChange(d.nodeId),a.onActivate(d.nodeId),l.value&&a.expandOnClick&&a.onExpandedChange(d.nodeId,!r.value))}function f(){v.value||a.setActiveNodeId(d.nodeId)}return(0,e.provide)(s.TREE_ITEM_CONTEXT,{get nodeId(){return d.nodeId},get depth(){return o.depth},get expanded(){return r.value},get selected(){return c.value},get disabled(){return d.disabled},get hasChildren(){return l.value},get loading(){return u.value}}),(t,E)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-tree__item","data-part":"item",role:"treeitem","aria-level":(0,e.unref)(o).depth,"aria-posinset":p.value?.posinset,"aria-setsize":p.value?.setsize,"aria-selected":(0,e.unref)(a).selectionMode==="none"||i.value!==void 0?void 0:c.value,"aria-expanded":l.value?r.value:void 0,"aria-checked":m.value,"aria-busy":u.value||void 0,"aria-disabled":n.disabled||void 0,"data-state":l.value?r.value?"expanded":"collapsed":void 0,"data-checked":x.value,"data-loading":u.value?"":void 0,"data-disabled":n.disabled?"":void 0,"data-text-value":n.textValue,"data-skdx-tree-node-id":n.nodeId,"data-skdx-tree-parent-id":(0,e.unref)(o).parentId??void 0,tabindex:I.value,style:(0,e.normalizeStyle)({"--skdx-tree-node-depth":(0,e.unref)(o).depth}),onClick:k,onFocus:f},[(0,e.renderSlot)(t.$slots,"default")],44,T))}});exports.default=b;

package/dist/tree/TreeItem.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TREE_AMBIENT_CONTEXT as e,TREE_AMBIENT_DEFAULT as a,TREE_CONTEXT as d,TREE_ITEM_CONTEXT as t}from"./context.js";import o from"./TreeGroup.vue.js";import{computed as n,createElementBlock as s,defineComponent as i,inject as r,onMounted as l,onUnmounted as u,openBlock as v,provide as c,renderSlot as p,unref as I,useSlots as m}from"vue";var h=["aria-level","aria-posinset","aria-setsize","aria-selected","aria-expanded","aria-checked","aria-busy","aria-disabled","data-state","data-checked","data-loading","data-disabled","data-skdx-tree-node-id","data-skdx-tree-parent-id","tabindex"],T=/* @__PURE__ */i({__name:"TreeItem",props:{nodeId:{},disabled:{type:Boolean,default:!1}},setup(i){const T=i,g=r(d);if(!g)throw new Error("SkdxTreeItem must be used within SkdxTree.");const x=r(e,a),E=m(),b=n(()=>(E.default?.()??[]).some(e=>e.type===o)),k=n(()=>g.expandedIds.value.has(T.nodeId)),f=n(()=>g.selectedIds.value.has(T.nodeId)),_=n(()=>g.loadingIds.value.has(T.nodeId)),N=n(()=>T.disabled?-1:g.activeNodeId.value===T.nodeId?0:-1);l(()=>g.registerNode(T.nodeId,x.parentId)),u(()=>g.unregisterNode(T.nodeId));const C=n(()=>g.positionOf(T.nodeId)),S=n(()=>"descendants"===g.selectionPropagation?g.checkedState(T.nodeId):void 0),B=n(()=>S.value),M=n(()=>void 0===S.value?void 0:"mixed"===S.value?"indeterminate":S.value?"checked":"unchecked");function y(e){T.disabled||e.target.closest('[role="treeitem"]')!==e.currentTarget||(g.onSelectedChange(T.nodeId),b.value&&g.onExpandedChange(T.nodeId,!k.value))}function A(){T.disabled||g.setActiveNodeId(T.nodeId)}return c(t,{get nodeId(){return T.nodeId},get depth(){return x.depth},get expanded(){return k.value},get selected(){return f.value},get disabled(){return T.disabled},get hasChildren(){return b.value},get loading(){return _.value}}),(e,a)=>(v(),s("div",{class:"skdx-tree__item","data-part":"item",role:"treeitem","aria-level":I(x).depth,"aria-posinset":C.value?.posinset,"aria-setsize":C.value?.setsize,"aria-selected":"none"===I(g).selectionMode?void 0:f.value,"aria-expanded":b.value?k.value:void 0,"aria-checked":B.value,"aria-busy":_.value||void 0,"aria-disabled":i.disabled||void 0,"data-state":b.value?k.value?"expanded":"collapsed":void 0,"data-checked":M.value,"data-loading":_.value?"":void 0,"data-disabled":i.disabled?"":void 0,"data-skdx-tree-node-id":i.nodeId,"data-skdx-tree-parent-id":I(x).parentId??void 0,tabindex:N.value,onClick:y,onFocus:A},[p(e.$slots,"default")],40,h))}});export{T as default};
+import{TREE_AMBIENT_CONTEXT as e,TREE_AMBIENT_DEFAULT as a,TREE_CONTEXT as d,TREE_ITEM_CONTEXT as t}from"./context.js";import o from"./TreeGroup.vue.js";import{computed as n,createElementBlock as i,defineComponent as s,inject as l,normalizeStyle as r,onMounted as u,onUnmounted as v,openBlock as c,provide as p,renderSlot as I,unref as h,useSlots as x}from"vue";var m=["aria-level","aria-posinset","aria-setsize","aria-selected","aria-expanded","aria-checked","aria-busy","aria-disabled","data-state","data-checked","data-loading","data-disabled","data-text-value","data-skdx-tree-node-id","data-skdx-tree-parent-id","tabindex"],k=/* @__PURE__ */s({__name:"TreeItem",props:{nodeId:{},disabled:{type:Boolean,default:!1},textValue:{default:void 0},hasChildren:{type:Boolean,default:void 0}},setup(s){const k=s,T=l(d);if(!T)throw new Error("SkdxTreeItem must be used within SkdxTree.");const g=l(e,a),E=x(),b=n(()=>k.hasChildren??(E.default?.()??[]).some(e=>e.type===o)),f=n(()=>T.expandedIds.value.has(k.nodeId)),C=n(()=>T.selectedIds.value.has(k.nodeId)),_=n(()=>T.loadingIds.value.has(k.nodeId)),N=n(()=>k.disabled&&"all"===T.disabledBehavior),y=n(()=>N.value?-1:T.activeNodeId.value===k.nodeId?0:-1);u(()=>T.registerNode(k.nodeId,g.parentId)),v(()=>T.unregisterNode(k.nodeId));const B=n(()=>T.positionOf(k.nodeId)),S=n(()=>"descendants"===T.selectionPropagation?T.checkedState(k.nodeId):void 0),A=n(()=>S.value),M=n(()=>void 0===S.value?void 0:"mixed"===S.value?"indeterminate":S.value?"checked":"unchecked");function O(e){k.disabled||e.target.closest('[role="treeitem"]')!==e.currentTarget||(T.onSelectedChange(k.nodeId),T.onActivate(k.nodeId),b.value&&T.expandOnClick&&T.onExpandedChange(k.nodeId,!f.value))}function z(){N.value||T.setActiveNodeId(k.nodeId)}return p(t,{get nodeId(){return k.nodeId},get depth(){return g.depth},get expanded(){return f.value},get selected(){return C.value},get disabled(){return k.disabled},get hasChildren(){return b.value},get loading(){return _.value}}),(e,a)=>(c(),i("div",{class:"skdx-tree__item","data-part":"item",role:"treeitem","aria-level":h(g).depth,"aria-posinset":B.value?.posinset,"aria-setsize":B.value?.setsize,"aria-selected":"none"===h(T).selectionMode||void 0!==S.value?void 0:C.value,"aria-expanded":b.value?f.value:void 0,"aria-checked":A.value,"aria-busy":_.value||void 0,"aria-disabled":s.disabled||void 0,"data-state":b.value?f.value?"expanded":"collapsed":void 0,"data-checked":M.value,"data-loading":_.value?"":void 0,"data-disabled":s.disabled?"":void 0,"data-text-value":s.textValue,"data-skdx-tree-node-id":s.nodeId,"data-skdx-tree-parent-id":h(g).parentId??void 0,tabindex:y.value,style:r({"--skdx-tree-node-depth":h(g).depth}),onClick:O,onFocus:z},[I(e.$slots,"default")],44,m))}});export{k as default};

package/dist/tree/TreeItemIndicator.vue.d.cts

@@ -1,10 +1,6 @@
 /**
- * Expand/collapse affordance (e.g. a chevron) within a `SkdxTreeItem`:
- * renders a `<span aria-hidden="true">` with `data-state` of
- * `"expanded"`/`"collapsed"` (unset if the item has no children). Clicking
- * it toggles expansion and stops propagation, so the enclosing
- * `SkdxTreeItem`'s own click handler doesn't double-toggle it. Must be used
- * inside an `SkdxTreeItem`.
+ * Toggle expand/collapse in `SkdxTreeItem`, stops propagation to prevent double-toggle.
+ * `data-state` (`expanded`/`collapsed`, unset if no children). Must be used in `SkdxTreeItem`.
  */
 type __VLS_Props = {};
 declare var __VLS_1: {};

package/dist/tree/TreeItemIndicator.vue.d.ts

@@ -1,10 +1,6 @@
 /**
- * Expand/collapse affordance (e.g. a chevron) within a `SkdxTreeItem`:
- * renders a `<span aria-hidden="true">` with `data-state` of
- * `"expanded"`/`"collapsed"` (unset if the item has no children). Clicking
- * it toggles expansion and stops propagation, so the enclosing
- * `SkdxTreeItem`'s own click handler doesn't double-toggle it. Must be used
- * inside an `SkdxTreeItem`.
+ * Toggle expand/collapse in `SkdxTreeItem`, stops propagation to prevent double-toggle.
+ * `data-state` (`expanded`/`collapsed`, unset if no children). Must be used in `SkdxTreeItem`.
  */
 type __VLS_Props = {};
 declare var __VLS_1: {};