@codemonster-ru/vueforge 0.64.0 → 0.66.0

package/README.md

@@ -83,6 +83,8 @@ import {
     SplitButton,
     ContextMenu,
     CommandPalette,
+    NotificationCenter,
+    AppShell,
     Tour,
 } from '@codemonster-ru/vueforge';
 import '@codemonster-ru/vueforge/dist/index.css';
@@ -228,6 +230,12 @@ app.use(VueForge, {
         { label: 'Save as draft', value: 'draft', group: 'Actions' },
     ]"
 />
+<NotificationCenter v-model="notificationsOpen" v-model:items="notificationsItems" />
+<AppShell v-model="sidebarCollapsed">
+    <template #sidebar>Sidebar content</template>
+    <template #header>Header content</template>
+    <div>Main content</div>
+</AppShell>
 <Tour v-model="tourOpen" :steps="tourSteps" />
 ```
 
@@ -273,6 +281,8 @@ app.use(VueForge, {
 - SplitButton
 - ContextMenu
 - CommandPalette
+- NotificationCenter
+- AppShell
 - Tour
 - Popover
 - Select
@@ -322,6 +332,8 @@ Input / InputGroup / Search / Password / Textarea (quick API):
 - `NumberInput`: numeric control, supports `v-model`, `min`, `max`, `step`, `precision`, `controls`, `size`, `variant`.
 - `Splitter`: resizable multi-panel container with draggable separators and `v-model` percentage sizes.
 - `Tour`: guided step-by-step onboarding overlay anchored to target elements.
+- `NotificationCenter`: persistent notifications inbox with read/unread state and bulk actions.
+- `AppShell`: application layout shell with sidebar/header/main/footer regions, collapse toggle, and mobile drawer behavior.
 - `Wizard`: multi-step flow container with linear navigation, per-step validation, and completion events.
 - `Textarea`: multi-line control, same as Input plus `rows`.
 - `TagInput`: token/tag control, supports `v-model` (array), suggestions, custom tags, `maxTags`, `clearable`, `size`, `variant`.
@@ -2057,6 +2069,113 @@ Component tokens (override via `theme.overrides.components.commandPalette`):
 - `shortcutBackgroundColor`, `shortcutTextColor`, `shortcutFontSize`
 - `emptyPadding`, `emptyColor`
 
+## NotificationCenter
+
+Props:
+
+- `modelValue?: boolean` (v-model)
+- `items?: Array<{ id: string | number; title: string; message?: string; date?: string; read?: boolean; severity?: 'neutral' | 'info' | 'success' | 'warn' | 'danger'; avatar?: string }>`
+- `title?: string` (default `Notifications`)
+- `emptyText?: string` (default `No notifications`)
+- `closeOnOverlay?: boolean` (default `true`)
+- `closeOnEsc?: boolean` (default `true`)
+- `markAllLabel?: string` (default `Mark all as read`)
+- `clearLabel?: string` (default `Clear`)
+- `closeLabel?: string` (default `Close notifications`)
+- `readLabel?: string` (default `Mark as read`)
+- `unreadLabel?: string` (default `Mark as unread`)
+
+Slots:
+
+- `item` (optional) - slot props `{ item, index, toggleRead }`
+- `empty` (optional)
+
+Events:
+
+- `update:modelValue`
+- `update:items`
+- `open`
+- `close`
+- `click`
+- `read`
+- `readAll`
+- `clear`
+
+Example:
+
+```vue
+<NotificationCenter v-model="open" v-model:items="notifications" />
+```
+
+### NotificationCenter tokens
+
+Component tokens (override via `theme.overrides.components.notificationCenter`):
+
+- `zIndex`, `overlayBackgroundColor`
+- `top`, `right`, `width`, `maxWidth`, `maxHeight`
+- `borderColor`, `borderRadius`, `backgroundColor`, `textColor`, `shadow`
+- `dividerColor`, `headerGap`, `headerPadding`
+- `titleGap`, `titleFontSize`, `titleLineHeight`, `titleFontWeight`
+- `badgeSize`, `badgeBackgroundColor`, `badgeTextColor`, `badgeFontSize`
+- `actionsGap`, `closeSize`, `closeHoverBackgroundColor`, `disabledOpacity`
+- `itemGap`, `itemPadding`, `unreadBackgroundColor`
+- `avatarSize`, `avatarBackgroundColor`, `avatarTextColor`, `avatarFontSize`
+- `itemTitleFontSize`, `itemTitleFontWeight`, `itemMetaFontSize`, `itemMetaColor`
+- `emptyPadding`, `emptyColor`
+
+## AppShell
+
+Props:
+
+- `modelValue?: boolean` (v-model collapsed state on desktop)
+- `sidebarWidth?: string` (default `16rem`)
+- `sidebarCollapsedWidth?: string` (default `4.25rem`)
+- `mobileBreakpoint?: number` (default `1024`)
+- `stickyHeader?: boolean` (default `true`)
+- `fullHeight?: boolean` (default `true`)
+- `showToggle?: boolean` (default `true`)
+- `closeOnEsc?: boolean` (default `true`)
+- `toggleLabel?: string` (default `Toggle sidebar`)
+- `closeSidebarLabel?: string` (default `Close sidebar`)
+- `toggleIcon?: string` (default `☰`)
+- `mainAriaLabel?: string` (default `Main content`)
+
+Slots:
+
+- `sidebar` (optional) - slot props `{ mobile, collapsed }`
+- `header` (optional) - slot props `{ mobile, collapsed, mobileSidebarOpen, toggleSidebar }`
+- `default` - main content
+- `footer` (optional) - slot props `{ mobile, collapsed }`
+
+Events:
+
+- `update:modelValue`
+- `sidebar-toggle`
+- `breakpoint-change`
+
+Example:
+
+```vue
+<AppShell v-model="collapsed">
+    <template #sidebar>Sidebar</template>
+    <template #header>Header</template>
+    <div>Main</div>
+    <template #footer>Footer</template>
+</AppShell>
+```
+
+### AppShell tokens
+
+Component tokens (override via `theme.overrides.components.appShell`):
+
+- `gap`, `backgroundColor`, `textColor`
+- `sidebarBackgroundColor`, `sidebarBorderColor`
+- `headerHeight`, `headerPadding`, `headerGap`, `headerBackgroundColor`, `headerBorderColor`
+- `contentPadding`, `mainBackgroundColor`
+- `footerPadding`, `footerBorderColor`, `footerBackgroundColor`
+- `toggleSize`, `toggleBorderRadius`, `toggleBackgroundColor`, `toggleTextColor`, `toggleHoverBackgroundColor`
+- `overlayBackgroundColor`, `zIndex`
+
 ## Tour
 
 Props:
@@ -2801,7 +2920,7 @@ VueForge exposes design tokens as CSS variables generated from the theme preset.
 Typed tokens:
 
 - `ThemeTokens`/`ThemeOptions`/`ThemePreset` are exported for type-safe theming in TS.
-- `components.*` accepts component-specific tokens (typed keys: button/card/checkbox/radio/tabs/accordion/toast/alert/emptyState/input/inputGroup/inlineEdit/searchInput/mentionInput/passwordInput/otpInput/colorPicker/maskedInput/numberInput/form/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/tour/select/autocomplete/combobox/multiselect/taginput/datepicker/calendar/daterangepicker/timepicker/datetimepicker/pagination/switch/segmentedControl/tooltip/skeleton/progress/badge/chip/filterChips/avatar/datatable/slider/splitter/stepper/wizard/rating/tree/treeselect/virtualScroller).
+- `components.*` accepts component-specific tokens (typed keys: button/card/checkbox/radio/tabs/accordion/toast/alert/emptyState/input/inputGroup/inlineEdit/searchInput/mentionInput/passwordInput/otpInput/colorPicker/maskedInput/numberInput/form/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/notificationCenter/appShell/tour/select/autocomplete/combobox/multiselect/taginput/datepicker/calendar/daterangepicker/timepicker/datetimepicker/pagination/switch/segmentedControl/tooltip/skeleton/progress/badge/chip/filterChips/avatar/datatable/slider/splitter/stepper/wizard/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):