vgapp 1.2.4 → 1.2.6

package/CHANGELOG.md

@@ -1,14 +1,73 @@
-# VEGAS-APP 1.2.2 (Июнь, 16, 2026)
+# VEGAS-APP 1.2.6 (Июнь, 29, 2026)
+## Новые фичи
+* В `BaseModule` добавлены универсальные route/fetch helpers: `requestRoute()` и `buildRouteUrl()` с нормализацией `headers`, `credentials`, query-параметров, JSON/FormData body и единым форматом ошибок ответа.
+* В `VGDynamicTable` remote-режим переведён на декларативную request-конфигурацию: добавлена поддержка `data-request-method`, `data-request-credentials`, `data-request-params` и построения export URL через общую route-конфигурацию.
+
+## Изменения
+* В `VGDynamicTable` удалён отдельный request helper `app/modules/vgdynamictable/js/request.js`, а remote-загрузка и export унифицированы через новый transport в `BaseModule`.
+* В `VGDynamicTable` доработана виртуализация: добавлены верхний и нижний spacer-rows, динамическое измерение высоты строк, корректный teardown scroll-binding и исключение spacer-строк из обычного row-цикла.
+* В `VGDynamicTable` упрощена тема таблицы: базовые light-токены перенесены в основной набор переменных, удалены отдельные `theme-light/theme-dark/theme-auto` ветки, для virtual spacer-строк добавлены нейтральные стили.
+* Добавлена документация для `VGDynamicTable`, а документация `VGRangeSlider` оформлена как полноценный README с API, Data API, событиями, skin-режимами и примерами интеграции.
+* Обновлена версия пакета в `package.json`: `1.2.5` -> `1.2.6`.
+
+---
+
+# VEGAS-APP 1.2.5 (Июнь, 25, 2026)
+## Новые фичи
+* Добавлен новый модуль `VGTooltip` с режимами `tooltip` и `popover`, Data API, автопозиционированием, fallback placement, закрытием по `Esc` и клику вне элемента.
+* В `VGAlert` добавлен режим рендера `render.type = 'overlay'` для встраивания alert поверх текущей `.vg-modal` или `.vg-sidebar`.
+* Добавлен новый модуль `VGRangeSlider` с single/range режимами, Data API, tooltip, label, hidden-input синхронизацией, внешними output-target, методами `getValue()/setValue()/enable()/disable()` и событиями `vg.rangeslider.*`.
+* В `VGRangeSlider` добавана система скинов: `ruler` со шкалой и делениями, а также `status` с цветовыми состояниями на базе utility-переменных `$success`, `$warning`, `$danger`.
+* Добавлен и экспортирован `VGDynamicTable`: основной модуль таблицы с local/remote режимами, callback/event API, сортировкой, фильтрами, поиском, пагинацией, sticky header, clone-sticky header, summary/footer, row actions и persistent state.
+
+## Изменения
+* В `VGAlert` рендер modal/overlay унифицирован: контейнер и экземпляр рендера создаются один раз, удалены отладочные `console.log`, закрытие вынесено в общий helper.
+* В `VGAlert` отмена confirm теперь корректно отклоняет `Promise`, а обработчик `vg.modal.hide` подписывается только для modal-режима и срабатывает один раз.
+* В `VGTooltip` глобальные обработчики `Esc` и клика вне элемента переведены на работу со всеми открытыми экземплярами, а сброс placement-классов вынесен в общий список.
+* В `VGRangeSlider` исправлены ошибки инициализации и синхронизации: вставка DOM для `input[type="range"]`, работа с вложенными data-параметрами (`output.*`, `name.*`, `input.*`, `label.words`, `status.*`), форматирование пустого prefix/suffix и merged tooltip в range-режиме.
+* В `VGRangeSlider` доработаны стили и геометрия: размеры вынесены в переменные, позиционирование fill/tooltip/шкалы переведено на pixel-based расчёт с учётом ширины thumb, настроены z-index слои, связана геометрия `ruler`, скрыты обычные labels для `ruler`-скина и добавлено dim-active поведение для делений.
+* В `VGRangeSlider` `status`-skin расширен поддержкой `status.by = from|to|avg`, `labelWords` и пробросом статуса (`tone`, `label`, `percent`, `sourceValue`) в события и callback detail.
+* В `VGDynamicTable` подключён публичный export через `index.js`, `Editable` переведён на получение инстанса таблицы через `Data.get(...)`, а инициализация переведена на `EventHandler.on(...)`.
+* В `VGDynamicTable` доработаны sticky-сценарии и таблица-обёртка: стили sticky header вынесены на уровень модуля, добавлен clone sticky header с синхронизацией scroll/select-all/drag-sort interactions, скорректированы fixed-column, striped и hover состояния.
+* В `VGDynamicTable` обновлены pagination и интеграции: локальный импорт `VGDropdown`, scroll-to-top при пагинации, summary node, persistent/view state, remote/local action callbacks и события `vgdt:*`.
+* Обновлена документация `VGAlert` и `VGTooltip`, из директории `app/modules/vgalert/js/old/` удалены устаревшие файлы.
+* Обновлена версия пакета в `package.json`: `1.2.4` -> `1.2.5`.
+
+---
+
+# VEGAS-APP 1.2.4 (Июнь, 19, 2026)
+## Новые фичи
+* В `VGModal` добавлены параметры `persistent` и `state` для opt-in persistent-модалок и сохранения состояния drag/resize через `localStorage`.
+
+## Изменения
+* В `VGModal` persistent-модалки исключены из селектора обычных открытых окон и больше не закрываются автоматически при открытии следующей модалки.
+* В `VGModal` сохранение и восстановление inline-состояния диалога и контента встроено в цикл `show/hide`, включая поддержку пользовательского `state.key`.
+* В `VGModal` при `backdrop: true` клик по backdrop закрывает активную модалку через экземпляр текущего окна, а логика закрытия вынесена из общего `Backdrop`.
+* В `VGModal` при `backdrop: false` модалка больше не блокирует страницу: добавлен `pointer-events: none` на контейнер и отдельная ветка корректного cleanup без backdrop.
+* Обновлена версия пакета в `package.json`: `1.2.3` -> `1.2.4`.
+
+---
+
+# VEGAS-APP 1.2.3 (Июнь, 16, 2026)
+## Изменения
+* В `VGToast` исправлен lifecycle `show/hide/dispose`: добавлены защита от повторного hide, очистка отложенного скрытия и проверки актуального элемента в async callback.
+* В `VGToast` `shown/hidden` больше не срабатывают по уже удалённому экземпляру, а `_isShown()` стал null-safe.
+* В `VGFormSender` параметр `alert.toast.closeModalsBeforeToast` по умолчанию переключён в `true`, чтобы перед показом toast закрывались открытые модалки.
+* В событие `vg.modal.loaded` добавлен `relatedTarget`, чтобы обработчики загрузки получали элемент-источник открытия модалки.
+* Обновлена версия пакета в `package.json`: `1.2.2` -> `1.2.3`.
+
+---
+# VEGAS-APP 1.2.2 (Июнь, 16, 2026)
 ## Новые фичи
 * В VGFiles добавлена настройка кнопок подтверждения удаления через `removes.buttons`, `removes.single.buttons` и `removes.all.buttons`.
 * В VGFormSender добавлены опции `alert.modal.closeModalsBeforeModal` и `alert.toast.closeModalsBeforeToast` для управления закрытием открытых модалок перед показом alert-modal или toast.
 
