@codemonster-ru/vueforge 0.70.0 → 0.72.0

package/README.md

@@ -26,6 +26,7 @@ import {
     VueForge,
     DefaultTheme,
     Button,
+    ButtonGroup,
     Input,
     InputGroup,
     InputAddon,
@@ -44,6 +45,7 @@ import {
     FileUpload,
     Breadcrumbs,
     Divider,
+    PageHeader,
     Select,
     Autocomplete,
     Combobox,
@@ -104,6 +106,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 : ''">
@@ -139,6 +146,12 @@ app.use(VueForge, {
 <FileUpload v-model="resume" accept=".pdf,.doc,.docx" />
 <Breadcrumbs :items="breadcrumbItems" />
 <Divider label="OR" />
+<PageHeader title="Projects" subtitle="Manage active projects and team workload.">
+    <template #actions>
+        <Button label="Import" variant="outlined" severity="secondary" />
+        <Button label="New project" icon="plus" />
+    </template>
+</PageHeader>
 <Select v-model="role" :options="roles" placeholder="Choose role" />
 <Autocomplete v-model="country" :options="countries" placeholder="Find country" />
 <Combobox v-model="countryId" :options="countries" placeholder="Pick country" clearable />
@@ -250,6 +263,7 @@ app.use(VueForge, {
 ## Components
 
 - Button
+- ButtonGroup
 - Card
 - Checkbox
 - RadioGroup
@@ -283,6 +297,7 @@ app.use(VueForge, {
 - Link
 - Breadcrumbs
 - Divider
+- PageHeader
 - Menu
 - Modal
 - ConfirmDialog
@@ -332,6 +347,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.
@@ -350,6 +366,7 @@ Input / InputGroup / Search / Password / Textarea (quick API):
 - `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.
+- `PageHeader`: page-level heading block with breadcrumbs/meta/actions slots for dashboard screens.
 - `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`.
@@ -1508,6 +1525,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:
@@ -1574,6 +1622,53 @@ Component tokens (override via `theme.overrides.components.divider`):
 - `gap`, `inset`
 - `labelPadding`, `labelFontSize`
 
+## PageHeader
+
+Props:
+
+- `title?: string`
+- `subtitle?: string`
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `divider?: boolean` (default `false`)
+
+Slots:
+
+- `breadcrumbs` (optional)
+- `title` (optional) - replaces `title` prop rendering
+- `subtitle` (optional) - replaces `subtitle` prop rendering
+- `meta` (optional)
+- `actions` (optional)
+- `default` (optional) - additional body content
+
+Example:
+
+```vue
+<PageHeader title="Projects" subtitle="Manage active projects and team workload.">
+    <template #breadcrumbs>
+        <Breadcrumbs :items="breadcrumbItems" />
+    </template>
+    <template #meta>
+        <Badge severity="info" variant="soft">24 active</Badge>
+        <Chip label="Last sync: 2m ago" />
+    </template>
+    <template #actions>
+        <Button label="Import" variant="outlined" severity="secondary" />
+        <Button label="New project" icon="plus" />
+    </template>
+</PageHeader>
+```
+
+### PageHeader tokens
+
+Component tokens (override via `theme.overrides.components.pageHeader`):
+
+- `gap`, `contentGap`, `breadcrumbGap`, `actionsGap`, `metaGap`
+- `padding`, `borderRadius`, `borderColor`, `backgroundColor`, `textColor`, `dividerColor`
+- `titleFontSize`, `titleLineHeight`, `titleFontWeight`
+- `subtitleFontSize`, `subtitleColor`
+- `small.padding`, `small.titleFontSize`, `small.subtitleFontSize`
+- `large.padding`, `large.titleFontSize`, `large.subtitleFontSize`
+
 ## SegmentedControl
 
 Props:
@@ -3107,7 +3202,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/spinner/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/pageHeader/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`):