@cocoar/vue-ui 2.2.1 → 2.4.0

package/dist/components/breadcrumb/CoarBreadcrumb.vue.d.ts

@@ -1,8 +1,18 @@
+export type CoarBreadcrumbSize = 'm' | 's';
 type __VLS_Props = {
     /** Separator character between breadcrumb items. */
     separator?: string;
     /** Accessible label for the nav landmark. Localizable. */
     ariaLabel?: string;
+    /**
+     * Visual density. `'m'` (default, 14 px) is the primary-navigation size.
+     * `'s'` (13 px) is for secondary chrome — file-explorer paths, settings
+     * trails, anywhere the breadcrumb sits above other content as
+     * orientation rather than the main interactive surface. Drives the
+     * `--coar-breadcrumb-font-size` token only; spacing + colors stay
+     * unchanged so both sizes feel consistent in the same UI.
+     */
+    size?: CoarBreadcrumbSize;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -14,6 +24,7 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: CoarBreadcrumbSize;
     ariaLabel: string;
     separator: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;

package/dist/components/breadcrumb/CoarBreadcrumb.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarBreadcrumb.vue.d.ts","sourceRoot":"","sources":["../../../src/components/breadcrumb/CoarBreadcrumb.vue"],"names":[],"mappings":"AAkDA,KAAK,WAAW,GAAG;IACf,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAYJ,iBAAS,cAAc;WAiCT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAUD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;eA9DL,MAAM;eAFN,MAAM;qFAwEpB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarBreadcrumb.vue.d.ts","sourceRoot":"","sources":["../../../src/components/breadcrumb/CoarBreadcrumb.vue"],"names":[],"mappings":"AAqEA,MAAM,MAAM,kBAAkB,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,KAAK,WAAW,GAAG;IACf,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,CAAC;AAYJ,iBAAS,cAAc;WAmCT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAUD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;UAhEV,kBAAkB;eATb,MAAM;eAFN,MAAM;qFAmFpB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

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

@@ -1,3 +1,4 @@
 export { default as CoarBreadcrumb } from './CoarBreadcrumb.vue';
+export type { CoarBreadcrumbSize } from './CoarBreadcrumb.vue';
 export { default as CoarBreadcrumbItem } from './CoarBreadcrumbItem.vue';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/breadcrumb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/breadcrumb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/components/icon/core-icons.d.ts

@@ -45,6 +45,7 @@ export declare const CORE_ICONS: {
     copy: string;
     database: string;
     download: string;
+    'ellipsis-vertical': string;
     ellipsis: string;
     eraser: string;
     'external-link': string;
@@ -56,9 +57,11 @@ export declare const CORE_ICONS: {
     folder: string;
     globe: string;
     'grip-vertical': string;
+    hand: string;
     hash: string;
     heading: string;
     heart: string;
+    highlighter: string;
     home: string;
     image: string;
     'indent-decrease': string;
@@ -85,6 +88,8 @@ export declare const CORE_ICONS: {
     moon: string;
     'more-horizontal': string;
     'more-vertical': string;
+    'mouse-pointer-2': string;
+    'move-horizontal': string;
     'move-left': string;
     'move-right': string;
     palette: string;
@@ -97,6 +102,8 @@ export declare const CORE_ICONS: {
     'qr-code': string;
     'redo-2': string;
     'refresh-cw': string;
+    'rotate-ccw': string;
+    'rotate-cw': string;
     rows: string;
     save: string;
     'scan-line': string;
@@ -120,6 +127,7 @@ export declare const CORE_ICONS: {
     'text-quote': string;
     'trash-2': string;
     'triangle-alert': string;
+    type: string;
     'undo-2': string;
     unlink: string;
     unlock: string;

package/dist/components/icon/core-icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-icons.d.ts","sourceRoot":"","sources":["../../../src/components/icon/core-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwHtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC"}
+{"version":3,"file":"core-icons.d.ts","sourceRoot":"","sources":["../../../src/components/icon/core-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgItB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC"}

package/dist/components/sidebar/CoarSidebarDivider.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarSidebarDivider.vue.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/CoarSidebarDivider.vue"],"names":[],"mappings":";AA2EA,wBAMG"}
+{"version":3,"file":"CoarSidebarDivider.vue.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/CoarSidebarDivider.vue"],"names":[],"mappings":";AA+HA,wBAMG"}

package/dist/components/sidebar/CoarSidebarGroup.vue.d.ts

@@ -11,6 +11,21 @@ type __VLS_Props = {
     iconOnly?: boolean;
     /** Open flyout on hover instead of click. Only applies to mode="flyout". */
     openOnHover?: boolean;
+    /**
+     * Split-trigger mode: clicking the trigger emits `triggerClick` instead
+     * of toggling the panel. The flyout opens only via hover (`openOnHover`)
+     * or programmatically via `v-model:open`. Use when the trigger represents
+     * a primary action (e.g. "activate marker tool") and the panel offers
+     * secondary configuration (stroke width, color). Only meaningful with
+     * `mode="flyout"`; ignored for `mode="expand"`.
+     */
+    splitTrigger?: boolean;
+    /**
+     * Visual "selected" state for the trigger — matches `CoarSidebarItem`'s
+     * `active` prop styling. Typically driven by the consumer to indicate
+     * that the tool this group represents is currently the active one.
+     */
+    active?: boolean;
 };
 type __VLS_PublicProps = {
     'open'?: boolean;
@@ -28,14 +43,18 @@ declare function __VLS_template(): {
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
+    triggerClick: (event: MouseEvent) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    onTriggerClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
     disabled: boolean;
     mode: "expand" | "flyout";
     icon: string;
+    active: boolean;
     iconOnly: boolean;
     openOnHover: boolean;
+    splitTrigger: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     triggerRef: HTMLDivElement;
 }, HTMLDivElement>;

package/dist/components/sidebar/CoarSidebarGroup.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarSidebarGroup.vue.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/CoarSidebarGroup.vue"],"names":[],"mappings":"AA6zBA,KAAK,WAAW,GAAG;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAqPJ,KAAK,iBAAiB,GAAG;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WA+IT,OAAO,IAA6B;;yBAXpB,GAAG;;;;;;EAgBhC;AA2BD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;cAnbN,OAAO;UAEX,QAAQ,GAAG,QAAQ;UAJnB,MAAM;cAMF,OAAO;iBAEJ,OAAO;;;kBAubvB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarSidebarGroup.vue.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/CoarSidebarGroup.vue"],"names":[],"mappings":"AA+4BA,KAAK,WAAW,GAAG;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAuRJ,KAAK,iBAAiB,GAAG;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WAuJT,OAAO,IAA6B;;yBAXpB,GAAG;;;;;;EAgBhC;AA4BD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;cA7eN,OAAO;UAEX,QAAQ,GAAG,QAAQ;UAJnB,MAAM;YAuBJ,OAAO;cAjBL,OAAO;iBAEJ,OAAO;kBASN,OAAO;;;kBAwexB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/tooltip/vTooltip.d.ts

@@ -13,6 +13,21 @@ export interface TooltipOptions {
     openDelay?: number;
     /** Close delay in ms. Default: 0 */
     closeDelay?: number;
+    /**
+     * Only show the tooltip when text is actually truncated.
+     *
+     * - `true` — check the trigger element itself
+     *   (`el.scrollWidth > el.clientWidth`).
+     * - `string` — treat as a CSS selector on the trigger element and check
+     *   that descendant's overflow instead. Use this when the tooltip is on a
+     *   wrapper (so the hover area covers the whole row, including icons) but
+     *   only the label inside is what gets truncated.
+     * - `function` — custom predicate, called with the trigger element on
+     *   every hover/focus, returning `true` if the tooltip should show.
+     *
+     * Checked lazily — no `ResizeObserver` overhead. Default: false.
+     */
+    onlyOnOverflow?: boolean | string | ((triggerEl: HTMLElement) => boolean);
 }
 type OpenReason = 'hover' | 'focus';
 interface TooltipState {

package/dist/components/tooltip/vTooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/vTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,SAAS,EAAyB,MAAM,KAAK,CAAC;AAGrG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,0BAA0B,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpC,UAAU,YAAY;IACpB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,kGAAkG;IAClG,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;CACrC;AAMD;;;;;GAKG;AACH,KAAK,mBAAmB,GAAG,MAAM,GAAG,cAAc,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAoM9E,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AACD,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,WAAW,EAAE,mBAAmB,CA2GhE,CAAC"}
+{"version":3,"file":"vTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/vTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,SAAS,EAAyB,MAAM,KAAK,CAAC;AAGrG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,0BAA0B,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;CAC3E;AAED,KAAK,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpC,UAAU,YAAY;IACpB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,kGAAkG;IAClG,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;CACrC;AAMD;;;;;GAKG;AACH,KAAK,mBAAmB,GAAG,MAAM,GAAG,cAAc,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AA0N9E,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AACD,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,WAAW,EAAE,mBAAmB,CAkHhE,CAAC"}

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

@@ -0,0 +1,70 @@
+import { CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeNodeMoveEvent, CoarTreeNodeSlotProps, CoarTreeRenameEvent, 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 "onUpdate:expanded"?: ((value: Set<string>) => any) | undefined;
+        readonly "onUpdate:selected"?: ((value: string | null) => 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 "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"> & ({
+        expanded?: Set<string>;
+        selected?: string | null;
+    } & {
+        /** Fluent builder from `useTree()`. When set, the other config props are ignored. */
+        builder?: TreeBuilder<T>;
+        nodes?: readonly T[];
+        getId?: (node: T) => string;
+        getChildren?: (node: T) => readonly T[] | null | undefined;
+        getLabel?: (node: T) => string;
+        isExpandable?: (node: T) => boolean;
+        draggable?: boolean | ((node: T) => boolean);
+        canDrop?: (source: T, target: T | null, position: CoarTreeDropPosition) => boolean;
+        acceptsFiles?: boolean;
+        autoExpandDelay?: number;
+        virtualize?: CoarTreeVirtualizeProp;
+        /**
+         * Opt into the built-in inline rename UI. With this on, `api.startRename(id)`
+         * + `@rename` work and `<CoarTreeNodeLabel>` swaps to an `<input>` while the
+         * row is renaming. Without it the rename context isn't provided and the
+         * label component stays a plain `<span>` (back-compat for existing consumers).
+         */
+        renamable?: boolean;
+    }) & Partial<{}>> & import('vue').PublicProps;
+    expose(exposed: import('vue').ShallowUnwrapRef<{
+        focusNode(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,
+         * keyboard shortcuts, etc. The rename input mounts + auto-focuses on
+         * the next frame.
+         */
+        startRename: (id: string) => void;
+    }>): void;
+    attrs: any;
+    slots: Readonly<{
+        default(props: CoarTreeNodeSlotProps<T>): unknown;
+        empty(): unknown;
+    }> & {
+        default(props: CoarTreeNodeSlotProps<T>): unknown;
+        empty(): unknown;
+    };
+    emit: {
+        (e: "activate", node: 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));
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};
+//# sourceMappingURL=CoarTree.vue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoarTree.vue.d.ts","sourceRoot":"","sources":["../../../src/components/tree/CoarTree.vue"],"names":[],"mappings":"AA8gCA,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;WAulCO,mBAAmB,CAAC;;;;;;;;;;mBAzRf,GAAG,CAAC,MAAM,CAAC;mBACX,MAAM,GAAG,IAAI;;QA7zBtB,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;oBAkkCuE,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB;sBA3U/B,MAAM;QAGpB;;;;;WAKG;0BAxBoB,MAAM;MA2VsC,GAAG,IAAI;WACpE,GAAG;;uBAliCM,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO;iBACxC,OAAO;;uBADD,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO;iBACxC,OAAO;;UAmiCX;YA9iCD,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;2HAyiCM;EAEvC,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AAlmCzE,wBAkmC4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,51 @@
+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 "onChevron-click"?: ((node: T) => 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"> & {
+        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;
+    slots: {};
+    emit: {
+        (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: "chevron-click", node: T): void;
+        (e: "row-dragstart", node: T, ev: DragEvent): void;
+        (e: "row-dragend", node: T): void;
+        (e: "row-dragover", node: T, el: HTMLElement, ev: DragEvent): void;
+        (e: "row-dragleave", node: T, ev: DragEvent): void;
+        (e: "row-drop", node: T, el: HTMLElement, ev: DragEvent): void;
+    };
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};
+//# sourceMappingURL=CoarTreeNode.vue.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,9 @@
+type __VLS_Props = {
+    /** What to render when not renaming — typically the node's name. */
+    label: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    inputEl: HTMLInputElement;
+}, any>;
+export default _default;
+//# sourceMappingURL=CoarTreeNodeLabel.vue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoarTreeNodeLabel.vue.d.ts","sourceRoot":"","sources":["../../../src/components/tree/CoarTreeNodeLabel.vue"],"names":[],"mappings":"AAsHA,KAAK,WAAW,GAAG;IACjB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;;;;AAyGF,wBAOG"}

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

@@ -0,0 +1,8 @@
+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 { useTree } from './useTree';
+export { TreeBuilder } from './tree-builder';
+export type { TreeApi, TreeBuilderState } from './tree-builder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,124 @@
+import { MaybeRefOrGetter, Ref } from 'vue';
+import { CoarTreeDropPosition, CoarTreeFilesDropEvent, CoarTreeMenuEntry, CoarTreeNodeMoveEvent, 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
+ * the component to re-evaluate.
+ */
+export interface TreeBuilderState<T> {
+    nodes: MaybeRefOrGetter<readonly T[]>;
+    getId: (n: T) => string;
+    getChildren?: (n: T) => readonly T[] | null | undefined;
+    getLabel?: (n: T) => string;
+    isExpandable?: (n: T) => boolean;
+    draggable: MaybeRefOrGetter<boolean | ((n: T) => boolean)>;
+    canDrop?: (s: T, t: T | null, p: CoarTreeDropPosition) => boolean;
+    acceptsFiles: MaybeRefOrGetter<boolean>;
+    autoExpandDelay: MaybeRefOrGetter<number>;
+    virtualize: MaybeRefOrGetter<CoarTreeVirtualizeProp>;
+    expanded: Ref<Set<string>>;
+    selected: Ref<string | null>;
+    onActivate?: (node: T) => void;
+    onNodeMove?: (e: CoarTreeNodeMoveEvent<T>) => void;
+    onFilesDrop?: (e: CoarTreeFilesDropEvent<T>) => void;
+    /** Declarative menus — `<CoarTree>` renders the menu itself when these are set. */
+    folderMenu?: (folder: T) => readonly CoarTreeMenuEntry[];
+    leafMenu?: (leaf: T) => readonly CoarTreeMenuEntry[];
+    viewportMenu?: () => readonly CoarTreeMenuEntry[];
+    /** Event variants — escape hatch. If set, the declarative menu for the same target is bypassed. */
+    onFolderContextMenu?: (folder: T, ev: MouseEvent) => void;
+    onLeafContextMenu?: (leaf: T, ev: MouseEvent) => void;
+    onViewportContextMenu?: (ev: MouseEvent) => void;
+}
+/**
+ * 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`)
+ * mirror the builder state so consumers can `watch()` them without owning
+ * the writable refs themselves.
+ */
+export interface TreeApi {
+    /** Programmatically move focus + selection to a node. No-op until `<CoarTree>` is mounted. */
+    focusNode(id: string): void;
+    /** Selected node id (read-only). */
+    readonly selectedId: Ref<string | null>;
+    /** Currently expanded ids (read-only). */
+    readonly expandedIds: Ref<Set<string>>;
+}
+export declare class TreeBuilder<T> {
+    readonly state: TreeBuilderState<T>;
+    readonly api: TreeApi;
+    private _focusNodeImpl;
+    private constructor();
+    /** Factory — keeps construction sites consistent across call sites. */
+    static create<T>(): TreeBuilder<T>;
+    /** Root nodes. Accepts a `Ref`, getter, or plain array. */
+    nodes(source: MaybeRefOrGetter<readonly T[]>): this;
+    getId(fn: (n: T) => string): this;
+    getChildren(fn: (n: T) => readonly T[] | null | undefined): this;
+    /** Label extractor — used by type-ahead keyboard navigation. */
+    getLabel(fn: (n: T) => string): this;
+    /**
+     * Override the default "branch if `getChildren` returns an array" rule.
+     * Useful for lazy-loaded folders that should render as expandable even
+     * before their children are fetched.
+     */
+    isExpandable(fn: (n: T) => boolean): this;
+    /** Enable internal drag-to-reorder. Accepts a per-node predicate. */
+    draggable(d: MaybeRefOrGetter<boolean | ((n: T) => boolean)>): this;
+    canDrop(fn: (source: T, target: T | null, position: CoarTreeDropPosition) => boolean): this;
+    acceptsFiles(b: MaybeRefOrGetter<boolean>): this;
+    autoExpandDelay(ms: MaybeRefOrGetter<number>): this;
+    /**
+     * Enable virtualization. Pass `true` for defaults (itemSize: 28, overscan: 5)
+     * or an object for custom row height / overscan. Required for trees with
+     * hundreds+ of visible rows; pure overhead for small trees.
+     *
+     * When virtualized, the tree owns its scroll container — give it an explicit
+     * height (or put it in a sized flex/grid cell) so the viewport is measurable.
+     */
+    virtualize(v: MaybeRefOrGetter<CoarTreeVirtualizeProp>): 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>`. */
+    selected(r: Ref<string | null>): this;
+    /** Fires on double-click or Enter on the focused row. */
+    onActivate(h: (node: 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;
+    /**
+     * Items shown when right-clicking a folder row. When set (and the
+     * `onFolderContextMenu` escape hatch is NOT set), `<CoarTree>` renders a
+     * `<CoarContextMenu>` itself — no extra markup needed in your template.
+     *
+     * Pass an array of `{ label, icon?, danger?, disabled?, onClick }` entries
+     * or the literal string `'divider'`.
+     */
+    folderMenu(fn: (folder: T) => readonly CoarTreeMenuEntry[]): this;
+    /** Same as {@link folderMenu} but for leaf (non-folder) nodes. */
+    leafMenu(fn: (leaf: T) => readonly CoarTreeMenuEntry[]): this;
+    /**
+     * Items shown when right-clicking the empty background of the tree pane.
+     * No node argument — there isn't one.
+     */
+    viewportMenu(fn: () => readonly CoarTreeMenuEntry[]): this;
+    /**
+     * Raw `contextmenu` event for folder rows. Overrides {@link folderMenu} —
+     * use when you want a fully custom popover (e.g. with form inputs, async
+     * sub-menus, or a third-party menu library).
+     */
+    onFolderContextMenu(h: (folder: T, ev: MouseEvent) => void): this;
+    /** Same as {@link onFolderContextMenu} for leaf rows. Overrides {@link leafMenu}. */
+    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;
+}
+//# sourceMappingURL=tree-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.d.ts","sourceRoot":"","sources":["../../../src/components/tree/tree-builder.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+import { CoarTreeDropPosition } from './tree-types';
+/**
+ * Compute where a drop should land relative to a row given the cursor's Y
+ * position within that row's bounding box.
+ *
+ * Default thresholds:
+ * - Top 25% of the row → `'before'`
+ * - Bottom 25% of the row → `'after'`
+ * - Middle 50% → `'inside'` (only if the target is expandable; otherwise
+ *   clamped to whichever band is closer)
+ *
+ * For leaf nodes the `'inside'` band is suppressed because dropping into a
+ * leaf doesn't make sense. We split the row 50/50 between before/after in
+ * that case so the user never gets a "dead zone".
+ */
+export declare function computeDropPosition(event: {
+    clientY: number;
+}, rect: {
+    top: number;
+    height: number;
+}, opts: {
+    expandable: boolean;
+}): CoarTreeDropPosition;
+/**
+ * Detect whether a DataTransfer represents a drag of OS files (vs. an internal
+ * tree-node drag). `types` is the only DataTransfer field reliably readable
+ * during `dragover` — `getData()` returns an empty string on most browsers
+ * until `drop` for security reasons.
+ */
+export declare function isFileDrag(dt: DataTransfer | null): boolean;
+//# sourceMappingURL=tree-dnd.d.ts.map

package/dist/components/tree/tree-dnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-dnd.d.ts","sourceRoot":"","sources":["../../../src/components/tree/tree-dnd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAC1B,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACrC,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,GAC5B,oBAAoB,CAWtB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAE3D"}