@cocoar/vue-ui 2.6.0 → 2.7.0

package/dist/components/listbox/CoarListbox.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarListbox.vue.d.ts","sourceRoot":"","sources":["../../../src/components/listbox/CoarListbox.vue"],"names":[],"mappings":"AA48BA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,uBAAuB;IACvB,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjC,qHAAqH;IACrH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sGAAsG;IACtG,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mHAAmH;IACnH,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IAClD,2GAA2G;IAC3G,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAEpE,mCAAmC;IACnC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,mEAAmE;IACnE,WAAW,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACxC,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,6GAA6G;IAC7G,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IAEhD,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IAEtC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IAClD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAClB,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC;KACnB,KAAK,OAAO,CAAC;IAEd,iGAAiG;IACjG,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;yBAEgB,CAAC,EACjB,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;WAi6BO,mBAAmB,CAAC;;;kBAz3BM,iBAAiB,CAAC,CAAC,CAAC;mBAAS,UAAU;;;kBACpC,iBAAiB,CAAC,CAAC,CAAC;mBAAS,UAAU;;;kBACvC,iBAAiB,CAAC,CAAC,CAAC;;;kBACtB,iBAAiB,CAAC,CAAC,CAAC;;;kBACpB,iBAAiB,CAAC,CAAC,CAAC;kBAAQ,MAAM;sBAAY,OAAO;;;mBACrD,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;;;mBACjC,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;qBAAW,OAAO;;;mBAGrE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;yBACzB,MAAM,GAAG,IAAI;uBACf,MAAM,GAAG,IAAI;sBACd,OAAO;;;mBAID,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;qBAAW,MAAM,GAAG,IAAI;;;qBA2bhE,CAAC,EAAE;0CA8a8E,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB;;;;;;MAAsB,GAAG,IAAI;WACpE,GAAG;;;;;;;UArE4E,GAAG;;;;;;UACrB,GAAG;;;;;YAE5C,GAAG;;;wBA7TjB,MAAM;YA8TQ,GAAG;;;;YACM,GAAG;;;;YAEF,GAAG;;;;;;;YADd,GAAG;;;;;;;YAEH,GAAG;uBACF,GAAG;wBACF,GAAG;;UA6DzB;cA73B2B,iBAAiB,CAAC,CAAC,CAAC;eAAS,UAAU;;cACpC,iBAAiB,CAAC,CAAC,CAAC;eAAS,UAAU;;cACvC,iBAAiB,CAAC,CAAC,CAAC;;cACtB,iBAAiB,CAAC,CAAC,CAAC;;cACpB,iBAAiB,CAAC,CAAC,CAAC;cAAQ,MAAM;kBAAY,OAAO;;eACrD,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;;eACjC,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;iBAAW,OAAO;;eAGrE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;qBACzB,MAAM,GAAG,IAAI;mBACf,MAAM,GAAG,IAAI;kBACd,OAAO;;eAID,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE;iBAAW,MAAM,GAAG,IAAI;mEA62BlC;EAEvC,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AA56BzE,wBA46B4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
+{"version":3,"file":"CoarListbox.vue.d.ts","sourceRoot":"","sources":["../../../src/components/listbox/CoarListbox.vue"],"names":[],"mappings":"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"}

package/dist/components/tree/CoarTree.vue.d.ts

@@ -1,18 +1,24 @@
-import { CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeNodeMoveEvent, CoarTreeNodeSlotProps, CoarTreeRenameEvent, CoarTreeVirtualizeProp } from './tree-types';
+import { CoarTreeDensity, CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeFilterMode, CoarTreeLabels, CoarTreeLoadChildrenContext, CoarTreeLoadErrorEvent, CoarTreeNodeMoveEvent, CoarTreeNodeSlotProps, CoarTreeRenameEvent, CoarTreeSelectEvent, CoarTreeSelectionMode, CoarTreeVirtualizeProp } from './tree-types';
 import { TreeBuilder } from './tree-builder';
 declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly onSelect?: ((payload: CoarTreeSelectEvent<T>) => any) | undefined;
         readonly "onUpdate:expanded"?: ((value: Set<string>) => any) | undefined;
         readonly "onUpdate:selected"?: ((value: string | null) => any) | undefined;
+        readonly "onUpdate:selectedIds"?: ((value: Set<string>) => any) | undefined;
+        readonly "onUpdate:checkedIds"?: ((value: Set<string>) => any) | undefined;
         readonly onActivate?: ((node: T) => any) | undefined;
         readonly "onFiles-drop"?: ((payload: CoarTreeFilesDropEvent<T>) => any) | undefined;
         readonly "onNode-move"?: ((payload: CoarTreeNodeMoveEvent<T>) => any) | undefined;
         readonly onRename?: ((payload: CoarTreeRenameEvent<T>) => any) | undefined;
         readonly "onRename-cancel"?: ((node: T) => any) | undefined;
+        readonly "onLoad-error"?: ((payload: CoarTreeLoadErrorEvent<T>) => any) | undefined;
         readonly "onContext-menu"?: ((node: T | null, ev: MouseEvent) => any) | undefined;
-    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onUpdate:expanded" | "onUpdate:selected" | "onActivate" | "onFiles-drop" | "onNode-move" | "onRename" | "onRename-cancel" | "onContext-menu"> & ({
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onSelect" | "onUpdate:expanded" | "onUpdate:selected" | "onUpdate:selectedIds" | "onUpdate:checkedIds" | "onActivate" | "onFiles-drop" | "onNode-move" | "onRename" | "onRename-cancel" | "onLoad-error" | "onContext-menu"> & ({
         expanded?: Set<string>;
         selected?: string | null;
