@quidgest/ui 0.31.2 → 0.32.1

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 (507) hide show
  1. package/CHANGELOG.md +63 -0
  2. package/dist/json/api.json +1278 -324
  3. package/dist/manifest/components.json +1 -0
  4. package/dist/ui.css +1183 -428
  5. package/dist/ui.esm.js +1640 -1393
  6. package/dist/ui.min.css +1 -1
  7. package/dist/ui.scss +1354 -386
  8. package/lib/components/QAccordion/QAccordion.d.ts +1 -1
  9. package/lib/components/QAccordion/QAccordion.d.ts.map +1 -1
  10. package/lib/components/QAccordion/QAccordionItem.d.ts.map +1 -1
  11. package/lib/components/QAccordion/QAccordionItem.vue.js +5 -5
  12. package/lib/components/QAccordion/index.d.ts +6 -6
  13. package/lib/components/QAccordion/types.d.ts +2 -2
  14. package/lib/components/QAccordion/types.d.ts.map +1 -1
  15. package/lib/components/QAlert/QAlert.d.ts +1 -1
  16. package/lib/components/QAlert/QAlert.d.ts.map +1 -1
  17. package/lib/components/QAlert/QAlert.vue.js +87 -73
  18. package/lib/components/QAlert/index.d.ts +3 -3
  19. package/lib/components/QAlert/types.d.ts +32 -2
  20. package/lib/components/QAlert/types.d.ts.map +1 -1
  21. package/lib/components/QAvatar/QAvatar.d.ts +1 -1
  22. package/lib/components/QAvatar/index.d.ts +3 -3
  23. package/lib/components/QBadge/QBadge.d.ts +1 -1
  24. package/lib/components/QBadge/QBadge.d.ts.map +1 -1
  25. package/lib/components/QBadge/QBadge.vue.js +72 -55
  26. package/lib/components/QBadge/index.d.ts +3 -3
  27. package/lib/components/QBadge/types.d.ts +13 -2
  28. package/lib/components/QBadge/types.d.ts.map +1 -1
  29. package/lib/components/QBadgeIndicator/QBadgeIndicator.vue.js +2 -3
  30. package/lib/components/QBreadcrumbs/QBreadcrumb.d.ts +6 -6
  31. package/lib/components/QBreadcrumbs/QBreadcrumb.vue.js +3 -3
  32. package/lib/components/QBreadcrumbs/QBreadcrumbs.d.ts +1 -1
  33. package/lib/components/QBreadcrumbs/QBreadcrumbs.d.ts.map +1 -1
  34. package/lib/components/QBreadcrumbs/QBreadcrumbs.vue.js +31 -31
  35. package/lib/components/QBreadcrumbs/context.d.ts +2 -1
  36. package/lib/components/QBreadcrumbs/context.d.ts.map +1 -1
  37. package/lib/components/QBreadcrumbs/index.d.ts +9 -9
  38. package/lib/components/QBreadcrumbs/types.d.ts +2 -2
  39. package/lib/components/QBreadcrumbs/types.d.ts.map +1 -1
  40. package/lib/components/QButton/QButton.d.ts +2 -2
  41. package/lib/components/QButton/QButton.d.ts.map +1 -1
  42. package/lib/components/QButton/QButton.vue.js +53 -49
  43. package/lib/components/QButton/index.d.ts +6 -6
  44. package/lib/components/QButton/types.d.ts +2 -2
  45. package/lib/components/QButton/types.d.ts.map +1 -1
  46. package/lib/components/QCard/QCard.vue.js +9 -20
  47. package/lib/components/QCarousel/QCarousel.d.ts +4 -4
  48. package/lib/components/QCarousel/QCarousel.d.ts.map +1 -1
  49. package/lib/components/QCarousel/QCarousel.vue.js +10 -16
  50. package/lib/components/QCarousel/index.d.ts +14 -14
  51. package/lib/components/QCarousel/types.d.ts +2 -2
  52. package/lib/components/QCarousel/types.d.ts.map +1 -1
  53. package/lib/components/QCheckbox/QCheckbox.d.ts +3 -22
  54. package/lib/components/QCheckbox/QCheckbox.d.ts.map +1 -1
  55. package/lib/components/QCheckbox/QCheckbox.vue.js +98 -100
  56. package/lib/components/QCheckbox/constants.d.ts +9 -0
  57. package/lib/components/QCheckbox/constants.d.ts.map +1 -1
  58. package/lib/components/QCheckbox/constants.js +4 -4
  59. package/lib/components/QCheckbox/index.d.ts +10 -72
  60. package/lib/components/QCheckbox/index.d.ts.map +1 -1
  61. package/lib/components/QCheckbox/types.d.ts +2 -8
  62. package/lib/components/QCheckbox/types.d.ts.map +1 -1
  63. package/lib/components/QCollapsible/QCollapsible.d.ts +1 -1
  64. package/lib/components/QCollapsible/QCollapsible.d.ts.map +1 -1
  65. package/lib/components/QCollapsible/QCollapsible.vue.js +20 -27
  66. package/lib/components/QCollapsible/index.d.ts +6 -6
  67. package/lib/components/QCollapsible/types.d.ts +2 -2
  68. package/lib/components/QCollapsible/types.d.ts.map +1 -1
  69. package/lib/components/QColorPicker/QColorPicker.d.ts +4 -18
  70. package/lib/components/QColorPicker/QColorPicker.d.ts.map +1 -1
  71. package/lib/components/QColorPicker/QColorPicker.vue.js +52 -35
  72. package/lib/components/QColorPicker/constants.d.ts +4 -0
  73. package/lib/components/QColorPicker/constants.d.ts.map +1 -1
  74. package/lib/components/QColorPicker/index.d.ts +13 -57
  75. package/lib/components/QColorPicker/index.d.ts.map +1 -1
  76. package/lib/components/QColorPicker/types.d.ts +2 -2
  77. package/lib/components/QColorPicker/types.d.ts.map +1 -1
  78. package/lib/components/QCombobox/QCombobox.d.ts +355 -299
  79. package/lib/components/QCombobox/QCombobox.d.ts.map +1 -1
  80. package/lib/components/QCombobox/QCombobox.vue.js +236 -190
  81. package/lib/components/QCombobox/constants.d.ts +5 -0
  82. package/lib/components/QCombobox/constants.d.ts.map +1 -1
  83. package/lib/components/QCombobox/constants.js +1 -0
  84. package/lib/components/QCombobox/index.d.ts +265 -424
  85. package/lib/components/QCombobox/index.d.ts.map +1 -1
  86. package/lib/components/QCombobox/types.d.ts +2 -2
  87. package/lib/components/QCombobox/types.d.ts.map +1 -1
  88. package/lib/components/QDateTimePicker/QDateTimePicker.d.ts +106 -229
  89. package/lib/components/QDateTimePicker/QDateTimePicker.d.ts.map +1 -1
  90. package/lib/components/QDateTimePicker/QDateTimePicker.vue.js +894 -765
  91. package/lib/components/QDateTimePicker/constants.d.ts +6 -1
  92. package/lib/components/QDateTimePicker/constants.d.ts.map +1 -1
  93. package/lib/components/QDateTimePicker/constants.js +2 -1
  94. package/lib/components/QDateTimePicker/index.d.ts +73 -229
  95. package/lib/components/QDateTimePicker/index.d.ts.map +1 -1
  96. package/lib/components/QDateTimePicker/types.d.ts +2 -1
  97. package/lib/components/QDateTimePicker/types.d.ts.map +1 -1
  98. package/lib/components/QDefaultsProvider/QDefaultsProvider.vue.js +4 -2
  99. package/lib/components/QDefaultsProvider/types.d.ts +10 -0
  100. package/lib/components/QDefaultsProvider/types.d.ts.map +1 -1
  101. package/lib/components/QDialog/QDialog.d.ts +22 -10
  102. package/lib/components/QDialog/QDialog.d.ts.map +1 -1
  103. package/lib/components/QDialog/QDialog.vue.js +143 -108
  104. package/lib/components/QDialog/QDialogProvider.d.ts.map +1 -1
  105. package/lib/components/QDialog/QDialogProvider.vue.js +8 -3
  106. package/lib/components/QDialog/constants.d.ts +19 -1
  107. package/lib/components/QDialog/constants.d.ts.map +1 -1
  108. package/lib/components/QDialog/constants.js +16 -11
  109. package/lib/components/QDialog/index.d.ts +39 -23
  110. package/lib/components/QDialog/index.d.ts.map +1 -1
  111. package/lib/components/QDialog/types.d.ts +24 -13
  112. package/lib/components/QDialog/types.d.ts.map +1 -1
  113. package/lib/components/QDivider/QDivider.d.ts.map +1 -1
  114. package/lib/components/QDivider/QDivider.vue.js +23 -13
  115. package/lib/components/QDivider/types.d.ts +9 -0
  116. package/lib/components/QDivider/types.d.ts.map +1 -1
  117. package/lib/components/QDrawer/QDrawer.d.ts +71 -0
  118. package/lib/components/QDrawer/QDrawer.d.ts.map +1 -0
  119. package/lib/components/QDrawer/QDrawer.vue.js +461 -0
  120. package/lib/components/QDrawer/QDrawer2.vue.js +5 -0
  121. package/lib/components/QDrawer/constants.d.ts +22 -0
  122. package/lib/components/QDrawer/constants.d.ts.map +1 -0
  123. package/lib/components/QDrawer/constants.js +14 -0
  124. package/lib/components/QDrawer/index.d.ts +214 -0
  125. package/lib/components/QDrawer/index.d.ts.map +1 -0
  126. package/lib/components/QDrawer/index.js +6 -0
  127. package/lib/components/QDrawer/types.d.ts +221 -0
  128. package/lib/components/QDrawer/types.d.ts.map +1 -0
  129. package/lib/components/QDropdownMenu/QDropdownMenu.d.ts +1 -1
  130. package/lib/components/QDropdownMenu/QDropdownMenu.d.ts.map +1 -1
  131. package/lib/components/QDropdownMenu/QDropdownMenu.vue.js +59 -52
  132. package/lib/components/QDropdownMenu/QDropdownMenuContent.d.ts +118 -42
  133. package/lib/components/QDropdownMenu/QDropdownMenuContent.d.ts.map +1 -1
  134. package/lib/components/QDropdownMenu/QDropdownMenuContent.vue.js +235 -195
  135. package/lib/components/QDropdownMenu/ids.d.ts +6 -0
  136. package/lib/components/QDropdownMenu/ids.d.ts.map +1 -1
  137. package/lib/components/QDropdownMenu/ids.js +4 -1
  138. package/lib/components/QDropdownMenu/index.d.ts +6 -6
  139. package/lib/components/QDropdownMenu/types.d.ts +6 -4
  140. package/lib/components/QDropdownMenu/types.d.ts.map +1 -1
  141. package/lib/components/QField/QField.d.ts +18 -17
  142. package/lib/components/QField/QField.d.ts.map +1 -1
  143. package/lib/components/QField/QField.vue.js +65 -50
  144. package/lib/components/QField/constants.d.ts +10 -3
  145. package/lib/components/QField/constants.d.ts.map +1 -1
  146. package/lib/components/QField/constants.js +4 -2
  147. package/lib/components/QField/index.d.ts +12 -11
  148. package/lib/components/QField/index.d.ts.map +1 -1
  149. package/lib/components/QField/types.d.ts +10 -9
  150. package/lib/components/QField/types.d.ts.map +1 -1
  151. package/lib/components/QFileUpload/QFileUpload.d.ts +28 -54
  152. package/lib/components/QFileUpload/QFileUpload.d.ts.map +1 -1
  153. package/lib/components/QFileUpload/QFileUpload.vue.js +43 -39
  154. package/lib/components/QFileUpload/constants.d.ts +4 -0
  155. package/lib/components/QFileUpload/constants.d.ts.map +1 -1
  156. package/lib/components/QFileUpload/index.d.ts +25 -105
  157. package/lib/components/QFileUpload/index.d.ts.map +1 -1
  158. package/lib/components/QFileUpload/types.d.ts +2 -1
  159. package/lib/components/QFileUpload/types.d.ts.map +1 -1
  160. package/lib/components/QFocusWrap/QFocusWrap.d.ts +1 -0
  161. package/lib/components/QFocusWrap/QFocusWrap.d.ts.map +1 -1
  162. package/lib/components/QFocusWrap/QFocusWrap.vue.js +60 -41
  163. package/lib/components/QFocusWrap/index.d.ts +3 -0
  164. package/lib/components/QFocusWrap/index.d.ts.map +1 -1
  165. package/lib/components/QFocusWrap/stack.d.ts +15 -0
  166. package/lib/components/QFocusWrap/stack.d.ts.map +1 -0
  167. package/lib/components/QFocusWrap/stack.js +11 -0
  168. package/lib/components/QFocusWrap/types.d.ts +8 -0
  169. package/lib/components/QFocusWrap/types.d.ts.map +1 -1
  170. package/lib/components/QGauge/QGauge.d.ts.map +1 -1
  171. package/lib/components/QGauge/QGauge.vue.js +153 -124
  172. package/lib/components/QGauge/types.d.ts +16 -1
  173. package/lib/components/QGauge/types.d.ts.map +1 -1
  174. package/lib/components/QGrid/QRow.d.ts +1 -1
  175. package/lib/components/QGrid/index.d.ts +3 -3
  176. package/lib/components/QIcon/QSvgSymbol.d.ts +1 -1
  177. package/lib/components/QIcon/QSvgSymbol.d.ts.map +1 -1
  178. package/lib/components/QIcon/QSvgSymbol.vue.js +31 -31
  179. package/lib/components/QIcon/utils/svgSource.d.ts +2 -2
  180. package/lib/components/QIcon/utils/svgSource.d.ts.map +1 -1
  181. package/lib/components/QInputGroup/QInputGroup.d.ts +35 -31
  182. package/lib/components/QInputGroup/QInputGroup.d.ts.map +1 -1
  183. package/lib/components/QInputGroup/QInputGroup.vue.js +96 -49
  184. package/lib/components/QInputGroup/index.d.ts +14 -12
  185. package/lib/components/QInputGroup/index.d.ts.map +1 -1
  186. package/lib/components/QLabel/QLabel.d.ts.map +1 -1
  187. package/lib/components/QLabel/QLabel.vue.js +2 -2
  188. package/lib/components/QList/QList.d.ts +46 -17
  189. package/lib/components/QList/QList.d.ts.map +1 -1
  190. package/lib/components/QList/QList.vue.js +470 -195
  191. package/lib/components/QList/QListItem.d.ts +1 -1
  192. package/lib/components/QList/QListItem.d.ts.map +1 -1
  193. package/lib/components/QList/QListItem.vue.js +51 -43
  194. package/lib/components/QList/QListItemGroup.vue.js +1 -1
  195. package/lib/components/QList/constants.d.ts +26 -0
  196. package/lib/components/QList/constants.d.ts.map +1 -1
  197. package/lib/components/QList/context.d.ts +12 -1
  198. package/lib/components/QList/context.d.ts.map +1 -1
  199. package/lib/components/QList/context.js +2 -2
  200. package/lib/components/QList/index.d.ts +79 -22
  201. package/lib/components/QList/index.d.ts.map +1 -1
  202. package/lib/components/QList/types.d.ts +11 -9
  203. package/lib/components/QList/types.d.ts.map +1 -1
  204. package/lib/components/QMeter/QMeter.d.ts.map +1 -1
  205. package/lib/components/QMeter/QMeter.vue.js +27 -26
  206. package/lib/components/QMeter/types.d.ts +3 -0
  207. package/lib/components/QMeter/types.d.ts.map +1 -1
  208. package/lib/components/QObfuscation/QObfuscation.d.ts +8 -26
  209. package/lib/components/QObfuscation/QObfuscation.d.ts.map +1 -1
  210. package/lib/components/QObfuscation/QObfuscation.vue.js +137 -113
  211. package/lib/components/QObfuscation/constants.d.ts +4 -0
  212. package/lib/components/QObfuscation/constants.d.ts.map +1 -1
  213. package/lib/components/QObfuscation/index.d.ts +26 -81
  214. package/lib/components/QObfuscation/index.d.ts.map +1 -1
  215. package/lib/components/QObfuscation/types.d.ts +10 -1
  216. package/lib/components/QObfuscation/types.d.ts.map +1 -1
  217. package/lib/components/QOverflow/QOverflow.d.ts +7 -3
  218. package/lib/components/QOverflow/QOverflow.d.ts.map +1 -1
  219. package/lib/components/QOverflow/QOverflow.vue.js +131 -108
  220. package/lib/components/QOverflow/constants.d.ts +4 -1
  221. package/lib/components/QOverflow/constants.d.ts.map +1 -1
  222. package/lib/components/QOverflow/index.d.ts +3 -3
  223. package/lib/components/QOverflow/types.d.ts +7 -4
  224. package/lib/components/QOverflow/types.d.ts.map +1 -1
  225. package/lib/components/QOverlay/QOverlay.d.ts +14 -5
  226. package/lib/components/QOverlay/QOverlay.d.ts.map +1 -1
  227. package/lib/components/QOverlay/QOverlay.vue.js +194 -166
  228. package/lib/components/QOverlay/index.d.ts +105 -13
  229. package/lib/components/QOverlay/index.d.ts.map +1 -1
  230. package/lib/components/QOverlay/layers.d.ts +21 -0
  231. package/lib/components/QOverlay/layers.d.ts.map +1 -0
  232. package/lib/components/QOverlay/layers.js +11 -0
  233. package/lib/components/QOverlay/types.d.ts +0 -6
  234. package/lib/components/QOverlay/types.d.ts.map +1 -1
  235. package/lib/components/QPasswordField/QPasswordField.d.ts +52 -170
  236. package/lib/components/QPasswordField/QPasswordField.d.ts.map +1 -1
  237. package/lib/components/QPasswordField/QPasswordField.vue.js +8 -3
  238. package/lib/components/QPasswordField/QPasswordFieldMeterOverlay.vue.js +2 -3
  239. package/lib/components/QPasswordField/constants.d.ts +4 -0
  240. package/lib/components/QPasswordField/constants.d.ts.map +1 -1
  241. package/lib/components/QPasswordField/index.d.ts +29 -170
  242. package/lib/components/QPasswordField/index.d.ts.map +1 -1
  243. package/lib/components/QPasswordField/types.d.ts +2 -1
  244. package/lib/components/QPasswordField/types.d.ts.map +1 -1
  245. package/lib/components/QPhoneField/QPhoneField.d.ts +491 -622
  246. package/lib/components/QPhoneField/QPhoneField.d.ts.map +1 -1
  247. package/lib/components/QPhoneField/QPhoneField.vue.js +21 -14
  248. package/lib/components/QPhoneField/constants.d.ts +4 -0
  249. package/lib/components/QPhoneField/constants.d.ts.map +1 -1
  250. package/lib/components/QPhoneField/index.d.ts +260 -393
  251. package/lib/components/QPhoneField/index.d.ts.map +1 -1
  252. package/lib/components/QPhoneField/types.d.ts +5 -2
  253. package/lib/components/QPhoneField/types.d.ts.map +1 -1
  254. package/lib/components/QPopover/QPopover.d.ts +1 -1
  255. package/lib/components/QPopover/QPopover.d.ts.map +1 -1
  256. package/lib/components/QPopover/QPopover.vue.js +64 -42
  257. package/lib/components/QPopover/index.d.ts +3 -3
  258. package/lib/components/QPopover/types.d.ts +7 -2
  259. package/lib/components/QPopover/types.d.ts.map +1 -1
  260. package/lib/components/QProgress/QProgress.d.ts.map +1 -1
  261. package/lib/components/QProgress/QProgress.vue.js +66 -46
  262. package/lib/components/QProgress/types.d.ts +3 -0
  263. package/lib/components/QProgress/types.d.ts.map +1 -1
  264. package/lib/components/QPropertyList/QPropertyList.d.ts +1 -1
  265. package/lib/components/QPropertyList/QPropertyList.d.ts.map +1 -1
  266. package/lib/components/QPropertyList/QPropertyList.vue.js +3 -3
  267. package/lib/components/QPropertyList/QPropertyListGroup.d.ts +1 -1
  268. package/lib/components/QPropertyList/QPropertyListGroup.d.ts.map +1 -1
  269. package/lib/components/QPropertyList/QPropertyListRow.d.ts +1 -1
  270. package/lib/components/QPropertyList/QPropertyListRow.d.ts.map +1 -1
  271. package/lib/components/QPropertyList/QPropertyListRow.vue.js +59 -44
  272. package/lib/components/QPropertyList/index.d.ts +8 -8
  273. package/lib/components/QPropertyList/index.d.ts.map +1 -1
  274. package/lib/components/QPropertyList/types.d.ts +3 -3
  275. package/lib/components/QPropertyList/types.d.ts.map +1 -1
  276. package/lib/components/QRadioGroup/QRadioButton.d.ts.map +1 -1
  277. package/lib/components/QRadioGroup/QRadioButton.vue.js +5 -2
  278. package/lib/components/QRadioGroup/QRadioGroup.d.ts +2 -2
  279. package/lib/components/QRadioGroup/QRadioGroup.d.ts.map +1 -1
  280. package/lib/components/QRadioGroup/QRadioGroup.vue.js +19 -18
  281. package/lib/components/QRadioGroup/index.d.ts +4 -9
  282. package/lib/components/QRadioGroup/index.d.ts.map +1 -1
  283. package/lib/components/QRadioGroup/types.d.ts +0 -6
  284. package/lib/components/QRadioGroup/types.d.ts.map +1 -1
  285. package/lib/components/QSection/QSection.d.ts +3 -3
  286. package/lib/components/QSection/QSection.d.ts.map +1 -1
  287. package/lib/components/QSection/QSection.vue.js +52 -45
  288. package/lib/components/QSection/index.d.ts +4 -4
  289. package/lib/components/QSection/types.d.ts +10 -2
  290. package/lib/components/QSection/types.d.ts.map +1 -1
  291. package/lib/components/QSelect/QSelect.d.ts +312 -114
  292. package/lib/components/QSelect/QSelect.d.ts.map +1 -1
  293. package/lib/components/QSelect/QSelect.vue.js +274 -250
  294. package/lib/components/QSelect/constants.d.ts +4 -0
  295. package/lib/components/QSelect/constants.d.ts.map +1 -1
  296. package/lib/components/QSelect/index.d.ts +176 -144
  297. package/lib/components/QSelect/index.d.ts.map +1 -1
  298. package/lib/components/QSelect/types.d.ts +4 -2
  299. package/lib/components/QSelect/types.d.ts.map +1 -1
  300. package/lib/components/QSidebar/QSidebar.d.ts +9 -9
  301. package/lib/components/QSidebar/QSidebar.d.ts.map +1 -1
  302. package/lib/components/QSidebar/QSidebar.vue.js +2 -2
  303. package/lib/components/QSidebar/QSidebarAnchor.d.ts +1 -1
  304. package/lib/components/QSidebar/QSidebarAnchor.d.ts.map +1 -1
  305. package/lib/components/QSidebar/QSidebarAnchor.vue.js +4 -4
  306. package/lib/components/QSidebar/QSidebarItem.d.ts +7 -7
  307. package/lib/components/QSidebar/QSidebarItem.vue.js +3 -3
  308. package/lib/components/QSidebar/QSidebarPanel.d.ts +3 -3
  309. package/lib/components/QSidebar/QSidebarPanel.d.ts.map +1 -1
  310. package/lib/components/QSidebar/QSidebarPanel.vue.js +81 -140
  311. package/lib/components/QSidebar/constants.d.ts.map +1 -1
  312. package/lib/components/QSidebar/constants.js +4 -5
  313. package/lib/components/QSidebar/index.d.ts +24 -24
  314. package/lib/components/QSidebar/types.d.ts +7 -6
  315. package/lib/components/QSidebar/types.d.ts.map +1 -1
  316. package/lib/components/QSteps/QStepHeader.d.ts +2 -1
  317. package/lib/components/QSteps/QStepHeader.d.ts.map +1 -1
  318. package/lib/components/QSteps/QStepHeader.vue.js +3 -4
  319. package/lib/components/QSteps/QSteps.d.ts +8 -8
  320. package/lib/components/QSteps/QSteps.d.ts.map +1 -1
  321. package/lib/components/QSteps/QSteps.vue.js +9 -6
  322. package/lib/components/QSteps/QStepsNav.d.ts +2 -1
  323. package/lib/components/QSteps/QStepsNav.d.ts.map +1 -1
  324. package/lib/components/QSteps/index.d.ts +12 -12
  325. package/lib/components/QSteps/types.d.ts +2 -2
  326. package/lib/components/QSteps/types.d.ts.map +1 -1
  327. package/lib/components/QSwitch/QSwitch.d.ts +39 -26
  328. package/lib/components/QSwitch/QSwitch.d.ts.map +1 -1
  329. package/lib/components/QSwitch/QSwitch.vue.js +64 -58
  330. package/lib/components/QSwitch/constants.d.ts +20 -0
  331. package/lib/components/QSwitch/constants.d.ts.map +1 -0
  332. package/lib/components/QSwitch/constants.js +9 -0
  333. package/lib/components/QSwitch/index.d.ts +56 -18
  334. package/lib/components/QSwitch/index.d.ts.map +1 -1
  335. package/lib/components/QSwitch/types.d.ts +21 -3
  336. package/lib/components/QSwitch/types.d.ts.map +1 -1
  337. package/lib/components/QTabs/QTab.d.ts +12 -12
  338. package/lib/components/QTabs/QTab.vue.js +3 -3
  339. package/lib/components/QTabs/QTabs.d.ts +9 -9
  340. package/lib/components/QTabs/QTabs.d.ts.map +1 -1
  341. package/lib/components/QTabs/QTabs.vue.js +92 -80
  342. package/lib/components/QTabs/index.d.ts +16 -16
  343. package/lib/components/QTabs/types.d.ts +2 -2
  344. package/lib/components/QTabs/types.d.ts.map +1 -1
  345. package/lib/components/QTextArea/QTextArea.d.ts +1 -0
  346. package/lib/components/QTextArea/QTextArea.d.ts.map +1 -1
  347. package/lib/components/QTextArea/QTextArea.vue.js +6 -1
  348. package/lib/components/QTextArea/index.d.ts +1 -0
  349. package/lib/components/QTextArea/index.d.ts.map +1 -1
  350. package/lib/components/QTextField/QTextField.d.ts +30 -42
  351. package/lib/components/QTextField/QTextField.d.ts.map +1 -1
  352. package/lib/components/QTextField/QTextField.vue.js +7 -2
  353. package/lib/components/QTextField/constants.d.ts +4 -0
  354. package/lib/components/QTextField/constants.d.ts.map +1 -1
  355. package/lib/components/QTextField/index.d.ts +26 -69
  356. package/lib/components/QTextField/index.d.ts.map +1 -1
  357. package/lib/components/QTextField/types.d.ts +2 -1
  358. package/lib/components/QTextField/types.d.ts.map +1 -1
  359. package/lib/components/QToast/QToast.d.ts +1 -1
  360. package/lib/components/QToast/QToast.d.ts.map +1 -1
  361. package/lib/components/QToast/QToast.vue.js +148 -134
  362. package/lib/components/QToast/QToaster.d.ts +3 -1
  363. package/lib/components/QToast/QToaster.d.ts.map +1 -1
  364. package/lib/components/QToast/QToaster.vue.js +78 -47
  365. package/lib/components/QToast/index.d.ts +9 -7
  366. package/lib/components/QToast/index.d.ts.map +1 -1
  367. package/lib/components/QToast/types.d.ts +2 -2
  368. package/lib/components/QToast/types.d.ts.map +1 -1
  369. package/lib/components/QToggle/QToggle.d.ts.map +1 -1
  370. package/lib/components/QToggle/QToggle.vue.js +2 -0
  371. package/lib/components/QToggle/index.d.ts +3 -3
  372. package/lib/components/QToggleGroup/QToggleGroupItem.d.ts +8 -1
  373. package/lib/components/QToggleGroup/QToggleGroupItem.d.ts.map +1 -1
  374. package/lib/components/QToggleGroup/QToggleGroupItem.vue.js +67 -16
  375. package/lib/components/QToggleGroup/index.d.ts +24 -3
  376. package/lib/components/QToggleGroup/index.d.ts.map +1 -1
  377. package/lib/components/QTooltip/QTooltip.d.ts +1 -1
  378. package/lib/components/QTooltip/QTooltip.vue.js +1 -1
  379. package/lib/components/QTooltip/index.d.ts +3 -3
  380. package/lib/components/__internal__/QChevron/QChevron.d.ts +1 -1
  381. package/lib/components/__internal__/QChevron/QChevron.d.ts.map +1 -1
  382. package/lib/components/__internal__/QChevron/index.d.ts +3 -3
  383. package/lib/components/__internal__/QChevron/types.d.ts +2 -2
  384. package/lib/components/__internal__/QChevron/types.d.ts.map +1 -1
  385. package/lib/components/__internal__/QClearButton/QClearButton.d.ts +1 -1
  386. package/lib/components/__internal__/QClearButton/QClearButton.d.ts.map +1 -1
  387. package/lib/components/__internal__/QClearButton/index.d.ts +1 -1
  388. package/lib/components/__internal__/QClearButton/types.d.ts +2 -2
  389. package/lib/components/__internal__/QClearButton/types.d.ts.map +1 -1
  390. package/lib/components/__internal__/QHelpPopover/QHelpPopover.d.ts +7 -7
  391. package/lib/components/__internal__/QHelpPopover/QHelpPopover.d.ts.map +1 -1
  392. package/lib/components/__internal__/QHelpPopover/QHelpPopover.vue.js +3 -6
  393. package/lib/components/__internal__/QHelpPopover/index.d.ts +7 -7
  394. package/lib/components/__internal__/QHelpPopover/types.d.ts +2 -2
  395. package/lib/components/__internal__/QHelpPopover/types.d.ts.map +1 -1
  396. package/lib/components/__internal__/QListboxPanel/QListboxPanel.d.ts +34 -0
  397. package/lib/components/__internal__/QListboxPanel/QListboxPanel.d.ts.map +1 -0
  398. package/lib/components/__internal__/QListboxPanel/QListboxPanel.vue.js +76 -0
  399. package/lib/components/__internal__/QListboxPanel/QListboxPanel2.vue.js +5 -0
  400. package/lib/components/__internal__/QListboxPanel/constants.d.ts +17 -0
  401. package/lib/components/__internal__/QListboxPanel/constants.d.ts.map +1 -0
  402. package/lib/components/__internal__/QListboxPanel/constants.js +4 -0
  403. package/lib/components/__internal__/QListboxPanel/index.d.ts +52 -0
  404. package/lib/components/__internal__/QListboxPanel/index.d.ts.map +1 -0
  405. package/lib/components/__internal__/QListboxPanel/index.js +7 -0
  406. package/lib/components/__internal__/QListboxPanel/types.d.ts +50 -0
  407. package/lib/components/__internal__/QListboxPanel/types.d.ts.map +1 -0
  408. package/lib/components/__internal__/QListboxPanel/utils.d.ts +4 -0
  409. package/lib/components/__internal__/QListboxPanel/utils.d.ts.map +1 -0
  410. package/lib/components/__internal__/QListboxPanel/utils.js +6 -0
  411. package/lib/components/__internal__/QRequiredIndicator/QRequiredIndicator.vue.js +1 -1
  412. package/lib/components/__internal__/QResizeHandle/QResizeButtons.d.ts +16 -0
  413. package/lib/components/__internal__/QResizeHandle/QResizeButtons.d.ts.map +1 -0
  414. package/lib/components/__internal__/QResizeHandle/QResizeButtons.vue.js +72 -0
  415. package/lib/components/__internal__/QResizeHandle/QResizeButtons2.vue.js +5 -0
  416. package/lib/components/__internal__/QResizeHandle/QResizeHandle.d.ts +15 -0
  417. package/lib/components/__internal__/QResizeHandle/QResizeHandle.d.ts.map +1 -0
  418. package/lib/components/__internal__/QResizeHandle/QResizeHandle.vue.js +74 -0
  419. package/lib/components/__internal__/QResizeHandle/QResizeHandle2.vue.js +5 -0
  420. package/lib/components/__internal__/QResizeHandle/constants.d.ts +22 -0
  421. package/lib/components/__internal__/QResizeHandle/constants.d.ts.map +1 -0
  422. package/lib/components/__internal__/QResizeHandle/constants.js +10 -0
  423. package/lib/components/__internal__/QResizeHandle/index.d.ts +28 -0
  424. package/lib/components/__internal__/QResizeHandle/index.d.ts.map +1 -0
  425. package/lib/components/__internal__/QResizeHandle/index.js +7 -0
  426. package/lib/components/__internal__/QResizeHandle/types.d.ts +107 -0
  427. package/lib/components/__internal__/QResizeHandle/types.d.ts.map +1 -0
  428. package/lib/components/__internal__/QResizeHandle/useEdgeResize.d.ts +42 -0
  429. package/lib/components/__internal__/QResizeHandle/useEdgeResize.d.ts.map +1 -0
  430. package/lib/components/__internal__/QResizeHandle/useEdgeResize.js +36 -0
  431. package/lib/components/__internal__/QResizeHandle/useResizePane.d.ts +39 -0
  432. package/lib/components/__internal__/QResizeHandle/useResizePane.d.ts.map +1 -0
  433. package/lib/components/__internal__/QResizeHandle/useResizePane.js +22 -0
  434. package/lib/components/__internal__/QSafeTriangle/QSafeTriangle.d.ts +2 -2
  435. package/lib/components/__internal__/QSafeTriangle/QSafeTriangle.vue.js +1 -1
  436. package/lib/components/__internal__/QSafeTriangle/index.d.ts +2 -2
  437. package/lib/components/__internal__/QSeverityContent/QSeverityContent.d.ts +24 -0
  438. package/lib/components/__internal__/QSeverityContent/QSeverityContent.d.ts.map +1 -0
  439. package/lib/components/__internal__/QSeverityContent/QSeverityContent.vue.js +58 -0
  440. package/lib/components/__internal__/QSeverityContent/QSeverityContent2.vue.js +5 -0
  441. package/lib/components/__internal__/QSeverityContent/index.d.ts +31 -0
  442. package/lib/components/__internal__/QSeverityContent/index.d.ts.map +1 -0
  443. package/lib/components/__internal__/QSeverityContent/index.js +6 -0
  444. package/lib/components/__internal__/QSeverityContent/types.d.ts +67 -0
  445. package/lib/components/__internal__/QSeverityContent/types.d.ts.map +1 -0
  446. package/lib/components/index.d.ts +1 -0
  447. package/lib/components/index.d.ts.map +1 -1
  448. package/lib/components/index.js +72 -70
  449. package/lib/composables/defaults.d.ts +25 -1
  450. package/lib/composables/defaults.d.ts.map +1 -1
  451. package/lib/composables/defaults.js +15 -7
  452. package/lib/composables/useColor/index.d.ts +9 -3
  453. package/lib/composables/useColor/index.d.ts.map +1 -1
  454. package/lib/composables/useColor/index.js +50 -42
  455. package/lib/composables/useColor/types.d.ts +17 -4
  456. package/lib/composables/useColor/types.d.ts.map +1 -1
  457. package/lib/composables/useDialog/_internal.js +1 -1
  458. package/lib/composables/useDialog/types.d.ts +6 -2
  459. package/lib/composables/useDialog/types.d.ts.map +1 -1
  460. package/lib/composables/useScrollTabStop/index.d.ts +17 -0
  461. package/lib/composables/useScrollTabStop/index.d.ts.map +1 -0
  462. package/lib/composables/useScrollTabStop/index.js +45 -0
  463. package/lib/composables/useVirtualList/index.d.ts +73 -0
  464. package/lib/composables/useVirtualList/index.d.ts.map +1 -0
  465. package/lib/composables/useVirtualList/index.js +83 -0
  466. package/lib/index.d.ts +2 -1
  467. package/lib/index.d.ts.map +1 -1
  468. package/lib/types/component.d.ts +12 -5
  469. package/lib/types/component.d.ts.map +1 -1
  470. package/lib/types/index.d.ts +1 -1
  471. package/lib/types/index.d.ts.map +1 -1
  472. package/lib/utils/bidi.d.ts +27 -0
  473. package/lib/utils/bidi.d.ts.map +1 -0
  474. package/lib/utils/bidi.js +15 -0
  475. package/lib/utils/boundedValue.d.ts +20 -0
  476. package/lib/utils/boundedValue.d.ts.map +1 -0
  477. package/lib/utils/boundedValue.js +9 -0
  478. package/lib/utils/color/blend.d.ts +13 -0
  479. package/lib/utils/color/blend.d.ts.map +1 -1
  480. package/lib/utils/color/blend.js +6 -3
  481. package/lib/utils/color/contrast.d.ts +19 -0
  482. package/lib/utils/color/contrast.d.ts.map +1 -1
  483. package/lib/utils/color/contrast.js +26 -11
  484. package/lib/utils/color/index.d.ts +1 -1
  485. package/lib/utils/color/index.d.ts.map +1 -1
  486. package/lib/utils/date.d.ts +18 -8
  487. package/lib/utils/date.d.ts.map +1 -1
  488. package/lib/utils/date.js +26 -14
  489. package/lib/utils/index.js +14 -13
  490. package/lib/utils/overlay.d.ts +6 -0
  491. package/lib/utils/overlay.d.ts.map +1 -1
  492. package/lib/utils/overlay.js +10 -10
  493. package/lib/utils/popupLabel.d.ts +15 -0
  494. package/lib/utils/popupLabel.d.ts.map +1 -0
  495. package/lib/utils/popupLabel.js +6 -0
  496. package/lib/utils/railWidth.d.ts +15 -0
  497. package/lib/utils/railWidth.d.ts.map +1 -0
  498. package/lib/utils/railWidth.js +4 -0
  499. package/lib/utils/safeTriangle.d.ts +4 -4
  500. package/lib/utils/safeTriangle.d.ts.map +1 -1
  501. package/lib/utils/slots.d.ts +11 -2
  502. package/lib/utils/slots.d.ts.map +1 -1
  503. package/lib/utils/slots.js +7 -4
  504. package/lib/utils/theme.d.ts +3 -3
  505. package/lib/utils/theme.d.ts.map +1 -1
  506. package/lib/utils/theme.js +31 -31
  507. package/package.json +1 -1
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.31.2",
2
+ "version": "0.32.1",
3
3
  "components": [
4
4
  {
5
5
  "name": "QAccordion",
@@ -76,8 +76,8 @@
76
76
  {
77
77
  "name": "icons",
78
78
  "type": {
79
- "kind": "object",
80
- "fields": {}
79
+ "kind": "unknown",
80
+ "raw": "QIcons<\"chevron\"> | undefined"
81
81
  },
82
82
  "description": "Icons for the sections. They reach every section through the defaults cascade,\nunless a section sets its own `icons`.\nPass every key, or omit the prop to keep the defaults.",
83
83
  "default": "DEFAULT_ICONS",
@@ -178,7 +178,7 @@
178
178
  },
179
179
  {
180
180
  "name": "QAlert",
181
- "description": "Alerts show persistent feedback inside the page, such as a summary of form errors or a notice next to related content. They stay in the document flow until removed. For short-lived notifications that float over the page, use a toast instead. The colors `info`, `success`, `warning` and `danger` set a severity: a default icon, a prefix that screen readers announce before the message (for example \"Warning:\"), and the live region role. Warnings and errors use `role=\"alert\"`, which interrupts the user. Other alerts use `role=\"status\"`, which waits until the user is idle.",
181
+ "description": "Alerts show persistent feedback inside the page, such as a summary of form errors or a notice next to related content. They stay in the document flow until removed. For short-lived notifications that float over the page, use a toast instead. ## Accessibility - The colors `info`, `success`, `warning` and `danger` set a severity: a default icon, a prefix that screen readers announce before the message (for example \"Warning:\"), and the live region role. - Warnings and errors use `role=\"alert\"`, which interrupts the user. Other alerts use `role=\"status\"`, which waits until the user is idle.",
182
182
  "meta": {
183
183
  "props": [
184
184
  {
@@ -233,6 +233,16 @@
233
233
  "required": false,
234
234
  "category": "Presentation"
235
235
  },
236
+ {
237
+ "name": "surface",
238
+ "type": {
239
+ "kind": "primitive",
240
+ "name": "string"
241
+ },
242
+ "description": "The color the alert sits on, when it is not the theme background: a utility color like\n'primary', or a CSS color code. The text color of the `tonal` and `outlined` variants is\nmeasured against it, so the alert stays readable on a colored banner. The dismiss button\nand the buttons in the `actions` slot (by default) are measured against what they sit on:\nthe tint over it in a `tonal` alert, the surface itself in an `outlined` one. A `bold`\nalert's buttons sit on its own fill, with or without a surface. Defaults to the theme\nbackground.",
243
+ "required": false,
244
+ "category": "Presentation"
245
+ },
236
246
  {
237
247
  "name": "variant",
238
248
  "type": {
@@ -248,6 +258,19 @@
248
258
  "required": false,
249
259
  "category": "Presentation"
250
260
  },
261
+ {
262
+ "name": "actionsAlign",
263
+ "type": {
264
+ "kind": "enum",
265
+ "values": [
266
+ "start",
267
+ "end"
268
+ ]
269
+ },
270
+ "description": "Which side the buttons in the `actions` slot pack to.\nLeave it unset to keep today's placement: a banner's message grows, so the\nactions sit at the end of that row, and under a title they sit at the start.\n`start` and `end` place them on that side in both layouts. `end` is the right\nin left-to-right text and the left in right-to-left. The dismiss button stays\nat the trailing edge.",
271
+ "required": false,
272
+ "category": "Presentation"
273
+ },
251
274
  {
252
275
  "name": "dismissible",
253
276
  "type": {
@@ -275,8 +298,8 @@
275
298
  {
276
299
  "name": "icons",
277
300
  "type": {
278
- "kind": "object",
279
- "fields": {}
301
+ "kind": "unknown",
302
+ "raw": "QIcons<\"info\" | \"success\" | \"warning\" | \"danger\" | \"dismiss\"> | undefined"
280
303
  },
281
304
  "description": "Custom icon configurations: the severity icons and the dismiss icon.\nPass every key, or omit the prop to keep the defaults.",
282
305
  "default": "DEFAULT_ICONS",
@@ -333,6 +356,16 @@
333
356
  "description": "`tonal` (default), `bold` and `outlined`.",
334
357
  "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-alert\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\t:variant=\"variant\" />\n\t\t\t</div>"
335
358
  },
359
+ {
360
+ "title": "Outlined Warning Border",
361
+ "description": "Warning (and other light colors) darken the text for contrast on the page. The outlined border takes that same color, not the raw theme color.",
362
+ "code": "<QAlert color=\"warning\" variant=\"outlined\" />"
363
+ },
364
+ {
365
+ "title": "Surface",
366
+ "description": "On a colored banner, set `surface` to the banner's color. The text of the `tonal` and `outlined` variants is then measured against the banner instead of the page, and the dismiss button and the actions get it too. A `bold` alert's buttons sit on its own fill.",
367
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem; padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n\t\t\t\t<q-alert\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:variant\n\t\t\t\t\tcolor=\"info\"\n\t\t\t\t\tsurface=\"primary\"\n\t\t\t\t\t:text=\"'A ' + variant + ' alert on a primary banner.'\"\n\t\t\t\t\tdismissible>\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tvariant=\"outlined\"\n\t\t\t\t\t\t\tlabel=\"Undo\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t</div>"
368
+ },
336
369
  {
337
370
  "title": "Custom Color",
338
371
  "description": "Any CSS color works too. Colors other than the four severities have no default icon, no screen reader prefix, and use `role=\"status\"`. Pass an icon in the `icon` slot to show one. The slot also replaces the icon of a severity alert.",
@@ -345,8 +378,8 @@
345
378
  },
346
379
  {
347
380
  "title": "Actions",
348
- "description": "The `actions` slot holds buttons or links that act on the alert. In a banner they share the row with the message and wrap below it when space runs out.",
349
- "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-alert v-bind=\"args\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Delete\" variant=\"bold\" color=\"danger\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert v-bind=\"args\" title=\"Delete record\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Delete\" variant=\"bold\" color=\"danger\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t</div>"
381
+ "description": "The `actions` slot holds buttons or links that act on the alert. In a banner they share the row with the message and wrap below it when space runs out. `actionsAlign=\"end\"` packs them to the end of the row. `actionsAlign=\"start\"` keeps a banner's actions next to the message. The buttons stay in the order they are written, and the dismiss button stays at the trailing edge.",
382
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-alert v-bind=\"args\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Delete\" variant=\"bold\" color=\"danger\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert v-bind=\"args\" title=\"Delete record\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Delete\" variant=\"bold\" color=\"danger\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert v-bind=\"args\" text=\"Follow the message?\" actions-align=\"start\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Follow\" variant=\"bold\" color=\"warning\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert v-bind=\"args\" text=\"Keep this record?\" actions-align=\"end\" dismissible>\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Keep\" variant=\"bold\" color=\"warning\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\ttitle=\"Keep record\"\n\t\t\t\t\ttext=\"Keep this record?\"\n\t\t\t\t\tactions-align=\"end\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Keep\" variant=\"bold\" color=\"warning\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t</div>"
350
383
  },
351
384
  {
352
385
  "title": "Actions On Bold",
@@ -454,7 +487,7 @@
454
487
  {
455
488
  "title": "With Image",
456
489
  "description": "Displays an avatar with an image.",
457
- "code": "<QAvatar src=\"https://i.pravatar.cc/150?img=10\" alt=\"User Avatar\" />"
490
+ "code": "<QAvatar src=\"/avatar.svg\" alt=\"User Avatar\" />"
458
491
  },
459
492
  {
460
493
  "title": "With Initials",
@@ -469,12 +502,12 @@
469
502
  {
470
503
  "title": "Custom Size",
471
504
  "description": "Displays an avatar with a custom size.",
472
- "code": "<QAvatar size=\"120px\" src=\"https://i.pravatar.cc/150?img=10\" alt=\"User Avatar\" />"
505
+ "code": "<QAvatar size=\"120px\" src=\"/avatar.svg\" alt=\"User Avatar\" />"
473
506
  },
474
507
  {
475
508
  "title": "Square Shape",
476
509
  "description": "Displays an avatar with a square shape.",
477
- "code": "<QAvatar shape=\"square\" initials=\"SQ\" src=\"https://i.pravatar.cc/150?img=10\" alt=\"User Avatar\" />"
510
+ "code": "<QAvatar shape=\"square\" initials=\"SQ\" src=\"/avatar.svg\" alt=\"User Avatar\" />"
478
511
  },
479
512
  {
480
513
  "title": "Custom Colors",
@@ -524,6 +557,16 @@
524
557
  "required": false,
525
558
  "category": "Presentation"
526
559
  },
560
+ {
561
+ "name": "surface",
562
+ "type": {
563
+ "kind": "primitive",
564
+ "name": "string"
565
+ },
566
+ "description": "The color the badge sits on, when it is not the theme background: a utility color like\n'primary', or a CSS color code. The text color of the `tonal` and `outlined` variants, and\nthe hover color, are measured against it, so the badge stays readable on a colored banner.\nIts buttons are measured against what they sit on: the badge's fill when `bold` (with or\nwithout a surface), its tint over the surface when `tonal`, and the surface when\n`outlined` or when the badge is clickable. Defaults to the theme background.",
567
+ "required": false,
568
+ "category": "Presentation"
569
+ },
527
570
  {
528
571
  "name": "pill",
529
572
  "type": {
@@ -582,8 +625,8 @@
582
625
  {
583
626
  "name": "icons",
584
627
  "type": {
585
- "kind": "object",
586
- "fields": {}
628
+ "kind": "unknown",
629
+ "raw": "QIcons<\"remove\"> | undefined"
587
630
  },
588
631
  "description": "Custom icon configurations.",
589
632
  "default": "DEFAULT_ICONS",
@@ -637,6 +680,16 @@
637
680
  "description": "Displays an outlined badge with a transparent background.",
638
681
  "code": "<q-badge variant=\"outlined\">\n\t\t\t\tBadge\n\t\t\t</q-badge>"
639
682
  },
683
+ {
684
+ "title": "Outlined Warning Border",
685
+ "description": "Warning (and other light colors) darken the text for contrast on the page. The outlined border takes that same color, not the raw theme color.",
686
+ "code": "<q-badge\n\t\t\t\tvariant=\"outlined\"\n\t\t\t\tcolor=\"warning\">\n\t\t\t\tWarning\n\t\t\t</q-badge>"
687
+ },
688
+ {
689
+ "title": "Surface",
690
+ "description": "On a colored banner, set `surface` to the banner's color. The text of the `tonal` and `outlined` variants is then measured against the banner instead of the page, so it stays readable. The remove button is measured against what it sits on: the badge's fill when `bold`, its tint over the banner when `tonal`, and the banner when `outlined`.",
691
+ "code": "<div style=\"display: flex; flex-wrap: wrap; gap: 0.5rem; padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n\t\t\t\t<q-badge\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:variant\n\t\t\t\t\tcolor=\"danger\"\n\t\t\t\t\tsurface=\"primary\"\n\t\t\t\t\tremovable>\n\t\t\t\t\t{{ variant }}\n\t\t\t\t</q-badge>\n\t\t\t</div>"
692
+ },
640
693
  {
641
694
  "title": "Trailing Icon",
642
695
  "description": "Displays an icon before the text.",
@@ -647,6 +700,11 @@
647
700
  "description": "Displays an icon after the text.",
648
701
  "code": "<q-badge v-bind=\"args\">\n\t\t\t\tLisbon\n\t\t\t\t<q-icon icon=\"map-marker\" />\n\t\t\t</q-badge>"
649
702
  },
703
+ {
704
+ "title": "Icon Only",
705
+ "description": "A badge with only an icon, which centers in the badge: there is no text whose capitals it could center on. The remove button of a removable one centers on the icon.",
706
+ "code": "<div style=\"display: flex; gap: 0.25rem\">\n\t\t\t\t<q-badge v-bind=\"args\">\n\t\t\t\t\t<q-icon icon=\"check-circle\" />\n\t\t\t\t</q-badge>\n\t\t\t\t<q-badge v-bind=\"args\" removable>\n\t\t\t\t\t<q-icon icon=\"check-circle\" />\n\t\t\t\t</q-badge>\n\t\t\t</div>"
707
+ },
650
708
  {
651
709
  "title": "Colors",
652
710
  "description": "Any color can be applied to the badge. Supports utility colors (for example `success` or `danger`) or css colors (`#033` or `rgba(255, 0, 0, 0.5)`)",
@@ -861,8 +919,8 @@
861
919
  {
862
920
  "name": "icons",
863
921
  "type": {
864
- "kind": "object",
865
- "fields": {}
922
+ "kind": "unknown",
923
+ "raw": "QIcons<\"check\" | \"description\" | \"expand\" | \"separator\" | \"collapsed\"> | undefined"
866
924
  },
867
925
  "description": "Custom icons for the default separator and the collapsed-items control.\nPass every key, or omit the prop to keep the defaults.",
868
926
  "default": "DEFAULT_ICONS",
@@ -899,6 +957,11 @@
899
957
  "description": "The full trail, with a leading icon on each crumb.",
900
958
  "code": "<q-breadcrumbs v-bind=\"args\">\n\t\t\t\t<q-breadcrumb label=\"Home\" href=\"/\" :icon=\"{ icon: 'home' }\" />\n\t\t\t\t<q-breadcrumb label=\"Documents\" href=\"/documents\" :icon=\"{ icon: 'folder' }\" />\n\t\t\t\t<q-breadcrumb label=\"Quarterly Report\" :icon=\"{ icon: 'file-document' }\" />\n\t\t\t</q-breadcrumbs>"
901
959
  },
960
+ {
961
+ "title": "Icon Size",
962
+ "description": "Icons of other sizes, set with the `size` of a crumb's `icon` and of `icons.separator`. They center on the capitals of the labels like icons of the default size.",
963
+ "code": "<q-breadcrumbs v-bind=\"args\">\n\t\t\t\t<q-breadcrumb label=\"Home\" href=\"/\" :icon=\"{ icon: 'home', size: 1.5 }\" />\n\t\t\t\t<q-breadcrumb label=\"Documents\" href=\"/documents\" :icon=\"{ icon: 'folder', size: 0.75 }\" />\n\t\t\t\t<q-breadcrumb label=\"Quarterly Report\" :icon=\"{ icon: 'file-document', size: 1.5 }\" />\n\t\t\t</q-breadcrumbs>"
964
+ },
902
965
  {
903
966
  "title": "Collapsed",
904
967
  "description": "A long trail collapses its middle crumbs into an ellipsis control that opens a dropdown, keeping the first and current crumb visible. The control has an accessible name (`aria-label`) and the dropdown is keyboard operable: Tab skips the collapsed links and reaches the control, which opens a menu of them.",
@@ -969,8 +1032,8 @@
969
1032
  {
970
1033
  "name": "icons",
971
1034
  "type": {
972
- "kind": "object",
973
- "fields": {}
1035
+ "kind": "unknown",
1036
+ "raw": "QIcons<\"help\"> | undefined"
974
1037
  },
975
1038
  "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
976
1039
  "default": "DEFAULT_ICONS",
@@ -1205,10 +1268,15 @@
1205
1268
  "description": "Use the primary button once per page to represent the preferred user action.",
1206
1269
  "code": "<div style=\"display: flex; flex-direction: column; align-items: start; gap: .5rem\">\n\t\t\t\t<div\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\tstyle=\"display: flex; align-items: start; gap: .5rem\">\n\t\t\t\t\t<q-button\n\t\t\t\t\t\tv-for=\"color in colors\"\n\t\t\t\t\t\t:key=\"color\"\n\t\t\t\t\t\t:variant\n\t\t\t\t\t\t:color\n\t\t\t\t\t\t:label=\"color\"\n\t\t\t\t\t\tv-bind=args />\n\t\t\t\t</div>\n\t\t\t</div>"
1207
1270
  },
1271
+ {
1272
+ "title": "Outlined Warning Border",
1273
+ "description": "Warning (and other light utilities) darken the label for contrast on white. The outlined border uses that same adjusted color, not the raw theme token.",
1274
+ "code": "<QButton label=\"Warning\" color=\"warning\" variant=\"outlined\" />"
1275
+ },
1208
1276
  {
1209
1277
  "title": "Surface",
1210
- "description": "On a colored banner, set `surface` to the banner's color. The label and the hover are then measured against the banner instead of the page, so they stay readable.",
1211
- "code": "<div style=\"display: flex; gap: .5rem; padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n\t\t\t\t<q-button\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:variant\n\t\t\t\t\tcolor=\"background\"\n\t\t\t\t\tsurface=\"primary\"\n\t\t\t\t\t:label=\"variant\" />\n\t\t\t</div>"
1278
+ "description": "On a colored banner, set `surface` to the banner's color. The label and the hover are then measured against the banner instead of the page, so they stay readable, in a theme color too: the danger row reads on the banner itself and on its tint.",
1279
+ "code": "<div style=\"display: flex; flex-direction: column; gap: .5rem; padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n\t\t\t\t<div\n\t\t\t\t\tv-for=\"color in colors\"\n\t\t\t\t\t:key=\"color\"\n\t\t\t\t\tstyle=\"display: flex; flex-wrap: wrap; gap: .5rem\">\n\t\t\t\t\t<q-button\n\t\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t\t:variant\n\t\t\t\t\t\t:color\n\t\t\t\t\t\tsurface=\"primary\"\n\t\t\t\t\t\t:label=\"variant\" />\n\t\t\t\t</div>\n\t\t\t</div>"
1212
1280
  },
1213
1281
  {
1214
1282
  "title": "Disabled",
@@ -1242,8 +1310,8 @@
1242
1310
  },
1243
1311
  {
1244
1312
  "title": "Size",
1245
- "description": "Local size overrides. Useful for slotting buttons within other components. Combines with the global density toolbar (product = global × size).",
1246
- "code": "<div style=\"display: flex; align-items: center; gap: 0.5rem\">\n\t\t\t\t<q-button size=\"small\" label=\"Small\" />\n\t\t\t\t<q-button size=\"medium\" label=\"Medium\" />\n\t\t\t\t<q-button size=\"large\" label=\"Large\" />\n\t\t\t</div>"
1313
+ "description": "Local size overrides. Useful for slotting buttons within other components. Combines with the global density toolbar (product = global × size). The icon scales with the label, and centers on its capitals in every size.",
1314
+ "code": "<div style=\"display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem\">\n\t\t\t\t<q-button size=\"small\" label=\"Small\"><q-icon icon=\"check-circle\" /></q-button>\n\t\t\t\t<q-button size=\"medium\" label=\"Medium\"><q-icon icon=\"check-circle\" /></q-button>\n\t\t\t\t<q-button size=\"large\" label=\"Large\"><q-icon icon=\"check-circle\" /></q-button>\n\t\t\t</div>"
1247
1315
  }
1248
1316
  ]
1249
1317
  },
@@ -1350,6 +1418,11 @@
1350
1418
  "title": "Elevated",
1351
1419
  "description": "Features a subtle shadow for an elevated visual effect.",
1352
1420
  "code": "<QButtonGroup :elevated=\"true\" />"
1421
+ },
1422
+ {
1423
+ "title": "Wrapping",
1424
+ "description": "Wraps onto more rows when its container is too narrow for one. Each row starts at the group's left edge, and the rows overlap their borders as the buttons of a row do.",
1425
+ "code": "<div style=\"width: 12rem\">\n\t\t\t\t<q-button-group v-bind=\"args\">\n\t\t\t\t\t<q-button label=\"Copy\" />\n\t\t\t\t\t<q-button label=\"Cut\" />\n\t\t\t\t\t<q-button label=\"Paste\" />\n\t\t\t\t\t<q-button label=\"Delete\" />\n\t\t\t\t\t<q-button label=\"Select all\" />\n\t\t\t\t</q-button-group>\n\t\t\t</div>"
1353
1426
  }
1354
1427
  ]
1355
1428
  },
@@ -1566,13 +1639,13 @@
1566
1639
  {
1567
1640
  "title": "Custom Header",
1568
1641
  "description": "Adds custom components to the card header.",
1569
- "code": "<q-card v-bind=\"args\">\n\t\t\t\t<template #header.prepend>\n\t\t\t\t\t<img src=\"https://aicontentfy.com/hubfs/Blog/e2f82ed6-4180-4648-9560-949a48793661.jpg\"\n\t\t\t\t\t\theight=\"200\"\n\t\t\t\t\t\talt=\"Clickable Image\">\n\t\t\t\t</template>\n\t\t\t\tSome quick example text to build on the card title.\n\t\t\t</q-card>"
1642
+ "code": "<q-card v-bind=\"args\">\n\t\t\t\t<template #header.prepend>\n\t\t\t\t\t<img src=\"/carousel/slide-4.jpg\"\n\t\t\t\t\t\theight=\"200\"\n\t\t\t\t\t\talt=\"Clickable Image\">\n\t\t\t\t</template>\n\t\t\t\tSome quick example text to build on the card title.\n\t\t\t</q-card>"
1570
1643
  }
1571
1644
  ]
1572
1645
  },
1573
1646
  {
1574
1647
  "name": "QCarousel",
1575
- "description": "The `QCarousel` component displays a set of slides with optional controls, indicators, autoplay, touch navigation, and progress bar. Screen readers call it a carousel: name it with `aria-label` or `aria-labelledby`. The slide shown is its Tab stop, where the arrows, Home and End change the slide. While it cycles on its own, a button pauses it, and it waits while focus or the pointer is on it.",
1648
+ "description": "The `QCarousel` component displays a set of slides with optional controls, indicators, autoplay, touch navigation, and progress bar. ## Accessibility - Screen readers call it a carousel: name it with `aria-label` or `aria-labelledby`. - The slide shown is its Tab stop, where the arrows, Home and End change the slide. - While it cycles on its own, a button pauses it, and it waits while focus or the pointer is on it.",
1576
1649
  "meta": {
1577
1650
  "props": [
1578
1651
  {
@@ -1715,8 +1788,8 @@
1715
1788
  {
1716
1789
  "name": "icons",
1717
1790
  "type": {
1718
- "kind": "object",
1719
- "fields": {}
1791
+ "kind": "unknown",
1792
+ "raw": "QIcons<\"back\" | \"forward\" | \"pause\" | \"play\"> | undefined"
1720
1793
  },
1721
1794
  "description": "Custom icon configurations.\nPass every key, or omit the prop to keep the defaults.",
1722
1795
  "default": "DEFAULT_ICONS",
@@ -1907,7 +1980,7 @@
1907
1980
  "kind": "object",
1908
1981
  "fields": {}
1909
1982
  },
1910
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
1983
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
1911
1984
  "default": "DEFAULT_ICONS",
1912
1985
  "required": false,
1913
1986
  "category": "Configuration"
@@ -1918,7 +1991,8 @@
1918
1991
  "kind": "object",
1919
1992
  "fields": {}
1920
1993
  },
1921
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.",
1994
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.",
1995
+ "default": "DEFAULT_TEXTS",
1922
1996
  "required": false,
1923
1997
  "category": "Configuration"
1924
1998
  },
@@ -2001,17 +2075,6 @@
2001
2075
  "required": false,
2002
2076
  "category": "State"
2003
2077
  },
2004
- {
2005
- "name": "hasFocusOutline",
2006
- "type": {
2007
- "kind": "primitive",
2008
- "name": "boolean"
2009
- },
2010
- "description": "Indicates whether the control will have an outline when focused.",
2011
- "default": "true",
2012
- "required": false,
2013
- "category": "Behavior"
2014
- },
2015
2078
  {
2016
2079
  "name": "borderless",
2017
2080
  "type": {
@@ -2052,6 +2115,10 @@
2052
2115
  "name": "errors",
2053
2116
  "description": ""
2054
2117
  },
2118
+ {
2119
+ "name": "warnings",
2120
+ "description": ""
2121
+ },
2055
2122
  {
2056
2123
  "name": "extras",
2057
2124
  "description": ""
@@ -2076,8 +2143,8 @@
2076
2143
  },
2077
2144
  {
2078
2145
  "title": "Readonly",
2079
- "description": "A read-only checkbox that conveys a non-interactive appearance. This can be used to display a static checked/unchecked state for reference.",
2080
- "code": "<div style=\"display: flex; gap: 2rem\">\n\t\t\t\t<q-checkbox v-bind=\"args\"/>\n\t\t\t\t<q-checkbox model-value v-bind=\"args\" />\n\t\t\t</div>"
2146
+ "description": "A read-only checkbox that conveys a non-interactive appearance. This can be used to display a static checked/unchecked state for reference. Shown in the light and the dark theme, where the checked box and its check stand out in each.",
2147
+ "code": "<QCheckbox label=\"Readonly\" :readonly=\"true\" />"
2081
2148
  },
2082
2149
  {
2083
2150
  "title": "Invalid",
@@ -2097,12 +2164,12 @@
2097
2164
  {
2098
2165
  "title": "Size",
2099
2166
  "description": "A demonstration of checkboxes with different size overrides. Combines with the global density toolbar (product = global × size).",
2100
- "code": "<div style=\"display: flex; align-items: center; gap: 2rem\">\n\t\t\t\t<q-checkbox model-value label=\"Small\" size=\"small\" />\n\t\t\t\t<q-checkbox model-value label=\"Medium\" size=\"medium\" />\n\t\t\t\t<q-checkbox model-value label=\"Large\" size=\"large\" />\n\t\t\t</div>"
2167
+ "code": "<div style=\"display: flex; flex-wrap: wrap; align-items: center; gap: 2rem\">\n\t\t\t\t<q-checkbox model-value label=\"Small\" size=\"small\" />\n\t\t\t\t<q-checkbox model-value label=\"Medium\" size=\"medium\" />\n\t\t\t\t<q-checkbox model-value label=\"Large\" size=\"large\" />\n\t\t\t</div>"
2101
2168
  },
2102
2169
  {
2103
2170
  "title": "Icons",
2104
2171
  "description": "A checkbox with custom icons for the checked and indeterminate states. This allows for a more personalized or context-specific design.",
2105
- "code": "<QCheckbox :model-value=\"true\" label=\"Diferent icon\" :icons=\"{\n\t\t\thelp: { icon: 'help' },\n\t\t\terror: { icon: 'alert-circle' },\n\t\t\tchecked: { icon: 'skip-next' },\n\t\t\tindeterminate: { icon: 'skip-next' }\n\t\t}\" />"
2172
+ "code": "<QCheckbox :model-value=\"true\" label=\"Diferent icon\" :icons=\"{\n\t\t\thelp: { icon: 'help' },\n\t\t\terror: { icon: 'alert-circle' },\n\t\t\twarning: { icon: 'alert' },\n\t\t\tchecked: { icon: 'skip-next' },\n\t\t\tindeterminate: { icon: 'skip-next' }\n\t\t}\" />"
2106
2173
  },
2107
2174
  {
2108
2175
  "title": "Indeterminate",
@@ -2119,6 +2186,11 @@
2119
2186
  "description": "The `errors` slot says what is wrong while `invalid` is true: here until the box is checked. The message goes under the label, above the help and the extras, and takes no room while there is none.",
2120
2187
  "code": "<q-checkbox\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"accepted\"\n\t\t\t\t:invalid=\"!accepted\">\n\t\t\t\t<template #errors>Accept the terms to continue</template>\n\t\t\t\t<template #extras>\n\t\t\t\t\t<a href=\"#terms\">Read the terms and conditions</a>\n\t\t\t\t</template>\n\t\t\t</q-checkbox>"
2121
2188
  },
2189
+ {
2190
+ "title": "Warning Message",
2191
+ "description": "The `warnings` slot points out something to check without making the value invalid. It goes under the error, above the help and the extras, and moves up to the error's place while there is no error. The box takes a warning border, and an invalid box the error's.",
2192
+ "code": "<q-checkbox\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"accepted\"\n\t\t\t\t:invalid=\"!accepted\">\n\t\t\t\t<template #errors>Accept the terms to continue</template>\n\t\t\t\t<template #warnings>The terms changed on 1 November</template>\n\t\t\t\t<template #extras>\n\t\t\t\t\t<a href=\"#terms\">Read the terms and conditions</a>\n\t\t\t\t</template>\n\t\t\t</q-checkbox>"
2193
+ },
2122
2194
  {
2123
2195
  "title": "Borderless",
2124
2196
  "description": "Displays borderless checkbox.",
@@ -2236,8 +2308,8 @@
2236
2308
  {
2237
2309
  "name": "icons",
2238
2310
  "type": {
2239
- "kind": "object",
2240
- "fields": {}
2311
+ "kind": "unknown",
2312
+ "raw": "QIcons<\"chevron\"> | undefined"
2241
2313
  },
2242
2314
  "description": "Custom icon configurations.",
2243
2315
  "default": "DEFAULT_ICONS",
@@ -2340,6 +2412,11 @@
2340
2412
  "title": "Custom Icon",
2341
2413
  "description": "The collapsible with a custom chevron icon.",
2342
2414
  "code": "<q-collapsible v-model=\"model\" v-bind=\"args\">\n\t\t\t\t<template #icon>\n\t\t\t\t\t<q-icon v-if=\"model\" icon=\"minus\" />\n\t\t\t\t\t<q-icon v-else icon=\"plus\" />\n\t\t\t\t</template>\n\t\t\t\t<q-text-field label=\"Text input\"/>\n\t\t\t</q-collapsible>"
2415
+ },
2416
+ {
2417
+ "title": "Long Title",
2418
+ "description": "A long title and subtitle wrap inside a narrow header, as at 320px, instead of being cut off.",
2419
+ "code": "<div style=\"width: 288px\">\n\t\t\t\t<q-collapsible v-bind=\"args\">\n\t\t\t\t\t<q-text-field label=\"Country\" />\n\t\t\t\t</q-collapsible>\n\t\t\t</div>"
2343
2420
  }
2344
2421
  ]
2345
2422
  },
@@ -2388,7 +2465,7 @@
2388
2465
  "kind": "object",
2389
2466
  "fields": {}
2390
2467
  },
2391
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.",
2468
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.",
2392
2469
  "default": "DEFAULT_ICONS",
2393
2470
  "required": false,
2394
2471
  "category": "Configuration"
@@ -2399,7 +2476,7 @@
2399
2476
  "kind": "object",
2400
2477
  "fields": {}
2401
2478
  },
2402
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.\nPass every key, or omit the prop to keep the defaults.",
2479
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.\nPass every key, or omit the prop to keep the defaults.",
2403
2480
  "default": "DEFAULT_TEXTS",
2404
2481
  "required": false,
2405
2482
  "category": "Configuration"
@@ -2521,6 +2598,10 @@
2521
2598
  "name": "errors",
2522
2599
  "description": ""
2523
2600
  },
2601
+ {
2602
+ "name": "warnings",
2603
+ "description": ""
2604
+ },
2524
2605
  {
2525
2606
  "name": "extras",
2526
2607
  "description": ""
@@ -2591,7 +2672,7 @@
2591
2672
  "kind": "object",
2592
2673
  "fields": {}
2593
2674
  },
2594
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the text field, the clear button, and the list.\nPass every key, or omit the prop to keep the defaults.",
2675
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the text field, the clear button, and the list.\nPass every key, or omit the prop to keep the defaults.",
2595
2676
  "default": "DEFAULT_ICONS",
2596
2677
  "required": false,
2597
2678
  "category": "Configuration"
@@ -2602,7 +2683,7 @@
2602
2683
  "kind": "object",
2603
2684
  "fields": {}
2604
2685
  },
2605
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the help and clear button labels.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the strings of the text field and the clear button.\nPass every key, or omit the prop to keep the defaults.",
2686
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the help and clear button labels.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the strings of the text field and the clear button.\nPass every key, or omit the prop to keep the defaults.",
2606
2687
  "default": "DEFAULT_TEXTS",
2607
2688
  "required": false,
2608
2689
  "category": "Configuration"
@@ -2721,7 +2802,7 @@
2721
2802
  "kind": "primitive",
2722
2803
  "name": "boolean"
2723
2804
  },
2724
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
2805
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
2725
2806
  "required": false,
2726
2807
  "category": "State"
2727
2808
  },
@@ -2849,7 +2930,6 @@
2849
2930
  "values": [
2850
2931
  "wrap",
2851
2932
  "fit-content",
2852
- "truncate",
2853
2933
  "wrap-on-focus",
2854
2934
  "scroll-on-focus"
2855
2935
  ]
@@ -2966,6 +3046,10 @@
2966
3046
  "name": "errors",
2967
3047
  "description": ""
2968
3048
  },
3049
+ {
3050
+ "name": "warnings",
3051
+ "description": ""
3052
+ },
2969
3053
  {
2970
3054
  "name": "extras",
2971
3055
  "description": ""
@@ -3012,18 +3096,33 @@
3012
3096
  },
3013
3097
  {
3014
3098
  "title": "Loading",
3015
- "description": "Displays a loading animation that lets users know content is being loaded. A status region announces it, since focus stays in the input.",
3099
+ "description": "Before the first options load, the open list shows a \"Loading\" row the size of the \"No data\" one, and a bar over its top edge once the load runs past a short delay. A status region announces it, since focus stays in the input.",
3016
3100
  "code": "<QCombobox :items=\"[]\" :loading=\"true\" />"
3017
3101
  },
3102
+ {
3103
+ "title": "Async Search",
3104
+ "description": "Options that load as the user types, as a lookup that searches on the server does. The options stay while each search runs, the list says it is busy, and a bar over its top edge shows once a search runs past a short delay, so typing does not make the list vanish and come back.",
3105
+ "code": "<q-combobox\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model:search=\"search\"\n\t\t\t\t:items=\"items\"\n\t\t\t\t:loading=\"loading\" />"
3106
+ },
3018
3107
  {
3019
3108
  "title": "No Match",
3020
3109
  "description": "When nothing matches what was typed, the open list says so, and a status region announces it, since focus stays in the input.",
3021
3110
  "code": "<QCombobox />"
3022
3111
  },
3112
+ {
3113
+ "title": "Typed Text Not An Option",
3114
+ "description": "Typed text that matches no option stays in the field for the user to fix when focus leaves. The field turns invalid and says to choose an option (`texts.invalidValue`), and the model keeps its last value. Text that is the label of an option, in any case, picks it. Escape puts the label of the selected option back, which clears the error.",
3115
+ "code": "<QCombobox model-value=\"queen\" />"
3116
+ },
3023
3117
  {
3024
3118
  "title": "Overflow",
3025
- "description": "Controls how long option labels overflow relative to the field width. Defaults to `wrap`. - `wrap`: the menu matches the field and labels wrap onto more lines. - `truncate`: the menu matches the field and labels end in an ellipsis; a cut-off label shows its full text in a native `title` on hover. - `fit-content`: the menu grows with the longest option. - `wrap-on-focus`: like `truncate` until the option is highlighted, then that label wraps. Focus stays in the field. - `scroll-on-focus`: like `truncate` until the option is highlighted, then that label scrolls to its end and back. With reduced motion, the highlighted label wraps instead.",
3026
- "code": "<div style=\"display: flex; flex-wrap: wrap; align-items: flex-start; gap: 1rem\">\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Wrap\" overflow=\"wrap\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"truncate\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Truncate\" overflow=\"truncate\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"fit-content\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Fit content\" overflow=\"fit-content\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap-on-focus\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Wrap on focus\" overflow=\"wrap-on-focus\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"scroll-on-focus\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Scroll on focus\" overflow=\"scroll-on-focus\" />\n\t\t\t\t</div>\n\t\t\t</div>"
3119
+ "description": "Controls how long option labels overflow relative to the field width. Defaults to `wrap`. - `wrap`: the menu matches the field and labels wrap onto more lines. - `fit-content`: the menu grows with the longest option, up to the width of the screen, where the labels wrap. - `wrap-on-focus`: the menu matches the field and labels end in an ellipsis until the option is highlighted, then that label wraps. Focus stays in the field. A cut-off label also shows its full text in a native `title` on hover. - `scroll-on-focus`: like `wrap-on-focus` until the option is highlighted, then that label scrolls to its end and back. With reduced motion, the highlighted label wraps instead.",
3120
+ "code": "<div style=\"display: flex; flex-wrap: wrap; align-items: flex-start; gap: 1rem\">\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Wrap\" overflow=\"wrap\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"fit-content\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Fit content\" overflow=\"fit-content\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap-on-focus\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Wrap on focus\" overflow=\"wrap-on-focus\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"scroll-on-focus\">\n\t\t\t\t\t<q-combobox v-bind=\"args\" label=\"Scroll on focus\" overflow=\"scroll-on-focus\" />\n\t\t\t\t</div>\n\t\t\t</div>"
3121
+ },
3122
+ {
3123
+ "title": "Fit Content Long Options",
3124
+ "description": "With `fit-content`, the list grows with its longest option up to the width of the screen, where the labels wrap: on a narrow screen, it never runs past the edge or scrolls sideways.",
3125
+ "code": "<QCombobox overflow=\"fit-content\" :items=\"[\n\t\t\t{ key: 'short', label: 'Short' },\n\t\t\t{\n\t\t\t\tkey: 'spaced',\n\t\t\t\tlabel: 'An option whose label has more words than a phone screen fits on one line'\n\t\t\t},\n\t\t\t{ key: 'unspaced', label: 'an_option_label_without_spaces_wider_than_a_phone_screen' }\n\t\t]\" />"
3027
3126
  },
3028
3127
  {
3029
3128
  "title": "Description In Items",
@@ -3039,12 +3138,17 @@
3039
3138
  "title": "Typing",
3040
3139
  "description": "Typing filters the list and highlights the first match, which Enter picks. Any character opens the list, Home and End move the caret while it is closed, and a press outside closes it, so it opens again with nothing highlighted.",
3041
3140
  "code": "<QCombobox />"
3141
+ },
3142
+ {
3143
+ "title": "Many Options",
3144
+ "description": "With many options, the list renders only those in view and a few around them, so it opens as fast as a short one. The keyboard reaches any option: End highlights the last one, which renders so `aria-activedescendant` has an element to point at, and typing filters all of them. Opened again, the list scrolls to the selected option, wherever it is.",
3145
+ "code": "<QCombobox label=\"Option\" :items=\"Array.from({ length: MANY_OPTIONS }, (_, index) => ({\n\t\t\tkey: `option${index + 1}`,\n\t\t\tlabel: `Option ${index + 1}`\n\t\t}))\" />"
3042
3146
  }
3043
3147
  ]
3044
3148
  },
