@cocoar/vue-ui 1.10.0 → 1.12.0

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

@@ -0,0 +1,65 @@
+import { PropType, VNode } from 'vue';
+import { SidebarFlyoutParent } from './sidebar-context';
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /** DOM id for the panel — referenced by the trigger's `aria-controls`. */
+    id: {
+        type: StringConstructor;
+        required: true;
+    };
+    /** Group label — shown as the flyout header in labels mode. */
+    label: {
+        type: StringConstructor;
+        required: true;
+    };
+    /** Icon-only mode — flyout switches to a narrow icon-only layout. */
+    iconOnly: {
+        type: BooleanConstructor;
+        required: true;
+    };
+    /** Parent flyout's control passed through `SIDEBAR_FLYOUT_PARENT_KEY`. */
+    parentControl: {
+        type: PropType<SidebarFlyoutParent | null>;
+        default: null;
+    };
+    /** Render function returning the default-slot VNodes from the owning group's scope. */
+    renderContent: {
+        type: PropType<() => VNode[] | undefined>;
+        required: true;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    flyoutEnter: () => any;
+    flyoutLeave: () => any;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /** DOM id for the panel — referenced by the trigger's `aria-controls`. */
+    id: {
+        type: StringConstructor;
+        required: true;
+    };
+    /** Group label — shown as the flyout header in labels mode. */
+    label: {
+        type: StringConstructor;
+        required: true;
+    };
+    /** Icon-only mode — flyout switches to a narrow icon-only layout. */
+    iconOnly: {
+        type: BooleanConstructor;
+        required: true;
+    };
+    /** Parent flyout's control passed through `SIDEBAR_FLYOUT_PARENT_KEY`. */
+    parentControl: {
+        type: PropType<SidebarFlyoutParent | null>;
+        default: null;
+    };
+    /** Render function returning the default-slot VNodes from the owning group's scope. */
+    renderContent: {
+        type: PropType<() => VNode[] | undefined>;
+        required: true;
+    };
+}>> & Readonly<{
+    onFlyoutEnter?: (() => any) | undefined;
+    onFlyoutLeave?: (() => any) | undefined;
+}>, {
+    parentControl: SidebarFlyoutParent | null;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=CoarSidebarFlyoutPanel.vue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoarSidebarFlyoutPanel.vue.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/CoarSidebarFlyoutPanel.vue"],"names":[],"mappings":"AA0DA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,KAAK,CAAC;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;;IA0H3D,0EAA0E;;;;;IAE1E,+DAA+D;;;;;IAE/D,qEAAqE;;;;;IAErE,0EAA0E;;cACzC,QAAQ,CAAC,mBAAmB,GAAG,IAAI,CAAC;;;IACrE,uFAAuF;;cAEnE,QAAQ,CAAC,MAAM,KAAK,EAAE,GAAG,SAAS,CAAC;;;;;;;IAVvD,0EAA0E;;;;;IAE1E,+DAA+D;;;;;IAE/D,qEAAqE;;;;;IAErE,0EAA0E;;cACzC,QAAQ,CAAC,mBAAmB,GAAG,IAAI,CAAC;;;IACrE,uFAAuF;;cAEnE,QAAQ,CAAC,MAAM,KAAK,EAAE,GAAG,SAAS,CAAC;;;;;;;;;AAjBzD,wBAsBG"}

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

@@ -19,11 +19,9 @@ declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
         default?(_: {}): any;
-        default?(_: {}): any;
     };
     refs: {
         triggerRef: HTMLDivElement;
-        flyoutRef: HTMLDivElement;
     };
     rootEl: HTMLDivElement;
 };
