bitboss-ui 3.0.0-beta.63 → 3.0.0-beta.65

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 (396) hide show
  1. package/README.md +25 -20
  2. package/bin/bitboss-ui.mjs +73 -7
  3. package/dist/ai/BbAlert.md +10 -1
  4. package/dist/ai/BbBadge.md +35 -3
  5. package/dist/ai/BbBadgeButton.md +4 -2
  6. package/dist/ai/BbBaseButton.md +9 -3
  7. package/dist/ai/BbBreadcrumbs.md +2 -2
  8. package/dist/ai/BbButton.md +113 -8
  9. package/dist/ai/BbCheckbox.md +1 -1
  10. package/dist/ai/BbCheckboxGroup.md +94 -6
  11. package/dist/ai/BbColorInput.md +4 -1
  12. package/dist/ai/BbColorPalette.md +2 -1
  13. package/dist/ai/BbConfirm.md +7 -3
  14. package/dist/ai/BbDatePicker.md +2 -1
  15. package/dist/ai/BbDatePickerInput.md +4 -1
  16. package/dist/ai/BbDialog.md +12 -11
  17. package/dist/ai/BbDropdown.md +189 -38
  18. package/dist/ai/BbDropdownButton.md +27 -7
  19. package/dist/ai/BbForm.md +55 -22
  20. package/dist/ai/BbHost.md +2 -2
  21. package/dist/ai/BbHoverCard.md +7 -3
  22. package/dist/ai/BbIcon.md +12 -6
  23. package/dist/ai/BbIndicator.md +11 -1
  24. package/dist/ai/BbNumberInput.md +4 -1
  25. package/dist/ai/BbOffCanvas.md +37 -3
  26. package/dist/ai/BbPopover.md +2 -1
  27. package/dist/ai/BbRadio.md +1 -1
  28. package/dist/ai/BbRadioGroup.md +102 -10
  29. package/dist/ai/BbSelect.md +52 -17
  30. package/dist/ai/BbSelectPopover.md +93 -26
  31. package/dist/ai/BbSwitch.md +1 -1
  32. package/dist/ai/BbSwitchGroup.md +30 -3
  33. package/dist/ai/BbTable.md +17 -10
  34. package/dist/ai/BbTabs.md +8 -3
  35. package/dist/ai/BbTabsList.md +4 -1
  36. package/dist/ai/BbTag.md +5 -2
  37. package/dist/ai/BbTextInput.md +4 -1
  38. package/dist/ai/BbTextarea.md +4 -1
  39. package/dist/ai/BbTimePicker.md +2 -1
  40. package/dist/ai/BbTimePickerInput.md +4 -1
  41. package/dist/ai/BbToast.md +9 -3
  42. package/dist/ai/BbTooltip.md +71 -9
  43. package/dist/ai/ChipsBox.md +1 -1
  44. package/dist/ai/CommonField.md +1 -1
  45. package/dist/ai/OptionsContainer.md +42 -0
  46. package/dist/ai/changelog.json +494 -6
  47. package/dist/ai/components.json +50 -48
  48. package/dist/ai/composables/useBbConfig.md +8 -1
  49. package/dist/ai/composables/useConfirm.md +39 -1
  50. package/dist/ai/design-tokens.json +6 -6
  51. package/dist/ai/guides/agent-contract.md +2 -2
  52. package/dist/ai/guides/ai-router.md +24 -23
  53. package/dist/ai/guides/app-layout.md +5 -0
  54. package/dist/ai/guides/component-picker.md +9 -2
  55. package/dist/ai/guides/design-language.md +24 -24
  56. package/dist/ai/guides/design-tokens.md +15 -8
  57. package/dist/ai/guides/icons-policy.md +9 -2
  58. package/dist/ai/guides/inertia-helpers.md +1183 -301
  59. package/dist/ai/guides/installation-and-plugin-setup.md +12 -2
  60. package/dist/ai/guides/migration/adoption-checklist.md +235 -0
  61. package/dist/ai/guides/migration/components/bb-checkbox-group.md +16 -15
  62. package/dist/ai/guides/migration/components/bb-dialog.md +9 -9
  63. package/dist/ai/guides/migration/components/bb-dropdown.md +7 -2
  64. package/dist/ai/guides/migration/components/bb-popover.md +4 -2
  65. package/dist/ai/guides/migration/components/bb-select.md +19 -0
  66. package/dist/ai/guides/migration/components/bb-table.md +1 -0
  67. package/dist/ai/guides/migration/components/bb-toast.md +4 -0
  68. package/dist/ai/guides/migration/components/bb-tooltip.md +15 -12
  69. package/dist/ai/guides/migration/components/use-confirm.md +25 -2
  70. package/dist/ai/guides/migration/v2-to-v3.md +211 -9
  71. package/dist/ai/guides/migration/v3-beta-css-classes.md +7 -3
  72. package/dist/ai/guides/options-items-playbook.md +2 -1
  73. package/dist/ai/guides/passthrough.md +149 -85
  74. package/dist/ai/guides/preset-components.md +140 -15
  75. package/dist/ai/helpers/definePreset.json +7 -0
  76. package/dist/ai/helpers/definePreset.ts +123 -11
  77. package/dist/ai/helpers/inertia/manifest.json +151 -62
  78. package/dist/ai/helpers/inertia/messages.ts +33 -0
  79. package/dist/ai/helpers/inertia/useConfirmOnRouteLeave.ts +120 -20
  80. package/dist/ai/helpers/inertia/useHasChanged.ts +34 -16
  81. package/dist/ai/helpers/inertia/useLazyProp.ts +102 -36
  82. package/dist/ai/helpers/inertia/useLazyPropGetter.ts +3 -1
  83. package/dist/ai/helpers/inertia/usePaginatedResponseContext.ts +154 -34
  84. package/dist/ai/helpers/inertia/usePromiseForm.ts +121 -14
  85. package/dist/ai/helpers/inertia/useQuery.ts +133 -11
  86. package/dist/ai/helpers/inertia/useQueryObject.ts +74 -67
  87. package/dist/ai/helpers/inertia/useResourceContext.ts +60 -14
  88. package/dist/ai/helpers/inertia/useRouteQuery.ts +38 -27
  89. package/dist/ai/helpers/inertia/useScreenSizes.ts +9 -7
  90. package/dist/ai/helpers/inertia/useTableContext.ts +5 -2
  91. package/dist/ai/helpers/inertia/utils.ts +14 -0
  92. package/dist/ai/index.md +1 -0
  93. package/dist/ai/manifest/common.json +0 -1
  94. package/dist/ai/manifest/components/BbAlert.json +7 -2
  95. package/dist/ai/manifest/components/BbBadge.json +13 -4
  96. package/dist/ai/manifest/components/BbBadge.tree.json +2 -0
  97. package/dist/ai/manifest/components/BbBadgeButton.json +4 -2
  98. package/dist/ai/manifest/components/BbBaseButton.json +4 -2
  99. package/dist/ai/manifest/components/BbBreadcrumbs.tree.json +1 -1
  100. package/dist/ai/manifest/components/BbButton.json +14 -3
  101. package/dist/ai/manifest/components/BbButton.tree.json +5 -1
  102. package/dist/ai/manifest/components/BbCheckboxGroup.json +13 -8
  103. package/dist/ai/manifest/components/BbCheckboxGroup.tree.json +11 -1
  104. package/dist/ai/manifest/components/BbColorInput.json +18 -15
  105. package/dist/ai/manifest/components/BbColorPalette.json +1 -1
  106. package/dist/ai/manifest/components/BbConfirm.json +4 -2
  107. package/dist/ai/manifest/components/BbConfirm.tree.json +1 -1
  108. package/dist/ai/manifest/components/BbDatePicker.json +1 -1
  109. package/dist/ai/manifest/components/BbDatePickerInput.json +17 -14
  110. package/dist/ai/manifest/components/BbDialog.tree.json +2 -1
  111. package/dist/ai/manifest/components/BbDropdown.json +24 -19
  112. package/dist/ai/manifest/components/BbDropdown.tree.json +9 -2
  113. package/dist/ai/manifest/components/BbDropdownButton.json +33 -20
  114. package/dist/ai/manifest/components/BbDropdownButton.tree.json +2 -2
  115. package/dist/ai/manifest/components/BbForm.json +2 -2
  116. package/dist/ai/manifest/components/BbHost.tree.json +1 -1
  117. package/dist/ai/manifest/components/BbHoverCard.json +1 -1
  118. package/dist/ai/manifest/components/BbIndicator.json +8 -2
  119. package/dist/ai/manifest/components/BbNumberInput.json +5 -2
  120. package/dist/ai/manifest/components/BbOffCanvas.json +2 -2
  121. package/dist/ai/manifest/components/BbOffCanvas.tree.json +1 -1
  122. package/dist/ai/manifest/components/BbPopover.json +1 -1
  123. package/dist/ai/manifest/components/BbRadioGroup.json +17 -12
  124. package/dist/ai/manifest/components/BbRadioGroup.tree.json +8 -1
  125. package/dist/ai/manifest/components/BbSelect.json +21 -18
  126. package/dist/ai/manifest/components/BbSelect.tree.json +2 -2
  127. package/dist/ai/manifest/components/BbSelectPopover.json +10 -10
  128. package/dist/ai/manifest/components/BbSelectPopover.tree.json +3 -2
  129. package/dist/ai/manifest/components/BbSwitchGroup.json +1 -1
  130. package/dist/ai/manifest/components/BbSwitchGroup.tree.json +3 -1
  131. package/dist/ai/manifest/components/BbTable.tree.json +14 -1
  132. package/dist/ai/manifest/components/BbTabs.json +9 -6
  133. package/dist/ai/manifest/components/BbTabs.tree.json +1 -1
  134. package/dist/ai/manifest/components/BbTabsList.json +6 -3
  135. package/dist/ai/manifest/components/BbTag.json +19 -16
  136. package/dist/ai/manifest/components/BbTag.tree.json +1 -1
  137. package/dist/ai/manifest/components/BbTextInput.json +6 -3
  138. package/dist/ai/manifest/components/BbTextarea.json +6 -3
  139. package/dist/ai/manifest/components/BbTimePicker.json +1 -1
  140. package/dist/ai/manifest/components/BbTimePickerInput.json +10 -7
  141. package/dist/ai/manifest/components/BbToast.json +7 -2
  142. package/dist/ai/manifest/components/BbToast.tree.json +4 -2
  143. package/dist/ai/manifest/components/BbTooltip.json +6 -5
  144. package/dist/ai/manifest/components/ChipsBox.tree.json +1 -1
  145. package/dist/ai/manifest/components/CommonField.json +1 -1
  146. package/dist/ai/manifest/components/OptionsContainer.json +3 -1
  147. package/dist/ai/manifest/components/OptionsContainer.tree.json +38 -0
  148. package/dist/ai/manifest/index.json +3 -3
  149. package/dist/ai/manifest/meta.json +5 -3
  150. package/dist/ai/manifest/types.advanced.json +5 -2
  151. package/dist/ai/manifest/types.api.json +9 -7
  152. package/dist/ai/recipes/inertia/approvals-inbox.md +1 -1
  153. package/dist/ai/recipes/inertia/inline-edit-workspace.md +1 -1
  154. package/dist/ai/recipes/inertia/layout-scaffold.md +19 -6
  155. package/dist/ai/recipes/inertia/ownership-atlas.md +1 -1
  156. package/dist/ai/recipes/inertia/records-workspace.md +50 -14
  157. package/dist/ai/recipes/inertia/upload-center.md +1 -1
  158. package/dist/ai/recipes/nuxt/layout-scaffold.md +19 -6
  159. package/dist/ai/recipes/nuxt/records-workspace.md +42 -12
  160. package/dist/ai/recipes/vue/layout-scaffold.md +19 -6
  161. package/dist/ai/recipes/vue/records-workspace.md +42 -12
  162. package/dist/ai/source/BbAlert.md +94 -76
  163. package/dist/ai/source/BbBadge.md +174 -72
  164. package/dist/ai/source/BbBadgeButton.md +130 -65
  165. package/dist/ai/source/BbBaseButton.md +46 -124
  166. package/dist/ai/source/BbBaseCheckboxIcon.md +38 -0
  167. package/dist/ai/source/BbBaseRadioIcon.md +18 -0
  168. package/dist/ai/source/BbBaseSwitchIcon.md +51 -0
  169. package/dist/ai/source/BbButton.md +153 -36
  170. package/dist/ai/source/BbCheckboxGroup.md +142 -18
  171. package/dist/ai/source/BbColorInput.md +240 -204
  172. package/dist/ai/source/BbColorPalette.md +7 -4
  173. package/dist/ai/source/BbConfirm.md +34 -11
  174. package/dist/ai/source/BbConfirmPortal.md +24 -9
  175. package/dist/ai/source/BbDatePicker.md +11 -7
  176. package/dist/ai/source/BbDatePickerInput.md +306 -269
  177. package/dist/ai/source/BbDialog.md +49 -14
  178. package/dist/ai/source/BbDropdown.md +314 -197
  179. package/dist/ai/source/BbDropdownButton.md +197 -31
  180. package/dist/ai/source/BbDropdownGroup.md +274 -176
  181. package/dist/ai/source/BbForm.md +50 -6
  182. package/dist/ai/source/BbHoverCard.md +12 -5
  183. package/dist/ai/source/BbIcon.md +4 -3
  184. package/dist/ai/source/BbIndicator.md +73 -52
  185. package/dist/ai/source/BbNumberInput.md +293 -257
  186. package/dist/ai/source/BbOffCanvas.md +55 -29
  187. package/dist/ai/source/BbPopover.md +14 -10
  188. package/dist/ai/source/BbRadioGroup.md +413 -297
  189. package/dist/ai/source/BbSelect.md +549 -435
  190. package/dist/ai/source/BbSelectPopover.md +153 -34
  191. package/dist/ai/source/BbSwitchGroup.md +70 -10
  192. package/dist/ai/source/BbTable.md +369 -37
  193. package/dist/ai/source/BbTabs.md +115 -39
  194. package/dist/ai/source/BbTabsList.md +106 -38
  195. package/dist/ai/source/BbTabsPanels.md +96 -36
  196. package/dist/ai/source/BbTabsRoot.md +96 -36
  197. package/dist/ai/source/BbTag.md +267 -233
  198. package/dist/ai/source/BbTextInput.md +261 -225
  199. package/dist/ai/source/BbTextarea.md +251 -215
  200. package/dist/ai/source/BbTimePicker.md +11 -7
  201. package/dist/ai/source/BbTimePickerInput.md +257 -220
  202. package/dist/ai/source/BbToast.md +73 -32
  203. package/dist/ai/source/BbToastPortal.md +65 -30
  204. package/dist/ai/source/BbTooltip.md +148 -113
  205. package/dist/ai/source/CommonPopover.md +6 -1
  206. package/dist/ai/source/FlatListBox.md +19 -9
  207. package/dist/ai/source/GroupedListBox.md +19 -9
  208. package/dist/ai/source/OptionsContainer.md +25 -9
  209. package/dist/components/BbAlert/BbAlert.vue_vue_type_script_setup_true_lang.js +61 -36
  210. package/dist/components/BbAlert/types.d.ts +9 -5
  211. package/dist/components/BbAlert/types.js +8 -3
  212. package/dist/components/BbBadge/BadgeBodyContent.vue.d.ts +3 -3
  213. package/dist/components/BbBadge/BadgeBodyContent.vue_vue_type_script_setup_true_lang.js +26 -17
  214. package/dist/components/BbBadge/BbBadge.vue_vue_type_script_setup_true_lang.js +103 -50
  215. package/dist/components/BbBadge/BbBadgeButton.vue_vue_type_script_setup_true_lang.js +20 -15
  216. package/dist/components/BbBadge/badgeButtonContext.d.ts +12 -1
  217. package/dist/components/BbBadge/types.d.ts +45 -15
  218. package/dist/components/BbBadge/types.js +12 -3
  219. package/dist/components/BbBaseButton/BbBaseButton.vue_vue_type_script_setup_true_lang.js +89 -126
  220. package/dist/components/BbBaseButton/types.d.ts +23 -4
  221. package/dist/components/BbBaseButton/types.js +7 -1
  222. package/dist/components/BbBaseButton/useLinkState.d.ts +41 -0
  223. package/dist/components/BbBaseButton/useLinkState.js +70 -0
  224. package/dist/components/BbButton/BbButton.vue_vue_type_script_setup_true_lang.js +130 -74
  225. package/dist/components/BbButton/types.d.ts +50 -13
  226. package/dist/components/BbButton/types.js +10 -3
  227. package/dist/components/BbCheckboxGroup/BbCheckboxGroup.vue_vue_type_script_setup_true_lang.js +148 -95
  228. package/dist/components/BbCheckboxGroup/types.d.ts +34 -11
  229. package/dist/components/BbCheckboxGroup/types.js +9 -4
  230. package/dist/components/BbCollapsible/BbCollapsible.vue.d.ts +1 -1
  231. package/dist/components/BbColorInput/BbColorInput.vue_vue_type_script_setup_true_lang.js +134 -93
  232. package/dist/components/BbColorInput/types.d.ts +11 -4
  233. package/dist/components/BbColorInput/types.js +9 -3
  234. package/dist/components/BbConfirm/BbConfirm.vue_vue_type_script_setup_true_lang.js +82 -59
  235. package/dist/components/BbConfirm/types.d.ts +9 -4
  236. package/dist/components/BbConfirm/types.js +8 -3
  237. package/dist/components/BbDatePicker/BbDatePicker.vue.d.ts +1 -1
  238. package/dist/components/BbDatePicker/BbDatePicker.vue_vue_type_script_setup_true_lang.js +68 -67
  239. package/dist/components/BbDatePickerInput/BbDatePickerInput.vue.d.ts +1 -1
  240. package/dist/components/BbDatePickerInput/BbDatePickerInput.vue_vue_type_script_setup_true_lang.js +259 -215
  241. package/dist/components/BbDatePickerInput/types.d.ts +12 -5
  242. package/dist/components/BbDatePickerInput/types.js +9 -3
  243. package/dist/components/BbDialog/BbDialog.vue_vue_type_script_setup_true_lang.js +223 -219
  244. package/dist/components/BbDialog/useDialogStack.d.ts +1 -1
  245. package/dist/components/BbDropdown/AdaptiveDropdown.vue_vue_type_script_setup_true_lang.js +104 -89
  246. package/dist/components/BbDropdown/BbDropdown.vue.d.ts +1 -0
  247. package/dist/components/BbDropdown/BbDropdown.vue_vue_type_script_setup_true_lang.js +323 -285
  248. package/dist/components/BbDropdown/BbDropdownList.vue.d.ts +1 -0
  249. package/dist/components/BbDropdown/BbDropdownList.vue_vue_type_script_setup_true_lang.js +411 -319
  250. package/dist/components/BbDropdown/DropdownPipelineResolver.vue_vue_type_script_setup_true_lang.js +100 -98
  251. package/dist/components/BbDropdown/DropdownRow.vue.d.ts +4 -3
  252. package/dist/components/BbDropdown/DropdownRow.vue_vue_type_script_setup_true_lang.js +49 -28
  253. package/dist/components/BbDropdown/normalizeGroups.d.ts +6 -0
  254. package/dist/components/BbDropdown/normalizeGroups.js +21 -15
  255. package/dist/components/BbDropdown/types.d.ts +59 -12
  256. package/dist/components/BbDropdown/types.js +16 -3
  257. package/dist/components/BbDropdown/useDropdownContext.d.ts +6 -0
  258. package/dist/components/BbDropdownButton/BbDropdownButton.vue.d.ts +2 -1
  259. package/dist/components/BbDropdownButton/BbDropdownButton.vue_vue_type_script_setup_true_lang.js +179 -68
  260. package/dist/components/BbDropdownButton/types.d.ts +44 -16
  261. package/dist/components/BbDropdownButton/types.js +28 -3
  262. package/dist/components/BbForm/BbForm.vue_vue_type_script_setup_true_lang.js +111 -89
  263. package/dist/components/BbForm/formSchema.d.ts +13 -0
  264. package/dist/components/BbHoverCard/BbHoverCard.vue_vue_type_script_setup_true_lang.js +100 -100
  265. package/dist/components/BbIndicator/BbIndicator.vue_vue_type_script_setup_true_lang.js +40 -25
  266. package/dist/components/BbIndicator/types.d.ts +9 -5
  267. package/dist/components/BbIndicator/types.js +8 -3
  268. package/dist/components/BbNumberInput/BbNumberInput.vue_vue_type_script_setup_true_lang.js +243 -202
  269. package/dist/components/BbNumberInput/types.d.ts +12 -5
  270. package/dist/components/BbNumberInput/types.js +9 -3
  271. package/dist/components/BbOffCanvas/BbOffCanvas.vue.d.ts +1 -1
  272. package/dist/components/BbOffCanvas/BbOffCanvas.vue_vue_type_script_setup_true_lang.js +401 -399
  273. package/dist/components/BbOffCanvas/types.d.ts +6 -2
  274. package/dist/components/BbPopover/BbPopover.vue_vue_type_script_setup_true_lang.js +81 -80
  275. package/dist/components/BbRadioGroup/BbRadioGroup.vue_vue_type_script_setup_true_lang.js +158 -105
  276. package/dist/components/BbRadioGroup/types.d.ts +21 -7
  277. package/dist/components/BbRadioGroup/types.js +9 -4
  278. package/dist/components/BbSelect/BbSelect.vue.d.ts +4 -3
  279. package/dist/components/BbSelect/BbSelect.vue_vue_type_script_setup_true_lang.js +181 -137
  280. package/dist/components/BbSelect/types.d.ts +36 -22
  281. package/dist/components/BbSelect/types.js +22 -3
  282. package/dist/components/BbSelectPopover/BbSelectPopover.vue.d.ts +4 -4
  283. package/dist/components/BbSelectPopover/BbSelectPopover.vue_vue_type_script_setup_true_lang.js +600 -577
  284. package/dist/components/BbSelectPopover/knownItems.d.ts +5 -0
  285. package/dist/components/BbSelectPopover/types.d.ts +46 -12
  286. package/dist/components/BbSmoothHeight/BbSmoothHeight.vue.d.ts +1 -1
  287. package/dist/components/BbSwitchGroup/BbSwitchGroup.vue_vue_type_script_setup_true_lang.js +2 -2
  288. package/dist/components/BbSwitchGroup/types.d.ts +14 -4
  289. package/dist/components/BbSwitchGroup/types.js +8 -3
  290. package/dist/components/BbTable/BbTable.vue_vue_type_script_setup_true_lang.js +1102 -995
  291. package/dist/components/BbTable/estimatedFloors.golden.d.ts +25 -0
  292. package/dist/components/BbTable/measuredFloors.d.ts +46 -0
  293. package/dist/components/BbTable/measuredFloors.js +322 -0
  294. package/dist/components/BbTable/measuredFloorsTestKit.d.ts +27 -0
  295. package/dist/components/BbTable/textRuler.d.ts +71 -0
  296. package/dist/components/BbTable/textRuler.js +121 -0
  297. package/dist/components/BbTable/utils.d.ts +113 -6
  298. package/dist/components/BbTable/utils.js +118 -65
  299. package/dist/components/BbTabs/BbTabs.vue_vue_type_script_setup_true_lang.js +53 -35
  300. package/dist/components/BbTabs/BbTabsList.vue_vue_type_script_setup_true_lang.js +62 -45
  301. package/dist/components/BbTabs/types.d.ts +26 -11
  302. package/dist/components/BbTabs/types.js +23 -8
  303. package/dist/components/BbTag/BbTag.vue_vue_type_script_setup_true_lang.js +205 -164
  304. package/dist/components/BbTag/types.d.ts +11 -4
  305. package/dist/components/BbTag/types.js +9 -3
  306. package/dist/components/BbTextInput/BbTextInput.vue_vue_type_script_setup_true_lang.js +98 -57
  307. package/dist/components/BbTextInput/types.d.ts +12 -5
  308. package/dist/components/BbTextInput/types.js +9 -3
  309. package/dist/components/BbTextarea/BbTextarea.vue_vue_type_script_setup_true_lang.js +137 -96
  310. package/dist/components/BbTextarea/types.d.ts +12 -5
  311. package/dist/components/BbTextarea/types.js +9 -3
  312. package/dist/components/BbTimePicker/BbTimePicker.vue_vue_type_script_setup_true_lang.js +105 -104
  313. package/dist/components/BbTimePickerInput/BbTimePickerInput.vue_vue_type_script_setup_true_lang.js +241 -197
  314. package/dist/components/BbTimePickerInput/types.d.ts +12 -5
  315. package/dist/components/BbTimePickerInput/types.js +9 -3
  316. package/dist/components/BbToast/BbToast.vue_vue_type_script_setup_true_lang.js +74 -32
  317. package/dist/components/BbToast/BbToastMessage.vue_vue_type_script_setup_true_lang.js +47 -47
  318. package/dist/components/BbToast/types.d.ts +10 -5
  319. package/dist/components/BbToast/types.js +18 -3
  320. package/dist/components/BbTooltip/BbTooltip.vue_vue_type_script_setup_true_lang.js +85 -71
  321. package/dist/components/BbTooltip/types.d.ts +13 -8
  322. package/dist/components/BbTooltip/types.js +8 -3
  323. package/dist/components/CommonField/CommonField.vue.d.ts +1 -1
  324. package/dist/components/CommonPopover/CommonPopover.vue.d.ts +1 -1
  325. package/dist/components/CommonPopover/CommonPopover.vue_vue_type_script_setup_true_lang.js +69 -69
  326. package/dist/components/FlatListBox/FlatListBox.vue_vue_type_script_setup_true_lang.js +53 -50
  327. package/dist/components/GroupedListBox/GroupedListBox.vue_vue_type_script_setup_true_lang.js +146 -143
  328. package/dist/components/OptionsContainer/OptionsContainer.vue_vue_type_script_setup_true_lang.js +7 -2
  329. package/dist/components/OptionsContainer/types.d.ts +14 -3
  330. package/dist/composables/useBbConfig.d.ts +1 -0
  331. package/dist/composables/useBbConfig.js +11 -7
  332. package/dist/composables/useBbFormContext.d.ts +4 -3
  333. package/dist/composables/useBbTabsContext.js +99 -85
  334. package/dist/composables/useChoiceIndicator.d.ts +58 -0
  335. package/dist/composables/useChoiceIndicator.js +197 -0
  336. package/dist/composables/useConfirm.d.ts +4 -4
  337. package/dist/composables/usePassthrough.d.ts +54 -1
  338. package/dist/composables/usePassthrough.js +100 -71
  339. package/dist/directives/bbTooltip.d.ts +12 -6
  340. package/dist/directives/createPopoverDirective.js +1 -1
  341. package/dist/index.d.ts +3 -1
  342. package/dist/llms-full.txt +3467 -801
  343. package/dist/llms-medium.txt +71 -53
  344. package/dist/llms.txt +2 -1
  345. package/dist/passthrough-deduper.js +6 -3
  346. package/dist/project-dts.d.ts +24 -0
  347. package/dist/project-dts.js +43 -17
  348. package/dist/styles.css +2 -2
  349. package/dist/types/AlertVariant.d.ts +14 -0
  350. package/dist/types/AlertVariant.js +9 -0
  351. package/dist/types/BadgeVariant.d.ts +14 -0
  352. package/dist/types/BadgeVariant.js +9 -0
  353. package/dist/types/ButtonVariant.d.ts +16 -0
  354. package/dist/types/ButtonVariant.js +11 -0
  355. package/dist/types/CheckboxVariant.d.ts +38 -0
  356. package/dist/types/CheckboxVariant.js +4 -0
  357. package/dist/types/CommonProps.d.ts +4 -3
  358. package/dist/types/Config.d.ts +7 -0
  359. package/dist/types/ConfirmVariant.d.ts +12 -0
  360. package/dist/types/ConfirmVariant.js +4 -0
  361. package/dist/types/DropdownItemVariant.d.ts +12 -0
  362. package/dist/types/DropdownItemVariant.js +4 -0
  363. package/dist/types/IndicatorVariant.d.ts +15 -0
  364. package/dist/types/IndicatorVariant.js +10 -0
  365. package/dist/types/InputVariant.d.ts +13 -0
  366. package/dist/types/InputVariant.js +8 -0
  367. package/dist/types/RadioVariant.d.ts +38 -0
  368. package/dist/types/RadioVariant.js +4 -0
  369. package/dist/types/TabsVariant.d.ts +13 -0
  370. package/dist/types/TabsVariant.js +8 -0
  371. package/dist/types/ToastVariant.d.ts +15 -0
  372. package/dist/types/ToastVariant.js +10 -0
  373. package/dist/types/TooltipVariant.d.ts +12 -0
  374. package/dist/types/TooltipVariant.js +4 -0
  375. package/dist/types/passthrough.d.ts +83 -15
  376. package/dist/types/passthrough.js +2 -2
  377. package/dist/types/ptComponentMap.d.ts +35 -23
  378. package/dist/utilities/functions/extractDomContainer.d.ts +20 -1
  379. package/dist/utilities/functions/extractDomContainer.js +8 -3
  380. package/dist/utils/focusVisibility.d.ts +6 -0
  381. package/dist/utils/focusVisibility.js +4 -1
  382. package/dist/utils/passthroughDeduper.d.ts +14 -0
  383. package/dist/utils/versionCheck.js +1 -1
  384. package/dist/vite-plugin.d.ts +64 -7
  385. package/dist/vite.js +385 -259
  386. package/llms.txt +2 -1
  387. package/package.json +5 -4
  388. package/scripts/lib/adoption-checklist.json +312 -0
  389. package/scripts/lib/eslint-plugin.d.ts +13 -0
  390. package/scripts/lib/eslint-plugin.mjs +75 -11
  391. package/scripts/lib/helpers-add.mjs +26 -2
  392. package/scripts/lib/idiom-scan.mjs +65 -0
  393. package/scripts/lib/mcp-config.mjs +203 -9
  394. package/scripts/lib/migrate-fix.mjs +42 -1
  395. package/scripts/lib/project-variant-dts.mjs +18 -0
  396. package/scripts/lib/validate-bb-markup.mjs +99 -2
