@codemonster-ru/vueforge 0.49.0 → 0.51.0

package/README.md

@@ -27,6 +27,7 @@ import {
     DefaultTheme,
     Button,
     Input,
+    SearchInput,
     PasswordInput,
     OtpInput,
     ColorPicker,
@@ -43,6 +44,7 @@ import {
     DatePicker,
     DateRangePicker,
     TimePicker,
+    DateTimePicker,
     Pagination,
     DataTable,
     Checkbox,
@@ -83,6 +85,7 @@ app.use(VueForge, {
 <FormField label="Name" hint="Required field">
     <Input v-model="name" placeholder="Your name" />
 </FormField>
+<SearchInput v-model="query" placeholder="Search components" clearable />
 <PasswordInput v-model="password" placeholder="Enter password" show-strength />
 <OtpInput v-model="otp" :length="6" />
 <ColorPicker v-model="brandColor" :presets="['#2b6cb0', '#0cbc87', '#d6293e']" />
@@ -98,6 +101,7 @@ app.use(VueForge, {
 <DatePicker v-model="birthday" placeholder="Pick birthday" />
 <DateRangePicker v-model="range" placeholder="Pick range" />
 <TimePicker v-model="meetingTime" placeholder="Pick time" />
+<DateTimePicker v-model="meetingAt" placeholder="Pick date and time" />
 <Pagination v-model="page" :total-items="240" :page-size="20" />
 <DataTable :columns="columns" :rows="rows" sortable striped />
 <Checkbox v-model="agreed" label="I agree" />
@@ -178,6 +182,7 @@ app.use(VueForge, {
 - ToastContainer
 - Alert
 - Input
+- SearchInput
 - PasswordInput
 - OtpInput
 - ColorPicker
@@ -204,6 +209,7 @@ app.use(VueForge, {
 - DatePicker
 - DateRangePicker
 - TimePicker
+- DateTimePicker
 - Pagination
 - DataTable
 - Switch
@@ -220,9 +226,10 @@ app.use(VueForge, {
 - TreeSelect
 - VirtualScroller
 
-Input / Password / Textarea (quick API):
+Input / Search / Password / Textarea (quick API):
 
 - `Input`: single-line control, supports `v-model`, `size`, `variant`, `disabled`, `readonly`.
+- `SearchInput`: search-focused control with `debounce`, `clearable`, `loading`, `size`, and `variant`.
 - `PasswordInput`: password control, supports visibility toggle, strength meter, CapsLock hint, `size`, and `variant`.
 - `OtpInput`: one-time code control, supports fixed length, paste handling, numeric/alphanumeric modes, `size`, and `variant`.
 - `ColorPicker`: color control with presets, optional alpha channel, and output formats (`hex`/`rgb`/`hsl`).
@@ -230,7 +237,7 @@ Input / Password / Textarea (quick API):
 - `NumberInput`: numeric control, supports `v-model`, `min`, `max`, `step`, `precision`, `controls`, `size`, `variant`.
 - `Textarea`: multi-line control, same as Input plus `rows`.
 - `TagInput`: token/tag control, supports `v-model` (array), suggestions, custom tags, `maxTags`, `clearable`, `size`, `variant`.
-- `OtpInput`, `ColorPicker`, `MaskedInput`, `Checkbox`, `Select`, `Autocomplete`, `MultiSelect`, `TagInput`, `DatePicker`, `DateRangePicker`, `Pagination`, `DataTable`, and `TreeSelect` also support `variant: 'filled' | 'outlined'`.
+- `SearchInput`, `OtpInput`, `ColorPicker`, `MaskedInput`, `Checkbox`, `Select`, `Autocomplete`, `MultiSelect`, `TagInput`, `DatePicker`, `DateRangePicker`, `DateTimePicker`, `Pagination`, `DataTable`, and `TreeSelect` also support `variant: 'filled' | 'outlined'`.
 
 ## FormField
 
@@ -510,6 +517,65 @@ Component tokens (override via `theme.overrides.components.timepicker`):
 - `small.fontSize`, `small.padding`
 - `large.fontSize`, `large.padding`
 
+## DateTimePicker
+
+Props:
+
+- `modelValue?: string` (v-model, ISO datetime `YYYY-MM-DDTHH:mm`)
+- `placeholder?: string`
+- `disabled?: boolean`
+- `readonly?: boolean`
+- `min?: string` (ISO datetime `YYYY-MM-DDTHH:mm`)
+- `max?: string` (ISO datetime `YYYY-MM-DDTHH:mm`)
+- `locale?: string` (default `en-US`)
+- `firstDayOfWeek?: number` (default `0`, Sunday)
+- `minuteStep?: number` (default `30`)
+- `format?: '24h' | '12h'` (default `24h`)
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `variant?: 'filled' | 'outlined'` (default `filled`)
+
+Events:
+
+- `update:modelValue`
+- `change`
+- `focus`
+- `blur`
+
+Example:
+
+```vue
+<DateTimePicker v-model="meetingAt" placeholder="Pick date and time" />
+<DateTimePicker
+    v-model="meetingAtAlt"
+    variant="outlined"
+    min="2026-01-10T09:00"
+    max="2026-12-31T18:00"
+    :minute-step="15"
+    format="12h"
+/>
+```
+
+### DateTimePicker tokens
+
+Component tokens (override via `theme.overrides.components.datetimepicker`):
+
+- `minWidth`, `fontSize`, `controlGap`, `chevronSize`
+- `padding`, `borderRadius`, `borderColor`
+- `backgroundColor`, `textColor`, `placeholderColor`
+- `focusBorderColor`, `focusRingShadow`, `hoverBorderColor`
+- `disabledOpacity`
+- `panelWidth`, `panelBackgroundColor`, `panelBorderColor`, `panelPadding`, `panelRadiusOffset`, `panelShadow`, `panelGap`
+- `headerGap`, `headerPadding`, `monthLabelFontSize`, `monthLabelFontWeight`
+- `navButtonSize`, `navButtonRadius`, `navButtonFontSize`
+- `weekdayColor`, `weekdayFontSize`, `weekdaysMarginBottom`
+- `daysGap`, `daySize`, `dayFontSize`, `dayBorderRadius`
+- `dayHoverBackgroundColor`, `daySelectedBackgroundColor`, `daySelectedTextColor`, `dayMutedColor`, `dayTodayBorderColor`
+- `timesWidth`, `timesMaxHeight`, `timesPaddingLeft`, `timesBorderColor`
+- `timeOptionPadding`, `timeOptionBorderRadius`, `timeOptionFontSize`
+- `timeOptionHoverBackgroundColor`, `timeOptionActiveBackgroundColor`, `timeOptionActiveTextColor`
+- `small.fontSize`, `small.padding`, `small.daySize`
+- `large.fontSize`, `large.padding`, `large.daySize`
+
 ## Pagination
 
 Props:
@@ -696,6 +762,53 @@ Component tokens (override via `theme.overrides.components.fileUpload`):
 - `small.fontSize`, `small.padding`, `small.buttonPadding`
 - `large.fontSize`, `large.padding`, `large.buttonPadding`
 
+## SearchInput
+
+Props:
+
+- `modelValue?: string` (v-model)
+- `placeholder?: string`
+- `disabled?: boolean`
+- `readonly?: boolean`
+- `debounce?: number` (default `300`)
+- `loading?: boolean` (default `false`)
+- `clearable?: boolean` (default `false`)
+- `size?: 'small' | 'normal' | 'large'` (default `normal`)
+- `variant?: 'filled' | 'outlined'` (default `filled`)
+- `ariaLabel?: string` (default `Search input`)
+
+Events:
+
+- `update:modelValue`
+- `input`
+- `change`
+- `search`
+- `clear`
+- `focus`
+- `blur`
+
+Example:
+
+```vue
+<SearchInput v-model="query" placeholder="Search..." clearable />
+<SearchInput v-model="query" placeholder="Search..." :debounce="500" loading variant="outlined" />
+```
+
+### SearchInput tokens
+
+Component tokens (override via `theme.overrides.components.searchInput`):
+
+- `gap`, `fontSize`, `padding`
+- `borderRadius`, `borderColor`
+- `backgroundColor`, `textColor`, `placeholderColor`
+- `focusBorderColor`, `focusRingShadow`, `hoverBorderColor`
+- `disabledOpacity`
+- `iconSize`, `iconColor`
+- `clearSize`, `clearRadius`, `clearHoverBackgroundColor`
+- `loadingSize`, `loadingBorderColor`, `loadingTopBorderColor`
+- `small.fontSize`, `small.padding`, `small.iconSize`, `small.clearSize`
+- `large.fontSize`, `large.padding`, `large.iconSize`, `large.clearSize`
+
 ## NumberInput
 
 Props:
@@ -1942,7 +2055,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/passwordInput/otpInput/colorPicker/maskedInput/numberInput/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/select/autocomplete/multiselect/taginput/datepicker/daterangepicker/timepicker/pagination/switch/tooltip/skeleton/progress/badge/chip/avatar/datatable/slider/stepper/rating/tree/treeselect/virtualScroller).
+- `components.*` accepts component-specific tokens (typed keys: button/card/checkbox/radio/tabs/accordion/toast/alert/input/searchInput/passwordInput/otpInput/colorPicker/maskedInput/numberInput/formField/textarea/link/breadcrumbs/menu/modal/confirmDialog/drawer/popover/dropdown/contextMenu/commandPalette/select/autocomplete/multiselect/taginput/datepicker/daterangepicker/timepicker/datetimepicker/pagination/switch/tooltip/skeleton/progress/badge/chip/avatar/datatable/slider/stepper/rating/tree/treeselect/virtualScroller).
 
 Default core values (from `DefaultTheme`):