3045
3149
  {
3046
3150
  "name": "QDateTimePicker",
3047
- "description": "A component that enables users to select dates and times in various formats.",
3151
+ "description": "A component that enables users to select dates and times in various formats. ## Accessibility - The field is a `combobox` that opens a `dialog`, which takes the field's name: its `label`, `aria-label` or `aria-labelledby`. Name the field, so the dialog has a name too. - The calendar is a `grid` with one Tab stop (selected day, else today). Arrows, Home/End, and PageUp/PageDown move within it; Enter commits, Escape closes. In range mode the grid is `aria-multiselectable`, and only the days chosen are `aria-selected`: the days a range previews while its end is picked are not. - Month and year pickers are separate views with their own controls. The month or year on display is `aria-current`.",
3048
3152
  "meta": {
3049
3153
  "props": [
3050
3154
  {
@@ -3133,7 +3237,7 @@
3133
3237
  "kind": "object",
3134
3238
  "fields": {}
3135
3239
  },
3136
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the text fields and the clear button.\nPass every key, or omit the prop to keep the defaults.",
3240
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the text fields and the clear button.\nPass every key, or omit the prop to keep the defaults.",
3137
3241
  "default": "DEFAULT_ICONS",
3138
3242
  "required": false,
3139
3243
  "category": "Configuration"
@@ -3144,7 +3248,7 @@
3144
3248
  "kind": "object",
3145
3249
  "fields": {}
3146
3250
  },
3147
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the strings of the text fields and the clear button.\nPass every key, or omit the prop to keep the defaults.",
3251
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the strings of the text fields and the clear button.\nPass every key, or omit the prop to keep the defaults.",
3148
3252
  "default": "DEFAULT_TEXTS",
3149
3253
  "required": false,
3150
3254
  "category": "Configuration"
@@ -3193,7 +3297,7 @@
3193
3297
  "kind": "primitive",
3194
3298
  "name": "boolean"
3195
3299
  },
3196
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
3300
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
3197
3301
  "required": false,
3198
3302
  "category": "State"
3199
3303
  },