+        selectedIds?: Set<string>;
+        checkedIds?: Set<string>;
     } & {
         /** Fluent builder from `useTree()`. When set, the other config props are ignored. */
         builder?: TreeBuilder<T>;
@@ -21,11 +27,66 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         getChildren?: (node: T) => readonly T[] | null | undefined;
         getLabel?: (node: T) => string;
         isExpandable?: (node: T) => boolean;
+        /** Mark nodes non-interactive (no select/activate/check/keyboard-focus; `aria-disabled`). */
+        isDisabled?: (node: T) => boolean;
+        /**
+         * Lazily fetch a node's children on first expand. The 2nd arg carries an
+         * `AbortSignal` that fires if the folder collapses / leaves the tree. See
+         * the builder's `loadChildren`.
+         */
+        loadChildren?: (node: T, ctx: CoarTreeLoadChildrenContext) => void | Promise<void>;
+        /**
+         * Max simultaneous in-flight `loadChildren` calls; extra ones queue. `0`
+         * (default) = unlimited. Set a small number (e.g. 6) for rate-limited
+         * backends so an expand-all / state-restore can't fan out unbounded.
+         */
+        maxConcurrentLoads?: number;
         draggable?: boolean | ((node: T) => boolean);
         canDrop?: (source: T, target: T | null, position: CoarTreeDropPosition) => boolean;
+        /** Custom drag ghost for a node: return an `HTMLElement` or an HTML string (else the default row image). */
+        getDragImage?: (node: T) => HTMLElement | string | null | undefined;
+        /** Fire `activate` on a single click too (not only double-click / Enter). Default false. */
+        activateOnClick?: boolean;
         acceptsFiles?: boolean;
         autoExpandDelay?: number;
         virtualize?: CoarTreeVirtualizeProp;
+        /**
+         * Selection behavior: `'single'` (default, `v-model:selected`), `'multiple'`
+         * (`v-model:selectedIds`, Ctrl/Shift/Ctrl+A), or `'checkbox'` (per-row
+         * tri-state checkbox, `v-model:checkedIds`, independent of the highlight).
+         */
+        selectionMode?: CoarTreeSelectionMode;
+        /**
+         * Checkbox mode only: when `true`, checks don't cascade to parent/children and
+         * nothing is ever indeterminate. Default `false` (cascade + tri-state).
+         */
+        checkStrictly?: boolean;
+        /** Row density (`xs`/`s`/`m`/`l`, default `m`). Sets the spacing CSS variables. */
+        density?: CoarTreeDensity;
+        /** Accessible name for the tree (`aria-label` on the `role="tree"` element). */
+        ariaLabel?: string;
+        /** Id of an external label element (`aria-labelledby` on the `role="tree"` element). */
+        ariaLabelledby?: string;
+        /** Override built-in UI / screen-reader strings for i18n. Unset fields use English defaults. */
+        labels?: Partial<CoarTreeLabels>;
+        /**
+         * Search-hit ids. The tree exposes `isMatch` / `isMatchAncestor` to the slot
+         * (for highlighting) and auto-expands the ancestors of every match so hits
+         * are visible.
+         */
+        matchedIds?: Set<string>;
+        /**
+         * With `matchedIds` set, hide non-matches (off by default = highlight-only).
+         * What's kept around a match is controlled by `filterMode`.
+         */
+        filter?: boolean;
+        /**
+         * How `filter` prunes (mirrors PrimeVue). `'strict'` (default) = matches +
+         * their ancestor path only (a matched folder's non-matching children stay
+         * hidden — the VS Code / react-arborist convention). `'lenient'` = a matched
+         * folder reveals its whole subtree. See {@link CoarTreeFilterMode}.
+         */
+        filterMode?: CoarTreeFilterMode;
         /**
          * Opt into the built-in inline rename UI. With this on, `api.startRename(id)`
          * + `@rename` work and `<CoarTreeNodeLabel>` swaps to an `<input>` while the
@@ -33,9 +94,29 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
          * label component stays a plain `<span>` (back-compat for existing consumers).
          */
         renamable?: boolean;
+        /**
+         * Suppress the built-in spinner the tree shows in the chevron while a node's
+         * children lazily load (see `loadChildren`). Set this when you render your
+         * own loading indicator from the `isLoading` slot prop — e.g. replacing the
+         * row icon with a spinner.
+         */
+        hideLoadingSpinner?: boolean;
     }) & Partial<{}>> & import('vue').PublicProps;
     expose(exposed: import('vue').ShallowUnwrapRef<{
+        /**
+         * Move keyboard focus to a node. The template-ref form has been focus-only
+         * since 2.4.0 (note: the builder `api.focusNode` selects + focuses). Prefer
+         * `selectNode` / `revealNode` for explicit intent.
+         */
         focusNode(id: string): void;
+        /** Highlight-select AND focus a node (the "reveal & select" action). */
+        selectNode(id: string): void;
+        /**
+         * Force `loadChildren` to (re)run for `id` — retry after an error or refresh
+         * an already-loaded folder. No-op if `loadChildren` isn't set or `id` isn't
+         * in the tree.
+         */
+        reloadChildren: (id: string) => void;
         /**
          * Enter inline-rename mode on `id`. No-op if `:renamable` isn't set or
          * the id isn't in the visible-row list. Use from context menu items,
@@ -43,6 +124,18 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
          * the next frame.
          */
         startRename: (id: string) => void;
+        /** Expand every expandable, currently-loaded node. */
+        expandAll: () => void;
+        /** Collapse everything. */
+        collapseAll: () => void;
+        /** Expand all loaded ancestors of `id` so its row becomes visible. */
+        expandTo: (id: string) => void;
+        /** Scroll a node into view without changing focus or selection. */
+        revealNode: (id: string) => void;
+        /** Resolve a node by id from the loaded tree, or `null`. */
+        getNode: (id: string) => T | null;
+        /** Move a node (keyboard / a11y equivalent of drag-drop); runs cycle + canDrop guards. */
+        moveNode: (sourceId: string, targetId: string | null, position: CoarTreeDropPosition) => boolean;
     }>): void;
     attrs: any;
     slots: Readonly<{
@@ -54,12 +147,14 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
     };
     emit: {
         (e: "activate", node: T): void;
+        (e: "select", payload: CoarTreeSelectEvent<T>): void;
         (e: "context-menu", node: T | null, ev: MouseEvent): void;
         (e: "files-drop", payload: CoarTreeFilesDropEvent<T>): void;
         (e: "node-move", payload: CoarTreeNodeMoveEvent<T>): void;
         (e: "rename", payload: CoarTreeRenameEvent<T>): void;
         (e: "rename-cancel", node: T): void;
-    } & (((evt: "update:expanded", value: Set<string>) => void) & ((evt: "update:selected", value: string | null) => void));
+        (e: "load-error", payload: CoarTreeLoadErrorEvent<T>): void;
+    } & (((evt: "update:expanded", value: Set<string>) => void) & ((evt: "update:selected", value: string | null) => void) & ((evt: "update:selectedIds", value: Set<string>) => void) & ((evt: "update:checkedIds", value: Set<string>) => void));
 }>) => import('vue').VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/components/tree/CoarTree.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarTree.vue.d.ts","sourceRoot":"","sources":["../../../src/components/tree/CoarTree.vue"],"names":[],"mappings":"AAqjCA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAE3B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAE1B,KAAK,mBAAmB,EAExB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;yBAEjC,CAAC,EACjB,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;WA8nCO,mBAAmB,CAAC;;;;;;;;;;mBAzRf,GAAG,CAAC,MAAM,CAAC;mBACX,MAAM,GAAG,IAAI;;QAp2BtB,qFAAqF;kBAC3E,WAAW,CAAC,CAAC,CAAC;gBAEhB,SAAS,CAAC,EAAE;gBACZ,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM;sBACb,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS;mBAC/C,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM;uBACf,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO;oBACvB,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;kBAClC,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,oBAAoB,KAAK,OAAO;uBACnE,OAAO;0BACJ,MAAM;qBACX,sBAAsB;QACnC;;;;;WAKG;oBACS,OAAO;oBAymCuE,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB;sBA3U/B,MAAM;QAGpB;;;;;WAKG;0BAxBoB,MAAM;MA2VsC,GAAG,IAAI;WACpE,GAAG;;uBAzkCM,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO;iBACxC,OAAO;;uBADD,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO;iBACxC,OAAO;;UA0kCX;YArlCD,UAAU,QAAQ,CAAC,GAAG,IAAI;YAC1B,cAAc,QAAQ,CAAC,GAAG,IAAI,MAAM,UAAU,GAAG,IAAI;YACrD,YAAY,WAAW,sBAAsB,CAAC,CAAC,CAAC,GAAG,IAAI;YACvD,WAAW,WAAW,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI;YACrD,QAAQ,WAAW,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI;YAChD,eAAe,QAAQ,CAAC,GAAG,IAAI;2HAglCM;EAEvC,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AAzoCzE,wBAyoC4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
