@skdx/vue 0.26.0 → 0.28.0

package/dist/transfer/context.d.ts

@@ -1,17 +1,7 @@
 import type { ComputedRef, InjectionKey } from 'vue';
-/**
- * Which of the two lists a part belongs to. `'source'` is the pool an item
- * starts in; `'target'` is the result — the array `SkdxTransfer`'s `value` holds.
- *
- * Named by role rather than by position: under `dir="rtl"` the target list is
- * on the left, so a `'left'`/`'right'` API would be wrong for half the world.
- */
+/** List side by role: source (start pool) or target (result). Named for RTL safety. */
 export type TransferSide = 'source' | 'target';
-/**
- * A move, named by where it lands rather than by which arrow it looks like.
- * `'toTarget'` adds to the value, `'toSource'` removes from it — true in both
- * writing directions, which `'right'`/`'left'` would not be.
- */
+/** Move direction by destination: toTarget (adds) or toSource (removes). Named for RTL safety. */
 export type TransferDirection = 'toTarget' | 'toSource';
 /** One entry in an `SkdxTransfer`'s collection. */
 export interface TransferItemData {
@@ -32,21 +22,9 @@ export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
 export declare const ORIGIN_OF: Record<TransferDirection, TransferSide>;
 /** @internal Where a direction takes items *to*. */
 export declare const DESTINATION_OF: Record<TransferDirection, TransferSide>;
-/**
- * @internal The word each side is called in default accessible names and in
- * the move announcement. Deliberately the *same* word in both, so "Move 3
- * items to selected" and "3 items moved to selected" name the same list.
- */
+/** @internal Side noun for accessible names and announcements. */
 export declare const SIDE_NOUN: Record<TransferSide, string>;
-/**
- * The accessible name of a move trigger: direction *and* count, because "→" is
- * unambiguous next to two labelled lists and meaningless read out on its own.
- *
- * With nothing to move the name says so rather than going silent — the trigger
- * stays focusable (`aria-disabled`, not `disabled`), so it is still the thing
- * that teaches a keyboard user the interaction, and it has to explain why
- * pressing it does nothing.
- *
+/** Accessible name of move trigger: direction and count. Explains when nothing to move.
  * @internal
  */
 export declare function moveTriggerLabel(count: number, direction: TransferDirection, all: boolean): string;
@@ -63,14 +41,61 @@ export interface TransferMoveDetail {
     /** The side they landed on. */
     to: TransferSide;
 }
+/** Default post-move announcement wording. Falls back for `getMoveAnnouncement`. */
+export declare function moveAnnouncement({ moved, remaining, from, to }: TransferMoveDetail): string;
+/** What a settled search query left visible, handed to `SkdxTransfer`'s `getSearchResultsAnnouncement`. */
+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;
+}
+/** Default search-results announcement wording. Falls back for `getSearchResultsAnnouncement`. */
+export declare function searchResultsAnnouncement({ shown, total, side, }: TransferSearchResultsDetail): string;
+/** One list's scroll geometry, carried by `SkdxTransfer`'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;
+}
 /**
- * The default wording of the post-move announcement. Split out so
- * `SkdxTransfer`'s `getMoveAnnouncement` has something to fall back to and so a
- * consumer can call it for the sides they do not want to re-word.
+ * How the built-in matcher compares a query against an item's label.
+ * `'contains'` is the default and the behaviour that shipped before this
+ * existed. A declarative stand-in for `filter`, which is a function and so
+ * cannot cross an HTML attribute boundary.
  */
-export declare function moveAnnouncement({ moved, remaining, from, to }: TransferMoveDetail): string;
+export type TransferFilterMatchMode = 'startsWith' | 'contains' | 'endsWith';
+/**
+ * Where an item lands on the target side when it is moved there. `'items'`
+ * keeps the collection's own order; `'append'` and `'prepend'` make the
+ * target list follow the order ids were moved in.
+ */
+export type TransferTargetOrder = 'items' | 'append' | 'prepend';
 /** @internal The default `filter`: a case-insensitive substring match against the item's label. */
 export declare function defaultTransferFilter(item: TransferItemData, query: string): boolean;