@@ -3296,6 +3400,10 @@
3296
3400
  "name": "errors",
3297
3401
  "description": ""
3298
3402
  },
3403
+ {
3404
+ "name": "warnings",
3405
+ "description": ""
3406
+ },
3299
3407
  {
3300
3408
  "name": "extras",
3301
3409
  "description": ""
@@ -3310,9 +3418,19 @@
3310
3418
  },
3311
3419
  {
3312
3420
  "title": "Date Time With Seconds",
3313
- "description": "DateTime picker with seconds display",
3421
+ "description": "DateTime picker with seconds display. Picking a day of the next month shows that month, with focus on the day picked.",
3314
3422
  "code": "<QDateTimePicker format=\"dd/MM/yyyy HH:mm:ss\" label=\"Select Date and Time\" placeholder=\"Choose date and time\" />"
3315
3423
  },
3424
+ {
3425
+ "title": "Six Week Calendar",
3426
+ "description": "Every month is six weeks, so a short month is as tall as a long one. Days of the month on display are heavier than the days of the months beside it, and those days stay readable.",
3427
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n\t\t\t\t<q-date-time-picker v-bind=\"args\" label=\"February 2021\" :model-value=\"february\" />\n\t\t\t\t<q-date-time-picker v-bind=\"args\" label=\"March 2026\" :model-value=\"march\" />\n\t\t\t</div>"
3428
+ },
3429
+ {
3430
+ "title": "Narrow Menu",
3431
+ "description": "On a narrow screen, the menu is no wider than the screen allows, and its days shrink with it: each week stays on one row, under its weekdays, and the days stay square. Checked in loose density, where the menu is widest and a day is a 44px control on a wider screen.",
3432
+ "code": "<QDateTimePicker format=\"dd/MM/yyyy\" />"
3433
+ },
3316
3434
  {
3317
3435
  "title": "Date Time 12 Hour Format",
3318
3436
  "description": "DateTime picker with 12-hour format (AM/PM)",
@@ -3323,6 +3441,11 @@
3323
3441
  "description": "Time-only picker. Without a calendar, the menu is only as wide as the time inputs.",
3324
3442
  "code": "<QDateTimePicker format=\"HH:mm\" label=\"Select Time\" placeholder=\"HH:mm\" model-value=\"14:00\" />"
3325
3443
  },
3444
+ {
3445
+ "title": "Typing A Time",
3446
+ "description": "Typing a time in its fields. A first digit stays as typed, so a second one follows it, even after the window loses focus and gets it back, and the number is padded when focus leaves its field. A digit typed at the end of a full field starts a new number.",
3447
+ "code": "<QDateTimePicker format=\"HH:mm\" label=\"Select Time\" />"
3448
+ },
3326
3449
  {
3327
3450
  "title": "Time Only 12 Hour Format",
3328
3451
  "description": "Time-only picker with 12-hour format (AM/PM)",
@@ -3348,9 +3471,24 @@
3348
3471
  "description": "Range DateTime picker",
3349
3472
  "code": "<QDateTimePicker label=\"Select a date range\" :range=\"true\" />"
3350
3473
  },
3474
+ {
3475
+ "title": "Range Around Today",
3476
+ "description": "A range around today, in both themes. The band of a week is a layer under the days: today keeps its own border, in the main color on every side, over it. The tint is too faint to show the range on its own (about 1.2:1), so the band takes edges in the text color, which show it.",
3477
+ "code": "<QDateTimePicker label=\"Select a date range\" :range=\"true\" format=\"dd/MM/yyyy\" :model-value=\"[\n\t\t\tnew Date(now.getFullYear(), now.getMonth(), now.getDate() - 3),\n\t\t\tnew Date(now.getFullYear(), now.getMonth(), now.getDate() + 3)\n\t\t]\" />"
3478
+ },
3479
+ {
3480
+ "title": "Range Across Months",
3481
+ "description": "A range from one month into the next. Its days in the next month stay as light as that month's other days, not bold: only the days of the month on display are bold, in a range or not. The band runs through the days of a week with no seam between them, at any scale.",
3482
+ "code": "<QDateTimePicker label=\"Select a date range\" :range=\"true\" format=\"dd/MM/yyyy\" :model-value=\"[new Date(2026, 3, 3), new Date(2026, 4, 10)]\" />"
3483
+ },
3484
+ {
3485
+ "title": "Range Right To Left",
3486
+ "description": "A range in a right-to-left page. The band runs from the start, on the right, to the end, on the left, and the ends round on the outside of the range: the start on the right, the end on the left. The menu opens in place (`inline`), in the story's right-to-left container.",
3487
+ "code": "<QDateTimePicker label=\"Select a date range\" :range=\"true\" :inline=\"true\" format=\"dd/MM/yyyy\" :model-value=\"[new Date(2026, 3, 3), new Date(2026, 3, 15)]\" />"
3488
+ },
3351
3489
  {
3352
3490
  "title": "Typed Text Not A Date",
3353
- "description": "Text that is not a date stays in the field for the user to fix. The field turns invalid and says how to type one, with today as the example (`texts.invalidValue`), and the model keeps its last value. A date clears the error.",
3491
+ "description": "Text that is not a date stays in the field for the user to fix. The field turns invalid and says how to type one, with today as the example (`texts.invalidValue`), and the model keeps its last value. So does a date that does not exist, such as 31 February: it is not changed to one that does. A date clears the error.",
3354
3492
  "code": "<q-date-time-picker v-bind=\"args\" v-model=\"args.modelValue\" />\n\t\t\t<q-button label=\"After\" style=\"margin-top: 1rem\" />"
3355
3493
  },
3356
3494
  {
@@ -3398,6 +3536,16 @@
3398
3536
  "description": "The default configuration values to provide to child components.\nThese values will be **merged with each component's own defaults**.",
3399
3537
  "required": true,
3400
3538
  "category": "Configuration"
3539
+ },
3540
+ {
3541
+ "name": "local",
3542
+ "type": {
3543
+ "kind": "primitive",
3544
+ "name": "boolean"
3545
+ },
3546
+ "description": "Keeps the defaults out of what is drawn on its own surface, over the page, but declared in\nthe slot: overlays (dialogs, popovers, menus), temporary drawers and toasts. They reach every\nother component in it. For defaults that depend on where the content is drawn, such as the\n`surface` of buttons on a colored banner. The defaults the app sets, and those of other\nproviders, still reach them.",
3547
+ "required": false,
3548
+ "category": "Configuration"
3401
3549
  }
3402
3550
  ],
3403
3551
  "events": [],
@@ -3412,7 +3560,7 @@
3412
3560
  },
3413
3561
  {
3414
3562
  "name": "QDialog",
3415
- "description": "A floating, dismissible dialog window that provides feedback or requires user interaction.",
3563
+ "description": "A floating, dismissible dialog window that provides feedback or requires user interaction. ## Accessibility - Uses `role=\"dialog\"`. With `focusWrap` (default) it traps Tab and sets `aria-modal=\"true\"`; without it, Tab can leave and `aria-modal` is omitted so the page stays available to assistive technology. - Escape dismisses it (including when `persistent` blocks outside pointer / focus). Focus returns to the opener on close unless `closingFocus` overrides that. - Prefer a visible title over `aria-label` alone. The title is an `h2` by default; pass `headingLevel` for another level, or a value outside 1–6 for a non-heading.",
3416
3564
  "meta": {
3417
3565
  "props": [
3418
3566
  {
@@ -3426,22 +3574,23 @@
3426
3574
  "category": "Identification"
3427
3575
  },
3428
3576
  {
3429
- "name": "modelValue",
3577
+ "name": "title",
3430
3578
  "type": {
3431
3579
  "kind": "primitive",
3432
- "name": "boolean"
3580
+ "name": "string"
3433
3581
  },
3434
- "description": "The value of the selected item.",
3582
+ "description": "The title of the dialog window.",
3435
3583
  "required": false,
3436
3584
  "category": "Content"
3437
3585
  },
3438
3586
  {
3439
- "name": "title",
3587
+ "name": "headingLevel",
3440
3588
  "type": {
3441
3589
  "kind": "primitive",
3442
- "name": "string"
3590
+ "name": "number"
3443
3591
  },
3444
- "description": "The title of the dialog window.",
3592
+ "description": "The heading level of the title. The title heads a window of its own, outside the heading\noutline of the page, so it is an `h2` by default: set this only for an app that wants another\nlevel. A value outside 1–6 renders the title in a plain `div`. Defaults to 2.",
3593
+ "default": "2",
3445
3594
  "required": false,
3446
3595
  "category": "Content"
3447
3596
  },
@@ -3484,8 +3633,7 @@
3484
3633
  "value": {}
3485
3634
  }
3486
3635
  },
3487
- "description": "The buttons to interact with the dialog window. Pass an empty array to show no buttons.",
3488
- "default": "DEFAULT_BUTTONS",
3636
+ "description": "The buttons to interact with the dialog window. Without it, the dialog shows one \"Ok\" button,\nlabeled from `texts.ok` with `icons.ok`. Pass an empty array to show no buttons.",
3489
3637
  "required": false,
3490
3638
  "category": "Content"
3491
3639
  },
@@ -3665,10 +3813,10 @@
3665
3813
  {
3666
3814
  "name": "icons",
3667
3815
  "type": {
3668
- "kind": "object",
3669
- "fields": {}
3816
+ "kind": "unknown",
3817
+ "raw": "QIcons<\"warning\" | \"close\" | \"help\" | \"error\" | \"clear\" | \"ok\"> | undefined"
3670
3818
  },
3671
- "description": "Custom icon configurations. Includes the icons of the prompt input.\nPass every key, or omit the prop to keep the defaults.",
3819
+ "description": "Custom icon configurations. Includes the icons of the prompt input and `ok`, the icon of\nthe default button.\nPass every key, or omit the prop to keep the defaults.",
3672
3820
  "default": "DEFAULT_ICONS",
3673
3821
  "required": false,
3674
3822
  "category": "Configuration"
@@ -3679,7 +3827,7 @@
3679
3827
  "kind": "object",
3680
3828
  "fields": {}
3681
3829
  },
3682
- "description": "Custom text configurations. Includes the strings of the prompt input.\nPass every key, or omit the prop to keep the defaults.",
3830
+ "description": "Custom text configurations. Includes the strings of the prompt input, `ok`, the label of\nthe default button, and `prompt`, the name of a prompt field with no `input.label`.\nPass every key, or omit the prop to keep the defaults.",
3683
3831
  "default": "DEFAULT_TEXTS",
3684
3832
  "required": false,
3685
3833
  "category": "Configuration"
@@ -3693,13 +3841,28 @@
3693
3841
  "description": "",
3694
3842
  "default": "undefined",
3695
3843
  "required": false
3844
+ },
3845
+ {
3846
+ "name": "modelValue",
3847
+ "type": {
3848
+ "kind": "primitive",
3849
+ "name": "boolean"
3850
+ },
3851
+ "description": "",
3852
+ "default": "false",
3853
+ "required": false
3696
3854
  }
3697
3855
  ],
