vgapp 0.7.9 → 0.8.0

package/app/utils/js/dom/cookie.js

@@ -1,127 +1,170 @@
 /*! js-cookie v3.0.1 | MIT */
 
-function assign (target) {
-	for (let i = 1; i < arguments.length; i++) {
-		let source = arguments[i];
-		for (let key in source) {
+'use strict';
+
+/**
+ * Объединяет несколько объектов в один (аналог Object.assign)
+ * @param {Object} target - целевой объект
+ * @param {...Object} sources - источники
+ * @returns {Object}
+ */
+function assign(target) {
+	const sources = Array.prototype.slice.call(arguments, 1);
+	sources.forEach(source => {
+		if (!source) return;
+		Object.keys(source).forEach(key => {
 			target[key] = source[key];
-		}
-	}
-	return target
+		});
+	});
+	return target;
 }
 
-let defaultConverter = {
+/**
+ * Конвертер для чтения и записи значений cookie
+ */
+const defaultConverter = {
+	/**
+	 * Читает значение cookie, убирая кавычки и декодируя
+	 * @param {string} value
+	 * @param {string} key
+	 * @returns {string}
+	 */
 	read: function (value) {
 		if (value[0] === '"') {
 			value = value.slice(1, -1);
 		}
-		return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent)
+		return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent);
 	},
+
+	/**
+	 * Записывает значение cookie, кодируя его
+	 * @param {string} value
+	 * @param {string} key
+	 * @returns {string}
+	 */
 	write: function (value) {
 		return encodeURIComponent(value).replace(
 			/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,
 			decodeURIComponent
-		)
+		);
 	}
 };
 
