@widgetic/file-browser 0.5.42 → 0.5.43

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,41 @@
1
+ import type { FileSystemItem } from '../types';
2
+ export type DragGhostLayer = {
3
+ item: FileSystemItem;
4
+ x: number;
5
+ y: number;
6
+ offsetX: number;
7
+ offsetY: number;
8
+ rotate: number;
9
+ scale: number;
10
+ opacity: number;
11
+ };
12
+ export type SelectedItemDragSnapshot = {
13
+ active: boolean;
14
+ phase: 'idle' | 'pending' | 'dragging' | 'dropping' | 'canceling';
15
+ pointerX: number;
16
+ pointerY: number;
17
+ anchorX: number;
18
+ anchorY: number;
19
+ layers: DragGhostLayer[];
20
+ totalCount: number;
21
+ hoverFolderId: string | null;
22
+ reducedMotion: boolean;
23
+ dropPulseFolderId: string | null;
24
+ };
25
+ export declare const idleDragSnapshot: () => SelectedItemDragSnapshot;
26
+ export type DragSelectedToFolderOptions = {
27
+ getContainer: () => HTMLElement | null;
28
+ getScrollContainer: () => HTMLElement | null;
29
+ getSelectedInView: () => FileSystemItem[];
30
+ getImmediateParentId: () => string | null;
31
+ getRoot: () => FileSystemItem;
32
+ isEnabled: () => boolean;
33
+ prefersReducedMotion: () => boolean;
34
+ onSnapshot: (snapshot: SelectedItemDragSnapshot) => void;
35
+ onDrop: (targetFolderId: string, items: FileSystemItem[]) => void;
36
+ debugLog?: boolean;
37
+ };
38
+ export declare function createDragSelectedToFolderController(options: DragSelectedToFolderOptions): {
39
+ detach: () => void;
40
+ getSnapshot: () => SelectedItemDragSnapshot;
41
+ };
@@ -0,0 +1,320 @@
1
+ import { canDropOnFolder, resolveFolderDropTarget } from '../utils/dragToFolder/folderDropTarget';
2
+ import { DEFAULT_GHOST_FOLLOW_FACTOR, layerFollowFactor, springLerpPoint } from '../utils/dragToFolder/springStep';
3
+ export const idleDragSnapshot = () => ({
4
+ active: false,
5
+ phase: 'idle',
6
+ pointerX: 0,
7
+ pointerY: 0,
8
+ anchorX: 0,
9
+ anchorY: 0,
10
+ layers: [],
11
+ totalCount: 0,
12
+ hoverFolderId: null,
13
+ reducedMotion: false,
14
+ dropPulseFolderId: null
15
+ });
16
+ const MOVE_THRESHOLD_PX = 5;
17
+ const MAX_STACK_LAYERS = 4;
18
+ export function createDragSelectedToFolderController(options) {
19
+ let snapshot = idleDragSnapshot();
20
+ let activePointerId = null;
21
+ let pressClientX = 0;
22
+ let pressClientY = 0;
23
+ let originClientX = 0;
24
+ let originClientY = 0;
25
+ let dragging = false;
26
+ let items = [];
27
+ let rafId = null;
28
+ let hoverElement = null;
29
+ let autoScrollFrame = null;
30
+ let disposed = false;
31
+ const setSnapshot = (next) => {
32
+ snapshot = { ...snapshot, ...next };
33
+ options.onSnapshot({ ...snapshot });
34
+ };
35
+ const clearHover = () => {
36
+ if (hoverElement) {
37
+ hoverElement.removeAttribute('data-folder-drop-hover');
38
+ hoverElement = null;
39
+ }
40
+ setSnapshot({ hoverFolderId: null });
41
+ };
42
+ const markSources = (on) => {
43
+ const container = options.getContainer();
44
+ if (!container)
45
+ return;
46
+ container.querySelectorAll('.item-container[data-selected="true"]').forEach((el) => {
47
+ if (on)
48
+ el.setAttribute('data-dragging-source', 'true');
49
+ else
50
+ el.removeAttribute('data-dragging-source');
51
+ });
52
+ if (on)
53
+ document.body.classList.add('fb-dragging-selected-files');
54
+ else
55
+ document.body.classList.remove('fb-dragging-selected-files');
56
+ };
57
+ const buildLayers = () => {
58
+ const show = items.slice(0, MAX_STACK_LAYERS);
59
+ return show.map((item, index) => ({
60
+ item,
61
+ x: originClientX,
62
+ y: originClientY,
63
+ offsetX: -index * 6,
64
+ offsetY: -index * 8,
65
+ rotate: index % 2 === 0 ? -4 + index * 2 : 3 - index,
66
+ scale: 1 - index * 0.04,
67
+ opacity: 1 - index * 0.08
68
+ }));
69
+ };
70
+ const stopAutoScroll = () => {
71
+ if (autoScrollFrame != null) {
72
+ cancelAnimationFrame(autoScrollFrame);
73
+ autoScrollFrame = null;
74
+ }
75
+ };
76
+ const autoScrollStep = () => {
77
+ const scrollEl = options.getScrollContainer();
78
+ if (!scrollEl || !dragging) {
79
+ stopAutoScroll();
80
+ return;
81
+ }
82
+ const rect = scrollEl.getBoundingClientRect();
83
+ const edge = 56;
84
+ const maxStep = 14;
85
+ let delta = 0;
86
+ if (snapshot.pointerY < rect.top + edge) {
87
+ delta = -maxStep;
88
+ }
89
+ else if (snapshot.pointerY > rect.bottom - edge) {
90
+ delta = maxStep;
91
+ }
92
+ if (delta !== 0) {
93
+ scrollEl.scrollTop += delta;
94
+ }
95
+ autoScrollFrame = requestAnimationFrame(autoScrollStep);
96
+ };
97
+ const tick = () => {
98
+ if (!dragging || disposed)
99
+ return;
100
+ const reduced = options.prefersReducedMotion();
101
+ const layers = snapshot.layers.map((layer, index) => {
102
+ const factor = reduced ? 1 : layerFollowFactor(index, DEFAULT_GHOST_FOLLOW_FACTOR);
103
+ const next = springLerpPoint({ x: layer.x + layer.offsetX, y: layer.y + layer.offsetY }, { x: snapshot.pointerX + layer.offsetX, y: snapshot.pointerY + layer.offsetY }, factor);
104
+ return {
105
+ ...layer,
106
+ x: next.x - layer.offsetX,
107
+ y: next.y - layer.offsetY
108
+ };
109
+ });
110
+ setSnapshot({ layers });
111
+ rafId = requestAnimationFrame(tick);
112
+ };
113
+ const beginDrag = () => {
114
+ if (dragging)
115
+ return;
116
+ dragging = true;
117
+ if (options.debugLog)
118
+ console.log('[file-browser] drag-selected: start', items.map((i) => i.id));
119
+ const layers = buildLayers();
120
+ setSnapshot({
121
+ active: true,
122
+ phase: 'dragging',
123
+ layers,
124
+ totalCount: items.length,
125
+ anchorX: originClientX,
126
+ anchorY: originClientY,
127
+ reducedMotion: options.prefersReducedMotion()
128
+ });
129
+ markSources(true);
130
+ rafId = requestAnimationFrame(tick);
131
+ autoScrollFrame = requestAnimationFrame(autoScrollStep);
132
+ };
133
+ const animateToFolderAndFinish = (target, folderId) => {
134
+ const rect = target.getBoundingClientRect();
135
+ const endX = rect.left + rect.width / 2;
136
+ const endY = rect.top + rect.height / 2;
137
+ setSnapshot({ phase: 'dropping', active: true, dropPulseFolderId: folderId });
138
+ target.setAttribute('data-folder-drop-pulse', 'true');
139
+ window.setTimeout(() => target.removeAttribute('data-folder-drop-pulse'), 420);
140
+ const start = performance.now();
141
+ const duration = options.prefersReducedMotion() ? 140 : 320;
142
+ const fromLayers = snapshot.layers;
143
+ const dropFrame = (now) => {
144
+ const t = Math.min(1, (now - start) / duration);
145
+ const ease = 1 - Math.pow(1 - t, 3);
146
+ const layers = fromLayers.map((layer) => ({
147
+ ...layer,
148
+ x: layer.x + (endX - layer.x - layer.offsetX) * ease,
149
+ y: layer.y + (endY - layer.y - layer.offsetY) * ease,
150
+ scale: layer.scale * (1 - 0.35 * ease),
151
+ opacity: layer.opacity * (1 - ease)
152
+ }));
153
+ setSnapshot({ layers, pointerX: endX, pointerY: endY });
154
+ if (t < 1) {
155
+ requestAnimationFrame(dropFrame);
156
+ }
157
+ else {
158
+ finishDrop(folderId);
159
+ }
160
+ };
161
+ requestAnimationFrame(dropFrame);
162
+ };
163
+ const finishDrop = (folderId) => {
164
+ if (options.debugLog)
165
+ console.log('[file-browser] drag-selected: drop', folderId);
166
+ options.onDrop(folderId, items);
167
+ resetAfterGesture();
168
+ };
169
+ const cancelToOrigin = () => {
170
+ setSnapshot({ phase: 'canceling' });
171
+ const fromLayers = snapshot.layers;
172
+ const duration = options.prefersReducedMotion() ? 120 : 260;
173
+ const start = performance.now();
174
+ const cancelFrame = (now) => {
175
+ const t = Math.min(1, (now - start) / duration);
176
+ const ease = 1 - Math.pow(1 - t, 2);
177
+ const layers = fromLayers.map((layer) => ({
178
+ ...layer,
179
+ x: layer.x + (originClientX - layer.x) * ease,
180
+ y: layer.y + (originClientY - layer.y) * ease,
181
+ opacity: layer.opacity * (1 - ease * 0.85)
182
+ }));
183
+ setSnapshot({ layers });
184
+ if (t < 1)
185
+ requestAnimationFrame(cancelFrame);
186
+ else
187
+ resetAfterGesture();
188
+ };
189
+ requestAnimationFrame(cancelFrame);
190
+ };
191
+ const resetAfterGesture = () => {
192
+ dragging = false;
193
+ activePointerId = null;
194
+ items = [];
195
+ stopAutoScroll();
196
+ if (rafId != null)
197
+ cancelAnimationFrame(rafId);
198
+ rafId = null;
199
+ clearHover();
200
+ markSources(false);
201
+ snapshot = idleDragSnapshot();
202
+ options.onSnapshot(snapshot);
203
+ };
204
+ const isFromMenuOrThumb = (target) => {
205
+ return Boolean(target.closest('[data-fb-menu-root]') ||
206
+ target.closest('button[data-fb-action="preview"]') ||
207
+ target.closest('button[data-fb-action="open-folder"]'));
208
+ };
209
+ const onPointerDown = (event) => {
210
+ if (disposed || !options.isEnabled())
211
+ return;
212
+ if (event.pointerType === 'touch')
213
+ return;
214
+ if (event.button !== 0)
215
+ return;
216
+ const target = event.target;
217
+ if (isFromMenuOrThumb(target))
218
+ return;
219
+ const container = options.getContainer();
220
+ if (!container || !container.contains(target))
221
+ return;
222
+ const itemEl = target.closest('.item-container');
223
+ if (!itemEl || itemEl.getAttribute('data-selected') !== 'true')
224
+ return;
225
+ const openFolder = itemEl.querySelector('[data-fb-action="open-folder"]');
226
+ if (openFolder)
227
+ return;
228
+ const selected = options.getSelectedInView();
229
+ if (selected.length === 0)
230
+ return;
231
+ activePointerId = event.pointerId;
232
+ pressClientX = event.clientX;
233
+ pressClientY = event.clientY;
234
+ originClientX = event.clientX;
235
+ originClientY = event.clientY;
236
+ items = selected;
237
+ setSnapshot({
238
+ ...idleDragSnapshot(),
239
+ phase: 'pending',
240
+ pointerX: event.clientX,
241
+ pointerY: event.clientY,
242
+ totalCount: selected.length,
243
+ reducedMotion: options.prefersReducedMotion()
244
+ });
245
+ };
246
+ const onPointerMove = (event) => {
247
+ if (activePointerId == null || event.pointerId !== activePointerId)
248
+ return;
249
+ setSnapshot({ pointerX: event.clientX, pointerY: event.clientY });
250
+ const distance = Math.hypot(event.clientX - pressClientX, event.clientY - pressClientY);
251
+ if (!dragging && distance >= MOVE_THRESHOLD_PX) {
252
+ beginDrag();
253
+ }
254
+ if (!dragging)
255
+ return;
256
+ const resolved = resolveFolderDropTarget(event.clientX, event.clientY);
257
+ const root = options.getRoot();
258
+ const parentId = options.getImmediateParentId();
259
+ let nextHover = null;
260
+ let hoverId = null;
261
+ if (resolved && canDropOnFolder(resolved.folderId, items, parentId, root)) {
262
+ nextHover = resolved.element;
263
+ hoverId = resolved.folderId;
264
+ }
265
+ if (hoverElement !== nextHover) {
266
+ clearHover();
267
+ hoverElement = nextHover;
268
+ if (hoverElement)
269
+ hoverElement.setAttribute('data-folder-drop-hover', 'true');
270
+ setSnapshot({ hoverFolderId: hoverId });
271
+ }
272
+ };
273
+ const onPointerUp = (event) => {
274
+ if (activePointerId == null || event.pointerId !== activePointerId)
275
+ return;
276
+ if (!dragging) {
277
+ activePointerId = null;
278
+ snapshot = idleDragSnapshot();
279
+ options.onSnapshot(snapshot);
280
+ return;
281
+ }
282
+ const resolved = resolveFolderDropTarget(event.clientX, event.clientY);
283
+ const root = options.getRoot();
284
+ const parentId = options.getImmediateParentId();
285
+ if (resolved &&
286
+ canDropOnFolder(resolved.folderId, items, parentId, root) &&
287
+ resolved.folderId) {
288
+ animateToFolderAndFinish(resolved.element, resolved.folderId);
289
+ }
290
+ else {
291
+ if (options.debugLog)
292
+ console.log('[file-browser] drag-selected: cancel');
293
+ cancelToOrigin();
294
+ }
295
+ };
296
+ const onKeyDown = (event) => {
297
+ if (event.key === 'Escape' && dragging) {
298
+ event.preventDefault();
299
+ cancelToOrigin();
300
+ }
301
+ };
302
+ const attach = () => {
303
+ window.addEventListener('pointerdown', onPointerDown, true);
304
+ window.addEventListener('pointermove', onPointerMove, true);
305
+ window.addEventListener('pointerup', onPointerUp, true);
306
+ window.addEventListener('pointercancel', onPointerUp, true);
307
+ window.addEventListener('keydown', onKeyDown, true);
308
+ };
309
+ const detach = () => {
310
+ disposed = true;
311
+ window.removeEventListener('pointerdown', onPointerDown, true);
312
+ window.removeEventListener('pointermove', onPointerMove, true);
313
+ window.removeEventListener('pointerup', onPointerUp, true);
314
+ window.removeEventListener('pointercancel', onPointerUp, true);
315
+ window.removeEventListener('keydown', onKeyDown, true);
316
+ resetAfterGesture();
317
+ };
318
+ attach();
319
+ return { detach, getSnapshot: () => snapshot };
320
+ }