3698
3856
  "events": [
3699
3857
  {
3700
3858
  "name": "update:modelValue",
3701
3859
  "description": "",
3702
- "type": "[val: boolean]"
3860
+ "type": "[value: boolean]"
3861
+ },
3862
+ {
3863
+ "name": "after-leave",
3864
+ "description": "",
3865
+ "type": "[]"
3703
3866
  },
3704
3867
  {
3705
3868
  "name": "action",
@@ -3751,9 +3914,14 @@
3751
3914
  },
3752
3915
  {
3753
3916
  "title": "With Title",
3754
- "description": "Displays a header with a custom title.",
3917
+ "description": "Displays a header with a custom title. The title is a heading, an `h2` unless `headingLevel` picks another level, and names the dialog.",
3755
3918
  "code": "<QDialog text=\"You clicked the button!\" title=\"What did you do?\" :dismissible=\"true\" />"
3756
3919
  },
3920
+ {
3921
+ "title": "Prompt",
3922
+ "description": "A prompt: `input` adds a field to the dialog, with its `type` and a visible `label`. A `validator` runs when a button with an `action` is pressed, and, once its error shows, again as the value changes, so the error goes as soon as the value is valid.",
3923
+ "code": "<QDialog title=\"Share the report\" text=\"We will send a link to the report.\" :icon=\"null\" :input=\"{\n\t\t\ttype: 'email',\n\t\t\tlabel: 'Email',\n\t\t\tvalidator: (value: string) =>\n\t\t\t\t/^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$/.test(value) ? undefined : 'Enter an email address'\n\t\t}\" :buttons=\"[\n\t\t\t{ id: 'send', action: () => undefined, props: { label: 'Send', variant: 'bold' } }\n\t\t]\" />"
3924
+ },
3757
3925
  {
3758
3926
  "title": "Flush",
3759
3927
  "description": "Edge-to-edge layout (no body inset or section dividers) — same chrome `QDialogProvider` uses for programmatic dialogs.",
@@ -3764,6 +3932,16 @@
3764
3932
  "description": "Shows a custom icon instead of the default one.",
3765
3933
  "code": "<QDialog text=\"You clicked the button?\" :icon=\"{\n\t\t\ticon: 'help-circle-outline'\n\t\t}\" />"
3766
3934
  },
3935
+ {
3936
+ "title": "Non Modal",
3937
+ "description": "A dialog that does not wrap focus (`focusWrap: false`): it is not modal, and Tab can leave it for the page. Focus still moves into it when it opens, and back to the button that opened it when it closes.",
3938
+ "code": "<QDialog text=\"You clicked the button!\" :focus-wrap=\"false\" />"
3939
+ },
3940
+ {
3941
+ "title": "Nothing Focusable",
3942
+ "description": "A dialog with nothing to focus: no buttons, no close button and no field. Focus moves to the dialog itself, so the keyboard is inside it, and Escape closes it.",
3943
+ "code": "<QDialog title=\"Saving\" text=\"Your changes are being saved.\" :icon=\"null\" :buttons=\"[]\" />"
3944
+ },
3767
3945
  {
3768
3946
  "title": "Without Icon Or Buttons",
3769
3947
  "description": "A message with no icon and no buttons: `icon` set to `null` and `buttons` to an empty array. The close button in the header dismisses it.",
@@ -3786,7 +3964,7 @@
3786
3964
  },
3787
3965
  {
3788
3966
  "title": "Header Slot",
3789
- "description": "For a fully custom dialog, the **header** slot replaces the header dialog content.",
3967
+ "description": "For a fully custom dialog, the **header** slot replaces the header dialog content. Without a `title`, the heading it renders names the dialog, or all of it when it renders none.",
3790
3968
  "code": "<q-button label=\"Click me\" @click=\"modelValue = true\" />\n\t\t\t<q-dialog v-model=\"modelValue\" v-bind=\"args\">\n\t\t\t\t<template #header>\n\t\t\t\t\t<h2 style=\"font-size: 1.125rem; margin: 0;\">Custom header</h2>\n\t\t\t\t\t<p style=\"color: var(--q-text-color-secondary); margin-top: 0.375rem;\">Custom header content</p>\n\t\t\t\t</template>\n\t\t\t</q-dialog>"
3791
3969
  },
3792
3970
  {
@@ -3828,6 +4006,11 @@
3828
4006
  "title": "Focus On Close",
3829
4007
  "description": "When the dialog is closed, a specific element will be focused.",
3830
4008
  "code": "<q-button label=\"Click me\" @click=\"modelValue = true\" />\n\t\t\t<br /><br />\n\t\t\t<q-button id=\"focus-btn\" label=\"Focus\" />\n\t\t\t<q-dialog v-model=\"modelValue\" v-bind=\"args\" />"
4009
+ },
4010
+ {
4011
+ "title": "Stacked",
4012
+ "description": "Two dialogs `useDialog` opens at once, such as a warning over a form. Closing the top one with Escape returns focus to the one under it, which is still open and modal. The top one fades out as it closes, like a dialog closed through `v-model`: the provider keeps its entry until its overlay has left.",
4013
+ "code": "<q-dialog-provider />\n\t\t\t<q-button label=\"Open both\" @click=\"openBoth\" />"
3831
4014
  }
3832
4015
  ]
3833
4016
  },
@@ -3931,6 +4114,16 @@
3931
4114
  "default": "neutral",
3932
4115
  "required": false,
3933
4116
  "category": "Presentation"
4117
+ },
4118
+ {
4119
+ "name": "surface",
4120
+ "type": {
4121
+ "kind": "primitive",
4122
+ "name": "string"
4123
+ },
4124
+ "description": "The color the divider sits on, when it is not the theme background: a utility color\nlike 'primary', or a CSS color code. The label color is measured against it, so the\nlabel stays readable on a colored banner, and a neutral divider's label takes the\nsurface's own text color. Defaults to the theme background.",
4125
+ "required": false,
4126
+ "category": "Presentation"
3934
4127
  }
3935
4128
  ],
3936
4129
  "events": [],
@@ -3971,12 +4164,17 @@
3971
4164
  "title": "Colored",
3972
4165
  "description": "A horizontal divider with a primary color.",
3973
4166
  "code": "<div>\n <p>Section above</p>\n <QDivider color=\"primary\" />\n <p>Section below</p>\n </div>"
4167
+ },
4168
+ {
4169
+ "title": "Surface",
4170
+ "description": "On a colored banner, set `surface` to the banner's color. The label is then measured against the banner instead of the page, so it stays readable. Without a `color`, the label takes the banner's own text color.",
4171
+ "code": "<div style=\"padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n <QDivider color=\"onPrimary\" surface=\"primary\">Or</QDivider>\n <QDivider color=\"danger\" surface=\"primary\">Danger</QDivider>\n <QDivider surface=\"primary\">Neutral</QDivider>\n </div>"
3974
4172
  }
3975
4173
  ]
3976
4174
  },
3977
4175
  {
3978
- "name": "QDropdownMenu",
3979
- "description": "A generic dropdown menu.",
4176
+ "name": "QDrawer",
4177
+ "description": "A side surface that docks left or right — permanent in the layout or temporary as an overlay with scrim — for app navigation and contextual panels. ## Accessibility - Temporary mode puts `role=\"dialog\"` on the surface inside `QFocusWrap` (like `QOverlay`, including `closingFocus` / `returnFocusOnDeactivate`), with Escape / scrim dismiss, scroll lock, and focus return on close. With `focusWrap` (default) it traps Tab, sets `aria-modal`, and registers a modal layer for toasts; without it, focus still moves in on open and Tab can leave. - Permanent mode renders an `<aside>` landmark. Provide a visible `title` or a `label` / `texts.drawer` so the landmark has an accessible name. - The optional resize handle is a focusable `separator` named after the drawer (`aria-labelledby` / the same name as the surface). Arrow keys resize it (WCAG 2.1.1). Shrink/grow buttons are the single-pointer alternative to dragging (WCAG 2.5.7) — arrow keys alone do not satisfy 2.5.7. - Width / slide transitions follow `prefers-reduced-motion` (local duration override). - Prefer a visible title over `aria-label` alone when the header is shown. Pass `headingLevel` (1–6) when the title should be a heading; omit it for a non-heading. - Rail mode: `#rail` is the collapsed icon strip; the default slot is the expanded chrome. `railExpand` chooses the layout when open: `beside` keeps the strip next to a (often different) panel; `replace` hides the strip once the panel shows (app-style icons → labeled nav). With `expandOnHover`, hover or focus-within widens the drawer. Name the landmark with `label` while the title may be hidden when collapsed.",
3980
4178
  "meta": {
3981
4179
  "props": [
3982
4180
  {
@@ -3990,94 +4188,563 @@
3990
4188
  "category": "Identification"
3991
4189
  },
3992
4190
  {
3993
- "name": "activator",
4191
+ "name": "location",
3994
4192
  "type": {
3995
- "kind": "union",
3996
- "types": [
3997
- {
3998
- "name": "string"
3999
- },
4000
- {
4001
- "name": "object",
4002
- "value": {}
4003
- }
4193
+ "kind": "enum",
4194
+ "values": [
4195
+ "left",
4196
+ "right"
4004
4197
  ]
4005
4198
  },
4006
- "description": "The DOM element used to activate the dropdown menu, such as a button. It takes the states\nof a menu button (`aria-haspopup`, `aria-expanded` and, while the menu is open,\n`aria-controls`), and its `id` names the menu.",
4199
+ "description": "Side of the viewport or layout the drawer docks to.\nDefaults to `left`.",
4200
+ "default": "left",
4007
4201
  "required": false,
4008
- "category": "Identification"
4202
+ "category": "Presentation"
4009
4203
  },
4010
4204
  {
4011
- "name": "itemValue",
4205
+ "name": "mode",
4012
4206
  "type": {
4013
- "kind": "primitive",
4014
- "name": "string"
4207
+ "kind": "enum",
4208
+ "values": [
4209
+ "temporary",
4210
+ "permanent"
4211
+ ]
4015
4212
  },
4016
- "description": "Property on each item that contains its value.",
4213
+ "description": "Layout mode: in-flow (`permanent`) or overlay with scrim (`temporary`).\nDefaults to `temporary`.",
4214
+ "default": "temporary",
4017
4215
  "required": false,
4018
- "category": "Identification"
4216
+ "category": "Behavior"
4019
4217
  },
4020
4218
  {
4021
- "name": "itemLabel",
4219
+ "name": "rail",
4022
4220
  "type": {
4023
4221
  "kind": "primitive",
4024
- "name": "string"
4222
+ "name": "boolean"
4025
4223
  },
4026
- "description": "Property on each item that contains its title.",
4224
+ "description": "When true, uses the collapsed rail width instead of the expanded width.\nPass a `#rail` slot for the icon strip and put the expanded chrome in the\ndefault slot. How those two relate when open is `railExpand`. Defaults to\n`false`.",
4225
+ "default": "false",
4027
4226
  "required": false,
4028
- "category": "Identification"
4227
+ "category": "Presentation"
4029
4228
  },
4030
4229
  {
4031
- "name": "items",
4230
+ "name": "expandOnHover",
4032
4231
  "type": {
4033
- "kind": "array",
4034
- "elementType": {
4035
- "name": "object",
4036
- "value": {}
4037
- }
4232
+ "kind": "primitive",
4233
+ "name": "boolean"
4038
4234
  },
4039
- "description": "The list of available items for selection.",
4235
+ "description": "When `rail` is true, expands to the full width on hover or focus-within\nand reveals the default-slot panel. Defaults to `false`.",
4236
+ "default": "false",
4040
4237
  "required": false,
4041
- "category": "Content"
4238
+ "category": "Behavior"
4042
4239
  },
4043
4240
  {
4044
- "name": "groups",
4241
+ "name": "railExpand",
4045
4242
  "type": {
4046
- "kind": "array",
4047
- "elementType": {
4048
- "name": "object",
4049
- "value": {}
4050
- }
4243
+ "kind": "enum",
4244
+ "values": [
4245
+ "replace",
4246
+ "beside"
4247
+ ]
4051
4248
  },
4052
- "description": "The item groups used for organizing the available items.",
4249
+ "description": "Layout of `#rail` vs the expanded panel when the rail is open.\n`beside` keeps the strip next to the panel; `replace` hides the strip\nonce the panel is shown (app-style icon rail → labeled nav). Only applies\nwith a `#rail` slot. Defaults to `beside`.",
4250
+ "default": "beside",
4053
4251
  "required": false,
4054
- "category": "Content"
4252
+ "category": "Presentation"
4055
4253
  },
4056
4254
  {
4057
- "name": "appearance",
4255
+ "name": "width",
4058
4256
  "type": {
4059
- "kind": "enum",
4060
- "values": [
4061
- "regular",
4062
- "inverted"
4257
+ "kind": "union",
4258
+ "types": [
4259
+ {
4260
+ "name": "string"
4261
+ },
4262
+ {
4263
+ "name": "number"
4264
+ }
4063
4265
  ]
4064
4266
  },
4065
- "description": "The appearance of the dropdown menu.\n'regular' uses body text color for background and body background color for text.\n'inverted' matches body color scheme.",
4267
+ "description": "Expanded drawer width. A number is treated as CSS pixels (scaled by\n`--q-density-scale`); a string is used as a raw CSS length.\nDefaults to `280`.",
4268
+ "default": "DEFAULT_WIDTH",
4066
4269
  "required": false,
4067
4270
  "category": "Presentation"
4068
4271
  },
4069
4272
  {
4070
- "name": "placement",
4273
+ "name": "railWidth",
4071
4274
  "type": {
4072
- "kind": "enum",
4073
- "values": [
4074
- "top",
4075
- "bottom",
4076
- "left",
4077
- "right",
4078
- "top-start",
4079
- "top-end",
4080
- "bottom-start",
4275
+ "kind": "union",
4276
+ "types": [
4277
+ {
4278
+ "name": "string"
4279
+ },
4280
+ {
4281
+ "name": "number"
4282
+ }
4283
+ ]
4284
+ },
4285
+ "description": "Rail (mini) width when `rail` is true. Same number/string rules as `width`.\nDefaults to `var(--q-rail-width, calc(var(--q-space-1) * 12.5))` — set\n`--q-rail-width` in app CSS to align this with the `QSidebar` anchor rail.",
4286
+ "default": "DEFAULT_RAIL_WIDTH",
4287
+ "required": false,
4288
+ "category": "Presentation"
4289
+ },
4290
+ {
4291
+ "name": "minWidth",
4292
+ "type": {
4293
+ "kind": "primitive",
4294
+ "name": "number"
4295
+ },
4296
+ "description": "Minimum width in CSS pixels while resizing. Only applies when `resizable`\nis true. Defaults to `50` (regular-density pixel equivalent of the shared\nrem rail width at a 16px root).",
4297
+ "default": "DEFAULT_RAIL_WIDTH_PX",
4298
+ "required": false,
4299
+ "category": "Presentation"
4300
+ },
4301
+ {
4302
+ "name": "maxWidth",
4303
+ "type": {
4304
+ "kind": "primitive",
4305
+ "name": "number"
4306
+ },
4307
+ "description": "Maximum width in CSS pixels while resizing. Only applies when `resizable`\nis true. Omit for no upper limit beyond the viewport.",
4308
+ "required": false,
4309
+ "category": "Presentation"
4310
+ },
4311
+ {
4312
+ "name": "resizable",
4313
+ "type": {
4314
+ "kind": "primitive",
4315
+ "name": "boolean"
4316
+ },
4317
+ "description": "Whether the user can resize the drawer by dragging (or arrow keys on) the\nedge handle. Ignored while `rail` is true. Defaults to `false`.",
4318
+ "default": "false",
4319
+ "required": false,
4320
+ "category": "Behavior"
4321
+ },
4322
+ {
4323
+ "name": "showGrip",
4324
+ "type": {
4325
+ "kind": "primitive",
4326
+ "name": "boolean"
4327
+ },
4328
+ "description": "Whether to show a visible grip on the resize handle. Only applies when\n`resizable` is true. Defaults to `true`.",
4329
+ "default": "true",
4330
+ "required": false,
4331
+ "category": "Presentation"
4332
+ },
4333
+ {
4334
+ "name": "title",
4335
+ "type": {
4336
+ "kind": "primitive",
4337
+ "name": "string"
4338
+ },
4339
+ "description": "Optional title shown in the header. Also names the drawer for assistive\ntechnology when no `label` is set and the header slot does not replace it.",
4340
+ "required": false,
4341
+ "category": "Content"
4342
+ },
4343
+ {
4344
+ "name": "headingLevel",
4345
+ "type": {
4346
+ "kind": "primitive",
4347
+ "name": "number"
4348
+ },
4349
+ "description": "Heading level for the title (`1`–`6` → `h1`–`h6`). Outside that range, or\nwhen omitted, the title renders as a `div` so the page outline does not\nchange until the app sets a level. No default.",
4350
+ "required": false,
4351
+ "category": "Accessibility"
4352
+ },
4353
+ {
4354
+ "name": "label",
4355
+ "type": {
4356
+ "kind": "primitive",
4357
+ "name": "string"
4358
+ },
4359
+ "description": "Accessible name when there is no rendered title element. Prefer a visible\n`title` when possible. Falls back to `texts.drawer` when omitted.",
4360
+ "required": false,
4361
+ "category": "Accessibility"
4362
+ },
4363
+ {
4364
+ "name": "dismissible",
4365
+ "type": {
4366
+ "kind": "primitive",
4367
+ "name": "boolean"
4368
+ },
4369
+ "description": "When true, shows a close button in the header area.\nDefaults to `false`.",
4370
+ "default": "false",
4371
+ "required": false,
4372
+ "category": "Behavior"
4373
+ },
4374
+ {
4375
+ "name": "backdropBlur",
4376
+ "type": {
4377
+ "kind": "primitive",
4378
+ "name": "boolean"
4379
+ },
4380
+ "description": "Temporary mode only: blurs the page behind the scrim.\nDefaults to `true`.",
4381
+ "default": "true",
4382
+ "required": false,
4383
+ "category": "Presentation"
4384
+ },
4385
+ {
4386
+ "name": "scrollLock",
4387
+ "type": {
4388
+ "kind": "primitive",
4389
+ "name": "boolean"
4390
+ },
4391
+ "description": "Temporary mode only: prevents scrolling the page while open.\nDefaults to `true`.",
4392
+ "default": "true",
4393
+ "required": false,
4394
+ "category": "Behavior"
4395
+ },
4396
+ {
4397
+ "name": "persistent",
4398
+ "type": {
4399
+ "kind": "primitive",
4400
+ "name": "boolean"
4401
+ },
4402
+ "description": "Temporary mode only: when true, outside pointer / focus does not close the\ndrawer. Escape still closes it so the dialog stays keyboard-dismissible.\nDefaults to `false`.",
4403
+ "default": "false",
4404
+ "required": false,
4405
+ "category": "Behavior"
4406
+ },
4407
+ {
4408
+ "name": "focusWrap",
4409
+ "type": {
4410
+ "kind": "primitive",
4411
+ "name": "boolean"
4412
+ },
4413
+ "description": "Temporary mode only: traps Tab focus inside the drawer while open.\nDefaults to `true`.",
4414
+ "default": "true",
4415
+ "required": false,
4416
+ "category": "Behavior"
4417
+ },
4418
+ {
4419
+ "name": "initialFocus",
4420
+ "type": {
4421
+ "kind": "union",
4422
+ "types": [
4423
+ {
4424
+ "name": "other",
4425
+ "value": "null"
4426
+ },
4427
+ {
4428
+ "name": "string"
4429
+ },
4430
+ {
4431
+ "name": "object",
4432
+ "value": {}
4433
+ }
4434
+ ]
4435
+ },
4436
+ "description": "Element to focus when the focus wrap activates. Has priority over\n`focusWithinOnActivate`.",
4437
+ "required": false,
4438
+ "category": "Behavior"
4439
+ },
4440
+ {
4441
+ "name": "focusWithinOnActivate",
4442
+ "type": {
4443
+ "kind": "primitive",
4444
+ "name": "boolean"
4445
+ },
4446
+ "description": "Whether to focus the first focusable element when the focus wrap activates.\nDefaults to `true`.",
4447
+ "default": "true",
4448
+ "required": false,
4449
+ "category": "Behavior"
4450
+ },
4451
+ {
4452
+ "name": "closingFocus",
4453
+ "type": {
4454
+ "kind": "union",
4455
+ "types": [
4456
+ {
4457
+ "name": "string"
4458
+ },
4459
+ {
4460
+ "name": "object",
4461
+ "value": {}
4462
+ }
4463
+ ]
4464
+ },
4465
+ "description": "Element to focus when the drawer closes. Has priority over\n`returnFocusOnDeactivate`.",
4466
+ "required": false,
4467
+ "category": "Behavior"
4468
+ },
4469
+ {
4470
+ "name": "returnFocusOnDeactivate",
4471
+ "type": {
4472
+ "kind": "primitive",
4473
+ "name": "boolean"
4474
+ },
4475
+ "description": "Whether to return focus to the element that opened the drawer when the\nfocus wrap deactivates. Defaults to `true`.",
4476
+ "default": "true",
4477
+ "required": false,
4478
+ "category": "Behavior"
4479
+ },
4480
+ {
4481
+ "name": "attach",
4482
+ "type": {
4483
+ "kind": "primitive",
4484
+ "name": "string"
4485
+ },
4486
+ "description": "DOM element the temporary drawer teleports to. Defaults to `body`.\nIgnored when `inline` is true or `mode` is `permanent`.",
4487
+ "default": "body",
4488
+ "required": false,
4489
+ "category": "Behavior"
4490
+ },
4491
+ {
4492
+ "name": "inline",
4493
+ "type": {
4494
+ "kind": "primitive",
4495
+ "name": "boolean"
4496
+ },
4497
+ "description": "Temporary mode only: disables teleport so `attach` is ignored.\nDefaults to `false`.",
4498
+ "default": "false",
4499
+ "required": false,
4500
+ "category": "Behavior"
4501
+ },
4502
+ {
4503
+ "name": "icons",
4504
+ "type": {
4505
+ "kind": "unknown",
4506
+ "raw": "QIcons<\"close\" | \"shrink\" | \"grow\"> | undefined"
4507
+ },
4508
+ "description": "Custom icon configurations. Pass every key, or omit the prop to keep the\ndefaults.",
4509
+ "default": "DEFAULT_ICONS",
4510
+ "required": false,
4511
+ "category": "Configuration"
4512
+ },
4513
+ {
4514
+ "name": "texts",
4515
+ "type": {
4516
+ "kind": "object",
4517
+ "fields": {}
4518
+ },
4519
+ "description": "Custom text configurations (close button, accessible name fallback, shrink /\ngrow). Pass every key, or omit the prop to keep the defaults.",
4520
+ "default": "DEFAULT_TEXTS",
4521
+ "required": false,
4522
+ "category": "Configuration"
4523
+ },
4524
+ {
4525
+ "name": "modelValue",
4526
+ "type": {
4527
+ "kind": "primitive",
4528
+ "name": "boolean"
4529
+ },
4530
+ "description": "",
4531
+ "default": "false",
4532
+ "required": false
4533
+ }
4534
+ ],
4535
+ "events": [
4536
+ {
4537
+ "name": "update:modelValue",
4538
+ "description": "",
4539
+ "type": "[value: boolean]"
4540
+ },
4541
+ {
4542
+ "name": "resize:start",
4543
+ "description": "",
4544
+ "type": "[]"
4545
+ },
4546
+ {
4547
+ "name": "resize",
4548
+ "description": "",
4549
+ "type": "[width: number]"
4550
+ },
4551
+ {
4552
+ "name": "resize:end",
4553
+ "description": "",
4554
+ "type": "[finalWidth: number]"
4555
+ }
4556
+ ],
4557
+ "slots": [
4558
+ {
4559
+ "name": "drawer",
4560
+ "description": ""
4561
+ },
4562
+ {
4563
+ "name": "rail",
4564
+ "description": ""
4565
+ },
4566
+ {
4567
+ "name": "header",
4568
+ "description": ""
4569
+ },
4570
+ {
4571
+ "name": "header.prepend",
4572
+ "description": ""
4573
+ },
4574
+ {
4575
+ "name": "header.append",
4576
+ "description": ""
4577
+ },
4578
+ {
4579
+ "name": "prepend",
4580
+ "description": ""
4581
+ },
4582
+ {
4583
+ "name": "default",
4584
+ "description": ""
4585
+ },
4586
+ {
4587
+ "name": "append",
4588
+ "description": ""
4589
+ },
4590
+ {
4591
+ "name": "footer",
4592
+ "description": ""
4593
+ }
4594
+ ]
4595
+ },
4596
+ "examples": [
4597
+ {
4598
+ "title": "Default",
4599
+ "description": "Temporary drawer over page content with scrim. Escape or the scrim closes it.",
4600
+ "code": "<div>\n\t\t\t\t<q-button label=\"Open drawer\" @click=\"open = true\" />\n\t\t\t\t<p style=\"margin-top: 1rem;\">Page content stays interactive only after the drawer closes.</p>\n\t\t\t\t<q-drawer v-bind=\"args\" :model-value=\"open\" @update:model-value=\"onUpdate\">\n\t\t\t\t\t<p>Temporary overlay drawer. Press Escape or click the scrim to dismiss.</p>\n\t\t\t\t</q-drawer>\n\t\t\t</div>"
4601
+ },
4602
+ {
4603
+ "title": "Permanent Left",
4604
+ "description": "Permanent left rail in the document flow — typical app shell navigation chrome. Menu items are slotted; the library does not ship a menu model.",
4605
+ "code": "<div class=\"q-drawer-story-shell\">\n\t\t\t\t<q-drawer v-model=\"args.modelValue\" v-bind=\"args\">\n\t\t\t\t\t<q-list label=\"Navigation\">\n\t\t\t\t\t\t<q-list-item value=\"home\" label=\"Home\" />\n\t\t\t\t\t\t<q-list-item value=\"projects\" label=\"Projects\" />\n\t\t\t\t\t\t<q-list-item value=\"settings\" label=\"Settings\" />\n\t\t\t\t\t</q-list>\n\t\t\t\t</q-drawer>\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>Main application content. The permanent drawer stays in layout flow.</p>\n\t\t\t\t</main>\n\t\t\t</div>"
4606
+ },
4607
+ {
4608
+ "title": "Permanent Right",
4609
+ "description": "Permanent drawer docked on the right — contextual edit panel pattern.",
4610
+ "code": "<div class=\"q-drawer-story-shell\">\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>Dashboard canvas. The edit panel docks on the right.</p>\n\t\t\t\t</main>\n\t\t\t\t<q-drawer v-model=\"args.modelValue\" v-bind=\"args\">\n\t\t\t\t\t<p>Widget configuration form goes here.</p>\n\t\t\t\t\t<template #footer>\n\t\t\t\t\t\t<q-button label=\"Save\" variant=\"bold\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-drawer>\n\t\t\t</div>"
4611
+ },
4612
+ {
4613
+ "title": "Temporary Right",
4614
+ "description": "Temporary right-side overlay — dashboard edit mode that covers the canvas.",
4615
+ "code": "<div>\n\t\t\t\t<q-button label=\"Edit dashboard\" @click=\"open = true\" />\n\t\t\t\t<q-drawer v-bind=\"args\" :model-value=\"open\" @update:model-value=\"onUpdate\">\n\t\t\t\t\t<p>Temporary panel for editing. Scrim blocks the canvas until closed.</p>\n\t\t\t\t</q-drawer>\n\t\t\t</div>"
4616
+ },
4617
+ {
4618
+ "title": "Rail",
4619
+ "description": "`railExpand=\"beside\"`: icon strip stays; a separate panel opens next to it. Collapsed shows `#rail` only; hover or focus-within widens the drawer. Clicking a strip tool switches the panel title and lists beside it.",
4620
+ "code": "<div class=\"q-drawer-story-shell\">\n\t\t\t\t<q-drawer\n\t\t\t\t\tv-model=\"args.modelValue\"\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\t:title=\"panels[tool].title\">\n\t\t\t\t\t<template #rail>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t:color=\"tool === 'search' ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\ttitle=\"Search\"\n\t\t\t\t\t\t\taria-label=\"Search\"\n\t\t\t\t\t\t\t:aria-pressed=\"tool === 'search'\"\n\t\t\t\t\t\t\t@click=\"selectTool('search')\">\n\t\t\t\t\t\t\t<q-icon icon=\"magnify\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t:color=\"tool === 'favorites' ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\ttitle=\"Favorites\"\n\t\t\t\t\t\t\taria-label=\"Favorites\"\n\t\t\t\t\t\t\t:aria-pressed=\"tool === 'favorites'\"\n\t\t\t\t\t\t\t@click=\"selectTool('favorites')\">\n\t\t\t\t\t\t\t<q-icon icon=\"star\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t:color=\"tool === 'help' ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\ttitle=\"Help\"\n\t\t\t\t\t\t\taria-label=\"Help\"\n\t\t\t\t\t\t\t:aria-pressed=\"tool === 'help'\"\n\t\t\t\t\t\t\t@click=\"selectTool('help')\">\n\t\t\t\t\t\t\t<q-icon icon=\"help-circle\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t</template>\n\t\t\t\t\t<p style=\"margin: 0 0 var(--q-space-3); color: var(--q-text-color-secondary);\">\n\t\t\t\t\t\t{{ panels[tool].blurb }}\n\t\t\t\t\t</p>\n\t\t\t\t\t<div\n\t\t\t\t\t\tv-for=\"(group, index) in panels[tool].groups\"\n\t\t\t\t\t\t:key=\"group.label\"\n\t\t\t\t\t\t:style=\"index > 0 ? 'margin-top: var(--q-space-3);' : undefined\">\n\t\t\t\t\t\t<q-list :label=\"group.label\">\n\t\t\t\t\t\t\t<q-list-item\n\t\t\t\t\t\t\t\tv-for=\"item in group.items\"\n\t\t\t\t\t\t\t\t:key=\"item.value\"\n\t\t\t\t\t\t\t\t:value=\"item.value\"\n\t\t\t\t\t\t\t\t:label=\"item.label\" />\n\t\t\t\t\t\t</q-list>\n\t\t\t\t\t</div>\n\t\t\t\t\t<template #footer>\n\t\t\t\t\t\t<q-button :label=\"tool === 'help' ? 'Contact' : 'Manage'\" variant=\"text\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-drawer>\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>\n\t\t\t\t\t\tHover the strip to open the panel. Click Search, Favorites, or Help to\n\t\t\t\t\t\tswap what the expanded area shows — the strip tools drive the panel,\n\t\t\t\t\t\tthey are not the same items with labels.\n\t\t\t\t\t</p>\n\t\t\t\t\t<p style=\"color: var(--q-text-color-secondary);\">\n\t\t\t\t\t\tActive tool: {{ panels[tool].title }}\n\t\t\t\t\t</p>\n\t\t\t\t</main>\n\t\t\t</div>"
4621
+ },
4622
+ {
4623
+ "title": "Rail Nav",
4624
+ "description": "`railExpand=\"replace\"`: collapsed `#rail` is the same destinations as icons only; hover widens into a labeled nav (top level + one sub-level at most) and the strip yields. No group separators. Strip and panel stay in sync on click.",
4625
+ "code": "<div class=\"q-drawer-story-shell q-drawer-rail-nav-demo\">\n\t\t\t\t<!-- Explicit after v-bind so Controls cannot reset railExpand to beside. -->\n\t\t\t\t<q-drawer v-model=\"args.modelValue\" v-bind=\"args\" rail-expand=\"replace\">\n\t\t\t\t\t<template #rail>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tv-for=\"item in items\"\n\t\t\t\t\t\t\t:key=\"item.id\"\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t:color=\"active === item.id || item.children?.some((c) => c.id === active) ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t:title=\"item.label\"\n\t\t\t\t\t\t\t:aria-label=\"item.label\"\n\t\t\t\t\t\t\t:aria-pressed=\"active === item.id || item.children?.some((c) => c.id === active)\"\n\t\t\t\t\t\t\t@click=\"selectFromRail(item.id)\">\n\t\t\t\t\t\t\t<q-icon :icon=\"item.icon\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t</template>\n\t\t\t\t\t<nav class=\"q-drawer-rail-nav\" :aria-label=\"args.label\">\n\t\t\t\t\t\t<template v-for=\"item in items\" :key=\"item.id\">\n\t\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\t\tclass=\"q-drawer-rail-nav__item\"\n\t\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t\t:color=\"active === item.id || item.children?.some((c) => c.id === active) ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t\t:aria-pressed=\"active === item.id || item.children?.some((c) => c.id === active)\"\n\t\t\t\t\t\t\t\t:aria-expanded=\"item.children ? Boolean(expanded[item.id]) : undefined\"\n\t\t\t\t\t\t\t\t@click=\"selectFromPanel(item.id)\">\n\t\t\t\t\t\t\t\t<q-icon :icon=\"item.icon\" />\n\t\t\t\t\t\t\t\t<span class=\"q-drawer-rail-nav__item-label\">{{ item.label }}</span>\n\t\t\t\t\t\t\t\t<q-icon\n\t\t\t\t\t\t\t\t\tv-if=\"item.children\"\n\t\t\t\t\t\t\t\t\t:icon=\"expanded[item.id] ? 'chevron-up' : 'chevron-down'\" />\n\t\t\t\t\t\t\t</q-button>\n\t\t\t\t\t\t\t<div\n\t\t\t\t\t\t\t\tv-if=\"item.children && expanded[item.id]\"\n\t\t\t\t\t\t\t\tclass=\"q-drawer-rail-nav__children\">\n\t\t\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\t\t\tv-for=\"child in item.children\"\n\t\t\t\t\t\t\t\t\t:key=\"child.id\"\n\t\t\t\t\t\t\t\t\tclass=\"q-drawer-rail-nav__child\"\n\t\t\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t\t\t:color=\"active === child.id ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t\t\t:aria-pressed=\"active === child.id\"\n\t\t\t\t\t\t\t\t\t@click=\"selectChild(child.id)\">\n\t\t\t\t\t\t\t\t\t<q-badge\n\t\t\t\t\t\t\t\t\t\tv-if=\"child.code\"\n\t\t\t\t\t\t\t\t\t\tvariant=\"tonal\"\n\t\t\t\t\t\t\t\t\t\tcolor=\"primary\"\n\t\t\t\t\t\t\t\t\t\tsize=\"small\"\n\t\t\t\t\t\t\t\t\t\tpill>\n\t\t\t\t\t\t\t\t\t\t{{ child.code }}\n\t\t\t\t\t\t\t\t\t</q-badge>\n\t\t\t\t\t\t\t\t\t<q-icon v-else-if=\"child.icon\" :icon=\"child.icon\" />\n\t\t\t\t\t\t\t\t\t<span class=\"q-drawer-rail-nav__item-label\">{{ child.label }}</span>\n\t\t\t\t\t\t\t\t</q-button>\n\t\t\t\t\t\t\t</div>\n\t\t\t\t\t\t</template>\n\t\t\t\t\t</nav>\n\t\t\t\t</q-drawer>\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>\n\t\t\t\t\t\tSame destinations as the icon strip — labels plus one sub-level when a\n\t\t\t\t\t\tsection is open. No separators or deeper nesting.\n\t\t\t\t\t</p>\n\t\t\t\t\t<p style=\"color: var(--q-text-color-secondary);\">\n\t\t\t\t\t\tActive: {{ activeLabel }}\n\t\t\t\t\t</p>\n\t\t\t\t</main>\n\t\t\t</div>"
4626
+ },
4627
+ {
4628
+ "title": "Rail Menus",
4629
+ "description": "A permanent `rail` with no panel: only the icon strip ever shows (no `expandOnHover`, no default slot). Each strip button opens its own `QDropdownMenu` beside the strip, titled in its `#prepend` slot, and each menu shows another option of the dropdown: icons, groups, descriptions, submenus, shortcuts, and groups with icons.",
4630
+ "code": "<div class=\"q-drawer-story-shell\">\n\t\t\t\t<q-drawer v-model=\"args.modelValue\" v-bind=\"args\">\n\t\t\t\t\t<template #rail>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tv-for=\"menu in menus\"\n\t\t\t\t\t\t\t:key=\"menu.id\"\n\t\t\t\t\t\t\t:ref=\"(button) => setActivator(menu.id, button)\"\n\t\t\t\t\t\t\t:class=\"['q-drawer-rail-menus__button', { 'q-drawer-rail-menus__button--open': open[menu.id] }]\"\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t:color=\"open[menu.id] ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t:title=\"menu.label\"\n\t\t\t\t\t\t\t:aria-label=\"menu.label\">\n\t\t\t\t\t\t\t<q-icon :icon=\"menu.icon\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t</template>\n\t\t\t\t</q-drawer>\n\t\t\t\t<q-dropdown-menu\n\t\t\t\t\tv-for=\"menu in menus\"\n\t\t\t\t\t:key=\"menu.id\"\n\t\t\t\t\tv-model=\"open[menu.id]\"\n\t\t\t\t\t:activator=\"activators[menu.id]\"\n\t\t\t\t\t:items=\"menu.items\"\n\t\t\t\t\t:groups=\"menu.groups\"\n\t\t\t\t\tplacement=\"right-start\"\n\t\t\t\t\t@select=\"(key) => onSelect(menu, key)\">\n\t\t\t\t\t<template #prepend>\n\t\t\t\t\t\t<div class=\"q-drawer-rail-menus__title\">{{ menu.label }}</div>\n\t\t\t\t\t\t<q-divider />\n\t\t\t\t\t</template>\n\t\t\t\t</q-dropdown-menu>\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>\n\t\t\t\t\t\tOnly the icon strip shows. Each icon opens its own menu: Create has icons,\n\t\t\t\t\t\tProjects groups, Notifications descriptions, Reports submenus, Tools\n\t\t\t\t\t\tshortcuts, and Account groups with icons.\n\t\t\t\t\t</p>\n\t\t\t\t\t<p style=\"color: var(--q-text-color-secondary);\">\n\t\t\t\t\t\tLast choice: {{ lastChoice }}\n\t\t\t\t\t</p>\n\t\t\t\t</main>\n\t\t\t</div>"
4631
+ },
4632
+ {
4633
+ "title": "Resizable",
4634
+ "description": "Resizable permanent drawer. Drag the free edge, use ArrowLeft / ArrowRight on the handle (Home / End for min / max), or the Narrow / Widen buttons (WCAG 2.5.7).",
4635
+ "code": "<div class=\"q-drawer-story-shell\">\n\t\t\t\t<q-drawer v-model=\"args.modelValue\" v-bind=\"args\">\n\t\t\t\t\t<p>Drag the right edge, use arrow keys on the handle, or Narrow / Widen.</p>\n\t\t\t\t</q-drawer>\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>Main content.</p>\n\t\t\t\t</main>\n\t\t\t</div>"
4636
+ },
4637
+ {
4638
+ "title": "Persistent",
4639
+ "description": "Persistent temporary drawer: Escape closes, outside pointer does not.",
4640
+ "code": "<div>\n\t\t\t\t<!-- Keep the opener mounted so focus can return to it. -->\n\t\t\t\t<q-button label=\"Open drawer\" @click=\"open = true\" />\n\t\t\t\t<p style=\"margin-top: 1rem;\">Outside content. A click here must not dismiss the drawer.</p>\n\t\t\t\t<q-drawer v-bind=\"args\" :model-value=\"open\" @update:model-value=\"onUpdate\">\n\t\t\t\t\t<p>Click outside — the drawer stays open. Press Escape or the close button.</p>\n\t\t\t\t</q-drawer>\n\t\t\t</div>"
4641
+ }
4642
+ ]
4643
+ },
4644
+ {
4645
+ "name": "QDropdownMenu",
4646
+ "description": "A generic dropdown menu.",
4647
+ "meta": {
4648
+ "props": [
4649
+ {
4650
+ "name": "id",
4651
+ "type": {
4652
+ "kind": "primitive",
4653
+ "name": "string"
4654
+ },
4655
+ "description": "The component unique identifier.",
4656
+ "required": false,
4657
+ "category": "Identification"
4658
+ },
4659
+ {
4660
+ "name": "activator",
4661
+ "type": {
4662
+ "kind": "union",
4663
+ "types": [
4664
+ {
4665
+ "name": "string"
4666
+ },
4667
+ {
4668
+ "name": "object",
4669
+ "value": {}
4670
+ }
4671
+ ]
4672
+ },
4673
+ "description": "The DOM element used to activate the dropdown menu, such as a button. It takes the states\nof a menu button (`aria-haspopup`, `aria-expanded` and, while the menu is open,\n`aria-controls`), and its `id` names the menu. An activator without an `id` gets one\nwhile it opens the menu.",
4674
+ "required": false,
4675
+ "category": "Identification"
4676
+ },
4677
+ {
4678
+ "name": "itemValue",
4679
+ "type": {
4680
+ "kind": "primitive",
4681
+ "name": "string"
4682
+ },
4683
+ "description": "Property on each item that contains its value.",
4684
+ "required": false,
4685
+ "category": "Identification"
4686
+ },
4687
+ {
4688
+ "name": "itemLabel",
4689
+ "type": {
4690
+ "kind": "primitive",
4691
+ "name": "string"
4692
+ },
4693
+ "description": "Property on each item that contains its title.",
4694
+ "required": false,
4695
+ "category": "Identification"
4696
+ },
4697
+ {
4698
+ "name": "items",
4699
+ "type": {
4700
+ "kind": "array",
4701
+ "elementType": {
4702
+ "name": "object",
4703
+ "value": {}
4704
+ }
4705
+ },
4706
+ "description": "The list of available items for selection. An item's `extraInfo`, such as a shortcut,\nshows at its end and describes it, unless the `item.append` slot replaces it.",
4707
+ "required": false,
4708
+ "category": "Content"
4709
+ },
4710
+ {
4711
+ "name": "groups",
4712
+ "type": {
4713
+ "kind": "array",
4714
+ "elementType": {
4715
+ "name": "object",
4716
+ "value": {}
4717
+ }
4718
+ },
4719
+ "description": "The item groups used for organizing the available items.",
4720
+ "required": false,
4721
+ "category": "Content"
4722
+ },
4723
+ {
4724
+ "name": "appearance",
4725
+ "type": {
4726
+ "kind": "enum",
4727
+ "values": [
4728
+ "regular",
4729
+ "inverted"
4730
+ ]
4731
+ },
4732
+ "description": "The appearance of the dropdown menu.\n'regular' uses body text color for background and body background color for text.\n'inverted' matches body color scheme.",
4733
+ "required": false,
4734
+ "category": "Presentation"
4735
+ },
4736
+ {
4737
+ "name": "placement",
4738
+ "type": {
4739
+ "kind": "enum",
4740
+ "values": [
4741
+ "top",
4742
+ "bottom",
4743
+ "left",
4744
+ "right",
4745
+ "top-start",
4746
+ "top-end",
4747
+ "bottom-start",
4081
4748
  "bottom-end",
4082
4749
  "left-start",
4083
4750
  "left-end",
@@ -4137,8 +4804,8 @@
4137
4804
  {
4138
4805
  "name": "icons",
4139
4806
  "type": {
4140
- "kind": "object",
4141
- "fields": {}
4807
+ "kind": "unknown",
4808
+ "raw": "QIcons<\"check\" | \"description\" | \"expand\"> | undefined"
4142
4809
  },
4143
4810
  "description": "Custom icon configurations. Includes the icons of the list.\nPass every key, or omit the prop to keep the defaults.",
4144
4811
  "required": false,
@@ -4224,7 +4891,7 @@
4224
4891
  {
4225
4892
  "title": "Custom Activator",
4226
4893
  "description": "Example of a custom activator other than a button.",
4227
- "code": "<q-button ref=\"activator\" variant=\"ghost\" pill size=\"small\">\n\t\t\t\t<q-avatar alt=\"User Avatar\" src=\"https://i.pravatar.cc/150?img=10\" />\n\t\t\t</q-button>\n\t\t\t<q-dropdown-menu v-bind=\"args\" :activator=\"activatorRef?.$el\">\n\t\t\t\t<template #prepend>\n\t\t\t\t\t<div style=\"padding: .75rem .75rem .1rem .75rem; min-width: 12rem;\">\n\t\t\t\t\t\t<p style=\"margin: 0\">User Avatar</p>\n\t\t\t\t\t\t<span style=\"color: var(--q-theme-primary); font-size: .85rem;\">Administrator</span>\n\t\t\t\t\t</div>\n\t\t\t\t\t<q-divider />\n\t\t\t\t</template>\n\t\t\t</q-dropdown-menu>"
4894
+ "code": "<q-button ref=\"activator\" variant=\"ghost\" pill size=\"small\">\n\t\t\t\t<q-avatar alt=\"User Avatar\" src=\"/avatar.svg\" />\n\t\t\t</q-button>\n\t\t\t<q-dropdown-menu v-bind=\"args\" :activator=\"activatorRef?.$el\">\n\t\t\t\t<template #prepend>\n\t\t\t\t\t<div style=\"padding: .75rem .75rem .1rem .75rem; min-width: 12rem;\">\n\t\t\t\t\t\t<p style=\"margin: 0\">User Avatar</p>\n\t\t\t\t\t\t<span style=\"color: var(--q-theme-primary); font-size: .85rem;\">Administrator</span>\n\t\t\t\t\t</div>\n\t\t\t\t\t<q-divider />\n\t\t\t\t</template>\n\t\t\t</q-dropdown-menu>"
4228
4895
  }
4229
4896
  ]
4230
4897
  },
@@ -4317,10 +4984,10 @@
4317
4984
  {
4318
4985
  "name": "icons",
4319
4986
  "type": {
4320
- "kind": "object",
4321
- "fields": {}
4987
+ "kind": "unknown",
4988
+ "raw": "QIcons<\"warning\" | \"help\" | \"error\"> | undefined"
4322
4989
  },
4323
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.",
4990
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.",
4324
4991
  "default": "DEFAULT_ICONS",
4325
4992
  "required": false,
4326
4993
  "category": "Configuration"
@@ -4331,7 +4998,7 @@
4331
4998
  "kind": "object",
4332
4999
  "fields": {}
4333
5000
  },
4334
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.",
5001
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.",
4335
5002
  "default": "DEFAULT_TEXTS",
4336
5003
  "required": false,
4337
5004
  "category": "Configuration"
@@ -4381,7 +5048,7 @@
4381
5048
  "kind": "primitive",
4382
5049
  "name": "boolean"
4383
5050
  },
4384
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
5051
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
4385
5052
  "required": false,
4386
5053
  "category": "State"
4387
5054
  }
@@ -4416,6 +5083,10 @@
4416
5083
  "name": "errors",
4417
5084
  "description": ""
4418
5085
  },
5086
+ {
5087
+ "name": "warnings",
5088
+ "description": ""
5089
+ },
4419
5090
  {
4420
5091
  "name": "extras",
4421
5092
  "description": ""
@@ -4426,7 +5097,7 @@
4426
5097
  },
4427
5098
  {
4428
5099
  "name": "QFileUpload",
4429
- "description": "An image input field with drag and drop area for uploading files.",
5100
+ "description": "An image input field with drag and drop area for uploading files. ## Accessibility - The native file input is hidden. The Choose button is the keyboard path; it carries the field label and describes required / invalid state in text because a button cannot take `aria-required` or `aria-invalid`. - Drag and drop is an extra pointer path, not the only one (WCAG 2.5.7). Focus stays in the field after a file is chosen or the native dialog closes.",
4430
5101
  "meta": {
4431
5102
  "props": [
4432
5103
  {
@@ -4515,7 +5186,7 @@
4515
5186
  "kind": "object",
4516
5187
  "fields": {}
4517
5188
  },
4518
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
5189
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
4519
5190
  "default": "DEFAULT_ICONS",
4520
5191
  "required": false,
4521
5192
  "category": "Configuration"
@@ -4526,7 +5197,7 @@
4526
5197
  "kind": "object",
4527
5198
  "fields": {}
4528
5199
  },
4529
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.",
5200
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.",
4530
5201
  "default": "DEFAULT_TEXTS",
4531
5202
  "required": false,
4532
5203
  "category": "Configuration"
@@ -4576,7 +5247,7 @@
4576
5247
  "kind": "primitive",
4577
5248
  "name": "boolean"
4578
5249
  },
4579
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
5250
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
4580
5251
  "required": false,
4581
5252
  "category": "State"
4582
5253
  },
@@ -4622,6 +5293,10 @@
4622
5293
  "name": "errors",
4623
5294
  "description": ""
4624
5295
  },
5296
+ {
5297
+ "name": "warnings",
5298
+ "description": ""
5299
+ },
4625
5300
  {
4626
5301
  "name": "extras",
4627
5302
  "description": ""
@@ -4673,7 +5348,7 @@
4673
5348
  },
4674
5349
  {
4675
5350
  "name": "QFocusWrap",
4676
- "description": "Causes the focus on elements within to wrap.",
5351
+ "description": "Traps or hosts keyboard focus inside its contents while active. ## Accessibility - With `wrap` (default), Tab cycles inside. Without it, focus still moves in on activate and back on deactivate, but Tab can leave — the non-modal dialog pattern. - Use `initialFocus` / `focusWithinOnActivate` for entry, and `closingFocus` / `returnFocusOnDeactivate` for exit. Dialog builds on this.",
4677
5352
  "meta": {
4678
5353
  "props": [
4679
5354
  {
@@ -4697,6 +5372,17 @@
4697
5372
  "required": false,
4698
5373
  "category": "Behavior"
4699
5374
  },
5375
+ {
5376
+ "name": "wrap",
5377
+ "type": {
5378
+ "kind": "primitive",
5379
+ "name": "boolean"
5380
+ },
5381
+ "description": "Whether Tab wraps around inside the contents while active. Without it, the focus wrap still\nmoves focus in when it activates and back when it deactivates, but Tab can leave it, as in\na non-modal dialog. Defaults to true.",
5382
+ "default": "true",
5383
+ "required": false,
5384
+ "category": "Behavior"
5385
+ },
4700
5386
  {
4701
5387
  "name": "initialFocus",
4702
5388
  "type": {
@@ -4876,7 +5562,7 @@
4876
5562
  }
4877
5563
  ]
4878
5564
  },
4879
- "description": "Text or formatter used as the fallback display and as the current-value part\nof `aria-valuetext`. Set this when the `value` slot changes how the value\nshould be announced, because slot markup cannot be inferred reliably for\naccessibility. When provided, it is treated as complete current-value text,\nso the unit is not appended there automatically.",
5565
+ "description": "Text or formatter used as the fallback display and as the current-value part\nof `aria-valuetext`. Set this when the `value` slot changes how the value\nshould be announced, because slot markup cannot be inferred reliably for\naccessibility. When provided, it is treated as complete current-value text,\nso the unit is not appended there automatically.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written. The numbers\nthe gauge formats itself always read left to right.",
4880
5566
  "required": false,
4881
5567
  "category": "Content"
4882
5568
  },
@@ -4918,7 +5604,7 @@
4918
5604
  }
4919
5605
  ]
4920
5606
  },
4921
- "description": "Text or formatter used to describe the target value.",
5607
+ "description": "Text or formatter used to describe the target value.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written. The numbers\nthe gauge formats itself always read left to right.",
4922
5608
  "required": false,
4923
5609
  "category": "Content"
4924
5610
  },
@@ -4960,7 +5646,7 @@
4960
5646
  "kind": "primitive",
4961
5647
  "name": "string"
4962
5648
  },