@@ -40,7 +38,6 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     openOnHover: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     triggerRef: HTMLDivElement;
-    flyoutRef: HTMLDivElement;
 }, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

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":"AAwoBA,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;AAuMJ,KAAK,iBAAiB,GAAG;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WAwLT,OAAO,IAA6B;;yBAbpB,GAAG;yBACH,GAAG;;;;;;;EAiBhC;AAgCD,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":"AA4nBA,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;AAyMJ,KAAK,iBAAiB,GAAG;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WAwIT,OAAO,IAA6B;;yBAXpB,GAAG;;;;;;EAgBhC;AAwBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;cA7XN,OAAO;UAEX,QAAQ,GAAG,QAAQ;UAJnB,MAAM;cAMF,OAAO;iBAEJ,OAAO;;;kBAiYvB,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/switch/CoarSwitch.vue.d.ts

@@ -26,8 +26,8 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
-    label: string;
     error: boolean;
+    label: string;
     disabled: boolean;
     id: string;
     name: string;

package/dist/components/switch/CoarSwitch.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarSwitch.vue.d.ts","sourceRoot":"","sources":["../../../src/components/switch/CoarSwitch.vue"],"names":[],"mappings":"AAmSA,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACnC,wBAAwB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,WAAW,GAAG,eAAe,CAAC;AA8DnC,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,WAAW,CAAC;;;;;;WAjFN,MAAM;WAMN,OAAO;cAJJ,OAAO;QAUb,MAAM;UAEJ,MAAM;UANN,cAAc;cAJV,OAAO;mBAMF,QAAQ,GAAG,OAAO;;AAmLpC,wBASG"}
+{"version":3,"file":"CoarSwitch.vue.d.ts","sourceRoot":"","sources":["../../../src/components/switch/CoarSwitch.vue"],"names":[],"mappings":"AAmSA,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACnC,wBAAwB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,WAAW,GAAG,eAAe,CAAC;AA8DnC,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,WAAW,CAAC;;;;;;WA3EN,OAAO;WANP,MAAM;cAEH,OAAO;QAUb,MAAM;UAEJ,MAAM;UANN,cAAc;cAJV,OAAO;mBAMF,QAAQ,GAAG,OAAO;;AAmLpC,wBASG"}

package/dist/components/tooltip/CoarTooltipPanel.vue.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Panel rendered by the overlay-service when `vTooltip` opens. The service handles
+ * teleport, positioning, z-index stacking, and the fixed-positioning that used to live
+ * inline on the tooltip element. This component is a thin visual shell around the
+ * content text.
+ *
+ * `id` is passed in so the tooltip-describing trigger (`aria-describedby`) can reference
+ * it — the service-generated host id is not exposed.
+ */
+type __VLS_Props = {
+    content: string;
+    id?: 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, {}, HTMLDivElement>;
+export default _default;
+//# sourceMappingURL=CoarTooltipPanel.vue.d.ts.map

package/dist/components/tooltip/CoarTooltipPanel.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoarTooltipPanel.vue.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/CoarTooltipPanel.vue"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,KAAK,WAAW,GAAG;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;;AAiDF,wBAOG"}

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

@@ -1,4 +1,6 @@
 import { Directive } from 'vue';
