@quidgest/ui 0.29.0 → 0.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/CHANGELOG.md +59 -0
  2. package/README.md +2 -20
  3. package/dist/json/api.json +1059 -803
  4. package/dist/ui.css +77 -29
  5. package/dist/ui.esm.js +1093 -994
  6. package/dist/ui.min.css +1 -1
  7. package/dist/ui.scss +75 -24
  8. package/esm/components/QAccordion/QAccordion.d.ts.map +1 -1
  9. package/esm/components/QAccordion/QAccordion.vue.js +2 -0
  10. package/esm/components/QAccordion/QAccordionItem.d.ts.map +1 -1
  11. package/esm/components/QAccordion/QAccordionItem.vue.js +3 -0
  12. package/esm/components/QAccordion/index.d.ts +3 -0
  13. package/esm/components/QAccordion/index.d.ts.map +1 -1
  14. package/esm/components/QAccordion/types.d.ts +8 -0
  15. package/esm/components/QAccordion/types.d.ts.map +1 -1
  16. package/esm/components/QAlert/QAlert.d.ts +1 -1
  17. package/esm/components/QAlert/index.d.ts +3 -3
  18. package/esm/components/QAvatar/QAvatar.d.ts +1 -1
  19. package/esm/components/QAvatar/index.d.ts +3 -3
  20. package/esm/components/QBadgeIndicator/QBadgeIndicator.d.ts.map +1 -1
  21. package/esm/components/QBadgeIndicator/QBadgeIndicator.vue.js +23 -13
  22. package/esm/components/QBadgeIndicator/types.d.ts +13 -0
  23. package/esm/components/QBadgeIndicator/types.d.ts.map +1 -1
  24. package/esm/components/QBreadcrumbs/QBreadcrumbs.d.ts.map +1 -1
  25. package/esm/components/QBreadcrumbs/QBreadcrumbs.vue.js +31 -31
  26. package/esm/components/QButton/QButton.d.ts.map +1 -1
  27. package/esm/components/QButton/QButton.vue.js +54 -48
  28. package/esm/components/QButtonGroup/QButtonGroup.d.ts.map +1 -1
  29. package/esm/components/QCard/QCard.d.ts.map +1 -1
  30. package/esm/components/QCard/QCard.vue.js +48 -32
  31. package/esm/components/QCard/types.d.ts +9 -0
  32. package/esm/components/QCard/types.d.ts.map +1 -1
  33. package/esm/components/QCarousel/QCarousel.d.ts +1 -0
  34. package/esm/components/QCarousel/QCarousel.d.ts.map +1 -1
  35. package/esm/components/QCarousel/QCarousel.vue.js +84 -80
  36. package/esm/components/QCarousel/index.d.ts +6 -0
  37. package/esm/components/QCarousel/index.d.ts.map +1 -1
  38. package/esm/components/QCarousel/types.d.ts +9 -1
  39. package/esm/components/QCarousel/types.d.ts.map +1 -1
  40. package/esm/components/QCheckbox/QCheckbox.d.ts.map +1 -1
  41. package/esm/components/QCheckbox/QCheckbox.vue.js +9 -1
  42. package/esm/components/QCheckbox/index.d.ts +3 -0
  43. package/esm/components/QCheckbox/index.d.ts.map +1 -1
  44. package/esm/components/QCheckbox/types.d.ts +8 -0
  45. package/esm/components/QCheckbox/types.d.ts.map +1 -1
  46. package/esm/components/QCollapsible/QCollapsible.d.ts +1 -0
  47. package/esm/components/QCollapsible/QCollapsible.d.ts.map +1 -1
  48. package/esm/components/QCollapsible/QCollapsible.vue.js +55 -47
  49. package/esm/components/QCollapsible/index.d.ts +6 -0
  50. package/esm/components/QCollapsible/index.d.ts.map +1 -1
  51. package/esm/components/QCollapsible/types.d.ts +9 -0
  52. package/esm/components/QCollapsible/types.d.ts.map +1 -1
  53. package/esm/components/QColorPicker/QColorPicker.d.ts.map +1 -1
  54. package/esm/components/QColorPicker/QColorPicker.vue.js +4 -1
  55. package/esm/components/QColorPicker/index.d.ts +3 -0
  56. package/esm/components/QColorPicker/index.d.ts.map +1 -1
  57. package/esm/components/QColorPicker/types.d.ts +7 -0
  58. package/esm/components/QColorPicker/types.d.ts.map +1 -1
  59. package/esm/components/QCombobox/QCombobox.d.ts +7 -0
  60. package/esm/components/QCombobox/QCombobox.d.ts.map +1 -1
  61. package/esm/components/QCombobox/QCombobox.vue.js +258 -235
  62. package/esm/components/QCombobox/constants.d.ts +1 -0
  63. package/esm/components/QCombobox/constants.d.ts.map +1 -1
  64. package/esm/components/QCombobox/constants.js +1 -0
  65. package/esm/components/QCombobox/index.d.ts +11 -0
  66. package/esm/components/QCombobox/index.d.ts.map +1 -1
  67. package/esm/components/QDateTimePicker/QDateTimePicker.d.ts +180 -0
  68. package/esm/components/QDateTimePicker/QDateTimePicker.d.ts.map +1 -1
  69. package/esm/components/QDateTimePicker/QDateTimePicker.vue.js +637 -542
  70. package/esm/components/QDateTimePicker/index.d.ts +90 -0
  71. package/esm/components/QDateTimePicker/index.d.ts.map +1 -1
  72. package/esm/components/QDialog/QDialog.d.ts.map +1 -1
  73. package/esm/components/QDialog/QDialog.vue.js +2 -0
  74. package/esm/components/QDialog/types.d.ts +3 -1
  75. package/esm/components/QDialog/types.d.ts.map +1 -1
  76. package/esm/components/QDropdownMenu/QDropdownMenu.d.ts +3 -1
  77. package/esm/components/QDropdownMenu/QDropdownMenu.d.ts.map +1 -1
  78. package/esm/components/QDropdownMenu/QDropdownMenu.vue.js +84 -27
  79. package/esm/components/QDropdownMenu/QDropdownMenuContent.d.ts +9 -2
  80. package/esm/components/QDropdownMenu/QDropdownMenuContent.d.ts.map +1 -1
  81. package/esm/components/QDropdownMenu/QDropdownMenuContent.vue.js +168 -135
  82. package/esm/components/QDropdownMenu/ids.d.ts +8 -0
  83. package/esm/components/QDropdownMenu/ids.d.ts.map +1 -0
  84. package/esm/components/QDropdownMenu/ids.js +6 -0
  85. package/esm/components/QDropdownMenu/index.d.ts +9 -3
  86. package/esm/components/QDropdownMenu/index.d.ts.map +1 -1
  87. package/esm/components/QDropdownMenu/types.d.ts +3 -1
  88. package/esm/components/QDropdownMenu/types.d.ts.map +1 -1
  89. package/esm/components/QField/QField.d.ts +2 -0
  90. package/esm/components/QField/QField.d.ts.map +1 -1
  91. package/esm/components/QField/QField.vue.js +68 -61
  92. package/esm/components/QField/ids.d.ts +15 -0
  93. package/esm/components/QField/ids.d.ts.map +1 -0
  94. package/esm/components/QField/ids.js +10 -0
  95. package/esm/components/QField/index.d.ts +2 -0
  96. package/esm/components/QField/index.d.ts.map +1 -1
  97. package/esm/components/QFileUpload/QFileUpload.d.ts +355 -0
  98. package/esm/components/QFileUpload/QFileUpload.d.ts.map +1 -1
  99. package/esm/components/QFileUpload/QFileUpload.vue.js +118 -88
  100. package/esm/components/QFileUpload/constants.d.ts +2 -0
  101. package/esm/components/QFileUpload/constants.d.ts.map +1 -1
  102. package/esm/components/QFileUpload/constants.js +3 -1
  103. package/esm/components/QFileUpload/index.d.ts +182 -0
  104. package/esm/components/QFileUpload/index.d.ts.map +1 -1
  105. package/esm/components/QIcon/QIconFont.d.ts.map +1 -1
  106. package/esm/components/QIcon/QIconFont.vue.js +2 -1
  107. package/esm/components/QIcon/QIconImg.d.ts.map +1 -1
  108. package/esm/components/QIcon/QIconImg.vue.js +1 -0
  109. package/esm/components/QIcon/QIconSvg.d.ts.map +1 -1
  110. package/esm/components/QInputGroup/QInputGroup.d.ts +5 -0
  111. package/esm/components/QInputGroup/QInputGroup.d.ts.map +1 -1
  112. package/esm/components/QInputGroup/QInputGroup.vue.js +48 -41
  113. package/esm/components/QInputGroup/index.d.ts +3 -0
  114. package/esm/components/QInputGroup/index.d.ts.map +1 -1
  115. package/esm/components/QLabel/QLabel.d.ts.map +1 -1
  116. package/esm/components/QLabel/QLabel.vue.js +21 -19
  117. package/esm/components/QLabel/ids.d.ts +9 -0
  118. package/esm/components/QLabel/ids.d.ts.map +1 -0
  119. package/esm/components/QLabel/ids.js +6 -0
  120. package/esm/components/QLineLoader/QLineLoader.d.ts.map +1 -1
  121. package/esm/components/QLineLoader/QLineLoader.vue.js +15 -14
  122. package/esm/components/QList/QList.d.ts +3 -3
  123. package/esm/components/QList/QList.d.ts.map +1 -1
  124. package/esm/components/QList/QList.vue.js +135 -117
  125. package/esm/components/QList/QListItem.d.ts.map +1 -1
  126. package/esm/components/QList/QListItem.vue.js +54 -50
  127. package/esm/components/QList/context.d.ts +8 -0
  128. package/esm/components/QList/context.d.ts.map +1 -0
  129. package/esm/components/QList/context.js +4 -0
  130. package/esm/components/QMeter/QMeter.d.ts.map +1 -1
  131. package/esm/components/QMeter/QMeter.vue.js +38 -19
  132. package/esm/components/QMeter/index.d.ts +2 -10
  133. package/esm/components/QMeter/index.d.ts.map +1 -1
  134. package/esm/components/QMeter/types.d.ts +9 -1
  135. package/esm/components/QMeter/types.d.ts.map +1 -1
  136. package/esm/components/QObfuscation/QObfuscation.d.ts.map +1 -1
  137. package/esm/components/QObfuscation/QObfuscation.vue.js +42 -26
  138. package/esm/components/QObfuscation/index.d.ts.map +1 -1
  139. package/esm/components/QOverflow/QOverflow.d.ts.map +1 -1
  140. package/esm/components/QOverflow/QOverflow.vue.js +94 -73
  141. package/esm/components/QOverlay/QOverlay.d.ts.map +1 -1
  142. package/esm/components/QOverlay/QOverlay.vue.js +162 -132
  143. package/esm/components/QPasswordField/QPasswordField.d.ts +4 -0
  144. package/esm/components/QPasswordField/QPasswordField.d.ts.map +1 -1
  145. package/esm/components/QPasswordField/QPasswordField.vue.js +72 -66
  146. package/esm/components/QPasswordField/QPasswordFieldMeterOverlay.d.ts.map +1 -1
  147. package/esm/components/QPasswordField/QPasswordFieldMeterOverlay.vue.js +4 -2
  148. package/esm/components/QPasswordField/index.d.ts +2 -0
  149. package/esm/components/QPasswordField/index.d.ts.map +1 -1
  150. package/esm/components/QPasswordField/types.d.ts +4 -0
  151. package/esm/components/QPasswordField/types.d.ts.map +1 -1
  152. package/esm/components/QPhoneField/QPhoneField.d.ts +34 -3
  153. package/esm/components/QPhoneField/QPhoneField.d.ts.map +1 -1
  154. package/esm/components/QPhoneField/QPhoneField.vue.js +98 -102
  155. package/esm/components/QPhoneField/constants.d.ts +2 -1
  156. package/esm/components/QPhoneField/constants.d.ts.map +1 -1
  157. package/esm/components/QPhoneField/constants.js +1 -1
  158. package/esm/components/QPhoneField/index.d.ts +26 -8
  159. package/esm/components/QPhoneField/index.d.ts.map +1 -1
  160. package/esm/components/QPhoneField/types.d.ts +5 -2
  161. package/esm/components/QPhoneField/types.d.ts.map +1 -1
  162. package/esm/components/QPopover/QPopover.d.ts +1 -1
  163. package/esm/components/QPopover/index.d.ts +3 -3
  164. package/esm/components/QProgress/QProgress.d.ts.map +1 -1
  165. package/esm/components/QProgress/QProgress.vue.js +1 -1
  166. package/esm/components/QPropertyList/QPropertyList.vue.js +1 -1
  167. package/esm/components/QPropertyList/QPropertyListRow.d.ts.map +1 -1
  168. package/esm/components/QPropertyList/index.d.ts.map +1 -1
  169. package/esm/components/QRadioGroup/QRadioButton.d.ts.map +1 -1
  170. package/esm/components/QRadioGroup/QRadioButton.vue.js +1 -1
  171. package/esm/components/QRadioGroup/QRadioGroup.d.ts.map +1 -1
  172. package/esm/components/QRadioGroup/QRadioGroup.vue.js +53 -41
  173. package/esm/components/QRemoveScrollBar/utils/gap.d.ts.map +1 -1
  174. package/esm/components/QSection/QSection.d.ts.map +1 -1
  175. package/esm/components/QSection/QSection.vue.js +3 -2
  176. package/esm/components/QSection/types.d.ts +3 -4
  177. package/esm/components/QSection/types.d.ts.map +1 -1
  178. package/esm/components/QSelect/QSelect.d.ts +6 -0
  179. package/esm/components/QSelect/QSelect.d.ts.map +1 -1
  180. package/esm/components/QSelect/QSelect.vue.js +405 -355
  181. package/esm/components/QSelect/constants.d.ts +2 -0
  182. package/esm/components/QSelect/constants.d.ts.map +1 -1
  183. package/esm/components/QSelect/constants.js +3 -1
  184. package/esm/components/QSelect/index.d.ts +8 -0
  185. package/esm/components/QSelect/index.d.ts.map +1 -1
  186. package/esm/components/QSidebar/QSidebarItem.d.ts +1 -0
  187. package/esm/components/QSidebar/QSidebarItem.d.ts.map +1 -1
  188. package/esm/components/QSidebar/QSidebarItem.vue.js +3 -0
  189. package/esm/components/QSidebar/QSidebarPanel.d.ts.map +1 -1
  190. package/esm/components/QSidebar/QSidebarPanel.vue.js +93 -32
  191. package/esm/components/QSidebar/index.d.ts +3 -0
  192. package/esm/components/QSidebar/index.d.ts.map +1 -1
  193. package/esm/components/QSidebar/types.d.ts +20 -1
  194. package/esm/components/QSidebar/types.d.ts.map +1 -1
  195. package/esm/components/QSkeletonLoader/QSkeletonLoader.d.ts.map +1 -1
  196. package/esm/components/QSkeletonLoader/QSkeletonLoader.vue.js +16 -15
  197. package/esm/components/QSpinnerLoader/QSpinnerLoader.d.ts.map +1 -1
  198. package/esm/components/QSpinnerLoader/QSpinnerLoader.vue.js +11 -10
  199. package/esm/components/QSteps/QSteps.d.ts +3 -2
  200. package/esm/components/QSteps/QSteps.d.ts.map +1 -1
  201. package/esm/components/QSteps/QSteps.vue.js +171 -152
  202. package/esm/components/QSteps/QStepsNav.d.ts +7 -0
  203. package/esm/components/QSteps/QStepsNav.d.ts.map +1 -1
  204. package/esm/components/QSteps/QStepsNav.vue.js +29 -15
  205. package/esm/components/QSteps/constants.d.ts +4 -2
  206. package/esm/components/QSteps/constants.d.ts.map +1 -1
  207. package/esm/components/QSteps/constants.js +2 -0
  208. package/esm/components/QSwitch/QSwitch.d.ts +2 -0
  209. package/esm/components/QSwitch/QSwitch.d.ts.map +1 -1
  210. package/esm/components/QSwitch/QSwitch.vue.js +12 -2
  211. package/esm/components/QSwitch/index.d.ts +4 -0
  212. package/esm/components/QSwitch/index.d.ts.map +1 -1
  213. package/esm/components/QSwitch/types.d.ts +8 -0
  214. package/esm/components/QSwitch/types.d.ts.map +1 -1
  215. package/esm/components/QTabs/QTab.d.ts.map +1 -1
  216. package/esm/components/QTabs/QTab.vue.js +1 -0
  217. package/esm/components/QTextArea/QTextArea.d.ts.map +1 -1
  218. package/esm/components/QTextArea/QTextArea.vue.js +6 -2
  219. package/esm/components/QTextField/QTextField.d.ts +4 -0
  220. package/esm/components/QTextField/QTextField.d.ts.map +1 -1
  221. package/esm/components/QTextField/QTextField.vue.js +5 -3
  222. package/esm/components/QTextField/index.d.ts +2 -0
  223. package/esm/components/QTextField/index.d.ts.map +1 -1
  224. package/esm/components/QThemeProvider/QThemeProvider.d.ts.map +1 -1
  225. package/esm/components/QToast/QToast.d.ts +1 -0
  226. package/esm/components/QToast/QToast.d.ts.map +1 -1
  227. package/esm/components/QToast/QToast.vue.js +89 -85
  228. package/esm/components/QToast/index.d.ts +6 -0
  229. package/esm/components/QToast/index.d.ts.map +1 -1
  230. package/esm/components/QToast/types.d.ts +8 -0
  231. package/esm/components/QToast/types.d.ts.map +1 -1
  232. package/esm/components/QTooltip/QTooltip.d.ts.map +1 -1
  233. package/esm/components/QTooltip/QTooltip.vue.js +19 -11
  234. package/esm/components/__internal__/QClearButton/QClearButton.d.ts.map +1 -1
  235. package/esm/components/__internal__/QHelpPopover/QHelpPopover.d.ts.map +1 -1
  236. package/esm/index.d.ts.map +1 -1
  237. package/esm/utils/focus.d.ts +10 -0
  238. package/esm/utils/focus.d.ts.map +1 -1
  239. package/esm/utils/focus.js +5 -2
  240. package/esm/utils/loader.d.ts +19 -0
  241. package/esm/utils/loader.d.ts.map +1 -0
  242. package/esm/utils/loader.js +6 -0
  243. package/package.json +24 -23
  244. package/dist/ui.js +0 -1846
  245. package/dist/ui.min.js +0 -1846
