r3ui-lib 1.2.3-2 → 1.2.3-20

package/CHANGELOG.md

@@ -0,0 +1,145 @@
+# Changelog
+
+Все значимые изменения в этом проекте будут документированы в этом файле.
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.3-9]
+
+### Added
+
+- **Контроль открытия внешних ссылок** - Новое свойство `openInNewWindow` для управления поведением внешних ссылок
+- **Гибкость навигации** - Возможность открывать внешние ссылки в том же окне или в новой вкладке
+- **Обратная совместимость** - По умолчанию внешние ссылки открываются в новом окне (как раньше)
+- **Новые Storybook примеры** - История `MixedExternalLinks` демонстрирует различные варианты использования
+- **Полное тестовое покрытие** - 6 новых тестов для проверки всех сценариев использования
+
+### Changed
+
+- Расширен интерфейс `SidebarLink` с полем `openInNewWindow?: boolean`
+- Обновлена логика обработки кликов в `SidebarLink.vue` и `CollapsedSidebarLink.vue`
+- Улучшена документация с примерами использования новой функциональности
+
+### Technical Details
+
+- Добавлена проверка `openInNewWindow !== false` для определения поведения ссылки
+- Внешние ссылки с `openInNewWindow: false` используют `window.location.href`
+- Внешние ссылки с `openInNewWindow: true` (по умолчанию) используют `window.open()`
+- HTML атрибуты `target` и `rel` устанавливаются динамически в зависимости от настроек
+
+## [1.2.3-6]
+
+### Fixed
+
+- **Исправлена проблема с отображением улиц** - Устранена проблема, когда улица показывала ID вместо названия
+- **Предотвращены повторные загрузки** - Добавлена защита от повторного вызова автозаполнения
+- **Оптимизирована загрузка localities** - Убрана ненужная загрузка localities в Case 5
+
+### Technical Details
+
+- Добавлена проверка `isAutoFilling` в watcher `AddressForm.vue`
+- Закомментирована загрузка localities с regionId в Case 5
+- Улучшена отладочная информация для диагностики загрузки улиц
+
+## [1.2.3-5]
+
+### Fixed
+
+- **Исправлены рекурсивные обновления в StoreOrganizationForm** - Устранена ошибка "Maximum recursive updates exceeded"
+- **Оптимизированы обновления formData** - Использование `Object.assign()` для пакетного обновления
+- **Добавлена отладочная информация** - Для диагностики проблем с загрузкой улиц
+
+### Technical Details
+
+- Оптимизирована функция `fillFieldsForEdit` в `create.vue`
+- Улучшена функция `fillAddressFields` для предотвращения множественных обновлений
+- Добавлены console.log для отладки загрузки адресных данных
+
+## [1.2.3-4]
+
+### Fixed
+
+- **Исправлены рекурсивные обновления в AddressForm** - Устранена ошибка "Unhandled error during execution of app errorHandler"
+- **Улучшены защитные механизмы** - Добавлены дополнительные флаги для предотвращения циклических обновлений
+- **Оптимизированы функции автозаполнения** - Использование `Object.assign()` вместо прямого присваивания
+- **Добавлена функция безопасного сравнения** - Предотвращение ненужных обновлений при одинаковых данных
+
+### Technical Details
+
+- Добавлена функция `isEqual()` для глубокого сравнения объектов
+- Улучшены watchers в `AddressForm.vue` с дополнительными проверками
+- Оптимизированы функции `autoFillForm` и `autoFillFormSkipReset` в `useAddressForm.ts`
+
+## [1.2.3-1]
+
+### Added
+
+- **Новый компонент Sidebar** - Навигационное меню с поддержкой многоуровневых ссылок
+- **Поддержка внешних ссылок** - Автоматическое открытие внешних ссылок в новой вкладке
+- **Визуальные индикаторы** - Иконка ↗ для внешних ссылок
+- **Безопасность** - Атрибуты `rel="noopener noreferrer"` для внешних ссылок
+- **Storybook примеры** - Новые истории `WithExternalLinks` и `WithExternalLinksCollapsed`
+- **Полная документация** - Подробное описание API в `/docs/components/Sidebar.md`
+
+### Changed
+
+- Расширен интерфейс `SidebarLink` с полем `isExternal?: boolean`
+- Обновлены компоненты `SidebarLink.vue` и `CollapsedSidebarLink.vue` для обработки внешних ссылок
+
+### Technical Details
+
+- Добавлена функция `handleLinkClick` для различения внутренних и внешних ссылок
+- Внешние ссылки открываются через `window.open()` с безопасными параметрами
+- Внутренние ссылки продолжают работать через событие `navigate`
+
+## [1.2.3] - 2024-12-18
+
+### Added
+
+- Новые компоненты форм: `BooleanCheckbox`, `MultiCheckbox`, `MultiInput`, `Flatpickr`, `HeaderSearchForm`, `AgeFromAgeTo`
+- Расширены компоненты таблиц: `ColumnSubFilter`, `TableAppliedFiltersStorage`, `TableQuickFilterComponent`, `EditTableColumns`, `ToggleAllTableRowButtons`
+- Новые модальные окна: `TableFilterModalComponent`, `EditTableColumnsModalComponent`
+- Компоненты макета: `Footer`, `Header`, `MainComponent`, `CardInfo`, `PageCard`
+- Аккордеоны: `DefaultAccordion`, `KindCheckboxesAccordion`
+- Утилиты: `Spinner`, `Icon`, `DefaultDropDown`, `QuestionIcon`, `FilterValuesPanel`, `Slider`
+- Компонент экспорта: `ExportComponent`
+- Кнопки: `ClearFormButton`, `CollapseButton`, `ToggleButtons`
+
+### Fixed
+
+- Исправлена бесконечная рекурсия в `AddressForm`
+- Добавлен watcher для `countryId` с автоматической загрузкой регионов
+- Восстановлен функционал `setFilterParamsStringsHandler`
+- Исправлены TypeScript декларации
+
+### Changed
+
+- Обновлена документация с полным списком всех компонентов
+- Добавлены примеры использования для всех новых компонентов
+- Улучшена производительность сборки
+
+## [1.2.2] - 2024-12-17
+
+### Added
+
+- Полная поддержка TypeScript
+- Все 56+ компонентов теперь доступны
+- Методы сброса полей и получения полного адреса в `AddressForm`
+
+## [1.2.1] - 2024-12-16
+
+### Added
+
+- Базовая структура библиотеки
+- Первые компоненты из `auth-front`
+- Storybook интеграция
+- Базовые тесты
+
+## [1.0.0] - 2024-12-15
+
+### Added
+
+- Первоначальный релиз библиотеки
+- Базовые компоненты
+- Документация

