@codemonster-ru/vueforge 0.52.0 → 0.54.0

package/README.md

@@ -50,11 +50,13 @@ import {
     DataTable,
     Checkbox,
     Switch,
+    SegmentedControl,
     Alert,
     Skeleton,
     Progress,
     Badge,
     Chip,
+    FilterChips,
     Accordion,
     AccordionItem,
     Slider,
@@ -108,11 +110,26 @@ app.use(VueForge, {
 <DataTable :columns="columns" :rows="rows" sortable striped />
 <Checkbox v-model="agreed" label="I agree" />
 <Switch v-model="darkMode" label="Dark mode" />
+<SegmentedControl
+    v-model="view"
+    :options="[
+        { label: 'List', value: 'list' },
+        { label: 'Grid', value: 'grid' },
+    ]"
+/>
 <Alert severity="info" title="Heads up" message="Project settings were updated." />
 <Skeleton height="12px" width="140px" />
 <Progress :value="64" />
 <Badge label="Beta" />
 <Chip label="New" />
+<FilterChips
+    v-model="filters"
+    :options="[
+        { label: 'Open', value: 'open' },
+        { label: 'Done', value: 'done' },
+    ]"
+    clearable
+/>
 <Slider v-model="volume" :min="0" :max="100" :step="5" show-value />
 <Stepper v-model="step" :steps="steps" clickable />
 <Rating v-model="rating" allow-half />
@@ -175,6 +192,7 @@ app.use(VueForge, {
 - Checkbox
 - RadioGroup
 - RadioButton
+- SegmentedControl
 - Tabs
 - Tab
 - TabPanel
@@ -221,6 +239,7 @@ app.use(VueForge, {
 - Progress
 - Badge
 - Chip
+- FilterChips
 - Avatar
 - Slider
 - Stepper
@@ -240,7 +259,8 @@ Input / Search / Password / Textarea (quick API):
 - `NumberInput`: numeric control, supports `v-model`, `min`, `max`, `step`, `precision`, `controls`, `size`, `variant`.
 - `Textarea`: multi-line control, same as Input plus `rows`.
 - `TagInput`: token/tag control, supports `v-model` (array), suggestions, custom tags, `maxTags`, `clearable`, `size`, `variant`.
-- `SearchInput`, `OtpInput`, `ColorPicker`, `MaskedInput`, `Checkbox`, `Select`, `Autocomplete`, `MultiSelect`, `TagInput`, `DatePicker`, `Calendar`, `DateRangePicker`, `DateTimePicker`, `Pagination`, `DataTable`, and `TreeSelect` also support `variant: 'filled' | 'outlined'`.
+- `FilterChips`: compact chip-based filter toggles with single/multiple selection modes and optional clear action.
+- `SearchInput`, `OtpInput`, `ColorPicker`, `MaskedInput`, `Checkbox`, `Select`, `Autocomplete`, `MultiSelect`, `TagInput`, `DatePicker`, `Calendar`, `DateRangePicker`, `DateTimePicker`, `Pagination`, `DataTable`, `SegmentedControl`, and `TreeSelect` also support `variant: 'filled' | 'outlined'`.
 
 ## FormField
 
@@ -1131,6 +1151,51 @@ Component tokens (override via `theme.overrides.components.breadcrumbs`):
 - `gap`, `fontSize`, `textColor`, `hoverColor`, `activeColor`
 - `separatorColor`, `disabledOpacity`
 
+## SegmentedControl
+
+Props:
+
+- `modelValue?: string | number` (v-model)
+- `options?: Array<{ label: string; value: string | number; disabled?: boolean }>` (default `[]`)
+- `disabled?: boolean`
+- `fullWidth?: boolean` (default `false`)
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `variant?: 'filled' | 'outlined'` (default `filled`)
+- `ariaLabel?: string`
+- `ariaLabelledby?: string`
+
+Events:
+
+- `update:modelValue`
+- `change`
+- `focus`
+- `blur`
+
+Example:
+
+```vue
+<SegmentedControl
+    v-model="view"
+    :options="[
+        { label: 'List', value: 'list' },
+        { label: 'Grid', value: 'grid' },
+        { label: 'Board', value: 'board' },
+    ]"
+/>
+```
+
+### SegmentedControl tokens
+
+Component tokens (override via `theme.overrides.components.segmentedControl`):
+
+- `fontSize`, `padding`, `gap`
+- `borderRadius`, `borderColor`, `backgroundColor`, `textColor`
+- `hoverBackgroundColor`, `activeBackgroundColor`, `activeTextColor`
+- `focusRingShadow`, `disabledOpacity`
+- `segmentPadding`, `segmentRadius`, `segmentFontWeight`
+- `small.fontSize`, `small.padding`, `small.segmentPadding`
+- `large.fontSize`, `large.padding`, `large.segmentPadding`
+
 ## Tabs / Tab / TabPanel
 
 Props (Tabs):
@@ -1745,6 +1810,61 @@ Component tokens (override via `theme.overrides.components.chip`):
 - `small.fontSize`, `small.paddingX`, `small.paddingY`
 - `large.fontSize`, `large.paddingX`, `large.paddingY`
 
+## FilterChips
+
+Props:
+
+- `modelValue?: string | number | Array<string | number> | null` (v-model)
+- `options?: Array<{ label: string; value: string | number; disabled?: boolean; count?: number }>` (default `[]`)
+- `multiple?: boolean` (default `true`)
+- `allowEmpty?: boolean` (default `true`, used in single mode)
+- `clearable?: boolean` (default `false`)
+- `clearText?: string` (default `Clear`)
+- `clearLabel?: string` (default `Clear filters`)
+- `disabled?: boolean`
+- `wrap?: boolean` (default `true`)
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `variant?: 'soft' | 'outline' | 'solid'` (default `soft`)
+- `ariaLabel?: string`
+- `ariaLabelledby?: string`
+
+Events:
+
+- `update:modelValue`
+- `change`
+- `clear`
+
+Example:
+
+```vue
+<FilterChips
+    v-model="activeFilters"
+    :options="[
+        { label: 'Open', value: 'open', count: 12 },
+        { label: 'In progress', value: 'progress', count: 7 },
+        { label: 'Done', value: 'done', count: 18 },
+    ]"
+    clearable
+/>
+<FilterChips v-model="activeStatus" :options="statusOptions" :multiple="false" variant="outline" />
+```
+
+### FilterChips tokens
+
+Component tokens (override via `theme.overrides.components.filterChips`):
+
+- `fontSize`, `gap`
+- `chipGap`, `chipPadding`, `chipBorderRadius`
+- `chipBorderColor`, `chipBackgroundColor`, `chipTextColor`
+- `chipHoverBackgroundColor`, `chipHoverBorderColor`
+- `chipActiveBackgroundColor`, `chipActiveBorderColor`, `chipActiveTextColor`
+- `chipSolidActiveBackgroundColor`, `chipSolidActiveBorderColor`, `chipSolidActiveTextColor`
+- `countPadding`, `countFontSize`, `countBackgroundColor`, `countTextColor`
+- `countActiveBackgroundColor`, `countActiveTextColor`
+- `disabledOpacity`
+- `small.fontSize`, `small.chipPadding`
+- `large.fontSize`, `large.chipPadding`
+
 ## Avatar
 
 Props:
@@ -2100,7 +2220,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/searchInput/passwordInput/otpInput/colorPicker/maskedInput/numberInput/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/select/autocomplete/multiselect/taginput/datepicker/calendar/daterangepicker/timepicker/datetimepicker/pagination/switch/tooltip/skeleton/progress/badge/chip/avatar/datatable/slider/stepper/rating/tree/treeselect/virtualScroller).
+- `components.*` accepts component-specific tokens (typed keys: button/card/checkbox/radio/tabs/accordion/toast/alert/input/searchInput/passwordInput/otpInput/colorPicker/maskedInput/numberInput/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/select/autocomplete/multiselect/taginput/datepicker/calendar/daterangepicker/timepicker/datetimepicker/pagination/switch/segmentedControl/tooltip/skeleton/progress/badge/chip/filterChips/avatar/datatable/slider/stepper/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):