vgapp 1.3.3 → 1.3.5

package/app/modules/vgfiles/readme.md

@@ -1,123 +1,123 @@
-# VGFiles
-
-`VGFiles` — модуль загрузки и управления файлами с поддержкой локального режима и AJAX.
-
-## Новые фичи
-
-- Поддержка `replace` для single-mode (`limits.count = 1`): новый файл заменяет предыдущий без накопления.
-- Переименование входящих файлов через `rename: true | (file, index) => string`.
-- `smartdrop`: глобальная подсветка dropzone, если на экране только одна видимая зона дропа.
-- Расширенный lifecycle для внешних файлов из `data-file`: парсинг `customData`, `src/image`, бинарных метаданных.
-- Интеграция с `VGFilePreview` в info-списке (`ui.nameOnly: true`) для inline-аудио, скачивания и предпросмотра по клику.
-- Авто-обогащение аудиофайлов метаданными (title/cover) через `extractAudioMetadata`.
-- Гибкие confirm-хуки для удаления (`removes.single.confirm`, `removes.all.confirm`) с контрактом `accepted/data`.
-- Повторная загрузка упавших файлов через `data-vg-reload="file"` и кнопки retry.
-- Проброс `customData` файла в `data-*` атрибуты элементов списка.
-
-## Базовые возможности
-
-- Выбор файлов через `<input type="file">` и drag&drop.
-- Лимиты: количество, размер файла, общий размер, MIME-типы.
-- Режимы загрузки: `sequential` и `parallel`.
-- Автоматическая/ручная инициализация.
-- Сортировка загруженных файлов с сохранением порядка на сервере.
-- Удаление одного файла и очистка всего списка.
-
-## Инициализация
-
-```js
-const files = new VGFiles(document.querySelector('.vg-files'), {
-  ajax: true,
-  smartdrop: true,
-  rename: true,
-  replace: true,
-  uploads: {
-    route: '/api/upload',
-    mode: 'sequential'
-  },
-  limits: {
-    count: 10,
-    sizes: 5,
-    total: 50
-  }
-});
-```
-
-## Ключевые параметры
-
-- `allowed` — разрешить drag-drop режим и особенности drop-зоны.
-- `ajax` — включить серверную загрузку.
-- `replace` (`default: true`) — замена файла в single-mode.
-- `rename` (`default: false`) — переименование файлов до добавления в список.
-- `smartdrop` (`default: false`) — глобальная логика подсказки drop-зоны.
-- `prepend` (`default: true`) — добавление новых файлов в начало.
-- `uploads.mode` — `'sequential' | 'parallel'`.
-- `uploads.maxParallel`, `uploads.maxConcurrent`, `uploads.retryAttempts`, `uploads.retryDelay`.
-- `removes.single.confirm`, `removes.all.confirm` — кастомные confirm-обработчики.
-- `sortable.enabled`, `sortable.route`, `sortable.handle`, `sortable.lists`.
-
-## Внешние (уже загруженные) файлы
-
-Модуль может стартовать с предзаполненным списком через `data-file` в `<li>`.
-
-Поддерживаемые поля объекта:
-
-- `id`, `name`, `size`, `type`, `src` (обязательный набор для валидного внешнего файла)
-- `image` (опционально)
-- `lastModified` / `last-modified` (опционально)
-- любые дополнительные поля -> попадают в `customData`
-
-`customData` дальше пробрасывается в `data-*` атрибуты элементов файла и может использоваться в шаблонах/интеграциях.
-
-## AJAX-события и callbacks
-
-DOM-события:
-
-- `vg.files.change`
-- `vg.files.upload.start`
-- `vg.files.upload.progress`
-- `vg.files.upload.complete`
-- `vg.files.upload.error`
-- `vg.files.upload.allComplete`
-- `vg.files.remove`
-- `vg.files.reload`
-
-Callbacks (`params.callbacks`):
-
-- `onInit`
-- `onChange` (`{ files, input, inputFiles }`)
-- `onUploadStart`
-- `onUploadProgress`
-- `onUploadComplete`
-- `onUploadError`
-- `onUploadAllComplete`
-- `onRemoveFile`
-- `onClear`
-- `onReload`
-
-## Удаление с кастомным confirm
-
-Если передан `removes.single.confirm` или `removes.all.confirm`, модуль вызывает вашу функцию вместо стандартного `VGAlert`.
-
-Контракт результата:
-
-- `true` или `{ accepted: true }` — подтвердить.
-- `false` или `{ accepted: false }` — отменить.
-- `{ accepted: true, data }` — подтвердить и использовать готовый ответ удаления (без дополнительного AJAX-запроса).
-
-## Статусы файлов
-
-- `pending` — ожидает загрузки.
-- `loading` — идет загрузка.
-- `completed` — успешно загружен.
-- `failing` — ошибка загрузки (доступен reload).
-
-## Методы API
-
-- `upload(file)`
-- `uploadAll(files)`
-- `reload(button)`
-- `removeFile(button)`
-- `clear(resetInput, uiOnly)`
-- `dispose()`
-
+# VGFiles
+
+`VGFiles` — модуль загрузки и управления файлами с поддержкой локального режима и AJAX.
+
+## Новые фичи
+
+- Поддержка `replace` для single-mode (`limits.count = 1`): новый файл заменяет предыдущий без накопления.
+- Переименование входящих файлов через `rename: true | (file, index) => string`.
+- `smartdrop`: глобальная подсветка dropzone, если на экране только одна видимая зона дропа.
+- Расширенный lifecycle для внешних файлов из `data-file`: парсинг `customData`, `src/image`, бинарных метаданных.
+- Интеграция с `VGFilePreview` в info-списке (`ui.nameOnly: true`) для inline-аудио, скачивания и предпросмотра по клику.
+- Авто-обогащение аудиофайлов метаданными (title/cover) через `extractAudioMetadata`.
+- Гибкие confirm-хуки для удаления (`removes.single.confirm`, `removes.all.confirm`) с контрактом `accepted/data`.
+- Повторная загрузка упавших файлов через `data-vg-reload="file"` и кнопки retry.
+- Проброс `customData` файла в `data-*` атрибуты элементов списка.
+
+## Базовые возможности
+
+- Выбор файлов через `<input type="file">` и drag&drop.
+- Лимиты: количество, размер файла, общий размер, MIME-типы.
+- Режимы загрузки: `sequential` и `parallel`.
+- Автоматическая/ручная инициализация.
+- Сортировка загруженных файлов с сохранением порядка на сервере.
+- Удаление одного файла и очистка всего списка.
+
+## Инициализация
+
+```js
+const files = new VGFiles(document.querySelector('.vg-files'), {
+  ajax: true,
+  smartdrop: true,
+  rename: true,
+  replace: true,
+  uploads: {
+    route: '/api/upload',
+    mode: 'sequential'
+  },
+  limits: {
+    count: 10,
+    sizes: 5,
+    total: 50
+  }
+});
+```
+
+## Ключевые параметры
+
+- `allowed` — разрешить drag-drop режим и особенности drop-зоны.
+- `ajax` — включить серверную загрузку.
+- `replace` (`default: true`) — замена файла в single-mode.
+- `rename` (`default: false`) — переименование файлов до добавления в список.
+- `smartdrop` (`default: false`) — глобальная логика подсказки drop-зоны.
+- `prepend` (`default: true`) — добавление новых файлов в начало.
+- `uploads.mode` — `'sequential' | 'parallel'`.
+- `uploads.maxParallel`, `uploads.maxConcurrent`, `uploads.retryAttempts`, `uploads.retryDelay`.
+- `removes.single.confirm`, `removes.all.confirm` — кастомные confirm-обработчики.
+- `sortable.enabled`, `sortable.route`, `sortable.handle`, `sortable.lists`.
+
+## Внешние (уже загруженные) файлы
+
+Модуль может стартовать с предзаполненным списком через `data-file` в `<li>`.
+
+Поддерживаемые поля объекта:
+
+- `id`, `name`, `size`, `type`, `src` (обязательный набор для валидного внешнего файла)
+- `image` (опционально)
+- `lastModified` / `last-modified` (опционально)
+- любые дополнительные поля -> попадают в `customData`
+
+`customData` дальше пробрасывается в `data-*` атрибуты элементов файла и может использоваться в шаблонах/интеграциях.
+
+## AJAX-события и callbacks
+
+DOM-события:
+
+- `vg.files.change`
+- `vg.files.upload.start`
+- `vg.files.upload.progress`
+- `vg.files.upload.complete`
+- `vg.files.upload.error`
+- `vg.files.upload.allComplete`
+- `vg.files.remove`
+- `vg.files.reload`
+
+Callbacks (`params.callbacks`):
+
+- `onInit`
+- `onChange` (`{ files, input, inputFiles }`)
+- `onUploadStart`
+- `onUploadProgress`
+- `onUploadComplete`
+- `onUploadError`
+- `onUploadAllComplete`
+- `onRemoveFile`
+- `onClear`
+- `onReload`
+
+## Удаление с кастомным confirm
+
+Если передан `removes.single.confirm` или `removes.all.confirm`, модуль вызывает вашу функцию вместо стандартного `VGAlert`.
+
+Контракт результата:
+
+- `true` или `{ accepted: true }` — подтвердить.
+- `false` или `{ accepted: false }` — отменить.
+- `{ accepted: true, data }` — подтвердить и использовать готовый ответ удаления (без дополнительного AJAX-запроса).
+
+## Статусы файлов
+
+- `pending` — ожидает загрузки.
+- `loading` — идет загрузка.
+- `completed` — успешно загружен.
+- `failing` — ошибка загрузки (доступен reload).
+
+## Методы API
+
+- `upload(file)`
+- `uploadAll(files)`
+- `reload(button)`
+- `removeFile(button)`
+- `clear(resetInput, uiOnly)`
+- `dispose()`
+

