r3ui-lib 1.3.16 → 1.3.18

package/CHANGELOG.md

@@ -11,6 +11,17 @@
 Формат основан на [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.18] - 2026-10-27
+
+- `CustomInput` передаёт атрибуты и нативные обработчики внутреннему полю, сохраняя `class` и `style` оболочки. Встроенная подпись связана со стабильным ID.
+- Очистка доступна с клавиатуры, возвращает фокус полю и сохраняет прежние события. Добавлены `readonly`, `clearLabel` и общее реактивное название очистки через `provide`.
+
+## [1.3.17] - 2026-10-26
+
+- Добавлен `useUnsavedChanges`: независимый исходный снимок в памяти, обнаружение изменений и подтверждение последнего запроса ухода без сброса черновика.
+- Незавершённая запись блокирует уход; её начало, отключение защиты и освобождение владельца отменяют ожидающее подтверждение.
+- `beforeunload` подключается только при необходимости и снимается при деактивации или уничтожении владельца. API не выполняет запросов и не сохраняет данные в хранилища.
+
 ## [1.3.13-runtime.0] - 2026-10-22
 
 - Общая граница совместимости проверяет DataLoader, RowManager и модули запроса до установки перехватов; повторная установка не дублирует владельца.

package/README.md

@@ -328,3 +328,70 @@ MIT License
 - ✅ Добавлена полная поддержка TypeScript
 - ✅ Все 57+ компонентов теперь доступны
 - ✅ Улучшена производительность сборки
+
+## Защита несохранённых форм (1.3.17)
+
+`useUnsavedChanges` хранит независимый исходный снимок только в памяти Vue scope.
+Он не изменяет поля, не выполняет навигацию, HTTP-запросы или запись в хранилища.
+Вызывать внутри `setup` или `effectScope`; значения формы и флаги должны быть реактивными.
+
+```vue
+<script setup lang="ts">
+import { reactive, ref } from 'vue';
+import { ConfirmationModal, useUnsavedChanges } from 'r3ui-lib';
+
+const form = reactive({ name: '' });
+const editorOpen = ref(true);
+const isPersisting = ref(false);
+const enabled = ref(true);
+const guard = useUnsavedChanges({ getSnapshot: () => ({ name: form.name }), isPersisting, enabled });
+const { confirmationOpen } = guard;
+// В настоящем редакторе снимок фиксируется после начального заполнения, до ввода.
+guard.captureBaseline();
+
+async function requestClose() {
+  if (await guard.requestLeave()) {
+    editorOpen.value = false;
+    // Закрытие уже принято владельцем; отменённая навигация снимок не очищает.
+    guard.clearBaseline();
+  }
+}
+</script>
+
+<template>
+  <div v-if="editorOpen">
+    <input v-model="form.name" aria-label="Название" :disabled="isPersisting">
+    <button type="button" @click="requestClose">Закрыть редактор</button>
+  </div>
+  <ConfirmationModal
+    :modal-visibility="confirmationOpen"
+    title="Несохранённые изменения"
+    message="Выйти без сохранения введённых данных?"
+    confirm-text="Выйти без сохранения"
+    cancel-text="Остаться"
+    @confirm="guard.confirmLeave"
+    @cancel="guard.cancelLeave"
+    @update:modal-visibility="open => { if (!open) guard.cancelLeave(); }"
+  />
+</template>
+```
+
+- `getSnapshot` возвращает бизнес-значения без локализованных подписей и индикаторов загрузки. Порядок наборов идентификаторов нормализует приложение.
+- `captureBaseline(snapshot?)` клонирует переданный снимок либо текущее значение `getSnapshot`. Позволяет отдельно нормализовать исходную запись без подмены её ранним пользовательским вводом. Ошибка клонирования сохраняет прежний снимок.
+- `isDirty` становится `true` при отличии от снимка; возвращение исходных значений снимает защиту. До первого снимка изменений нет, но незавершённая запись уже блокирует уход.
+- `requestLeave()` возвращает разрешение, не сбрасывая поля или снимок. Повторный вызов завершает прежний запрос отказом; подтверждается только последний. При отменённом другим guard переходе форма остаётся защищённой.
+- `isPersisting` означает только неподтверждённую запись: навигация и последующий GET в него не входят. Её начало отменяет открытое подтверждение; окончание не запускает отложенный уход.
+- `enabled=false` отменяет ожидающее подтверждение и разрешает новые попытки ухода, в том числе обязательный выход при потере сессии. При подтверждении флаги проверяются заново.
+- `clearBaseline()` отменяет ожидание и удаляет снимок, не меняя поля. Вызывать при фактическом закрытии или смене редактора. После уничтожения scope старый guard отклоняет уход и запрещает новый снимок.
+- `beforeunload` предупреждает только при включённой активной защите и изменениях либо записи. Браузер определяет показ и текст предупреждения; после перезагрузки черновик не восстанавливается.
+- KeepAlive отменяет ожидающее подтверждение и снимает предупреждение при деактивации; при возврате исходный снимок и обнаружение изменений сохраняются. Уничтожение освобождает снимок и обработчики. На сервере обращения к `window` отсутствуют.
+
+Для маршрутного guard возвращать `guard.requestLeave()` напрямую. Смену идентификатора в том же маршруте также проверяет приложение; новая форма получает собственный scope. Обычные формы и модальные окна без подключения composable сохраняют прежнее поведение.
+
+## Семантика CustomInput (1.3.18)
+
+- `id`, `aria-*`, `required`, `autocomplete`, `inputmode`, `data-*` и нативные обработчики передаются настоящему `input`. `class` и `style` остаются на внешней оболочке; `inputClass` задаёт класс поля.
+- Встроенный `title` отображается как `label`, связанный с явно переданным или автоматически созданным стабильным ID. Внешние подписи связывает приложение.
+- Очистка доступна через Tab, Enter и Space, не отправляет форму и возвращает фокус полю. Сохраняется контракт `update:modelValue(null)` и `change(null)`. Для пустого, `disabled` или `readonly` поля кнопка скрыта; число `0` можно очистить.
+- Название очистки задаётся пропом `clearLabel`. Общее реактивное значение для вложенных полей можно передать из приложения: `provide('r3ui-custom-input-clear-label', computed(() => t('custom_input.clear')))`. Переводы находятся в `r3ui-lang-front`; без настройки используется «Очистить поле».
+- Существующая семантика `max`, `maxNumber`, `modelValue`, `blur` и `change` сохранена. Внешний нативный `input` получает событие после синхронного обновления модели.