-## Изменения
-* В VGFormSender при `alert.modal.closeModalsBeforeModal = false` новая alert-modal открывается поверх существующей модалки, получает класс `vg-modal-stacked` и повышенный `z-index`.
-* В VGFormSender закрытие открытых Bootstrap/VGModal модалок вынесено в общий helper.
-* В VGFormSender служебный параметр `closeModalsBeforeToast` не передается в настройки VGToast.
-* В VGModal persistent-модалка помечается отдельным признаком и не влияет на расчёт открытых модалок, а клик по backdrop закрывает именно активную модалку.
-* Обновлена версия пакета в `package.json`: `1.2.1` -> `1.2.2`.
+## Изменения
+* В VGFormSender при `alert.modal.closeModalsBeforeModal = false` новая alert-modal открывается поверх существующей модалки, получает класс `vg-modal-stacked` и повышенный `z-index`.
+* В VGFormSender закрытие открытых Bootstrap/VGModal модалок вынесено в общий helper.
+* В VGFormSender служебный параметр `closeModalsBeforeToast` не передается в настройки VGToast.
+* В VGModal persistent-модалка помечается отдельным признаком и не влияет на расчёт открытых модалок, а клик по backdrop закрывает именно активную модалку.
+* Обновлена версия пакета в `package.json`: `1.2.1` -> `1.2.2`.
 
 ---
 

package/README.md

@@ -38,7 +38,8 @@ npm i vgapp
 - `VGSidebar` — боковые панели с управлением открытием/закрытием.
 - `VGSpy` — scroll‑spy для подсветки активных ссылок по секциям.
 - `VGTabs` — вкладки с переключением контента и поддержкой URL/hash.
-- `VGToast` — всплывающие уведомления со стеком и автозакрытием.
+- `VGToast` — всплывающие уведомления со стеком и автозакрытием.
+- `VGTooltip` — tooltip/popover подсказки с Data API, автопозиционированием и закрытием по `Esc`/клику вне элемента.
 
 ## Authors
 

package/agents.md

@@ -6,9 +6,9 @@
 
 ### Свод правил:
 1. Правила по changelog для проекта vegas-app:
