@codemonster-ru/vueforge 0.42.0 → 0.44.0

package/README.md

@@ -54,11 +54,13 @@ import {
     Rating,
     Tree,
     TreeSelect,
+    VirtualScroller,
     Drawer,
     ConfirmDialog,
     Dropdown,
     SplitButton,
     ContextMenu,
+    CommandPalette,
 } from '@codemonster-ru/vueforge';
 import '@codemonster-ru/vueforge/dist/index.css';
 
@@ -100,6 +102,11 @@ app.use(VueForge, {
 <Rating v-model="rating" allow-half />
 <Tree v-model="selectedNode" v-model:expandedKeys="expandedKeys" :items="treeItems" />
 <TreeSelect v-model="selectedNode" v-model:expandedKeys="expandedKeys" :items="treeItems" placeholder="Select node" />
+<VirtualScroller :items="largeItems" :item-height="40" height="320px">
+    <template #default="{ item, index }">
+        {{ index + 1 }}. {{ item.label }}
+    </template>
+</VirtualScroller>
 <Accordion v-model="faq">
     <AccordionItem value="shipping" title="Shipping">
         Shipping details
@@ -136,6 +143,13 @@ app.use(VueForge, {
 <ContextMenu :items="menuItems">
     <div>Right-click here</div>
 </ContextMenu>
+<CommandPalette
+    v-model="commandPaletteOpen"
+    :items="[
+        { label: 'Open docs', value: 'docs', group: 'Navigation' },
+        { label: 'Save as draft', value: 'draft', group: 'Actions' },
+    ]"
+/>
 ```
 
 ## Components
@@ -167,6 +181,7 @@ app.use(VueForge, {
 - Dropdown
 - SplitButton
 - ContextMenu
+- CommandPalette
 - Popover
 - Select
 - Autocomplete
@@ -188,6 +203,7 @@ app.use(VueForge, {
 - Rating
 - Tree
 - TreeSelect
+- VirtualScroller
 
 Input / Textarea (quick API):
 
@@ -1131,6 +1147,63 @@ Component tokens (override via `theme.overrides.components.contextMenu`):
 - `panelBackgroundColor`, `panelShadow`, `zIndex`
 - `disabledOpacity`, `itemPadding`
 
+## CommandPalette
+
+Props:
+
+- `modelValue?: boolean` (v-model)
+- `items?: Array<{ label: string; value?: string | number; description?: string; shortcut?: string; group?: string; disabled?: boolean; keywords?: Array<string>; command?: () => void }>`
+- `placeholder?: string` (default `Type a command or search...`)
+- `emptyText?: string` (default `No commands found`)
+- `ariaLabel?: string` (default `Command palette`)
+- `closeOnOverlay?: boolean` (default `true`)
+- `closeOnEsc?: boolean` (default `true`)
+- `closeOnSelect?: boolean` (default `true`)
+- `filter?: boolean` (default `true`)
+- `enableShortcut?: boolean` (default `true`)
+- `shortcutKey?: string` (default `k`)
+
+Events:
+
+- `update:modelValue`
+- `open`
+- `close`
+- `select`
+- `search`
+
+Example:
+
+```vue
+<CommandPalette
+    v-model="open"
+    :items="[
+        { label: 'Open docs', value: 'docs', group: 'Navigation' },
+        { label: 'Save and publish', value: 'publish', group: 'Actions', shortcut: 'Ctrl+Enter' },
+    ]"
+    @select="onCommand"
+/>
+```
+
+### CommandPalette tokens
+
+Component tokens (override via `theme.overrides.components.commandPalette`):
+
+- `width`, `maxWidth`, `maxHeight`
+- `padding`, `borderRadius`, `borderColor`
+- `backgroundColor`, `textColor`, `overlayBackgroundColor`
+- `shadow`, `zIndex`, `headerGap`
+- `inputPadding`, `inputBorderRadius`, `inputBorderColor`
+- `inputBackgroundColor`, `inputTextColor`, `inputPlaceholderColor`
+- `inputFocusBorderColor`, `inputFocusRingShadow`
+- `listGap`, `groupGap`
+- `groupLabelPadding`, `groupLabelColor`, `groupLabelFontSize`
+- `itemPadding`, `itemBorderRadius`, `itemGap`
+- `itemTextColor`, `itemDescriptionColor`, `itemDescriptionFontSize`
+- `itemActiveBackgroundColor`, `itemActiveTextColor`, `itemDisabledOpacity`
+- `shortcutPadding`, `shortcutBorderRadius`, `shortcutBorderColor`
+- `shortcutBackgroundColor`, `shortcutTextColor`, `shortcutFontSize`
+- `emptyPadding`, `emptyColor`
+
 ## Tooltip
 
 Props:
@@ -1543,6 +1616,51 @@ Component tokens (override via `theme.overrides.components.treeselect`):
 - `small.fontSize`, `small.padding`
 - `large.fontSize`, `large.padding`
 
+## VirtualScroller
+
+Props:
+
+- `items?: Array<unknown>` (default `[]`)
+- `itemHeight?: number` (default `36`)
+- `height?: string` (default `18rem`)
+- `overscan?: number` (default `4`)
+- `keyField?: string` (default `id`)
+- `virtual?: boolean` (default `true`)
+- `ariaLabel?: string` (default `Virtual list`)
+- `emptyText?: string` (default `No items`)
+
+Events:
+
+- `scroll`
+- `rangeChange` (payload: `{ start: number; end: number }`)
+- `reachEnd`
+
+Slots:
+
+- `default` - item content with slot props `{ item, index }`
+- `empty` - empty state content
+
+Example:
+
+```vue
+<VirtualScroller :items="users" :item-height="44" height="320px" :overscan="6" key-field="id">
+    <template #default="{ item, index }">
+        <div>{{ index + 1 }}. {{ item.name }}</div>
+    </template>
+</VirtualScroller>
+```
+
+### VirtualScroller tokens
+
+Component tokens (override via `theme.overrides.components.virtualScroller`):
+
+- `fontSize`
+- `borderColor`, `borderRadius`
+- `backgroundColor`, `textColor`
+- `focusRingShadow`
+- `itemPadding`, `itemBorderColor`
+- `emptyPadding`, `emptyColor`
+
 ## Tokens
 
 VueForge exposes design tokens as CSS variables generated from the theme preset. Core groups:
@@ -1557,7 +1675,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/input/numberInput/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/select/autocomplete/multiselect/datepicker/daterangepicker/timepicker/pagination/switch/tooltip/skeleton/progress/badge/chip/avatar/datatable/slider/stepper/rating/tree/treeselect).
+- `components.*` accepts component-specific tokens (typed keys: button/card/checkbox/radio/tabs/accordion/toast/alert/input/numberInput/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/select/autocomplete/multiselect/datepicker/daterangepicker/timepicker/pagination/switch/tooltip/skeleton/progress/badge/chip/avatar/datatable/slider/stepper/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):