4963
- "description": "Unit displayed next to the current value.",
5649
+ "description": "Unit displayed next to the current value, and after the target value.\n\nIn a right-to-left page, the unit reads in the direction of its first letter: `°C` as written,\nand a unit in Arabic or Hebrew right to left.",
4964
5650
  "required": false,
4965
5651
  "category": "Content"
4966
5652
  },
@@ -4991,7 +5677,7 @@
4991
5677
  "kind": "unknown",
4992
5678
  "raw": "((value: number) => string) | undefined"
4993
5679
  },
4994
- "description": "Formatter used for scale labels.",
5680
+ "description": "Formatter used for scale labels.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written. The numbers\nthe gauge formats itself always read left to right.",
4995
5681
  "required": false,
4996
5682
  "category": "Configuration"
4997
5683
  },
@@ -5040,6 +5726,16 @@
5040
5726
  "title": "Responsive Composition",
5041
5727
  "description": "Gauges remain responsive when composed into a KPI dashboard owned by the consumer.",
5042
5728
  "code": "<div class=\"q-gauge-story-grid\">\n\t\t\t\t<q-gauge\n\t\t\t\t\tv-for=\"item in items\"\n\t\t\t\t\t:key=\"item.label\"\n\t\t\t\t\t:model-value=\"item.value\"\n\t\t\t\t\t:label=\"item.label\"\n\t\t\t\t\t:target=\"item.target\"\n\t\t\t\t\t:unit=\"item.unit\"\n\t\t\t\t\t:ranges=\"performanceRanges\"\n\t\t\t\t\t:show-legend=\"false\"\n\t\t\t\t/>\n\t\t\t</div>"
5729
+ },
5730
+ {
5731
+ "title": "Right To Left",
5732
+ "description": "In a right-to-left page, the dial stays as it is, with the lowest value on the left, as a speedometer or a clock does; the label, the value and the legend around it read from the right. The numbers show as written (`-20`, not `20-`): on the scale, in the value and at the target, and so does the unit (`°C`, not `C°`), which reads in the direction of its first letter.",
5733
+ "code": "<div dir=\"rtl\" style=\"width: 20rem\">\n\t\t\t\t<q-gauge v-bind=\"args\" />\n\t\t\t</div>"
5734
+ },
5735
+ {
5736
+ "title": "Right To Left Formatted",
5737
+ "description": "In a right-to-left page, a tick label, value or target value the app formats reads in the direction of its first letter, so a number alone, such as `-20%`, reads as written.",
5738
+ "code": "<div dir=\"rtl\" style=\"width: 20rem\">\n\t\t\t\t<q-gauge v-bind=\"args\" />\n\t\t\t</div>"
5043
5739
  }
5044
5740
  ]
5045
5741
  },
@@ -5148,10 +5844,10 @@
5148
5844
  {
5149
5845
  "name": "icons",
5150
5846
  "type": {
5151
- "kind": "object",
5152
- "fields": {}
5847
+ "kind": "unknown",
5848
+ "raw": "QIcons<\"warning\" | \"help\" | \"error\"> | undefined"
5153
5849
  },
5154
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.",
5850
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.",
5155
5851
  "required": false,
5156
5852
  "category": "Configuration"
5157
5853
  },
@@ -5161,7 +5857,7 @@
5161
5857
  "kind": "object",
5162
5858
  "fields": {}
5163
5859
  },
5164
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.",
5860
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.",
5165
5861
  "required": false,
5166
5862
  "category": "Configuration"
5167
5863
  },
@@ -5260,7 +5956,7 @@
5260
5956
  "kind": "primitive",
5261
5957
  "name": "boolean"
5262
5958
  },
5263
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
5959
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
5264
5960
  "required": false,
5265
5961
  "category": "State"
5266
5962
  },
@@ -5331,6 +6027,10 @@
5331
6027
  "name": "errors",
5332
6028
  "description": ""
5333
6029
  },
6030
+ {
6031
+ "name": "warnings",
6032
+ "description": ""
6033
+ },
5334
6034
  {
5335
6035
  "name": "extras",
5336
6036
  "description": ""
@@ -5389,29 +6089,74 @@
5389
6089
  "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field aria-label=\"Search\" placeholder=\"Search\" />\n\t\t\t\t<template #append>\n\t\t\t\t\t<q-button aria-label=\"Search\">\n\t\t\t\t\t\t<q-icon icon=\"magnify\" />\n\t\t\t\t\t</q-button>\n\t\t\t\t\t<q-button aria-label=\"Settings\">\n\t\t\t\t\t\t<q-icon icon=\"cog\" />\n\t\t\t\t\t</q-button>\n\t\t\t\t</template>\n\t\t\t</q-input-group>"
5390
6090
  },
5391
6091
  {
5392
- "title": "Required",
5393
- "description": "Displays an asterisk next to the group label.",
5394
- "code": "<QInputGroup label=\"Full name\" :required=\"true\" />"
6092
+ "title": "Required",
6093
+ "description": "Displays an asterisk next to the group label.",
6094
+ "code": "<QInputGroup label=\"Full name\" :required=\"true\" />"
6095
+ },
6096
+ {
6097
+ "title": "Help",
6098
+ "description": "Help shown in a popover beside the group label.",
6099
+ "code": "<QInputGroup label=\"Full name\" help=\"As it appears on your ID\" :required=\"true\" />"
6100
+ },
6101
+ {
6102
+ "title": "Disabled",
6103
+ "description": "Disables the group and every control in it, buttons included. A control that sets its own `disabled` keeps it.",
6104
+ "code": "<QInputGroup :disabled=\"true\" />"
6105
+ },
6106
+ {
6107
+ "title": "Readonly",
6108
+ "description": "Makes every field in the group read-only, while its buttons stay enabled. A field that sets its own `readonly` keeps it.",
6109
+ "code": "<QInputGroup :readonly=\"true\" />"
6110
+ },
6111
+ {
6112
+ "title": "Invalid",
6113
+ "description": "Put the message in the group's `errors` slot and pass the fields the `invalid` and `describedBy` of the default slot. The group draws one danger shadow around all its parts, and its text and icon addons take the danger border with the fields. A button addon keeps its own.",
6114
+ "code": "<QInputGroup label=\"Email\" :prepend-icon=\"{\n\t\t\ticon: 'email'\n\t\t}\" :invalid=\"true\" />"
6115
+ },
6116
+ {
6117
+ "title": "Warning Message",
6118
+ "description": "A warning in the group's `warnings` slot draws the group's shadow and its addons' border in warning-dark, and leaves the fields valid.",
6119
+ "code": "<QInputGroup label=\"Email\" :prepend-icon=\"{\n\t\t\ticon: 'email'\n\t\t}\" />"
6120
+ },
6121
+ {
6122
+ "title": "Warning With Invalid Field",
6123
+ "description": "A field marked invalid on its own, in a group with a warning: the error wins, as it does in a field, so the group draws its shadow and its addons' border in danger.",
6124
+ "code": "<QInputGroup label=\"Email\" :prepend-icon=\"{\n\t\t\ticon: 'email'\n\t\t}\" />"
6125
+ },
6126
+ {
6127
+ "title": "Invalid With Nested Messages",
6128
+ "description": "The group's shadow wraps its control row alone: the labels of the nested fields above it and their messages under it stay outside.",
6129
+ "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<template #default=\"{ invalid }\">\n\t\t\t\t\t<q-text-field label=\"Name\" :invalid=\"invalid\">\n\t\t\t\t\t\t<template #errors>Enter your name</template>\n\t\t\t\t\t</q-text-field>\n\t\t\t\t\t<q-text-field label=\"Email\" :invalid=\"invalid\">\n\t\t\t\t\t\t<template #extras>We never share it</template>\n\t\t\t\t\t</q-text-field>\n\t\t\t\t</template>\n\t\t\t\t<template #errors>Enter a name and an email</template>\n\t\t\t</q-input-group>"
6130
+ },
6131
+ {
6132
+ "title": "Mixed Heights",
6133
+ "description": "Keeps sibling controls aligned when one child has a larger intrinsic height. An error under one field must not stretch the other controls into the message area.",
6134
+ "code": "<div>\n\t\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t\t<q-text-field aria-label=\"Name\" placeholder=\"Name\" />\n\t\t\t\t\t<q-text-area aria-label=\"Notes\" placeholder=\"Notes\" :rows=\"3\" />\n\t\t\t\t\t<q-date-time-picker\n\t\t\t\t\t\taria-label=\"Due date\"\n\t\t\t\t\t\tformat=\"dd/MM/yyyy\"\n\t\t\t\t\t\tplaceholder=\"Due date\" />\n\t\t\t\t\t<q-text-field\n\t\t\t\t\t\taria-label=\"Code\"\n\t\t\t\t\t\tplaceholder=\"Code\"\n\t\t\t\t\t\tsize=\"mini\"\n\t\t\t\t\t\tinvalid>\n\t\t\t\t\t\t<template #errors>\n\t\t\t\t\t\t\tThis error is long enough to wrap onto several lines in a narrow field\n\t\t\t\t\t\t</template>\n\t\t\t\t\t\t<template #warnings>Also a warning under the error</template>\n\t\t\t\t\t</q-text-field>\n\t\t\t\t\t<template #append>\n\t\t\t\t\t\t<q-button aria-label=\"Lookup\">\n\t\t\t\t\t\t\t<q-icon icon=\"format-list-bulleted\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t</template>\n\t\t\t\t</q-input-group>\n\t\t\t\t<p data-testid=\"after-group\">Next row</p>\n\t\t\t</div>"
6135
+ },
6136
+ {
6137
+ "title": "Sized Beside Block",
6138
+ "description": "A field with a size keeps it beside a field without one, as outside a group: the area code stays small and the number takes the rest of the group.",
6139
+ "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field aria-label=\"Area code\" size=\"small\" />\n\t\t\t\t<q-text-field aria-label=\"Number\" />\n\t\t\t</q-input-group>"
5395
6140
  },