-function init (converter, defaultAttributes) {
-	function set (key, value, attributes) {
-		if (typeof document === 'undefined') {
-			return
-		}
-
+/**
+ * Инициализация функционала работы с cookie
+ * @param {Object} converter - объект с методами read/write
+ * @param {Object} defaultAttributes - атрибуты по умолчанию (например, path, expires)
+ * @returns {Object} - API: set, get, remove, withAttributes, withConverter
+ */
+function init(converter, defaultAttributes) {
+	/**
+	 * Устанавливает cookie
+	 */
+	function set(key, value, attributes) {
+		if (typeof document === 'undefined') return;
+
+		// Объединяем атрибуты: по умолчанию → экземпляр → вызов
 		attributes = assign({}, defaultAttributes, attributes);
 
+		// Обработка expires: число → дата
 		if (typeof attributes.expires === 'number') {
-			attributes.expires = new Date(Date.now() + attributes.expires * 864e5);
+			const daysInMs = 864e5; // 24 * 60 * 60 * 1000
+			attributes.expires = new Date(Date.now() + attributes.expires * daysInMs);
 		}
+
+		// Преобразуем дату в строку, если есть
 		if (attributes.expires) {
 			attributes.expires = attributes.expires.toUTCString();
 		}
 
+		// Кодируем ключ
 		key = encodeURIComponent(key)
 			.replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent)
 			.replace(/[()]/g, escape);
 
+		// Формируем строку атрибутов
 		let stringifiedAttributes = '';
-		for (let attributeName in attributes) {
-			if (!attributes[attributeName]) {
-				continue
-			}
+		Object.keys(attributes).forEach(attributeName => {
+			if (!attributes[attributeName]) return;
 
 			stringifiedAttributes += '; ' + attributeName;
 
-			if (attributes[attributeName] === true) {
-				continue
+			// Булевые атрибуты (например, Secure) не требуют значения
+			if (attributes[attributeName] !== true) {
+				// RFC 6265: обрезаем значение до первого `;`
+				const sanitizedValue = String(attributes[attributeName]).split(';')[0];
+				stringifiedAttributes += '=' + sanitizedValue;
 			}
+		});
 
-			// Considers RFC 6265 section 5.2:
-			// ...
-			// 3.  If the remaining unparsed-attributes contains a %x3B (";")
-			//     character:
-			// Consume the characters of the unparsed-attributes up to,
-			// not including, the first %x3B (";") character.
-			// ...
-			stringifiedAttributes += '=' + attributes[attributeName].split(';')[0];
-		}
-
-		return (document.cookie =
-			key + '=' + converter.write(value, key) + stringifiedAttributes)
+		// Устанавливаем cookie
+		return (document.cookie = key + '=' + converter.write(value, key) + stringifiedAttributes);
 	}
 
-	function get (key) {
+	/**
+	 * Получает значение cookie по ключу
+	 */
+	function get(key) {
 		if (typeof document === 'undefined' || (arguments.length && !key)) {
-			return
+			return;
 		}
 
-		// To prevent the for loop in the first place assign an empty array
-		// in case there are no cookies at all.
-		let cookies = document.cookie ? document.cookie.split('; ') : [];
-		let jar = {};
+		const cookies = document.cookie ? document.cookie.split('; ') : [];
+		const jar = {};
+
 		for (let i = 0; i < cookies.length; i++) {
-			let parts = cookies[i].split('=');
-			let value = parts.slice(1).join('=');
+			const parts = cookies[i].split('=');
+			const value = parts.slice(1).join('=');
+			const encodedKey = parts[0];
 
 			try {
-				let foundKey = decodeURIComponent(parts[0]);
+				const foundKey = decodeURIComponent(encodedKey);
 				jar[foundKey] = converter.read(value, foundKey);
 
-				if (key === foundKey) {
-					break
-				}
-			} catch (e) {}
+				// Прерываем, если нашли нужный ключ
+				if (key === foundKey) break;
+			} catch (e) {
+				// Игнорируем поврежденные cookie
+			}
 		}
 
-		return key ? jar[key] : jar
+		return key ? jar[key] : jar;
 	}
 
-	return Object.create({
-			set: set,
-			get: get,
+	// Возвращаем API
+	return Object.create(
+		{
+			set,
+			get,
+			/**
+			 * Удаляет cookie, устанавливая срок действия в прошлое
+			 */
 			remove: function (key, attributes) {
-				set(
-					key,
-					'',
-					assign({}, attributes, {
-						expires: -1
-					})
-				);
+				set(key, '', assign({}, attributes, { expires: -1 }));
 			},
+
+			/**
+			 * Создаёт новый экземпляр с новыми атрибутами по умолчанию
+			 */
 			withAttributes: function (attributes) {
-				return init(this.converter, assign({}, this.attributes, attributes))
+				return init(this.converter, assign({}, this.attributes, attributes));
 			},
+
+			/**
+			 * Создаёт новый экземпляр с новым конвертером
+			 */
 			withConverter: function (converter) {
-				return init(assign({}, this.converter, converter), this.attributes)
+				return init(assign({}, this.converter, converter), this.attributes);
 			}
 		},
 		{
 			attributes: { value: Object.freeze(defaultAttributes) },
 			converter: { value: Object.freeze(converter) }
 		}
-	)
+	);
 }
 
-let api = init(defaultConverter, { path: '/' });
+// Экспорт по умолчанию: экземпляр с атрибутом path: '/'
+const Cookies = init(defaultConverter, { path: '/' });
 
-export default api;
+export default Cookies;

package/app/utils/js/dom/data.js

@@ -3,49 +3,97 @@
  * Bootstrap data.js
  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
  * --------------------------------------------------------------------------
- * Скрипт работает с коллекцией модулей. Подробнее тут https://learn.javascript.ru/map-set
+ * Управление данными-экземплярами, привязанными к DOM-элементам.
+ * Использует Map для эффективного хранения и контроля уникальности.
  */
 
 /**
- * Константы
+ * Внутренняя карта для хранения данных по элементам.
+ * Структура: Element → Map<Key, Instance>
  */
+const elementMap = new Map();
 
-const elementMap = new Map()
+/**
+ * Утилита для безопасного получения вложенной карты экземпляров.
+ * @param {Element} element
+ * @returns {Map<string, any>|null}
+ */
+function getInstanceMap(element) {
+	if (!elementMap.has(element)) {
+		return null;
+	}
+	return elementMap.get(element);
+}
+
+/**
+ * Утилита для создания новой вложенной карты для элемента.
+ * @param {Element} element
+ * @returns {Map<string, any>}
+ */
+function createInstanceMap(element) {
+	const map = new Map();
+	elementMap.set(element, map);
+	return map;
+}
 
 export default {
+	/**
+	 * Устанавливает экземпляр для элемента по ключу.
+	 * Запрещает несколько экземпляров на один элемент.
+	 *
+	 * @param {Element} element - DOM-элемент
+	 * @param {string} key - уникальный ключ (например, имя компонента)
+	 * @param {any} instance - экземпляр класса или объект
+	 */
 	set(element, key, instance) {
-		if (!elementMap.has(element)) {
-			elementMap.set(element, new Map())
+		if (!getInstanceMap(element)) {
+			createInstanceMap(element);
 		}
 
-		const instanceMap = elementMap.get(element)
-		if (!instanceMap.has(key) && instanceMap.size !== 0) {
-			console.error(`VGApp не допускает более одного экземпляра для каждого элемента. Связанный экземпляр: ${Array.from(instanceMap.keys())[0]}.`)
-			return
+		const instanceMap = getInstanceMap(element);
+
+		// Проверяем, есть ли уже экземпляр (кроме случая, если это первая запись)
+		if (instanceMap.size > 0 && !instanceMap.has(key)) {
+			const existingKey = Array.from(instanceMap.keys())[0];
+			console.error(
+				`VGApp не допускает более одного экземпляра для каждого элемента. Связанный экземпляр: ${existingKey}.`
+			);
+			return;
 		}
 
 		instanceMap.set(key, instance);
 	},
 
+	/**
+	 * Получает экземпляр по элементу и ключу.
+	 *
+	 * @param {Element} element - DOM-элемент
+	 * @param {string} key - ключ
+	 * @returns {any|null} - экземпляр или null
+	 */
 	get(element, key) {
-		if (elementMap.has(element)) {
-			return elementMap.get(element).get(key) || null
-		}
+		const instanceMap = getInstanceMap(element);
+		if (!instanceMap) return null;
 
-		return null
+		return instanceMap.get(key) || null;
 	},
 
+	/**
+	 * Удаляет экземпляр по ключу.
+	 * Если у элемента не остаётся экземпляров — удаляет и сам элемент из хранилища.
+	 *
+	 * @param {Element} element - DOM-элемент
+	 * @param {string} key - ключ
+	 */
 	remove(element, key) {
-		if (!elementMap.has(element)) {
-			return
-		}
-
-		const instanceMap = elementMap.get(element)
+		const instanceMap = getInstanceMap(element);
+		if (!instanceMap) return;
 
 		instanceMap.delete(key);
 
+		// Очищаем корневую запись, если больше нет экземпляров
 		if (instanceMap.size === 0) {
-			elementMap.delete(element)
+			elementMap.delete(element);
 		}
 	}
-}
+};