@flux-ui/components 3.0.0-next.57 → 3.0.0-next.59

package/src/component/FluxKanbanColumn.vue

@@ -1,39 +1,85 @@
 <template>
     <div
-        data-kanban-column
-        :class="[$style.kanbanColumn, isOver && $style.isOver]">
-        <div :class="$style.kanbanColumnHeader">
+        ref="root"
+        role="list"
+        aria-roledescription="Kanban column"
+        :aria-label="label"
+        :aria-disabled="disabledState ? true : undefined"
+        :class="[
+            $style.kanbanColumn,
+            isOver && $style.isOver,
+            isOver && !kanban.isDropAllowed.value && $style.isDropDisallowed,
+            isReorderable && $style.isReorderable,
+            isColumnDragging && $style.isColumnDragging,
+            isColumnDropBefore && $style.isColumnDropBefore,
+            disabledState && $style.isDisabled
+        ]">
+        <header
+            :class="$style.kanbanColumnHeader"
+            :draggable="isReorderable && !disabledState"
+            :tabindex="isReorderable && !disabledState ? 0 : undefined"
+            @dragstart="onColumnDragStart"
+            @dragend="onColumnDragEnd"
+            @dragover="onColumnDragOver"
+            @drop="onColumnDrop">
             <slot name="header">
                 <span :class="$style.kanbanColumnLabel">{{ label }}</span>
             </slot>
 
             <slot name="actions"/>
-        </div>
+        </header>
 
-        <div
+        <main
+            ref="body"
             :class="$style.kanbanColumnBody"
             @dragenter="onDragEnter"
             @dragleave="onDragLeave"
-            @dragover.prevent="onDragOver"
-            @drop.prevent="onDrop">
+            @dragover="onDragOver"
+            @drop="onDrop">
             <slot/>
 
             <div
-                v-if="isDropEnd"
-                :class="$style.kanbanDropIndicator"/>
-        </div>
+                v-if="isEmpty"
+                :class="$style.kanbanColumnEmpty">
+                <slot name="empty"/>
+            </div>
+
+            <div
+                aria-hidden="true"
+                :class="[
+                    $style.kanbanDropIndicator,
+                    dropIndicator !== null && $style.isVisible,
+                    dropIndicator !== null && !kanban.isDropAllowed.value && $style.isDisallowed
+                ]"
+                :style="dropIndicator !== null ? { transform: `translateY(${dropIndicator}px)` } : undefined"/>
+        </main>
+
+        <footer
+            v-if="hasFooter"
+            :class="$style.kanbanColumnFooter">
+            <slot
+                v-if="hasFooter"
+                name="footer"/>
+        </footer>
     </div>
 </template>
 
 <script
     lang="ts"
     setup>
-    import { computed, inject, ref, unref } from 'vue';
-    import { FluxKanbanInjectionKey } from '$flux/data/di';
-    import $style from '$flux/css/component/FluxKanbanColumn.module.scss';
+    import { flattenVNodeTree } from '@flux-ui/internals';
+    import { Comment, computed, onBeforeUnmount, onMounted, provide, Text, toRef, unref, useSlots, useTemplateRef, watch } from 'vue';
+    import { useDisabled, useKanbanInjection } from '~flux/components/composable';
+    import { FluxDisabledInjectionKey } from '~flux/components/data';
+    import $style from '~flux/components/css/component/Kanban.module.scss';
 
-    const {columnId, label} = defineProps<{
+    const {
+        columnId,
+        disabled = false,
+        label
+    } = defineProps<{
         readonly columnId: string | number;
+        readonly disabled?: boolean;
         readonly label: string;
     }>();
 
@@ -41,44 +87,191 @@
         default?(): any;
         header?(): any;
         actions?(): any;
+        empty?(): any;
+        footer?(): any;
     }>();
 
