@cocoar/vue-ui 3.1.0 → 3.2.0-beta.6

package/dist/components/data-list/internal/reorder-core.d.ts

@@ -0,0 +1,46 @@
+import { CoarDataListDropTarget, CoarDataListKey, CoarDataListLayout } from '../types';
+/**
+ * Drop position relative to the item under the pointer: split vertically in the
+ * list layout, horizontally between tiles in the grid layout. With `nestable`,
+ * the middle half of a list row means "drop inside" (make the item the parent).
+ */
+export declare function computeDropTarget(layout: CoarDataListLayout, rect: {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}, point: {
+    x: number;
+    y: number;
+}, key: CoarDataListKey, options?: {
+    nestable?: boolean;
+}): CoarDataListDropTarget;
+export interface Insertion {
+    toIndex: number;
+    afterKey: CoarDataListKey | null;
+    beforeKey: CoarDataListKey | null;
+}
+/**
+ * Translates a drop target into an insertion point among `siblingKeys` (the
+ * visible items that share the destination parent) with the dragged keys
+ * removed. Pass `null` as target to append. Returns `null` when the drop would
+ * change nothing (target is a dragged item, or the block would land where it
+ * already is).
+ */
+export declare function resolveInsertion(siblingKeys: readonly CoarDataListKey[], draggedKeys: ReadonlySet<CoarDataListKey>, target: {
+    key: CoarDataListKey;
+    position: 'before' | 'after';
+} | null, options: {
+    fromSelf: boolean;
+    sameParent: boolean;
+}): Insertion | null;
+/** Distance from the viewport edges at which dragging starts auto-scrolling. */
+export declare const AUTOSCROLL_EDGE = 28;
+/** Scroll step per frame while the pointer sits inside the edge zone. */
+export declare function autoscrollDelta(clientY: number, rect: {
+    top: number;
+    bottom: number;
+}): number;
+/** `true` when a DataTransfer carries OS files (the only thing readable during dragover). */
+export declare function isFileDrag(dt: DataTransfer | null): boolean;
+//# sourceMappingURL=reorder-core.d.ts.map

package/dist/components/data-list/internal/reorder-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder-core.d.ts","sourceRoot":"","sources":["../../../../src/components/data-list/internal/reorder-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAClE,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,GAAG,EAAE,eAAe,EACpB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,sBAAsB,CAcxB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,SAAS,eAAe,EAAE,EACvC,WAAW,EAAE,WAAW,CAAC,eAAe,CAAC,EACzC,MAAM,EAAE;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,GAAG,IAAI,EACrE,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAClD,SAAS,GAAG,IAAI,CAwBlB;AAED,gFAAgF;AAChF,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAI9F;AAED,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAE3D"}

package/dist/components/data-list/internal/search.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lower-cases and strips diacritics so "Café" matches "cafe" and "CAFÉ" alike.
+ */
+export declare function normalizeSearchText(text: string): string;
+/** Splits a query into normalized, non-empty terms. */
+export declare function searchTerms(query: string | undefined | null): string[];
+/** Every term must occur somewhere in the (already normalized) haystack. */
+export declare function matchesSearchTerms(normalizedHaystack: string, terms: readonly string[]): boolean;
+/**
+ * Default searchable text of an item: its own string, number and boolean
+ * properties joined with spaces. Nested objects and functions are skipped.
+ */
+export declare function defaultSearchText(item: unknown): string;
+/** Builds the searchable text for an item from a field list or extractor. */
+export declare function searchTextOf<T>(item: T, searchBy: ReadonlyArray<keyof T & string> | ((item: T) => string) | undefined): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/components/data-list/internal/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/components/data-list/internal/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,EAAE,CAGtE;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAKhG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAUvD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,SAAS,GAC5E,MAAM,CAWR"}

package/dist/components/data-list/internal/useDataListLines.d.ts

