vgapp 1.1.2 → 1.1.4

package/app/modules/vgspy/readme.md

@@ -47,10 +47,10 @@
 |--------|------|-------------|----------|
 | `offset` | `number` | `null` | *(устарело)* Смещение активации (в пикселях). Используйте `rootMargin` вместо этого. |
 | `rootMargin` | `string` | `'0px 0px -25%'` | Отступы для `IntersectionObserver`. Управляет, насколько "внутрь" должна зайти секция, чтобы стать активной. |
-| `smoothScroll` | `boolean` | `true` | Включить плавную прокрутку при клике на якорные ссылки. |
-| `target` | `HTMLElement \| string` | элемент с `data-vg-toggle="spy"` | Контейнер, внутри которого происходит прокрутка. Если не указан — используется `window`. |
-| `scrollbar` | `Object \| null` | `null` | Инстанс `smooth-scrollbar` или Scrollbar API (если `smooth-scrollbar` импортирован как модуль и не лежит в `window.Scrollbar`). |
-| `threshold` | `number[] \| string` | `[0.1, 0.5, 1]` | Пороги видимости (от 0 до 1), при которых срабатывает активация. Можно передать строку: `'0.1, 0.5, 1'`. |
+| `smoothScroll` | `boolean` | `true` | Включить плавную прокрутку при клике на якорные ссылки. |
+| `target` | `HTMLElement \| string` | элемент с `data-vg-toggle="spy"` | Контейнер, внутри которого происходит прокрутка. Если не указан — используется `window`. |
+| `scrollbar` | `Object \| null` | `null` | Инстанс `smooth-scrollbar` или Scrollbar API (если `smooth-scrollbar` импортирован как модуль и не лежит в `window.Scrollbar`). |
+| `threshold` | `number[] \| string` | `[0.1, 0.5, 1]` | Пороги видимости (от 0 до 1), при которых срабатывает активация. Можно передать строку: `'0.1, 0.5, 1'`. |
 
 ---
 
@@ -86,29 +86,29 @@
 
 ---
 
-## 📚 Заметки
-
-- Убедитесь, что все целевые секции имеют `id`, соответствующий `href` ссылки.
-- Секции должны быть видимы (`display: block`, `visibility: visible`).
-- Работает с динамически добавленным контентом, но требует вызова `refresh()` после вставки.
-- Если прокрутка виртуальная (например, `smooth-scrollbar`), передайте `target` как контейнер, на который был инициализирован `smooth-scrollbar`, и при модульном импорте также передайте `scrollbar`.
-
-Пример (модульный импорт `smooth-scrollbar`):
-
-```js
-import Scrollbar from 'smooth-scrollbar';
-import VGSpy from './app/modules/vgspy';
-
-const scrollRoot = document.querySelector('.my-scroll-root');
-Scrollbar.init(scrollRoot);
-
-VGSpy.getOrCreateInstance(document.querySelector('[data-vg-toggle="spy"]'), {
-  target: scrollRoot,
-  scrollbar: Scrollbar,
-});
-```
-
----
+## 📚 Заметки
+
+- Убедитесь, что все целевые секции имеют `id`, соответствующий `href` ссылки.
+- Секции должны быть видимы (`display: block`, `visibility: visible`).
+- Работает с динамически добавленным контентом, но требует вызова `refresh()` после вставки.
+- Если прокрутка виртуальная (например, `smooth-scrollbar`), передайте `target` как контейнер, на который был инициализирован `smooth-scrollbar`, и при модульном импорте также передайте `scrollbar`.
+
+Пример (модульный импорт `smooth-scrollbar`):
+
+```js
+import Scrollbar from 'smooth-scrollbar';
+import VGSpy from './app/modules/vgspy';
+
+const scrollRoot = document.querySelector('.my-scroll-root');
+Scrollbar.init(scrollRoot);
+
+VGSpy.getOrCreateInstance(document.querySelector('[data-vg-toggle="spy"]'), {
+  target: scrollRoot,
+  scrollbar: Scrollbar,
+});
+```
+
+---
 
 
 ## 📝 Лицензия