5396
6141
  {
5397
- "title": "Help",
5398
- "description": "Help shown in a popover beside the group label.",
5399
- "code": "<QInputGroup label=\"Full name\" help=\"As it appears on your ID\" :required=\"true\" />"
6142
+ "title": "Labeled Controls",
6143
+ "description": "A field with a label of its own keeps it above the control row and its messages under it, so the addons and the other fields line up with its control. A checkbox with its label beside it sits in the control row. A checkbox or switch keeps its content width, labeled or not, and the text field takes the rest.",
6144
+ "code": "<div>\n\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field aria-label=\"Email\" invalid>\n\t\t\t\t\t<template #errors>Enter a valid email address</template>\n\t\t\t\t</q-text-field>\n\t\t\t\t<q-checkbox label=\"Weekly\" />\n\t\t\t\t<template #append>\n\t\t\t\t\t<q-button label=\"Subscribe\" />\n\t\t\t\t</template>\n\t\t\t</q-input-group>\n\t\t\t<q-input-group label=\"Search\">\n\t\t\t\t<q-text-field label=\"Query\" invalid>\n\t\t\t\t\t<template #errors>Enter at least three characters</template>\n\t\t\t\t</q-text-field>\n\t\t\t\t<q-text-field aria-label=\"Scope\" />\n\t\t\t\t<template #append>\n\t\t\t\t\t<q-button label=\"Go\" />\n\t\t\t\t</template>\n\t\t\t</q-input-group>\n\t\t\t<q-input-group label=\"Status\">\n\t\t\t\t<q-text-field aria-label=\"Name\" />\n\t\t\t\t<q-checkbox aria-label=\"Active\" />\n\t\t\t</q-input-group>\n\t\t\t</div>"
5400
6145
  },
5401
6146
  {
5402
- "title": "Disabled",
5403
- "description": "Disables the group and every control in it, buttons included. A control that sets its own `disabled` keeps it.",
5404
- "code": "<QInputGroup :disabled=\"true\" />"
6147
+ "title": "Nested Help",
6148
+ "description": "A nested field without a label shows its popover help button beside its control. The control fills the field's column, so the help button meets the next control with no gap.",
6149
+ "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field\n\t\t\t\t\taria-label=\"Code\"\n\t\t\t\t\thelp=\"Find the code in your welcome email\"\n\t\t\t\t\thelp-display=\"popover\" />\n\t\t\t\t<template #append>\n\t\t\t\t\t<q-button label=\"Apply\" />\n\t\t\t\t</template>\n\t\t\t</q-input-group>"
5405
6150
  },
5406
6151
  {
5407
- "title": "Readonly",
5408
- "description": "Makes every field in the group read-only, while its buttons stay enabled. A field that sets its own `readonly` keeps it.",
5409
- "code": "<QInputGroup :readonly=\"true\" />"
6152
+ "title": "Right To Left",
6153
+ "description": "In a right-to-left page the group starts on the right: the prepend sits there with the rounded corners, and neighbors share one border.",
6154
+ "code": "<div dir=\"rtl\">\n\t\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t\t<q-text-field aria-label=\"Address\" />\n\t\t\t\t\t<template #prepend>\n\t\t\t\t\t\t<span>https://</span>\n\t\t\t\t\t</template>\n\t\t\t\t\t<template #append>\n\t\t\t\t\t\t<span>.com</span>\n\t\t\t\t\t</template>\n\t\t\t\t</q-input-group>\n\t\t\t</div>"
5410
6155
  },
5411
6156
  {
5412
- "title": "Mixed Heights",
5413
- "description": "Keeps sibling controls aligned when one child has a larger intrinsic height.",
5414
- "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field aria-label=\"Name\" placeholder=\"Name\" />\n\t\t\t\t<q-text-area aria-label=\"Notes\" placeholder=\"Notes\" :rows=\"3\" />\n\t\t\t</q-input-group>"
6157
+ "title": "Narrow",
6158
+ "description": "In a narrow layout the field shrinks first, down to its content and the target size of its input, while the addon text and the button keep their whole width.",
6159
+ "code": "<div data-testid=\"container\">\n\t\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t\t<q-text-field aria-label=\"User\" />\n\t\t\t\t\t<template #append>\n\t\t\t\t\t\t<span>@example.com</span>\n\t\t\t\t\t\t<q-button label=\"Search\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-input-group>\n\t\t\t</div>"
5415
6160
  },
5416
6161
  {
5417
6162
  "title": "Advanced Usage",
@@ -5559,7 +6304,7 @@
5559
6304
  },
5560
6305
  {
5561
6306
  "name": "QList",
5562
- "description": "A list of items, allowing the user to select one or more of them.",
6307
+ "description": "A list of items, allowing the user to select one or more of them. ## Accessibility - Default role is `listbox` with `option` items. Pass `role=\"menu\"` (as DropdownMenu does) for action items (`menuitem`); a menu never selects a value and always uses the `list` layout. - Provide `label` (or an accessible name from the owner) so the listbox / menu is named. - In `grid` layout, arrows follow the tile grid; menus stay a vertical list.",
5563
6308
  "meta": {
5564
6309
  "props": [
5565
6310
  {
@@ -5596,16 +6341,6 @@
5596
6341
  "required": false,
5597
6342
  "category": "Presentation"
5598
6343
  },
5599
- {
5600
- "name": "modelValue",
5601
- "type": {
5602
- "kind": "unknown",
5603
- "raw": "any"
5604
- },
5605
- "description": "The value of the selected item.",
5606
- "required": false,
5607
- "category": "Content"
5608
- },
5609
6344
  {
5610
6345
  "name": "highlighted",
5611
6346
  "type": {
@@ -5729,20 +6464,29 @@
5729
6464
  {
5730
6465
  "name": "icons",
5731
6466
  "type": {
5732
- "kind": "object",
5733
- "fields": {}
6467
+ "kind": "unknown",
6468
+ "raw": "QIcons<\"check\" | \"description\"> | undefined"
5734
6469
  },
5735
6470
  "description": "Custom icon configurations, used by every item. Includes the check mark and description icons.\nPass every key, or omit the prop to keep the defaults.",
5736
6471
  "default": "DEFAULT_ICONS",
5737
6472
  "required": false,
5738
6473
  "category": "Configuration"
6474
+ },
6475
+ {
6476
+ "name": "modelValue",
6477
+ "type": {
6478
+ "kind": "unknown",
6479
+ "raw": "any"
6480
+ },
6481
+ "description": "",
6482
+ "required": false
5739
6483
  }
5740
6484
  ],
5741
6485
  "events": [
5742
6486
  {
5743
6487
  "name": "update:modelValue",
5744
6488
  "description": "",
5745
- "type": "[val: any]"
6489
+ "type": "[value: any]"
5746
6490
  },
5747
6491
  {
5748
6492
  "name": "click",
@@ -5803,19 +6547,49 @@
5803
6547
  },
5804
6548
  {
5805
6549
  "title": "Selectable",
5806
- "description": "Allows the user to select items from the list.",
6550
+ "description": "Allows the user to select items from the list. The check of the selected item centers on the capitals of its label, raised by the optical lift, as a checkbox's box does next to its label.",
5807
6551
  "code": "<QList :items=\"[\n\t\t\t{ key: 'item1', label: 'Item 1' },\n\t\t\t{ key: 'item2', label: 'Item 2' },\n\t\t\t{ key: 'item3', label: 'Item 3' }\n\t\t]\" :selectable=\"true\" />"
5808
6552
  },
6553
+ {
6554
+ "title": "Selectable Font Icon",
6555
+ "description": "A check an app sets as a font icon. Its font is the icon size, so its own capitals are not the label's: the line that holds it moves, in the label's font, so it centers on the label's capitals as the default check does.",
6556
+ "code": "<QList :icons=\"{ ...DEFAULT_ICONS, check: { icon: 'check', type: 'font' } }\" />"
6557
+ },
6558
+ {
6559
+ "title": "Selectable Sized Check",
6560
+ "description": "A check an app sets at a size of its own (`icons.check.size`, in rem), as an SVG and as a font icon: the option keeps room for it at that size, so a label that fills the row stops before it.",
6561
+ "code": "<div style=\"width: 15rem\">\n\t\t\t\t<q-list v-bind=\"args\" :icons=\"svg\" />\n\t\t\t\t<q-list v-bind=\"args\" :icons=\"font\" />\n\t\t\t</div>"
6562
+ },
5809
6563
  {
5810
6564
  "title": "Multiple",
5811
6565
  "description": "Allows the user to select items from the list.",
5812
6566
  "code": "<QList :items=\"[\n\t\t\t{ key: 'item1', label: 'Item 1' },\n\t\t\t{ key: 'item2', label: 'Item 2' },\n\t\t\t{ key: 'item3', label: 'Item 3' }\n\t\t]\" :multiple=\"true\" />"
5813
6567
  },
6568
+ {
6569
+ "title": "Multiple Wrapping Label",
6570
+ "description": "A label longer than its row wraps, and the box stays beside its first line: the box's line keeps its width, so the box never wraps under it.",
6571
+ "code": "<div style=\"width: 12.5rem\">\n\t\t\t\t<q-list v-bind=\"args\" />\n\t\t\t</div>"
6572
+ },
5814
6573
  {
5815
6574
  "title": "Multiple With Description",
5816
6575
  "description": "Allows the user to select items from the list with icons.",
5817
6576
  "code": "<QList :items=\"[\n\t\t\t{\n\t\t\t\ticon: { icon: 'content-copy' },\n\t\t\t\tkey: 'item1',\n\t\t\t\tlabel: 'Item 1',\n\t\t\t\tdescription: 'Description for items'\n\t\t\t},\n\t\t\t{\n\t\t\t\ticon: { icon: 'content-duplicate' },\n\t\t\t\tkey: 'item2',\n\t\t\t\tlabel: 'Item 2',\n\t\t\t\tdescription: 'This item is nice :)'\n\t\t\t},\n\t\t\t{\n\t\t\t\ticon: { icon: 'content-paste' },\n\t\t\t\tkey: 'item3',\n\t\t\t\tlabel: 'Item 3',\n\t\t\t\tdescription: 'This is a description for this item'\n\t\t\t}\n\t\t]\" :multiple=\"true\" />"
5818
6577
  },
6578
+ {
6579
+ "title": "Multiple Tall Append",
6580
+ "description": "A row taller than its label for another reason, such as an avatar after the label (`item.append`): the label centers in the row, and the box stays beside it.",
6581
+ "code": "<q-list v-bind=\"args\">\n\t\t\t\t<template #item.append=\"{ item }\">\n\t\t\t\t\t<q-avatar :initials=\"item.label.split(' ').map((name) => name[0]).join('')\" />\n\t\t\t\t</template>\n\t\t\t</q-list>"
6582
+ },
6583
+ {
6584
+ "title": "Multiple Short Line",
6585
+ "description": "A line an app makes shorter than the box (`--q-line-height-md`), above a description: the label is the first line of the row, and the box stays beside it.",
6586
+ "code": "<div style=\"--q-line-height-md: 1rem\">\n\t\t\t\t<q-list v-bind=\"args\" />\n\t\t\t</div>"
6587
+ },
6588
+ {
6589
+ "title": "Multiple Right To Left",
6590
+ "description": "A list in a right-to-left page: the box is at the left end of the option, in the room the option keeps for it, and a label that fills the row stops before it.",
6591
+ "code": "<div dir=\"rtl\" style=\"width: 12.5rem\">\n\t\t\t\t<q-list v-bind=\"args\" />\n\t\t\t</div>"
6592
+ },
5819
6593
  {
5820
6594
  "title": "Selectable And Required",
5821
6595
  "description": "Allows the user to select items from the list and requires at least one item to be selected.",
@@ -5863,8 +6637,13 @@
5863
6637
  },
5864
6638
  {
5865
6639
  "title": "Highlighted",
5866
- "description": "The option the keyboard is on in a list that keeps focus elsewhere, as `QSelect` and `QCombobox` drive it (`highlighted`), shows the focus ring, and the selected one keeps its tint without it.",
5867
- "code": "<QList :items=\"[\n\t\t\t{ key: 'item1', label: 'Item 1' },\n\t\t\t{ key: 'item2', label: 'Item 2' },\n\t\t\t{ key: 'item3', label: 'Item 3' }\n\t\t]\" :selectable=\"true\" model-value=\"item3\" highlighted=\"item2\" />"
6640
+ "description": "The option the keyboard is on in a list that keeps focus elsewhere, as `QCombobox` and `QDropdownMenu` drive it (`highlighted`), shows the focus ring, and the selected one keeps its tint without it. Focus stays in the field, whose Up and Down arrows move the highlight, and the field points `aria-activedescendant` at the highlighted option.",
6641
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-text-field\n\t\t\t\t\tlabel=\"Item\"\n\t\t\t\t\trole=\"combobox\"\n\t\t\t\t\taria-expanded=\"true\"\n\t\t\t\t\t:aria-controls=\"args.id\"\n\t\t\t\t\t:aria-activedescendant=\"activeId\"\n\t\t\t\t\t@keydown=\"onKeydown\" />\n\t\t\t\t<q-list\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\tref=\"list\"\n\t\t\t\t\t:highlighted=\"highlighted\" />\n\t\t\t</div>"
6642
+ },
6643
+ {
6644
+ "title": "Item Append",
6645
+ "description": "The `item.append` slot adds content at the end of each item, such as a count and a chevron. An item is named by its label alone, which replaces its content, so screen readers read the count only through the item's `ariaDescribedby`, which points at the badge. Words only screen readers need, such as what the number counts, go in the badge as `.q-sr-only` text.",
6646
+ "code": "<q-list\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tstyle=\"max-width: 20rem;\">\n\t\t\t\t<template #item.append=\"{ item }\">\n\t\t\t\t\t<q-badge\n\t\t\t\t\t\t:id=\"item.ariaDescribedby\"\n\t\t\t\t\t\tcolor=\"info\">\n\t\t\t\t\t\t{{ item.count }}<span class=\"q-sr-only\"> open tickets</span>\n\t\t\t\t\t</q-badge>\n\t\t\t\t\t<q-icon icon=\"chevron-right\" />\n\t\t\t\t</template>\n\t\t\t</q-list>"
5868
6647
  },
5869
6648
  {
5870
6649
  "title": "Keyboard Navigation",
@@ -5948,7 +6727,7 @@
5948
6727
  }
5949
6728
  ]
5950
6729
  },
5951
- "description": "Label to display next to the meter value.",
6730
+ "description": "Label to display next to the meter value.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written.",
5952
6731
  "required": false,
5953
6732
  "category": "Content"
5954
6733
  },
@@ -6003,12 +6782,17 @@
6003
6782
  "title": "Semantic",
6004
6783
  "description": "The meter bar color can be used to convey semantic meaning, such as status or severity.",
6005
6784
  "code": "<QMeter :model-value=\"75\" :max=\"100\" color=\"success\" label=\"Storage\" :value-label=\"(value: number, max: number) => `${value} GB available of ${max} GB`\" />"
6785
+ },
6786
+ {
6787
+ "title": "Right To Left",
6788
+ "description": "In a right-to-left page, the meter fills from the right, where the line starts, and its value, a text the app formats, reads in the direction of its first letter: `-5 °C` as written.",
6789
+ "code": "<div dir=\"rtl\" style=\"width: 20rem\">\n\t\t\t\t<q-meter v-bind=\"args\" />\n\t\t\t</div>"
6006
6790
  }
6007
6791
  ]
6008
6792
  },
6009
6793
  {
6010
6794
  "name": "QObfuscation",
6011
- "description": "Permission-based data obfuscation for consulta / sensitive fields. - No permission: plain \"Restricted\" (or bullets) — no action. - Can reveal: a padlock toggles the value. When revealed, either: - place scoped-slot `qObfuscationHideAction` on the field's `label.append` (QObfuscation then hides its own label/padlock), or - omit it and QObfuscation keeps its label with the hide padlock. - Set `loading` while fetching on reveal (before the value becomes visible).",
6795
+ "description": "Permission-based data obfuscation for consulta / sensitive fields. - No permission: plain \"Restricted\" (or bullets) — no action. - Can reveal: a padlock toggles the value. When revealed, either: - place scoped-slot `qObfuscationHideAction` on the field's `label.append` (QObfuscation then hides its own label/padlock), or - omit it and QObfuscation keeps its label with the hide padlock. - Set `hideable: false` to reveal for good: no hide control, and the value stays shown until the app sets `revealed` back to false. - Set `loading` while fetching on reveal (before the value becomes visible).",
6012
6796
  "meta": {
6013
6797
  "props": [
6014
6798
  {
@@ -6099,7 +6883,7 @@
6099
6883
  "kind": "object",
6100
6884
  "fields": {}
6101
6885
  },
6102
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
6886
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
6103
6887
  "default": "DEFAULT_ICONS",
6104
6888
  "required": false,
6105
6889
  "category": "Configuration"
@@ -6110,7 +6894,7 @@
6110
6894
  "kind": "object",
6111
6895
  "fields": {}
6112
6896
  },
6113
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.",
6897
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.",
6114
6898
  "default": "DEFAULT_TEXTS",
6115
6899
  "required": false,
6116
6900
  "category": "Configuration"
@@ -6160,7 +6944,7 @@
6160
6944
  "kind": "primitive",
6161
6945
  "name": "boolean"
6162
6946
  },
6163
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
6947
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
6164
6948
  "required": false,
6165
6949
  "category": "State"
6166
6950
  },
@@ -6175,6 +6959,17 @@
6175
6959
  "required": false,
6176
6960
  "category": "Behavior"
6177
6961
  },
6962
+ {
6963
+ "name": "hideable",
6964
+ "type": {
6965
+ "kind": "primitive",
6966
+ "name": "boolean"
6967
+ },
6968
+ "description": "When false, a revealed value stays revealed: no hide button shows, `QObfuscationHideAction`\nrenders none, and the slot's `toggle` does not hide it. The app can still hide it by setting\n`revealed` to false. Has no effect unless `revealable`.",
6969
+ "default": "true",
6970
+ "required": false,
6971
+ "category": "Behavior"
6972
+ },
6178
6973
  {
6179
6974
  "name": "loading",
6180
6975
  "type": {
@@ -6264,6 +7059,10 @@
6264
7059
  "name": "errors",
6265
7060
  "description": ""
6266
7061
  },
7062
+ {
7063
+ "name": "warnings",
7064
+ "description": ""
7065
+ },
6267
7066
  {
6268
7067
  "name": "extras",
6269
7068
  "description": ""
@@ -6291,6 +7090,11 @@
6291
7090
  "description": "Allow reveal — value shown with an open padlock on the slotted field label.",
6292
7091
  "code": "<q-obfuscation\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model:revealed=\"revealed\"\n\t\t\t\tv-slot=\"{ qObfuscationHideAction }\">\n\t\t\t\t<q-text-field :label=\"args.label\" v-model=\"value\">\n\t\t\t\t\t<template #label.append>\n\t\t\t\t\t\t<component :is=\"qObfuscationHideAction\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-text-field>\n\t\t\t</q-obfuscation>"
6293
7092
  },
7093
+ {
7094
+ "title": "Reveal Only",
7095
+ "description": "Reveal only — `hideable: false` shows no hide button once the value is revealed. The field still places `qObfuscationHideAction`, which then draws no button but leaves the field's label as the only one. Focus moves to the field, since the button that had it is gone. Only the app can mask the value again, by setting `revealed` to false: \"Mask again\" does that, and restores the value.",
7096
+ "code": "<div style=\"display: flex; flex-direction: column; align-items: flex-start; gap: 1rem;\">\n\t\t\t\t<q-obfuscation\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\tv-model:revealed=\"revealed\"\n\t\t\t\t\tv-slot=\"{ qObfuscationHideAction }\">\n\t\t\t\t\t<q-text-field v-model=\"value\" :label=\"args.label\">\n\t\t\t\t\t\t<template #label.append>\n\t\t\t\t\t\t\t<component :is=\"qObfuscationHideAction\" />\n\t\t\t\t\t\t</template>\n\t\t\t\t\t</q-text-field>\n\t\t\t\t</q-obfuscation>\n\t\t\t\t<q-button\n\t\t\t\t\tlabel=\"Mask again\"\n\t\t\t\t\t@click=\"reset\" />\n\t\t\t</div>"
7097
+ },
6294
7098
  {
6295
7099
  "title": "Revealable Text Field",
6296
7100
  "description": "Editable text field gated behind the padlock control.",
@@ -6471,8 +7275,8 @@
6471
7275
  {
6472
7276
  "name": "icons",
6473
7277
  "type": {
6474
- "kind": "object",
6475
- "fields": {}
7278
+ "kind": "unknown",
7279
+ "raw": "QIcons<\"back\" | \"forward\" | \"up\" | \"down\"> | undefined"
6476
7280
  },
6477
7281
  "description": "Custom icon configurations for navigation controls.\n\nIcons are chosen from physical `direction` (left/right or up/down), not document\n`dir` / writing mode. Logical start/end and RTL-aware chevrons are a follow-up.",
6478
7282
  "default": "DEFAULT_ICONS",
@@ -6485,7 +7289,7 @@
6485
7289
  "kind": "object",
6486
7290
  "fields": {}
6487
7291
  },
6488
- "description": "Custom accessible strings for navigation controls.\n\nOptional `regionLabel` opts into a named landmark (`role=\"region\"` + `aria-label`).\nOmit it (the default) for a plain root — avoids N generic landmarks and an invalid\nunnamed `region`.",
7292
+ "description": "Custom accessible strings for navigation controls.\n\nOptional `regionLabel` opts into a named landmark (`role=\"region\"` + `aria-label`) and\nnames the scroll area while it is a Tab stop. Set it when the content takes no focus, such\nas text or images: the scroll area is then a Tab stop while it overflows, so the keyboard can\nscroll it, and without a name it says nothing to a screen reader. Omit it (the default) when\nthe content takes focus (tabs, buttons), which avoids N generic landmarks and an invalid\nunnamed `region`.",
6489
7293
  "default": "DEFAULT_TEXTS",
6490
7294
  "required": false,
6491
7295
  "category": "Configuration"
@@ -6543,16 +7347,26 @@
6543
7347
  "description": "Custom previous and next controls via slots.",
6544
7348
  "code": "<div :style=\"horizontalHostStyle\">\n\t\t\t\t<q-overflow v-bind=\"args\">\n\t\t\t\t\t<template #prev=\"{ disabled, onClick }\">\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\tlabel=\"Back\"\n\t\t\t\t\t\t\t:disabled=\"disabled\"\n\t\t\t\t\t\t\t@click=\"onClick\" />\n\t\t\t\t\t</template>\n\n\t\t\t\t\t<div :style=\"horizontalStripStyle\">\n\t\t\t\t\t\t<div\n\t\t\t\t\t\t\tv-for=\"item in demoItems\"\n\t\t\t\t\t\t\t:key=\"item\"\n\t\t\t\t\t\t\t:style=\"horizontalItemStyle\">\n\t\t\t\t\t\t\t{{ item }}\n\t\t\t\t\t\t</div>\n\t\t\t\t\t</div>\n\n\t\t\t\t\t<template #next=\"{ disabled, onClick }\">\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\tlabel=\"Next\"\n\t\t\t\t\t\t\t:disabled=\"disabled\"\n\t\t\t\t\t\t\t@click=\"onClick\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-overflow>\n\t\t\t</div>"
6545
7349
  },
7350
+ {
7351
+ "title": "Region Label",
7352
+ "description": "A strip of content that takes no focus, such as text or images, is a Tab stop while it overflows, so the keyboard can scroll it. Name it with `texts.regionLabel`: the strip becomes a named region, and the scroll area a group with the same name, which screen readers read when it takes focus. Without a name, it is a Tab stop that says nothing.",
7353
+ "code": "<QOverflow :texts=\"{ back: 'Previous', forward: 'Next', regionLabel: 'Recent files' }\" />"
7354
+ },
6546
7355
  {
6547
7356
  "title": "Without Overflow",
6548
7357
  "description": "When content fits the viewport, navigation arrows are omitted.",
6549
7358
  "code": "<div :style=\"horizontalHostStyle\">\n\t\t\t\t<q-overflow v-bind=\"args\">\n\t\t\t\t\t<div :style=\"horizontalStripStyle\">\n\t\t\t\t\t\t<div :style=\"horizontalItemStyle\">Fits</div>\n\t\t\t\t\t\t<div :style=\"horizontalItemStyle\">Here</div>\n\t\t\t\t\t</div>\n\t\t\t\t</q-overflow>\n\t\t\t</div>"
7359
+ },
7360
+ {
7361
+ "title": "Focusable Items",
7362
+ "description": "Items that take focus, such as buttons: Tab goes from item to item, and each one scrolls into view as it takes focus, clear of the edge fade. The viewport is then no Tab stop of its own, since the items already scroll it. Without items that take focus, the viewport is a Tab stop while it overflows, so the keyboard can scroll it (see **Default**).",
7363
+ "code": "<div :style=\"horizontalHostStyle\">\n\t\t\t\t<q-overflow v-bind=\"args\">\n\t\t\t\t\t<div :style=\"[horizontalStripStyle, 'gap: 0.5rem; padding: 0.25rem']\">\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tv-for=\"item in demoItems\"\n\t\t\t\t\t\t\t:key=\"item\"\n\t\t\t\t\t\t\t:label=\"item\" />\n\t\t\t\t\t</div>\n\t\t\t\t</q-overflow>\n\t\t\t</div>"
6550
7364
  }
6551
7365
  ]
6552
7366
  },
6553
7367
  {
6554
7368
  "name": "QOverlay",
6555
- "description": "A generic overlay for creating floating elements.",
7369
+ "description": "A generic overlay for creating floating elements. ## Accessibility - With an underlay (modal-style overlay), the content gets `role=\"dialog\"`. Pair that with `focusWrap` when Tab should stay inside; without the trap, Tab can leave (same split as Dialog). Prefer Dialog when you need the full dialog chrome. - Escape still dismisses a `persistent` overlay so it stays keyboard-closable. `scrollLock` blocks page scroll while open. - Anchored overlays (menus, popovers) omit the dialog role: the owner supplies the popup semantics (`listbox`, `menu`, and so on).",
6556
7370
  "meta": {
6557
7371
  "props": [
6558
7372
  {
@@ -6565,16 +7379,6 @@
6565
7379
  "required": false,
6566
7380
  "category": "Identification"
6567
7381
  },
6568
- {
6569
- "name": "modelValue",
6570
- "type": {
6571
- "kind": "primitive",
6572
- "name": "boolean"
6573
- },
6574
- "description": "The value of the selected item.",
6575
- "required": false,
6576
- "category": "Content"
6577
- },
6578
7382
  {
6579
7383
  "name": "anchor",
6580
7384
  "type": {
@@ -6900,13 +7704,28 @@
6900
7704
  "default": "true",
6901
7705
  "required": false,
6902
7706
  "category": "Behavior"
7707
+ },
7708
+ {
7709
+ "name": "modelValue",
7710
+ "type": {
7711
+ "kind": "primitive",
7712
+ "name": "boolean"
7713
+ },
7714
+ "description": "",
7715
+ "default": "false",
7716
+ "required": false
6903
7717
  }
6904
7718
  ],
6905
7719
  "events": [
6906
7720
  {
6907
7721
  "name": "update:modelValue",
6908
7722
  "description": "",
6909
- "type": "[val: boolean]"
7723
+ "type": "[value: boolean]"
7724
+ },
7725
+ {
7726
+ "name": "after-leave",
7727
+ "description": "",
7728
+ "type": "[]"
6910
7729
  },
6911
7730
  {
6912
7731
  "name": "enter",
@@ -6965,7 +7784,7 @@
6965
7784
  "kind": "object",
6966
7785
  "fields": {}
6967
7786
  },
6968
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the clear button and the help button.\nPass every key, or omit the prop to keep the defaults.",
7787
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the clear button and the help button.\nPass every key, or omit the prop to keep the defaults.",
6969
7788
  "default": "DEFAULT_ICONS",
6970
7789
  "required": false,
6971
7790
  "category": "Configuration"
@@ -7084,7 +7903,7 @@
7084
7903
  "kind": "primitive",
7085
7904
  "name": "boolean"
7086
7905
  },
7087
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
7906
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
7088
7907
  "required": false,
7089
7908
  "category": "State"
7090
7909
  },
@@ -7229,6 +8048,10 @@
7229
8048
  "name": "errors",
7230
8049
  "description": ""
7231
8050
  },
8051
+ {
8052
+ "name": "warnings",
8053
+ "description": ""
8054
+ },
7232
8055
  {
7233
8056
  "name": "extras",
7234
8057
  "description": ""
@@ -7374,7 +8197,7 @@
7374
8197
  "kind": "object",
7375
8198
  "fields": {}
7376
8199
  },
7377
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the country selector and the clear button.\nPass every key, or omit the prop to keep the defaults.",
8200
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the country selector and the clear button.\nPass every key, or omit the prop to keep the defaults.",
7378
8201
  "default": "DEFAULT_ICONS",
7379
8202
  "required": false,
7380
8203
  "category": "Configuration"
@@ -7385,7 +8208,7 @@
7385
8208
  "kind": "object",
7386
8209
  "fields": {}
7387
8210
  },
7388
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the texts of the country selector and the clear button.\nPass every key, or omit the prop to keep the defaults.",
8211
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the texts of the country selector and the clear button.\nPass every key, or omit the prop to keep the defaults.",
7389
8212
  "default": "DEFAULT_TEXTS",
7390
8213
  "required": false,
7391
8214
  "category": "Configuration"
@@ -7434,7 +8257,7 @@
7434
8257
  "kind": "primitive",
7435
8258
  "name": "boolean"
7436
8259
  },
7437
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
8260
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
7438
8261
  "required": false,
7439
8262
  "category": "State"
7440
8263
  },
@@ -8325,9 +9148,13 @@
8325
9148
  "name": "errors",
8326
9149
  "description": "The app's error message, shown under the field while `invalid` is true, in place of the\nfield's own message from `autoValidate`."
8327
9150
  },
9151
+ {
9152
+ "name": "warnings",
9153
+ "description": "A warning about the value, shown under the field, after the error, whenever it renders."
9154
+ },
8328
9155
  {
8329
9156
  "name": "extras",
8330
- "description": "Other content under the field, after the error and the help."
9157
+ "description": "Other content under the field, after the error, the warning and the help."
8331
9158
  }
8332
9159
  ]
8333
9160
  },
@@ -8376,6 +9203,11 @@
8376
9203
  "title": "Invalid",
8377
9204
  "description": "Combines an application-provided invalid state with the component validation styling. The app's message, in the `errors` slot, takes the place of the field's own while `invalid` is true.",