@@ -0,0 +1,92 @@
+import { ComputedRef, Ref } from 'vue';
+import { CoarDataListEntry, CoarDataListKey, CoarDataListLayout } from '../types';
+type ItemEntry<T> = Extract<CoarDataListEntry<T>, {
+    kind: 'item';
+}>;
+type GroupEntry<T> = Extract<CoarDataListEntry<T>, {
+    kind: 'group';
+}>;
+/**
+ * Where a line sits when it belongs to the children of an expanded grid tile:
+ * the band under that tile's row. `parentColumn` / `columns` describe the
+ * parent's position in its row so the frame can open exactly under it.
+ */
+export interface CoarDataListBand {
+    parentKey: CoarDataListKey;
+    parentColumn: number;
+    parentColumns: number;
+    /** 1 for a band under a top-level row, 2 for a band inside that band, … */
+    level: number;
+    first: boolean;
+    last: boolean;
+}
+/**
+ * One virtualized row. `items` lines hold one entry in list layout, up to
+ * `columns` entries in grid layout — always in data order. Lines carry the
+ * layout of their level, so a list may nest grid children and vice versa.
+ */
+export type CoarDataListLine<T> = {
+    kind: 'group';
+    key: string;
+    entry: GroupEntry<T>;
+    depth: 0;
+    band?: CoarDataListBand;
+} | {
+    kind: 'items';
+    key: string;
+    entries: ItemEntry<T>[];
+    depth: number;
+    layout: CoarDataListLayout;
+    columns: number;
+    /** Set on the row that has a band directly under it (its bottom gap is removed). */
+    opensBand: boolean;
+    band?: CoarDataListBand;
+};
+export interface UseDataListLinesOptions<T> {
+    entries: Ref<readonly CoarDataListEntry<T>[]>;
+    layout: () => CoarDataListLayout;
+    tileMinWidth: () => number | string;
+    /** Layout / tile width of the child levels; `undefined` = inherit. */
+    childLayout: () => CoarDataListLayout | undefined;
+    childTileMinWidth: () => number | string | undefined;
+    gap: () => number | string | undefined;
+    /** Horizontal inset of a band (px) — bands are narrower than their parent row. */
+    bandInset: () => number;
+    /** The scroll container — its width decides the column count. */
+    viewport: Ref<HTMLElement | null>;
+    /** Invisible element styled with `width: tileMinWidth; padding-left: gap`, used to resolve CSS lengths to px. */
+    probe: Ref<HTMLElement | null>;
+    /** Same for the child levels' tile width. */
+    childProbe: Ref<HTMLElement | null>;
+}
+/** A band's extent in lines — one frame is drawn per band, not per line. */
+export interface CoarDataListBandRange {
+    parentKey: CoarDataListKey;
+    level: number;
+    firstLine: number;
+    lastLine: number;
+}
+export interface UseDataListLinesReturn<T> {
+    lines: ComputedRef<CoarDataListLine<T>[]>;
+    bands: ComputedRef<CoarDataListBandRange[]>;
+    /** Tiles per row on the top level (1 in list layout). */
+    columns: ComputedRef<number>;
+    lineIndexOfKey(key: CoarDataListKey): number;
+    /** Visual position of an item: its line and its column inside that line. */
+    positionOfKey(key: CoarDataListKey): {
+        line: number;
+        column: number;
+    } | null;
+    /** Re-read viewport and probe sizes (e.g. after a layout change the observer cannot see). */
+    remeasure(): void;
+}
+/**
+ * Chunks the model's entries into virtualizable lines and derives the grid
+ * column count from the viewport width. Group headings always take a full
+ * line. Children of an expanded parent follow the parent row directly in list
+ * layout; in grid layout they form a band under the parent's *row*, so tiles
+ * never move horizontally when something expands.
+ */
+export declare function useDataListLines<T>(options: UseDataListLinesOptions<T>): UseDataListLinesReturn<T>;
+export {};
+//# sourceMappingURL=useDataListLines.d.ts.map

package/dist/components/data-list/internal/useDataListLines.d.ts.map

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