@@ -119,4 +119,4 @@ MIT. Свободно использовать и модифицировать.
 
 📌 *Разработано в рамках фронтенд-системы VG Modules.*
 > 🚀 Автор: VEGAS STUDIO (vegas-dev.com)
-> 📍 Поддерживается в проектах VEGAS
+> 📍 Поддерживается в проектах VEGAS

package/app/utils/js/components/audio-metadata.js

@@ -0,0 +1,240 @@
+const AUDIO_EXTENSIONS = new Set(['mp3']);
+
+const readSyncSafeInt = (bytes, offset = 0) => {
+	return ((bytes[offset] & 0x7f) << 21)
+		| ((bytes[offset + 1] & 0x7f) << 14)
+		| ((bytes[offset + 2] & 0x7f) << 7)
+		| (bytes[offset + 3] & 0x7f);
+};
+
+const readUInt32 = (view, offset, useSyncSafe) => {
+	if (useSyncSafe) {
+		return readSyncSafeInt([
+			view.getUint8(offset),
+			view.getUint8(offset + 1),
+			view.getUint8(offset + 2),
+			view.getUint8(offset + 3)
+		], 0);
+	}
+
+	return (
+		(view.getUint8(offset) << 24)
+		| (view.getUint8(offset + 1) << 16)
+		| (view.getUint8(offset + 2) << 8)
+		| view.getUint8(offset + 3)
+	) >>> 0;
+};
+
+const decodeText = (bytes, encodingByte) => {
+	if (!bytes || !bytes.length) {
+		return '';
+	}
+
+	try {
+		if (encodingByte === 0x00) {
+			return new TextDecoder('iso-8859-1').decode(bytes).replace(/\u0000/g, '').trim();
+		}
+
+		if (encodingByte === 0x01) {
+			if (bytes.length >= 2) {
+				const bom0 = bytes[0];
+				const bom1 = bytes[1];
+				if (bom0 === 0xff && bom1 === 0xfe) {
+					return new TextDecoder('utf-16le').decode(bytes.slice(2)).replace(/\u0000/g, '').trim();
+				}
+				if (bom0 === 0xfe && bom1 === 0xff) {
+					const swapped = new Uint8Array(bytes.length - 2);
+					for (let i = 2; i + 1 < bytes.length; i += 2) {
+						swapped[i - 2] = bytes[i + 1];
+						swapped[i - 1] = bytes[i];
+					}
+					return new TextDecoder('utf-16le').decode(swapped).replace(/\u0000/g, '').trim();
+				}
+			}
+
+			return new TextDecoder('utf-16le').decode(bytes).replace(/\u0000/g, '').trim();
+		}
+
+		if (encodingByte === 0x02) {
+			const swapped = new Uint8Array(bytes.length);
+			for (let i = 0; i + 1 < bytes.length; i += 2) {
+				swapped[i] = bytes[i + 1];
+				swapped[i + 1] = bytes[i];
+			}
+			return new TextDecoder('utf-16le').decode(swapped).replace(/\u0000/g, '').trim();
+		}
+
+		return new TextDecoder('utf-8').decode(bytes).replace(/\u0000/g, '').trim();
+	} catch {
+		return '';
+	}
+};
+
+const findNullTerminator = (bytes, start, step = 1) => {
+	for (let i = start; i < bytes.length; i += step) {
+		if (step === 2) {
+			if (i + 1 < bytes.length && bytes[i] === 0x00 && bytes[i + 1] === 0x00) {
+				return i;
+			}
+		} else if (bytes[i] === 0x00) {
+			return i;
+		}
+	}
+
+	return -1;
+};
+
+const parseApic = (frameBytes) => {
+	if (!frameBytes || frameBytes.length < 4) {
+		return null;
+	}
+
+	const encoding = frameBytes[0];
+	let pos = 1;
+
+	const mimeEnd = findNullTerminator(frameBytes, pos);
+	if (mimeEnd < 0) {
+		return null;
+	}
+	const mimeTypeRaw = new TextDecoder('iso-8859-1').decode(frameBytes.slice(pos, mimeEnd)).trim();
+	pos = mimeEnd + 1;
+
+	if (pos >= frameBytes.length) {
+		return null;
+	}
+
+	pos += 1; // picture type
+
+	const isUnicode = encoding === 0x01 || encoding === 0x02;
+	const descEnd = findNullTerminator(frameBytes, pos, isUnicode ? 2 : 1);
+	if (descEnd >= 0) {
+		pos = descEnd + (isUnicode ? 2 : 1);
+	}
+
+	if (pos >= frameBytes.length) {
+		return null;
+	}
+
+	const data = frameBytes.slice(pos);
+	const mimeType = mimeTypeRaw || 'image/jpeg';
+	if (!data.length) {
+		return null;
+	}
+
+	return { mimeType, data };
+};
+
+const parseId3v2 = (arrayBuffer) => {
+	const bytes = new Uint8Array(arrayBuffer);
+	if (bytes.length < 10) {
+		return null;
+	}
+
+	if (bytes[0] !== 0x49 || bytes[1] !== 0x44 || bytes[2] !== 0x33) {
+		return null;
+	}
+
+	const version = bytes[3];
+	if (version < 2 || version > 4) {
+		return null;
+	}
+
+	const tagSize = readSyncSafeInt(bytes, 6);
+	const totalTagSize = Math.min(bytes.length, tagSize + 10);
+	const view = new DataView(arrayBuffer, 0, totalTagSize);
+
+	let offset = 10;
+	let title = '';
+	let picture = null;
+
+	while (offset + 10 <= totalTagSize) {
+		const frameId = String.fromCharCode(
+			view.getUint8(offset),
+			view.getUint8(offset + 1),
+			view.getUint8(offset + 2),
+			view.getUint8(offset + 3)
+		);
+
+		if (!frameId.trim()) {
+			break;
+		}
+
+		const frameSize = readUInt32(view, offset + 4, version === 4);
+		if (!frameSize || frameSize < 1) {
+			break;
+		}
+
+		const frameDataStart = offset + 10;
+		const frameDataEnd = frameDataStart + frameSize;
+		if (frameDataEnd > totalTagSize) {
+			break;
+		}
+
+		const frameBytes = bytes.slice(frameDataStart, frameDataEnd);
+		if (frameId === 'TIT2' && frameBytes.length > 1) {
+			title = decodeText(frameBytes.slice(1), frameBytes[0]) || title;
+		}
+
+		if (frameId === 'APIC' && !picture) {
+			picture = parseApic(frameBytes);
+		}
+
+		offset = frameDataEnd;
+	}
+
+	return {
+		title,
+		picture
+	};
+};
+
+const getFileExtension = (file) => {
+	const fileName = String(file?.name || '').toLowerCase();
+	const dot = fileName.lastIndexOf('.');
+	if (dot < 0 || dot >= fileName.length - 1) {
+		return '';
+	}
+	return fileName.slice(dot + 1);
+};
+
+const extractAudioMetadata = async (file) => {
+	if (!(file instanceof File)) {
+		return null;
+	}
+
+	const ext = getFileExtension(file);
+	if (!AUDIO_EXTENSIONS.has(ext)) {
+		return null;
+	}
+
+	if (!file.size) {
+		return null;
+	}
+
+	try {
+		const chunk = file.slice(0, Math.min(file.size, 1024 * 1024 * 2));
+		const buffer = await chunk.arrayBuffer();
+		const parsed = parseId3v2(buffer);
+		if (!parsed) {
+			return null;
+		}
+
+		const result = {};
+		if (parsed.title) {
+			result.title = parsed.title;
+		}
+
+		if (parsed.picture?.data?.length) {
+			const imageBlob = new Blob([parsed.picture.data], { type: parsed.picture.mimeType || 'image/jpeg' });
+			result.pictureBlob = imageBlob;
+		}
+
+		return Object.keys(result).length ? result : null;
+	} catch {
+		return null;
+	}
+};
+
+export {
+	extractAudioMetadata
+};

