⚠️ Breaking Changes

• Exposed flow method handleFlow now accepts a step value instead of an index and has been renamed to executeFlow
• partial in flow prop is removed, since it has no effect on the behaviour. Prop remains an object in case of potential updates
• @flow-step emitted event will provide the step value instead of the step index

For more info, take a look at the migration guide

🚀 Features

• Accessibility improvements (#1211)
  • New events added (@menu-mounted, @menu-unmounted), each carries the menu HTMLElement
  • New property added in config, onInternalKeydown
  • onKeyUp is now teleport-aware
  • Forced shift + tab close is now gated behind config.tabOutClosesMenu
  • onKeyDown is now aware of config.spaceConfirm
  • Enter key on the input field is guarded by preventDefault + stopImmediatePropagation
  • Added Enter case for onKeyDown in the menu with the same opt-in logic
  • Various aria-* improvements

🐛 Bug Fixes

• Fixed issue with nuxt hydration mismatch error and warnings (#1210)
• Fixed issue with text-input in time-picker snaps to startTime/now mid-typing, not respecting invalid input value (#1212)
• Fixed issue with elements under overlays remain focusable (#1213)
• Fixed issue with wrong calendar when using timezone (#1233)
• Fixed issue with quasar marking time input as disabled (#1243)
• Fixed issue when using textInput.format function throwing an error (#1246)
• Fixed issue with "Now" button only working in date picker mode (#1249)
• Fixed issue where menu arrow is missing when positioning the menu to top-start/end or bottom-start/end (#1257)
• Fixed issue where update-month-year is not being emitted when changed from selecting a date from a different month (#1258)
• Fixed issue with infinite loop when using timezone and multi-calendars (#1273)
• Fixed issue where menu arrow is not centered compared to the reference element when menu position is shifted
• Fixed issue where year selection overlay in year flow step opens the overlay on top instead of selected year position
• Fixed issue where fixed start/end range dates times were mutable

🔧 Refactor

• Flow has been re-worked to be more stable, it will also resume from any step if the flow is broken.

⚠️ Breaking Chnages

• All class names are renamed from underscore to dash
• Few class wordings are changed and few removed
• week-start is now taken from the locale prop instead of defaulting to Monday.

For more info, take a look at the migration guide

🚀 Features

• Automatically use week-start based on the locale prop (#1236)

🐛 Bug Fixes

• Fixed issue with text-input not parsing letters used for values (#1222, #1234)
• Fixed teleport prop type for proper boolean support (by @syyyr) (#1223)
• Fixed issue with input loosing focus upon opening the menu with selectOnFocus enabled (by @abdouthetif) (#1224, #1225)
• Fixed issue with missing source files warning (#1226)
• Fixed issue with new unplugin-dts types generating throwing error (#1231)
• Fixed TypeScript issue on slots that provide different props in different modes (#1232)
• Fixed issue with invalid time value when switching programatically between enabled/disabled range (by @Kapcash) (#1256, #1259)
• Fixed issue with broken filters.years on month-picker and quarter-picker (by @umutcantopal) (#1263, #1264)
• Fixed issue with formats.input not being propagated to formats.preview (#1261)
• Fixed issue with extra spaces in range separator where text input is enabled with range (by @AlexanderNP) (#1269, #1271)
• Fixed issue with menu wrap remaining in the DOM after closing the menu (by @alexovn) (#1278, #1279)

🔧 Refactor

• Added data-test-id for preview section (by @jaccodenneboom) (#1219, #1220)
• Repository converted to pnpm workspace and package manager changed to pnpm
• Removed sass and replaced with plain css

🚀 Features

• Added support for arrow-navigation in multi-calendars mode (#1086)
• Added support for multiple range separators in text-input (#1096)
• Added option to disable auto range start/end switch (#1114)
• Added applyOnBlur property in text-input configuration (#1182)
• Added WeekStart enum export by @ChronosMasterOfAllTime (#1199)
• Improve UI/UX for fixed start/end range hover and extending the range (#1200)
• Added formatValue to the action-preview slot props (#1207)
• Exposed selectDate and disabled flag to action-buttons slot (#1207)
• Exposed internal refs dpMenuRef, dpWrapMenuRef and inputRef (#1209)
• Added options to floating prop for customizing shift and flip middleware behaviour (#1215)

🐛 Bug Fixes

• Fixed issue where action-extra slot is displayed inline when the sidebar slot is provided (#1202)
• Fixed issue with missing {hours/minutes/seconds}Increment in time-config prop type definition (#1203)
• Fixed issue with vitest failing tests when using global.stubs.teleport from vue-test-utils (#1206)
• Fixed issue with failing to properly parse text-input date when the pattern includes short year (#1208)

🔧 Refactor

• arrow-navigation will now start from the active element instead of top-left (#1118)
• Refactor slot propagation across components, added type exports per mode for [left/right]-sidebar and month-year slot props

🐛 Bug Fixes

• Fixed issue with menu re-rendering while in the open state (#1192)
• FIxed issue where de-selecting multi-dates breaks time object (#1194)
• Fixed issue with menu not opening when centered prop is enabled by @alexpopovme (#1195)
• Fixed issue with calendar days shifting depending on the OS timezone (#1198)

🔧 Refactor

• boolean HTML attributes are removed from DOM when the value is false (#1191)

🐛 Bug Fixes

• Fixed issue where multi-calendars navigation in inline mode remounts calendar on position update (#1183)
• Fixed issue where end time resets on range date select (#1184)
• Fixed wrong type definition for action-row slot props (#1185)
• Fixed issue where "blur" event is being emitted on every click outside (#1186)
• Fixed issue where clearing text-input value with auto-apply emits an empty string (#1187)
• Fixed issue where auto-apply on range select doesn't close the menu (#1188)
• Fixed wrong type for updateTime function in time-picker slot (#1189)
• Fixed issue where setDateOnMenuClose triggers update:model-value to be emitted on every click outside (#1190)

🐛 Bug Fix

• (Regression) Fixed wrong types for text-input format property and proper parsing based on the provided value (#1181)

🐛 Bug Fixes

• Fixed issue where overlay-toggle event is not emitted on month/year open (#1175)
• Fixed issue where v-model value set externally not working in the disabled or readonly state (#1176)
• Make all types exported (#1179)

🐛 Bug Fixes

• Fixed issue where text-input format pattern not propely inheriting default value from formats (#1172)
• Fixed issue where selecting more that one date in multi-dates mode throws an error (#1173)

⚠️ Breaking changes

This release includes a lot of internal refactor and a lot of breaking changes.

Please take a look at the migration guide

🚀 Features

• Added option to add calendard instance in setMonthYear exposed function (#1120)
• Added option to hide menu arrow (floating prop) (#1089)
• Added option to change inputmode (#1149)
• Added option to set custom input id (input-attrs prop) (#1163)
• Added @invalid event that propagates oninvalid from the input field (#1127)
• Added input masking on text-input alpha stage , tnx to @apsisxcoder (#1131)
• Added support for rounding the value on now button (action-row prop) (#1138)

🐛 Bug Fixes

• Fixed issue where time values in the overlay are not reacting to v-model change (#1108)
• Fixed issue with time increment when picking from non-DST to DST date (#1112)
• Fixed issue with being unable to use auto-apply when partialRange is enabled (#1113)
• Fixed issue where Increasing calendar width makes the inline time picker not centered (#1117)
• Fixed issue where maxRange and minRange are not working in year-picker mode (#1123)
• Fixed issue where mobile swipe causes an unwanted selection of dates in the calendar (#1124, #1169)
• Fixed issue where auto-apply closes the picker when using flow with range (#1125)
• Fixed issue where start-date is not working in quarter-picker mode (#1133)
• Fixed issue where events range-start and range-end are not emitted when the time is updated (fixes #1142)
• Fixed positioning issue on smaller screens with preset-dates enabled (#1144)
• Fixed issue with wrong week numbers from 2027 (#1147)
• Fixed isue where auto-apply not selecting range in quarter-picker mode (#1166)

🔧 Other

• Use @floating-ui/vue for menu positioning instead of custom positioning logic
• Use @vueuse/core: onClickOutside and unrefElement instead of copied logic
• Use @date-fns/tz for timezone calculations instead of basic custom implementation
• Documentation website source code is moved under repository and updated
• Full type support throughout the library
• Root types are auto generated

🐛 Bug Fixes

• Fixed wrong aria-label calendar cell from aria-pressed to aria-selected by (#1102) @sahilrajthapa
• Fixed issue where you can't type date when text-input and auto-apply are enabled (#1106) by @JoaoPedroAS51
• Fixed issue with disabled-dates function not working in year-picker mode (#1107) by @sahilrajthapa
• Fixed wrong css variable on time picker arrow icon (#1109) by @ayrtonandino
• Fixed issue with selectable months if year is out of range in month-picker mode (#1145) by @spider-hand
• Removed extra padding from the input when clearable is set to false (#1150) by @Amirkian2023
• Fixed missing value and text props in year slot when using the month-picker mode (#1154) by @mayswind
• Fixed a11y typo in aria-selected logic for range end dates (#1167) by @brandonlavello