@codemonster-ru/vueforge 0.65.0 → 0.67.0

package/README.md

@@ -84,6 +84,8 @@ import {
     ContextMenu,
     CommandPalette,
     NotificationCenter,
+    AppShell,
+    KanbanBoard,
     Tour,
 } from '@codemonster-ru/vueforge';
 import '@codemonster-ru/vueforge/dist/index.css';
@@ -230,6 +232,12 @@ app.use(VueForge, {
     ]"
 />
 <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>
+<KanbanBoard v-model:items="kanbanItems" :columns="kanbanColumns" />
 <Tour v-model="tourOpen" :steps="tourSteps" />
 ```
 
@@ -276,6 +284,8 @@ app.use(VueForge, {
 - ContextMenu
 - CommandPalette
 - NotificationCenter
+- AppShell
+- KanbanBoard
 - Tour
 - Popover
 - Select
@@ -326,6 +336,8 @@ Input / InputGroup / Search / Password / Textarea (quick API):
 - `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.
+- `KanbanBoard`: task board with draggable cards, customizable column/card slots, and move events.
 - `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`.
@@ -2115,6 +2127,105 @@ Component tokens (override via `theme.overrides.components.notificationCenter`):
 - `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`
+
+## KanbanBoard
+
+Props:
+
+- `columns?: Array<{ id: string | number; title: string }>`
+- `items?: Array<{ id: string | number; columnId: string | number; title: string; description?: string; assignee?: string; priority?: 'low' | 'medium' | 'high'; tags?: string[] }>`
+- `ariaLabel?: string` (default `Kanban board`)
+- `emptyColumnText?: string` (default `Drop cards here`)
+
+Slots:
+
+- `column-header` (optional) - slot props `{ column, items }`
+- `card` (optional) - slot props `{ item, column, index }`
+- `column-footer` (optional) - slot props `{ column, items }`
+- `empty-column` (optional) - slot props `{ column }`
+
+Events:
+
+- `update:items`
+- `move`
+- `click`
+
+Example:
+
+```vue
+<KanbanBoard v-model:items="items" :columns="columns" @move="onMove" />
+```
+
+### KanbanBoard tokens
+
+Component tokens (override via `theme.overrides.components.kanbanBoard`):
+
+- `gap`, `columnMinWidth`, `columnGap`
+- `columnBorderColor`, `columnBorderRadius`, `columnBackgroundColor`
+- `columnHeaderPadding`, `columnHeaderBorderColor`
+- `columnTitleFontSize`, `columnTitleFontWeight`, `columnCountFontSize`, `columnCountColor`
+- `bodyPadding`
+- `cardGap`, `cardPadding`, `cardBorderRadius`, `cardBorderColor`, `cardBackgroundColor`, `cardHoverBorderColor`
+- `cardTitleFontSize`, `cardTitleFontWeight`, `cardDescriptionFontSize`, `cardDescriptionColor`
+- `priorityLowColor`, `priorityMediumColor`, `priorityHighColor`
+- `tagGap`, `tagPadding`, `tagBorderRadius`, `tagBackgroundColor`, `tagTextColor`
+- `assigneeFontSize`, `assigneeColor`
+- `emptyPadding`, `emptyColor`
+- `columnFooterPadding`, `columnFooterBorderColor`
+- `dragOpacity`
+
 ## Tour
 
 Props:
@@ -2859,7 +2970,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/notificationCenter/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/kanbanBoard/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`):