package/app/utils/js/components/file-icon.js

@@ -0,0 +1,109 @@
+const FILE_ICON_BY_EXT = {
+	pdf: 'file-pdf',
+	doc: 'file-word',
+	docx: 'file-word',
+	odt: 'file-word',
+	rtf: 'file-word',
+	xls: 'file-exel',
+	xlsx: 'file-exel',
+	xlsm: 'file-exel',
+	ods: 'file-exel',
+	csv: 'file-exel',
+	zip: 'file-zip',
+	rar: 'file-zip',
+	'7z': 'file-zip',
+	tar: 'file-zip',
+	gz: 'file-zip',
+	tgz: 'file-zip',
+	txt: 'file-text',
+	md: 'file-text',
+	log: 'file-text',
+	json: 'file-text',
+	xml: 'file-text',
+	yml: 'file-text',
+	yaml: 'file-text',
+	php: 'file-php',
+	png: 'file-image',
+	jpg: 'file-image',
+	jpeg: 'file-image',
+	gif: 'file-image',
+	webp: 'file-image',
+	svg: 'file-image',
+	bmp: 'file-image',
+	tif: 'file-image',
+	tiff: 'file-image',
+	heic: 'file-image',
+	heif: 'file-image',
+	avif: 'file-image',
+	mp3: 'file-audio',
+	wav: 'file-audio',
+	ogg: 'file-audio',
+	flac: 'file-audio',
+	aac: 'file-audio',
+	m4a: 'file-audio',
+	mp4: 'file-video',
+	webm: 'file-video',
+	mov: 'file-video',
+	mkv: 'file-video',
+	avi: 'file-video'
+};
+
+const extractExtension = (value) => {
+	if (!value) return '';
+
+	const cleanValue = String(value).toLowerCase().split('#')[0].split('?')[0];
+	const lastSegment = cleanValue.split('/').pop() || '';
+	if (!lastSegment.includes('.')) return '';
+
+	return lastSegment.split('.').pop() || '';
+};
+
+const parseFileDescriptor = (value) => {
+	if (!value) return {type: '', ext: ''};
+
+	if (typeof value === 'object') {
+		const type = String(value.type || '').toLowerCase();
+		const name = String(value.name || value.path || value.url || '').toLowerCase();
+		return {type, ext: extractExtension(name)};
+	}
+
+	return {type: '', ext: extractExtension(value)};
+};
+
+const resolveFileIconName = (descriptor) => {
+	const {type, ext} = parseFileDescriptor(descriptor);
+
+	if (type === 'application/pdf') return 'file-pdf';
+	if (type.includes('word')) return 'file-word';
+	if (type.includes('excel') || type.includes('spreadsheet')) return 'file-exel';
+	if (type.includes('zip') || type.includes('compressed')) return 'file-zip';
+	if (type.startsWith('text/')) return 'file-text';
+	if (type.startsWith('image/')) return 'file-image';
+	if (type.startsWith('audio/')) return 'file-audio';
+	if (type.startsWith('video/')) return 'file-video';
+
+	return FILE_ICON_BY_EXT[ext] || 'file-generic';
+};
+
+const getSVG = (name, icons = {}) => {
+	const explicitIcon = icons[name];
+	if (explicitIcon) {
+		return explicitIcon;
+	}
+
+	const autoIconName = resolveFileIconName(name);
+	const autoIcon = icons[autoIconName];
+	if (autoIcon) {
+		return autoIcon;
+	}
+
+	return icons['file-generic'] || '';
+};
+
+export {
+	FILE_ICON_BY_EXT,
+	extractExtension,
+	parseFileDescriptor,
+	resolveFileIconName,
+	getSVG
+};