-    const kanban = inject(FluxKanbanInjectionKey)!;
+    const kanban = useKanbanInjection();
+    const root = useTemplateRef('root');
+    const body = useTemplateRef('body');
+    const slots = useSlots();
 
-    let dragEnterCount = 0;
-    const isOver = ref(false);
+    const disabledState = useDisabled(toRef(() => disabled));
+    provide(FluxDisabledInjectionKey, disabledState);
 
-    const isDropEnd = computed(() => {
+    const isOver = computed(() => kanban.isOverColumnId.value === columnId);
+    const isReorderable = computed(() => unref(kanban.reorderableColumns) && !unref(disabledState));
+
+    const dropIndicator = computed<number | null>(() => {
         const state = unref(kanban.dragState);
-        return state !== null && state.dropColumnId === columnId && state.beforeCardId === null;
+        const bodyEl = body.value;
+
+        if (!state || state.dropColumnId !== columnId || !(bodyEl instanceof HTMLElement)) {
+            return null;
+        }
+
+        const items = Array.from(bodyEl.children).filter(
+            (child): child is HTMLElement => child instanceof HTMLElement && kanban.getItemInfo(child) !== undefined
+        );
+
+        if (state.beforeItemId === null) {
+            const last = items[items.length - 1];
+            return last ? last.offsetTop + last.offsetHeight + 4 : 4;
+        }
+
+        const target = items.find(el => kanban.getItemInfo(el)?.itemId === state.beforeItemId);
+        return target ? target.offsetTop - 5 : null;
     });
 
+    const isColumnDragging = computed(() => unref(kanban.columnDragState)?.columnId === columnId);
+
+    const isColumnDropBefore = computed(() => {
+        const state = unref(kanban.columnDragState);
+
+        if (!state || state.dropBeforeColumnId !== columnId || state.columnId === columnId) {
+            return false;
+        }
+
+        return true;
+    });
+
+    const isEmpty = computed(() => {
+        if (!slots.empty) {
+            return false;
+        }
+
+        const defaultSlot = slots.default?.();
+
+        if (!defaultSlot || defaultSlot.length === 0) {
+            return true;
+        }
+
+        const hasContent = flattenVNodeTree(defaultSlot).some(vnode => vnode.type !== Comment && vnode.type !== Text);
+        return !hasContent;
+    });
+
+    const hasFooter = computed(() => !!slots.footer);
+
     function onDragEnter(): void {
-        dragEnterCount++;
-        isOver.value = true;
+        kanban.enterColumn(columnId);
     }
 
     function onDragLeave(): void {
-        if (--dragEnterCount <= 0) {
-            dragEnterCount = 0;
-            isOver.value = false;
-            kanban.clearDropTarget();
-        }
+        kanban.leaveColumn(columnId);
     }
 
     function onDragOver(evt: DragEvent): void {
-        // Only handle empty-area drops; cards stop propagation on their own dragover
+        if (unref(disabledState) || !unref(kanban.dragState)) {
+            return;
+        }
+
+        evt.preventDefault();
+
         const target = evt.target as Element;
-        const isOverCard = !!target.closest('[data-kanban-card]');
+        const isOverItem = !!target.closest('[data-kanban-item]');
 
-        if (!isOverCard) {
+        if (!isOverItem) {
             kanban.updateDropTarget(columnId, null);
         }
     }
 
-    function onDrop(): void {
-        dragEnterCount = 0;
-        isOver.value = false;
+    function onDrop(evt: DragEvent): void {
+        if (unref(disabledState) || !unref(kanban.dragState)) {
+            return;
+        }
+
+        evt.preventDefault();
         kanban.commitDrop();
     }
+
+    function onColumnDragStart(evt: DragEvent): void {
+        if (!unref(isReorderable)) {
+            return;
+        }
+
+        if (evt.dataTransfer) {
+            evt.dataTransfer.effectAllowed = 'move';
+            evt.dataTransfer.setData('text/plain', `column:${String(columnId)}`);
+        }
+
+        kanban.startColumnDrag(columnId);
+    }
+
+    function onColumnDragEnd(): void {
+        kanban.endColumnDrag();
+    }
+
+    function onColumnDragOver(evt: DragEvent): void {
+        const state = unref(kanban.columnDragState);
+
+        if (!state || state.columnId === columnId) {
+            return;
+        }
+
+        evt.preventDefault();
+
+        const headerEl = evt.currentTarget as Element;
+        const rect = headerEl.getBoundingClientRect();
+
+        if (evt.clientX < rect.left + rect.width / 2) {
+            kanban.updateColumnDropTarget(columnId);
+        } else {
+            let next = root.value?.nextElementSibling ?? null;
+
+            while (next) {
+                const info = kanban.getColumnInfo(next);
+
+                if (info) {
+                    kanban.updateColumnDropTarget(info.columnId);
+                    return;
+                }
+
+                next = next.nextElementSibling;
+            }
+
+            kanban.updateColumnDropTarget(null);
+        }
+    }
+
+    function onColumnDrop(evt: DragEvent): void {
+        if (!unref(kanban.columnDragState)) {
+            return;
+        }
+
+        evt.preventDefault();
+        kanban.commitColumnDrop();
+    }
+
+    onMounted(() => {
+        if (root.value) {
+            kanban.registerColumn(root.value, columnId);
+        }
+
+        if (body.value) {
+            kanban.setColumnBodyElement(columnId, body.value);
+        }
+    });
+
+    onBeforeUnmount(() => {
+        if (root.value) {
+            kanban.unregisterColumn(root.value);
+        }
+
+        kanban.setColumnBodyElement(columnId, null);
+    });
+
+    watch(() => columnId, (newId, oldId) => {
+        if (oldId !== undefined) {
+            kanban.setColumnBodyElement(oldId, null);
+        }
+
+        if (root.value) {
+            kanban.unregisterColumn(root.value);
+            kanban.registerColumn(root.value, newId);
+        }
+
+        if (body.value) {
+            kanban.setColumnBodyElement(newId, body.value);
+        }
+    });
 </script>

package/src/component/FluxKanbanItem.vue

@@ -0,0 +1,162 @@
+<template>
+    <div
+        ref="root"
+        data-kanban-item
+        role="listitem"
+        aria-roledescription="Kanban item"
+        :aria-disabled="disabledState ? true : undefined"
+        :class="[
+            $style.kanbanItem,
+            isDragging && $style.isDragging,
+            isGrabbed && $style.isGrabbed,
+            disabledState && $style.isDisabled
+        ]"
+        :draggable="!disabledState"
+        :tabindex="disabledState ? -1 : 0"
+        @dragstart="onDragStart"
+        @dragend="onDragEnd"
+        @dragover.stop="onDragOver"
+        @focus="onFocus"
+        @keydown="handleKeyDown">
+        <slot/>
+    </div>
+</template>
+
+<script
+    lang="ts"
+    setup>
+    import { useKeyboardGrab } from '@flux-ui/internals';
+    import { computed, onBeforeUnmount, onMounted, toRef, unref, useTemplateRef, watch } from 'vue';
+    import { useDisabled, useKanbanInjection } from '~flux/components/composable';
+    import $style from '~flux/components/css/component/Kanban.module.scss';
+
+    const {
+        columnId,
+        disabled = false,
+        itemId
+    } = defineProps<{
+        readonly columnId: string | number;
+        readonly disabled?: boolean;
+        readonly itemId: string | number;
+    }>();
+
+    defineSlots<{
+        default?(): any;
+    }>();
+
+    const kanban = useKanbanInjection();
+    const root = useTemplateRef('root');
+    const disabledState = useDisabled(toRef(() => disabled));
+
+    const isDragging = computed(() => {
+        const state = unref(kanban.dragState);
+        return state?.itemId === itemId && state?.mode === 'pointer';
+    });
+
+    const {isGrabbed, handleKeyDown, release} = useKeyboardGrab<true>({
+        isDraggable: computed(() => !unref(disabledState)),
+        itemId: toRef(() => itemId),
+        grabbedId: kanban.grabbedId,
+        onGrab() {
+            kanban.grabItem(itemId, columnId);
+            return true;
+        },
+        onMove(direction) {
+            kanban.moveKeyboard(direction);
+        },
+        onCommit() {
+            kanban.commitKeyboardDrop();
+        },
+        onCancel() {
+            kanban.cancelKeyboardDrop();
+        }
+    });
+
+    onMounted(() => {
+        if (root.value) {
+            kanban.registerItem(root.value, itemId);
+        }
+
+        if (kanban.isItemGrabbed(itemId)) {
+            root.value?.focus();
+        }
+    });
+
+    onBeforeUnmount(() => {
+        if (root.value) {
+            kanban.unregisterItem(root.value);
+        }
+    });
+
+    watch(() => itemId, (newId, oldId) => {
+        if (root.value && oldId !== undefined) {
+            kanban.unregisterItem(root.value);
+            kanban.registerItem(root.value, newId);
+        }
+    });
+
+    function onDragStart(evt: DragEvent): void {
+        if (unref(disabledState)) {
+            evt.preventDefault();
+            return;
+        }
+
+        if (isGrabbed.value) {
+            kanban.cancelKeyboardDrop();
+            release();
+        }
+
+        kanban.startDrag(itemId, columnId);
+
+        if (evt.dataTransfer) {
+            evt.dataTransfer.effectAllowed = 'move';
+            evt.dataTransfer.setData('text/plain', `item:${String(itemId)}`);
+
+            if (root.value) {
+                const offsetX = evt.offsetX || root.value.getBoundingClientRect().width / 2;
+                const offsetY = evt.offsetY || 12;
+                evt.dataTransfer.setDragImage(root.value, offsetX, offsetY);
+            }
+        }
+    }
+
+    function onDragEnd(): void {
+        kanban.endDrag();
+    }
+
+    function onFocus(): void {
+        root.value?.scrollIntoView({block: 'nearest', inline: 'nearest', behavior: 'smooth'});
+    }
+
+    function onDragOver(evt: DragEvent): void {
+        const state = unref(kanban.dragState);
+
+        if (!state || unref(disabledState)) {
+            return;
+        }
+
+        evt.preventDefault();
+
+        const itemEl = evt.currentTarget as Element;
+        const rect = itemEl.getBoundingClientRect();
+
+        if (evt.clientY < rect.top + rect.height / 2) {
+            kanban.updateDropTarget(columnId, itemId);
+        } else {
+            let next = itemEl.nextElementSibling;
+
+            while (next) {
+                const info = kanban.getItemInfo(next);
+
+                if (info) {
+                    kanban.updateDropTarget(columnId, info.itemId);
+                    return;
+                }
+
+                next = next.nextElementSibling;
+            }
+
+            kanban.updateDropTarget(columnId, null);
+        }
+    }
+</script>

package/src/component/FluxLayerPane.vue

@@ -8,7 +8,7 @@
     lang="ts"
     setup>
     import type { VNode } from 'vue';
-    import $style from '$flux/css/component/LayerPane.module.scss';
+    import $style from '~flux/components/css/component/LayerPane.module.scss';
 
     defineSlots<{
         default(): VNode[];

package/src/component/FluxLayerPaneSecondary.vue

@@ -8,7 +8,7 @@
     lang="ts"
     setup>
     import type { VNode } from 'vue';
-    import $style from '$flux/css/component/LayerPane.module.scss';
+    import $style from '~flux/components/css/component/LayerPane.module.scss';
 
     defineSlots<{
         default(): VNode[];

package/src/component/FluxLegend.vue

@@ -16,7 +16,7 @@
     lang="ts"
     setup>
     import type { FluxDirection, FluxLegendObject } from '@flux-ui/types';
-    import $style from '$flux/css/component/Legend.module.scss';
+    import $style from '~flux/components/css/component/Legend.module.scss';
 
     const {
         direction = 'horizontal'

package/src/component/FluxLink.vue

@@ -20,7 +20,7 @@
     setup>
     import type { FluxButtonEmits, FluxButtonProps, FluxButtonSlots, FluxIconName } from '@flux-ui/types';
     import FluxButton, { SLOTS } from './FluxButton.vue';
-    import $style from '$flux/css/component/Button.module.scss';
+    import $style from '~flux/components/css/component/Button.module.scss';
 
     const emit = defineEmits<FluxButtonEmits>();
 

package/src/component/FluxMenu.vue

@@ -13,7 +13,7 @@
     setup>
     import { useFocusZone } from '@flux-ui/internals';
     import { useTemplateRef, type VNode } from 'vue';
-    import $style from '$flux/css/component/Menu.module.scss';
+    import $style from '~flux/components/css/component/Menu.module.scss';
 
     defineProps<{
         readonly isLarge?: boolean;

package/src/component/FluxMenuCollapsible.vue

@@ -36,12 +36,12 @@
 <script
     lang="ts"
     setup>
-    import type { FluxIconName, FluxTo } from '@flux-ui/types';
     import { flattenVNodeTree } from '@flux-ui/internals';
+    import type { FluxIconName, FluxTo } from '@flux-ui/types';
     import { computed, getCurrentInstance, ref, useId, type VNode, watch } from 'vue';
-    import { FluxAutoHeightTransition } from '$flux/transition';
+    import { FluxAutoHeightTransition } from '~flux/components/transition';
     import FluxMenuItem from './FluxMenuItem.vue';
-    import $style from '$flux/css/component/Menu.module.scss';
+    import $style from '~flux/components/css/component/Menu.module.scss';
 
     type RouteRecordLike = {
         readonly name?: string | symbol | null | undefined;

package/src/component/FluxMenuGroup.vue

@@ -10,7 +10,7 @@
     lang="ts"
     setup>
     import type { VNode } from 'vue';
-    import $style from '$flux/css/component/Menu.module.scss';
+    import $style from '~flux/components/css/component/Menu.module.scss';
 
     defineProps<{
         readonly isHorizontal?: boolean;

package/src/component/FluxMenuItem.vue

@@ -68,12 +68,12 @@
 <script
     lang="ts"
     setup>
-    import type { VNode } from 'vue';
     import type { FluxButtonEmits, FluxButtonProps, FluxIconName } from '@flux-ui/types';
+    import type { VNode } from 'vue';
     import FluxButton from './FluxButton.vue';
     import FluxIcon from './FluxIcon.vue';
     import FluxSpinner from './FluxSpinner.vue';
-    import $style from '$flux/css/component/Menu.module.scss';
+    import $style from '~flux/components/css/component/Menu.module.scss';
 
     defineEmits<FluxButtonEmits>();
 

package/src/component/FluxMenuSubHeader.vue

@@ -23,7 +23,7 @@
     setup>
     import type { FluxIconName } from '@flux-ui/types';
     import FluxIcon from './FluxIcon.vue';
-    import $style from '$flux/css/component/Menu.module.scss';
+    import $style from '~flux/components/css/component/Menu.module.scss';
 
     defineProps<{
         readonly iconLeading?: FluxIconName;

package/src/component/FluxMenuTitle.vue

@@ -9,7 +9,7 @@
 <script
     lang="ts"
     setup>
-    import $style from '$flux/css/component/Menu.module.scss';
+    import $style from '~flux/components/css/component/Menu.module.scss';
 
     defineProps<{
         readonly title: string;

package/src/component/FluxNotice.vue

@@ -50,13 +50,13 @@
 <script
     lang="ts"
     setup>
-    import type { VNode } from 'vue';
     import type { FluxColor, FluxIconName } from '@flux-ui/types';
     import { clsx } from 'clsx';
-    import { useTranslate } from '$flux/composable/private';
+    import type { VNode } from 'vue';
+    import { useTranslate } from '~flux/components/composable/private';
     import FluxIcon from './FluxIcon.vue';
     import FluxSpinner from './FluxSpinner.vue';
-    import $style from '$flux/css/component/Notice.module.scss';
+    import $style from '~flux/components/css/component/Notice.module.scss';
 
     const emit = defineEmits<{
         close: [];

package/src/component/FluxOverflowBar.vue

@@ -39,7 +39,7 @@
     import type { FluxAlignment, FluxDirection } from '@flux-ui/types';
     import { computed, ref, unref, useTemplateRef, type VNode, watch } from 'vue';
     import FluxDynamicView from './FluxDynamicView.vue';
-    import $style from '$flux/css/component/OverflowBar.module.scss';
+    import $style from '~flux/components/css/component/OverflowBar.module.scss';
 
     const {
         alignment = 'center',

package/src/component/FluxOverlay.vue

@@ -2,9 +2,9 @@
     import type { FluxSize } from '@flux-ui/types';
     import { clsx } from 'clsx';
     import { defineComponent, type PropType } from 'vue';
-    import { FluxOverlayTransition } from '$flux/transition';
-    import { createDialogRenderer } from '$flux/util';
-    import $style from '$flux/css/component/Overlay.module.scss';
+    import { FluxOverlayTransition } from '~flux/components/transition';
+    import { createDialogRenderer } from '~flux/components/util';
+    import $style from '~flux/components/css/component/Overlay.module.scss';
 
     export default defineComponent({
         emits: ['close'],

package/src/component/FluxOverlayProvider.vue

@@ -28,12 +28,12 @@
 <script
     lang="ts"
     setup>
-    import { useFluxStore } from '$flux/data';
+    import { useFluxStore } from '~flux/components/data';
     import FluxAlert from './FluxAlert.vue';
     import FluxConfirm from './FluxConfirm.vue';
     import FluxOverlay from './FluxOverlay.vue';
     import FluxPrompt from './FluxPrompt.vue';
-    import $style from '$flux/css/component/Overlay.module.scss';
+    import $style from '~flux/components/css/component/Overlay.module.scss';
 
     const {alerts, confirms, prompts} = useFluxStore();
 </script>

package/src/component/FluxPagination.vue

@@ -58,10 +58,10 @@
     lang="ts"
     setup>
     import { computed, unref } from 'vue';
-    import { useTranslate } from '$flux/composable/private';
-    import { showPrompt } from '$flux/data';
+    import { useTranslate } from '~flux/components/composable/private';
+    import { showPrompt } from '~flux/components/data';
     import FluxPaginationButton from './FluxPaginationButton.vue';
-    import $style from '$flux/css/component/Pagination.module.scss';
+    import $style from '~flux/components/css/component/Pagination.module.scss';
 
     const emit = defineEmits<{
         navigate: [number];

package/src/component/FluxPaginationBar.vue

@@ -34,11 +34,11 @@
     setup>
     import type { FluxFormSelectOption } from '@flux-ui/types';
     import { computed, ref, watch } from 'vue';
-    import { useTranslate } from '$flux/composable/private';
+    import { useTranslate } from '~flux/components/composable/private';
     import FluxFormSelect from './FluxFormSelect.vue';
     import FluxPagination from './FluxPagination.vue';
     import FluxSpacer from './FluxSpacer.vue';
-    import $style from '$flux/css/component/Pagination.module.scss';
+    import $style from '~flux/components/css/component/Pagination.module.scss';
 
     const emit = defineEmits<{
         limit: [number];