+{"version":3,"file":"CoarTree.vue.d.ts","sourceRoot":"","sources":["../../../src/components/tree/CoarTree.vue"],"names":[],"mappings":"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"}

package/dist/components/tree/CoarTreeNode.vue.d.ts

@@ -1,31 +1,24 @@
-import { CoarTreeDropPosition } from './tree-types';
 declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
         readonly "onRow-click"?: ((node: T, ev: MouseEvent) => any) | undefined;
         readonly "onRow-dblclick"?: ((node: T, ev: MouseEvent) => any) | undefined;
         readonly "onRow-context-menu"?: ((node: T, ev: MouseEvent) => any) | undefined;
-        readonly "onRow-dragstart"?: ((node: T, ev: DragEvent) => any) | undefined;
+        readonly "onRow-check-toggle"?: ((node: T) => any) | undefined;
+        readonly "onRow-retry"?: ((node: T) => any) | undefined;
         readonly "onChevron-click"?: ((node: T) => any) | undefined;
+        readonly "onRow-dragstart"?: ((node: T, ev: DragEvent) => any) | undefined;
         readonly "onRow-dragend"?: ((node: T) => any) | undefined;
         readonly "onRow-dragleave"?: ((node: T, ev: DragEvent) => any) | undefined;
         readonly "onRow-dragover"?: ((node: T, el: HTMLElement, ev: DragEvent) => any) | undefined;
         readonly "onRow-drop"?: ((node: T, el: HTMLElement, ev: DragEvent) => any) | undefined;
-    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onRow-click" | "onRow-dblclick" | "onRow-context-menu" | "onRow-dragstart" | "onChevron-click" | "onRow-dragend" | "onRow-dragleave" | "onRow-dragover" | "onRow-drop"> & {
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onRow-click" | "onRow-dblclick" | "onRow-context-menu" | "onRow-check-toggle" | "onRow-retry" | "onChevron-click" | "onRow-dragstart" | "onRow-dragend" | "onRow-dragleave" | "onRow-dragover" | "onRow-drop"> & {
         node: T;
         nodeId: string;
         depth: number;
         isExpandable: boolean;