-   - Правило: при команде "записать в changelog" или "дополни changelog" записываем вкратце изменения в файл `CHANGELOG.md`, которые были сделаны с прошлой версии. Записываем так: Версия (смотри `package.json`), дата и построчно что было внесено, нужно как-то выделить новые фичи.
+   - Правило: при команде "записать в changelog" или "дополни changelog" записываем вкратце изменения в файл `D:\OSPanel\home\projects\vegas-app\CHANGELOG.md`, которые были сделаны с прошлой версии. Записываем так: Версия (смотри `package.json`), дата и построчно что было внесено, нужно как-то выделить новые фичи.
    - Смотрим только проект и репозиторий vegas-app, а не связанные.
    - Если версия в `package.json` не изменилась, нужно проверить, есть ли эта версия в `CHANGELOG.md`.
    - Если запись версии уже есть, дописывать изменения в существующую запись (как дополнение), а не создавать новый блок той же версии.
    - Если записи версии нет, создавать новый блок с версией из `package.json`, датой и списком изменений, запись добавляется сверху.
-2. Все файлы должны иметь кодировку UTF-8.
+2. Все файлы должны иметь кодировку UTF-8.

package/app/modules/base-module.js

@@ -15,8 +15,8 @@ import Animation from "../utils/js/components/animation";
 import Ajax from "../utils/js/components/ajax";
 import Html from "../utils/js/components/templater";
 
-class BaseModule {
-	constructor(element) {
+class BaseModule {
+	constructor(element) {
 		if (!element) return
 
 		this._element = Selectors.find(element);
@@ -54,9 +54,13 @@ class BaseModule {
 	 * - timeout = задержка перед отправкой, по умолчанию 0
 	 * @param callback
 	 */
-	_route(callback) {
-		let $content = null,
-			timeout = this._params.ajax.timeout || 0;
+	_route(callback) {
+		if (typeof callback !== 'function') {
+			return this._requestRoute(callback);
+		}
+
+		let $content = null,
+			timeout = this._params.ajax.timeout || 0;
 
 		if (this._isLoaded) return;
 
@@ -133,10 +137,83 @@ class BaseModule {
 			if (this._params.ajax.method.toLowerCase() === 'delete') {
 				ajax.delete(this._params.ajax.route, ajaxData);
 			}
-		}, timeout);
-	}
-
-	_dismissElement() {
+		}, timeout);
+	}
+
+	_requestRoute(options = {}) {
+		const config = this._normalizeRouteRequestOptions(options);
+		return Ajax.requestRoute(config);
+	}
+
+	_buildRouteUrl(params = {}, endpoint = '', options = {}) {
+		const config = this._normalizeRouteRequestOptions(Object.assign({}, options, {
+			params,
+			route: endpoint || options.route || '',
+		}));
+		return Ajax.buildRouteUrl(config.route, {
+			params: config.params,
+			baseParams: config.baseParams,
+		});
+	}
+
+	_normalizeRouteRequestOptions(options = {}) {
+		const requestOptions = this._params && isObject(this._params.request)
+			? this._params.request
+			: {};
+		const ajaxOptions = this._params && isObject(this._params.ajax)
+			? this._params.ajax
+			: {};
+		const source = isObject(options) ? options : {};
+		const route = String(
+			source.route
+			|| source.endpoint
+			|| requestOptions.route
+			|| ajaxOptions.route
+			|| ''
+		).trim();
+		const method = String(
+			source.method
+			|| requestOptions.method
+			|| ajaxOptions.method
+			|| 'GET'
+		).toUpperCase().trim() || 'GET';
+		const credentials = String(
+			source.credentials
+			|| requestOptions.credentials
+			|| 'same-origin'
+		).trim() || 'same-origin';
+		const headers = mergeDeepObject(
+			{
+				'Accept': 'application/json',
+				'X-Requested-With': 'XMLHttpRequest',
+			},
+			isObject(requestOptions.headers) ? requestOptions.headers : {},
+			isObject(source.headers) ? source.headers : {}
+		);
+		const baseParams = mergeDeepObject(
+			{},
+			isObject(requestOptions.params) ? requestOptions.params : {},
+			isObject(source.baseParams) ? source.baseParams : {},
+			isObject(source.paramsBase) ? source.paramsBase : {}
+		);
+		const params = isObject(source.params) ? source.params : {};
+		const body = source.body !== undefined
+			? source.body
+			: (source.data !== undefined ? source.data : null);
+		return {
+			route,
+			method,
+			credentials,
+			headers,
+			baseParams,
+			params,
+			body,
+			signal: source.signal || null,
+			responseType: String(source.responseType || source.parse || 'auto').toLowerCase().trim() || 'auto',
+		};
+	}
+
+	_dismissElement() {
 		let cross = getSVG('cross'),
 			button = this._element.querySelector('.vg-btn-close');
 
@@ -171,4 +248,4 @@ class BaseModule {
 	}
 }
 
-export default BaseModule;
+export default BaseModule;