@codemonster-ru/vueforge 0.43.0 → 0.45.0

package/README.md

@@ -35,6 +35,7 @@ import {
     Select,
     Autocomplete,
     MultiSelect,
+    TagInput,
     DatePicker,
     DateRangePicker,
     TimePicker,
@@ -54,6 +55,7 @@ import {
     Rating,
     Tree,
     TreeSelect,
+    VirtualScroller,
     Drawer,
     ConfirmDialog,
     Dropdown,
@@ -84,6 +86,7 @@ app.use(VueForge, {
 <Select v-model="role" :options="roles" placeholder="Choose role" />
 <Autocomplete v-model="country" :options="countries" placeholder="Find country" />
 <MultiSelect v-model="countries" :options="countryOptions" placeholder="Select countries" clearable />
+<TagInput v-model="skills" :options="skillOptions" placeholder="Add skills" clearable />
 <DatePicker v-model="birthday" placeholder="Pick birthday" />
 <DateRangePicker v-model="range" placeholder="Pick range" />
 <TimePicker v-model="meetingTime" placeholder="Pick time" />
@@ -101,6 +104,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
@@ -180,6 +188,7 @@ app.use(VueForge, {
 - Select
 - Autocomplete
 - MultiSelect
+- TagInput
 - DatePicker
 - DateRangePicker
 - TimePicker
@@ -197,13 +206,15 @@ app.use(VueForge, {
 - Rating
 - Tree
 - TreeSelect
+- VirtualScroller
 
 Input / Textarea (quick API):
 
 - `Input`: single-line control, supports `v-model`, `size`, `variant`, `disabled`, `readonly`.
 - `NumberInput`: numeric control, supports `v-model`, `min`, `max`, `step`, `precision`, `controls`, `size`, `variant`.
 - `Textarea`: multi-line control, same as Input plus `rows`.
-- `Checkbox`, `Select`, `Autocomplete`, `MultiSelect`, `DatePicker`, `DateRangePicker`, `Pagination`, `DataTable`, and `TreeSelect` also support `variant: 'filled' | 'outlined'`.
+- `TagInput`: token/tag control, supports `v-model` (array), suggestions, custom tags, `maxTags`, `clearable`, `size`, `variant`.
+- `Checkbox`, `Select`, `Autocomplete`, `MultiSelect`, `TagInput`, `DatePicker`, `DateRangePicker`, `Pagination`, `DataTable`, and `TreeSelect` also support `variant: 'filled' | 'outlined'`.
 
 ## FormField
 
@@ -302,6 +313,66 @@ Example:
 <MultiSelect v-model="countries" :options="countryOptions" placeholder="Select countries" clearable />
 ```
 
+## TagInput
+
+Props:
+
+- `modelValue?: Array<string | number>` (v-model)
+- `options?: Array<{ label: string; value: string | number; disabled?: boolean }>`
+- `optionLabel?: string` (default `label`)
+- `optionValue?: string` (default `value`)
+- `placeholder?: string`
+- `disabled?: boolean`
+- `readonly?: boolean`
+- `loading?: boolean`
+- `loadingText?: string` (default `Loading...`)
+- `emptyText?: string` (default `No results`)
+- `filter?: boolean` (default `true`)
+- `allowCustom?: boolean` (default `true`)
+- `maxTags?: number`
+- `clearable?: boolean` (default `false`)
+- `validateTag?: (value: string) => boolean`
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `variant?: 'filled' | 'outlined'` (default `filled`)
+
+Events:
+
+- `update:modelValue`
+- `change`
+- `search`
+- `add` (payload: `{ value: string | number; source: 'option' | 'custom' }`)
+- `remove`
+- `reject` (payload: `{ reason: 'duplicate' | 'maxTags' | 'invalid' | 'readonly'; value: string }`)
+- `focus`
+- `blur`
+
+Example:
+
+```vue
+<TagInput v-model="skills" :options="skillOptions" placeholder="Add skills" clearable />
+```
+
+### TagInput tokens
+
+Component tokens (override via `theme.overrides.components.taginput`):
+
+- `minWidth`, `minHeight`, `fontSize`, `controlGap`, `chevronSize`
+- `padding`, `borderRadius`, `borderColor`
+- `backgroundColor`, `textColor`, `placeholderColor`
+- `focusBorderColor`, `focusRingShadow`, `hoverBorderColor`
+- `disabledOpacity`
+- `panelBackgroundColor`, `panelBorderColor`, `panelPadding`, `panelMaxHeight`, `panelRadiusOffset`, `panelShadow`
+- `optionPadding`, `optionBorderRadius`
+- `optionHoverBackgroundColor`, `optionHighlightedBackgroundColor`
+- `emptyPadding`, `emptyColor`
+- `loadingPadding`, `loadingColor`
+- `inputMinWidth`
+- `chipGap`, `chipPadding`, `chipRadius`, `chipBackgroundColor`, `chipTextColor`, `chipFontSize`
+- `chipRemoveSize`, `chipRemoveRadius`, `chipRemoveHoverBackgroundColor`
+- `clearSize`, `clearRadius`, `clearHoverBackgroundColor`
+- `small.fontSize`, `small.padding`, `small.chipPadding`, `small.chipFontSize`
+- `large.fontSize`, `large.padding`, `large.chipPadding`, `large.chipFontSize`
+
 ### MultiSelect tokens
 
 Component tokens (override via `theme.overrides.components.multiselect`):
@@ -1609,6 +1680,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:
@@ -1623,7 +1739,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/commandPalette/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/taginput/datepicker/daterangepicker/timepicker/pagination/switch/tooltip/skeleton/progress/badge/chip/avatar/datatable/slider/stepper/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):