-        isExpanded: boolean;
-        isSelected: boolean;
-        isFocused: boolean;
-        isRenaming: boolean;
         draggable: boolean;
         posInSet: number;
         setSize: number;
-        /** Drop-position indicator when an internal drag is over this row. */
-        dropIndicator: CoarTreeDropPosition | null;
-        /** Whole-row highlight when an OS file drag is over this folder. */
-        fileDropActive: boolean;
     } & Partial<{}>> & import('vue').PublicProps;
     expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
     attrs: any;
@@ -34,6 +27,8 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         (e: "row-click", node: T, ev: MouseEvent): void;
         (e: "row-dblclick", node: T, ev: MouseEvent): void;
         (e: "row-context-menu", node: T, ev: MouseEvent): void;
+        (e: "row-check-toggle", node: T): void;
+        (e: "row-retry", node: T): void;
         (e: "chevron-click", node: T): void;
         (e: "row-dragstart", node: T, ev: DragEvent): void;
         (e: "row-dragend", node: T): void;

package/dist/components/tree/CoarTreeNode.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarTreeNode.vue.d.ts","sourceRoot":"","sources":["../../../src/components/tree/CoarTreeNode.vue"],"names":[],"mappings":"AAkOA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,cAAc,CAAC;yBAEL,CAAC,EACjB,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;WAuNO,mBAAmB,CAAC;;;;;;;;;;;cArNpB,CAAC;gBACC,MAAM;eACP,MAAM;sBACC,OAAO;oBACT,OAAO;oBACP,OAAO;mBACR,OAAO;oBACN,OAAO;mBACR,OAAO;kBACR,MAAM;iBACP,MAAM;QACf,sEAAsE;uBACvD,oBAAoB,GAAG,IAAI;QAC1C,oEAAoE;wBACpD,OAAO;mBAuMqE,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI;WAClD,GAAG;;;YA/LL,WAAW,QAAQ,CAAC,MAAM,UAAU,GAAG,IAAI;YAC3C,cAAc,QAAQ,CAAC,MAAM,UAAU,GAAG,IAAI;YAC9C,kBAAkB,QAAQ,CAAC,MAAM,UAAU,GAAG,IAAI;YAClD,eAAe,QAAQ,CAAC,GAAG,IAAI;YAC/B,eAAe,QAAQ,CAAC,MAAM,SAAS,GAAG,IAAI;YAC9C,aAAa,QAAQ,CAAC,GAAG,IAAI;YAC7B,cAAc,QAAQ,CAAC,MAAM,WAAW,MAAM,SAAS,GAAG,IAAI;YAC9D,eAAe,QAAQ,CAAC,MAAM,SAAS,GAAG,IAAI;YAC9C,UAAU,QAAQ,CAAC,MAAM,WAAW,MAAM,SAAS,GAAG,IAAI;;EA2L5D,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AAlOzE,wBAkO4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
+{"version":3,"file":"CoarTreeNode.vue.d.ts","sourceRoot":"","sources":["../../../src/components/tree/CoarTreeNode.vue"],"names":[],"mappings":"yBAwXiB,CAAC,EACjB,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;WAoWO,mBAAmB,CAAC;;;;;;;;;;;;;cAlWpB,CAAC;gBACC,MAAM;eACP,MAAM;sBACC,OAAO;mBACV,OAAO;kBACR,MAAM;iBACP,MAAM;mBA4V6E,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI;WAClD,GAAG;;;YApTL,WAAW,QAAQ,CAAC,MAAM,UAAU,GAAG,IAAI;YAC3C,cAAc,QAAQ,CAAC,MAAM,UAAU,GAAG,IAAI;YAC9C,kBAAkB,QAAQ,CAAC,MAAM,UAAU,GAAG,IAAI;YAClD,kBAAkB,QAAQ,CAAC,GAAG,IAAI;YAClC,WAAW,QAAQ,CAAC,GAAG,IAAI;YAC3B,eAAe,QAAQ,CAAC,GAAG,IAAI;YAC/B,eAAe,QAAQ,CAAC,MAAM,SAAS,GAAG,IAAI;YAC9C,aAAa,QAAQ,CAAC,GAAG,IAAI;YAC7B,cAAc,QAAQ,CAAC,MAAM,WAAW,MAAM,SAAS,GAAG,IAAI;YAC9D,eAAe,QAAQ,CAAC,MAAM,SAAS,GAAG,IAAI;YAC9C,UAAU,QAAQ,CAAC,MAAM,WAAW,MAAM,SAAS,GAAG,IAAI;;EA8S5D,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AA/WzE,wBA+W4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}

package/dist/components/tree/index.d.ts

@@ -1,7 +1,7 @@
 export { default as CoarTree } from './CoarTree.vue';
 export { default as CoarTreeNodeLabel } from './CoarTreeNodeLabel.vue';
-export type { CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeNodeMoveEvent, CoarTreeNodeSlotProps, CoarTreeRenameContext, CoarTreeRenameEvent, CoarTreeMenuItem, CoarTreeMenuEntry, } from './tree-types';
-export { COAR_TREE_DRAG_MIME, COAR_TREE_RENAME_KEY, COAR_TREE_ROW_ID_KEY } from './tree-types';
+export type { CoarTreeDensity, CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeFilterMode, CoarTreeLabels, CoarTreeLoadChildrenContext, CoarTreeLoadErrorEvent, CoarTreeNodeMoveEvent, CoarTreeNodeSlotProps, CoarTreeRenameContext, CoarTreeRenameEvent, CoarTreeSelectEvent, CoarTreeSelectionMode, CoarTreeMenuItem, CoarTreeMenuEntry, CoarTreeVirtualizeProp, CoarTreeVirtualOptions, } from './tree-types';
+export { COAR_TREE_DRAG_MIME, COAR_TREE_RENAME_KEY, COAR_TREE_ROW_ID_KEY, DEFAULT_TREE_LABELS, } from './tree-types';
 export { useTree } from './useTree';
 export { TreeBuilder } from './tree-builder';
 export type { TreeApi, TreeBuilderState } from './tree-builder';

package/dist/components/tree/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvE,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvE,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/components/tree/internal/selection.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pure checkbox-cascade engine for `<CoarTree :selection-mode="'checkbox'">`.
+ *
+ * All functions are side-effect-free and operate on a {@link TreeIndex} (a flat
+ * id→relations view of the *loaded* tree), so they're trivially unit-testable
+ * and never touch Vue reactivity. The component builds the index from its
+ * config and feeds the result back into the `checkedIds` model.
+ *
+ * **Model.** `checkedIds` holds every node considered fully checked — leaves AND
+ * parents whose loaded children are all checked. The invariant maintained by
+ * {@link applyCheckToggle} is: *a parent is in the set iff all its loaded
+ * children are*. "Indeterminate" (some-but-not-all descendants checked) is never
+ * stored — it's derived on demand by {@link computeIndeterminate}.
+ *
+ * **Lazy inheritance.** A checked folder whose children aren't loaded yet keeps
+ * its id in the set; when the children arrive, {@link reconcileChecked}
+ * propagates the check down to them. See `loadChildren` on the tree.
+ *
+ * `checkStrictly` mode bypasses cascade entirely — callers just add/remove the
+ * single id and skip reconcile + indeterminate.
+ */
+/** Flat, O(1)-lookup view of the loaded tree. Unloaded/leaf nodes map to `[]`. */
+export interface TreeIndex {
+    /** Loaded child ids for each node id, in order. */
+    children: Map<string, string[]>;
+    /** Parent id for each node id; root nodes map to `null`. */
+    parent: Map<string, string | null>;
+    /** All node ids in DFS pre-order (parent before its children). */
+    order: string[];
+}
+/**
+ * Build a {@link TreeIndex} from the loaded node tree. Walks every node reachable
+ * via `getChildren` (regardless of expand state) so cascade works on collapsed
+ * subtrees too. Unloaded lazy folders (`getChildren` → null/undefined) contribute
+ * no children, so cascade never descends into data that doesn't exist yet.
+ */
+export declare function indexTree<T>(roots: readonly T[], getId: (n: T) => string, getChildren: (n: T) => readonly T[] | null | undefined): TreeIndex;
+/**
+ * Toggle `id` (and its whole loaded subtree) to `value`, then re-normalize every
+ * ancestor so a parent ends up checked exactly when all its loaded children are.
+ * Returns a NEW set; the input is left untouched.
+ */
+export declare function applyCheckToggle(checked: ReadonlySet<string>, id: string, value: boolean, index: TreeIndex): Set<string>;
+/**
+ * Propagate checks downward from every checked node. The only mutation is
+ * *adding* inherited descendants, so it's safe to run on any tree change: newly
+ * loaded children under a checked folder become checked, and a consumer that
+ * sets `checkedIds` to just a few ancestor ids gets the full closure for free.
+ * Returns the input set unchanged (same reference) when nothing was added.
+ */
+export declare function reconcileChecked(checked: ReadonlySet<string>, index: TreeIndex): Set<string>;
+/**
+ * Derive the indeterminate set: nodes NOT in `checked` that have at least one
+ * checked descendant. Walks in reverse DFS order (children before parents) so
+ * each node aggregates its already-computed subtree in one pass.
+ */
+export declare function computeIndeterminate(checked: ReadonlySet<string>, index: TreeIndex): Set<string>;
+//# sourceMappingURL=selection.d.ts.map

package/dist/components/tree/internal/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../../src/components/tree/internal/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,kFAAkF;AAClF,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,4DAA4D;IAC5D,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACnC,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EACvB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GACrD,SAAS,CAwBX;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,SAAS,GACf,GAAG,CAAC,MAAM,CAAC,CAwBb;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAe5F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAahG"}

package/dist/components/tree/tree-builder.d.ts

@@ -1,5 +1,5 @@
 import { MaybeRefOrGetter, Ref } from 'vue';
-import { CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeMenuEntry, CoarTreeNodeMoveEvent, CoarTreeVirtualizeProp } from './tree-types';
+import { CoarTreeDensity, CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeFilterMode, CoarTreeLabels, CoarTreeLoadChildrenContext, CoarTreeLoadErrorEvent, CoarTreeMenuEntry, CoarTreeNodeMoveEvent, CoarTreeRenameEvent, CoarTreeSelectEvent, CoarTreeSelectionMode, CoarTreeVirtualizeProp } from './tree-types';
 /**
  * Internal mutable state owned by the builder. Held as `shallowReactive` so
  * mid-session mutations (e.g. `builder.draggable(true)` after mount) trigger
@@ -11,16 +11,47 @@ export interface TreeBuilderState<T> {
     getChildren?: (n: T) => readonly T[] | null | undefined;
     getLabel?: (n: T) => string;
     isExpandable?: (n: T) => boolean;
+    isDisabled?: (n: T) => boolean;
     draggable: MaybeRefOrGetter<boolean | ((n: T) => boolean)>;
     canDrop?: (s: T, t: T | null, p: CoarTreeDropPosition) => boolean;
+    getDragImage?: (n: T) => HTMLElement | string | null | undefined;
+    activateOnClick: MaybeRefOrGetter<boolean>;
     acceptsFiles: MaybeRefOrGetter<boolean>;
     autoExpandDelay: MaybeRefOrGetter<number>;
     virtualize: MaybeRefOrGetter<CoarTreeVirtualizeProp>;
+    hideLoadingSpinner: MaybeRefOrGetter<boolean>;
+    /** Opt into the built-in inline-rename UI (see `renamable` setter). */
+    renamable: MaybeRefOrGetter<boolean>;
+    onRename?: (e: CoarTreeRenameEvent<T>) => void;
+    onRenameCancel?: (node: T) => void;
+    selectionMode: MaybeRefOrGetter<CoarTreeSelectionMode>;
+    /** Checkbox-mode only: independent parent/child checks, no cascade / indeterminate. */
+    checkStrictly: MaybeRefOrGetter<boolean>;
+    density: MaybeRefOrGetter<CoarTreeDensity>;
+    ariaLabel: MaybeRefOrGetter<string | undefined>;
+    ariaLabelledby: MaybeRefOrGetter<string | undefined>;
+    labels: MaybeRefOrGetter<Partial<CoarTreeLabels> | undefined>;
+    /** Search-hit ids — drives `isMatch`/`isMatchAncestor` + auto-expand-to-match. */
+    matchedIds: MaybeRefOrGetter<Set<string> | undefined>;
+    /** With `matchedIds`, hide non-matches. `filterMode` controls what's kept around a match. */
+    filter: MaybeRefOrGetter<boolean>;
+    filterMode: MaybeRefOrGetter<CoarTreeFilterMode>;
     expanded: Ref<Set<string>>;
+    /** Single-mode highlight selection. */
     selected: Ref<string | null>;
+    /** Multiple/checkbox-mode highlight selection. */
+    selectedIds: Ref<Set<string>>;
+    /** Checkbox-mode checked set (fully-checked nodes; indeterminate is derived). */
+    checkedIds: Ref<Set<string>>;
     onActivate?: (node: T) => void;
+    onSelect?: (e: CoarTreeSelectEvent<T>) => void;
     onNodeMove?: (e: CoarTreeNodeMoveEvent<T>) => void;
     onFilesDrop?: (e: CoarTreeFilesDropEvent<T>) => void;
+    /** Lazily fetch a node's children when it's expanded (see `loadChildren` setter). */
+    loadChildren?: (node: T, ctx: CoarTreeLoadChildrenContext) => void | Promise<void>;
+    /** Max simultaneous in-flight loads; extra ones queue. 0/undefined = unlimited. */
+    maxConcurrentLoads: MaybeRefOrGetter<number>;
+    onLoadError?: (e: CoarTreeLoadErrorEvent<T>) => void;
     /** Declarative menus — `<CoarTree>` renders the menu itself when these are set. */
     folderMenu?: (folder: T) => readonly CoarTreeMenuEntry[];
     leafMenu?: (leaf: T) => readonly CoarTreeMenuEntry[];
@@ -30,25 +61,71 @@ export interface TreeBuilderState<T> {
     onLeafContextMenu?: (leaf: T, ev: MouseEvent) => void;
     onViewportContextMenu?: (ev: MouseEvent) => void;
 }
+/**
+ * The imperative operations `<CoarTree>` registers on mount. The {@link TreeApi}
+ * delegates to these; before mount they're absent, so action methods warn +
+ * no-op and `getNode` returns `null`.
+ * @internal
+ */
+export interface TreeApiImpls<T> {
+    focusNode(id: string): void;
+    selectNode(id: string): void;
+    reloadChildren(id: string): void;
+    startRename(id: string): void;
+    expandAll(): void;
+    collapseAll(): void;
+    expandTo(id: string): void;
+    revealNode(id: string): void;
+    getNode(id: string): T | null;
+    moveNode(sourceId: string, targetId: string | null, position: CoarTreeDropPosition): boolean;
+}
 /**
  * Public, narrow imperative interface returned by `useTree().api`. Keeps
- * component refs out of consumer code: you call `api.focusNode('x')` instead
- * of digging into a template ref. Readonly refs (`selectedId`, `expandedIds`)
+ * component refs out of consumer code: you call `api.selectNode('x')` instead
+ * of digging into a template ref. Readonly refs (`selectedId`, `expandedIds`, …)
  * mirror the builder state so consumers can `watch()` them without owning
- * the writable refs themselves.
+ * the writable refs themselves. Action methods are no-ops (with a DEV warning)
+ * until `<CoarTree>` mounts.
  */
-export interface TreeApi {
-    /** Programmatically move focus + selection to a node. No-op until `<CoarTree>` is mounted. */
+export interface TreeApi<T = unknown> {
+    /** Highlight-select AND focus a node (the "reveal & select" action). Preferred over `focusNode`. */
+    selectNode(id: string): void;
+    /** Alias of {@link selectNode} (selects + focuses) — retained for back-compat since 2.4.0. */
     focusNode(id: string): void;
-    /** Selected node id (read-only). */
+    /** Force `loadChildren` to (re)run for a node — retry after error / refresh. */
+    reloadChildren(id: string): void;
+    /** Enter inline-rename mode on a node (requires `renamable`). */
+    startRename(id: string): void;
+    /** Expand every expandable, currently-loaded node. */
+    expandAll(): void;
+    /** Collapse everything. */
+    collapseAll(): void;
+    /** Expand all loaded ancestors of `id` so its row becomes visible. */
+    expandTo(id: string): void;
+    /** Scroll a node into view without changing focus or selection (expands ancestors first). */
+    revealNode(id: string): void;
+    /** Resolve a node by id from the loaded tree, or `null` (also `null` before mount). */
+    getNode(id: string): T | null;
+    /**
+     * Programmatically move a node — the keyboard / a11y-accessible equivalent of a
+     * drag-drop. Runs the same cycle + `canDrop` guards and fires `node-move`.
+     * Returns `true` if the move was emitted, `false` if rejected (or before mount).
+     */
+    moveNode(sourceId: string, targetId: string | null, position: CoarTreeDropPosition): boolean;
+    /** Selected node id (read-only, single mode). */
     readonly selectedId: Ref<string | null>;
+    /** Highlight-selected ids (read-only, multiple/checkbox mode). */
+    readonly selectedIds: Ref<Set<string>>;
+    /** Checked ids (read-only, checkbox mode). */
+    readonly checkedIds: Ref<Set<string>>;
     /** Currently expanded ids (read-only). */
     readonly expandedIds: Ref<Set<string>>;
 }
 export declare class TreeBuilder<T> {
     readonly state: TreeBuilderState<T>;
-    readonly api: TreeApi;
-    private _focusNodeImpl;
+    readonly api: TreeApi<T>;
+    private _impls;
+    private _warnUnmounted;
     private constructor();
     /** Factory — keeps construction sites consistent across call sites. */
     static create<T>(): TreeBuilder<T>;
@@ -64,9 +141,48 @@ export declare class TreeBuilder<T> {
      * before their children are fetched.
      */
     isExpandable(fn: (n: T) => boolean): this;
+    /**
+     * Mark nodes as non-interactive: disabled rows can't be selected, activated,
+     * directly checked, focused by keyboard, or matched by type-ahead, and render
+     * `aria-disabled`. (Cascade from a checked ancestor still includes them.)
+     */
+    isDisabled(fn: (n: T) => boolean): this;
+    /**
+     * Lazily fetch a node's children the first time it's expanded while it has no
+     * loaded children yet. Return a `Promise` and the tree shows a spinner on the
+     * row until it settles; on rejection the row flips to an error state and
+     * `onLoadError` fires. Pair with `.isExpandable(() => true)` (or per-node) so
+     * folders render expandable BEFORE their children exist — the consumer attaches
+     * the fetched children to its own `nodes`.
+     *
+     * Attach so `nodes` updates reactively: produce a NEW root reference
+     * (`nodes.value = [...]`) or keep `nodes` deeply reactive. A pure in-place
+     * mutation on a shallow source won't re-render the row (the spinner persists).
+     *
+     * The 2nd arg carries an `AbortSignal` that fires if the folder collapses or
+     * leaves the tree mid-flight — forward it to `fetch` so a cancelled load
+     * doesn't waste work or race a later reopen.
+     */
+    loadChildren(fn: (node: T, ctx: CoarTreeLoadChildrenContext) => void | Promise<void>): this;
+    /**
+     * Cap simultaneous in-flight `loadChildren` calls; extra ones queue. `0`
+     * (default) = unlimited. Set a small number (e.g. 6) for rate-limited backends.
+     */
+    maxConcurrentLoads(n: MaybeRefOrGetter<number>): this;
     /** Enable internal drag-to-reorder. Accepts a per-node predicate. */
     draggable(d: MaybeRefOrGetter<boolean | ((n: T) => boolean)>): this;
+    /**
+     * Veto drops. Return `false` to disallow dropping `source` at `position`
+     * relative to `target` (`null` target = the root background). Advisory: `source`
+     * is the dragstart snapshot (not re-resolved per `dragover`), so read identity,
+     * not mutable fields. Integrity (no node into its own descendant) is always
+     * guaranteed by the built-in cycle guard regardless of what `canDrop` returns.
+     */
     canDrop(fn: (source: T, target: T | null, position: CoarTreeDropPosition) => boolean): this;
+    /** Custom drag ghost for a node: return an `HTMLElement` or HTML string (else the default row image). */
+    getDragImage(fn: (n: T) => HTMLElement | string | null | undefined): this;
+    /** Fire `onActivate` on a single click too (not only double-click / Enter). Default false. */
+    activateOnClick(b: MaybeRefOrGetter<boolean>): this;
     acceptsFiles(b: MaybeRefOrGetter<boolean>): this;
     autoExpandDelay(ms: MaybeRefOrGetter<number>): this;
     /**
@@ -78,20 +194,90 @@ export declare class TreeBuilder<T> {
      * height (or put it in a sized flex/grid cell) so the viewport is measurable.
      */
     virtualize(v: MaybeRefOrGetter<CoarTreeVirtualizeProp>): this;
+    /**
+     * Suppress the built-in spinner the tree shows in the chevron while a node's
+     * children lazily load. Set this when you render your own loading indicator
+     * from the `isLoading` slot prop (e.g. replacing the row icon).
+     */
+    hideLoadingSpinner(b: MaybeRefOrGetter<boolean>): this;
+    /**
+     * Enable the built-in inline-rename UI. With it on, `api.startRename(id)` and
+     * F2 on the focused row swap `<CoarTreeNodeLabel>` to an `<input>`; commit on
+     * Enter / blur fires `onRename`, Escape / empty fires `onRenameCancel`.
+     */
+    renamable(b: MaybeRefOrGetter<boolean>): this;
+    /**
+     * Selection behavior: `'single'` (default), `'multiple'` (Ctrl/Shift/Ctrl+A on
+     * `selectedIds`), or `'checkbox'` (per-row tri-state checkbox on `checkedIds`,
+     * independent of the highlight selection). See {@link CoarTreeSelectionMode}.
+     */
+    selectionMode(m: MaybeRefOrGetter<CoarTreeSelectionMode>): this;
+    /**
+     * Checkbox mode only: when `true`, checking a node does NOT cascade to its
+     * parent/children and no node is ever indeterminate. Default `false`
+     * (cascade + tri-state, the file-tree convention).
+     */
+    checkStrictly(b: MaybeRefOrGetter<boolean>): this;
+    /** Row density (`xs`/`s`/`m`/`l`, default `m`). Sets the spacing CSS variables. */
+    density(d: MaybeRefOrGetter<CoarTreeDensity>): this;
+    /** Accessible name for the tree (`aria-label` on the `role="tree"` element). */
+    ariaLabel(label: MaybeRefOrGetter<string | undefined>): this;
+    /** Id of an external label element (`aria-labelledby` on the `role="tree"` element). */
+    ariaLabelledby(id: MaybeRefOrGetter<string | undefined>): this;
+    /** Override built-in UI / screen-reader strings for i18n (unset fields use English defaults). */
+    labels(l: MaybeRefOrGetter<Partial<CoarTreeLabels> | undefined>): this;
+    /**
+     * Search-hit ids. Drives `isMatch` / `isMatchAncestor` slot props and
+     * auto-expands the ancestors of every match. Filtering the node set is still
+     * the consumer's job (e.g. a computed passed to `.nodes()`).
+     */
+    matchedIds(ids: MaybeRefOrGetter<Set<string> | undefined>): this;
+    /**
+     * With `matchedIds` set, hide everything that isn't a match, an ancestor of a
+     * match (kept as a "virtual parent" for context), or a descendant of a match.
+     * Default false (highlight-only).
+     */
+    filter(b: MaybeRefOrGetter<boolean>): this;
+    /**
+     * How `filter` prunes: `'strict'` (default) = matches + ancestor path only;
+     * `'lenient'` = a matched folder reveals its whole subtree. See {@link CoarTreeFilterMode}.
+     */
+    filterMode(m: MaybeRefOrGetter<CoarTreeFilterMode>): this;
     /**
      * Bind the set of expanded folder ids. Must be a writable `Ref` — `api`
      * and folder toggles need to write back. Getters are rejected at runtime
      * because they would silently lose writes.
      */
     expanded(r: Ref<Set<string>>): this;
-    /** Bind the selected-node id. Must be a writable `Ref<string | null>`. */
+    /** Bind the selected-node id (single mode). Must be a writable `Ref<string | null>`. */
     selected(r: Ref<string | null>): this;
+    /**
+     * Bind the highlight-selection set (multiple / checkbox modes). Must be a
+     * writable `Ref<Set<string>>` — Ctrl/Shift/Ctrl+A and `api` write back.
+     */
+    selectedIds(r: Ref<Set<string>>): this;
+    /**
+     * Bind the checked set (checkbox mode). Must be a writable `Ref<Set<string>>`.
+     * Holds every fully-checked node; the indeterminate set is derived internally.
+     */
+    checkedIds(r: Ref<Set<string>>): this;
     /** Fires on double-click or Enter on the focused row. */
     onActivate(h: (node: T) => void): this;
+    /**
+     * Fires whenever the highlight selection changes, with the primary node, the
+     * full selected-id set, and whether it was a user gesture or an `api` call.
+     */
+    onSelect(h: (e: CoarTreeSelectEvent<T>) => void): this;
     /** Fires after an internal drag-drop completes. The consumer mutates the tree. */
     onNodeMove(h: (e: CoarTreeNodeMoveEvent<T>) => void): this;
     /** Fires when OS files are dropped onto a folder or the empty background. */
     onFilesDrop(h: (e: CoarTreeFilesDropEvent<T>) => void): this;
+    /** Fires when an inline rename is committed (Enter / blur with a non-empty name). */
+    onRename(h: (e: CoarTreeRenameEvent<T>) => void): this;
+    /** Fires when an inline rename is cancelled (Escape, or committed empty). */
+    onRenameCancel(h: (node: T) => void): this;
+    /** Fires when a lazy `loadChildren` promise rejects. */
+    onLoadError(h: (e: CoarTreeLoadErrorEvent<T>) => void): this;
     /**
      * Items shown when right-clicking a folder row. When set (and the
      * `onFolderContextMenu` escape hatch is NOT set), `<CoarTree>` renders a
@@ -118,7 +304,7 @@ export declare class TreeBuilder<T> {
     onLeafContextMenu(h: (leaf: T, ev: MouseEvent) => void): this;
     /** Same as {@link onFolderContextMenu} for the empty background. Overrides {@link viewportMenu}. */
     onViewportContextMenu(h: (ev: MouseEvent) => void): this;
-    /** @internal — `<CoarTree>` registers its focus impl on mount. */
-    _setFocusNodeImpl(fn: ((id: string) => void) | null): void;
+    /** @internal — `<CoarTree>` registers its imperative impls on mount, clears (null) on unmount. */
+    _bindImpls(impls: TreeApiImpls<T> | null): void;
 }
 //# sourceMappingURL=tree-builder.d.ts.map