@nice2dev/ui 1.0.20 → 1.0.21

package/CHANGELOG.md

@@ -1,3 +1,108 @@
+# [1.0.21] — 2026-05-30
+
+### Added — NiceNavShell sticky body slots
+
+- 4 nowe propsy: `showStickyHeader` (default `false`), `stickyHeaderContent`,
+  `showStickyFooter` (default `false`), `stickyFooterContent`. Sloty siedzą
+  wewnątrz `__main` (nad/pod `__content`), nie wewnątrz `__body` — czyli
+  scrolluje się tylko zawartość strony, nagłówek i stopka zostają. Akceptują
+  dowolny ReactNode (NiceMenu, NiceButton, dashboardy).
+
+### Changed — NiceSidebarNav whole-row collapse
+
+- Klik w cały wiersz węzła z dziećmi (branch) toggle'uje rozwinięcie zamiast
+  nawigować, niezależnie od tego czy node ma `route`. Wcześniej navigable-branch
+  (route + children) lewym klikiem nawigował — teraz toggle. Nawigacja na takie
+  węzły dostępna przez prawy klik → "Otwórz" / "Otwórz w nowej karcie" lub przez
+  klik w konkretne dziecko-leaf po rozwinięciu.
+- Chevron-strzałka nie podświetla się już osobnym hover-bg — cały wiersz świeci
+  się jako jeden. Focus-visible outline pozostaje na chevron-button dla a11y.
+
+### Changed — Tab close × większe (+33%)
+
+- `.nice-nav-shell__tab-close` 18×18px → 24×24px, font 16px → 21px. Większy
+  hit-target dla lewego klika, lepsze UX na touch-screen.
+
+### Improved — Order page UX hint
+
+- `preferences/order` ma teraz hint tłumaczący że kolejność dotyczy elementów
+  top-level wewnątrz każdej grupy źródła. Reorder fizycznie działa
+  (`applyItemOrder` w `SourceSection`) — hint adresuje confusion gdy user nie
+  widzi efektu po przesunięciu pozycji w widoku globalnym.
+- Nowy klucz i18n `sidebar.prefs.order.visibilityHint` (EN+PL).
+
+### Tests
+
+- `niceNavShell.stickyBody.test.tsx` — 3 testy (default off, header slot,
+  footer slot).
+- `niceSidebarNav.collapseClick.test.tsx` — 2 testy (leaf navigates, branch
+  always toggles).
+
+# [1.0.20] — 2026-05-30
+
+### Added — NiceSidebarNav: context menu, configurable left-click, preferences as routes
+
+- **Right-click context menu** on view-nodes (opt-in via `contextMenu` prop,
+  default `true`). Akcje: Open in new tab (force-new), Open in browser tab
+  (gdy `routeToUrl` podane), Pin/Unpin favorite, Hide, Copy link. Source-header
+  ma osobne mini-menu (Pin/Unpin source, Hide source). Reuse'uje istniejący
+  `NiceContextMenu` + `NiceMenuItem`.
+- **Configurable left-click behavior** — `SidebarNavUserPrefs.leftClickBehavior:
+'focus-existing' | 'open-new'`. Default zachowuje obecne UX (focus istniejącej
+  karty); `'open-new'` zawsze otwiera duplikat. Sygnatura `onNavigate` rozszerzona
+  o `opts?: { forceNew?: boolean }` (backward compat — stare handlery ignorują).
+- **Preferences jako route'y** — stary inline `PreferencesPanel` zastąpiony
+  nawigowalnym drzewem 5 kategorii (`preferences/general`, `/display`, `/order`,
+  `/hidden`, `/reset`). Każda kategoria to osobna strona renderowana przez
+  NavShell. Eliminuje bug przycinania tekstu przy zwiniętym sidebarze.
+- **Order page** (`preferences/order`) — `NiceSortable` lista top-level
+  elementów per tryb; persistent w localStorage; sidebar tree sortuje wg
+  `prefs.itemOrder[mode]` przez nowy helper `applyItemOrder`.
+- **`buildSidebarPrefsRoutes()`** — helper zwracający `Record<string, ReactNode>`
+  z 5 wbudowanymi stronami prefs. NavShell auto-merge'uje przez prop
+  `includeSidebarPreferenceRoutes` (default true gdy `sidebarUserId` podane).
+- **`SidebarPrefsScopeProvider`** + `useSidebarPrefsScope` / `useSidebarUserId` —
+  przekazują `userId` + `data` do stron prefs.
+- **Cross-instance prefs sync** — custom event `SIDEBAR_PREFS_CHANGE_EVENT`
+  zapewnia natychmiastową propagację zmian między sidebar tree a otwartymi
+  stronami prefs (storage event działa tylko cross-tab).
+
+### Added — NiceNavShellHome smart dashboard
+
+- Nowy komponent `<NiceNavShellHome>` renderowany jako default home tab content.
+  4 sekcje: greeting (time-aware, 4 buckety), open tabs, shortcuts (auto z
+  sidebar favorites lub explicit prop), all routes. Internacjonalizowany przez
+  `t()` dla wszystkich stringów.
+
+### Added — NavShell help system + pinned home
+
+- Multi-step `?` button w toolbarze NavShella otwiera `NiceTutorial` overlay
+  z onboardingiem (kroki: tabs, sidebar, prefs, home). Reuse'uje istniejący
+  `NiceTutorial` komponent.
+- Pinned home tab — niezamykalna karta home renderująca `homeContent` lub
+  default `NiceNavShellHome`.
+
+### Fixed — NiceMenu hover-bridge gap
+
+- Usunięto 5 źródeł szpary 3–5px między triggerem a dropdown panelem (CSS:
+  `margin-top:0` dla `.nice-menu__panel`, `margin-left:0` dla wertykalnego
+  panelu i subpanelu; JS: zdjęte offsety `+6`/`+4` z `recomputePanelCoords`).
+  Komentarz tłumaczy że flush-against-trigger zachowuje hover-bridge integrity
+  (mouse leaves trigger → enters panel bez gap-induced close).
+
+### Fixed — Pipeline & quality gates
+
+- Vector editor / ui-graphics size-limit budget bumped 800 → 860 KB
+  (absorpcja parallel work nad vector editorem).
+- ui-diagrams / ui-presentations vite config — `@nice2dev/ui` dodane do
+  `external` (peer dep), bundle size dropped ~10× (570 kB bundled → ~50 kB).
+- icons-filetypes test script `--passWithNoTests` (brak test files exit 1 fix).
+- NiceViewRegistry async imports refactor — `registerLazy(loader, pick, entry)`
+  helper z `.catch(()=>{})` swallowuje rejections during test teardown
+  (12 EnvironmentTeardownErrors fix).
+- 39 nowych i18n kluczy (EN+PL): `sidebar.menu.*`, `sidebar.prefs.*`,
+  `navShell.home.*`, `nav.help`.
+
 # [1.0.19] — 2026-05-26
 
 ### Fixed — NiceNavShell breakpoint sync