@codemonster-ru/vueforge 0.69.0 → 0.71.0

package/README.md

@@ -26,6 +26,7 @@ import {
     VueForge,
     DefaultTheme,
     Button,
+    ButtonGroup,
     Input,
     InputGroup,
     InputAddon,
@@ -63,6 +64,7 @@ import {
     EmptyState,
     Skeleton,
     Progress,
+    Spinner,
     Badge,
     Chip,
     FilterChips,
@@ -103,6 +105,11 @@ app.use(VueForge, {
 
 ```vue
 <Button label="Hello" severity="primary" />
+<ButtonGroup attached variant="outlined" size="small">
+    <Button label="Day" />
+    <Button label="Week" />
+    <Button label="Month" />
+</ButtonGroup>
 <Form v-model="formValues" :validate="validateForm" @submit="onSubmit">
     <template #default="{ values, errors, touched, setFieldValue, setFieldTouched }">
         <FormField label="Email" :error="touched.email ? errors.email : ''">
@@ -163,6 +170,7 @@ app.use(VueForge, {
 <EmptyState title="No projects yet" description="Create your first project to get started." icon="📂" />
 <Skeleton height="12px" width="140px" />
 <Progress :value="64" />
+<Spinner label="Loading..." />
 <Badge label="Beta" />
 <Chip label="New" />
 <FilterChips
@@ -248,6 +256,7 @@ app.use(VueForge, {
 ## Components
 
 - Button
+- ButtonGroup
 - Card
 - Checkbox
 - RadioGroup
@@ -310,6 +319,7 @@ app.use(VueForge, {
 - Tooltip
 - Skeleton
 - Progress
+- Spinner
 - Badge
 - Chip
 - FilterChips
@@ -329,6 +339,7 @@ app.use(VueForge, {
 Input / InputGroup / Search / Password / Textarea (quick API):
 
 - `Input`: single-line control, supports `v-model`, `size`, `variant`, `disabled`, `readonly`.
+- `ButtonGroup`: grouped button actions with shared size/variant/severity and attached/stacked layouts.
 - `InputGroup`: horizontal control combiner for field/addon/button layouts with unified corners and borders.
 - `EmptyState`: reusable empty-data block with icon/title/description/actions for table/list/search blank states.
 - `InlineEdit`: inline value editing with view/edit states, save/cancel actions, and text/number modes.
@@ -346,6 +357,7 @@ Input / InputGroup / Search / Password / Textarea (quick API):
 - `KanbanBoard`: task board with draggable cards, customizable column/card slots, and move events.
 - `RichTextEditor`: formatting editor with toolbar actions and Markdown/HTML output.
 - `Divider`: horizontal/vertical visual separator with optional label and style variants.
+- `Spinner`: lightweight loading indicator with inline/overlay variants and severity colors.
 - `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`.
@@ -1504,6 +1516,37 @@ Example:
 </RadioGroup>
 ```
 
+## ButtonGroup
+
+Props:
+
+- `size?: 'small' | 'normal' | 'large'` (inherits to nested `Button`/`SplitButton` when child props are not set)
+- `variant?: 'filled' | 'outlined' | 'text'` (inherits to nested `Button`/`SplitButton`)
+- `severity?: 'primary' | 'secondary' | 'success' | 'info' | 'warning' | 'danger'` (inherits to nested `Button`/`SplitButton`)
+- `disabled?: boolean` (default `false`)
+- `orientation?: 'horizontal' | 'vertical'` (default `horizontal`)
+- `attached?: boolean` (default `false`)
+
+Slots:
+
+- `default` - place `Button` / `SplitButton` items
+
+Example:
+
+```vue
+<ButtonGroup attached size="small" variant="outlined" severity="primary">
+    <Button label="Day" />
+    <Button label="Week" />
+    <Button label="Month" />
+</ButtonGroup>
+```
+
+### ButtonGroup tokens
+
+Component tokens (override via `theme.overrides.components.buttonGroup`):
+
+- `gap`, `borderRadius`, `disabledOpacity`
+
 ## Breadcrumbs
 
 Props:
@@ -2632,6 +2675,40 @@ Component tokens (override via `theme.overrides.components.progress`):
 - `small.height`, `small.labelFontSize`, `small.circularSize`, `small.circularThickness`
 - `large.height`, `large.labelFontSize`, `large.circularSize`, `large.circularThickness`
 
+## Spinner
+
+Props:
+
+- `variant?: 'inline' | 'overlay'` (default `inline`)
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `severity?: 'neutral' | 'info' | 'success' | 'warn' | 'danger'` (default `neutral`)
+- `label?: string`
+- `ariaLabel?: string` (default `Loading`)
+
+Slots:
+
+- `default` (optional) - custom label content
+
+Example:
+
+```vue
+<Spinner />
+<Spinner label="Loading users..." size="small" />
+<Spinner variant="overlay" severity="info" label="Sync in progress" />
+```
+
+### Spinner tokens
+
+Component tokens (override via `theme.overrides.components.spinner`):
+
+- `size`, `thickness`, `color`, `trackColor`
+- `gap`, `labelColor`, `labelFontSize`
+- `animationDuration`
+- `overlayMinHeight`, `overlayPadding`, `overlayBorderRadius`, `overlayBackgroundColor`
+- `info.color`, `success.color`, `warn.color`, `danger.color`
+- `small.size`, `small.thickness`, `small.labelFontSize`
+- `large.size`, `large.thickness`, `large.labelFontSize`
+
 ## Slider
 
 Props:
@@ -3069,7 +3146,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/richTextEditor/link/breadcrumbs/divider/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).
+- `components.*` accepts component-specific tokens (typed keys: button/buttonGroup/card/checkbox/radio/tabs/accordion/toast/alert/emptyState/input/inputGroup/inlineEdit/searchInput/mentionInput/passwordInput/otpInput/colorPicker/maskedInput/numberInput/form/formField/textarea/richTextEditor/link/breadcrumbs/divider/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/spinner/badge/chip/filterChips/avatar/datatable/slider/splitter/stepper/wizard/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):