+/**
+ * The built-in matcher, parameterised by `filterMatchMode`.
+ *
+ * A declarative counterpart to `filter`: a function cannot cross the HTML
+ * attribute boundary, so `<skdx-transfer>` could only ever have the default
+ * substring match. This enum covers the case almost every consumer actually
+ * wants — "match from the start" for an id list, "contains" for labels — from
+ * an attribute, and leaves `filter` as the property-only escape hatch for
+ * anything else. PrimeVue's `filterMatchMode` is the precedent.
+ *
+ * Case-insensitive and trimmed in every mode, as the substring default always
+ * was: a user typing a leading space has not changed what they meant.
+ */
+export declare function matchesFilterMode(item: TransferItemData, query: string, mode?: TransferFilterMatchMode): boolean;
 /**
  * @internal Shared state distributed from `SkdxTransfer` to its parts. Every
  * field a part renders from is a `ComputedRef`, never a snapshot, so a prop
@@ -108,6 +133,16 @@ export interface TransferContext {
     registerHeader: (side: TransferSide, present: boolean) => void;
     /** Lets the root find a list element again, to place focus after a move. */
     registerList: (side: TransferSide, node: HTMLElement | null) => void;
+    /**
+     * Set just before the root places focus itself (after a move) so the next
+     * `focusin` a list sees is not mistaken for an external Tab and re-targeted
+     * by the default focus-in rule — the root's own placement is more specific
+     * than "first marked, else first". A plain mutable object, like `anchor`:
+     * nothing renders from it.
+     */
+    suppressFocusIn: {
+        current: boolean;
+    };
     /** Moves `values` (silently dropping any disabled ones), announces the outcome, and re-places focus. */
     move: (direction: TransferDirection, values: string[]) => void;
     /**
@@ -118,6 +153,8 @@ export interface TransferContext {
      * reaches the triggers.
      */
     moveLabel: (count: number, direction: TransferDirection, all: boolean) => string;
+    /** Publishes one list's scroll geometry to the root's `list-scroll` event. */
+    emitListScroll: (side: TransferSide, list: HTMLElement) => void;
 }
 /** @internal Injection key an `SkdxTransfer` provides so its parts share membership, marks, queries, and the move. */
 export declare const TRANSFER_CONTEXT: InjectionKey<TransferContext>;

package/dist/transfer/context.js

@@ -1 +1 @@
-var e='[role="option"]:not([data-disabled])',t={toTarget:"source",toSource:"target"},o={toTarget:"target",toSource:"source"},r={source:"available",target:"selected"};function a(e,t,a){const n=r[o[t]],s=a?"Move all":"Move";return 0===e?`${s} items to ${n}, ${a?"nothing to move":"nothing selected"}`:`${s} ${e} ${1===e?"item":"items"} to ${n}`}function n({moved:e,remaining:t,from:o,to:a}){return`${e} ${1===e?"item":"items"} moved to ${r[a]}. ${t} remaining in ${r[o]}.`}function s(e,t){return e.label.toLowerCase().includes(t.trim().toLowerCase())}var i=/* @__PURE__ */Symbol("skdx-transfer-context"),l=/* @__PURE__ */Symbol("skdx-transfer-list-context");export{o as DESTINATION_OF,e as OPTION_SELECTOR,t as ORIGIN_OF,r as SIDE_NOUN,i as TRANSFER_CONTEXT,l as TRANSFER_LIST_CONTEXT,s as defaultTransferFilter,n as moveAnnouncement,a as moveTriggerLabel};
+var t='[role="option"]:not([data-disabled])',e={toTarget:"source",toSource:"target"},o={toTarget:"target",toSource:"source"},n={source:"available",target:"selected"};function s(t,e,s){const r=n[o[e]],a=s?"Move all":"Move";return 0===t?`${a} items to ${r}, ${s?"nothing to move":"nothing selected"}`:`${a} ${t} ${1===t?"item":"items"} to ${r}`}function r({moved:t,remaining:e,from:o,to:s}){return`${t} ${1===t?"item":"items"} moved to ${n[s]}. ${e} remaining in ${n[o]}.`}function a({shown:t,total:e,side:o}){return`${t} of ${e} ${1===e?"item":"items"} shown in ${n[o]}.`}function i(t,e,o="contains"){const n=e.trim().toLowerCase();if(""===n)return!0;const s=t.label.toLowerCase();return"startsWith"===o?s.startsWith(n):"endsWith"===o?s.endsWith(n):s.includes(n)}var c=/* @__PURE__ */Symbol("skdx-transfer-context"),m=/* @__PURE__ */Symbol("skdx-transfer-list-context");export{o as DESTINATION_OF,t as OPTION_SELECTOR,e as ORIGIN_OF,n as SIDE_NOUN,c as TRANSFER_CONTEXT,m as TRANSFER_LIST_CONTEXT,i as matchesFilterMode,r as moveAnnouncement,s as moveTriggerLabel,a as searchResultsAnnouncement};

