@codemonster-ru/vueforge 0.58.0 → 0.60.0

package/README.md

@@ -27,6 +27,8 @@ import {
     DefaultTheme,
     Button,
     Input,
+    InputGroup,
+    InputAddon,
     InlineEdit,
     SearchInput,
     MentionInput,
@@ -35,6 +37,7 @@ import {
     ColorPicker,
     MaskedInput,
     NumberInput,
+    Form,
     FormField,
     Textarea,
     FileUpload,
@@ -89,9 +92,28 @@ 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>
+<InputGroup>
+    <InputAddon>$</InputAddon>
+    <NumberInput v-model="price" :min="0" :step="0.5" />
+    <InputAddon>.00</InputAddon>
+</InputGroup>
 <InlineEdit v-model="name" placeholder="No name" />
 <SearchInput v-model="query" placeholder="Search components" clearable />
 <MentionInput v-model="message" :suggestions="mentionSuggestions" placeholder="Type @name" />
@@ -210,6 +232,8 @@ app.use(VueForge, {
 - ToastContainer
 - Alert
 - Input
+- InputGroup
+- InputAddon
 - InlineEdit
 - SearchInput
 - MentionInput
@@ -218,6 +242,7 @@ app.use(VueForge, {
 - ColorPicker
 - MaskedInput
 - NumberInput
+- Form
 - FormField
 - Textarea
 - FileUpload
@@ -260,9 +285,10 @@ app.use(VueForge, {
 - TreeSelect
 - VirtualScroller
 
-Input / Search / Password / Textarea (quick API):
+Input / InputGroup / Search / Password / Textarea (quick API):
 
 - `Input`: single-line control, supports `v-model`, `size`, `variant`, `disabled`, `readonly`.
+- `InputGroup`: horizontal control combiner for field/addon/button layouts with unified corners and borders.
 - `InlineEdit`: inline value editing with view/edit states, save/cancel actions, and text/number modes.
 - `SearchInput`: search-focused control with `debounce`, `clearable`, `loading`, `size`, and `variant`.
 - `MentionInput`: text input with `@`/`#` triggers, suggestions panel, keyboard selection, and mention insertion events.
@@ -276,6 +302,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:
@@ -305,6 +385,46 @@ 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`.
+
+## InputGroup / InputAddon
+
+Props (`InputGroup`):
+
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `variant?: 'filled' | 'outlined'` (default `filled`)
+- `disabled?: boolean` (default `false`)
+
+Props (`InputAddon`):
+
+- `as?: string` (default `span`)
+
+Slots:
+
+- `default` - group controls/addons content
+
+Example:
+
+```vue
+<InputGroup>
+    <InputAddon>$</InputAddon>
+    <NumberInput v-model="price" :min="0" :step="0.5" />
+    <Button label="Apply" />
+</InputGroup>
+```
+
+### InputGroup tokens
+
+Component tokens (override via `theme.overrides.components.inputGroup`):
+
+- `gap`, `borderRadius`
+- `addonPadding`, `addonFontSize`
+- `addonBackgroundColor`, `addonOutlinedBackgroundColor`
+- `addonTextColor`, `addonBorderColor`, `disabledOpacity`
+- `small.addonPadding`, `small.addonFontSize`
+- `large.addonPadding`, `large.addonFontSize`
+
 ## InlineEdit
 
 Props:
@@ -2439,7 +2559,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/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/stepper/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):