@@ -295,6 +295,7 @@ import {
295
295
  formControlPtActive,
296
296
  SEGMENTED_CONTROL_NATIVE_ATTRS,
297
297
  usePassthrough,
298
+ variantPt,
298
299
  } from '@/composables/usePassthrough';
299
300
  import {
300
301
  useSegmentedFields,
@@ -323,7 +324,11 @@ import {
323
324
  type TimePickerInputError,
324
325
  } from './types';
325
326
 
326
- defineOptions({ inheritAttrs: false });
327
+ defineOptions({
328
+ // An app's own variants as declared `pt:<part>:<name>` props (Q76.7).
329
+ mixins: [variantPt(BB_TIME_PICKER_INPUT_PT)],
330
+ inheritAttrs: false,
331
+ });
327
332
  const declaredProps = withDefaults(defineProps<BbTimePickerInputProps>(), {
328
333
  // `undefined` (declared, not omitted) keeps `adaptive` three-state so
329
334
  // `props.adaptive ?? config.adaptive` reaches the config default, while the
@@ -411,6 +416,11 @@ const passthrough = usePassthrough({
411
416
  // used, which is not what `open` promises.
412
417
  open: () => shown.value,
413
418
  },
419
+ variant: {
420
+ ...BB_TIME_PICKER_INPUT_PT.variant,
421
+ // CommonFieldInput's default.
422
+ current: () => props.variant ?? 'outline',
423
+ },
414
424
  });
415
425
 
416
426
  type FieldKey = 'hour' | 'minute' | 'second' | 'meridiem';
@@ -1161,13 +1171,19 @@ onBeforeUnmount(() => {
1161
1171
 
1162
1172
  ```ts
1163
1173
  import type { Responsive } from '@/types/ResponsiveSize';
1164
- import type { InputVariantType } from '@/types/InputVariant';
1174
+ import {
1175
+ INPUT_VARIANTS,
1176
+ type InputVariantBuiltIn,
1177
+ type InputVariantRegistry,
1178
+ type InputVariantType,
1179
+ } from '@/types/InputVariant';
1165
1180
  import {
1166
1181
  type FormControlPtState,
1167
1182
  type PtMap,
1168
1183
  type PtValue,
1169
1184
  TEXT_CONTROL_PT_PARTS,
1170
1185
  type TextControlPtPart,
1186
+ type PtVariantAttrs,
1171
1187
  } from '@/types/passthrough';
1172
1188
  import type { HTMLAttributes, InputHTMLAttributes } from 'vue';
1173
1189
  import type { FieldCrossAlign, FieldLayout } from '@/types/FieldLayout';
@@ -1260,7 +1276,19 @@ export const BB_TIME_PICKER_INPUT_PT = {
1260
1276
  'open',
1261
1277
  'loading',
1262
1278
  ],
1279
+ // The input `variant` is a state on the field's parts (Q76.7), below
1280
+ // the real states; a picker's panel and rows are not the field's.
1281
+ variant: {
1282
+ names: INPUT_VARIANTS,
1283
+ option: 'inputVariants',
1284
+ parts: [...TEXT_CONTROL_PT_PARTS, 'activator'],
1285
+ },
1263
1286
  } as const satisfies {
1287
+ variant: {
1288
+ names: readonly InputVariantBuiltIn[];
1289
+ option: string;
1290
+ parts: ReadonlyArray<TextControlPtPart | 'activator'>;
1291
+ };
1264
1292
  parts: readonly BbTimePickerInputPtPart[];
1265
1293
  states: readonly BbTimePickerInputPtState[];
1266
1294
  };
@@ -1271,224 +1299,233 @@ export const BB_TIME_PICKER_INPUT_PT = {
1271
1299
  export type BbTimePickerInputProps = {
1272
1300
  [K in
1273
1301
  | `pt:${BbTimePickerInputPtPart}`
1274
- | `pt:${BbTimePickerInputPtPart}:${BbTimePickerInputPtState}`]?: PtValue;
1275
- } & {
1276
- /**
1277
- * Passthrough, object form: the same keys as the `pt:*` attributes
1278
- * without the prefix. See the `pt:<part>` row.
1279
- */
1280
- pt?: PtMap<BbTimePickerInputPtPart, BbTimePickerInputPtState>;
1281
- /**
1282
- * On mobile the time columns open inside a bottom off-canvas sheet instead
1283
- * of a floating popover. When unset, falls back to the global
1284
- * `config.adaptive`.
1285
- * @defaultValue `config.adaptive` (`true`)
1286
- */
1287
- adaptive?: boolean;
1288
-
1289
- /**
1290
- * 12-hour display with an AM/PM segment. Purely a field-composition
1291
- * concern: the model stays 24-hour. Type `A`/`P` (or ArrowUp/Down) to set
1292
- * the meridiem.
1293
- */
1294
- ampm?: boolean;
1295
-
1296
- /** Name of the icon to be added at the end of the input. */
1297
- 'append:icon'?: IconType;
1298
-
1299
- /**
1300
- * Guides the browser as to the type of information expected in the field.
1301
- * @defaultValue `'off'`
1302
- */
1303
- autocomplete?: InputHTMLAttributes['autocomplete'];
1304
-
1305
- /** Focuses the field when it mounts (a dialog already open included), unless the user is typing in another field. */
1306
- autofocus?: InputHTMLAttributes['autofocus'];
1307
-
1308
- /** Displays a clear button when the input has a value and is being interacted with. */
1309
- clearable?: boolean;
1310
-
1311
- /**
1312
- * Compact density: the field uses the `-compact` twins of `--bb-input-h`,
1313
- * `--bb-input-py` and `--bb-label-spacing-y`, so a `--bb-input-h` set on
1314
- * the component is ignored while it is on. Size a compact field with
1315
- * `--bb-input-h-compact` (and `--bb-input-py-compact`).
1316
- */
1317
- compact?: boolean;
1318
-
1319
- /**
1320
- * The field box's look, with `BbButton`'s names and tokens. Colours only,
1321
- * so a form never reflows; `'ghost'` has no border in any state, `'none'`
1322
- * no look at all (you own hover, focus and the states). Register more with
1323
- * the plugin's `inputVariants`.
1324
- *
1325
- * @defaultValue `'outline'`
1326
- */
1327
- variant?: InputVariantType;
1328
-
1329
- /**
1330
- * Descriptive text displayed below the label and above the input. Always
1331
- * visible and linked to the input via `aria-describedby` (after any
1332
- * `errors` / `warnings`, before the `hint`).
1333
- */
1334
- description?: string;
1335
-
1336
- /**
1337
- * How label and input sit together: `'vertical'`, `'horizontal'` (50/50),
1338
- * `'auto'`, `'label-fill'`, `'input-fill'`, a ratio like `'xx xxxxx'`, or a
1339
- * per-breakpoint map (`{ default: 'vertical', md: 'xx xxxxx' }`).
1340
- */
1341
- layout?: Responsive<FieldLayout>;
1342
-
1343
- /**
1344
- * Vertical position of the label block in a side-by-side row; not
1345
- * `labelPosition`, the horizontal one. Omitted, the label's first line
1346
- * meets the control's.
1347
- */
1348
- labelAlign?: FieldCrossAlign;
1349
-
1350
- /**
1351
- * Vertical position of the control in a side-by-side row; not
1352
- * `inputPosition`, the horizontal one. Omitted, the control's first line
1353
- * meets the label's.
1354
- */
1355
- inputAlign?: FieldCrossAlign;
1356
-
1357
- /** Disables the component. */
1358
- disabled?: boolean;
1359
-
1360
- /**
1361
- * Disables typing into the input.
1362
- * Use `'mobile'` / `'desktop'` to disable typing on one platform only.
1363
- * @defaultValue `false`
1364
- */
1365
- disableWriting?: boolean | 'mobile' | 'desktop';
1366
-
1367
- /**
1368
- * Error messages under the field, a string or string array. They render in
1369
- * an `aria-live="polite"` region and are referenced first from the segment
1370
- * inputs' `aria-describedby`, so they are re-read when a segment regains
1371
- * focus.
1372
- */
1373
- errors?: string | string[];
1374
-
1375
- /**
1376
- * Define if the component should be in an error state.
1377
- * It usually attaches a CSS class for styling purposes.
1378
- */
1379
- hasErrors?: boolean;
1380
-
1381
- /**
1382
- * Warning messages under the field, a string or array: amber, in their own
1383
- * `aria-live` region and in the control's `aria-describedby` after the
1384
- * errors. Non-empty turns on the warning state; errors win when both are
1385
- * set.
1386
- */
1387
- warnings?: string | string[];
1388
-
1389
- /**
1390
- * Define if the component should be in a warning state.
1391
- * Same chrome as errors with `--bb-warn`; errors take priority.
1392
- */
1393
- hasWarnings?: boolean;
1394
-
1395
- /** Visually hides the label of the input while maintaining accessibility. */
1396
- hideLabel?: boolean;
1397
-
1398
- /** Text box to be displayed near the input, usually to indicate instructions. */
1399
- hint?: string;
1400
-
1401
- /**
1402
- * The `id` of the native control; the label's `for` and the description
1403
- * and message ids derive from it. Generated when omitted.
1404
- */
1405
- id?: HTMLAttributes['id'];
1406
-
1407
- /** Text content of the label of the element. */
1408
- label: string;
1409
-
1410
- /** Label rendering mode. */
1411
- labelMode?: 'outside' | 'floating' | 'inside';
1412
-
1413
- /** Sets the text alignment of the label. */
1414
- labelPosition?: 'left' | 'center' | 'right';
1415
-
1416
- /** Sets the component in a loading state, usually triggering some visual styles. */
1417
- loading?: boolean;
1418
-
1419
- /**
1420
- * Maximum selectable time, `HH:mm` (other shapes throw at setup). The
1421
- * columns disable the entries no in-range time can use; a typed value (or
1422
- * an hour beside an out-of-range minute) is clamped with a `disabled_time`
1423
- * error.
1424
- */
1425
- max?: string;
1426
-
1427
- /**
1428
- * Minimum selectable time, `HH:mm` (other shapes throw at setup). The
1429
- * columns disable the entries no in-range time can use; a typed value (or
1430
- * an hour beside an out-of-range minute) is clamped with a `disabled_time`
1431
- * error.
1432
- */
1433
- min?: string;
1434
-
1435
- /**
1436
- * v-model value: `null` for empty, a 24-hour `HH:mm` (or `HH:mm:ss` with
1437
- * `seconds`) string, or a two-element array when `range` is true.
1438
- */
1439
- modelValue?: string | string[] | null;
1440
-
1441
- /** Defines the name of the input. */
1442
- name?: InputHTMLAttributes['name'];
1443
-
1444
- /**
1445
- * Props for the phone sheet (the `BbOffCanvas` that `adaptive` renders on
1446
- * mobile), spread over its defaults. A `pt` inside it styles only the sheet
1447
- * (passthrough guide § Inside the sheet). The sheet hides its ✕; `{
1448
- * hideClose: false }` brings it back.
1449
- */
1450
- offCanvasProps?: Partial<BbOffCanvasProps>;
1451
-
1452
- /** Keeps the hint displayed. */
1453
- persistentHint?: boolean;
1454
-
1455
- /** Text shown while the field is empty. */
1456
- placeholder?: InputHTMLAttributes['placeholder'];
1457
-
1458
- /** Name of the icon to be added at the start of the input. */
1459
- 'prepend:icon'?: IconType;
1460
-
1461
- /**
1462
- * Range selection: v-model expects a two-element array `[start, end]`.
1463
- * An inverted pair swaps on finalize with an `end_before_start` error.
1464
- */
1465
- range?: boolean;
1466
-
1467
- /** Sets the input in a readonly state. */
1468
- readonly?: boolean;
1469
-
1470
- /** Sets the input as required. */
1471
- required?: boolean;
1472
-
1473
- /** Reverses the layout: the order of the label and the input is swapped. */
1474
- reverse?: boolean;
1475
-
1476
- /**
1477
- * Adds the seconds segment. Without it an incoming value carrying seconds
1478
- * displays truncated and zeroes out on the next user commit.
1479
- */
1480
- seconds?: boolean;
1481
-
1482
- /**
1483
- * Minute granularity for the popover minute column.
1484
- * Constrains what the columns produce, never what typing accepts; ArrowUp/Down on a segment always step by 1.
1485
- * @defaultValue `1`
1486
- */
1487
- step?: number;
1488
-
1489
- /** Transition duration, in milliseconds, for the popover appearance. */
1490
- transitionDuration?: number;
1491
- } & FormFieldProps<string | string[] | null>;
1302
+ | `pt:${BbTimePickerInputPtPart}:${BbTimePickerInputPtState}`
1303
+ | `pt:${TextControlPtPart}:${InputVariantBuiltIn}`
1304
+ | `pt:activator:${InputVariantBuiltIn}`]?: PtValue;
1305
+ } & /* @vue-ignore */ PtVariantAttrs<
1306
+ TextControlPtPart | 'activator',
1307
+ keyof InputVariantRegistry
1308
+ > & {
1309
+ /**
1310
+ * Passthrough, object form: the same keys as the `pt:*` attributes
1311
+ * without the prefix. See the `pt:<part>` row.
1312
+ */
1313
+ /* eslint-disable @typescript-eslint/consistent-indexed-object-style -- mapped, never Record (T23) */
1314
+ pt?: PtMap<BbTimePickerInputPtPart, BbTimePickerInputPtState> & {
1315
+ [K in `${TextControlPtPart | 'activator'}:${InputVariantBuiltIn | keyof InputVariantRegistry}`]?: PtValue;
1316
+ };
1317
+ /* eslint-enable @typescript-eslint/consistent-indexed-object-style */
1318
+ /**
1319
+ * On mobile the time columns open inside a bottom off-canvas sheet instead
1320
+ * of a floating popover. When unset, falls back to the global
1321
+ * `config.adaptive`.
1322
+ * @defaultValue `config.adaptive` (`true`)
1323
+ */
1324
+ adaptive?: boolean;
1325
+
1326
+ /**
1327
+ * 12-hour display with an AM/PM segment. Purely a field-composition
1328
+ * concern: the model stays 24-hour. Type `A`/`P` (or ArrowUp/Down) to set
1329
+ * the meridiem.
1330
+ */
1331
+ ampm?: boolean;
1332
+
1333
+ /** Name of the icon to be added at the end of the input. */
1334
+ 'append:icon'?: IconType;
1335
+
1336
+ /**
1337
+ * Guides the browser as to the type of information expected in the field.
1338
+ * @defaultValue `'off'`
1339
+ */
1340
+ autocomplete?: InputHTMLAttributes['autocomplete'];
1341
+
1342
+ /** Focuses the field when it mounts (a dialog already open included), unless the user is typing in another field. */
1343
+ autofocus?: InputHTMLAttributes['autofocus'];
1344
+
1345
+ /** Displays a clear button when the input has a value and is being interacted with. */
1346
+ clearable?: boolean;
1347
+
1348
+ /**
1349
+ * Compact density: the field uses the `-compact` twins of `--bb-input-h`,
1350
+ * `--bb-input-py` and `--bb-label-spacing-y`, so a `--bb-input-h` set on
1351
+ * the component is ignored while it is on. Size a compact field with
1352
+ * `--bb-input-h-compact` (and `--bb-input-py-compact`).
1353
+ */
1354
+ compact?: boolean;
1355
+
1356
+ /**
1357
+ * The field box's look, with `BbButton`'s names and tokens. Colours only,
1358
+ * so a form never reflows; `'ghost'` has no border in any state, `'none'`
1359
+ * no look at all (you own hover, focus and the states). Register more with
1360
+ * the plugin's `inputVariants`.
1361
+ *
1362
+ * @defaultValue `'outline'`
1363
+ */
1364
+ variant?: InputVariantType;
1365
+
1366
+ /**
1367
+ * Descriptive text displayed below the label and above the input. Always
1368
+ * visible and linked to the input via `aria-describedby` (after any
1369
+ * `errors` / `warnings`, before the `hint`).
1370
+ */
1371
+ description?: string;
1372
+
1373
+ /**
1374
+ * How label and input sit together: `'vertical'`, `'horizontal'` (50/50),
1375
+ * `'auto'`, `'label-fill'`, `'input-fill'`, a ratio like `'xx xxxxx'`, or a
1376
+ * per-breakpoint map (`{ default: 'vertical', md: 'xx xxxxx' }`).
1377
+ */
1378
+ layout?: Responsive<FieldLayout>;
1379
+
1380
+ /**
1381
+ * Vertical position of the label block in a side-by-side row; not
1382
+ * `labelPosition`, the horizontal one. Omitted, the label's first line
1383
+ * meets the control's.
1384
+ */
1385
+ labelAlign?: FieldCrossAlign;
1386
+
1387
+ /**
1388
+ * Vertical position of the control in a side-by-side row; not
1389
+ * `inputPosition`, the horizontal one. Omitted, the control's first line
1390
+ * meets the label's.
1391
+ */
1392
+ inputAlign?: FieldCrossAlign;
1393
+
1394
+ /** Disables the component. */
1395
+ disabled?: boolean;
1396
+
1397
+ /**
1398
+ * Disables typing into the input.
1399
+ * Use `'mobile'` / `'desktop'` to disable typing on one platform only.
1400
+ * @defaultValue `false`
1401
+ */
1402
+ disableWriting?: boolean | 'mobile' | 'desktop';
1403
+
1404
+ /**
1405
+ * Error messages under the field, a string or string array. They render in
1406
+ * an `aria-live="polite"` region and are referenced first from the segment
1407
+ * inputs' `aria-describedby`, so they are re-read when a segment regains
1408
+ * focus.
1409
+ */
1410
+ errors?: string | string[];
1411
+
1412
+ /**
1413
+ * Define if the component should be in an error state.
1414
+ * It usually attaches a CSS class for styling purposes.
1415
+ */
1416
+ hasErrors?: boolean;
1417
+
1418
+ /**
1419
+ * Warning messages under the field, a string or array: amber, in their own
1420
+ * `aria-live` region and in the control's `aria-describedby` after the
1421
+ * errors. Non-empty turns on the warning state; errors win when both are
1422
+ * set.
1423
+ */
1424
+ warnings?: string | string[];
1425
+
1426
+ /**
1427
+ * Define if the component should be in a warning state.
1428
+ * Same chrome as errors with `--bb-warn`; errors take priority.
1429
+ */
1430
+ hasWarnings?: boolean;
1431
+
1432
+ /** Visually hides the label of the input while maintaining accessibility. */
1433
+ hideLabel?: boolean;
1434
+
1435
+ /** Text box to be displayed near the input, usually to indicate instructions. */
1436
+ hint?: string;
1437
+
1438
+ /**
1439
+ * The `id` of the native control; the label's `for` and the description
1440
+ * and message ids derive from it. Generated when omitted.
1441
+ */
1442
+ id?: HTMLAttributes['id'];
1443
+
1444
+ /** Text content of the label of the element. */
1445
+ label: string;
1446
+
1447
+ /** Label rendering mode. */
1448
+ labelMode?: 'outside' | 'floating' | 'inside';
1449
+
1450
+ /** Sets the text alignment of the label. */
1451
+ labelPosition?: 'left' | 'center' | 'right';
1452
+
1453
+ /** Sets the component in a loading state, usually triggering some visual styles. */
1454
+ loading?: boolean;
1455
+
1456
+ /**
1457
+ * Maximum selectable time, `HH:mm` (other shapes throw at setup). The
1458
+ * columns disable the entries no in-range time can use; a typed value (or
1459
+ * an hour beside an out-of-range minute) is clamped with a `disabled_time`
1460
+ * error.
1461
+ */
1462
+ max?: string;
1463
+
1464
+ /**
1465
+ * Minimum selectable time, `HH:mm` (other shapes throw at setup). The
1466
+ * columns disable the entries no in-range time can use; a typed value (or
1467
+ * an hour beside an out-of-range minute) is clamped with a `disabled_time`
1468
+ * error.
1469
+ */
1470
+ min?: string;
1471
+
1472
+ /**
1473
+ * v-model value: `null` for empty, a 24-hour `HH:mm` (or `HH:mm:ss` with
1474
+ * `seconds`) string, or a two-element array when `range` is true.
1475
+ */
1476
+ modelValue?: string | string[] | null;
1477
+
1478
+ /** Defines the name of the input. */
1479
+ name?: InputHTMLAttributes['name'];
1480
+
1481
+ /**
1482
+ * Props for the phone sheet (the `BbOffCanvas` that `adaptive` renders on
1483
+ * mobile), spread over its defaults. A `pt` inside it styles only the sheet
1484
+ * (passthrough guide § Inside the sheet). The sheet hides its ✕; `{
1485
+ * hideClose: false }` brings it back.
1486
+ */
1487
+ offCanvasProps?: Partial<BbOffCanvasProps>;
1488
+
1489
+ /** Keeps the hint displayed. */
1490
+ persistentHint?: boolean;
1491
+
1492
+ /** Text shown while the field is empty. */
1493
+ placeholder?: InputHTMLAttributes['placeholder'];
1494
+
1495
+ /** Name of the icon to be added at the start of the input. */
1496
+ 'prepend:icon'?: IconType;
1497
+
1498
+ /**
1499
+ * Range selection: v-model expects a two-element array `[start, end]`.
1500
+ * An inverted pair swaps on finalize with an `end_before_start` error.
1501
+ */
1502
+ range?: boolean;
1503
+
1504
+ /** Sets the input in a readonly state. */
1505
+ readonly?: boolean;
1506
+
1507
+ /** Sets the input as required. */
1508
+ required?: boolean;
1509
+
1510
+ /** Reverses the layout: the order of the label and the input is swapped. */
1511
+ reverse?: boolean;
1512
+
1513
+ /**
1514
+ * Adds the seconds segment. Without it an incoming value carrying seconds
1515
+ * displays truncated and zeroes out on the next user commit.
1516
+ */
1517
+ seconds?: boolean;
1518
+
1519
+ /**
1520
+ * Minute granularity for the popover minute column.
1521
+ * Constrains what the columns produce, never what typing accepts; ArrowUp/Down on a segment always step by 1.
1522
+ * @defaultValue `1`
1523
+ */
1524
+ step?: number;
1525
+
1526
+ /** Transition duration, in milliseconds, for the popover appearance. */
1527
+ transitionDuration?: number;
1528
+ } & FormFieldProps<string | string[] | null>;
1492
1529
 
1493
1530
  export type BbTimePickerInputEvents = {
1494
1531
  /** Emitted as soon as the time panel (the popover, or the sheet on a phone) starts to open. */