package/dist/transfer/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./Transfer.vue.cjs"),e=require("./TransferItem.vue.cjs"),s=require("./TransferList.vue.cjs"),t=require("./TransferListHeader.vue.cjs"),a=require("./TransferListSearch.vue.cjs"),n=require("./TransferControls.vue.cjs"),i=require("./TransferMoveTrigger.vue.cjs"),u=require("./TransferMoveAllTrigger.vue.cjs"),f=require("./TransferEmpty.vue.cjs");exports.SkdxTransfer=r.default;exports.SkdxTransferControls=n.default;exports.SkdxTransferEmpty=f.default;exports.SkdxTransferItem=e.default;exports.SkdxTransferList=s.default;exports.SkdxTransferListHeader=t.default;exports.SkdxTransferListSearch=a.default;exports.SkdxTransferMoveAllTrigger=u.default;exports.SkdxTransferMoveTrigger=i.default;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./Transfer.vue.cjs");exports.SkdxTransfer=e.default;

package/dist/transfer/index.d.cts

@@ -1,10 +1,2 @@
 export { default as SkdxTransfer } from './Transfer.vue.cjs';
-export { default as SkdxTransferList } from './TransferList.vue.cjs';
-export { default as SkdxTransferListHeader } from './TransferListHeader.vue.cjs';
-export { default as SkdxTransferListSearch } from './TransferListSearch.vue.cjs';
-export { default as SkdxTransferItem } from './TransferItem.vue.cjs';
-export { default as SkdxTransferControls } from './TransferControls.vue.cjs';
-export { default as SkdxTransferMoveTrigger } from './TransferMoveTrigger.vue.cjs';
-export { default as SkdxTransferMoveAllTrigger } from './TransferMoveAllTrigger.vue.cjs';
-export { default as SkdxTransferEmpty } from './TransferEmpty.vue.cjs';
-export type { TransferItemData, TransferMoveDetail, TransferSide, TransferDirection } from './context.cjs';
+export type { TransferItemData, TransferMoveDetail, TransferSide, TransferDirection, } from './context.cjs';

package/dist/transfer/index.d.ts

@@ -1,10 +1,2 @@
 export { default as SkdxTransfer } from './Transfer.vue.js';
-export { default as SkdxTransferList } from './TransferList.vue.js';
-export { default as SkdxTransferListHeader } from './TransferListHeader.vue.js';
-export { default as SkdxTransferListSearch } from './TransferListSearch.vue.js';
-export { default as SkdxTransferItem } from './TransferItem.vue.js';
-export { default as SkdxTransferControls } from './TransferControls.vue.js';
-export { default as SkdxTransferMoveTrigger } from './TransferMoveTrigger.vue.js';
-export { default as SkdxTransferMoveAllTrigger } from './TransferMoveAllTrigger.vue.js';
-export { default as SkdxTransferEmpty } from './TransferEmpty.vue.js';
-export type { TransferItemData, TransferMoveDetail, TransferSide, TransferDirection } from './context.js';
+export type { TransferItemData, TransferMoveDetail, TransferSide, TransferDirection, } from './context.js';

package/dist/transfer/index.js

@@ -1 +1 @@
-import r from"./Transfer.vue.js";import e from"./TransferItem.vue.js";import s from"./TransferList.vue.js";import a from"./TransferListHeader.vue.js";import f from"./TransferListSearch.vue.js";import o from"./TransferControls.vue.js";import m from"./TransferMoveTrigger.vue.js";import t from"./TransferMoveAllTrigger.vue.js";import T from"./TransferEmpty.vue.js";export{r as SkdxTransfer,o as SkdxTransferControls,T as SkdxTransferEmpty,e as SkdxTransferItem,s as SkdxTransferList,a as SkdxTransferListHeader,f as SkdxTransferListSearch,t as SkdxTransferMoveAllTrigger,m as SkdxTransferMoveTrigger};
+import r from"./Transfer.vue.js";export{r as SkdxTransfer};

package/dist/transfer/primitives.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./TransferControls.vue.cjs"),e=require("./TransferEmpty.vue.cjs"),s=require("./TransferItem.vue.cjs"),t=require("./TransferList.vue.cjs"),a=require("./TransferListHeader.vue.cjs"),n=require("./TransferListSearch.vue.cjs"),i=require("./TransferMoveAllTrigger.vue.cjs"),u=require("./TransferMoveTrigger.vue.cjs"),f=require("./Transfer.vue.cjs");exports.SkdxTransfer=f.default;exports.SkdxTransferControls=r.default;exports.SkdxTransferEmpty=e.default;exports.SkdxTransferItem=s.default;exports.SkdxTransferList=t.default;exports.SkdxTransferListHeader=a.default;exports.SkdxTransferListSearch=n.default;exports.SkdxTransferMoveAllTrigger=i.default;exports.SkdxTransferMoveTrigger=u.default;

package/dist/transfer/primitives.d.cts