package/app/modules/vgfiles/scss/_variables.scss

@@ -70,27 +70,27 @@ $files-map: (
 	info-radius: 4px,
 	info-list-max-height: 360px,
 
-	info-gap: 8px,
-	info-padding: 8px,
-	info-border-bottom-color: var(--vg-secondary-bg),
-	info-hover-bg: rgba(var(--vg-secondary-bg-rgb), .4),
-	info-audio-progress-track: rgba(var(--vg-secondary-bg-rgb), .3),
-	info-audio-progress-fill: #000,
-	info-audio-progress-opacity: .33,
-	info-audio-row-min-height: 64px,
-	info-audio-image-size: 48px,
-
-	info-image-radius: 4px,
+	info-gap: 8px,
+	info-padding: 8px,
+	info-border-bottom-color: var(--vg-secondary-bg),
+	info-hover-bg: rgba(var(--vg-secondary-bg-rgb), .4),
+	info-audio-progress-track: rgba(var(--vg-secondary-bg-rgb), .3),
+	info-audio-progress-fill: #000,
+	info-audio-progress-opacity: .33,
+	info-audio-row-min-height: 64px,
+	info-audio-image-size: 48px,
+
+	info-image-radius: 4px,
 	info-iteration-font-size: 16px,
 	info-name-font-size: 16px,
 	info-size-font-size: 14px,
 
-	info-remove-icon-size: 16px,
-	info-row-remove-size: 22px,
-	info-row-remove-icon-size: 10px,
-	info-failing-actions-gap: 6px,
-	info-failing-actions-margin-start: 8px,
-	drop-failing-actions-gap: 6px,
+	info-remove-icon-size: 16px,
+	info-row-remove-size: 22px,
+	info-row-remove-icon-size: 10px,
+	info-failing-actions-gap: 6px,
+	info-failing-actions-margin-start: 8px,
+	drop-failing-actions-gap: 6px,
 
 	// legacy (оставлено для совместимости со старым API темы)
 	info-mb: 10px,
@@ -112,4 +112,4 @@ $files-map: (
 	info-list-span-me: 6px,
 	info-list-button-fs: 12px,
 	info-list-button-color: #999999,
-);
+);