8378
9205
  "code": "<q-phone-field v-bind=\"args\">\n\t\t\t\t<template #errors>This number is already registered</template>\n\t\t\t</q-phone-field>"
9206
+ },
9207
+ {
9208
+ "title": "Open On Selection",
9209
+ "description": "The country list open on the selected country, which shows its check mark next to its calling code. The play leaves the list open, so the story checks measure the options, the check mark among them.",
9210
+ "code": "<QPhoneField label=\"Phone number\" />"
8379
9211
  }
8380
9212
  ]
8381
9213
  },
@@ -8408,7 +9240,7 @@
8408
9240
  }
8409
9241
  ]
8410
9242
  },
8411
- "description": "The DOM element the popover should be anchored to.",
9243
+ "description": "The DOM element the popover should be anchored to. It takes the states of a button that\nopens a dialog (`aria-haspopup`, `aria-expanded` and, while the popover is open,\n`aria-controls`), and names a popover that has no title and no `aria-label` or\n`aria-labelledby` of its own: an anchor with no `id` gets one while it is the anchor.",
8412
9244
  "required": true,
8413
9245
  "category": "Identification"
8414
9246
  },
@@ -8438,7 +9270,7 @@
8438
9270
  "kind": "primitive",
8439
9271
  "name": "number"
8440
9272
  },
8441
- "description": "The heading level of the title of the popover.",
9273
+ "description": "The heading level of the title. The title heads a window of its own, outside the heading\noutline of the page, so it is an `h2` by default: set this only for an app that wants another\nlevel. A value outside 1–6 renders the title in a plain `div`. Defaults to 2.",
8442
9274
  "default": "2",
8443
9275
  "required": false,
8444
9276
  "category": "Content"
@@ -8559,7 +9391,7 @@
8559
9391
  "examples": [
8560
9392
  {
8561
9393
  "title": "Default",
8562
- "description": "Displays the popover to the right of the element.",
9394
+ "description": "Displays the popover to the right of the element. With no title, the button that opens it names it, and says it opens a dialog, whether it is open, and which one.",
8563
9395
  "code": "<q-button ref=\"anchor\" label=\"Click me\" />\n <q-popover v-bind=\"args\" :anchor=\"anchor?.$el\" />"
8564
9396
  },
8565
9397
  {
@@ -8645,7 +9477,7 @@
8645
9477
  "kind": "primitive",
8646
9478
  "name": "string"
8647
9479
  },
8648
- "description": "Text displayed in the progress bar.\nNot shown if the 'mini' prop is true.",
9480
+ "description": "Text displayed in the progress bar.\nNot shown if the 'mini' prop is true.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written.",
8649
9481
  "required": false,
8650
9482
  "category": "Content"
8651
9483
  },
@@ -8803,6 +9635,16 @@
8803
9635
  "description": "Animated solid fill — sheen sweeps across the bar (no stripes required).",
8804
9636
  "code": "<q-progress v-bind=\"args\" />"
8805
9637
  },
9638
+ {
9639
+ "title": "Animated At Any Value",
9640
+ "description": "The sheen is the same size and moves at the same speed whatever the value: it sweeps along the track, and the fill shows the part that crosses it. On a short fill it passes quickly, on a long one it stays longer.",
9641
+ "code": "<div style=\"display: grid; gap: 1rem; width: 20rem\">\n\t\t\t\t<q-progress v-bind=\"args\" label=\"Short\" :model-value=\"20\" />\n\t\t\t\t<q-progress v-bind=\"args\" label=\"Long\" :model-value=\"80\" />\n\t\t\t</div>"
9642
+ },
9643
+ {
9644
+ "title": "Animated Value Change",
9645
+ "description": "A value that changes moves the fill over a short transition, and the sheen stays half the track at every frame of it, whether the bar advances or starts again from a lower value.",
9646
+ "code": "<div style=\"display: grid; gap: 1rem; width: 20rem\">\n\t\t\t\t<q-progress v-bind=\"args\" label=\"Upload\" :model-value=\"value\" />\n\t\t\t\t<div style=\"display: flex; gap: 0.5rem\">\n\t\t\t\t\t<q-button label=\"Advance\" @click=\"value = 80\" />\n\t\t\t\t\t<q-button label=\"Restart\" @click=\"value = 10\" />\n\t\t\t\t</div>\n\t\t\t</div>"
9647
+ },
8806
9648
  {
8807
9649
  "title": "Animated Striped",
8808
9650
  "description": "Displays an animated, striped progress bar.",
@@ -8817,6 +9659,11 @@
8817
9659
  "title": "With Limits And Percent",
8818
9660
  "description": "Displays the current percent along with the min and max limits.",
8819
9661
  "code": "<q-progress v-bind=\"args\" />"
9662
+ },
9663
+ {
9664
+ "title": "Right To Left",
9665
+ "description": "In a right-to-left page, the bar fills from the right, where the line starts: the sheen sweeps and the stripes move from right to left, and the numbers show as written (`-10`, not `10-`). A text the app passes reads in the direction of its first letter.",
9666
+ "code": "<div dir=\"rtl\" style=\"display: grid; gap: 1rem; width: 20rem\">\n\t\t\t\t<q-progress v-bind=\"args\" label=\"Temperature\" />\n\t\t\t\t<q-progress :model-value=\"25\" label=\"Outside\" text=\"-5 °C\" />\n\t\t\t\t<q-progress :model-value=\"33\" label=\"Still\" striped />\n\t\t\t</div>"
8820
9667
  }
8821
9668
  ]
8822
9669
  },
@@ -8920,8 +9767,8 @@
8920
9767
  {
8921
9768
  "name": "icons",
8922
9769
  "type": {
8923
- "kind": "object",
8924
- "fields": {}
9770
+ "kind": "unknown",
9771
+ "raw": "QIcons<\"close\" | \"open\"> | undefined"
8925
9772
  },
8926
9773
  "description": "Custom icon configurations.",
8927
9774
  "default": "DEFAULT_ICONS",
@@ -9010,10 +9857,10 @@
9010
9857
  {
9011
9858
  "name": "icons",
9012
9859
  "type": {
9013
- "kind": "object",
9014
- "fields": {}
9860
+ "kind": "unknown",
9861
+ "raw": "QIcons<\"warning\" | \"help\" | \"error\"> | undefined"
9015
9862
  },
9016
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.",
9863
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.",
9017
9864
  "required": false,
9018
9865
  "category": "Configuration"
9019
9866
  },
@@ -9023,7 +9870,7 @@
9023
9870
  "kind": "object",
9024
9871
  "fields": {}
9025
9872
  },
9026
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.",
9873
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.",
9027
9874
  "required": false,
9028
9875
  "category": "Configuration"
9029
9876
  },
@@ -9124,7 +9971,7 @@
9124
9971
  "kind": "primitive",
9125
9972
  "name": "boolean"
9126
9973
  },
9127
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
9974
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
9128
9975
  "required": false,
9129
9976
  "category": "State"
9130
9977
  },
@@ -9177,17 +10024,6 @@
9177
10024
  "required": false,
9178
10025
  "category": "Behavior"
9179
10026
  },
9180
- {
9181
- "name": "hasFocusOutline",
9182
- "type": {
9183
- "kind": "primitive",
9184
- "name": "boolean"
9185
- },
9186
- "description": "Indicates whether the control will have an outline when focused.",
9187
- "default": "true",
9188
- "required": false,
9189
- "category": "Behavior"
9190
- },
9191
10027
  {
9192
10028
  "name": "modelValue",
9193
10029
  "type": {
@@ -9214,6 +10050,10 @@
9214
10050
  "name": "errors",
9215
10051
  "description": ""
9216
10052
  },
10053
+ {
10054
+ "name": "warnings",
10055
+ "description": ""
10056
+ },
9217
10057
  {
9218
10058
  "name": "extras",
9219
10059
  "description": ""
@@ -9238,8 +10078,8 @@
9238
10078
  },
9239
10079
  {
9240
10080
  "title": "Readonly",
9241
- "description": "A read-only radio button group that displays a fixed selection.",
9242
- "code": "<q-radio-group v-bind=\"args\">\n\t\t\t\t<q-radio-button label=\"Red\" value=\"red\" />\n\t\t\t\t<q-radio-button label=\"Blue\" value=\"blue\" />\n\t\t\t\t<q-radio-button label=\"Green\" value=\"green\" />\n\t\t\t</q-radio-group>"
10081
+ "description": "A read-only radio button group that displays a fixed selection. Shown in the light and the dark theme, where its circles stand out in each.",
10082
+ "code": "<QRadioGroup model-value=\"blue\" label=\"Read-only selection\" :readonly=\"true\" :'on-update:model-value'=\"fn()\" />"
9243
10083
  },
9244
10084
  {
9245
10085
  "title": "Disabled",
@@ -9253,8 +10093,8 @@
9253
10093
  },
9254
10094
  {
9255
10095
  "title": "Colors",
9256
- "description": "A demonstration of radio buttons with different color themes.",
9257
- "code": "<q-radio-group v-bind=\"args\">\n\t\t\t\t<q-radio-button label=\"Primary\" value=\"primary\" color=\"primary\" />\n\t\t\t\t<q-radio-button label=\"Info\" value=\"info\" color=\"info\" />\n\t\t\t\t<q-radio-button label=\"Success\" value=\"success\" color=\"success\" />\n\t\t\t\t<q-radio-button label=\"Warning\" value=\"warning\" color=\"warning\" />\n\t\t\t\t<q-radio-button label=\"Danger\" value=\"danger\" color=\"danger\" />\n\t\t\t\t<q-radio-button label=\"Custom\" value=\"custom\" color=\"#cc00cc\" />\n\t\t\t</q-radio-group>"
10096
+ "description": "A demonstration of radio buttons with different color themes, in the light and the dark theme. A custom color is drawn as given in both, so it is the app's to pick one that stands out from the page in each.",
10097
+ "code": "<QRadioGroup model-value=\"primary\" label=\"Theme Colors\" />"
9258
10098
  },
9259
10099
  {
9260
10100
  "title": "Size",
@@ -9273,9 +10113,14 @@
9273
10113
  },
9274
10114
  {
9275
10115
  "title": "Invalid",
9276
- "description": "A radio button group with an invalid state.",
10116
+ "description": "A radio button group with an invalid state. Each button takes a danger border, the checked one too.",
9277
10117
  "code": "<q-radio-group v-bind=\"args\">\n\t\t\t\t<q-radio-button label=\"Option 1\" value=\"option1\" />\n\t\t\t\t<q-radio-button label=\"Option 2\" value=\"option2\" />\n\t\t\t\t<q-radio-button label=\"Option 3\" value=\"option3\" />\n\t\t\t</q-radio-group>"
9278
10118
  },
10119
+ {
10120
+ "title": "Warning Message",
10121
+ "description": "The `warnings` slot points out something to check without making the choice invalid. Each button takes a warning border, the checked one too.",
10122
+ "code": "<q-radio-group v-bind=\"args\">\n\t\t\t\t<q-radio-button label=\"Option 1\" value=\"option1\" />\n\t\t\t\t<q-radio-button label=\"Option 2\" value=\"option2\" />\n\t\t\t\t<q-radio-button label=\"Option 3\" value=\"option3\" />\n\t\t\t\t<template #warnings>Option 2 takes a week longer this month</template>\n\t\t\t</q-radio-group>"
10123
+ },
9279
10124
  {
9280
10125
  "title": "Help",
9281
10126
  "description": "Help shown in a popover.",
@@ -9379,6 +10224,16 @@
9379
10224
  "required": false,
9380
10225
  "category": "Content"
9381
10226
  },
10227
+ {
10228
+ "name": "headingLevel",
10229
+ "type": {
10230
+ "kind": "primitive",
10231
+ "name": "number"
10232
+ },
10233
+ "description": "The heading level of the title, so screen reader users can find the section by its\nheading. Choose the level that fits the page's heading outline. Not set by default, so the\ntitle stays a plain `div`, as does a value outside 1–6.",
10234
+ "required": false,
10235
+ "category": "Content"
10236
+ },
9382
10237
  {
9383
10238
  "name": "help",
9384
10239
  "type": {
@@ -9444,8 +10299,8 @@
9444
10299
  {
9445
10300
  "name": "icons",
9446
10301
  "type": {
9447
- "kind": "object",
9448
- "fields": {}
10302
+ "kind": "unknown",
10303
+ "raw": "QIcons<\"help\"> | undefined"
9449
10304
  },
9450
10305
  "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
9451
10306
  "default": "DEFAULT_ICONS",
@@ -9488,7 +10343,7 @@
9488
10343
  },
9489
10344
  {
9490
10345
  "title": "Popover",
9491
- "description": "Help shown in a popover on the title.",
10346
+ "description": "Help shown in a popover on the title, which is a heading at `headingLevel`.",
9492
10347
  "code": "<q-section v-bind=\"args\">\n\t\t\t\t<span>Example of a group box</span>\n\t\t\t</q-section>"
9493
10348
  },
9494
10349
  {
@@ -9521,6 +10376,11 @@
9521
10376
  "description": "Group box with different styling variants.",
9522
10377
  "code": "<div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n\t\t\t\t<q-section title=\"Default\" variant=\"default\">\n\t\t\t\t\t<p>Default variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Background\" variant=\"background\">\n\t\t\t\t\t<p>Background variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Minor\" variant=\"minor\">\n\t\t\t\t\t<p>Minor variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Minor Border Top\" variant=\"minor-border-top\">\n\t\t\t\t\t<p>Minor with border top variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Title Background\" variant=\"title-background\">\n\t\t\t\t\t<p>Title background variant content</p>\n\t\t\t\t</q-section>\n\t\t\t</div>"
9523
10378
  },
10379
+ {
10380
+ "title": "Variants With Help",
10381
+ "description": "Every variant with help, whose button sits next to the title. Uppercase titles center it on their capitals as they are; the minor variants, not uppercase, raise it by the optical lift, as next to any text with lowercase letters.",
10382
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n\t\t\t\t<q-section\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:title=\"'Variant ' + variant\"\n\t\t\t\t\t:variant=\"variant\"\n\t\t\t\t\thelp=\"What this section holds\">\n\t\t\t\t\t<p>Content</p>\n\t\t\t\t</q-section>\n\t\t\t</div>"
10383
+ },
9524
10384
  {
9525
10385
  "title": "Custom Title",
9526
10386
  "description": "A section with custom content prepended and appended to the title.",
@@ -9624,7 +10484,7 @@
9624
10484
  "kind": "object",
9625
10485
  "fields": {}
9626
10486
  },
9627
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the badges and the list.\nPass every key, or omit the prop to keep the defaults.",
10487
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the badges and the list.\nPass every key, or omit the prop to keep the defaults.",
9628
10488
  "default": "DEFAULT_ICONS",
9629
10489
  "required": false,
9630
10490
  "category": "Configuration"
@@ -9635,7 +10495,7 @@
9635
10495
  "kind": "object",
9636
10496
  "fields": {}
9637
10497
  },
9638
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the badges' remove label and the clear button strings.\nPass every key, or omit the prop to keep the defaults.",
10498
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the badges' remove label and the clear button strings.\nPass every key, or omit the prop to keep the defaults.",
9639
10499
  "default": "DEFAULT_TEXTS",
9640
10500
  "required": false,
9641
10501
  "category": "Configuration"
@@ -9684,7 +10544,7 @@
9684
10544
  "kind": "primitive",
9685
10545
  "name": "boolean"
9686
10546
  },
9687
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
10547
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
9688
10548
  "required": false,
9689
10549
  "category": "State"
9690
10550
  },
@@ -9763,7 +10623,7 @@
9763
10623
  "kind": "primitive",
9764
10624
  "name": "boolean"
9765
10625
  },
9766
- "description": "Whether pressing Tab while an option is focused selects it before focus moves away.",
10626
+ "description": "Whether pressing Tab while an option is focused selects it before focus moves away.\nA multiple select never does: each option there is picked on its own, and Tab only\nleaves the list.",
9767
10627
  "default": "true",
9768
10628
  "required": false,
9769
10629
  "category": "Behavior"
@@ -9785,7 +10645,6 @@
9785
10645
  "values": [
9786
10646
  "wrap",
9787
10647
  "fit-content",
9788
- "truncate",
9789
10648
  "wrap-on-focus",
9790
10649
  "scroll-on-focus"
9791
10650
  ]
@@ -9916,6 +10775,10 @@
9916
10775
  "name": "errors",
9917
10776
  "description": ""
9918
10777
  },
10778
+ {
10779
+ "name": "warnings",
10780
+ "description": ""
10781
+ },
9919
10782
  {
9920
10783
  "name": "extras",
9921
10784
  "description": ""
@@ -9967,7 +10830,7 @@
9967
10830
  },
9968
10831
  {
9969
10832
  "title": "Loading",
9970
- "description": "Displays a loading animation that lets users know content is being loaded. A status region announces it, since focus never reaches the animation.",
10833
+ "description": "Before the first options load, the open list shows a \"Loading\" row the size of the \"No data\" one, and a bar over its top edge once the load runs past a short delay. A status region announces it, since focus never reaches them. Options that load again stay while they load.",
9971
10834
  "code": "<QSelect :items=\"[]\" :loading=\"true\" />"
9972
10835
  },
9973
10836
  {
@@ -9977,8 +10840,13 @@
9977
10840
  },
9978
10841
  {
9979
10842
  "title": "Overflow",
9980
- "description": "Controls how long option labels overflow relative to the field width. Defaults to `wrap`. - `wrap`: the menu matches the field and labels wrap onto more lines. - `truncate`: the menu matches the field and labels end in an ellipsis; a cut-off label shows its full text in a native `title` on hover. - `fit-content`: the menu grows with the longest option. - `wrap-on-focus`: like `truncate` until the option is focused, then that label wraps. - `scroll-on-focus`: like `truncate` until the option is focused, then that label scrolls to its end and back. With reduced motion, the focused label wraps instead.",
9981
- "code": "<div style=\"display: flex; flex-wrap: wrap; align-items: flex-start; gap: 1rem\">\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Wrap\" overflow=\"wrap\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"truncate\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Truncate\" overflow=\"truncate\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"fit-content\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Fit content\" overflow=\"fit-content\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap-on-focus\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Wrap on focus\" overflow=\"wrap-on-focus\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"scroll-on-focus\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Scroll on focus\" overflow=\"scroll-on-focus\" />\n\t\t\t\t</div>\n\t\t\t</div>"
10843
+ "description": "Controls how long option labels overflow relative to the field width. Defaults to `wrap`. - `wrap`: the menu matches the field and labels wrap onto more lines. - `fit-content`: the menu grows with the longest option, up to the width of the screen, where the labels wrap. - `wrap-on-focus`: the menu matches the field and labels end in an ellipsis until the option is focused, then that label wraps. A cut-off label also shows its full text in a native `title` on hover. - `scroll-on-focus`: like `wrap-on-focus` until the option is focused, then that label scrolls to its end and back. With reduced motion, the focused label wraps instead.",
10844
+ "code": "<div style=\"display: flex; flex-wrap: wrap; align-items: flex-start; gap: 1rem\">\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Wrap\" overflow=\"wrap\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"fit-content\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Fit content\" overflow=\"fit-content\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"wrap-on-focus\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Wrap on focus\" overflow=\"wrap-on-focus\" />\n\t\t\t\t</div>\n\t\t\t\t<div style=\"width: 12rem\" data-overflow=\"scroll-on-focus\">\n\t\t\t\t\t<q-select v-bind=\"args\" label=\"Scroll on focus\" overflow=\"scroll-on-focus\" />\n\t\t\t\t</div>\n\t\t\t</div>"
10845
+ },
10846
+ {
10847
+ "title": "Fit Content Long Options",
10848
+ "description": "With `fit-content`, the list grows with its longest option up to the width of the screen, where the labels wrap: on a narrow screen, it never runs past the edge or scrolls sideways.",
10849
+ "code": "<QSelect overflow=\"fit-content\" :items=\"[\n\t\t\t{ key: 'short', label: 'Short' },\n\t\t\t{\n\t\t\t\tkey: 'spaced',\n\t\t\t\tlabel: 'An option whose label has more words than a phone screen fits on one line'\n\t\t\t},\n\t\t\t{ key: 'unspaced', label: 'an_option_label_without_spaces_wider_than_a_phone_screen' }\n\t\t]\" />"
9982
10850
  },
9983
10851
  {
9984
10852
  "title": "Description In Items",
@@ -10027,19 +10895,29 @@
10027
10895
  },
10028
10896
  {
10029
10897
  "title": "Readonly Counter",
10030
- "description": "A read-only select keeps every value in reach: its \"+N\" counter is a button, for the keyboard too, that opens a popover listing them all. Escape closes it and returns to the counter.",
10898
+ "description": "A read-only select keeps every value in reach: its \"+N\" counter is a button, for the keyboard too, that opens a popover listing them all. Escape closes it and returns to the counter. The count keeps room for the counter as a button, which is wider than a plain badge.",
10031
10899
  "code": "<QSelect :readonly=\"true\" />"
10032
10900
  },
10033
10901
  {
10034
10902
  "title": "Keyboard",
10035
10903
  "description": "The select by keyboard: Arrow Down, Enter or Space opens it on the selected option (or the first), the arrows, Home, End and typing move through the options, Enter picks one, and Escape closes the list. Focus goes back to the select either way. Tab picks the focused option and goes on to what follows the select; Shift+Tab goes back to the select without picking anything. The text shows the picked option, and typing, Backspace or a paste leaves it as it is.",
10036
- "code": "<div style=\"display: flex; gap: 0.5rem; align-items: center\">\n\t\t\t\t<q-button label=\"Before\" />\n\t\t\t\t<q-select v-bind=\"args\" aria-label=\"Format\" style=\"width: 12rem\" />\n\t\t\t\t<q-button label=\"After\" />\n\t\t\t</div>"
10904
+ "code": "<div style=\"display: flex; flex-wrap: wrap; gap: 0.5rem; align-items: center\">\n\t\t\t\t<q-button label=\"Before\" />\n\t\t\t\t<q-select v-bind=\"args\" aria-label=\"Format\" style=\"width: 12rem\" />\n\t\t\t\t<q-button label=\"After\" />\n\t\t\t</div>"
10905
+ },
10906
+ {
10907
+ "title": "Many Options",
10908
+ "description": "With many options, the list renders only those in view and a few around them, so it opens as fast as a short one. Each option says its place among all of them, and the keyboard reaches any of them: End goes to the last one, which renders as it takes focus.",
10909
+ "code": "<QSelect :items=\"manyOptions\" />"
10910
+ },
10911
+ {
10912
+ "title": "Many Options Fit Content",
10913
+ "description": "A list as wide as its widest option (`overflow: 'fit-content'`) with many options renders only those in view, and measures the widest label and description rather than render every option: the list is as wide from the start as the options far down that need it most, which show on one line when reached.",
10914
+ "code": "<QSelect overflow=\"fit-content\" :items=\"Array.from({ length: MANY_OPTIONS }, (_, index) => {\n\t\t\t// The widest label and the widest description, far down the list, with names to type\n\t\t\tif (index === MANY_OPTIONS - 2000) {\n\t\t\t\treturn {\n\t\t\t\t\tkey: index + 1,\n\t\t\t\t\tlabel: 'Zone with a much longer name than every other option'\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (index === MANY_OPTIONS - 1000) {\n\t\t\t\treturn {\n\t\t\t\t\tkey: index + 1,\n\t\t\t\t\tlabel: 'Zones',\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t'A description wider than every name in the list, with its icon before it, by far'\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn { key: index + 1, label: `Option ${index + 1}` }\n\t\t})\" />"
10037
10915
  }
10038
10916
  ]
10039
10917
  },
10040
10918
  {
10041
10919
  "name": "QSidebar",
10042
- "description": "A flexible sidebar component.",
10920
+ "description": "A flexible sidebar with anchors and optional panels — including resizable ones. ## Accessibility - An open panel is a named `region` (`aria-labelledby` from the title or the anchor toggle). A resizable panel needs that name: its resize handle is a Tab stop that takes it. - The optional resize handle is a focusable `separator`: arrow keys resize it (WCAG 2.1.1). Shrink/grow buttons are the single-pointer alternative to dragging (WCAG 2.5.7) — arrow keys alone do not satisfy 2.5.7. - Pass `headingLevel` (1–6) when the panel title should be a heading; omit it for a non-heading.",
10043
10921
  "meta": {
10044
10922
  "props": [
10045
10923
  {
@@ -10058,7 +10936,7 @@
10058
10936
  "kind": "primitive",
10059
10937
  "name": "number"
10060
10938
  },
10061
- "description": "Width of the anchor section in pixels at regular density. Scaled by\n`--q-density-scale` when applied. Omit to use the density-scaled default\nrail width from CSS.",
10939
+ "description": "Width of the anchor section in pixels at regular density. Scaled by\n`--q-density-scale` when applied. Omit to use\n`var(--q-rail-width, calc(var(--q-space-1) * 12.5))` — set `--q-rail-width`\nin app CSS to align this with `QDrawer`'s default `railWidth`.",
10062
10940
  "required": false,
10063
10941
  "category": "Presentation"
10064
10942
  },
@@ -10089,8 +10967,8 @@
10089
10967
  {
10090
10968
  "name": "icons",
10091
10969
  "type": {
10092
- "kind": "object",
10093
- "fields": {}
10970
+ "kind": "unknown",
10971
+ "raw": "QIcons<\"shrink\" | \"grow\"> | undefined"
10094
10972
  },
10095
10973
  "description": "Icons of the buttons that narrow and widen a resizable panel, which the sidebar\ncascades to its items unless an item sets its own `icons`.\nPass every key, or omit the prop to keep the defaults.",
10096
10974
  "default": "DEFAULT_ICONS",
@@ -10125,9 +11003,9 @@
10125
11003
  "type": "[value: string | undefined]"
10126
11004
  },
10127
11005
  {
10128
- "name": "click:item",
11006
+ "name": "resize:start",
10129
11007
  "description": "",
10130
- "type": "[id: string]"
11008
+ "type": "[]"
10131
11009
  },
10132
11010
  {
10133
11011
  "name": "resize",
@@ -10135,14 +11013,14 @@
10135
11013
  "type": "[width: number]"
10136
11014
  },
10137
11015
  {
10138
- "name": "resize:start",
11016
+ "name": "resize:end",
10139
11017
  "description": "",
10140
- "type": "[]"
11018
+ "type": "[finalWidth: number]"
10141
11019
  },
10142
11020
  {
10143
- "name": "resize:end",
11021
+ "name": "click:item",
10144
11022
  "description": "",
10145
- "type": "[finalWidth: number]"
11023
+ "type": "[id: string]"
10146
11024
  }
10147
11025
  ],
10148
11026
  "slots": [
@@ -10413,8 +11291,8 @@
10413
11291
  {
10414
11292
  "name": "icons",
10415
11293
  "type": {
10416
- "kind": "object",
10417
- "fields": {}
11294
+ "kind": "unknown",
11295
+ "raw": "QIcons<\"back\" | \"forward\" | \"previous\" | \"next\" | \"up\" | \"down\" | \"completed\" | \"current\"> | undefined"
10418
11296
  },
10419
11297
  "description": "Custom icons for the previous/next navigation buttons, the\n`completed`/`current` status badges, and the overflow scroll arrows.\nPass every key, or omit the prop to keep the defaults.",
10420
11298
  "default": "DEFAULT_ICONS",
@@ -10640,10 +11518,11 @@
10640
11518
  {
10641
11519
  "name": "icons",
10642
11520
  "type": {
10643
- "kind": "object",
10644
- "fields": {}
11521
+ "kind": "unknown",
11522
+ "raw": "QIcons<\"warning\" | \"help\" | \"error\"> | undefined"
10645
11523
  },
10646
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.",
11524
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nIcon overrides. Includes the field's help, error and warning icons.\nPass every key, or omit the prop to keep the defaults.",
11525
+ "default": "DEFAULT_ICONS",
10647
11526
  "required": false,
10648
11527
  "category": "Configuration"
10649
11528
  },
@@ -10653,7 +11532,8 @@
10653
11532
  "kind": "object",
10654
11533
  "fields": {}
10655
11534
  },
10656
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.",
11535
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nText overrides. Includes the state labels, `on` and `off`, shown when the switch has no\n`trueLabel` or `falseLabel`, and the field's help, error and warning texts.\nPass every key, or omit the prop to keep the defaults.",
11536
+ "default": "DEFAULT_TEXTS",
10657
11537
  "required": false,
10658
11538
  "category": "Configuration"
10659
11539
  },
@@ -10663,8 +11543,7 @@
10663
11543
  "kind": "primitive",
10664
11544
  "name": "string"
10665
11545
  },
10666
- "description": "Label displayed when switch is in the \"true\" state.",
10667
- "default": "On",
11546
+ "description": "Label displayed when the switch is on, with `showStateLabels`. Defaults to `texts.on`;\nan empty string shows none.",
10668
11547
  "required": false,
10669
11548
  "category": "Content"
10670
11549
  },
@@ -10674,8 +11553,7 @@
10674
11553
  "kind": "primitive",
10675
11554
  "name": "string"
10676
11555
  },
10677
- "description": "Label displayed when switch is in the \"false\" state.",
10678
- "default": "Off",
11556
+ "description": "Label displayed when the switch is off, with `showStateLabels`. Defaults to `texts.off`;\nan empty string shows none.",
10679
11557
  "required": false,
10680
11558
  "category": "Content"
10681
11559
  },
@@ -10774,6 +11652,10 @@
10774
11652
  {
10775
11653
  "name": "errors",
10776
11654
  "description": ""
11655
+ },
11656
+ {
11657
+ "name": "warnings",
11658
+ "description": ""
10777
11659
  }
10778
11660
  ]
10779
11661
  },
@@ -10785,7 +11667,7 @@
10785
11667
  },
10786
11668
  {
10787
11669
  "title": "With State Labels",
10788
- "description": "Displays the switch with state-specific labels (`trueLabel` / `falseLabel`).",
11670
+ "description": "Displays the switch with state-specific labels, off and on, in the light and the dark theme. They come from `texts.on` and `texts.off` (\"On\" and \"Off\") unless the switch sets `trueLabel` and `falseLabel`. The thumb takes the color that goes on its track, so it stands out from the track in each, and the label on it takes the track's color.",
10789
11671
  "code": "<QSwitch :show-state-labels=\"true\" />"
10790
11672
  },
