vgapp 0.7.8 → 0.8.0

package/app/modules/vgformsender/readme.md

@@ -190,6 +190,35 @@ VGFormSender.buttonClick('#contactForm', (form, instance) => {
 ```
 ---
 
+## 🔄 Ответ сервера
+Ответ сервера обязательно должен быть в формате JSON.
+```php
+json_encode([
+    'errors' => false, // флаг ошибки,
+    'title' => 'Успех!', // заголовок уведомления
+    'message' => 'Сообщение отправлено' // текст уведомления
+])
+```
+или 
+
+```php
+json_encode([
+    'errors' => false, // флаг ошибки,
+    'view' => '<...>' // HTML-контент
+])
+```
+Если есть несколько ошибок логики работы сервера, передаем так:
+
+```php
+json_encode([
+    'errors' => [ // массив ошибок
+        ['Не заполнено поля имя', 'Не заполнено поля email']
+    ],
+])
+```
+
+---
+
 ## 🎨 CSS-классы
 
 | Класс | Назначение |
@@ -218,4 +247,4 @@ MIT — свободно используйте и модифицируйте.
 ---
 
 > 🚀 Автор: VEGAS STUDIO (vegas-dev.com)
-> 📍 Поддерживается в проектах на VEGAS / SberTech
+> 📍 Поддерживается в проектах VEGAS

package/app/modules/vglawcookie/js/vglawcookie.js

@@ -1,35 +1,35 @@
 import BaseModule from "../../base-module";
-import {isDisabled, mergeDeepObject} from "../../../utils/js/functions";
+import { isDisabled, mergeDeepObject } from "../../../utils/js/functions";
 import EventHandler from "../../../utils/js/dom/event";
 import Selectors from "../../../utils/js/dom/selectors";
 import Cookies from "../../../utils/js/dom/cookie";
-import {dismissTrigger} from "../../module-fn";
+import { dismissTrigger } from "../../module-fn";
 
 /**
  * Constants
  */
-const NAME     = 'lawcookie';
+const NAME = 'lawcookie';
 const NAME_KEY = 'vg.lawcookie';
 
 const CLASS_NAME_SHOW = 'show';
 
-const EVENT_KEY_HIDE   = `${NAME_KEY}.hide`;
+const EVENT_KEY_HIDE = `${NAME_KEY}.hide`;
 const EVENT_KEY_HIDDEN = `${NAME_KEY}.hidden`;
-const EVENT_KEY_SHOW   = `${NAME_KEY}.show`;
-const EVENT_KEY_SHOWN  = `${NAME_KEY}.shown`;
+const EVENT_KEY_SHOW = `${NAME_KEY}.show`;
+const EVENT_KEY_SHOWN = `${NAME_KEY}.shown`;
 
-const SELECTOR_DATA_TOGGLE       = '[data-vg-toggle="lawcookie"]';
+const SELECTOR_DATA_TOGGLE = '[data-vg-toggle="lawcookie"]';
 const SELECTOR_DATA_TOGGLE_CLEAR = '[data-vg-toggle="lawcookie-clear"]';
-const EVENT_KEY_CLICK_DATA_API   = `click.${NAME_KEY}.data.api`;
+const EVENT_KEY_CLICK_DATA_API = `click.${NAME_KEY}.data.api`;
 
 class VGLawCookie extends BaseModule {
-	static sParams = {};
+	// Убрано статическое sParams — избыточно и небезопасно
 
 	constructor(element, params = {}) {
 		super(element, params);
 
 		this._params = this._getParams(element, mergeDeepObject({
-			storage: 'local', // cookie or local
+			storage: 'local', // 'cookie' или 'local'
 			delay: 500,
 			cookie: {
 				name: 'lawCookie',
@@ -52,9 +52,11 @@ class VGLawCookie extends BaseModule {
 			}
 		}, params));
 
-		VGLawCookie.sParams = this._params;
+		// Инициализация хранилища сразу в конструкторе
+		this._storage = this._createStorage();
 
-		this._params.animation.delay = !this._params.animation.enable ? 0 : this._params.animation.delay;
+		// Настройка анимации
+		this._params.animation.delay = this._params.animation.enable ? this._params.animation.delay : 0;
 		this._animation(this._element, VGLawCookie.NAME_KEY, this._params.animation);
 	}
 
@@ -66,82 +68,112 @@ class VGLawCookie extends BaseModule {
 		return NAME_KEY;
 	}
 
-	toggle() {
-		return !this._isShown() ? this.show() : this.hide();
+	/**
+	 * Проверяет, было ли дано согласие
+	 * @returns {boolean}
+	 * @private
+	 */
+	_isConsented() {
+		return this._storage.get() === this._params.cookie.value;
 	}
 
-	_isShown() {
-		return this.storage().get();
+	/**
+	 * Переключает отображение: показать, если ещё нет согласия
+	 */
+	toggle() {
+		return this._isConsented() ? this.hide() : this.show();
 	}
 
+	/**
+	 * Показать баннер
+	 */
 	show() {
-		if (isDisabled(this._element)) return;
+		if (isDisabled(this._element) || this._isConsented()) return;
 
-		const showEvent = EventHandler.trigger(this._element, EVENT_KEY_SHOW, {})
+		const showEvent = EventHandler.trigger(this._element, EVENT_KEY_SHOW);
 		if (showEvent.defaultPrevented) return;
 
 		this._element.classList.add(CLASS_NAME_SHOW);
 
-		const completeCallBack = () => {
-			EventHandler.trigger(this._element, EVENT_KEY_SHOWN, {});
-		}
-		this._queueCallback(completeCallBack, this._element, true, this._params.delay)
+		const completeCallback = () => {
+			EventHandler.trigger(this._element, EVENT_KEY_SHOWN);
+		};
+
+		this._queueCallback(completeCallback, this._element, true, this._params.delay);
 	}
 
+	/**
+	 * Скрыть баннер и сохранить согласие
+	 */
 	hide() {
 		const hideEvent = EventHandler.trigger(this._element, EVENT_KEY_HIDE);
 		if (hideEvent.defaultPrevented) return;
 
-		setTimeout(() => {
-			this._element.classList.remove(CLASS_NAME_SHOW);
+		this._element.classList.remove(CLASS_NAME_SHOW);
 
-			const completeCallback = () => EventHandler.trigger(this._element, EVENT_KEY_HIDDEN);
-			this._queueCallback(completeCallback, this._element, true);
-		}, this._params.animation.delay);
-	}
-
-	storage() {
-		this._storage = {
-			isCookie: this._params.storage === 'cookie',
-			storage: this._params.storage === 'cookie' ? Cookies : localStorage,
-			name: this._params.cookie.name,
-			value: this._params.cookie.value,
-			attributes: this._params.cookie.attributes,
-		}
+		const completeCallback = () => {
+			EventHandler.trigger(this._element, EVENT_KEY_HIDDEN);
+		};
 
-		return this;
-	}
-
-	get() {
-		if (this._storage.isCookie) {
-			return this._storage.storage.get(this._storage.name);
-		} else {
-			return this._storage.storage.getItem(this._storage.name);
-		}
+		this._queueCallback(completeCallback, this._element, true, this._params.animation.delay);
 	}
 
-	set() {
-		if (this._storage.isCookie) {
-			this._storage.storage.set(this._storage.name, this._storage.value, this._storage.attributes);
+	/**
+	 * Создаёт объект хранилища с унифицированным API
+	 * @returns {{get: () => string|null, set: () => void}}
+	 * @private
+	 */
+	_createStorage() {
+		const { name, value, attributes } = this._params.cookie;
+
+		if (this._params.storage === 'cookie') {
+			return {
+				get: () => Cookies.get(name),
+				set: () => Cookies.set(name, value, attributes)
+			};
 		} else {
-			this._storage.storage.setItem(this._storage.name, this._storage.value);
+			return {
+				get: () => localStorage.getItem(name),
+				set: () => localStorage.setItem(name, value)
+			};
 		}
 	}
 
-	dispose() {
-		super.dispose();
+	/**
+	 * Сохраняет согласие
+	 */
+	accept() {
+		this._storage.set();
 	}
 
+	/**
+	 * Полный сброс согласия
+	 */
 	static reset() {
-		Cookies.remove(VGLawCookie.sParams.cookie.name);
+		Cookies.remove(VGLawCookie.getDefaultParams().cookie.name);
 		localStorage.clear();
 		location.reload();
 	}
 
 	/**
-	 * Инициализация
-	 * @param element
-	 * @param params
+	 * Возвращает дефолтные параметры (для доступа без инстанса)
+	 */
+	static getDefaultParams() {
+		return mergeDeepObject({
+			cookie: { name: 'lawCookie' }
+		}, {});
+	}
+
+	dispose() {
+		Cookies.remove(VGLawCookie.getDefaultParams().cookie.name);
+		localStorage.clear();
+		super.dispose();
+	}
+
+	/**
+	 * Инициализация модуля
+	 * @param {Element} element
+	 * @param {Object} params
 	 */
 	static init(element, params = {}) {
 		const instance = VGLawCookie.getOrCreateInstance(element, params);
@@ -149,11 +181,13 @@ class VGLawCookie extends BaseModule {
 	}
 }
 
+// Подключение поведения закрытия через триггер
 dismissTrigger(VGLawCookie);
 
+// Обработка кнопки принятия согласия
 EventHandler.on(document, EVENT_KEY_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {
 	if (['A', 'AREA'].includes(this.tagName)) {
-		event.preventDefault()
+		event.preventDefault();
 	}
 
 	if (isDisabled(this)) return;
@@ -162,13 +196,14 @@ EventHandler.on(document, EVENT_KEY_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, functi
 	if (!element) return;
 
 	const instance = VGLawCookie.getOrCreateInstance(element);
-	instance.storage().set();
-	instance.hide();
+	instance.accept(); // Сохраняем согласие
+	instance.hide();   // Скрываем баннер
 });
 
+// Обработка кнопки сброса
 EventHandler.on(document, EVENT_KEY_CLICK_DATA_API, SELECTOR_DATA_TOGGLE_CLEAR, function (event) {
 	if (['A', 'AREA'].includes(this.tagName)) {
-		event.preventDefault()
+		event.preventDefault();
 	}
 
 	if (isDisabled(this)) return;
@@ -178,8 +213,7 @@ EventHandler.on(document, EVENT_KEY_CLICK_DATA_API, SELECTOR_DATA_TOGGLE_CLEAR,
 
 	const instance = VGLawCookie.getOrCreateInstance(element);
 	instance.dispose();
-
-	location.reload();
+	VGLawCookie.reset(); // Полный сброс
 });
 
 export default VGLawCookie;

package/app/modules/vglawcookie/readme.md

@@ -0,0 +1,102 @@
+# Модуль `vglawcookie` — Управление согласием на использование cookies
+
+Модуль `vglawcookie` предназначен для реализации функциональности **баннера согласия на использование cookies** в соответствии с требованиями законодательства (например, GDPR, российское законодательство о персональных данных и т.д.).
+
+Он позволяет отображать всплывающий баннер, который пользователь может подтвердить или отклонить, а также обеспечивает гибкую настройку поведения и хранения согласия.
+
+---
+
+## 🔧 Возможности модуля
+
+- Автоматическое отображение баннера при отсутствии согласия.
+- Поддержка двух типов хранения согласия:
+    - Через **cookies**
+    - Через **localStorage**
+- Анимированное появление и скрытие (на основе [Animate.css](https://animate.style/)).
+- Поддержка задержки перед показом.
+- Гибкая настройка параметров через атрибуты `data-*` или JavaScript.
+- Обработка событий показа/скрытия.
+- Возможность сброса согласия и очистки хранилища.
+- Совместимость с динамически создаваемыми элементами (через делегирование событий).
+
+---
+
+## 📦 Установка
+Инициализация происходит автоматически при наличии разметки или вручную.
+
+## 🏗️ HTML-разметка
+
+Пример базового баннера:
+```html
+<div class="vg-lawcookie left bottom fullwidth" id="vg-lawcookie">
+    <div class="vg-lawcookie--content">
+        <div class="d-flex align-items-center justify-content-center">
+            <p class="mb-0"><b>Мы используем файлы cookie</b>. Продолжая использовать сайт, вы соглашаетесь с <a href="https://museum-arms.ru/terms-of-use">политикой сбора и обработки данных</a>.</p>
+            <p class="mb-0 ms-3">
+                <a href="#" data-vg-toggle="lawcookie" class="btn btn-primary btn-sm">Хорошо</a>
+            </p>
+        </div>
+    </div>
+</div>
+
+```
+
+> ✅ Баннер автоматически будет скрыт после подтверждения и не появится снова, пока не будет сброшен.
+
+---
+
+## ⚙️ Параметры (настройки)
+
+Параметры можно задавать:
+- Через `data-*` атрибуты на элементе
+- При инициализации через JavaScript
+
+| Параметр                | По умолчанию         | Описание |
+|-------------------------|----------------------|---------|
+| `storage`               | `'local'`            | Способ хранения: `'cookie'` или `'local'` (localStorage) |
+| `delay`                 | `500`                | Задержка перед показом баннера (в мс) |
+| `cookie.name`           | `'lawCookie'`        | Имя cookie или ключа в localStorage |
+| `cookie.value`          | `'yes'`              | Значение, сохраняемое при согласии |
+| `cookie.attributes`     | `{}`                 | Атрибуты cookie (например, `expires`, `path`, `domain`) |
+| `animation.enable`      | `true`               | Включить анимацию |
+| `animation.in`          | `'animate__fadeInUp'`| Класс анимации входа (из Animate.css) |
+| `animation.out`         | `'animate__fadeOutDown'`| Класс анимации исчезновения |
+| `animation.delay`       | `800`                | Задержка анимации исчезновения |
+| `ajax.route`            | `''`                 | URL для загрузки контента по AJAX |
+| `ajax.target`           | `''`                 | CSS-селектор элемента, куда загружать контент |
+| `ajax.method`           | `'get'`              | HTTP-метод (`get`, `post`) |
+| `ajax.loader`           | `false`              | Показывать ли лоадер при AJAX-запросе |
+| `ajax.once`             | `false`              | Загружать контент только один раз |
+| `ajax.output`           | `true`               | Вставлять ли ответ в `target` |
+
+---
+
+## 🎯 События
+
+Модуль генерирует пользовательские события на элементе баннера:
+
+| Событие               | Описание |
+|-----------------------|--------|
+| `vg.lawcookie.show`   | Перед показом баннера |
+| `vg.lawcookie.shown`  | После завершения показа |
+| `vg.lawcookie.hide`   | Перед скрытием баннера |
+| `vg.lawcookie.hidden` | После завершения скрытия |
+
+## 🔐 Безопасность и очистка
+
+- После вызова `dispose()` или `reset()` удаляется:
+    - Cookie с именем из `params.cookie.name`
+    - Полностью очищается `localStorage`
+- Это полезно для отладки или реализации кнопки "Отозвать согласие".
+
+---
+
+## 📝 Лицензия
+
+MIT. Свободно использовать и модифицировать.
+
+---
+
+📌 *Разработано в рамках фронтенд-системы VG Modules.*
+> 🚀 Автор: VEGAS STUDIO (vegas-dev.com)
+> 📍 Поддерживается в проектах VEGAS

package/app/modules/vgsidebar/js/vgsidebar.js

@@ -4,7 +4,8 @@ import EventHandler from "../../../utils/js/dom/event";
 import {dismissTrigger} from "../../module-fn";
 import Selectors from "../../../utils/js/dom/selectors";
 import Backdrop from "../../../utils/js/components/backdrop";
-import Overflow from "../../../utils/js/components/overflow";
+import ScrollBarHelper from "../../../utils/js/components/scrollbar";
+
 
 /**
  * Constants
@@ -56,6 +57,7 @@ class VGSidebar extends BaseModule {
 		this._addEventListeners();
 		this._dismissElement();
 
+		this._scrollBar = new ScrollBarHelper();
 		this._params.animation.delay = !this._params.animation.enable ? 0 : this._params.animation.delay;
 		this._animation(this._element, VGSidebar.NAME_KEY, this._params.animation);
 	}
@@ -90,7 +92,7 @@ class VGSidebar extends BaseModule {
 		}
 
 		if (_this._params.overflow) {
-			Overflow.append();
+			this._scrollBar.hide();
 		}
 
 		if (this._params.hash) {
@@ -131,13 +133,13 @@ class VGSidebar extends BaseModule {
 					if (this._params.backdrop) {
 						Backdrop.hide(() => {
 							if (this._params.overflow) {
-								Overflow.destroy();
+								this._scrollBar.reset();
 							}
 						});
 					}
 
 					if (this._params.overflow) {
-						Overflow.destroy();
+						this._scrollBar.reset();
 					}
 
 					if (this._params.hash) {