package/app/modules/vgfiles/scss/vgfiles.scss

@@ -261,15 +261,15 @@
 				}
 			}
 
-			.file {
-				--vg-button-color: var(--vg-secondary);
-				display: flex;
-				align-items: center;
-				gap: var(--vg-files-info-gap);
-				padding: var(--vg-files-info-padding);
-				border-bottom: 1px solid var(--vg-files-info-border-bottom-color);
-				transition: all .2s ease-in-out;
-				position: relative;
+			.file {
+				--vg-button-color: var(--vg-secondary);
+				display: flex;
+				align-items: center;
+				gap: var(--vg-files-info-gap);
+				padding: var(--vg-files-info-padding);
+				border-bottom: 1px solid var(--vg-files-info-border-bottom-color);
+				transition: all .2s ease-in-out;
+				position: relative;
 
 				@include vgfiles-sortable();
 				@include vgfiles-state();
@@ -278,45 +278,45 @@
 					border-bottom: none;
 				}
 
-				&:hover {
-					background-color: var(--vg-files-info-hover-bg);
-				}
-
-				&[data-vg-filepreview-renderer="audio"] {
-					--vg-filepreview-audio-inline-progress: 0%;
-					position: relative;
-					overflow: hidden;
-					isolation: isolate;
-					min-height: var(--vg-files-info-audio-row-min-height);
-					background-color: var(--vg-files-info-audio-progress-track);
-
-					&::before {
-						content: '';
-						position: absolute;
-						inset: 0 auto 0 0;
-						width: var(--vg-filepreview-audio-inline-progress);
-						background: var(--vg-files-info-audio-progress-fill);
-						opacity: var(--vg-files-info-audio-progress-opacity);
-						pointer-events: none;
-						z-index: 0;
-						transition: width .12s linear;
-					}
-
-					> * {
-						position: relative;
-						z-index: 1;
-					}
-
-					.file-image {
-						flex: 0 0 var(--vg-files-info-audio-image-size);
-						width: var(--vg-files-info-audio-image-size);
-						height: var(--vg-files-info-audio-image-size);
-					}
-				}
-
-				> * {
-					transition: all .2s ease-in-out;
-				}
+				&:hover {
+					background-color: var(--vg-files-info-hover-bg);
+				}
+
+				&[data-vg-filepreview-renderer="audio"] {
+					--vg-filepreview-audio-inline-progress: 0%;
+					position: relative;
+					overflow: hidden;
+					isolation: isolate;
+					min-height: var(--vg-files-info-audio-row-min-height);
+					background-color: var(--vg-files-info-audio-progress-track);
+
+					&::before {
+						content: '';
+						position: absolute;
+						inset: 0 auto 0 0;
+						width: var(--vg-filepreview-audio-inline-progress);
+						background: var(--vg-files-info-audio-progress-fill);
+						opacity: var(--vg-files-info-audio-progress-opacity);
+						pointer-events: none;
+						z-index: 0;
+						transition: width .12s linear;
+					}
+
+					> * {
+						position: relative;
+						z-index: 1;
+					}
+
+					.file-image {
+						flex: 0 0 var(--vg-files-info-audio-image-size);
+						width: var(--vg-files-info-audio-image-size);
+						height: var(--vg-files-info-audio-image-size);
+					}
+				}
+
+				> * {
+					transition: all .2s ease-in-out;
+				}
 
 				&-image {
 					flex: 0 0 var(--vg-files-image-width);
@@ -362,63 +362,63 @@
 						display: none;
 					}
 
-					.name {
-						display: block;
-						overflow: hidden;
-						text-overflow: ellipsis;
-						white-space: nowrap;
-						font-size: var(--vg-files-info-name-font-size);
-
-						&.vg-filepreview-audio-inline {
-							display: inline-flex;
-							gap: var(--vg-filepreview-audio-inline-gap);
-							align-items: center;
-						}
-
-						&.is-preview-action {
-							cursor: pointer;
-						}
-					}
-
-					.size {
-						color: var(--vg-secondary);
-						font-size: var(--vg-files-info-size-font-size);
-						white-space: nowrap;
-						margin-left: auto;
-					}
-
-					.download {
-						margin-left: 8px;
-
-						.vg-filepreview-download-trigger {
-							padding: 0;
-							background: transparent;
-							color: var(--vg-secondary);
-							border-radius: 0;
-							font-size: var(--vg-files-info-size-font-size);
-							font-weight: 500;
-							gap: 4px;
-
-							&:hover {
-								color: var(--vg-body-color);
-							}
-
-							&__icon svg {
-								width: 14px;
-								height: 14px;
-							}
-
-							&__text {
-								display: none;
-							}
-						}
-					}
-				}
-
-				&-remove {
-					flex: 0 0 var(--vg-files-remove-width);
-					width: var(--vg-files-remove-width);
-					margin-left: auto;
+					.name {
+						display: block;
+						overflow: hidden;
+						text-overflow: ellipsis;
+						white-space: nowrap;
+						font-size: var(--vg-files-info-name-font-size);
+
+						&.vg-filepreview-audio-inline {
+							display: inline-flex;
+							gap: var(--vg-filepreview-audio-inline-gap);
+							align-items: center;
+						}
+
+						&.is-preview-action {
+							cursor: pointer;
+						}
+					}
+
+					.size {
+						color: var(--vg-secondary);
+						font-size: var(--vg-files-info-size-font-size);
+						white-space: nowrap;
+						margin-left: auto;
+					}
+
+					.download {
+						margin-left: 8px;
+
+						.vg-filepreview-download-trigger {
+							padding: 0;
+							background: transparent;
+							color: var(--vg-secondary);
+							border-radius: 0;
+							font-size: var(--vg-files-info-size-font-size);
+							font-weight: 500;
+							gap: 4px;
+
+							&:hover {
+								color: var(--vg-body-color);
+							}
+
+							&__icon svg {
+								width: 14px;
+								height: 14px;
+							}
+
+							&__text {
+								display: none;
+							}
+						}
+					}
+				}
+
+				&-remove {
+					flex: 0 0 var(--vg-files-remove-width);
+					width: var(--vg-files-remove-width);
+					margin-left: auto;
 
 					button {
 						width: var(--vg-files-remove-width);
@@ -451,21 +451,21 @@
 									fill: var(--vg-button-color);
 								}
 							}