+import { OverlayInstance } from '../overlay/overlay-service';
+import { OverlayRef } from '../overlay/overlay-types';
 export type TooltipPlacement = 'auto' | 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
 export interface TooltipOptions {
     /** Tooltip text content */
@@ -14,7 +16,7 @@ export interface TooltipOptions {
 }
 type OpenReason = 'hover' | 'focus';
 interface TooltipState {
-    tooltipEl: HTMLElement | null;
+    overlayRef: OverlayRef | null;
     openTimerId: number | null;
     closeTimerId: number | null;
     openReasons: Set<OpenReason>;
@@ -22,6 +24,8 @@ interface TooltipState {
     tooltipId: string;
     cleanup: (() => void) | null;
     opts: TooltipOptions;
+    /** Resolved at `mounted` from the host component's provides chain; `undefined` = root overlay. */
+    parentOverlay: OverlayInstance | undefined;
     onPointerDown: () => void;
     onMouseEnter: () => void;
     onMouseLeave: () => void;

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,KAAK,EAAE,SAAS,EAAoB,MAAM,KAAK,CAAC;AAIvD,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,SAAS,EAAE,WAAW,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,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;AAmND,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AACD,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAgGpE,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;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;AAuMD,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AACD,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CA2GpE,CAAC"}

package/dist/composables/dragRegistry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Module-level registry that carries live item references across HTML5 drag-and-drop
+ * events. Used by {@link useDragDrop} to exchange payloads between independent Vue
+ * components — the browser's `DataTransfer` API only accepts strings, so we serialize
+ * a drag id there and keep the actual payload (with object identity preserved) here.
+ *
+ * Exported for advanced integrations that want to implement their own drag handlers
+ * while staying compatible with {@link useDragDrop}'s matching rules.
+ */
+export declare const DRAG_MIME = "application/x-coar-dnd";
+export interface DragEntry<T = unknown> {
+    /** Random drag-session id (stored in DataTransfer as a string). */
+    id: string;
+    /** Stable id of the source surface — used to detect self-drops. */
+    sourceId: string;
+    /** Public identifier the consumer gave the source via `dragId`, if any. */
+    fromId: string | null;
+    /** Optional drag group name. Only surfaces sharing a group accept each other's items. */
+    dragGroup: string | null;
+    /** The actual items being dragged. */
+    items: readonly T[];
+    /**
+     * Invoked by the drop target when it accepts the drop. The source uses this to
+     * emit its "items-removed" callback synchronously — avoiding the brief "duplicated
+     * items" window between `drop` on the target and `dragend` on the source.
+     */
+    onAcceptedBy?: (targetId: string, insertIndex: number | null) => void;
+    /** Flag set by a target on accept so the source's `dragend` can report `dropped: true`. */
+    consumed?: boolean;
+}
+export declare function registerDrag<T>(entry: DragEntry<T>): void;
+export declare function getDrag<T>(id: string): DragEntry<T> | undefined;
+/**
+ * Returns the drag session currently in flight — readable during `dragover`
+ * events, where the browser refuses to expose `DataTransfer.getData()`.
+ */
+export declare function getActiveDrag<T>(): DragEntry<T> | undefined;
+export declare function deleteDrag(id: string): void;
+//# sourceMappingURL=dragRegistry.d.ts.map

package/dist/composables/dragRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dragRegistry.d.ts","sourceRoot":"","sources":["../../src/composables/dragRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,SAAS,2BAA2B,CAAC;AAElD,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yFAAyF;IACzF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sCAAsC;IACtC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAGzD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAE/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAE3D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG3C"}

package/dist/composables/index.d.ts

@@ -0,0 +1,7 @@
+export { useVirtualList } from './useVirtualList';
+export type { UseVirtualListOptions, UseVirtualListReturn, VirtualRow, } from './useVirtualList';
+export { useDragDrop } from './useDragDrop';
+export type { UseDragDropOptions, UseDragDropReturn, DropPayload, } from './useDragDrop';
+export { DRAG_MIME, registerDrag, getDrag, getActiveDrag, deleteDrag, } from './dragRegistry';
+export type { DragEntry } from './dragRegistry';
+//# sourceMappingURL=index.d.ts.map

package/dist/composables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,OAAO,EACP,aAAa,EACb,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/composables/useDragDrop.d.ts

@@ -0,0 +1,109 @@
+import { MaybeRefOrGetter, Ref } from 'vue';
+/** Payload surfaced to `canDrop` checks and the `onDropAccept` callback. */
+export interface DropPayload<T> {
+    /** The items being dropped. */
+    items: readonly T[];
+    /** Public identifier of the source surface, if it set `dragId`. */
+    fromId: string | null;
+    /** Drag group of the source surface. */
+    fromGroup: string | null;
+    /** True when the source and target are the same surface (drag within one list). */
+    fromSelf: boolean;
+}
+export interface UseDragDropOptions<T> {
+    /** Public identifier for this surface. Auto-generated per instance if not set. */
+    dragId?: MaybeRefOrGetter<string | undefined>;
+    /**
+     * Shared name linking compatible surfaces. Items can only cross between surfaces
+     * with the same `dragGroup`. A surface without a group still accepts self-drops.
+     */
+    dragGroup?: MaybeRefOrGetter<string | undefined>;
+    /**
+     * Whitelist of source `dragId`s this surface accepts items from. When set, drops
+     * are only accepted if the source's `dragId` is listed. Unset = accept from any
+     * surface in the same `dragGroup`.
+     */
+    dragAccept?: MaybeRefOrGetter<string[] | undefined>;
+    /**
+     * Runtime target validation. Called on `dragover` and `drop`. Return `false`
+     * to refuse the drop — the cursor shows "not allowed" and nothing happens.
+     */
+    canDrop?: (payload: DropPayload<T>) => boolean;
+    /** Fired after `startDrag` succeeds. */
+    onDragStart?: (items: readonly T[]) => void;
+    /**
+     * Fired on `dragend` (whether the drop was accepted or cancelled). `dropped` is
+     * `true` when some target consumed the payload.
+     */
+    onDragEnd?: (payload: {
+        items: readonly T[];
+        dropped: boolean;
+    }) => void;
+    /**
+     * Fired on this surface when it accepts a drop. Consumers update their own
+     * source-of-truth here (append items, insert at `insertIndex`, etc.).
+     */
+    onDropAccept?: (payload: DropPayload<T> & {
+        insertIndex: number | null;
+    }) => void;
+    /**
+     * Fired on the *source* surface when another target consumed its payload.
+     * Consumers update their own source-of-truth here (remove the items).
+     * Fires synchronously inside the target's `drop`, before the source's `dragend`.
+     */
+    onItemsRemove?: (payload: {
+        items: readonly T[];
+        toGroup: string | null;
+    }) => void;
+}
+export interface UseDragDropReturn<T> {
+    /** Stable instance id — use it when you need to distinguish surfaces externally. */
+    instanceId: string;
+    /** `true` while a compatible drag is hovering this surface (clears on leave/drop). */
+    isDragOver: Ref<boolean>;
+    /** `true` while this surface is the source of an in-flight drag. */
+    isDragging: Ref<boolean>;
+    /**
+     * Call from a `@dragstart` handler on a draggable element. Pass the payload you
+     * want to transfer. Returns `true` if the drag was registered, `false` if the
+     * event had no `dataTransfer` or items was empty.
+     */
+    startDrag(event: DragEvent, items: readonly T[]): boolean;
+    /** Call from a `@dragend` handler on the draggable element. Cleans up the session. */
+    endDrag(): void;
+    /** Call from the drop container's `@dragover`. */
+    onDragOver(event: DragEvent): void;
+    /** Call from the drop container's `@dragleave`. */
+    onDragLeave(event: DragEvent): void;
+    /**
+     * Call from the drop container's (or an inner drop target's) `@drop`. Pass an
+     * optional `insertIndex` to tell consumers where the drop landed (null = append).
+     */
+    onDrop(event: DragEvent, context?: {
+        insertIndex?: number | null;
+    }): void;
+}
+/**
+ * Framework-agnostic HTML5 drag-and-drop primitive used across Cocoar UI
+ * components. Decouples "what is being dragged" (your items) from the
+ * registration bookkeeping (group matching, whitelists, runtime validation,
+ * source-side cleanup).
+ *
+ * Usage:
+ * ```ts
+ * const dnd = useDragDrop<Row>({
+ *   dragGroup: 'rows',
+ *   onDropAccept: ({ items }) => { rows.value = [...rows.value, ...items] },
+ *   onItemsRemove: ({ items }) => {
+ *     const keep = new Set(rows.value); items.forEach(i => keep.delete(i));
+ *     rows.value = [...keep];
+ *   },
+ * })
+ *
+ * // In template:
+ * // <div draggable @dragstart="dnd.startDrag($event, [row])" @dragend="dnd.endDrag">
+ * // <div @dragover="dnd.onDragOver" @dragleave="dnd.onDragLeave" @drop="dnd.onDrop">
+ * ```
+ */
+export declare function useDragDrop<T>(opts?: UseDragDropOptions<T>): UseDragDropReturn<T>;
+//# sourceMappingURL=useDragDrop.d.ts.map

package/dist/composables/useDragDrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDragDrop.d.ts","sourceRoot":"","sources":["../../src/composables/useDragDrop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAUpE,4EAA4E;AAC5E,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,+BAA+B;IAC/B,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wCAAwC;IACxC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,kFAAkF;IAClF,MAAM,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAEpD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IAE/C,wCAAwC;IACxC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC;IAC5C;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACzE;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IAClF;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,oEAAoE;IACpE,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAGzB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC;IAC1D,sFAAsF;IACtF,OAAO,IAAI,IAAI,CAAC;IAGhB,kDAAkD;IAClD,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,mDAAmD;IACnD,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E;AAOD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CA6HrF"}

package/dist/composables/useVirtualList.d.ts

@@ -0,0 +1,52 @@
+import { MaybeRefOrGetter, Ref, ComputedRef } from 'vue';
+/** Options for {@link useVirtualList}. */
+export interface UseVirtualListOptions {
+    /** Total number of items in the virtual list. */
+    count: MaybeRefOrGetter<number>;
+    /**
+     * Row height in pixels — either a fixed number, or a function that returns
+     * the height for a given index. Reactive: if you pass a ref, changes invalidate
+     * the offset cache automatically.
+     */
+    itemSize: MaybeRefOrGetter<number | ((index: number) => number)>;
+    /** Rows rendered above/below the viewport as a scroll buffer. Default 5. */
+    overscan?: MaybeRefOrGetter<number>;
+    /** The scrollable element — typically a template ref on the scrolling container. */
+    scrollElement: Ref<HTMLElement | null>;
+}
+/** One positioned row produced by the virtualizer. */
+export interface VirtualRow {
+    /** Position in the underlying list (0 .. count - 1). */
+    index: number;
+    /** Pixel offset from the top of the spacer. */
+    start: number;
+    /** Row height in pixels. */
+    size: number;
+}
+export interface UseVirtualListReturn {
+    /** Slice of rows currently inside the viewport + overscan window. */
+    virtualRows: ComputedRef<VirtualRow[]>;
+    /** Total pixel height of the full list — use this for the scroll spacer. */
+    totalSize: ComputedRef<number>;
+    /** Programmatically scroll an index into view. */
+    scrollToIndex(index: number, align?: 'auto' | 'start' | 'center' | 'end'): void;
+    /** Inspect the precomputed offset for an index (debug/tests). */
+    offsetFor(index: number): number;
+}
+/**
+ * Minimal fixed-viewport virtualizer. Keeps a cumulative offset table so both
+ * fixed and per-index heights are O(log n) per scroll event, without any
+ * external dependencies.
+ *
+ * Usage:
+ * ```ts
+ * const scrollEl = useTemplateRef('scroll')
+ * const { virtualRows, totalSize, scrollToIndex } = useVirtualList({
+ *   count: () => items.length,
+ *   itemSize: 32,
+ *   scrollElement: scrollEl,
+ * })
+ * ```
+ */
+export declare function useVirtualList(opts: UseVirtualListOptions): UseVirtualListReturn;
+//# sourceMappingURL=useVirtualList.d.ts.map

package/dist/composables/useVirtualList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualList.d.ts","sourceRoot":"","sources":["../../src/composables/useVirtualList.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACR,KAAK,WAAW,EACjB,MAAM,KAAK,CAAC;AAEb,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC;;;;OAIG;IACH,QAAQ,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC;IACjE,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACpC,oFAAoF;IACpF,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACxC;AAED,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,4EAA4E;IAC5E,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,kDAAkD;IAClD,aAAa,CACX,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAC1C,IAAI,CAAC;IACR,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CA0KhF"}