package/README.md

@@ -81,6 +81,7 @@ import { DefaultButton, Table, useTableDefault } from 'r3ui-lib'
 - `MainComponent` - Основной компонент макета
 - `CardInfo` - Информационная карточка
 - `PageCard` - Карточка страницы
+- `Sidebar` - Навигационное меню с поддержкой внешних ссылок
 
 ### 📋 Аккордеоны
 - `DefaultAccordion` - Базовый аккордеон
@@ -118,6 +119,7 @@ import { DefaultButton, Table, useTableDefault } from 'r3ui-lib'
 
 - **[TableWithComposable.vue](./examples/TableWithComposable.vue)** - Пример использования Table с useTableDefault
 - **[BreadcrumbsExample.vue](./examples/BreadcrumbsExample.vue)** - Пример использования useBreadcrumbs
+- **[SidebarExample.vue](./examples/SidebarExample.vue)** - Пример использования Sidebar с внешними ссылками
 
 ## 🛠️ Разработка
 
@@ -220,6 +222,59 @@ function handleAddressChange(key, value) {
 </script>
 ```
 
+### Навигационное меню (Sidebar)
+
+```vue
+<template>
+  <Sidebar 
+    :links="sidebarLinks" 
+    :is-collapsed="isCollapsed"
+    @navigate="handleNavigation"
+  >
+    <template #footer>
+      <button @click="toggleSidebar" class="btn btn-light w-100">
+        Toggle Sidebar
+      </button>
+    </template>
+  </Sidebar>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import { Sidebar } from 'r3ui-lib'
+
+const isCollapsed = ref(false)
+
+const sidebarLinks = [
+  {
+    level: 0,
+    uniqueKey: 1,
+    isVisible: true,
+    icon: '<i class="bi bi-house"></i>',
+    label: 'Главная',
+    href: '/',
+  },
+  {
+    level: 0,
+    uniqueKey: 2,
+    isVisible: true,
+    icon: '<i class="bi bi-github"></i>',
+    label: 'GitHub',
+    href: 'https://github.com',
+    isExternal: true, // Внешняя ссылка
+  }
+]
+
+const handleNavigation = (href) => {
+  console.log('Navigation to:', href)
+}
+
+const toggleSidebar = () => {
+  isCollapsed.value = !isCollapsed.value
+}
+</script>
+```
+
 ## 🔗 Полезные ссылки
 
 - [GitHub Repository](git@github.com:REGAGRO-LTD-CY/r3ui-lib.git)
@@ -236,6 +291,15 @@ MIT License
 **Последнее обновление:** Декабрь 2024
 
 ## 🆕 Последние обновления
+
+### v1.2.3-1 (Декабрь 2024)
+- ✅ **Новый компонент Sidebar** - Навигационное меню с поддержкой внешних ссылок
+- ✅ **Внешние ссылки в Sidebar** - Автоматическое открытие в новой вкладке с безопасными атрибутами
+- ✅ **Визуальные индикаторы** - Иконка ↗ для внешних ссылок
+- ✅ **Storybook примеры** - Новые истории с внешними ссылками
+- ✅ **Полная документация** - Подробное описание API и примеры использования
+
+### Предыдущие обновления
 - ✅ Добавлены новые компоненты форм: `BooleanCheckbox`, `MultiCheckbox`, `MultiInput`, `Flatpickr`, `HeaderSearchForm`, `AgeFromAgeTo`
 - ✅ Расширены компоненты таблиц: `ColumnSubFilter`, `TableAppliedFiltersStorage`, `TableQuickFilterComponent`, `EditTableColumns`, `ToggleAllTableRowButtons`
 - ✅ Добавлены новые модальные окна: `TableFilterModalComponent`, `EditTableColumnsModalComponent`
@@ -244,7 +308,7 @@ MIT License
 - ✅ Добавлены утилиты: `Spinner`, `Icon`, `DefaultDropDown`, `QuestionIcon`, `FilterValuesPanel`, `Slider`
 - ✅ Добавлен компонент экспорта: `ExportComponent`
 - ✅ Добавлены кнопки: `ClearFormButton`, `CollapseButton`, `ToggleButtons`
-- ✅ Обновлена документация с полным списком всех 56+ компонентов
+- ✅ Обновлена документация с полным списком всех 57+ компонентов
 - ✅ Добавлены примеры использования для всех новых компонентов
 - ✅ Исправлена бесконечная рекурсия в `AddressForm`
 - ✅ Добавлен watcher для `countryId` с автоматической загрузкой регионов
@@ -252,5 +316,5 @@ MIT License
 - ✅ Добавлены методы сброса полей и получения полного адреса
 - ✅ Исправлены TypeScript декларации
 - ✅ Добавлена полная поддержка TypeScript
-- ✅ Все 56+ компонентов теперь доступны
+- ✅ Все 57+ компонентов теперь доступны
 - ✅ Улучшена производительность сборки