@skdx/react 0.27.0 → 0.29.0

package/dist/transfer/types.d.ts

@@ -1,19 +1,13 @@
 import type * as React from 'react';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
-/**
- * Which of the two lists a part belongs to. `'source'` is the pool an item
- * starts in; `'target'` is the result — the array `Transfer`'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.
- */
+/** `'source'` is the pool, `'target'` is the array `Transfer`'s `value` holds; named by role, not position. */
 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.
- */
+/** Named by where items land: `'toTarget'` adds to value, `'toSource'` removes. */
 export type TransferDirection = 'toTarget' | 'toSource';
+/** How the built-in matcher compares queries against item labels. */
+export type TransferFilterMatchMode = 'startsWith' | 'contains' | 'endsWith';
+/** Where items land on target side: `'items'` keeps collection order; `'append'` / `'prepend'` follow moves. */
+export type TransferTargetOrder = 'items' | 'append' | 'prepend';
 /** One entry in a {@link Transfer}'s collection. */
 export interface TransferItemData {
     /** Unique id. This is what appears in `Transfer`'s `value` once the item is on the target side. */
@@ -21,129 +15,217 @@ export interface TransferItemData {
     /** Human-readable text, used as the option's content and its typeahead `textValue` when the list renders itself. */
     label: string;
     /**
-     * Excludes this item from selection, from keyboard navigation, and from
-     * every move — including "move all".
-     * @default undefined — the item behaves normally.
+     * Excludes item from selection, navigation, and moves.
+     * @default undefined — item behaves normally.
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
 }
 /** @internal Shared state distributed from {@link Transfer} to its parts via context. Not part of the public API. */
 export interface TransferContextValue {
-    /** Stable id prefix the parts derive their wiring ids from. */
     baseId: string;
-    /** Whether the whole widget is disabled. */
     disabled: boolean;
-    /** Whether the search plumbing is on; `TransferListSearch` renders nothing while it is off. */
+    /** Whether search is active; `TransferListSearch` renders nothing when off. */
     searchable: boolean;
-    /** Every item on a side, before the search filter. */
+    /** All items on each side before search filtering. */
     sideItems: Record<TransferSide, TransferItemData[]>;
-    /** Every item on a side that survives the current search query — what is actually rendered. */
+    /** Items on each side that survive the current search query. */
     visibleItems: Record<TransferSide, TransferItemData[]>;
-    /** Each side's marked-for-move selection, already pruned of values that side no longer holds. */
+    /** Each side's marked-for-move selection, pruned to values still present. */
     marked: Record<TransferSide, string[]>;
-    /** Replaces one side's marked selection wholesale. */
     setMarked: (side: TransferSide, values: string[]) => void;
-    /** Each side's search query. */
     query: Record<TransferSide, string>;
     setQuery: (side: TransferSide, query: string) => void;
-    /** The option value holding each list's own tab stop — one roving group per side. */
+    /** The roving-focus option id for each list. */
     active: Record<TransferSide, string | null>;
     setActive: (side: TransferSide, value: string | null) => void;
-    /** Range-selection anchor per side: the last option marked *without* Shift. */
-    anchor: React.MutableRefObject<Record<TransferSide, string | null>>;
-    /** Whether a `TransferListHeader` is mounted for a side, which decides `aria-labelledby` vs `aria-label`. */
+    /** Range-selection anchor per side (last option marked without Shift). */
+    anchorRef: React.RefObject<Record<TransferSide, string | null>>;
+    /** Whether `TransferListHeader` is mounted (decides `aria-labelledby` vs `aria-label`). */
     labelled: Record<TransferSide, boolean>;
     registerHeader: (side: TransferSide, present: boolean) => void;
-    /** Lets the root find a list element again, to place focus after a move. */
     registerList: (side: TransferSide, node: HTMLDivElement | null) => void;
-    /** Moves `values` (silently dropping any disabled ones), announces the outcome, and re-places focus. */
+    /** Flag to suppress `focusin` being mistaken for external Tab after programmatic focus. */
+    suppressFocusInRef: React.RefObject<boolean>;
+    /** Moves values, announces outcome, and re-places focus; silently drops disabled items. */
     move: (direction: TransferDirection, values: string[]) => void;
-    /** The accessible name each move trigger gives itself — the root's `getMoveLabel`, or the built-in English one. */
+    /** Accessible name for move triggers (from `getMoveLabel` or built-in English). */
     moveLabel: (count: number, direction: TransferDirection, all: boolean) => string;
+    emitListScroll: (side: TransferSide, list: HTMLElement) => void;
 }
-/** What a move just did, handed to {@link TransferProps.getMoveAnnouncement} so it can word the live-region message. */
+/** The payload {@link TransferProps.onMove} receives: the items that moved and which way they went. */
+export interface TransferMoveEventDetail {
+    /** The items that actually moved; disabled ones are dropped before the move. */
+    items: TransferItemData[];
+    /** Which way they went. */
+    direction: TransferDirection;
+}
+/** Move outcome, handed to {@link TransferProps.getMoveAnnouncement} for wording. */
 export interface TransferMoveDetail {
-    /** How many items actually moved (disabled ones are never counted). */
+    /** How many items moved (disabled items never counted). */
     moved: number;
-    /** How many items are left on the side they came from. */
+    /** Items left on the origin side. */
     remaining: number;
-    /** Which way they went. */
     direction: TransferDirection;
-    /** The side they left. */
     from: TransferSide;
-    /** The side they landed on. */
     to: TransferSide;
 }
+/** Search results, handed to {@link TransferProps.getSearchResultsAnnouncement}. */
+export interface TransferSearchResultsDetail {
+    /** Items on this side that match the query. */
+    shown: number;
+    /** Total items on this side before filtering. */
+    total: number;
+    side: TransferSide;
+    /** The settled query (empty if user cleared the box). */
+    query: string;
+}
+/** List scroll geometry, carried by {@link TransferProps.onListScroll}. */
+export interface TransferListScrollDetail {
+    side: TransferSide;
+    scrollTop: number;
+    scrollHeight: number;
+    clientHeight: number;
+}
+/** Reason {@link TransferEmpty} is showing, handed to a function child. */
+export interface TransferEmptyContext {
+    /** `'empty'` when side holds nothing; `'no-results'` when filtered to nothing. */
+    reason: 'empty' | 'no-results';
+    /** The active search query (empty string if reason is `'empty'`). */
+    query: string;
+}
 /** Props for the {@link Transfer} root. */
 export interface TransferProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange' | 'defaultValue'> {
     /**
-     * The whole collection, both sides at once. Each side is *derived* from this
-     * plus `value`, never stored separately — one array is the source of truth,
-     * so the two lists cannot drift apart.
+     * Manually-composed parts; omitted, derives headed searchable lists from `titles` and `renderItem`.
+     * @default undefined — derives anatomy.
      */
+    children?: React.ReactNode | undefined;
+    /** Entire collection; both sides are derived from this plus `value`. */
     items: TransferItemData[];
     /**
-     * The ids currently on the target side, for controlled usage. Pair with
-     * `onValueChange`. Rendering order always follows `items`, not this array,
-     * so a controlled consumer never has to keep two orderings in sync.
-     * @default undefined — uncontrolled, tracks its own membership internally.
+     * Target-side ids for controlled usage; pair with `onValueChange`.
+     * @default undefined — uncontrolled.
+     */
+    value?: string[] | undefined;
+    /**
+     * Initial target-side ids for uncontrolled usage.
+     * @default undefined — all items start on source.
+     */
+    defaultValue?: string[] | undefined;
+    /**
+     * Fires with new target-side ids whenever items move.
+     * @default undefined — no-op.
+     */
+    onValueChange?: ((value: string[]) => void) | undefined;
+    /**
+     * Fires alongside `onValueChange` with the moved items and which way they went.
+     * @default undefined — no-op.
+     */
+    onMove?: ((detail: TransferMoveEventDetail) => void) | undefined;
+    /**
+     * Disables both lists and all move triggers; individual items have their own `disabled`.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Form field name; target-side ids submit as separate entries (not joined).
+     * @default undefined — submits nothing.
+     */
+    name?: string | undefined;
+    /**
+     * Form id for the submitted entries when Transfer is outside the form.
+     * @default undefined — entries belong to nearest ancestor form.
+     */
+    form?: string | undefined;
+    /**
+     * Enables per-list filtering; while false, `TransferListSearch` renders nothing.
+     * @default false
+     */
+    searchable?: boolean | undefined;
+    /**
+     * Custom filter; returns true if item survives query. Only consulted when `searchable`.
+     * @default undefined — case-insensitive substring match.
+     */
+    filter?: ((item: TransferItemData, query: string) => boolean) | undefined;
+    /**
+     * How built-in matcher compares queries to labels; ignored if `filter` is given.
+     * @default 'contains'
+     */
+    filterMatchMode?: TransferFilterMatchMode | undefined;
+    /**
+     * Words move-trigger accessible names (count is items to move, including zero).
+     * @default undefined — built-in English.
+     */
+    getMoveLabel?: ((count: number, direction: TransferDirection, all: boolean) => string) | undefined;
+    /**
+     * Words the polite live-region announcement after moves (return empty string to silence).
+     * @default undefined — built-in English.
+     */
+    getMoveAnnouncement?: ((detail: TransferMoveDetail) => string) | undefined;
+    /**
+     * Words the polite live-region announcement when search settles per side (return empty to silence).
+     * @default undefined — built-in English.
+     */
+    getSearchResultsAnnouncement?: ((detail: TransferSearchResultsDetail) => string) | undefined;
+    /**
+     * Where items land on target: `'items'` keeps collection order; `'append'` / `'prepend'` follow moves.
+     * @default 'items'
      */
-    value?: string[];
+    targetOrder?: TransferTargetOrder | undefined;
     /**
-     * The ids initially on the target side, for uncontrolled usage.
-     * @default undefined — every item starts on the source side.
+     * Fires on either list scroll with geometry for infinite-scroll loading.
+     * @default undefined — no-op.
      */
-    defaultValue?: string[];
+    onListScroll?: ((detail: TransferListScrollDetail) => void) | undefined;
     /**
-     * Fires with the whole new target-side id array whenever a move happens,
-     * controlled or not.
-     * @default undefined — no-op if omitted.
+     * Heading text for derived `TransferListHeader`s. Ignored when `children` given.
+     * @default { source: 'Available items', target: 'Selected items' }
      */
-    onValueChange?: (value: string[]) => void;
+    titles?: TransferTitles | undefined;
     /**
-     * Fires alongside `onValueChange` with the items that actually moved and
-     * which way, for side effects that need the moved rows rather than the new
-     * membership — a toast, an undo entry, a server call.
-     * @default undefined — no-op if omitted.
+     * Text for derived `TransferEmpty` states (`{query}` replaced with search text).
+     * @default { empty: 'Nothing here.', noMatch: 'No match for "{query}".' }
      */
-    onMove?: (items: TransferItemData[], direction: TransferDirection) => void;
+    emptyText?: TransferEmptyText | undefined;
     /**
-     * Disables both lists and every move trigger at once. Individual items can
-     * still be disabled on their own via `TransferItemData.disabled`.
+     * Whether derived `TransferControls` include a move-all trigger (off by default due to destructiveness).
      * @default false
      */
-    disabled?: boolean;
+    showMoveAll?: boolean | undefined;
     /**
-     * Enables per-list filtering. While `false`, `TransferListSearch` renders
-     * nothing and `filter` is never called — so the search box cannot be left
-     * on screen as decoration that does not work.
-     * @default false — both lists show everything on their side.
+     * Renders derived `TransferItem` content instead of `label`. Ignored when `children` given.
+     * @default undefined — each item renders its `label`.
      */
-    searchable?: boolean;
+    renderItem?: ((item: TransferItemData) => React.ReactNode) | undefined;
     /**
-     * Decides whether an item survives its list's current query. Only consulted
-     * while `searchable`.
-     * @default undefined — case-insensitive substring match against `item.label`.
+     * Spacing rung the skin packs the rows by, fed to both derived lists.
+     * @default undefined — the skin's own default spacing.
      */
-    filter?: (item: TransferItemData, query: string) => boolean;
+    density?: 'compact' | (string & {}) | undefined;
     /**
-     * Words the accessible name of every `TransferMoveTrigger` and
-     * `TransferMoveAllTrigger` under this root. `all` distinguishes the two, and
-     * `count` is how many items pressing it would actually move — zero included,
-     * because the trigger stays focusable with nothing to move and has to say
-     * why.
-     *
-     * The only way to translate those names: they are computed from live counts,
-     * so a static `aria-label` on the trigger cannot express them.
-     * @default undefined — the built-in English wording ("Move 3 items to selected").
+     * Corner rung the skin rounds the lists by, fed to both derived lists.
+     * @default undefined — the skin's own default corner.
      */
-    getMoveLabel?: (count: number, direction: TransferDirection, all: boolean) => string;
+    shape?: 'square' | 'rounded' | (string & {}) | undefined;
     /**
-     * Words the polite live-region announcement made after each move. Return
-     * `''` to say nothing at all.
-     * @default undefined — the built-in English wording ("3 items moved to selected. 5 remaining in available.").
+     * Size rung the skin scales the lists by, fed to both derived lists.
+     * @default undefined — the skin's own default size.
      */
-    getMoveAnnouncement?: (detail: TransferMoveDetail) => string;
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
+}
+/** Text for empty states. See {@link TransferProps.emptyText}. */
+export interface TransferEmptyText {
+    /** Shown when side holds no items. @default 'Nothing here.' */
+    empty?: string | undefined;
+    /** Shown when search filters all items (`{query}` replaced). @default 'No match for "{query}".' */
+    noMatch?: string | undefined;
+}
+/** List headings for derived anatomy. See {@link TransferProps.titles}. */
+export interface TransferTitles {
+    /** Source (available) list heading. @default 'Available items' */
+    source?: string | undefined;
+    /** Target (selected) list heading. @default 'Selected items' */
+    target?: string | undefined;
 }
 /** @internal Wiring passed from a {@link TransferList} to the {@link TransferItem}s inside it. Not part of the public API. */
 export interface TransferListContextValue {
@@ -154,10 +236,30 @@ export interface TransferListProps extends Omit<PrimitivePropsWithRef<'div'>, 'o
     /** Which of the two sides this list renders the items for. */
     side: TransferSide;
     /**
-     * Your own `TransferItem`s, when the default rendering is not enough.
-     * @default undefined — the list renders one `TransferItem` per visible item on its side, using `label` as both content and `textValue`.
+     * Renders derived `TransferItem` content instead of `label`. Ignored when `children` given.
+     * @default undefined — each item renders its `label`.
+     */
+    renderItem?: ((item: TransferItemData) => React.ReactNode) | undefined;
+    /**
+     * Custom `TransferItem`s to override the default rendering of items.
+     * @default undefined — one `TransferItem` per visible item, using `label` as content.
+     */
+    children?: React.ReactNode | undefined;
+    /**
+     * Spacing rung the skin packs this list by, mirrored to `data-density`.
+     * @default undefined — the skin's own default spacing.
      */
-    children?: React.ReactNode;
+    density?: 'compact' | (string & {}) | undefined;
+    /**
+     * Corner rung the skin rounds this list by, mirrored to `data-shape`.
+     * @default undefined — the skin's own default corner.
+     */
+    shape?: 'square' | 'rounded' | (string & {}) | undefined;
+    /**
+     * Size rung the skin scales this list by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
 }
 /** Props for {@link TransferListHeader}, the heading naming one list. */
 export interface TransferListHeaderProps extends PrimitivePropsWithRef<'div'> {
@@ -174,31 +276,36 @@ export interface TransferItemProps extends PrimitivePropsWithRef<'div'> {
     /** The id of the `TransferItemData` entry this option renders. */
     value: string;
     /**
-     * Excludes this option from marking, navigation, and moves.
+     * Excludes option from marking, navigation, and moves.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
-     * Text typeahead matches this option against, published as `data-text-value`.
-     * @default undefined — falls back to the option's rendered text content, indicator glyph included.
+     * Text typeahead matches against, published as `data-text-value`.
+     * @default undefined — falls back to rendered text content.
      */
-    textValue?: string;
+    textValue?: string | undefined;
 }
 /** Props for {@link TransferControls}, the named group holding the move triggers. */
 export interface TransferControlsProps extends PrimitivePropsWithRef<'div'> {
 }
-/** Props for {@link TransferMoveTrigger}, which moves the marked items one way. */
+/** Props for {@link TransferMoveTrigger}, moves marked items. */
 export interface TransferMoveTriggerProps extends PrimitivePropsWithRef<'button'> {
-    /** Which way this trigger moves: `'toTarget'` adds to the value, `'toSource'` removes from it. */
+    /** Direction: `'toTarget'` adds to value, `'toSource'` removes. */
     direction: TransferDirection;
 }
-/** Props for {@link TransferMoveAllTrigger}, which moves every visible item one way. */
+/** Props for {@link TransferMoveAllTrigger}, moves all visible items. */
 export interface TransferMoveAllTriggerProps extends PrimitivePropsWithRef<'button'> {
-    /** Which way this trigger moves: `'toTarget'` adds to the value, `'toSource'` removes from it. */
+    /** Direction: `'toTarget'` adds to value, `'toSource'` removes. */
     direction: TransferDirection;
 }
-/** Props for {@link TransferEmpty}, shown while one side has nothing to render. */
-export interface TransferEmptyProps extends PrimitivePropsWithRef<'div'> {
-    /** Which side's emptiness this message covers. */
+/** Props for {@link TransferEmpty}, shown when side has nothing to render. */
+export interface TransferEmptyProps extends Omit<PrimitivePropsWithRef<'div'>, 'children'> {
+    /** Which side ('source' or 'target') this empty state applies to. */
     side: TransferSide;
+    /**
+     * Message; pass function to differentiate empty vs no-results (published as `data-reason` / `data-query`).
+     * @default undefined — renders element only.
+     */
+    children?: React.ReactNode | ((context: TransferEmptyContext) => React.ReactNode) | undefined;
 }

package/dist/tree/Tree.cjs

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

package/dist/tree/Tree.d.cts

@@ -1,54 +1,30 @@
 import * as React from 'react';
-import type { TreeContextValue, TreeProps } from './types.cjs';
+import type { TreeContextValue, TreeHandle, TreeProps } from './types.cjs';
 /** Default `getLoadedLabel`: `"src loaded"`. */
 export declare function defaultGetLoadedLabel(nodeId: string): string;
-export declare const TreeProvider: {
-    (props: TreeContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, useTreeContext: (consumerName: string) => TreeContextValue;
-/** Ambient depth/parent-id passed down to the next level of TreeItems; overridden by each TreeGroup. */
+export declare const TreeProvider: React.FC<TreeContextValue & {
+    children: React.ReactNode;
+}>, useTreeContext: (consumerName: string) => TreeContextValue;
+/** Ambient depth and parent id passed to the next level, overridden by TreeGroup. */
 export declare const TreeAmbientContext: React.Context<{
     depth: number;
     parentId: string | null;
 }>;
 /**
- * Root of a tree view following the WAI-ARIA `treeview` pattern: renders a
- * `<div role="tree">` with `aria-multiselectable` when `selectionMode` is
- * `"multiple"`. Owns expanded/selected/active-node state and hands it down
- * to `TreeItem` / `TreeGroup` / `TreeItemIndicator` via context.
- *
- * A single tab stop uses roving tabindex over the currently *visible* items
- * only — collapsed subtrees aren't rendered, so they're naturally excluded.
- * Arrow Up/Down/Home/End move focus; Arrow Right expands a collapsed node
- * (or moves to its first child if already expanded); Arrow Left collapses an
- * expanded node (or moves focus to its parent); Enter/Space select the
- * focused node; printable characters run typeahead over the visible nodes'
- * labels; `*` expands every collapsed sibling of the focused node. Under
- * `selectionMode="multiple"`, Shift+Arrow Up/Down moves focus and toggles the
- * node it lands on, Shift+Home/End selects through to the first/last node,
- * Ctrl+A selects every visible node, and Ctrl+Arrow Up/Down moves focus
- * without touching the selection.
- *
- * Expansion and selection each work controlled (`expandedIds`/`selectedIds`
- * + their `onChange`) or uncontrolled (`defaultExpandedIds`/`defaultSelectedIds`).
- *
- * `loadChildren` lazily populates a branch the first time it expands, marking
- * the node `aria-busy` meanwhile and announcing when its children arrive.
- * `selectionPropagation="descendants"` turns it into a tri-state checkbox tree.
+ * Root of a tree view following the WAI-ARIA `treeview` pattern, rendering `role="tree"` with roving tabindex, full keyboard navigation/selection, lazy `loadChildren`, and an optional tri-state `selectionPropagation="descendants"` checkbox mode.
  *
  * @example
  * ```tsx
- * <Tree defaultExpandedIds={['src']}>
- *   <TreeItem nodeId="src">
- *     <TreeItemIndicator>▸</TreeItemIndicator>
- *     src
- *     <TreeGroup>
- *       <TreeItem nodeId="src/index.ts">index.ts</TreeItem>
- *     </TreeGroup>
- *   </TreeItem>
- * </Tree>
+ * <Tree
+ *   aria-label="Project files"
+ *   collection={[{ nodeId: 'src', children: [{ nodeId: 'src/index.ts', label: 'index.ts' }] }]}
+ *   defaultExpandedIds={['src']}
+ * />
  * ```
  */
-export declare const Tree: React.ForwardRefExoticComponent<Omit<TreeProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const Tree: {
+    (treeProps: Omit<TreeProps, "ref"> & {
+        ref?: React.Ref<HTMLDivElement & TreeHandle> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};

package/dist/tree/Tree.d.ts

@@ -1,54 +1,30 @@
 import * as React from 'react';
-import type { TreeContextValue, TreeProps } from './types.js';
+import type { TreeContextValue, TreeHandle, TreeProps } from './types.js';
 /** Default `getLoadedLabel`: `"src loaded"`. */
 export declare function defaultGetLoadedLabel(nodeId: string): string;
-export declare const TreeProvider: {
-    (props: TreeContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, useTreeContext: (consumerName: string) => TreeContextValue;
-/** Ambient depth/parent-id passed down to the next level of TreeItems; overridden by each TreeGroup. */
+export declare const TreeProvider: React.FC<TreeContextValue & {
+    children: React.ReactNode;
+}>, useTreeContext: (consumerName: string) => TreeContextValue;
+/** Ambient depth and parent id passed to the next level, overridden by TreeGroup. */
 export declare const TreeAmbientContext: React.Context<{
     depth: number;
     parentId: string | null;
 }>;
 /**
- * Root of a tree view following the WAI-ARIA `treeview` pattern: renders a
- * `<div role="tree">` with `aria-multiselectable` when `selectionMode` is
- * `"multiple"`. Owns expanded/selected/active-node state and hands it down
- * to `TreeItem` / `TreeGroup` / `TreeItemIndicator` via context.
- *
- * A single tab stop uses roving tabindex over the currently *visible* items
- * only — collapsed subtrees aren't rendered, so they're naturally excluded.
- * Arrow Up/Down/Home/End move focus; Arrow Right expands a collapsed node
- * (or moves to its first child if already expanded); Arrow Left collapses an
- * expanded node (or moves focus to its parent); Enter/Space select the
- * focused node; printable characters run typeahead over the visible nodes'
- * labels; `*` expands every collapsed sibling of the focused node. Under
- * `selectionMode="multiple"`, Shift+Arrow Up/Down moves focus and toggles the
- * node it lands on, Shift+Home/End selects through to the first/last node,
- * Ctrl+A selects every visible node, and Ctrl+Arrow Up/Down moves focus
- * without touching the selection.
- *
- * Expansion and selection each work controlled (`expandedIds`/`selectedIds`
- * + their `onChange`) or uncontrolled (`defaultExpandedIds`/`defaultSelectedIds`).
- *
- * `loadChildren` lazily populates a branch the first time it expands, marking
- * the node `aria-busy` meanwhile and announcing when its children arrive.
- * `selectionPropagation="descendants"` turns it into a tri-state checkbox tree.
+ * Root of a tree view following the WAI-ARIA `treeview` pattern, rendering `role="tree"` with roving tabindex, full keyboard navigation/selection, lazy `loadChildren`, and an optional tri-state `selectionPropagation="descendants"` checkbox mode.
  *
  * @example
  * ```tsx
- * <Tree defaultExpandedIds={['src']}>
- *   <TreeItem nodeId="src">
- *     <TreeItemIndicator>▸</TreeItemIndicator>
- *     src
- *     <TreeGroup>
- *       <TreeItem nodeId="src/index.ts">index.ts</TreeItem>
- *     </TreeGroup>
- *   </TreeItem>
- * </Tree>
+ * <Tree
+ *   aria-label="Project files"
+ *   collection={[{ nodeId: 'src', children: [{ nodeId: 'src/index.ts', label: 'index.ts' }] }]}
+ *   defaultExpandedIds={['src']}
+ * />
  * ```
  */
-export declare const Tree: React.ForwardRefExoticComponent<Omit<TreeProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const Tree: {
+    (treeProps: Omit<TreeProps, "ref"> & {
+        ref?: React.Ref<HTMLDivElement & TreeHandle> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};