@codemonster-ru/vueforge 0.57.0 → 0.59.0

package/README.md

@@ -35,6 +35,7 @@ import {
     ColorPicker,
     MaskedInput,
     NumberInput,
+    Form,
     FormField,
     Textarea,
     FileUpload,
@@ -64,6 +65,7 @@ import {
     AccordionItem,
     Slider,
     Stepper,
+    Timeline,
     Rating,
     Tree,
     TreeSelect,
@@ -88,6 +90,20 @@ app.use(VueForge, {
 
 ```vue
 <Button label="Hello" severity="primary" />
+<Form v-model="formValues" :validate="validateForm" @submit="onSubmit">
+    <template #default="{ values, errors, touched, setFieldValue, setFieldTouched }">
+        <FormField label="Email" :error="touched.email ? errors.email : ''">
+            <template #default>
+                <Input
+                    :model-value="String(values.email ?? '')"
+                    @update:model-value="value => setFieldValue('email', value)"
+                    @blur="() => setFieldTouched('email', true)"
+                />
+            </template>
+        </FormField>
+        <Button type="submit" label="Submit" />
+    </template>
+</Form>
 <FormField label="Name" hint="Required field">
     <Input v-model="name" placeholder="Your name" />
 </FormField>
@@ -138,6 +154,7 @@ app.use(VueForge, {
 />
 <Slider v-model="volume" :min="0" :max="100" :step="5" show-value />
 <Stepper v-model="step" :steps="steps" clickable />
+<Timeline :items="timelineItems" />
 <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" />
@@ -216,6 +233,7 @@ app.use(VueForge, {
 - ColorPicker
 - MaskedInput
 - NumberInput
+- Form
 - FormField
 - Textarea
 - FileUpload
@@ -252,6 +270,7 @@ app.use(VueForge, {
 - Avatar
 - Slider
 - Stepper
+- Timeline
 - Rating
 - Tree
 - TreeSelect
@@ -273,6 +292,60 @@ Input / Search / Password / Textarea (quick API):
 - `FilterChips`: compact chip-based filter toggles with single/multiple selection modes and optional clear action.
 - `SearchInput`, `MentionInput`, `InlineEdit`, `OtpInput`, `ColorPicker`, `MaskedInput`, `Checkbox`, `Select`, `Autocomplete`, `MultiSelect`, `TagInput`, `DatePicker`, `Calendar`, `DateRangePicker`, `DateTimePicker`, `Pagination`, `DataTable`, `SegmentedControl`, and `TreeSelect` also support `variant: 'filled' | 'outlined'`.
 
+## Form
+
+Props:
+
+- `modelValue?: Record<string, unknown>` (v-model)
+- `initialValues?: Record<string, unknown>`
+- `validate?: (values) => Record<string, string> | string | boolean | null | Promise<...>`
+- `validateOn?: 'submit' | 'input' | 'change' | 'blur' | Array<'submit' | 'input' | 'change' | 'blur'>` (default `submit`)
+- `disabled?: boolean`
+- `novalidate?: boolean` (default `true`)
+- `id?: string`
+- `ariaLabel?: string`
+- `ariaLabelledby?: string`
+
+Events:
+
+- `update:modelValue`
+- `change`
+- `blur`
+- `validate`
+- `submit`
+- `invalidSubmit`
+- `reset`
+
+Slots:
+
+- `default` - form helpers:
+  `{ values, errors, touched, isValid, isDirty, isSubmitting, setFieldValue, setFieldTouched, setFieldError, validate, submit, reset }`
+
+Example:
+
+```vue
+<Form v-model="values" :validate="validateForm" validate-on="blur" @submit="send">
+    <template #default="{ values, errors, touched, setFieldValue, setFieldTouched }">
+        <FormField label="Email" :error="touched.email ? errors.email : ''">
+            <template #default>
+                <Input
+                    :model-value="String(values.email ?? '')"
+                    @update:model-value="value => setFieldValue('email', value)"
+                    @blur="() => setFieldTouched('email', true)"
+                />
+            </template>
+        </FormField>
+        <Button type="submit" label="Send" />
+    </template>
+</Form>
+```
+
+### Form tokens
+
+Component tokens (override via `theme.overrides.components.form`):
+
+- `gap`, `textColor`, `disabledOpacity`
+
 ## FormField
 
 Props:
@@ -302,6 +375,9 @@ Example:
 </FormField>
 ```
 
+When `error` is set, `FormField` applies invalid-state border highlighting to nested form controls.
+Customize these colors via `theme.overrides.components.formField.errorBorderColor` and `errorFocusBorderColor`.
+
 ## InlineEdit
 
 Props:
@@ -2189,6 +2265,49 @@ 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`
 
+## Timeline
+
+Props:
+
+- `items?: Array<{ id?: string | number; title?: string; description?: string; date?: string; icon?: string; status?: 'neutral' | 'info' | 'success' | 'warn' | 'danger' }>` (default `[]`)
+- `orientation?: 'vertical' | 'horizontal'` (default `vertical`)
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `ariaLabel?: string`
+- `ariaLabelledby?: string`
+
+Slots:
+
+- `marker` (props: `item`, `index`)
+- `item` (props: `item`, `index`)
+
+Example:
+
+```vue
+<Timeline
+    :items="[
+        { title: 'Created', description: 'Issue created', date: '2026-02-17', status: 'info' },
+        { title: 'In progress', description: 'Developer started work', date: '2026-02-18', status: 'warn' },
+        { title: 'Done', description: 'Issue closed', date: '2026-02-19', status: 'success' },
+    ]"
+/>
+<Timeline :items="events" orientation="horizontal" size="small" />
+```
+
+### Timeline tokens
+
+Component tokens (override via `theme.overrides.components.timeline`):
+
+- `gap`, `itemGap`
+- `markerSize`, `markerBorderRadius`, `markerBorderWidth`, `markerBackgroundColor`, `markerBorderColor`, `markerTextColor`, `markerIconSize`, `dotSize`
+- `lineThickness`, `lineLength`, `lineColor`
+- `titleFontSize`, `titleColor`, `descriptionFontSize`, `descriptionColor`, `dateFontSize`, `dateColor`
+- `info.markerBackgroundColor`, `info.markerBorderColor`, `info.markerTextColor`, `info.lineColor`
+- `success.markerBackgroundColor`, `success.markerBorderColor`, `success.markerTextColor`, `success.lineColor`
+- `warn.markerBackgroundColor`, `warn.markerBorderColor`, `warn.markerTextColor`, `warn.lineColor`
+- `danger.markerBackgroundColor`, `danger.markerBorderColor`, `danger.markerTextColor`, `danger.lineColor`
+- `small.itemGap`, `small.markerSize`, `small.markerIconSize`, `small.dotSize`, `small.lineLength`, `small.dateFontSize`, `small.titleFontSize`, `small.descriptionFontSize`
+- `large.itemGap`, `large.markerSize`, `large.markerIconSize`, `large.dotSize`, `large.lineLength`, `large.dateFontSize`, `large.titleFontSize`, `large.descriptionFontSize`
+
 ## Rating
 
 Props:
@@ -2393,7 +2512,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/inlineEdit/searchInput/mentionInput/passwordInput/otpInput/colorPicker/maskedInput/numberInput/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/stepper/rating/tree/treeselect/virtualScroller).
+- `components.*` accepts component-specific tokens (typed keys: button/card/checkbox/radio/tabs/accordion/toast/alert/input/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/stepper/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):