package/CHANGELOG.md CHANGED
@@ -7,6 +7,65 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  Entries below start at **0.16.0**. There's a section for every release (major, minor, and patch), including public API breaks with migration steps plus notable Added/Changed/Fixed entries. This file also ships in the npm package.
9
9
 
10
+ ## [0.30.0] - 2026-10-28
11
+
12
+ ### Added
13
+
14
+ - `headingLevel` on `QCollapsible` (default 4), `QAccordionItem`, `QAccordion` (passed to its sections; a section's own value wins), `QToast` (default 4), `QSidebarItem` (default 3), and `QCarousel` (default 2). A value outside 1–6 renders a `div`. The defaults keep the previous levels
15
+ - `QCard` `headingLevel` — no default: unset, the title stays a `p`; 1–6 renders `h1`–`h6`. A clickable card (`role="button"`) keeps a `p` at any level
16
+ - `invalid` on `QCheckbox`, `QSwitch`, and `QColorPicker`. The control gets `aria-invalid`; `QCheckbox` shows a danger border and `QSwitch` a danger ring
17
+ - `QBadgeIndicator` `ariaLabel` — visually hidden text for the dot, which otherwise shows its meaning in color only
18
+ - `QSidebar` — the resize handle is a focusable `separator` named after its panel. The arrow keys resize the panel by 16px, Home and End take it to its limits, and each key emits `resize:start`, `resize`, and `resize:end`
19
+ - `--q-target-size-min` token — 24px at regular and loose density, `0px` at compact. Field affix buttons (clear and the others) are at least that size, never taller than the field
20
+ - `QSpinnerLoader`, `QLineLoader`, and `QSkeletonLoader` named with `aria-label` or `aria-labelledby` become an indeterminate `progressbar`
21
+
22
+ ### Changed
23
+
24
+ - **Breaking:** `QFileUpload` `texts` gains `required` ("required") and `invalid` ("invalid entry"), which screen readers read on the choose, download, and remove buttons. `texts` is all-or-nothing, so apps that pass their own `texts` (or set them in `createFramework` defaults) must add both keys: `{ ...myTexts, required: 'obrigatório', invalid: 'entrada inválida' }`
25
+ - **Breaking:** `QSelect` `texts` gains `loading` and `noData`, `QCombobox` `texts` gains `loading`, and `QPhoneField` gets both through `QSelect`. Apps that pass their own `texts` must add them. A status region announces them while the open list is loading or empty
26
+ - **Breaking:** `QPhoneField` — the `noCountries` key is removed; set `noData` instead (`{ ...myTexts, noData: 'Nenhum país encontrado' }`). `.q-phone-field__empty` is removed too: the text is in `.q-select__loader`, in the regular text color instead of `neutral-dark`
27
+ - **Breaking:** `QSelect` shows "No data available" in an open list with no items. Apps that show their own empty text through the `body.prepend` or `body.append` slots now show both: remove it and set `noData` instead
28
+ - **Breaking:** `QSelect` and `QCombobox` set `aria-expanded="false"` while the open popup shows no list (loading, or no options). Tests that read `aria-expanded` to tell whether the popup is open must check `v-model:open` or the popup instead
29
+ - **Breaking:** `QDropdownMenu` (and the collapsed-crumbs menu of `QBreadcrumbs`) is a `menu` of `menuitem`s, not a `listbox` of `option`s. Change test queries such as `findByRole('option', { name: 'Export' })` to `findByRole('menuitem', { name: 'Export' })`. Escape in a submenu closes only that submenu, so tests press it once per level. The menu sets the activator's `aria-haspopup`, `aria-expanded`, and `aria-controls`; apps that set them can drop them
30
+ - **Breaking:** `QCollapsible` (and `QAccordionItem`) — the title is no longer an `h4` inside the button. `.q-collapsible__header` is the heading and holds the button; the title text is `span.q-collapsible__title-text`, and `.q-collapsible__title` and `.q-collapsible__subtitle` are `span`s. Replace selectors such as `.q-collapsible h4` with `.q-collapsible__title-text`, and `div.q-collapsible__subtitle` with `.q-collapsible__subtitle`
31
+ - **Breaking:** `QToast` — the title heading has the class `.q-toast__title-text`. Replace `.q-toast__title h4` with `.q-toast__title-text`
32
+ - `QDropdownMenu` keyboard follows the menu button pattern: ArrowLeft closes a submenu and does nothing at the top level, and Tab closes every level and moves on to what follows the activator
33
+ - `QDateTimePicker` — the days are a `grid` with one Tab stop, each named with its full date. The arrows move by a day or a week, Home and End to the start and end of the week, Page Up and Page Down by a month (with Shift, a year). The day buttons sit in `.q-date-time-picker__week` rows (`display: contents`), so direct-child selectors such as `.q-date-time-picker__days > button` no longer match
34
+ - `QButton` keeps focus when it starts `loading`: it is `aria-busy` and `aria-disabled`, and becomes natively `disabled` only once focus leaves. `aria-disabled="true"` is styled like `disabled`
35
+ - Loaders are `aria-hidden` by default, since the control that shows them is the one marked busy
36
+ - Hover overlays (`QTooltip`, and `QOverlay` with `trigger="hover"`) stay open while the pointer is on them, and close 150ms after it leaves
37
+ - Popovers fit into the Tab order: Tab from the last control closes the popover and moves on to what follows the anchor, and Shift+Tab from the start closes it and returns to the anchor. An overlay closed because focus moved out of it leaves focus where it went
38
+ - `QSection` with `helpDisplay="tooltip"` makes its title a Tab stop, so keyboard users can open the tooltip
39
+ - `QDialog` sets `aria-modal="true"` while `focusWrap` is on (the default)
40
+ - `QCard` with a click handler and no `href` is a `role="button"` Tab stop that Enter and Space click
41
+ - `QMeter` is a `role="meter"` named by its label; a meter without one needs an `aria-label`
42
+ - `QSteps` — the scroll arrows are named "Scroll steps back" and "Scroll steps forward" by default. A Next or Previous button that turns unavailable while focused keeps focus as `aria-disabled`, and a click on it does nothing (the default Next on the last step does not emit `finish`)
43
+ - `QListItem` `selectOnTab` — only a forward Tab picks the focused option, and never one already picked
44
+ - Key handlers leave keys held with Alt, Ctrl, or Meta to the browser in `QList`, `QTab`, `QOverflow`, `QSelect`, `QCombobox`, `QPhoneField`, and read-only `QRadioButton`. Alt+ArrowDown still opens a closed `QSelect` or `QCombobox`
45
+ - `libphonenumber-js` and `country-flag-icons` are no longer installed with `@quidgest/ui` (they are still bundled). Apps that import either package themselves must declare it in their own `package.json`
46
+ - `QPhoneCountryCode` is declared in the library, with the same 245 region codes, instead of re-exporting `CountryCode` from `libphonenumber-js`
47
+
48
+ ### Removed
49
+
50
+ - **Breaking:** UMD bundles — `dist/ui.js` and `dist/ui.min.js` (global `QuidgestUI`) are no longer published, and `unpkg` / `jsdelivr` point to `dist/ui.esm.js`. Pages that load `@quidgest/ui` from a CDN with a `<script>` tag must switch to `<script type="module">` or an import map that maps `@quidgest/ui` to `dist/ui.esm.js` and `vue` to `vue.esm-browser.prod.js`. Imports through npm are unaffected
51
+
52
+ ### Fixed
53
+
54
+ - Fields expose their state: `QTextField`, `QTextArea`, and `QSelect` (and so `QPasswordField`, `QCombobox`, and `QDateTimePicker`) set `aria-invalid`; `QTextArea` shows `invalid`; the `QFileUpload` choose button is named by the field label and described by its help; `QPasswordField` links its unmet rules to the input; `QInputGroup` (and so `QPhoneField`) is a group named by the field label
55
+ - Choice controls expose their state: `QRadioGroup` is named by its label and sets `aria-required`, `aria-readonly`, and `aria-invalid`; `QSwitch` sets `aria-required` and `aria-readonly`; `QCheckbox` sets `aria-readonly`
56
+ - `QSelect` — sets `aria-required`, `aria-readonly`, `aria-disabled`, and `aria-busy`; the open list takes the select's name; Tab from the open list moves on to what follows the select, and Shift+Tab goes back without picking; the read-only "+N" counter is a button keyboard users can reach; typing, Backspace, and paste no longer change the shown text; a press outside emits `before-hide`. In `QPhoneField`, Tab from the country list reaches the number
57
+ - `QCombobox` — `aria-controls` points at the list; `aria-activedescendant` points at an option on the page while typing; any character or a paste opens the list; Home and End move the caret while the list is closed; a press outside emits `before-hide` and resets the highlight
58
+ - `QList` — option descriptions are read through `aria-describedby`, and one Shift+Tab leaves the list
59
+ - `QTooltip` adds its id to the anchor's `aria-describedby` instead of replacing it, so help descriptions stay
60
+ - Focus no longer drops to the page when a control leaves or turns disabled in `QTextField` (clear), `QFileUpload`, `QObfuscation`, `QSteps`, `QOverflow`, and `QDateTimePicker`
61
+ - `QObfuscation` — with `v-model:revealed`, `reveal` and `hide` are no longer swapped; in the fetch-on-reveal flow, focus moves to the hide button once the value shows
62
+ - `QCard` sets `aria-busy` while `loading`; `QProgress` announces a drop of any size
63
+ - `QDateTimePicker` — Tab from the menu's last stop goes to what follows the field; a time-only format sizes the menu to its content
64
+ - `QPropertyList` is no longer an extra Tab stop before its first field
65
+ - `QIconImg` renders `alt=""`, and `QIconFont` is `aria-hidden`
66
+ - `QBadge` — icons keep their size while the SVG bundle loads, and image icons keep their aspect ratio
67
+ - `QCarousel` prop types resolve in consumer apps (they were `any`)
68
+
10
69
  ## [0.29.0] - 2026-10-19
11
70
 
12
71
  ### Added
package/README.md CHANGED
@@ -87,24 +87,6 @@ api.utils // utils submodules re-exported from `src/utils/index.ts`
87
87
 
88
88
  The selective barrels are the allowlist: only what those entry files re-export appears under `composables` and `utils`. The file is produced by `pnpm build:api` (also run before Storybook and in the package publish pipeline). Component Storybook docs remain the primary human reference for props; use this export for tooling (codegen, Genio, audits) or the Storybook **API/** pages for composables and utils.
89
89
 
90
- ## Development
90
+ ## Documentation
91
91
 
92
- The package utilizes Storybook for component development and organization. You can view the components locally in the Storybook documentation explorer.
93
-
94
- Execute the following command to run Storybook:
95
-
96
- ```cli
97
- npm run storybook
98
- ```
99
-
100
- (You might need to execute `pnpm install` beforehand if you haven't done so.)
101
-
102
- By default, Storybook will be running at `http://localhost:6006/`.
103
-
104
- ## Running Unit Tests
105
-
106
- It's important to run unit tests during development to ensure code quality and correctness. Execute the following command to run the unit tests:
107
-
108
- ```cli
109
- npm run test
110
- ```
92
+ Components, props and examples are in the Storybook at [ui.quidgest.pt](https://ui.quidgest.pt/). Try the library in the browser at [ui-playground.quidgest.pt](https://ui-playground.quidgest.pt/).