package/dist/components/data-list/internal/useDataListReorder.d.ts

@@ -0,0 +1,68 @@
+import { Ref } from 'vue';
+import { DropPayload } from '../../../composables/useDragDrop';
+import { CoarDataListDragEngine, CoarDataListDropEvent, CoarDataListDropTarget, CoarDataListFilesDropEvent, CoarDataListItemsRemoveEvent, CoarDataListKey, CoarDataListLayout } from '../types';
+export interface UseDataListReorderOptions<T> {
+    viewport: Ref<HTMLElement | null>;
+    /** Reordering / accepting drops is on and the list is not disabled. */
+    enabled: () => boolean;
+    /**
+     * Whether the sibling level under `parentKey` (`null` = top level) is sorted.
+     * A sorted level takes no positional drops — its order is the sort's business.
+     */
+    sortedAt: (parentKey: CoarDataListKey | null) => boolean;
+    engine: () => CoarDataListDragEngine;
+    layout: () => CoarDataListLayout;
+    visibleItems: () => readonly T[];
+    keyOf: (item: T) => CoarDataListKey;
+    itemByKey: (key: CoarDataListKey) => T | undefined;
+    isSelected: (key: CoarDataListKey) => boolean;
+    canDrag: () => ((item: T) => boolean) | undefined;
+    dragGroup: () => string | undefined;
+    dragId: () => string | undefined;
+    dragAccept: () => string[] | undefined;
+    canDrop: () => ((payload: DropPayload<T>) => boolean) | undefined;
+    groupOf: (item: T) => string | null;
+    /** Visible parent key of a visible item (`null` at the top level). */
+    parentOf: (key: CoarDataListKey) => CoarDataListKey | null;
+    /** Visible items sharing `parentKey` (`null` = top level), in display order. */
+    siblingsOf: (parentKey: CoarDataListKey | null) => readonly T[];
+    /** The list nests and dropping inside `item` is allowed for the dragged items. */
+    canNestInto: (parent: T, items: readonly T[]) => boolean;
+    /** Ancestor check to refuse dropping a parent into its own subtree. */
+    isDescendantOf: (key: CoarDataListKey, ancestorKey: CoarDataListKey) => boolean;
+    acceptsFiles: () => boolean;
+    focusedKey: Ref<CoarDataListKey | null>;
+    scrollToKey: (key: CoarDataListKey) => void;
+    onReorder: (event: CoarDataListDropEvent<T>) => void;
+    onItemsAdd: (event: CoarDataListDropEvent<T>) => void;
+    onItemsRemove: (event: CoarDataListItemsRemoveEvent<T>) => void;
+    onFilesDrop: (event: CoarDataListFilesDropEvent<T>) => void;
+    onDragStart: (items: readonly T[]) => void;
+    onDragEnd: (payload: {
+        items: readonly T[];
+        dropped: boolean;
+    }) => void;
+}
+/**
+ * Reordering for `<CoarDataList>`: the list-specific parts (hit testing on rows,
+ * insertion maths, keyboard grab mode, file drops) on top of the shared
+ * `useDragDrop` engines (native HTML5 or pointer events).
+ */
+export declare function useDataListReorder<T>(options: UseDataListReorderOptions<T>): {
+    engine: import('vue').ComputedRef<"native" | "pointer">;
+    dragging: import('vue').ComputedRef<boolean>;
+    grabbed: Ref<boolean, boolean>;
+    dragKeys: import('vue').ShallowRef<Set<CoarDataListKey>, Set<CoarDataListKey>>;
+    dropTarget: import('vue').ShallowRef<CoarDataListDropTarget | null, CoarDataListDropTarget | null>;
+    isDragOver: import('vue').ComputedRef<boolean>;
+    nativeDraggable: import('vue').ComputedRef<boolean>;
+    isDragged: (key: CoarDataListKey) => boolean;
+    onItemDragStart: (event: DragEvent, item: T) => void;
+    onItemDragEnd: () => void;
+    onItemPointerDown: (event: PointerEvent, item: T) => void;
+    onViewportDragOver: (event: DragEvent) => void;
+    onViewportDragLeave: (event: DragEvent) => void;
+    onViewportDrop: (event: DragEvent) => void;
+    onKeyDown: (event: KeyboardEvent) => boolean;
+};
+//# sourceMappingURL=useDataListReorder.d.ts.map