10791
11673
  {
@@ -10810,8 +11692,13 @@
10810
11692
  },
10811
11693
  {
10812
11694
  "title": "Invalid",
10813
- "description": "An invalid switch. The help says what to fix, since the danger outline shows it only in color.",
10814
- "code": "<QSwitch help=\"Turn notifications on to continue.\" :invalid=\"true\" />"
11695
+ "description": "An invalid switch, on or off. The help says what to fix, since the danger outline shows it only in color.",
11696
+ "code": "<div style=\"display: flex; flex-wrap: wrap; gap: 2rem\">\n\t\t\t\t<q-switch v-bind=\"args\" />\n\t\t\t\t<q-switch v-bind=\"args\" model-value />\n\t\t\t</div>"
11697
+ },
11698
+ {
11699
+ "title": "Warning Message",
11700
+ "description": "The `warnings` slot points out something to check without making the value invalid. The switch takes a warning outline, on or off.",
11701
+ "code": "<div style=\"display: flex; flex-wrap: wrap; gap: 2rem\">\n\t\t\t\t<q-switch v-bind=\"args\">\n\t\t\t\t\t<template #warnings>Notifications can arrive late this week</template>\n\t\t\t\t</q-switch>\n\t\t\t\t<q-switch v-bind=\"args\" model-value>\n\t\t\t\t\t<template #warnings>Notifications can arrive late this week</template>\n\t\t\t\t</q-switch>\n\t\t\t</div>"
10815
11702
  },
10816
11703
  {
10817
11704
  "title": "Size",
@@ -10820,12 +11707,12 @@
10820
11707
  },
10821
11708
  {
10822
11709
  "title": "Custom Color",
10823
- "description": "Switch with a custom checked color instead of the default theme color.",
11710
+ "description": "Switch with a custom checked color instead of the default theme color, in the light and the dark theme. The track takes the custom color as given in both, and the thumb the color that goes on it.",
10824
11711
  "code": "<QSwitch :model-value=\"true\" checked-color=\"rgb(0, 200, 83)\" />"
10825
11712
  },
10826
11713
  {
10827
11714
  "title": "Custom Switch",
10828
- "description": "A themed switch using emoji labels and a custom color, ideal for toggling between light and dark modes.",
11715
+ "description": "A themed switch using its own state labels (`trueLabel` and `falseLabel`, with emoji) and a custom color, ideal for toggling between light and dark modes.",
10829
11716
  "code": "<QSwitch :model-value=\"true\" :show-state-labels=\"true\" label=\"Theme\" true-label=\"🌙 Dark\" false-label=\"☀️ Light\" checked-color=\"#333\" />"
10830
11717
  },
10831
11718
  {
@@ -10842,7 +11729,7 @@
10842
11729
  },
10843
11730
  {
10844
11731
  "name": "QTabs",
10845
- "description": "Displays a set of tabbed panels. Only one panel is visible at a time.",
11732
+ "description": "Displays a set of tabbed panels. Only one panel is visible at a time. Name the tab strip with `aria-label` or `aria-labelledby` on `QTabs`, when the page has more than one strip or the tabs alone do not say what they switch: both go to the tablist.",
10846
11733
  "meta": {
10847
11734
  "props": [
10848
11735
  {
@@ -10912,8 +11799,8 @@
10912
11799
  {
10913
11800
  "name": "icons",
10914
11801
  "type": {
10915
- "kind": "object",
10916
- "fields": {}
11802
+ "kind": "unknown",
11803
+ "raw": "QIcons<\"back\" | \"forward\" | \"up\" | \"down\"> | undefined"
10917
11804
  },
10918
11805
  "description": "Icons for the tab strip. Includes the overflow navigation chevrons.\nPass every key, or omit the prop to keep the defaults.",
10919
11806
  "default": "DEFAULT_ICONS",
@@ -10966,6 +11853,11 @@
10966
11853
  "description": "Subtext help at the top of a panel. The tab button stays the label.",
10967
11854
  "code": "<q-tabs v-bind=\"args\">\n\t\t\t\t<q-tab title=\"Details\" value=\"details\" help=\"Shown for this tab\">\n\t\t\t\t\tContent for the details tab.\n\t\t\t\t</q-tab>\n\t\t\t\t<q-tab title=\"History\" value=\"history\">\n\t\t\t\t\tContent for the history tab.\n\t\t\t\t</q-tab>\n\t\t\t\t<q-tab title=\"Settings\" value=\"settings\">\n\t\t\t\t\tContent for the settings tab.\n\t\t\t\t</q-tab>\n\t\t\t</q-tabs>"
10968
11855
  },
11856
+ {
11857
+ "title": "Named",
11858
+ "description": "Tabs named by the heading above them: `aria-labelledby` on `QTabs` names the tablist, so a screen reader says which tabs these are.",
11859
+ "code": "<h3 id=\"account-tabs-title\">Account</h3>\n\t\t\t<q-tabs v-bind=\"args\" aria-labelledby=\"account-tabs-title\">\n\t\t\t\t<q-tab title=\"Profile\" value=\"profile\">\n\t\t\t\t\tContent for the profile tab.\n\t\t\t\t</q-tab>\n\t\t\t\t<q-tab title=\"Security\" value=\"security\">\n\t\t\t\t\tContent for the security tab.\n\t\t\t\t</q-tab>\n\t\t\t</q-tabs>"
11860
+ },
10969
11861
  {
10970
11862
  "title": "Vertical",
10971
11863
  "description": "Vertical tab list beside the panels.",
@@ -11111,10 +12003,10 @@
11111
12003
  {
11112
12004
  "name": "icons",
11113
12005
  "type": {
11114
- "kind": "object",
11115
- "fields": {}
12006
+ "kind": "unknown",
12007
+ "raw": "QIcons<\"warning\" | \"help\" | \"error\"> | undefined"
11116
12008
  },
11117
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.",
12009
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.",
11118
12010
  "required": false,
11119
12011
  "category": "Configuration"
11120
12012
  },
@@ -11124,7 +12016,7 @@
11124
12016
  "kind": "object",
11125
12017
  "fields": {}
11126
12018
  },
11127
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.",
12019
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.",
11128
12020
  "required": false,
11129
12021
  "category": "Configuration"
11130
12022
  },
@@ -11172,7 +12064,7 @@
11172
12064
  "kind": "primitive",
11173
12065
  "name": "boolean"
11174
12066
  },
11175
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
12067
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
11176
12068
  "required": false,
11177
12069
  "category": "State"
11178
12070
  },
@@ -11296,6 +12188,10 @@
11296
12188
  "name": "errors",
11297
12189
  "description": ""
11298
12190
  },
12191
+ {
12192
+ "name": "warnings",
12193
+ "description": ""
12194
+ },
11299
12195
  {
11300
12196
  "name": "extras",
11301
12197
  "description": ""
@@ -11451,7 +12347,7 @@
11451
12347
  "kind": "object",
11452
12348
  "fields": {}
11453
12349
  },
11454
- "description": "Icon overrides. Includes the help popover icon, `help`, and the error icon, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.",
12350
+ "description": "Icon overrides. Includes the help popover icon, `help`, the error icon, `error`, and the\nwarning icon, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.",
11455
12351
  "default": "DEFAULT_ICONS",
11456
12352
  "required": false,
11457
12353
  "category": "Configuration"
@@ -11462,7 +12358,7 @@
11462
12358
  "kind": "object",
11463
12359
  "fields": {}
11464
12360
  },
11465
- "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the text read\nbefore an error message, `error`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the help and clear button labels.\nPass every key, or omit the prop to keep the defaults.",
12361
+ "description": "Accessible text overrides. Includes the help button label, `showHelp`, and the texts read\nbefore an error message, `error`, and before a warning, `warning`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the help and clear button labels.\nPass every key, or omit the prop to keep the defaults.",
11466
12362
  "default": "DEFAULT_TEXTS",
11467
12363
  "required": false,
11468
12364
  "category": "Configuration"
@@ -11511,7 +12407,7 @@
11511
12407
  "kind": "primitive",
11512
12408
  "name": "boolean"
11513
12409
  },
11514
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
12410
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
11515
12411
  "required": false,
11516
12412
  "category": "State"
11517
12413
  },
@@ -11599,6 +12495,10 @@
11599
12495
  "name": "errors",
11600
12496
  "description": ""
11601
12497
  },
12498
+ {
12499
+ "name": "warnings",
12500
+ "description": ""
12501
+ },
11602
12502
  {
11603
12503
  "name": "extras",
11604
12504
  "description": ""
@@ -11661,6 +12561,21 @@
11661
12561
  "description": "The `errors` slot says what is wrong while `invalid` is true. The message shows under the field after an error icon, describes the input, and screen readers announce it as it appears, after the text \"Error:\" (`texts.error`). The slot is ignored while `invalid` is false, so it can hold the message all along.",
11662
12562
  "code": "<q-text-field\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"value\"\n\t\t\t\t:invalid=\"invalid\">\n\t\t\t\t<template #errors>Use at least 3 characters</template>\n\t\t\t</q-text-field>"
11663
12563
  },
12564
+ {
12565
+ "title": "Warning Message",
12566
+ "description": "The `warnings` slot points out something the user may want to check, without blocking: the value stays valid. The warning shows whenever the slot renders something, so render it conditionally. It shows under the field after a warning icon, with a warning border and a shadow of its color, and describes the input. Screen readers announce it as it appears, after the text \"Warning:\" (`texts.warning`).",
12567
+ "code": "<q-text-field\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"value\">\n\t\t\t\t<template\n\t\t\t\t\tv-if=\"uppercase\"\n\t\t\t\t\t#warnings>\n\t\t\t\t\tUsernames are usually all lowercase\n\t\t\t\t</template>\n\t\t\t</q-text-field>"
12568
+ },
12569
+ {
12570
+ "title": "Error And Warning",
12571
+ "description": "With an error and a warning, both show, the error first, and the border and its shadow are the error's.",
12572
+ "code": "<q-text-field\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"value\">\n\t\t\t\t<template #errors>Use at least 3 characters</template>\n\t\t\t\t<template #warnings>Usernames are usually all lowercase</template>\n\t\t\t</q-text-field>"
12573
+ },
12574
+ {
12575
+ "title": "Message Icon Size",
12576
+ "description": "Error and warning icons of another size, set with the `size` of `icons.error` and `icons.warning`. They center on the capitals of their messages like icons of the default size.",
12577
+ "code": "<q-text-field v-bind=\"args\">\n\t\t\t\t<template #errors>Use at least 3 characters</template>\n\t\t\t\t<template #warnings>Usernames are usually all lowercase</template>\n\t\t\t</q-text-field>"
12578
+ },
11664
12579
  {
11665
12580
  "title": "Clearable",
11666
12581
  "description": "Adds a clear button to the field, allowing the user to clear the value. The button leaves with the value, so focus goes back to the input, to type a new one.",
@@ -11760,7 +12675,7 @@
11760
12675
  },
11761
12676
  {
11762
12677
  "name": "QToast",
11763
- "description": "Toasts are commonly used to display quick feedback messages to the user, without removing focus from the main page. Show toasts with `useToast` and a `QToaster`, which announces each one to screen readers. A toast used on its own takes `role=\"alert\"` for warnings and errors and `role=\"status\"` otherwise, but many screen readers skip a `status` toast that appears together with its message.",
12678
+ "description": "Toasts are commonly used to display quick feedback messages to the user, without removing focus from the main page. Show toasts with `useToast` and a `QToaster`. ## Accessibility - A `QToaster` announces each toast to screen readers. A toast used on its own takes `role=\"alert\"` for warnings and errors and `role=\"status\"` otherwise, but many screen readers skip a `status` toast that appears together with its message.",
11764
12679
  "meta": {
11765
12680
  "props": [
11766
12681
  {
@@ -11884,8 +12799,8 @@
11884
12799
  {
11885
12800
  "name": "icons",
11886
12801
  "type": {
11887
- "kind": "object",
11888
- "fields": {}
12802
+ "kind": "unknown",
12803
+ "raw": "QIcons<\"info\" | \"success\" | \"warning\" | \"danger\" | \"close\"> | undefined"
11889
12804
  },
11890
12805
  "description": "Custom icon configurations: the severity icons and the dismiss icon.\nPass every key, or omit the prop to keep the defaults.",
11891
12806
  "default": "DEFAULT_ICONS",
@@ -11963,7 +12878,7 @@
11963
12878
  {
11964
12879
  "title": "Elevation",
11965
12880
  "description": "Supports different elevation levels. Defaults to medium.",
11966
- "code": "<div style=\"display: flex; gap: 0.5rem;\">\n\t\t\t\t<q-toast\n\t\t\t\t\tv-for=\"(_, idx) in elevations\"\n\t\t\t\t\t:key=\"elevations[idx]\"\n\t\t\t\t\t:elevation=\"elevations[idx]\"\n\t\t\t\t\t:text=\"texts[idx]\"\n\t\t\t\t\tv-bind=\"args\" />\n\t\t\t</div>"
12881
+ "code": "<div style=\"display: flex; flex-wrap: wrap; gap: 0.5rem;\">\n\t\t\t\t<q-toast\n\t\t\t\t\tv-for=\"(_, idx) in elevations\"\n\t\t\t\t\t:key=\"elevations[idx]\"\n\t\t\t\t\t:elevation=\"elevations[idx]\"\n\t\t\t\t\t:text=\"texts[idx]\"\n\t\t\t\t\tv-bind=\"args\" />\n\t\t\t</div>"
11967
12882
  },
11968
12883
  {
11969
12884
  "title": "Colors",
@@ -11987,13 +12902,28 @@
11987
12902
  },
11988
12903
  {
11989
12904
  "title": "Outlined",
11990
- "description": "Displays an outlined toast with a transparent background.",
12905
+ "description": "Displays an outlined toast: a border in its color, on an opaque background.",
11991
12906
  "code": "<QToast color=\"danger\" variant=\"outlined\" elevation=\"none\" text=\"An unexpected error occured!\" />"
11992
12907
  },
12908
+ {
12909
+ "title": "Outlined Warning Border",
12910
+ "description": "Warning (and other light colors) darken the text for contrast. The outlined border takes that same color, not the raw theme color.",
12911
+ "code": "<QToast color=\"warning\" variant=\"outlined\" elevation=\"none\" text=\"Your session expires in five minutes.\" />"
12912
+ },
12913
+ {
12914
+ "title": "Long Word",
12915
+ "description": "A long word, such as a file path or a link, wraps inside the toast instead of widening it.",
12916
+ "code": "<QToast color=\"info\" text=\"Saved as QuarterlySalesFiguresAndForecastByRegionFinalVersion2026.pdf\" />"
12917
+ },
12918
+ {
12919
+ "title": "Wrapped Text",
12920
+ "description": "A text that wraps onto more lines. The icon and the dismiss button stay on its first line, and the rest of the text runs below them.",
12921
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem; width: 320px\">\n\t\t\t\t<q-toast v-bind=\"args\" />\n\t\t\t\t<q-toast v-bind=\"args\" text=\"Your report is ready.\" />\n\t\t\t</div>"
12922
+ },
11993
12923
  {
11994
12924
  "title": "Custom Body",
11995
12925
  "description": "The default slot of the toast allows for greater customization of its contents.",
11996
- "code": "<q-toast v-bind=\"args\">\n\t\t\t\t<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t\t<q-skeleton-loader type=\"icon\" :width=\"40\" :height=\"40\" />\n\t\t\t\t\t<q-skeleton-loader type=\"text\" :width=\"500\" />\n\t\t\t\t\t<q-skeleton-loader type=\"text\" :width=\"435\" />\n\t\t\t\t</div>\n\t\t\t</q-toast>"
12926
+ "code": "<q-toast v-bind=\"args\">\n\t\t\t\t<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t\t<q-skeleton-loader type=\"icon\" :width=\"40\" :height=\"40\" />\n\t\t\t\t\t<q-skeleton-loader type=\"text\" width=\"min(31.25rem, 100%)\" />\n\t\t\t\t\t<q-skeleton-loader type=\"text\" width=\"min(27rem, 100%)\" />\n\t\t\t\t</div>\n\t\t\t</q-toast>"
11997
12927
  },
11998
12928
  {
11999
12929
  "title": "Header Slots",
@@ -12054,8 +12984,8 @@
12054
12984
  {
12055
12985
  "name": "icons",
12056
12986
  "type": {
12057
- "kind": "object",
12058
- "fields": {}
12987
+ "kind": "unknown",
12988
+ "raw": "QIcons<\"help\"> | undefined"
12059
12989
  },
12060
12990
  "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
12061
12991
  "required": false,
@@ -12249,14 +13179,9 @@
12249
13179
  "description": "",
12250
13180
  "code": "<q-toggle v-bind=\"args\" aria-label=\"Underline\">\n\t\t <q-icon icon=\"format-underline\" />\n\t\t</q-toggle>"
12251
13181
  },
12252
- {
12253
- "title": "Colors",
12254
- "description": "A pressed toggle uses its own `color`: a tonal fill and a label that clears 4.5:1 on it.",
12255
- "code": "<div style=\"display: flex; gap: 0.5rem;\">\n\t\t <q-toggle\n\t\t v-for=\"color in colors\"\n\t\t :key=\"color\"\n\t\t :model-value=\"true\"\n\t\t :color=\"color\"\n\t\t :aria-label=\"'Underline in ' + color\">\n\t\t <q-icon icon=\"format-underline\" />\n\t\t </q-toggle>\n\t\t</div>"
12256
- },
12257
13182
  {
12258
13183
  "title": "Borderless Colors",
12259
- "description": "A pressed borderless toggle has no border to show it, so it fills solid in its own color, with the text that goes on that color, rather than the faint tonal fill.",
13184
+ "description": "A pressed borderless toggle fills solid in its own color too, with the text that goes on that color.",
12260
13185
  "code": "<div style=\"display: flex; gap: 0.5rem;\">\n\t\t <q-toggle\n\t\t v-for=\"color in colors\"\n\t\t :key=\"color\"\n\t\t :model-value=\"true\"\n\t\t :color=\"color\"\n\t\t borderless\n\t\t :aria-label=\"'Underline in ' + color\">\n\t\t <q-icon icon=\"format-underline\" />\n\t\t </q-toggle>\n\t\t <q-toggle borderless aria-label=\"Bold\">\n\t\t <q-icon icon=\"format-bold\" />\n\t\t </q-toggle>\n\t\t</div>"
12261
13186
  }
12262
13187
  ]
@@ -12674,6 +13599,11 @@
12674
13599
  "title": "HTML Support",
12675
13600
  "description": "Enables HTML support for the tooltip text.",
12676
13601
  "code": "<QTooltip text=\"This is a tooltip. Did you know that the contents of tooltips can be formatted?&lt;br>&lt;br>HTML is fully supported, so text formatting options such as &lt;b>bold&lt;/b>, &lt;i>italic&lt;/i>, or even&lt;br>newlines can be used.\" />"
13602
+ },
13603
+ {
13604
+ "title": "Click Trigger",
13605
+ "description": "A tooltip that opens on a click of its anchor (`trigger: 'click'`), as a toggletip. From the keyboard too, focus stays on the anchor, which the tooltip describes: the tooltip itself takes no focus, so Tab goes on to what follows the anchor and closes it, and Escape closes it.",
13606
+ "code": "<q-button id=\"click-trigger-anchor\" label=\"Info\" />\n\t\t\t<q-tooltip anchor=\"#click-trigger-anchor\" trigger=\"click\" text=\"More about this\" />\n\t\t\t<q-button label=\"Next\" />"
12677
13607
  }
12678
13608
  ]
12679
13609
  }
@@ -12701,7 +13631,7 @@
12701
13631
  "name": "QDialogItem",
12702
13632
  "kind": "type",
12703
13633
  "description": "Public view of a dialog managed by {@link useDialog}. `id` is set when the dialog registers during setup. Prefer `await addDialog(...)` to obtain the id rather than reading it from this list before the promise resolves.",
12704
- "signature": "type QDialogItem = {\n id?: string;\n props: QDialogProps;\n options?: QDialogOptions;\n handlers?: QDialogHandlers;\n};"
13634
+ "signature": "type QDialogItem = {\n id?: string;\n props: QDialogProps & {\n modelValue?: boolean;\n };\n options?: QDialogOptions;\n handlers?: QDialogHandlers;\n};"
12705
13635
  },
12706
13636
  {
12707
13637
  "name": "QThemeDefinition",
@@ -13352,7 +14282,7 @@
13352
14282
  "name": "completePartialDateInput",
13353
14283
  "kind": "function",
13354
14284
  "description": "Completes trailing partial numeric segments with zero defaults. Partial digits are right-padded; missing suffix segments use zero-filled defaults.",
13355
- "signature": "completePartialDateInput(dateStr: string, format: string, labels?: DateParserLabels | undefined): string | null",
14285
+ "signature": "completePartialDateInput(dateStr: string, format: string, labels?: QDateParserLabels | undefined): string | null",
13356
14286
  "parameters": [
13357
14287
  {
13358
14288
  "name": "dateStr",
@@ -13368,7 +14298,7 @@
13368
14298
  },
13369
14299
  {
13370
14300
  "name": "labels",
13371
- "type": "DateParserLabels | undefined",
14301
+ "type": "QDateParserLabels | undefined",
13372
14302
  "description": "Optional localized text resolvers, to read the date before a missing offset.",
13373
14303
  "optional": true
13374
14304
  }
@@ -13396,23 +14326,11 @@
13396
14326
  "description": "Mask string."
13397
14327
  }
13398
14328
  },
13399
- {
13400
- "name": "DateFormatterLabels",
13401
- "kind": "type",
13402
- "description": "Formats a date according to a format string.",
13403
- "signature": "type DateFormatterLabels = {\n getMonthName?: (month: number, short: boolean) => string;\n getWeekdayName?: (weekday: number, short: boolean) => string;\n};"
13404
- },
13405
- {
13406
- "name": "DateParserLabels",
13407
- "kind": "type",
13408
- "description": "Optional parsing label resolvers used by `parseDate`. English names are always read too.",
13409
- "signature": "type DateParserLabels = {\n getMonthName?: (month: number, short: boolean) => string;\n getWeekdayName?: (weekday: number, short: boolean) => string;\n getMonthIndex?: (monthName: string, short: boolean) => number | null;\n getWeekdayIndex?: (weekdayName: string, short: boolean) => number | null;\n};"
13410
- },
13411
14329
  {
13412
14330
  "name": "formatDate",
13413
14331
  "kind": "function",
13414
14332
  "description": "Formats a date according to a format string. Supports numeric and textual date/time tokens and quoted literals.",
13415
- "signature": "formatDate(date: Date, format: string, labels?: DateFormatterLabels | undefined): string",
14333
+ "signature": "formatDate(date: Date, format: string, labels?: QDateFormatterLabels | undefined): string",
13416
14334
  "parameters": [
13417
14335
  {
13418
14336
  "name": "date",
@@ -13428,7 +14346,7 @@
13428
14346
  },
13429
14347
  {
13430
14348
  "name": "labels",
13431
- "type": "DateFormatterLabels | undefined",
14349
+ "type": "QDateFormatterLabels | undefined",
13432
14350
  "description": "Optional localized text resolvers for month/weekday names.",
13433
14351
  "optional": true
13434
14352
  }
@@ -13756,11 +14674,35 @@
13756
14674
  "description": "Left-zero-padded string value."
13757
14675
  }
13758
14676
  },
14677
+ {
14678
+ "name": "padNumericSegments",
14679
+ "kind": "function",
14680
+ "description": "Pads fully-typed numeric segments to their width for the provided format, such as `5/4/2026 9:05` to `05/04/2026 09:05` in `dd/MM/yyyy HH:mm`. Unlike {@link clampNumericSegments}, it never changes a value: a date or time that does not exist, such as `31/02/2026`, stays as it is, for a parser to reject.",
14681
+ "signature": "padNumericSegments(value: string, format: string): string",
14682
+ "parameters": [
14683
+ {
14684
+ "name": "value",
14685
+ "type": "string",
14686
+ "description": "Masked user input.",
14687
+ "optional": false
14688
+ },
14689
+ {
14690
+ "name": "format",
14691
+ "type": "string",
14692
+ "description": "Date/time format pattern.",
14693
+ "optional": false
14694
+ }
14695
+ ],
14696
+ "returns": {
14697
+ "type": "string",
14698
+ "description": "Input with its numeric segments padded."
14699
+ }
14700
+ },
13759
14701
  {
13760
14702
  "name": "parseDate",
13761
14703
  "kind": "function",
13762
14704
  "description": "Parses a date string according to a format string. Supports quoted literals, milliseconds, meridiem, and textual month/weekday tokens. A weekday name the date does not fall on makes the input invalid, unless `options.ignoreWeekday` is set.",
13763
- "signature": "parseDate(dateStr: string, format: string, labels?: DateParserLabels | undefined, options?: { ignoreWeekday?: boolean; } | undefined): Date | null",
14705
+ "signature": "parseDate(dateStr: string, format: string, labels?: QDateParserLabels | undefined, options?: { ignoreWeekday?: boolean; } | undefined): Date | null",
13764
14706
  "parameters": [
13765
14707
  {
13766
14708
  "name": "dateStr",
@@ -13776,7 +14718,7 @@
13776
14718
  },
13777
14719
  {
13778
14720
  "name": "labels",
13779
- "type": "DateParserLabels | undefined",
14721
+ "type": "QDateParserLabels | undefined",
13780
14722
  "description": "Optional localized text resolvers for month/weekday parsing.",
13781
14723
  "optional": true
13782
14724
  },
@@ -13796,7 +14738,7 @@
13796
14738
  "name": "parseDateWithCompletion",
13797
14739
  "kind": "function",
13798
14740
  "description": "Parses a date string, completing trailing partial numeric segments when needed.",
13799
- "signature": "parseDateWithCompletion(dateStr: string, format: string, labels?: DateParserLabels | undefined, options?: { ignoreWeekday?: boolean; } | undefined): Date | null",
14741
+ "signature": "parseDateWithCompletion(dateStr: string, format: string, labels?: QDateParserLabels | undefined, options?: { ignoreWeekday?: boolean; } | undefined): Date | null",
13800
14742
  "parameters": [
13801
14743
  {
13802
14744
  "name": "dateStr",
@@ -13812,7 +14754,7 @@
13812
14754
  },
13813
14755
  {
13814
14756
  "name": "labels",
13815
- "type": "DateParserLabels | undefined",
14757
+ "type": "QDateParserLabels | undefined",
13816
14758
  "description": "Optional localized text resolvers for month/weekday parsing.",
13817
14759
  "optional": true
13818
14760
  },
@@ -13846,6 +14788,18 @@
13846
14788
  "description": "Parsed `Date` instance or `null` when the string is not ISO-shaped or invalid."
13847
14789
  }
13848
14790
  },
14791
+ {
14792
+ "name": "QDateFormatterLabels",
14793
+ "kind": "type",
14794
+ "description": "Formats a date according to a format string.",
14795
+ "signature": "type QDateFormatterLabels = {\n getMonthName?: (month: number, short: boolean) => string;\n getWeekdayName?: (weekday: number, short: boolean) => string;\n};"
14796
+ },
14797
+ {
14798
+ "name": "QDateParserLabels",
14799
+ "kind": "type",
14800
+ "description": "Optional parsing label resolvers used by `parseDate`. English names are always read too.",
14801
+ "signature": "type QDateParserLabels = {\n getMonthName?: (month: number, short: boolean) => string;\n getWeekdayName?: (weekday: number, short: boolean) => string;\n getMonthIndex?: (monthName: string, short: boolean) => number | null;\n getWeekdayIndex?: (weekdayName: string, short: boolean) => number | null;\n};"
14802
+ },
13849
14803
  {
13850
14804
  "name": "uses12HourFormat",
13851
14805
  "kind": "function",
@@ -13950,7 +14904,7 @@
13950
14904
  {
13951
14905
  "name": "hasSlotContent",
13952
14906
  "kind": "function",
13953
- "description": "Whether a slot renders anything: a node that is not a comment, looking inside fragments. A slot can be passed and still render nothing, such as a template whose only element has a false `v-if`, which Vue renders as a comment. `$slots.name` is set all the same, so a wrapper shown on it would render empty. By default this is exactly the rule Vue uses to show a slot's fallback content (`ensureValidVNode`), so a check and a fallback never disagree. Only `ignoreBlankText` departs from it. Call it while rendering, in the template or a function the template calls, never in a `computed`: the slots object is not reactive, so a computed keeps its first answer.",
14907
+ "description": "Whether a slot renders anything: a node that is not a comment, looking inside fragments. A slot can be passed and still render nothing, such as a template whose only element has a false `v-if`, which Vue renders as a comment. `$slots.name` is set all the same, so a wrapper shown on it would render empty. By default this is exactly the rule Vue uses to show a slot's fallback content (`ensureValidVNode`), so a check and a fallback never disagree. Only `ignoreBlankText` and `textOnly` depart from it. Call it while rendering, in the template or a function the template calls, never in a `computed`: the slots object is not reactive, so a computed keeps its first answer.",
13954
14908
  "signature": "hasSlotContent(slot: ((props: never) => unknown) | undefined, options?: QHasSlotContentOptions): boolean",
13955
14909
  "parameters": [
13956
14910
  {
@@ -13962,7 +14916,7 @@
13962
14916
  {
13963
14917
  "name": "options",
13964
14918
  "type": "QHasSlotContentOptions",
13965
- "description": "The props to pass to a scoped slot, and whether blank text counts.",
14919
+ "description": "The props to pass to a scoped slot, whether blank text counts, and whether only text does.",
13966
14920
  "optional": true
13967
14921
  }
13968
14922
  ],
@@ -13975,7 +14929,7 @@
13975
14929
  "name": "QHasSlotContentOptions",
13976
14930
  "kind": "type",
13977
14931
  "description": "Options for {@link hasSlotContent}.",
13978
- "signature": "type QHasSlotContentOptions = {\n props?: Record<string, unknown>;\n ignoreBlankText?: boolean;\n};"
14932
+ "signature": "type QHasSlotContentOptions = {\n props?: Record<string, unknown>;\n ignoreBlankText?: boolean;\n textOnly?: boolean;\n};"
13979
14933
  }
13980
14934
  ]
13981
14935
  }