@@ -0,0 +1,34 @@
+/**
+ * Advanced primitives for custom `SkdxTransfer` layouts. Recipe built from
+ * these.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxTransfer, SkdxTransferControls, SkdxTransferList, SkdxTransferListHeader, SkdxTransferMoveTrigger } from '@skdx/vue/primitives/transfer';
+ * </script>
+ *
+ * <template>
+ *   <SkdxTransfer :items="items" v-model:value="value">
+ *     <SkdxTransferListHeader side="source">Available</SkdxTransferListHeader>
+ *     <SkdxTransferList side="source" />
+ *     <SkdxTransferControls>
+ *       <SkdxTransferMoveTrigger direction="toTarget">→</SkdxTransferMoveTrigger>
+ *       <SkdxTransferMoveTrigger direction="toSource">←</SkdxTransferMoveTrigger>
+ *     </SkdxTransferControls>
+ *     <SkdxTransferListHeader side="target">Selected</SkdxTransferListHeader>
+ *     <SkdxTransferList side="target" />
+ *   </SkdxTransfer>
+ * </template>
+ * ```
+ */
+export { default as SkdxTransfer } from './Transfer.vue.cjs';
+export { default as SkdxTransferList } from './TransferList.vue.cjs';
+export { default as SkdxTransferListHeader } from './TransferListHeader.vue.cjs';
+export { default as SkdxTransferListSearch } from './TransferListSearch.vue.cjs';
+export { default as SkdxTransferItem } from './TransferItem.vue.cjs';
+export { default as SkdxTransferControls } from './TransferControls.vue.cjs';
+export { default as SkdxTransferMoveTrigger } from './TransferMoveTrigger.vue.cjs';
+export { default as SkdxTransferMoveAllTrigger } from './TransferMoveAllTrigger.vue.cjs';
+export { default as SkdxTransferEmpty } from './TransferEmpty.vue.cjs';
+export type { TransferItemData, TransferMoveDetail, TransferSide, TransferDirection, } from './context.cjs';

package/dist/transfer/primitives.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Advanced primitives for custom `SkdxTransfer` layouts. Recipe built from
+ * these.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxTransfer, SkdxTransferControls, SkdxTransferList, SkdxTransferListHeader, SkdxTransferMoveTrigger } from '@skdx/vue/primitives/transfer';
+ * </script>
+ *
+ * <template>
+ *   <SkdxTransfer :items="items" v-model:value="value">
+ *     <SkdxTransferListHeader side="source">Available</SkdxTransferListHeader>
+ *     <SkdxTransferList side="source" />
+ *     <SkdxTransferControls>
+ *       <SkdxTransferMoveTrigger direction="toTarget">→</SkdxTransferMoveTrigger>
+ *       <SkdxTransferMoveTrigger direction="toSource">←</SkdxTransferMoveTrigger>
+ *     </SkdxTransferControls>
+ *     <SkdxTransferListHeader side="target">Selected</SkdxTransferListHeader>
+ *     <SkdxTransferList side="target" />
+ *   </SkdxTransfer>
+ * </template>
+ * ```
+ */
+export { default as SkdxTransfer } from './Transfer.vue.js';
+export { default as SkdxTransferList } from './TransferList.vue.js';
+export { default as SkdxTransferListHeader } from './TransferListHeader.vue.js';
+export { default as SkdxTransferListSearch } from './TransferListSearch.vue.js';
+export { default as SkdxTransferItem } from './TransferItem.vue.js';
+export { default as SkdxTransferControls } from './TransferControls.vue.js';
+export { default as SkdxTransferMoveTrigger } from './TransferMoveTrigger.vue.js';
+export { default as SkdxTransferMoveAllTrigger } from './TransferMoveAllTrigger.vue.js';
+export { default as SkdxTransferEmpty } from './TransferEmpty.vue.js';
+export type { TransferItemData, TransferMoveDetail, TransferSide, TransferDirection, } from './context.js';

package/dist/transfer/primitives.js

@@ -0,0 +1 @@
+import r from"./TransferControls.vue.js";import e from"./TransferEmpty.vue.js";import s from"./TransferItem.vue.js";import a from"./TransferList.vue.js";import f from"./TransferListHeader.vue.js";import o from"./TransferListSearch.vue.js";import m from"./TransferMoveAllTrigger.vue.js";import t from"./TransferMoveTrigger.vue.js";import T from"./Transfer.vue.js";export{T as SkdxTransfer,r as SkdxTransferControls,e as SkdxTransferEmpty,s as SkdxTransferItem,a as SkdxTransferList,f as SkdxTransferListHeader,o as SkdxTransferListSearch,m as SkdxTransferMoveAllTrigger,t as SkdxTransferMoveTrigger};

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;