package/dist/components/data-list/internal/useDataListReorder.d.ts.map

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

package/dist/components/data-list/internal/useSearchHighlight.d.ts

@@ -0,0 +1,19 @@
+import { MaybeRefOrGetter, Ref, WatchSource } from 'vue';
+/** Name of the shared CSS highlight — style it with `::highlight(coar-data-list-search)`. */
+export declare const DATA_LIST_HIGHLIGHT_NAME = "coar-data-list-search";
+export interface UseSearchHighlightOptions {
+    /** Element whose rendered text is scanned. */
+    root: Ref<HTMLElement | null>;
+    /** Raw query; split into lower-cased whitespace-separated terms. */
+    query: MaybeRefOrGetter<string>;
+    enabled: MaybeRefOrGetter<boolean>;
+    /** Extra sources that mean "the DOM under root changed" (e.g. the virtual window). */
+    triggers?: WatchSource[];
+}
+/**
+ * Marks search matches inside `root` with the CSS Custom Highlight API. Browsers
+ * without the API simply show no highlight. Matching is case-insensitive on the
+ * rendered text; diacritics are not folded here.
+ */
+export declare function useSearchHighlight(options: UseSearchHighlightOptions): void;
+//# sourceMappingURL=useSearchHighlight.d.ts.map

package/dist/components/data-list/internal/useSearchHighlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSearchHighlight.d.ts","sourceRoot":"","sources":["../../../../src/components/data-list/internal/useSearchHighlight.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACR,KAAK,WAAW,EACjB,MAAM,KAAK,CAAC;AAEb,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AA8ChE,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,IAAI,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9B,oEAAoE;IACpE,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAuC3E"}

package/dist/components/data-list/types.d.ts

