@umituz/web-dashboard 11.10.1 → 11.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,160 @@
1
+ import { useCallback, type DragEvent, type KeyboardEvent, type ReactNode } from 'react';
2
+ import { ChevronLeft, ChevronRight } from 'lucide-react';
3
+ import type { KanbanCardActions, KanbanColumn, KanbanItem } from '../types';
4
+
5
+ export interface KanbanCardProps<T = unknown> {
6
+ readonly item: KanbanItem<T>;
7
+ readonly column: KanbanColumn<T>;
8
+ readonly actions?: KanbanCardActions;
9
+ readonly renderCard?: (
10
+ item: KanbanItem<T>,
11
+ column: KanbanColumn<T>,
12
+ actions?: KanbanCardActions,
13
+ ) => ReactNode;
14
+ readonly onSelectItem?: (item: KanbanItem<T>) => void;
15
+ readonly onDragStart?: (e: DragEvent<HTMLDivElement>, item: KanbanItem<T>) => void;
16
+ readonly onDragEnd?: (e: DragEvent<HTMLDivElement>, item: KanbanItem<T>) => void;
17
+ readonly isDragging?: boolean;
18
+ readonly showStageActions?: boolean;
19
+ readonly className?: string;
20
+ }
21
+
22
+ export function KanbanCard<T = unknown>({
23
+ item,
24
+ column,
25
+ actions,
26
+ renderCard,
27
+ onSelectItem,
28
+ onDragStart,
29
+ onDragEnd,
30
+ isDragging = false,
31
+ showStageActions = false,
32
+ className,
33
+ }: KanbanCardProps<T>): ReactNode {
34
+ const handleClick = useCallback(() => {
35
+ onSelectItem?.(item);
36
+ }, [onSelectItem, item]);
37
+
38
+ const handleKeyDown = useCallback(
39
+ (e: KeyboardEvent<HTMLDivElement>) => {
40
+ if (e.key === 'Enter' || e.key === ' ') {
41
+ if ((e.target as HTMLElement).tagName.toLowerCase() === 'button') {
42
+ return;
43
+ }
44
+ e.preventDefault();
45
+ onSelectItem?.(item);
46
+ }
47
+ },
48
+ [onSelectItem, item],
49
+ );
50
+
51
+ const handleDragStart = useCallback(
52
+ (e: DragEvent<HTMLDivElement>) => {
53
+ e.dataTransfer.setData('text/plain', item.id);
54
+ e.dataTransfer.effectAllowed = 'move';
55
+ onDragStart?.(e, item);
56
+ },
57
+ [item, onDragStart],
58
+ );
59
+
60
+ const handleDragEnd = useCallback(
61
+ (e: DragEvent<HTMLDivElement>) => {
62
+ onDragEnd?.(e, item);
63
+ },
64
+ [item, onDragEnd],
65
+ );
66
+
67
+ if (renderCard) {
68
+ return (
69
+ <div
70
+ draggable={!item.disabled}
71
+ onDragStart={handleDragStart}
72
+ onDragEnd={handleDragEnd}
73
+ onClick={handleClick}
74
+ onKeyDown={handleKeyDown}
75
+ role="button"
76
+ tabIndex={0}
77
+ className={`udb-kanban-card${isDragging ? ' is-dragging' : ''}${item.disabled ? ' is-disabled' : ''}${className ? ` ${className}` : ''}`}
78
+ >
79
+ {renderCard(item, column, actions)}
80
+ </div>
81
+ );
82
+ }
83
+
84
+ return (
85
+ <div
86
+ draggable={!item.disabled}
87
+ onDragStart={handleDragStart}
88
+ onDragEnd={handleDragEnd}
89
+ onClick={handleClick}
90
+ onKeyDown={handleKeyDown}
91
+ role="button"
92
+ tabIndex={0}
93
+ className={`udb-kanban-card${isDragging ? ' is-dragging' : ''}${item.disabled ? ' is-disabled' : ''}${className ? ` ${className}` : ''}`}
94
+ >
95
+ <div className="udb-kanban-card-head">
96
+ <div className="udb-kanban-card-title">{item.title}</div>
97
+ {item.badge}
98
+ </div>
99
+
100
+ {item.description && <div className="udb-kanban-card-desc">{item.description}</div>}
101
+
102
+ {item.tags && item.tags.length > 0 && (
103
+ <div className="udb-kanban-card-tags">
104
+ {item.tags.map((tag) => (
105
+ <span key={tag.label} className="udb-kanban-card-tag">
106
+ {tag.label}
107
+ </span>
108
+ ))}
109
+ </div>
110
+ )}
111
+
112
+ {(item.meta || item.assignee || (showStageActions && actions)) && (
113
+ <div className="udb-kanban-card-foot">
114
+ <div className="udb-kanban-card-meta">
115
+ {item.assignee && (
116
+ <span className="udb-kanban-card-assignee">
117
+ <span className="udb-kanban-card-avatar">
118
+ {item.assignee.avatarUrl ? (
119
+ <img src={item.assignee.avatarUrl} alt={item.assignee.name} />
120
+ ) : (
121
+ item.assignee.initials ?? item.assignee.name.slice(0, 2)
122
+ )}
123
+ </span>
124
+ <span>{item.assignee.name}</span>
125
+ </span>
126
+ )}
127
+ {item.meta}
128
+ </div>
129
+
130
+ {showStageActions && actions && (
131
+ <div
132
+ className="udb-kanban-stage-actions"
133
+ onClick={(e) => e.stopPropagation()}
134
+ onKeyDown={(e) => e.stopPropagation()}
135
+ >
136
+ <button
137
+ type="button"
138
+ className="udb-kanban-stage-btn"
139
+ disabled={!actions.canMoveBack}
140
+ onClick={actions.moveBack}
141
+ aria-label="Move backward"
142
+ >
143
+ <ChevronLeft size={13} aria-hidden="true" />
144
+ </button>
145
+ <button
146
+ type="button"
147
+ className="udb-kanban-stage-btn"
148
+ disabled={!actions.canMoveForward}
149
+ onClick={actions.moveForward}
150
+ aria-label="Move forward"
151
+ >
152
+ <ChevronRight size={13} aria-hidden="true" />
153
+ </button>
154
+ </div>
155
+ )}
156
+ </div>
157
+ )}
158
+ </div>
159
+ );
160
+ }
@@ -0,0 +1,163 @@
1
+ import { useCallback, useState, type DragEvent, type ReactNode } from 'react';
2
+ import { Plus } from 'lucide-react';
3
+ import type { KanbanCardActions, KanbanColumn as IKanbanColumn, KanbanItem } from '../types';
4
+ import { KanbanCard } from './KanbanCard';
5
+
6
+ export interface KanbanColumnProps<T = unknown> {
7
+ readonly column: IKanbanColumn<T>;
8
+ readonly items: readonly KanbanItem<T>[];
9
+ readonly draggingItemId?: string | null;
10
+ readonly getCardActions?: (item: KanbanItem<T>, column: IKanbanColumn<T>) => KanbanCardActions;
11
+ readonly onDropItem?: (targetColumnId: string, itemId: string) => void;
12
+ readonly onSelectItem?: (item: KanbanItem<T>) => void;
13
+ readonly onColumnAction?: (columnId: string) => void;
14
+ readonly onDragStartCard?: (e: DragEvent<HTMLDivElement>, item: KanbanItem<T>) => void;
15
+ readonly onDragEndCard?: (e: DragEvent<HTMLDivElement>, item: KanbanItem<T>) => void;
16
+ readonly renderCard?: (
17
+ item: KanbanItem<T>,
18
+ column: IKanbanColumn<T>,
19
+ actions?: KanbanCardActions,
20
+ ) => ReactNode;
21
+ readonly renderColumnHeader?: (
22
+ column: IKanbanColumn<T>,
23
+ items: readonly KanbanItem<T>[],
24
+ ) => ReactNode;
25
+ readonly renderColumnFooter?: (column: IKanbanColumn<T>) => ReactNode;
26
+ readonly renderEmptyColumn?: (column: IKanbanColumn<T>) => ReactNode;
27
+ readonly showStageActions?: boolean;
28
+ readonly emptyText?: string;
29
+ readonly className?: string;
30
+ readonly cardClassName?: string;
31
+ }
32
+
33
+ export function KanbanColumn<T = unknown>({
34
+ column,
35
+ items,
36
+ draggingItemId,
37
+ getCardActions,
38
+ onDropItem,
39
+ onSelectItem,
40
+ onColumnAction,
41
+ onDragStartCard,
42
+ onDragEndCard,
43
+ renderCard,
44
+ renderColumnHeader,
45
+ renderColumnFooter,
46
+ renderEmptyColumn,
47
+ showStageActions,
48
+ emptyText = 'Drop here',
49
+ className,
50
+ cardClassName,
51
+ }: KanbanColumnProps<T>): ReactNode {
52
+ const [isDragOver, setIsDragOver] = useState(false);
53
+
54
+ const handleDragOver = useCallback((e: DragEvent<HTMLDivElement>) => {
55
+ e.preventDefault();
56
+ e.dataTransfer.dropEffect = 'move';
57
+ }, []);
58
+
59
+ const handleDragEnter = useCallback((e: DragEvent<HTMLDivElement>) => {
60
+ e.preventDefault();
61
+ setIsDragOver(true);
62
+ }, []);
63
+
64
+ const handleDragLeave = useCallback((e: DragEvent<HTMLDivElement>) => {
65
+ if (e.currentTarget.contains(e.relatedTarget as Node)) {
66
+ return;
67
+ }
68
+ setIsDragOver(false);
69
+ }, []);
70
+
71
+ const handleDrop = useCallback(
72
+ (e: DragEvent<HTMLDivElement>) => {
73
+ e.preventDefault();
74
+ setIsDragOver(false);
75
+ const itemId = e.dataTransfer.getData('text/plain');
76
+ if (itemId) {
77
+ onDropItem?.(column.id, itemId);
78
+ }
79
+ },
80
+ [column.id, onDropItem],
81
+ );
82
+
83
+ const isLimitExceeded =
84
+ typeof column.limit === 'number' && column.limit > 0 && items.length > column.limit;
85
+
86
+ return (
87
+ <div
88
+ className={`udb-kanban-col${isDragOver ? ' is-drag-over' : ''}${className ? ` ${className}` : ''}`}
89
+ onDragOver={handleDragOver}
90
+ onDragEnter={handleDragEnter}
91
+ onDragLeave={handleDragLeave}
92
+ onDrop={handleDrop}
93
+ data-column-id={column.id}
94
+ >
95
+ {renderColumnHeader ? (
96
+ renderColumnHeader(column, items)
97
+ ) : (
98
+ <div className="udb-kanban-col-head">
99
+ <div className="udb-kanban-col-title-wrap">
100
+ {column.icon}
101
+ {column.tone && (
102
+ <span
103
+ className={`udb-kanban-tone-dot tone-${column.tone}`}
104
+ aria-hidden="true"
105
+ />
106
+ )}
107
+ <span className="udb-kanban-col-title">{column.title}</span>
108
+ <span className="udb-kanban-col-count">{items.length}</span>
109
+ {typeof column.limit === 'number' && column.limit > 0 && (
110
+ <span
111
+ className={`udb-kanban-col-limit${isLimitExceeded ? ' is-exceeded' : ''}`}
112
+ >
113
+ / {column.limit}
114
+ </span>
115
+ )}
116
+ </div>
117
+
118
+ <div className="udb-kanban-col-actions">
119
+ {column.headerActions}
120
+ {onColumnAction && (
121
+ <button
122
+ type="button"
123
+ className="udb-kanban-col-btn"
124
+ onClick={() => onColumnAction(column.id)}
125
+ aria-label={`Add item to ${String(column.title)}`}
126
+ >
127
+ <Plus size={15} aria-hidden="true" />
128
+ </button>
129
+ )}
130
+ </div>
131
+ </div>
132
+ )}
133
+
134
+ <div className="udb-kanban-col-body">
135
+ {items.length === 0 ? (
136
+ renderEmptyColumn ? (
137
+ renderEmptyColumn(column)
138
+ ) : (
139
+ <div className="udb-kanban-empty-col">{emptyText}</div>
140
+ )
141
+ ) : (
142
+ items.map((item) => (
143
+ <KanbanCard<T>
144
+ key={item.id}
145
+ item={item}
146
+ column={column}
147
+ actions={getCardActions?.(item, column)}
148
+ renderCard={renderCard}
149
+ onSelectItem={onSelectItem}
150
+ onDragStart={onDragStartCard}
151
+ onDragEnd={onDragEndCard}
152
+ isDragging={draggingItemId === item.id}
153
+ showStageActions={showStageActions}
154
+ className={cardClassName}
155
+ />
156
+ ))
157
+ )}
158
+ </div>
159
+
160
+ {renderColumnFooter && renderColumnFooter(column)}
161
+ </div>
162
+ );
163
+ }
@@ -0,0 +1,115 @@
1
+ import { describe, expect, it, vi } from 'vitest';
2
+ import { render, screen, fireEvent } from '@testing-library/react';
3
+ import { MemoryRouter } from 'react-router';
4
+ import { KanbanPage } from './KanbanPage';
5
+ import type { KanbanColumn, KanbanItem, KanbanKpi } from '../types';
6
+
7
+ interface ProjectDeal {
8
+ amount: number;
9
+ }
10
+
11
+ const COLUMNS: readonly KanbanColumn<ProjectDeal>[] = [
12
+ { id: 'lead', title: 'New Leads', tone: 'neutral' },
13
+ { id: 'qualified', title: 'Qualified', tone: 'info' },
14
+ { id: 'won', title: 'Closed Won', tone: 'success' },
15
+ ];
16
+
17
+ const ITEMS: readonly KanbanItem<ProjectDeal>[] = [
18
+ {
19
+ id: 'deal-1',
20
+ columnId: 'lead',
21
+ title: 'Acme Corp Contract',
22
+ description: 'Enterprise license',
23
+ meta: '$120,000',
24
+ payload: { amount: 120000 },
25
+ },
26
+ {
27
+ id: 'deal-2',
28
+ columnId: 'qualified',
29
+ title: 'Globex Deal',
30
+ meta: '$45,000',
31
+ payload: { amount: 45000 },
32
+ },
33
+ ];
34
+
35
+ const KPIS: readonly KanbanKpi[] = [
36
+ { label: 'Active Pipeline', value: '$165,000' },
37
+ { label: 'Deals in Progress', value: '2' },
38
+ ];
39
+
40
+ describe('KanbanPage', () => {
41
+ it('renders page header with kicker, title, and subtitle', () => {
42
+ render(
43
+ <MemoryRouter>
44
+ <KanbanPage<ProjectDeal>
45
+ kicker="Sales CRM"
46
+ title="Pipeline Deals"
47
+ subtitle="All active enterprise deals across stages"
48
+ columns={COLUMNS}
49
+ items={ITEMS}
50
+ />
51
+ </MemoryRouter>,
52
+ );
53
+
54
+ expect(screen.getByText('Sales CRM')).toBeDefined();
55
+ expect(screen.getByText('Pipeline Deals')).toBeDefined();
56
+ expect(screen.getByText('All active enterprise deals across stages')).toBeDefined();
57
+ });
58
+
59
+ it('renders KPI cards', () => {
60
+ render(
61
+ <MemoryRouter>
62
+ <KanbanPage<ProjectDeal>
63
+ title="Pipeline Deals"
64
+ kpis={KPIS}
65
+ columns={COLUMNS}
66
+ items={ITEMS}
67
+ />
68
+ </MemoryRouter>,
69
+ );
70
+
71
+ expect(screen.getByText('Active Pipeline')).toBeDefined();
72
+ expect(screen.getByText('$165,000')).toBeDefined();
73
+ expect(screen.getByText('Deals in Progress')).toBeDefined();
74
+ expect(screen.getByText('2')).toBeDefined();
75
+ });
76
+
77
+ it('renders search input and responds to change events', () => {
78
+ const handleSearch = vi.fn();
79
+ render(
80
+ <MemoryRouter>
81
+ <KanbanPage<ProjectDeal>
82
+ title="Pipeline Deals"
83
+ search={{
84
+ value: '',
85
+ onChange: handleSearch,
86
+ placeholder: 'Search deals...',
87
+ }}
88
+ columns={COLUMNS}
89
+ items={ITEMS}
90
+ />
91
+ </MemoryRouter>,
92
+ );
93
+
94
+ const input = screen.getByPlaceholderText('Search deals...');
95
+ expect(input).toBeDefined();
96
+
97
+ fireEvent.change(input, { target: { value: 'Acme' } });
98
+ expect(handleSearch).toHaveBeenCalledWith('Acme');
99
+ });
100
+
101
+ it('renders footer when provided', () => {
102
+ render(
103
+ <MemoryRouter>
104
+ <KanbanPage<ProjectDeal>
105
+ title="Pipeline Deals"
106
+ columns={COLUMNS}
107
+ items={ITEMS}
108
+ footer={<div data-testid="page-footer">Custom Footer Note</div>}
109
+ />
110
+ </MemoryRouter>,
111
+ );
112
+
113
+ expect(screen.getByTestId('page-footer')).toBeDefined();
114
+ });
115
+ });
@@ -0,0 +1,91 @@
1
+ import { type ReactNode } from 'react';
2
+ import { Search } from 'lucide-react';
3
+ import { PageHeader } from '@umituz/web-design-system/templates';
4
+ import type { KanbanPageProps } from '../types';
5
+ import { KanbanBoard } from './KanbanBoard';
6
+
7
+ export function KanbanPage<T = unknown>({
8
+ kicker,
9
+ title,
10
+ subtitle,
11
+ actions,
12
+ callout,
13
+ kpis,
14
+ search,
15
+ filterBar,
16
+ loading = false,
17
+ footer,
18
+ children,
19
+ className,
20
+ ...boardProps
21
+ }: KanbanPageProps<T>): ReactNode {
22
+ return (
23
+ <div className={`udb-kanban-page${className ? ` ${className}` : ''}`}>
24
+ <PageHeader
25
+ title={title}
26
+ subtitle={subtitle}
27
+ kicker={kicker}
28
+ actions={actions}
29
+ />
30
+
31
+ {callout && <div className="udb-kanban-callout">{callout}</div>}
32
+
33
+ {kpis && kpis.length > 0 && (
34
+ <div className="udb-kanban-kpis">
35
+ {kpis.map((kpi) => (
36
+ <div key={kpi.label} className="udb-kanban-kpi-card">
37
+ <div className="udb-kanban-kpi-label">{kpi.label}</div>
38
+ <div className="udb-kanban-kpi-value">{kpi.value}</div>
39
+ {kpi.hint && <div className="udb-kanban-kpi-hint">{kpi.hint}</div>}
40
+ </div>
41
+ ))}
42
+ </div>
43
+ )}
44
+
45
+ {(search || filterBar) && (
46
+ <div className="udb-kanban-toolbar">
47
+ {search ? (
48
+ <div className="udb-kanban-search-box">
49
+ <span className="udb-kanban-search-icon" aria-hidden="true">
50
+ <Search size={15} />
51
+ </span>
52
+ <input
53
+ type="text"
54
+ className="udb-kanban-search-input"
55
+ placeholder={search.placeholder ?? 'Filter cards…'}
56
+ value={search.value}
57
+ onChange={(e) => search.onChange(e.target.value)}
58
+ />
59
+ </div>
60
+ ) : (
61
+ <div />
62
+ )}
63
+
64
+ {filterBar}
65
+ </div>
66
+ )}
67
+
68
+ {loading ? (
69
+ <div className="udb-kanban-loading" aria-busy="true">
70
+ <div className="udb-kanban-board">
71
+ {boardProps.columns.map((col) => (
72
+ <div key={col.id} className="udb-kanban-col">
73
+ <div className="udb-kanban-col-head">
74
+ <span className="udb-kanban-col-title">{col.title}</span>
75
+ </div>
76
+ <div className="udb-kanban-col-body">
77
+ <div className="udb-kanban-empty-col">Loading…</div>
78
+ </div>
79
+ </div>
80
+ ))}
81
+ </div>
82
+ </div>
83
+ ) : (
84
+ <KanbanBoard<T> {...boardProps} />
85
+ )}
86
+
87
+ {footer && <div className="udb-kanban-footer">{footer}</div>}
88
+ {children}
89
+ </div>
90
+ );
91
+ }
@@ -0,0 +1,4 @@
1
+ export { KanbanBoard } from './KanbanBoard';
2
+ export { KanbanColumn, type KanbanColumnProps } from './KanbanColumn';
3
+ export { KanbanCard, type KanbanCardProps } from './KanbanCard';
4
+ export { KanbanPage } from './KanbanPage';
@@ -0,0 +1,12 @@
1
+ export type {
2
+ KanbanTone,
3
+ KanbanTag,
4
+ KanbanAssignee,
5
+ KanbanItem,
6
+ KanbanColumn,
7
+ KanbanCardActions,
8
+ KanbanBoardProps,
9
+ KanbanKpi,
10
+ KanbanPageProps,
11
+ } from './types';
12
+ export * from './components';