-						}
-					}
-				}
-
-				&.failing {
-					.file-remove {
-						flex: 0 0 auto;
-						width: auto;
-					}
-				}
-
-				&:not(.with-image) {
-					.file-info {
-						.iteration {
-							display: block;
+						}
+					}
+				}
+
+				&.failing {
+					.file-remove {
+						flex: 0 0 auto;
+						width: auto;
+					}
+				}
+
+				&:not(.with-image) {
+					.file-info {
+						.iteration {
+							display: block;
 						}
 					}
 				}
@@ -512,26 +512,26 @@
 							}
 						}
 					}
-				}
-			}
-		}
-	}
-
-	.file-failing-actions {
-		display: inline-flex;
-		align-items: center;
-		gap: var(--vg-files-info-failing-actions-gap);
-	}
-
-	&-info--list {
-		.file.failing {
-			.file-remove {
-				margin-left: var(--vg-files-info-failing-actions-margin-start);
-			}
-		}
-	}
-
-	&-drop {
+				}
+			}
+		}
+	}
+
+	.file-failing-actions {
+		display: inline-flex;
+		align-items: center;
+		gap: var(--vg-files-info-failing-actions-gap);
+	}
+
+	&-info--list {
+		.file.failing {
+			.file-remove {
+				margin-left: var(--vg-files-info-failing-actions-margin-start);
+			}
+		}
+	}
+
+	&-drop {
 		background-color: var(--vg-files-drop-bg);
 		border: var(--vg-files-drop-border-width) var(--vg-files-drop-border-style) var(--vg-files-drop-border-color);
 		cursor: pointer;
@@ -711,14 +711,14 @@
 					flex-direction: column;
 					gap: 8px;
 
-					.file-remove {
-						.file-failing-actions {
-							gap: var(--vg-files-drop-failing-actions-gap);
-						}
-
-						button {
-							background: var(--vg-body-bg);
-							color: var(--vg-body-color);
+					.file-remove {
+						.file-failing-actions {
+							gap: var(--vg-files-drop-failing-actions-gap);
+						}
+
+						button {
+							background: var(--vg-body-bg);
+							color: var(--vg-body-color);
 							border: none;
 							cursor: pointer;
 							outline: none;