@@ -0,0 +1,185 @@
+import { DragEngine } from '../../composables/useDragDrop';
+/** Identity of a list item — what `itemKey` returns. */
+export type CoarDataListKey = string | number;
+export type CoarDataListSortDirection = 'asc' | 'desc';
+/** Active sort state (`v-model:sort`). `null` keeps the input order. */
+export interface CoarDataListSort {
+    /** `key` of the chosen {@link CoarDataListSortOption}. */
+    key: string;
+    direction: CoarDataListSortDirection;
+}
+/** One entry of the sort menu. */
+export interface CoarDataListSortOption<T> {
+    /** Stable identifier, also used as the default property name when `by` is omitted. */
+    key: string;
+    /** Menu label. */
+    label: string;
+    /**
+     * Extracts the value to compare. Values are compared locale-aware (numeric strings,
+     * diacritics), numbers numerically, dates chronologically; `null`/`undefined` sort last.
+     * Default: `item[key]`.
+     */
+    by?: (item: T) => unknown;
+    /** Full custom comparator for ascending order. Wins over `by`. */
+    compare?: (a: T, b: T) => number;
+    /** Direction applied when this option is chosen. Default `'asc'`. */
+    defaultDirection?: CoarDataListSortDirection;
+}
+/**
+ * Which text the search matches against: a list of property names (joined), or a
+ * function returning the searchable string. Default: every own string, number and
+ * boolean property of the item.
+ */
+export type CoarDataListSearchBy<T> = ReadonlyArray<keyof T & string> | ((item: T) => string);
+export type CoarDataListSelectionMode = 'none' | 'single' | 'multiple';
+/** Order of groups when `groupBy` is used. Default `'asc'`. */
+export type CoarDataListSortGroups = 'asc' | 'desc' | 'none' | ((a: string, b: string) => number);
+export type CoarDataListDensity = 's' | 'm' | 'l';
+/**
+ * `'list'`: one record per row. `'grid'`: records flow into tiles, as many per
+ * row as fit `tileMinWidth`. Both keep the exact data order — a tile grid is a
+ * list that wraps.
+ */
+export type CoarDataListLayout = 'list' | 'grid';
+/** How nested levels are drawn: guide lines per depth, or indentation only. */
+export type CoarDataListNestingStyle = 'lines' | 'none';
+/**
+ * Per-level configuration for nested lists. The top level is the list itself;
+ * every child level may override how its items are sorted. (Layout per level
+ * is planned — mixed list/grid nesting — and will live here too.)
+ */
+export interface CoarDataListLevelConfig<T> {
+    sortOptions?: readonly CoarDataListSortOption<T>[];
+    sort?: CoarDataListSort | null;
+    /** Layout of the child levels. Default: the list's own layout. */
+    layout?: CoarDataListLayout;
+    /** Minimum tile width when the child levels use the grid layout. Default: the list's `tileMinWidth`. */
+    tileMinWidth?: number | string;
+}
+/** A visible row — either an item or the heading of a group. */
+export type CoarDataListEntry<T> = {
+    kind: 'item';
+    /** Unique row key (`i:` + item key). */
+    key: string;
+    itemKey: CoarDataListKey;
+    item: T;
+    /** Position among the visible items (group headings excluded). */
+    index: number;
+    /** Nesting depth, 0 for top-level items. */
+    depth: number;
+    /** Key of the parent item, `null` at the top level. */
+    parentKey: CoarDataListKey | null;
+    /** The item has children (whether or not they are shown). */
+    hasChildren: boolean;
+    /** Children are currently shown. */
+    expanded: boolean;
+} | {
+    kind: 'group';
+    key: string;
+    group: string;
+    count: number;
+    items: T[];
+};
+export interface CoarDataListItemSlotProps<T> {
+    item: T;
+    /** Position among the visible items. */
+    index: number;
+    itemKey: CoarDataListKey;
+    selected: boolean;
+    focused: boolean;
+    /** Part of an in-flight drag (pointer or keyboard). */
+    dragging: boolean;
+    /** Nesting depth, 0 at the top level. */
+    depth: number;
+    hasChildren: boolean;
+    expanded: boolean;
+    /** Select only this item. */
+    select(): void;
+    /** Toggle this item's selection (multiple) or select/clear it (single). */
+    toggle(): void;
+    /** Show / hide this item's children. */
+    toggleExpanded(): void;
+}
+export interface CoarDataListGroupSlotProps<T> {
+    group: string;
+    count: number;
+    items: T[];
+}
+export interface CoarDataListItemEvent<T> {
+    item: T;
+    itemKey: CoarDataListKey;
+    index: number;
+    event: MouseEvent | KeyboardEvent;
+}
+/** Drag engine — see `DragEngine` in `useDragDrop`. Accepting OS files works with either. */
+export type CoarDataListDragEngine = DragEngine;
+/** `'inside'` makes the target the new parent (nested lists only). */
+export type CoarDataListDropPosition = 'before' | 'after' | 'inside';
+/** Where a drag would land, relative to a visible item. */
+export interface CoarDataListDropTarget {
+    key: CoarDataListKey;
+    position: CoarDataListDropPosition;
+}
+/**
+ * Payload of `reorder` (drop inside the same list) and `items-add` (drop from
+ * another list). The list never mutates its data — apply the change to your
+ * source. `afterKey` / `beforeKey` name the visible neighbours of the insertion
+ * point (dragged items excluded), which stays correct while a search hides rows.
+ */
+export interface CoarDataListDropEvent<T> {
+    items: T[];
+    keys: CoarDataListKey[];
+    /** Index among the visible siblings of the insertion point, dragged items excluded. */
+    toIndex: number;
+    afterKey: CoarDataListKey | null;
+    beforeKey: CoarDataListKey | null;
+    /** `groupBy` value at the insertion point, or `null` without grouping / at the end. */
+    group: string | null;
+    /** Parent of the insertion point in nested lists (`null` = top level). */
+    parentKey: CoarDataListKey | null;
+    fromSelf: boolean;
+    /** `dragId` of the source list, if it set one. */
+    sourceId: string | null;
+    sourceDragGroup: string | null;
+}
+export interface CoarDataListItemsRemoveEvent<T> {
+    items: T[];
+    keys: CoarDataListKey[];
+    /** `dragGroup` of the list that accepted the items. */
+    toDragGroup: string | null;
+}
+export interface CoarDataListFilesDropEvent<T> {
+    files: File[];
+    /** The item under the pointer, or `null` on empty space. */
+    item: T | null;
+    event: DragEvent;
+}
+/** One entry of a declarative context menu (`builder.itemMenu` / `builder.viewportMenu`). */
+export interface CoarDataListMenuItem {
+    label: string;
+    /** Icon name passed to `<CoarMenuItem :icon>`. */
+    icon?: string;
+    /** Destructive action styling. */
+    danger?: boolean;
+    disabled?: boolean;
+    /** Invoked on click; the list closes the menu afterwards. */
+    onClick: () => void;
+}
+export type CoarDataListMenuEntry = CoarDataListMenuItem | 'divider';
+/** Selection API shared by the composable and the component. */
+export interface CoarDataListSelection<T> {
+    isSelected(key: CoarDataListKey): boolean;
+    /**
+     * Change the selection relative to `key`.
+     * - `replace` (default): only this item
+     * - `toggle`: add/remove it (in single mode: select or clear)
+     * - `range`: from the anchor to this item (multiple mode only)
+     */
+    select(key: CoarDataListKey, mode?: 'replace' | 'toggle' | 'range'): void;
+    /** Select every visible item (multiple mode). */
+    selectAll(): void;
+    clear(): void;
+    /** The currently selected items, in visible order (filtered-out items are kept). */
+    selectedItems: import('vue').ComputedRef<T[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/data-list/types.d.ts.map

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

package/dist/components/data-list/useDataListModel.d.ts

@@ -0,0 +1,79 @@
+import { ComputedRef, MaybeRef, MaybeRefOrGetter, Ref } from 'vue';
+import { CoarDataListEntry, CoarDataListKey, CoarDataListLevelConfig, CoarDataListSearchBy, CoarDataListSelection, CoarDataListSelectionMode, CoarDataListSort, CoarDataListSortGroups, CoarDataListSortOption } from './types';
+type ItemEntry<T> = Extract<CoarDataListEntry<T>, {
+    kind: 'item';
+}>;
+export interface UseDataListModelOptions<T> {
+    items: MaybeRefOrGetter<readonly T[]>;
+    /** Stable identity of an item. Selection and measured heights are stored under it. */
+    itemKey: (item: T) => CoarDataListKey;
+    /** Free-text query. Whitespace splits it into terms that must all match. */
+    search?: MaybeRefOrGetter<string | undefined>;
+    /** Plain value or ref (not a getter — a function here is the extractor itself). */
+    searchBy?: MaybeRef<CoarDataListSearchBy<T> | undefined>;
+    /** Additional predicate applied before the search. Plain function or ref. */
+    filter?: MaybeRef<((item: T) => boolean) | undefined>;
+    sort?: MaybeRefOrGetter<CoarDataListSort | null | undefined>;
+    sortOptions?: MaybeRefOrGetter<readonly CoarDataListSortOption<T>[] | undefined>;
+    /** Plain function or ref. */
+    groupBy?: MaybeRef<((item: T) => string) | undefined>;
+    sortGroups?: MaybeRef<CoarDataListSortGroups | undefined>;
+    /** BCP 47 tag for collation. Default: the runtime locale. */
+    locale?: MaybeRefOrGetter<string | undefined>;
+    selectionMode?: MaybeRefOrGetter<CoarDataListSelectionMode>;
+    /** External selection model. When omitted the composable keeps its own. */
+    selected?: Ref<CoarDataListKey[]>;
+    /** Nested lists: returns an item's children (plain function or ref). */
+    children?: MaybeRef<((item: T) => readonly T[] | null | undefined) | undefined>;
+    /** Keys of the items whose children are shown. When omitted the composable keeps its own. */
+    expanded?: Ref<CoarDataListKey[]>;
+    /** Configuration of the child levels (all levels below the top share it). */
+    childLevel?: MaybeRefOrGetter<CoarDataListLevelConfig<T> | undefined>;
+    /** Deepest level shown, 0 = top level only. Default: unlimited. */
+    maxDepth?: MaybeRefOrGetter<number | undefined>;
+    /** Set to `false` to show top-level items only (used by layouts without nesting). Default true. */
+    nesting?: MaybeRefOrGetter<boolean>;
+}
+export interface UseDataListModelReturn<T> extends CoarDataListSelection<T> {
+    /** Visible items after filter, search, sort, grouping and nesting, in display order. */
+    items: ComputedRef<T[]>;
+    /** Visible rows including group headings, in display order. */
+    entries: ComputedRef<CoarDataListEntry<T>[]>;
+    /** Number of source items (top level). */
+    total: ComputedRef<number>;
+    /** Number of visible items (all levels). */
+    count: ComputedRef<number>;
+    keyOf(item: T): CoarDataListKey;
+    itemByKey(key: CoarDataListKey): T | undefined;
+    /** Position of a key among the visible items, or -1. */
+    indexOfKey(key: CoarDataListKey): number;
+    /** Position of a key among `entries` (group headings included), or -1. */
+    entryIndexOfKey(key: CoarDataListKey): number;
+    /** The visible entry of a key. */
+    entryOfKey(key: CoarDataListKey): ItemEntry<T> | undefined;
+    selected: Ref<CoarDataListKey[]>;
+    /** Anchor for shift-range selection. */
+    anchor: Ref<CoarDataListKey | null>;
+    /** Keys with children currently shown. */
+    expanded: Ref<CoarDataListKey[]>;
+    isExpanded(key: CoarDataListKey): boolean;
+    hasChildren(item: T): boolean;
+    expand(key: CoarDataListKey): void;
+    collapse(key: CoarDataListKey): void;
+    toggleExpanded(key: CoarDataListKey): void;
+    /** Expand every visible item that has children (recursively). */
+    expandAll(): void;
+    collapseAll(): void;
+    /** Parent key of a visible item, `null` at the top level. */
+    parentOf(key: CoarDataListKey): CoarDataListKey | null;
+    /** The sort in effect on a level (0 = top level); `null` when that level keeps its input order. */
+    sortAtDepth(depth: number): CoarDataListSort | null;
+}
+/**
+ * Headless data pipeline for {@link CoarDataList}: filter → search → sort → group,
+ * nested children under expanded parents, plus key-based selection. Use it
+ * directly when you render your own list.
+ */
+export declare function useDataListModel<T>(options: UseDataListModelOptions<T>): UseDataListModelReturn<T>;
+export {};
+//# sourceMappingURL=useDataListModel.d.ts.map

package/dist/components/data-list/useDataListModel.d.ts.map

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

package/dist/components/date-time/_shared/maskito-config.d.ts

@@ -10,9 +10,14 @@ export declare function coarCreateDateMask(pattern: DateFormatConfig['pattern'])
 /**
  * Creates a Maskito datetime mask for a given date format pattern and time options.
  *
+ * The date/time separator must stay a plain space: the pickers format and parse
+ * their input as `"<date> <time>"`, while Maskito's default separator is `", "`
+ * — with the default, re-masking on the first keystroke inserts a comma the
+ * parsers reject, so edits never reach the model and revert on blur.
+ *
  * @example
- * const mask = coarCreateDateTimeMask('dd.mm.yyyy', false) // "01.06.2026, 14:30"
- * const mask = coarCreateDateTimeMask('mm/dd/yyyy', true)  // "06/01/2026, 2:30 PM"
+ * const mask = coarCreateDateTimeMask('dd.mm.yyyy', false) // "01.06.2026 14:30"
+ * const mask = coarCreateDateTimeMask('mm/dd/yyyy', true)  // "06/01/2026 02:30 PM"
  */
 export declare function coarCreateDateTimeMask(pattern: DateFormatConfig['pattern'], use12Hour: boolean): Required<import('@maskito/core').MaskitoOptions>;
 //# sourceMappingURL=maskito-config.d.ts.map

package/dist/components/date-time/_shared/maskito-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maskito-config.d.ts","sourceRoot":"","sources":["../../../../src/components/date-time/_shared/maskito-config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIhD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,oDAKtE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,SAAS,EAAE,OAAO,oDAOnB"}
+{"version":3,"file":"maskito-config.d.ts","sourceRoot":"","sources":["../../../../src/components/date-time/_shared/maskito-config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIhD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,oDAKtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,SAAS,EAAE,OAAO,oDAQnB"}

package/dist/components/date-time/_shared/time-helpers.d.ts

@@ -11,12 +11,19 @@ export declare function coarDetect12HourFormat(locale: string): boolean;
 /**
  * Formats a time value as a string.
  *
+ * `forMaskedInput` emits the exact canonical text of the Maskito `HH:MM AA`
+ * mask: two-digit hour (the mask shreds "8:30 PM" into "83:0" on the first
+ * re-mask) and a no-break space before the meridiem (Maskito's own output —
+ * a regular space would make every programmatic write differ from the DOM
+ * and yank the cursor to the end). 24h output is identical either way.
+ *
  * @example
- * coarFormatTime(14, 30, true)  // "14:30"
- * coarFormatTime(14, 30, false) // "2:30 PM"
- * coarFormatTime(0, 5, false)   // "12:05 AM"
+ * coarFormatTime(14, 30, true)         // "14:30"
+ * coarFormatTime(14, 30, false)        // "2:30 PM"
+ * coarFormatTime(14, 30, false, true)  // "02:30\u00a0PM"
+ * coarFormatTime(0, 5, false)          // "12:05 AM"
  */
-export declare function coarFormatTime(hours: number, minutes: number, use24Hour: boolean): string;
+export declare function coarFormatTime(hours: number, minutes: number, use24Hour: boolean, forMaskedInput?: boolean): string;
 /**
  * Parses a time string into hours and minutes.
  * Supports both 24-hour ("14:30") and 12-hour ("2:30 PM") formats.

package/dist/components/date-time/_shared/time-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/date-time/_shared/time-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAW9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAYzF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA6BrE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAK9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,GACP;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAgBxC;AAED,gDAAgD;AAChD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAMnE"}
+{"version":3,"file":"time-helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/date-time/_shared/time-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAW9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,cAAc,UAAQ,GACrB,MAAM,CAeR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA6BrE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAK9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,GACP;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAgBxC;AAED,gDAAgD;AAChD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAMnE"}

package/dist/components/date-time/_shared/use-date-picker-base.d.ts

@@ -29,7 +29,7 @@ export declare function useDatePickerBase(props: {
 }): {
     effectiveLocale: ComputedRef<string>;
     effectiveDateFormat: ComputedRef<DateFormatConfig>;
-    separator: ComputedRef<"." | "/" | "-">;
+    separator: ComputedRef<"." | "-" | "/">;
     timezone: Readonly<Ref<string, string>>;
     isOpen: Ref<boolean, boolean>;
     open: () => void;

package/dist/components/date-time/plain-date-picker/CoarPlainDatePicker.vue.d.ts

@@ -55,8 +55,8 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     onOpened?: (() => any) | undefined;
 }>, {
     error: boolean;
-    size: CoarPlainDatePickerSize;
     id: string;
+    size: CoarPlainDatePickerSize;
     required: boolean;
     disabled: boolean;
     placeholder: string;