@codemonster-ru/vueforge 0.62.0 → 0.64.0

package/README.md

@@ -70,6 +70,8 @@ import {
     Splitter,
     SplitterPanel,
     Stepper,
+    Wizard,
+    WizardStep,
     Timeline,
     Rating,
     Tree,
@@ -81,6 +83,7 @@ import {
     SplitButton,
     ContextMenu,
     CommandPalette,
+    Tour,
 } from '@codemonster-ru/vueforge';
 import '@codemonster-ru/vueforge/dist/index.css';
 
@@ -169,6 +172,10 @@ app.use(VueForge, {
     <SplitterPanel :min-size="20">Right panel</SplitterPanel>
 </Splitter>
 <Stepper v-model="step" :steps="steps" clickable />
+<Wizard v-model="wizardStep" :steps="wizardSteps">
+    <WizardStep value="account">Account step</WizardStep>
+    <WizardStep value="confirm">Confirm step</WizardStep>
+</Wizard>
 <Timeline :items="timelineItems" />
 <Rating v-model="rating" allow-half />
 <Tree v-model="selectedNode" v-model:expandedKeys="expandedKeys" :items="treeItems" />
@@ -221,6 +228,7 @@ app.use(VueForge, {
         { label: 'Save as draft', value: 'draft', group: 'Actions' },
     ]"
 />
+<Tour v-model="tourOpen" :steps="tourSteps" />
 ```
 
 ## Components
@@ -265,6 +273,7 @@ app.use(VueForge, {
 - SplitButton
 - ContextMenu
 - CommandPalette
+- Tour
 - Popover
 - Select
 - Autocomplete
@@ -290,6 +299,8 @@ app.use(VueForge, {
 - Splitter
 - SplitterPanel
 - Stepper
+- Wizard
+- WizardStep
 - Timeline
 - Rating
 - Tree
@@ -310,6 +321,8 @@ Input / InputGroup / Search / Password / Textarea (quick API):
 - `MaskedInput`: formatted input control with string/function masks and optional raw output (`unmask`).
 - `NumberInput`: numeric control, supports `v-model`, `min`, `max`, `step`, `precision`, `controls`, `size`, `variant`.
 - `Splitter`: resizable multi-panel container with draggable separators and `v-model` percentage sizes.
+- `Tour`: guided step-by-step onboarding overlay anchored to target elements.
+- `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`.
 - `FilterChips`: compact chip-based filter toggles with single/multiple selection modes and optional clear action.
@@ -2044,6 +2057,74 @@ Component tokens (override via `theme.overrides.components.commandPalette`):
 - `shortcutBackgroundColor`, `shortcutTextColor`, `shortcutFontSize`
 - `emptyPadding`, `emptyColor`
 
+## Tour
+
+Props:
+
+- `modelValue?: boolean` (v-model)
+- `steps?: Array<{ target?: string | HTMLElement; title?: string; content?: string; placement?: 'top' | 'bottom' | 'left' | 'right'; offset?: number }>`
+- `startIndex?: number` (default `0`)
+- `placement?: 'top' | 'bottom' | 'left' | 'right'` (default `bottom`)
+- `offset?: number` (default `10`)
+- `mask?: boolean` (default `true`)
+- `closeOnOverlay?: boolean` (default `true`)
+- `closeOnEsc?: boolean` (default `true`)
+- `showSkip?: boolean` (default `true`)
+- `showProgress?: boolean` (default `true`)
+- `spotlightPadding?: number` (default `6`)
+- `nextLabel?: string` (default `Next`)
+- `prevLabel?: string` (default `Back`)
+- `finishLabel?: string` (default `Finish`)
+- `skipLabel?: string` (default `Skip`)
+- `ariaLabel?: string` (default `Tour`)
+
+Slots:
+
+- `default` - step content with slot props `{ step, index }`
+- `title` (optional) - step title with slot props `{ step, index }`
+- `actions` (optional) - custom actions with slot props `{ step, index, isFirst, isLast, prev, next, skip }`
+
+Events:
+
+- `update:modelValue`
+- `open`
+- `close` (payload reason: `overlay | esc | complete | skip`)
+- `stepChange`
+- `next`
+- `prev`
+- `complete`
+- `skip`
+
+Example:
+
+```vue
+<Tour
+    v-model="tourOpen"
+    :steps="[
+        { target: '#tour-start', title: 'Start', content: 'Launch onboarding here.' },
+        { target: '#tour-search', title: 'Search', content: 'Find projects quickly.', placement: 'bottom' },
+    ]"
+/>
+```
+
+### Tour tokens
+
+Component tokens (override via `theme.overrides.components.tour`):
+
+- `zIndex`, `overlayBackgroundColor`
+- `width`, `maxWidth`, `padding`
+- `borderRadius`, `borderColor`
+- `backgroundColor`, `textColor`, `shadow`
+- `titleGap`, `titleFontSize`, `titleLineHeight`, `titleFontWeight`
+- `contentGap`, `contentFontSize`, `contentLineHeight`, `contentColor`
+- `progressGap`, `progressFontSize`, `progressColor`
+- `actionsGap`
+- `buttonMinWidth`, `buttonPadding`, `buttonRadius`
+- `buttonBorderColor`, `buttonBackgroundColor`, `buttonTextColor`, `buttonHoverBackgroundColor`
+- `secondaryButtonBorderColor`, `secondaryButtonBackgroundColor`, `secondaryButtonTextColor`, `secondaryButtonHoverBackgroundColor`
+- `spotlightRadius`, `spotlightBorderWidth`, `spotlightBorderColor`
+- `disabledOpacity`
+
 ## Tooltip
 
 Props:
@@ -2405,6 +2486,74 @@ Component tokens (override via `theme.overrides.components.stepper`):
 - `small.indicatorSize`, `small.indicatorFontSize`, `small.labelFontSize`, `small.descriptionFontSize`, `small.lineLength`, `small.itemGap`
 - `large.indicatorSize`, `large.indicatorFontSize`, `large.labelFontSize`, `large.descriptionFontSize`, `large.lineLength`, `large.itemGap`
 
+## Wizard / WizardStep
+
+Props (`Wizard`):
+
+- `modelValue?: string | number` (v-model active step value)
+- `steps?: Array<{ value: string | number; title?: string; description?: string; optional?: boolean; disabled?: boolean; validate?: (value, index) => boolean | string | Promise<...> }>`
+- `linear?: boolean` (default `true`)
+- `disabled?: boolean` (default `false`)
+- `nextLabel?: string` (default `Next`)
+- `prevLabel?: string` (default `Back`)
+- `finishLabel?: string` (default `Finish`)
+- `validateStep?: (step, index, value) => boolean | string | Promise<...>`
+- `ariaLabel?: string`
+- `ariaLabelledby?: string`
+
+Props (`WizardStep`):
+
+- `value: string | number` (must match one of `Wizard.steps[].value`)
+
+Slots (`Wizard`):
+
+- `default` - place `WizardStep` components
+- `indicator` (optional) - slot props `{ step, index }`
+- `actions` (optional) - slot props `{ step, index, isFirst, isLast, next, prev, complete }`
+
+Events (`Wizard`):
+
+- `update:modelValue`
+- `change`
+- `next`
+- `prev`
+- `complete`
+- `invalidStep`
+
+Example:
+
+```vue
+<Wizard v-model="wizardStep" :steps="wizardSteps">
+    <WizardStep value="account">
+        <Input v-model="email" placeholder="Email" />
+    </WizardStep>
+    <WizardStep value="plan">
+        <Select v-model="plan" :options="plans" />
+    </WizardStep>
+    <WizardStep value="confirm">
+        Review and finish
+    </WizardStep>
+</Wizard>
+```
+
+### Wizard tokens
+
+Component tokens (override via `theme.overrides.components.wizard`):
+
+- `gap`, `borderColor`, `headerPaddingBottom`
+- `itemGap`, `stepGap`
+- `indicatorSize`, `indicatorBorderRadius`, `indicatorFontSize`
+- `indicatorBorderColor`, `indicatorBackgroundColor`, `indicatorTextColor`
+- `activeIndicatorBorderColor`, `activeIndicatorBackgroundColor`, `activeIndicatorTextColor`
+- `completedIndicatorBorderColor`, `completedIndicatorBackgroundColor`, `completedIndicatorTextColor`
+- `errorIndicatorBorderColor`, `errorIndicatorBackgroundColor`, `errorIndicatorTextColor`
+- `titleFontSize`, `titleColor`, `descriptionFontSize`, `descriptionColor`
+- `actionsGap`
+- `buttonMinWidth`, `buttonPadding`, `buttonBorderRadius`
+- `buttonBorderColor`, `buttonBackgroundColor`, `buttonTextColor`, `buttonHoverBackgroundColor`
+- `secondaryButtonBorderColor`, `secondaryButtonBackgroundColor`, `secondaryButtonTextColor`, `secondaryButtonHoverBackgroundColor`
+- `disabledOpacity`
+
 ## Timeline
 
 Props:
@@ -2652,7 +2801,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/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/select/autocomplete/combobox/multiselect/taginput/datepicker/calendar/daterangepicker/timepicker/datetimepicker/pagination/switch/segmentedControl/tooltip/skeleton/progress/badge/chip/filterChips/avatar/datatable/slider/splitter/stepper/rating/tree/treeselect/virtualScroller).
+- `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/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/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).
 
 Default core values (from `DefaultTheme`):