bitboss-ui 3.0.0-beta.4 → 3.0.0-beta.41

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 (937) hide show
  1. package/README.md +317 -98
  2. package/bin/bitboss-ui-mcp.mjs +1566 -75
  3. package/bin/bitboss-ui.mjs +716 -72
  4. package/dist/ai/BbAccordion.md +178 -56
  5. package/dist/ai/BbAlert.md +140 -28
  6. package/dist/ai/BbAsterisk.md +61 -4
  7. package/dist/ai/BbAvatar.md +194 -53
  8. package/dist/ai/BbBadge.md +250 -50
  9. package/dist/ai/BbBadgeButton.md +74 -21
  10. package/dist/ai/BbBaseButton.md +132 -51
  11. package/dist/ai/BbBaseCheckboxIcon.md +118 -26
  12. package/dist/ai/BbBaseRadioIcon.md +115 -26
  13. package/dist/ai/BbBaseSwitchIcon.md +123 -28
  14. package/dist/ai/BbBreadcrumbs.md +221 -51
  15. package/dist/ai/BbButton.md +389 -107
  16. package/dist/ai/BbCalendar.md +667 -0
  17. package/dist/ai/BbCheckbox.md +242 -80
  18. package/dist/ai/BbCheckboxGroup.md +575 -66
  19. package/dist/ai/BbCollapsible.md +158 -39
  20. package/dist/ai/BbColorInput.md +322 -82
  21. package/dist/ai/BbColorPalette.md +261 -61
  22. package/dist/ai/BbConfirm.md +220 -51
  23. package/dist/ai/BbConfirmPortal.md +1 -1
  24. package/dist/ai/BbDatePicker.md +272 -37
  25. package/dist/ai/BbDatePickerInput.md +321 -92
  26. package/dist/ai/BbDialog.md +492 -87
  27. package/dist/ai/BbDropdown.md +1182 -104
  28. package/dist/ai/BbDropdownButton.md +239 -61
  29. package/dist/ai/BbDropdownGroup.md +5 -5
  30. package/dist/ai/BbDropzone.md +140 -36
  31. package/dist/ai/BbForm.md +1165 -40
  32. package/dist/ai/BbIcon.md +100 -33
  33. package/dist/ai/BbIndicator.md +79 -12
  34. package/dist/ai/BbNumberInput.md +257 -87
  35. package/dist/ai/BbOffCanvas.md +396 -91
  36. package/dist/ai/BbPagination.md +199 -32
  37. package/dist/ai/BbPopover.md +219 -54
  38. package/dist/ai/BbProgress.md +137 -71
  39. package/dist/ai/BbPtScope.md +136 -0
  40. package/dist/ai/BbRadio.md +234 -43
  41. package/dist/ai/BbRadioGroup.md +529 -91
  42. package/dist/ai/BbRating.md +243 -61
  43. package/dist/ai/BbSelect.md +690 -120
  44. package/dist/ai/BbSelectPopover.md +434 -122
  45. package/dist/ai/BbSlider.md +275 -79
  46. package/dist/ai/BbSmoothHeight.md +142 -34
  47. package/dist/ai/BbSpinner.md +179 -81
  48. package/dist/ai/BbSwitch.md +249 -63
  49. package/dist/ai/BbSwitchGroup.md +394 -65
  50. package/dist/ai/BbTable.md +1666 -222
  51. package/dist/ai/BbTabs.md +898 -178
  52. package/dist/ai/BbTabsList.md +81 -7
  53. package/dist/ai/BbTabsPanels.md +77 -0
  54. package/dist/ai/BbTabsRoot.md +16 -15
  55. package/dist/ai/BbTag.md +256 -76
  56. package/dist/ai/BbTextInput.md +480 -102
  57. package/dist/ai/BbTextarea.md +310 -96
  58. package/dist/ai/BbTimePicker.md +159 -24
  59. package/dist/ai/BbTimePickerInput.md +277 -46
  60. package/dist/ai/BbToast.md +286 -40
  61. package/dist/ai/BbToastPortal.md +3 -3
  62. package/dist/ai/BbTooltip.md +187 -34
  63. package/dist/ai/BbTree.md +260 -85
  64. package/dist/ai/ChipsBox.md +43 -2
  65. package/dist/ai/ClearableButton.md +12 -0
  66. package/dist/ai/CommaBox.md +2 -1
  67. package/dist/ai/CommonField.md +63 -0
  68. package/dist/ai/CommonFieldInput.md +90 -0
  69. package/dist/ai/CommonPopover.md +17 -12
  70. package/dist/ai/CommonTimeSelector.md +63 -0
  71. package/dist/ai/ErrorIcon.md +20 -0
  72. package/dist/ai/FlatListBox.md +41 -11
  73. package/dist/ai/GroupedListBox.md +42 -12
  74. package/dist/ai/ListBox.md +46 -11
  75. package/dist/ai/OptionsContainer.md +13 -10
  76. package/dist/ai/WarningIcon.md +20 -0
  77. package/dist/ai/changelog.json +4025 -141
  78. package/dist/ai/components.json +51872 -10136
  79. package/dist/ai/composables/useBbConfig.md +72 -11
  80. package/dist/ai/composables/useBbDropdownContext.md +168 -0
  81. package/dist/ai/composables/useBbFormContext.md +51 -24
  82. package/dist/ai/composables/useBbFormField.md +134 -0
  83. package/dist/ai/composables/useBbTableContext.md +41 -19
  84. package/dist/ai/composables/useConfirm.md +16 -8
  85. package/dist/ai/composables/useCountdown.md +1 -1
  86. package/dist/ai/composables/useId.md +10 -10
  87. package/dist/ai/composables/useMobile.md +17 -10
  88. package/dist/ai/composables/useToast.md +25 -19
  89. package/dist/ai/design-tokens.json +940 -0
  90. package/dist/ai/design-tokens.manifest.yaml +175 -0
  91. package/dist/ai/guides/agent-contract.md +168 -22
  92. package/dist/ai/guides/ai-router.md +79 -40
  93. package/dist/ai/guides/app-layout.md +8 -4
  94. package/dist/ai/guides/coherence-playbook.md +8 -8
  95. package/dist/ai/guides/component-picker.md +42 -34
  96. package/dist/ai/guides/design-language.md +274 -97
  97. package/dist/ai/guides/design-tokens.md +493 -105
  98. package/dist/ai/guides/fetch-items-playbook.md +22 -16
  99. package/dist/ai/guides/icons-policy.md +67 -35
  100. package/dist/ai/guides/inertia-helpers.md +4 -1
  101. package/dist/ai/guides/inline-edit-playbook.md +13 -6
  102. package/dist/ai/guides/installation-and-plugin-setup.md +817 -73
  103. package/dist/ai/guides/migration/components/bb-accordion.md +37 -0
  104. package/dist/ai/guides/migration/components/bb-alert.md +2 -2
  105. package/dist/ai/guides/migration/components/bb-avatar.md +13 -14
  106. package/dist/ai/guides/migration/components/bb-badge.md +5 -5
  107. package/dist/ai/guides/migration/components/bb-breadcrumbs.md +9 -8
  108. package/dist/ai/guides/migration/components/bb-button.md +80 -20
  109. package/dist/ai/guides/migration/components/bb-checkbox-group.md +116 -29
  110. package/dist/ai/guides/migration/components/bb-checkbox.md +53 -10
  111. package/dist/ai/guides/migration/components/bb-chip.md +6 -6
  112. package/dist/ai/guides/migration/components/bb-collapsible.md +5 -5
  113. package/dist/ai/guides/migration/components/bb-color-input.md +5 -5
  114. package/dist/ai/guides/migration/components/bb-color-palette.md +16 -9
  115. package/dist/ai/guides/migration/components/bb-date-picker-input.md +45 -35
  116. package/dist/ai/guides/migration/components/bb-dialog.md +69 -36
  117. package/dist/ai/guides/migration/components/bb-dropdown-button.md +7 -1
  118. package/dist/ai/guides/migration/components/bb-dropdown.md +31 -8
  119. package/dist/ai/guides/migration/components/bb-dropzone.md +8 -0
  120. package/dist/ai/guides/migration/components/bb-icon.md +7 -7
  121. package/dist/ai/guides/migration/components/bb-intersection.md +1 -1
  122. package/dist/ai/guides/migration/components/bb-offcanvas.md +29 -31
  123. package/dist/ai/guides/migration/components/bb-pagination.md +10 -0
  124. package/dist/ai/guides/migration/components/bb-popover.md +19 -11
  125. package/dist/ai/guides/migration/components/bb-radio-group.md +14 -0
  126. package/dist/ai/guides/migration/components/bb-rating.md +61 -24
  127. package/dist/ai/guides/migration/components/bb-select-popover.md +9 -1
  128. package/dist/ai/guides/migration/components/bb-select.md +21 -4
  129. package/dist/ai/guides/migration/components/bb-slider.md +14 -6
  130. package/dist/ai/guides/migration/components/bb-switch-group.md +14 -0
  131. package/dist/ai/guides/migration/components/bb-table.md +574 -33
  132. package/dist/ai/guides/migration/components/bb-tabs.md +91 -41
  133. package/dist/ai/guides/migration/components/bb-tag.md +9 -7
  134. package/dist/ai/guides/migration/components/bb-text-input.md +12 -12
  135. package/dist/ai/guides/migration/components/bb-toast.md +2 -2
  136. package/dist/ai/guides/migration/components/bb-tooltip.md +18 -0
  137. package/dist/ai/guides/migration/components/bb-tree.md +11 -9
  138. package/dist/ai/guides/migration/components/use-confirm.md +9 -1
  139. package/dist/ai/guides/migration/v2-to-v3.md +828 -240
  140. package/dist/ai/guides/migration/v3-beta-css-classes.md +751 -0
  141. package/dist/ai/guides/migration/v3-beta-tooling.md +119 -0
  142. package/dist/ai/guides/options-items-playbook.md +161 -12
  143. package/dist/ai/guides/page-shell.md +1 -1
  144. package/dist/ai/guides/passthrough.md +958 -0
  145. package/dist/ai/guides/preset-components.md +361 -0
  146. package/dist/ai/guides/ssr-prefill.md +127 -0
  147. package/dist/ai/guides/validated-forms.md +466 -55
  148. package/dist/ai/guides/validation-libraries.md +171 -0
  149. package/dist/ai/guides/validation-providers.md +113 -0
  150. package/dist/ai/index.md +45 -44
  151. package/dist/ai/recipes/inertia/approvals-inbox.md +26 -10
  152. package/dist/ai/recipes/inertia/command-palette.md +2 -2
  153. package/dist/ai/recipes/inertia/inline-edit-workspace.md +46 -30
  154. package/dist/ai/recipes/inertia/layout-scaffold.md +6 -2
  155. package/dist/ai/recipes/inertia/onboarding.md +30 -8
  156. package/dist/ai/recipes/inertia/ownership-atlas.md +72 -49
  157. package/dist/ai/recipes/inertia/record-form.md +53 -19
  158. package/dist/ai/recipes/inertia/records-workspace.md +201 -49
  159. package/dist/ai/recipes/inertia/settings-workspace.md +3809 -0
  160. package/dist/ai/recipes/inertia/upload-center.md +54 -43
  161. package/dist/ai/recipes/inertia/wizard-form.md +98 -14
  162. package/dist/ai/recipes/nuxt/approvals-inbox.md +26 -10
  163. package/dist/ai/recipes/nuxt/command-palette.md +2 -2
  164. package/dist/ai/recipes/nuxt/inline-edit-workspace.md +68 -52
  165. package/dist/ai/recipes/nuxt/layout-scaffold.md +6 -2
  166. package/dist/ai/recipes/nuxt/onboarding.md +30 -8
  167. package/dist/ai/recipes/nuxt/record-form.md +66 -22
  168. package/dist/ai/recipes/nuxt/records-workspace.md +199 -48
  169. package/dist/ai/recipes/nuxt/settings-workspace.md +3898 -0
  170. package/dist/ai/recipes/nuxt/upload-center.md +52 -41
  171. package/dist/ai/recipes/nuxt/wizard-form.md +98 -14
  172. package/dist/ai/recipes/vue/approvals-inbox.md +28 -12
  173. package/dist/ai/recipes/vue/command-palette.md +2 -2
  174. package/dist/ai/recipes/vue/inline-edit-workspace.md +69 -53
  175. package/dist/ai/recipes/vue/layout-scaffold.md +6 -2
  176. package/dist/ai/recipes/vue/onboarding.md +32 -8
  177. package/dist/ai/recipes/vue/record-form.md +81 -54
  178. package/dist/ai/recipes/vue/records-workspace.md +198 -49
  179. package/dist/ai/recipes/vue/settings-workspace.md +3836 -0
  180. package/dist/ai/recipes/vue/upload-center.md +53 -42
  181. package/dist/ai/recipes/vue/wizard-form.md +97 -14
  182. package/dist/ai/source/BbAccordion.md +90 -24
  183. package/dist/ai/source/BbAlert.md +209 -62
  184. package/dist/ai/source/BbAsterisk.md +54 -4
  185. package/dist/ai/source/BbAvatar.md +73 -16
  186. package/dist/ai/source/BbBadge.md +265 -97
  187. package/dist/ai/source/BbBadgeButton.md +218 -79
  188. package/dist/ai/source/BbBaseButton.md +108 -12
  189. package/dist/ai/source/BbBaseCheckboxIcon.md +151 -36
  190. package/dist/ai/source/BbBaseRadioIcon.md +121 -17
  191. package/dist/ai/source/BbBaseSwitchIcon.md +138 -28
  192. package/dist/ai/source/BbBreadcrumbs.md +363 -69
  193. package/dist/ai/source/BbButton.md +563 -174
  194. package/dist/ai/source/BbCalendar.md +1744 -0
  195. package/dist/ai/source/BbCheckbox.md +470 -68
  196. package/dist/ai/source/BbCheckboxGroup.md +976 -95
  197. package/dist/ai/source/BbCollapsible.md +96 -8
  198. package/dist/ai/source/BbColorInput.md +597 -67
  199. package/dist/ai/source/BbColorPalette.md +1284 -65
  200. package/dist/ai/source/BbConfirm.md +149 -7
  201. package/dist/ai/source/BbConfirmPortal.md +89 -3
  202. package/dist/ai/source/BbDatePicker.md +527 -381
  203. package/dist/ai/source/BbDatePickerInput.md +2015 -118
  204. package/dist/ai/source/BbDialog.md +531 -64
  205. package/dist/ai/source/BbDropdown.md +885 -175
  206. package/dist/ai/source/BbDropdownButton.md +377 -79
  207. package/dist/ai/source/BbDropdownGroup.md +687 -96
  208. package/dist/ai/source/BbDropzone.md +140 -31
  209. package/dist/ai/source/BbForm.md +875 -17
  210. package/dist/ai/source/BbIcon.md +130 -52
  211. package/dist/ai/source/BbIndicator.md +117 -60
  212. package/dist/ai/source/BbNumberInput.md +667 -84
  213. package/dist/ai/source/BbOffCanvas.md +1007 -261
  214. package/dist/ai/source/BbPagination.md +203 -31
  215. package/dist/ai/source/BbPopover.md +267 -90
  216. package/dist/ai/source/BbProgress.md +88 -26
  217. package/dist/ai/source/BbPtScope.md +54 -0
  218. package/dist/ai/source/BbRadio.md +388 -58
  219. package/dist/ai/source/BbRadioGroup.md +940 -109
  220. package/dist/ai/source/BbRating.md +736 -84
  221. package/dist/ai/source/BbSelect.md +1096 -96
  222. package/dist/ai/source/BbSelectPopover.md +807 -114
  223. package/dist/ai/source/BbSlider.md +1390 -98
  224. package/dist/ai/source/BbSmoothHeight.md +48 -2
  225. package/dist/ai/source/BbSpinner.md +62 -6
  226. package/dist/ai/source/BbSwitch.md +297 -60
  227. package/dist/ai/source/BbSwitchGroup.md +761 -83
  228. package/dist/ai/source/BbTable.md +6950 -1864
  229. package/dist/ai/source/BbTabs.md +368 -111
  230. package/dist/ai/source/BbTabsList.md +503 -146
  231. package/dist/ai/source/BbTabsPanels.md +625 -0
  232. package/dist/ai/source/BbTabsRoot.md +319 -100
  233. package/dist/ai/source/BbTag.md +796 -87
  234. package/dist/ai/source/BbTextInput.md +497 -68
  235. package/dist/ai/source/BbTextarea.md +550 -65
  236. package/dist/ai/source/BbTimePicker.md +395 -69
  237. package/dist/ai/source/BbTimePickerInput.md +1233 -106
  238. package/dist/ai/source/BbToast.md +250 -74
  239. package/dist/ai/source/BbToastPortal.md +210 -66
  240. package/dist/ai/source/BbTooltip.md +181 -30
  241. package/dist/ai/source/BbTree.md +76 -11
  242. package/dist/ai/source/ChipsBox.md +25 -5
  243. package/dist/ai/source/CommaBox.md +21 -6
  244. package/dist/ai/source/{BbBaseInputContainer.md → CommonField.md} +467 -250
  245. package/dist/ai/source/CommonFieldInput.md +848 -0
  246. package/dist/ai/source/CommonPopover.md +116 -30
  247. package/dist/ai/source/CommonTimeSelector.md +726 -0
  248. package/dist/ai/source/ErrorIcon.md +2 -2
  249. package/dist/ai/source/FlatListBox.md +188 -17
  250. package/dist/ai/source/GroupedListBox.md +236 -44
  251. package/dist/ai/source/GuidesComponent.md +14 -7
  252. package/dist/ai/source/ListBox.md +46 -8
  253. package/dist/ai/source/OptionsContainer.md +288 -60
  254. package/dist/ai/source/WarningIcon.md +2 -2
  255. package/dist/assets/css/reset.css_inline.js +1 -1
  256. package/dist/assets/svgs/star.svg_raw.js +4 -0
  257. package/dist/components/BbAccordion/BbAccordion.vue_vue_type_script_setup_true_lang.js +49 -32
  258. package/dist/components/BbAccordion/types.d.ts +35 -3
  259. package/dist/components/BbAccordion/types.js +11 -0
  260. package/dist/components/BbAlert/BbAlert.vue_vue_type_script_setup_true_lang.js +46 -30
  261. package/dist/components/BbAlert/types.d.ts +37 -3
  262. package/dist/components/BbAlert/types.js +13 -0
  263. package/dist/components/BbAsterisk/BbAsterisk.vue.d.ts +3 -1
  264. package/dist/components/BbAsterisk/BbAsterisk.vue_vue_type_script_setup_true_lang.js +23 -8
  265. package/dist/components/BbAsterisk/types.d.ts +18 -0
  266. package/dist/components/BbAsterisk/types.js +7 -0
  267. package/dist/components/BbAvatar/BbAvatar.vue.d.ts +1 -1
  268. package/dist/components/BbAvatar/BbAvatar.vue_vue_type_script_setup_true_lang.js +57 -44
  269. package/dist/components/BbAvatar/types.d.ts +23 -0
  270. package/dist/components/BbAvatar/types.js +7 -0
  271. package/dist/components/BbBadge/BadgeBodyContent.vue_vue_type_script_setup_true_lang.js +24 -18
  272. package/dist/components/BbBadge/BbBadge.vue_vue_type_script_setup_true_lang.js +96 -53
  273. package/dist/components/BbBadge/BbBadgeButton.vue_vue_type_script_setup_true_lang.js +27 -8
  274. package/dist/components/BbBadge/badgeButtonContext.d.ts +25 -8
  275. package/dist/components/BbBadge/types.d.ts +46 -3
  276. package/dist/components/BbBadge/types.js +13 -0
  277. package/dist/components/BbBaseButton/BbBaseButton.vue_vue_type_script_setup_true_lang.js +109 -96
  278. package/dist/components/BbBaseButton/RouterComponent.vue_vue_type_script_setup_true_lang.js +11 -11
  279. package/dist/components/BbBaseButton/types.d.ts +33 -3
  280. package/dist/components/BbBaseButton/types.js +9 -2
  281. package/dist/components/BbBaseCheckboxIcon/BbBaseCheckboxIcon.vue_vue_type_script_setup_true_lang.js +50 -18
  282. package/dist/components/BbBaseCheckboxIcon/types.d.ts +31 -2
  283. package/dist/components/BbBaseCheckboxIcon/types.js +8 -0
  284. package/dist/components/BbBaseRadioIcon/BbBaseRadioIcon.vue_vue_type_script_setup_true_lang.js +45 -15
  285. package/dist/components/BbBaseRadioIcon/types.d.ts +31 -2
  286. package/dist/components/BbBaseRadioIcon/types.js +8 -0
  287. package/dist/components/BbBaseSwitchIcon/BbBaseSwitchIcon.vue_vue_type_script_setup_true_lang.js +48 -16
  288. package/dist/components/BbBaseSwitchIcon/types.d.ts +31 -2
  289. package/dist/components/BbBaseSwitchIcon/types.js +8 -0
  290. package/dist/components/BbBreadcrumbs/BbBreadcrumbs.vue_vue_type_script_setup_true_lang.js +187 -132
  291. package/dist/components/BbBreadcrumbs/types.d.ts +45 -3
  292. package/dist/components/BbBreadcrumbs/types.js +12 -0
  293. package/dist/components/BbButton/BbButton.vue.d.ts +5 -0
  294. package/dist/components/BbButton/BbButton.vue_vue_type_script_setup_true_lang.js +107 -81
  295. package/dist/components/BbButton/types.d.ts +113 -2
  296. package/dist/components/BbButton/types.js +12 -0
  297. package/dist/components/BbCalendar/BbCalendar.vue.d.ts +34 -0
  298. package/dist/components/BbCalendar/BbCalendar.vue.js +6 -0
  299. package/dist/components/BbCalendar/BbCalendar.vue_vue_type_script_setup_true_lang.js +608 -0
  300. package/dist/components/BbCalendar/CalendarMonthPanel.vue.js +5 -0
  301. package/dist/components/BbCalendar/CalendarMonthPanel.vue_vue_type_script_setup_true_lang.js +124 -0
  302. package/dist/components/BbCalendar/CalendarYearPanel.vue.js +5 -0
  303. package/dist/components/BbCalendar/CalendarYearPanel.vue_vue_type_script_setup_true_lang.js +126 -0
  304. package/dist/components/BbCalendar/calendarHost.d.ts +29 -0
  305. package/dist/components/BbCalendar/calendarHost.js +10 -0
  306. package/dist/components/BbCalendar/types.d.ts +225 -0
  307. package/dist/components/BbCalendar/types.js +29 -0
  308. package/dist/components/{BbBaseDatePicker/useDatePickerContext.d.ts → BbCalendar/useCalendarContext.d.ts} +10 -7
  309. package/dist/components/BbCalendar/useCalendarContext.js +11 -0
  310. package/dist/components/BbCalendar/useCalendarGrid.d.ts +208 -0
  311. package/dist/components/BbCalendar/useCalendarGrid.js +274 -0
  312. package/dist/components/BbCalendar/useDayGrid.d.ts +79 -0
  313. package/dist/components/BbCalendar/useDayGrid.js +204 -0
  314. package/dist/components/BbCalendar/useToday.d.ts +23 -0
  315. package/dist/components/BbCalendar/useToday.js +21 -0
  316. package/dist/components/BbCheckbox/BbCheckbox.vue.d.ts +7 -7
  317. package/dist/components/BbCheckbox/BbCheckbox.vue_vue_type_script_setup_true_lang.js +214 -72
  318. package/dist/components/BbCheckbox/types.d.ts +180 -13
  319. package/dist/components/BbCheckbox/types.js +8 -0
  320. package/dist/components/BbCheckboxGroup/BbCheckboxGroup.vue.d.ts +15 -3
  321. package/dist/components/BbCheckboxGroup/BbCheckboxGroup.vue_vue_type_script_setup_true_lang.js +338 -90
  322. package/dist/components/BbCheckboxGroup/types.d.ts +195 -20
  323. package/dist/components/BbCheckboxGroup/types.js +10 -0
  324. package/dist/components/BbCollapsible/BbCollapsible.vue.d.ts +2 -1
  325. package/dist/components/BbCollapsible/BbCollapsible.vue_vue_type_script_setup_true_lang.js +41 -19
  326. package/dist/components/BbCollapsible/types.d.ts +44 -1
  327. package/dist/components/BbCollapsible/types.js +7 -0
  328. package/dist/components/BbColorInput/BbColorInput.vue.d.ts +17 -7
  329. package/dist/components/BbColorInput/BbColorInput.vue_vue_type_script_setup_true_lang.js +330 -86
  330. package/dist/components/BbColorInput/types.d.ts +230 -12
  331. package/dist/components/BbColorInput/types.js +24 -0
  332. package/dist/components/BbColorPalette/BbColorPalette.vue.d.ts +10 -2
  333. package/dist/components/BbColorPalette/BbColorPalette.vue_vue_type_script_setup_true_lang.js +515 -108
  334. package/dist/components/BbColorPalette/types.d.ts +76 -7
  335. package/dist/components/BbColorPalette/types.js +12 -0
  336. package/dist/components/BbConfirm/BbConfirm.vue.d.ts +2 -1
  337. package/dist/components/BbConfirm/BbConfirm.vue_vue_type_script_setup_true_lang.js +125 -76
  338. package/dist/components/BbConfirm/BbConfirmPortal.vue.d.ts +1 -0
  339. package/dist/components/BbConfirm/types.d.ts +49 -0
  340. package/dist/components/BbConfirm/types.js +17 -0
  341. package/dist/components/BbDatePicker/BbDatePicker.vue.d.ts +16 -10
  342. package/dist/components/BbDatePicker/BbDatePicker.vue_vue_type_script_setup_true_lang.js +320 -223
  343. package/dist/components/BbDatePicker/types.d.ts +111 -17
  344. package/dist/components/BbDatePicker/types.js +33 -0
  345. package/dist/components/BbDatePickerInput/BbDatePickerInput.vue.d.ts +16 -4
  346. package/dist/components/BbDatePickerInput/BbDatePickerInput.vue_vue_type_script_setup_true_lang.js +1172 -87
  347. package/dist/components/BbDatePickerInput/types.d.ts +224 -19
  348. package/dist/components/BbDatePickerInput/types.js +39 -0
  349. package/dist/components/BbDialog/BbDialog.vue.d.ts +3 -3
  350. package/dist/components/BbDialog/BbDialog.vue_vue_type_script_setup_true_lang.js +227 -136
  351. package/dist/components/BbDialog/types.d.ts +92 -3
  352. package/dist/components/BbDialog/types.js +16 -0
  353. package/dist/components/BbDialog/useDialogStack.d.ts +12 -0
  354. package/dist/components/BbDialog/useDialogStack.js +9 -2
  355. package/dist/components/BbDropdown/AdaptiveDropdown.vue.d.ts +2 -0
  356. package/dist/components/BbDropdown/AdaptiveDropdown.vue_vue_type_script_setup_true_lang.js +108 -96
  357. package/dist/components/BbDropdown/BbDropdown.vue.d.ts +10 -2
  358. package/dist/components/BbDropdown/BbDropdown.vue_vue_type_script_setup_true_lang.js +337 -268
  359. package/dist/components/BbDropdown/BbDropdownGroup.vue.d.ts +5 -1
  360. package/dist/components/BbDropdown/BbDropdownList.vue.d.ts +8 -2
  361. package/dist/components/BbDropdown/BbDropdownList.vue_vue_type_script_setup_true_lang.js +377 -293
  362. package/dist/components/BbDropdown/DropdownPipelineResolver.vue_vue_type_script_setup_true_lang.js +129 -118
  363. package/dist/components/BbDropdown/normalizeGroups.js +55 -31
  364. package/dist/components/BbDropdown/types.d.ts +288 -30
  365. package/dist/components/BbDropdown/types.js +21 -2
  366. package/dist/components/BbDropdown/useDropdownContext.d.ts +10 -4
  367. package/dist/components/BbDropdown/useDropdownGroupRegistry.d.ts +1 -0
  368. package/dist/components/BbDropdownButton/BbDropdownButton.vue.d.ts +18 -3
  369. package/dist/components/BbDropdownButton/BbDropdownButton.vue_vue_type_script_setup_true_lang.js +172 -40
  370. package/dist/components/BbDropdownButton/types.d.ts +137 -8
  371. package/dist/components/BbDropdownButton/types.js +35 -0
  372. package/dist/components/BbDropzone/BbDropzone.vue.d.ts +2 -2
  373. package/dist/components/BbDropzone/BbDropzone.vue_vue_type_script_setup_true_lang.js +186 -144
  374. package/dist/components/BbDropzone/types.d.ts +38 -4
  375. package/dist/components/BbDropzone/types.js +16 -0
  376. package/dist/components/BbForm/BbForm.vue.d.ts +94 -0
  377. package/dist/{validated → components/BbForm}/BbForm.vue.js +1 -1
  378. package/dist/components/BbForm/BbForm.vue_vue_type_script_setup_true_lang.js +317 -0
  379. package/dist/components/BbForm/BbFormCustomField.d.ts +14 -0
  380. package/dist/components/BbForm/BbFormCustomField.js +43 -0
  381. package/dist/components/BbForm/bindFormField.d.ts +16 -0
  382. package/dist/components/BbForm/bindFormField.js +85 -0
  383. package/dist/components/BbForm/formFields.d.ts +64 -0
  384. package/dist/components/BbForm/formFields.js +11 -0
  385. package/dist/components/BbForm/formSchema.d.ts +56 -0
  386. package/dist/components/BbForm/formSchema.js +196 -0
  387. package/dist/components/BbForm/standardSchema.d.ts +59 -0
  388. package/dist/components/BbIcon/BbIcon.vue_vue_type_script_setup_true_lang.js +58 -48
  389. package/dist/components/BbIcon/iconCache.d.ts +63 -0
  390. package/dist/components/BbIcon/iconCache.js +35 -0
  391. package/dist/components/BbIcon/types.d.ts +22 -2
  392. package/dist/components/BbIcon/types.js +7 -0
  393. package/dist/components/BbIndicator/BbIndicator.vue_vue_type_script_setup_true_lang.js +34 -21
  394. package/dist/components/BbIndicator/types.d.ts +24 -0
  395. package/dist/components/BbIndicator/types.js +7 -0
  396. package/dist/components/BbNumberInput/BbNumberInput.vue.d.ts +12 -8
  397. package/dist/components/BbNumberInput/BbNumberInput.vue_vue_type_script_setup_true_lang.js +308 -85
  398. package/dist/components/BbNumberInput/types.d.ts +201 -18
  399. package/dist/components/BbNumberInput/types.js +8 -0
  400. package/dist/components/BbOffCanvas/BbOffCanvas.vue.d.ts +3 -3
  401. package/dist/components/BbOffCanvas/BbOffCanvas.vue_vue_type_script_setup_true_lang.js +311 -210
  402. package/dist/components/BbOffCanvas/types.d.ts +79 -6
  403. package/dist/components/BbOffCanvas/types.js +15 -0
  404. package/dist/components/BbPagination/BbPagination.vue.d.ts +2 -2
  405. package/dist/components/BbPagination/BbPagination.vue_vue_type_script_setup_true_lang.js +125 -90
  406. package/dist/components/BbPagination/types.d.ts +38 -0
  407. package/dist/components/BbPagination/types.js +13 -0
  408. package/dist/components/BbPopover/BbPopover.vue.d.ts +4 -4
  409. package/dist/components/BbPopover/BbPopover.vue_vue_type_script_setup_true_lang.js +219 -179
  410. package/dist/components/BbPopover/types.d.ts +51 -5
  411. package/dist/components/BbPopover/types.js +14 -0
  412. package/dist/components/BbProgress/BbProgress.vue_vue_type_script_setup_true_lang.js +29 -16
  413. package/dist/components/BbProgress/types.d.ts +25 -0
  414. package/dist/components/BbProgress/types.js +7 -0
  415. package/dist/components/BbPtScope/BbPtScope.vue.d.ts +12 -0
  416. package/dist/components/BbPtScope/BbPtScope.vue.js +5 -0
  417. package/dist/components/BbPtScope/BbPtScope.vue_vue_type_script_setup_true_lang.js +13 -0
  418. package/dist/components/BbPtScope/types.d.ts +15 -0
  419. package/dist/components/BbRadio/BbRadio.vue.d.ts +7 -7
  420. package/dist/components/BbRadio/BbRadio.vue_vue_type_script_setup_true_lang.js +172 -59
  421. package/dist/components/BbRadio/types.d.ts +152 -13
  422. package/dist/components/BbRadio/types.js +8 -0
  423. package/dist/components/BbRadioGroup/BbRadioGroup.vue.d.ts +14 -2
  424. package/dist/components/BbRadioGroup/BbRadioGroup.vue_vue_type_script_setup_true_lang.js +319 -92
  425. package/dist/components/BbRadioGroup/types.d.ts +198 -22
  426. package/dist/components/BbRadioGroup/types.js +10 -0
  427. package/dist/components/BbRating/BbRating.vue.d.ts +10 -8
  428. package/dist/components/BbRating/BbRating.vue_vue_type_script_setup_true_lang.js +259 -78
  429. package/dist/components/BbRating/types.d.ts +174 -13
  430. package/dist/components/BbRating/types.js +21 -0
  431. package/dist/components/BbSelect/BbSelect.vue.d.ts +17 -3
  432. package/dist/components/BbSelect/BbSelect.vue_vue_type_script_setup_true_lang.js +553 -83
  433. package/dist/components/BbSelect/types.d.ts +235 -20
  434. package/dist/components/BbSelect/types.js +41 -0
  435. package/dist/components/BbSelectPopover/BbSelectPopover.vue.d.ts +15 -1
  436. package/dist/components/BbSelectPopover/BbSelectPopover.vue_vue_type_script_setup_true_lang.js +541 -391
  437. package/dist/components/BbSelectPopover/types.d.ts +124 -8
  438. package/dist/components/BbSelectPopover/types.js +24 -0
  439. package/dist/components/BbSlider/BbSlider.vue.d.ts +13 -8
  440. package/dist/components/BbSlider/BbSlider.vue_vue_type_script_setup_true_lang.js +472 -96
  441. package/dist/components/BbSlider/types.d.ts +202 -13
  442. package/dist/components/BbSlider/types.js +26 -0
  443. package/dist/components/BbSmoothHeight/BbSmoothHeight.vue.d.ts +1 -1
  444. package/dist/components/BbSmoothHeight/BbSmoothHeight.vue_vue_type_script_setup_true_lang.js +60 -48
  445. package/dist/components/BbSmoothHeight/types.d.ts +19 -0
  446. package/dist/components/BbSmoothHeight/types.js +7 -0
  447. package/dist/components/BbSpinner/BbSpinner.vue_vue_type_script_setup_true_lang.js +27 -14
  448. package/dist/components/BbSpinner/types.d.ts +22 -1
  449. package/dist/components/BbSpinner/types.js +7 -0
  450. package/dist/components/BbSwitch/BbSwitch.vue.d.ts +7 -7
  451. package/dist/components/BbSwitch/BbSwitch.vue_vue_type_script_setup_true_lang.js +220 -78
  452. package/dist/components/BbSwitch/types.d.ts +25 -10
  453. package/dist/components/BbSwitch/types.js +5 -0
  454. package/dist/components/BbSwitchGroup/BbSwitchGroup.vue.d.ts +14 -2
  455. package/dist/components/BbSwitchGroup/BbSwitchGroup.vue_vue_type_script_setup_true_lang.js +338 -90
  456. package/dist/components/BbSwitchGroup/types.d.ts +30 -7
  457. package/dist/components/BbSwitchGroup/types.js +5 -0
  458. package/dist/components/BbTable/BbTable.vue.d.ts +27 -6
  459. package/dist/components/BbTable/BbTable.vue_vue_type_script_setup_true_lang.js +2013 -685
  460. package/dist/components/BbTable/BbTableDataRow.d.ts +196 -0
  461. package/dist/components/BbTable/BbTableDataRow.js +151 -0
  462. package/dist/components/BbTable/BbTableExpandRow.d.ts +84 -0
  463. package/dist/components/BbTable/BbTableExpandRow.js +62 -0
  464. package/dist/components/BbTable/BbTableSelectToggle.d.ts +120 -0
  465. package/dist/components/BbTable/BbTableSelectToggle.js +122 -0
  466. package/dist/components/BbTable/gridWidgets.d.ts +30 -0
  467. package/dist/components/BbTable/gridWidgets.js +14 -0
  468. package/dist/components/BbTable/types.d.ts +473 -123
  469. package/dist/components/BbTable/types.js +31 -0
  470. package/dist/components/BbTable/utils.d.ts +145 -4
  471. package/dist/components/BbTable/utils.js +154 -37
  472. package/dist/components/BbTabs/BbTabs.vue.d.ts +3 -1
  473. package/dist/components/BbTabs/BbTabs.vue_vue_type_script_setup_true_lang.js +62 -26
  474. package/dist/components/BbTabs/BbTabsList.vue.d.ts +3 -10
  475. package/dist/components/BbTabs/BbTabsList.vue_vue_type_script_setup_true_lang.js +143 -81
  476. package/dist/components/BbTabs/BbTabsPanels.vue.d.ts +12 -0
  477. package/dist/components/{BbBaseSwitch/BbBaseSwitch.vue.js → BbTabs/BbTabsPanels.vue.js} +2 -2
  478. package/dist/components/BbTabs/BbTabsPanels.vue_vue_type_script_setup_true_lang.js +59 -0
  479. package/dist/components/BbTabs/BbTabsRoot.vue.d.ts +3 -1
  480. package/dist/components/BbTabs/BbTabsRoot.vue_vue_type_script_setup_true_lang.js +2 -1
  481. package/dist/components/BbTabs/types.d.ts +183 -23
  482. package/dist/components/BbTabs/types.js +34 -0
  483. package/dist/components/BbTag/BbTag.vue.d.ts +13 -10
  484. package/dist/components/BbTag/BbTag.vue_vue_type_script_setup_true_lang.js +383 -92
  485. package/dist/components/BbTag/types.d.ts +139 -14
  486. package/dist/components/BbTag/types.js +22 -0
  487. package/dist/components/BbTextInput/BbTextInput.vue.d.ts +10 -8
  488. package/dist/components/BbTextInput/BbTextInput.vue_vue_type_script_setup_true_lang.js +257 -84
  489. package/dist/components/BbTextInput/types.d.ts +168 -13
  490. package/dist/components/BbTextInput/types.js +8 -0
  491. package/dist/components/BbTextarea/BbTextarea.vue.d.ts +7 -7
  492. package/dist/components/BbTextarea/BbTextarea.vue_vue_type_script_setup_true_lang.js +291 -94
  493. package/dist/components/BbTextarea/types.d.ts +158 -14
  494. package/dist/components/BbTextarea/types.js +8 -0
  495. package/dist/components/BbTimePicker/BbTimePicker.vue.d.ts +12 -4
  496. package/dist/components/BbTimePicker/BbTimePicker.vue_vue_type_script_setup_true_lang.js +199 -122
  497. package/dist/components/BbTimePicker/types.d.ts +94 -7
  498. package/dist/components/BbTimePicker/types.js +18 -0
  499. package/dist/components/BbTimePickerInput/BbTimePickerInput.vue.d.ts +14 -4
  500. package/dist/components/BbTimePickerInput/BbTimePickerInput.vue_vue_type_script_setup_true_lang.js +749 -86
  501. package/dist/components/BbTimePickerInput/types.d.ts +171 -22
  502. package/dist/components/BbTimePickerInput/types.js +25 -0
  503. package/dist/components/BbToast/BbToast.vue_vue_type_script_setup_true_lang.js +63 -25
  504. package/dist/components/BbToast/BbToastMessage.vue.d.ts +4 -1
  505. package/dist/components/BbToast/BbToastMessage.vue_vue_type_script_setup_true_lang.js +79 -76
  506. package/dist/components/BbToast/BbToastPortal.vue.d.ts +1 -0
  507. package/dist/components/BbToast/BbToastRegion.vue.d.ts +4 -1
  508. package/dist/components/BbToast/BbToastRegion.vue_vue_type_script_setup_true_lang.js +72 -64
  509. package/dist/components/BbToast/types.d.ts +54 -1
  510. package/dist/components/BbToast/types.js +28 -0
  511. package/dist/components/BbTooltip/BbTooltip.vue_vue_type_script_setup_true_lang.js +104 -87
  512. package/dist/components/BbTooltip/types.d.ts +40 -2
  513. package/dist/components/BbTooltip/types.js +7 -0
  514. package/dist/components/BbTree/BbTree.vue.d.ts +15 -3
  515. package/dist/components/BbTree/BbTree.vue_vue_type_script_setup_true_lang.js +51 -29
  516. package/dist/components/BbTree/BbTreeLevel.vue.d.ts +1 -1
  517. package/dist/components/BbTree/BbTreeLevel.vue_vue_type_script_setup_true_lang.js +17 -16
  518. package/dist/components/BbTree/context.d.ts +9 -1
  519. package/dist/components/BbTree/types.d.ts +40 -5
  520. package/dist/components/BbTree/types.js +7 -0
  521. package/dist/components/ChipsBox/ChipsBox.vue_vue_type_script_setup_true_lang.js +46 -44
  522. package/dist/components/ChipsBox/types.d.ts +7 -0
  523. package/dist/components/ClearableButton/ClearableButton.vue_vue_type_script_setup_true_lang.js +5 -5
  524. package/dist/components/CommaBox/CommaBox.vue_vue_type_script_setup_true_lang.js +11 -7
  525. package/dist/components/CommaBox/types.d.ts +7 -0
  526. package/dist/components/{BbBaseInputContainer/BbBaseInputContainer.vue.d.ts → CommonField/CommonField.vue.d.ts} +5 -5
  527. package/dist/components/{BbBaseRadio/BbBaseRadio.vue.js → CommonField/CommonField.vue.js} +2 -2
  528. package/dist/components/CommonField/CommonField.vue_vue_type_script_setup_true_lang.js +189 -0
  529. package/dist/components/CommonField/messageHeightMatrix.d.ts +2 -0
  530. package/dist/components/{BbBaseInputContainer → CommonField}/types.d.ts +52 -16
  531. package/dist/components/{CommonInputWrapper/CommonInputWrapper.vue.d.ts → CommonFieldInput/CommonFieldInput.vue.d.ts} +5 -4
  532. package/dist/components/{BbBaseRadioGroup/BbBaseRadioGroup.vue.js → CommonFieldInput/CommonFieldInput.vue.js} +2 -2
  533. package/dist/components/CommonFieldInput/CommonFieldInput.vue_vue_type_script_setup_true_lang.js +120 -0
  534. package/dist/components/CommonFieldInput/boxBorderMatrix.d.ts +10 -0
  535. package/dist/components/{CommonInputWrapper → CommonFieldInput}/types.d.ts +27 -8
  536. package/dist/components/CommonPopover/CommonPopover.vue.d.ts +11 -2
  537. package/dist/components/CommonPopover/CommonPopover.vue_vue_type_script_setup_true_lang.js +76 -63
  538. package/dist/components/CommonPopover/types.d.ts +27 -8
  539. package/dist/components/{BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue.d.ts → CommonTimeSelector/CommonTimeSelector.vue.d.ts} +21 -2
  540. package/dist/components/{BbBaseColorPalette/BbBaseColorPalette.vue.js → CommonTimeSelector/CommonTimeSelector.vue.js} +2 -2
  541. package/dist/components/CommonTimeSelector/CommonTimeSelector.vue_vue_type_script_setup_true_lang.js +232 -0
  542. package/dist/components/CommonTimeSelector/types.d.ts +6 -0
  543. package/dist/components/FlatListBox/FlatListBox.vue.d.ts +5 -1
  544. package/dist/components/FlatListBox/FlatListBox.vue_vue_type_script_setup_true_lang.js +165 -95
  545. package/dist/components/FlatListBox/types.d.ts +24 -2
  546. package/dist/components/GroupedListBox/GroupedListBox.vue.d.ts +5 -1
  547. package/dist/components/GroupedListBox/GroupedListBox.vue_vue_type_script_setup_true_lang.js +217 -134
  548. package/dist/components/GroupedListBox/types.d.ts +24 -2
  549. package/dist/components/ListBox/ListBox.vue.d.ts +5 -1
  550. package/dist/components/ListBox/ListBox.vue_vue_type_script_setup_true_lang.js +95 -69
  551. package/dist/components/ListBox/types.d.ts +24 -2
  552. package/dist/components/OptionsContainer/OptionsContainer.vue.d.ts +1 -1
  553. package/dist/components/OptionsContainer/OptionsContainer.vue_vue_type_script_setup_true_lang.js +109 -37
  554. package/dist/components/OptionsContainer/types.d.ts +53 -9
  555. package/dist/components/Transitions/ScaleFade.vue_vue_type_script_setup_true_lang.js +8 -8
  556. package/dist/components/Transitions/Slide.vue.js +1 -1
  557. package/dist/composables/useBaseOptions.d.ts +12 -1
  558. package/dist/composables/useBaseOptions.js +77 -37
  559. package/dist/composables/useBbConfig.d.ts +27 -6
  560. package/dist/composables/useBbConfig.js +8 -2
  561. package/dist/composables/useBbDropdownContext.d.ts +5 -0
  562. package/dist/composables/useBbFormContext.d.ts +131 -8
  563. package/dist/composables/useBbFormContext.js +49 -30
  564. package/dist/composables/useBbFormField.d.ts +40 -0
  565. package/dist/composables/useBbFormField.js +39 -0
  566. package/dist/composables/useBbTableContext.d.ts +45 -1
  567. package/dist/composables/useBbTableContext.js +93 -87
  568. package/dist/composables/useBbTabsContext.d.ts +15 -9
  569. package/dist/composables/useBbTabsContext.js +121 -90
  570. package/dist/composables/useClosingInert.d.ts +4 -4
  571. package/dist/composables/useCoarsePointer.js +7 -10
  572. package/dist/composables/useCoherence.js +1 -1
  573. package/dist/composables/useConfig.d.ts +59 -0
  574. package/dist/composables/useConfig.js +15 -0
  575. package/dist/composables/useConfirm.d.ts +39 -7
  576. package/dist/composables/useConfirm.js +50 -41
  577. package/dist/composables/useEscapeStackEntry.d.ts +13 -0
  578. package/dist/composables/useEscapeStackEntry.js +16 -0
  579. package/dist/composables/useFormBinding.d.ts +116 -0
  580. package/dist/composables/useFormBinding.js +34 -0
  581. package/dist/composables/useHydrated.d.ts +18 -0
  582. package/dist/composables/useHydrated.js +13 -7
  583. package/dist/composables/useId.d.ts +4 -3
  584. package/dist/composables/useId.js +1 -7
  585. package/dist/composables/useItemsGetter.d.ts +11 -0
  586. package/dist/composables/useItemsGetter.js +44 -18
  587. package/dist/composables/useKeyboardInset.d.ts +28 -0
  588. package/dist/composables/useKeyboardInset.js +32 -0
  589. package/dist/composables/useLocale.js +10 -7
  590. package/dist/composables/useMobile.js +7 -10
  591. package/dist/composables/usePassthrough.d.ts +228 -0
  592. package/dist/composables/usePassthrough.js +247 -0
  593. package/dist/composables/usePrefill.d.ts +22 -2
  594. package/dist/composables/usePrefill.js +35 -19
  595. package/dist/composables/useSafeAreaInternal.js +1 -1
  596. package/dist/composables/useSegmentedFields.d.ts +2 -2
  597. package/dist/composables/useSsrState.d.ts +20 -0
  598. package/dist/composables/useSsrState.js +13 -0
  599. package/dist/composables/useTableWidthContext.d.ts +24 -4
  600. package/dist/composables/useTableWidthContext.js +31 -28
  601. package/dist/composables/useToast.d.ts +18 -1
  602. package/dist/composables/useToast.js +31 -18
  603. package/dist/composables/useToggleInput.d.ts +44 -0
  604. package/dist/composables/useToggleInput.js +39 -0
  605. package/dist/composables/useViewportWidth.d.ts +5 -25
  606. package/dist/composables/useViewportWidth.js +14 -7
  607. package/dist/deprecation/ai-deprecations.json.d.ts +1977 -289
  608. package/dist/deprecation/ai-deprecations.json.js +1 -1
  609. package/dist/deprecation/removedProps.js +9 -4
  610. package/dist/directives/bbDropdown.d.ts +15 -4
  611. package/dist/directives/bbDropdown.js +31 -9
  612. package/dist/directives/bbTooltip.d.ts +6 -0
  613. package/dist/directives/createPopoverDirective.d.ts +62 -0
  614. package/dist/directives/createPopoverDirective.js +92 -37
  615. package/dist/i18n/index.d.ts +10 -16
  616. package/dist/i18n/locales/cs.json +9 -5
  617. package/dist/i18n/locales/da.json +9 -5
  618. package/dist/i18n/locales/de.json +9 -5
  619. package/dist/i18n/locales/el.json +9 -5
  620. package/dist/i18n/locales/en.json +9 -5
  621. package/dist/i18n/locales/es.json +9 -5
  622. package/dist/i18n/locales/fi.json +9 -5
  623. package/dist/i18n/locales/fr.json +9 -5
  624. package/dist/i18n/locales/hu.json +9 -5
  625. package/dist/i18n/locales/it.json +9 -5
  626. package/dist/i18n/locales/ja.json +9 -5
  627. package/dist/i18n/locales/ko.json +9 -5
  628. package/dist/i18n/locales/nb.json +9 -5
  629. package/dist/i18n/locales/nl.json +9 -5
  630. package/dist/i18n/locales/pl.json +9 -5
  631. package/dist/i18n/locales/pt.json +9 -5
  632. package/dist/i18n/locales/ro.json +9 -5
  633. package/dist/i18n/locales/ru.json +9 -5
  634. package/dist/i18n/locales/sv.json +9 -5
  635. package/dist/i18n/locales/tr.json +9 -5
  636. package/dist/i18n/locales/uk.json +9 -5
  637. package/dist/i18n/locales/zh-cn.json +9 -5
  638. package/dist/icon-scan.d.ts +276 -0
  639. package/dist/icon-scan.js +485 -0
  640. package/dist/icons-whitelist.d.ts +5 -4
  641. package/dist/index.d.ts +40 -21
  642. package/dist/index.js +78 -71
  643. package/dist/llms-full.txt +61164 -27972
  644. package/dist/llms-medium.txt +1482 -366
  645. package/dist/llms.txt +32 -15
  646. package/dist/locale-blueprint.json +9 -5
  647. package/dist/nuxt-auto-imports.d.ts +76 -0
  648. package/dist/nuxt-auto-imports.js +32 -0
  649. package/dist/nuxt-module.d.ts +30 -15
  650. package/dist/nuxt.js +35 -9
  651. package/dist/passthrough-deduper.js +5 -0
  652. package/dist/plugin.d.ts +10 -1
  653. package/dist/plugin.js +29 -19
  654. package/dist/project-dts.d.ts +84 -0
  655. package/dist/project-dts.js +170 -0
  656. package/dist/reset.css +1 -1
  657. package/dist/runtime/nuxt-plugin.js +34 -21
  658. package/dist/styles.css +3 -2
  659. package/dist/types/AlertVariant.d.ts +10 -1
  660. package/dist/types/BadgeVariant.d.ts +16 -5
  661. package/dist/types/ButtonVariant.d.ts +12 -1
  662. package/dist/types/ColumnName.d.ts +30 -3
  663. package/dist/types/CommonProps.d.ts +2 -2
  664. package/dist/types/Config.d.ts +94 -1
  665. package/dist/types/ConfirmVariant.d.ts +8 -1
  666. package/dist/types/DropdownItemVariant.d.ts +8 -1
  667. package/dist/types/FieldLayout.d.ts +32 -0
  668. package/dist/types/IndicatorVariant.d.ts +11 -1
  669. package/dist/types/InputVariant.d.ts +30 -0
  670. package/dist/types/ItemProps.d.ts +50 -0
  671. package/dist/types/Option.d.ts +6 -0
  672. package/dist/types/PtScope.d.ts +15 -0
  673. package/dist/types/RegistryKey.d.ts +10 -0
  674. package/dist/types/TabsVariant.d.ts +25 -0
  675. package/dist/types/ToastVariant.d.ts +12 -2
  676. package/dist/types/TooltipVariant.d.ts +8 -1
  677. package/dist/types/passthrough.d.ts +362 -0
  678. package/dist/types/passthrough.js +78 -0
  679. package/dist/types/ptComponentMap.d.ts +62 -0
  680. package/dist/utilities/functions/hasVnodeListener.d.ts +16 -0
  681. package/dist/utilities/functions/hasVnodeListener.js +12 -0
  682. package/dist/utilities/functions/isImeComposing.d.ts +7 -0
  683. package/dist/utilities/functions/isImeComposing.js +4 -0
  684. package/dist/utilities/functions/itemProps.d.ts +46 -0
  685. package/dist/utilities/functions/itemProps.js +47 -0
  686. package/dist/utilities/functions/slotKey.d.ts +13 -8
  687. package/dist/utilities/functions/slotKey.js +78 -2
  688. package/dist/utilities/functions/snapToStep.js +2 -1
  689. package/dist/utilities/functions/toggleInput.d.ts +98 -0
  690. package/dist/utilities/functions/toggleInput.js +56 -0
  691. package/dist/utilities/functions/warnRemovedAttrs.d.ts +27 -1
  692. package/dist/utilities/functions/warnRemovedAttrs.js +75 -14
  693. package/dist/utilities/misc/listboxMetrics.d.ts +9 -3
  694. package/dist/utilities/misc/listboxMetrics.js +5 -2
  695. package/dist/utilities/misc/ssrStateInjectionKey.d.ts +42 -0
  696. package/dist/utilities/misc/ssrStateInjectionKey.js +4 -0
  697. package/dist/utils/cssLayers.d.ts +91 -0
  698. package/dist/utils/cssLayers.js +43 -0
  699. package/dist/utils/injectLibraryStyles.d.ts +3 -1
  700. package/dist/utils/injectLibraryStyles.js +24 -23
  701. package/dist/utils/overlayEscapeStack.d.ts +10 -0
  702. package/dist/utils/overlayEscapeStack.js +5 -3
  703. package/dist/utils/passthrough.d.ts +67 -0
  704. package/dist/utils/passthrough.js +100 -0
  705. package/dist/utils/passthroughDeduper.d.ts +2 -0
  706. package/dist/utils/ptScope.d.ts +8 -0
  707. package/dist/utils/ptScope.js +4 -0
  708. package/dist/utils/versionCheck.d.ts +19 -0
  709. package/dist/utils/versionCheck.js +18 -0
  710. package/dist/vite-plugin.d.ts +301 -53
  711. package/dist/vite.js +547 -375
  712. package/llms.txt +33 -16
  713. package/package.json +49 -27
  714. package/scripts/lib/check-fix.mjs +129 -0
  715. package/scripts/lib/component-attr-targets.ts +123 -0
  716. package/scripts/lib/component-tree.ts +648 -0
  717. package/scripts/lib/css-class-check.mjs +326 -0
  718. package/scripts/lib/css-class-surface.mjs +292 -0
  719. package/scripts/lib/css-color-resolve.mjs +172 -0
  720. package/scripts/lib/css-local-check.mjs +267 -0
  721. package/scripts/lib/design-token-manifest.mjs +499 -0
  722. package/scripts/lib/doc-sections.mjs +248 -0
  723. package/scripts/lib/ensure-manifest.mjs +28 -5
  724. package/scripts/lib/eslint-disable.mjs +141 -0
  725. package/scripts/lib/eslint-plugin.d.ts +64 -1
  726. package/scripts/lib/eslint-plugin.mjs +1285 -30
  727. package/scripts/lib/hand-imported-styles.mjs +326 -0
  728. package/scripts/lib/hand-roll-hints.mjs +50 -6
  729. package/scripts/lib/html-attributes.mjs +353 -0
  730. package/scripts/lib/local-components.mjs +177 -0
  731. package/scripts/lib/mcp-config.mjs +87 -58
  732. package/scripts/lib/migrate-fix.mjs +62 -3
  733. package/scripts/lib/project-variant-dts.mjs +122 -0
  734. package/scripts/lib/public-type-exports.mjs +273 -0
  735. package/scripts/lib/slot-key.mjs +147 -0
  736. package/scripts/lib/slot-renames.mjs +46 -0
  737. package/scripts/lib/squashed-slot-words.mjs +133 -0
  738. package/scripts/lib/validate-bb-markup.mjs +2213 -76
  739. package/scripts/lib/wrapper-props.mjs +188 -0
  740. package/dist/ai/BbBaseCheckbox.md +0 -49
  741. package/dist/ai/BbBaseCheckboxGroup.md +0 -64
  742. package/dist/ai/BbBaseColorInput.md +0 -65
  743. package/dist/ai/BbBaseColorPalette.md +0 -39
  744. package/dist/ai/BbBaseDatePicker.md +0 -43
  745. package/dist/ai/BbBaseDatePickerInput.md +0 -73
  746. package/dist/ai/BbBaseInputContainer.md +0 -48
  747. package/dist/ai/BbBaseNumberInput.md +0 -71
  748. package/dist/ai/BbBaseRadio.md +0 -46
  749. package/dist/ai/BbBaseRadioGroup.md +0 -64
  750. package/dist/ai/BbBaseRating.md +0 -52
  751. package/dist/ai/BbBaseSelect.md +0 -88
  752. package/dist/ai/BbBaseSlider.md +0 -56
  753. package/dist/ai/BbBaseSwitch.md +0 -49
  754. package/dist/ai/BbBaseSwitchGroup.md +0 -64
  755. package/dist/ai/BbBaseTag.md +0 -68
  756. package/dist/ai/BbBaseTextInput.md +0 -75
  757. package/dist/ai/BbBaseTextarea.md +0 -62
  758. package/dist/ai/BbBaseTimePickerInput.md +0 -62
  759. package/dist/ai/BbTabsPanes.md +0 -27
  760. package/dist/ai/CommonInputWrapper.md +0 -42
  761. package/dist/ai/source/BbBaseCheckbox.md +0 -461
  762. package/dist/ai/source/BbBaseCheckboxGroup.md +0 -554
  763. package/dist/ai/source/BbBaseColorInput.md +0 -431
  764. package/dist/ai/source/BbBaseColorPalette.md +0 -942
  765. package/dist/ai/source/BbBaseDatePicker.md +0 -1448
  766. package/dist/ai/source/BbBaseDatePickerInput.md +0 -1940
  767. package/dist/ai/source/BbBaseNumberInput.md +0 -617
  768. package/dist/ai/source/BbBaseRadio.md +0 -381
  769. package/dist/ai/source/BbBaseRadioGroup.md +0 -539
  770. package/dist/ai/source/BbBaseRating.md +0 -607
  771. package/dist/ai/source/BbBaseSelect.md +0 -945
  772. package/dist/ai/source/BbBaseSlider.md +0 -1144
  773. package/dist/ai/source/BbBaseSwitch.md +0 -246
  774. package/dist/ai/source/BbBaseSwitchGroup.md +0 -302
  775. package/dist/ai/source/BbBaseTag.md +0 -694
  776. package/dist/ai/source/BbBaseTextInput.md +0 -511
  777. package/dist/ai/source/BbBaseTextarea.md +0 -504
  778. package/dist/ai/source/BbBaseTimePickerInput.md +0 -1037
  779. package/dist/ai/source/BbTabsPanes.md +0 -377
  780. package/dist/ai/source/CommonInputWrapper.md +0 -584
  781. package/dist/alert-variants.d.ts +0 -19
  782. package/dist/assets/svgs/sort.svg_raw.js +0 -4
  783. package/dist/badge-variants.d.ts +0 -19
  784. package/dist/button-variants.d.ts +0 -21
  785. package/dist/components/BbBadge/BadgeAppendIcon.vue.d.ts +0 -3
  786. package/dist/components/BbBadge/BadgeAppendIcon.vue.js +0 -5
  787. package/dist/components/BbBadge/BadgeAppendIcon.vue_vue_type_script_setup_true_lang.js +0 -22
  788. package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue.d.ts +0 -40
  789. package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue.js +0 -6
  790. package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue_vue_type_script_setup_true_lang.js +0 -145
  791. package/dist/components/BbBaseCheckbox/types.d.ts +0 -224
  792. package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue.d.ts +0 -19
  793. package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue.js +0 -6
  794. package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue_vue_type_script_setup_true_lang.js +0 -190
  795. package/dist/components/BbBaseCheckboxGroup/types.d.ts +0 -257
  796. package/dist/components/BbBaseColorInput/BbBaseColorInput.vue.d.ts +0 -43
  797. package/dist/components/BbBaseColorInput/BbBaseColorInput.vue.js +0 -6
  798. package/dist/components/BbBaseColorInput/BbBaseColorInput.vue_vue_type_script_setup_true_lang.js +0 -184
  799. package/dist/components/BbBaseColorInput/types.d.ts +0 -219
  800. package/dist/components/BbBaseColorPalette/BbBaseColorPalette.vue.d.ts +0 -13
  801. package/dist/components/BbBaseColorPalette/BbBaseColorPalette.vue_vue_type_script_setup_true_lang.js +0 -395
  802. package/dist/components/BbBaseColorPalette/types.d.ts +0 -40
  803. package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue.d.ts +0 -20
  804. package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue.js +0 -6
  805. package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue_vue_type_script_setup_true_lang.js +0 -407
  806. package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue.d.ts +0 -47
  807. package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue.js +0 -5
  808. package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue_vue_type_script_setup_true_lang.js +0 -318
  809. package/dist/components/BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue.js +0 -5
  810. package/dist/components/BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue_vue_type_script_setup_true_lang.js +0 -115
  811. package/dist/components/BbBaseDatePicker/BbBaseDatePickerYearSelector.vue.js +0 -5
  812. package/dist/components/BbBaseDatePicker/BbBaseDatePickerYearSelector.vue_vue_type_script_setup_true_lang.js +0 -116
  813. package/dist/components/BbBaseDatePicker/types.d.ts +0 -108
  814. package/dist/components/BbBaseDatePicker/useDatePickerContext.js +0 -11
  815. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue.d.ts +0 -31
  816. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue.js +0 -6
  817. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue_vue_type_script_setup_true_lang.js +0 -737
  818. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue.js +0 -6
  819. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue_vue_type_script_setup_true_lang.js +0 -204
  820. package/dist/components/BbBaseDatePickerInput/types.d.ts +0 -325
  821. package/dist/components/BbBaseInputContainer/BbBaseInputContainer.vue.js +0 -6
  822. package/dist/components/BbBaseInputContainer/BbBaseInputContainer.vue_vue_type_script_setup_true_lang.js +0 -190
  823. package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue.d.ts +0 -52
  824. package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue.js +0 -6
  825. package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue_vue_type_script_setup_true_lang.js +0 -215
  826. package/dist/components/BbBaseNumberInput/types.d.ts +0 -211
  827. package/dist/components/BbBaseRadio/BbBaseRadio.vue.d.ts +0 -33
  828. package/dist/components/BbBaseRadio/BbBaseRadio.vue_vue_type_script_setup_true_lang.js +0 -113
  829. package/dist/components/BbBaseRadio/types.d.ts +0 -179
  830. package/dist/components/BbBaseRadioGroup/BbBaseRadioGroup.vue.d.ts +0 -19
  831. package/dist/components/BbBaseRadioGroup/BbBaseRadioGroup.vue_vue_type_script_setup_true_lang.js +0 -179
  832. package/dist/components/BbBaseRadioGroup/types.d.ts +0 -223
  833. package/dist/components/BbBaseRating/BbBaseRating.vue.d.ts +0 -38
  834. package/dist/components/BbBaseRating/BbBaseRating.vue.js +0 -6
  835. package/dist/components/BbBaseRating/BbBaseRating.vue_vue_type_script_setup_true_lang.js +0 -192
  836. package/dist/components/BbBaseRating/types.d.ts +0 -176
  837. package/dist/components/BbBaseSelect/BbBaseSelect.vue.d.ts +0 -19
  838. package/dist/components/BbBaseSelect/BbBaseSelect.vue.js +0 -6
  839. package/dist/components/BbBaseSelect/BbBaseSelect.vue_vue_type_script_setup_true_lang.js +0 -311
  840. package/dist/components/BbBaseSelect/types.d.ts +0 -297
  841. package/dist/components/BbBaseSlider/BbBaseSlider.vue.d.ts +0 -35
  842. package/dist/components/BbBaseSlider/BbBaseSlider.vue.js +0 -6
  843. package/dist/components/BbBaseSlider/BbBaseSlider.vue_vue_type_script_setup_true_lang.js +0 -340
  844. package/dist/components/BbBaseSlider/types.d.ts +0 -200
  845. package/dist/components/BbBaseSwitch/BbBaseSwitch.vue.d.ts +0 -35
  846. package/dist/components/BbBaseSwitch/BbBaseSwitch.vue_vue_type_script_setup_true_lang.js +0 -146
  847. package/dist/components/BbBaseSwitch/types.d.ts +0 -10
  848. package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue.d.ts +0 -19
  849. package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue.js +0 -6
  850. package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue_vue_type_script_setup_true_lang.js +0 -190
  851. package/dist/components/BbBaseSwitchGroup/types.d.ts +0 -8
  852. package/dist/components/BbBaseTag/BbBaseTag.vue.d.ts +0 -50
  853. package/dist/components/BbBaseTag/BbBaseTag.vue.js +0 -6
  854. package/dist/components/BbBaseTag/BbBaseTag.vue_vue_type_script_setup_true_lang.js +0 -266
  855. package/dist/components/BbBaseTag/types.d.ts +0 -160
  856. package/dist/components/BbBaseTextInput/BbBaseTextInput.vue.d.ts +0 -45
  857. package/dist/components/BbBaseTextInput/BbBaseTextInput.vue.js +0 -6
  858. package/dist/components/BbBaseTextInput/BbBaseTextInput.vue_vue_type_script_setup_true_lang.js +0 -200
  859. package/dist/components/BbBaseTextInput/types.d.ts +0 -209
  860. package/dist/components/BbBaseTextarea/BbBaseTextarea.vue.d.ts +0 -39
  861. package/dist/components/BbBaseTextarea/BbBaseTextarea.vue.js +0 -6
  862. package/dist/components/BbBaseTextarea/BbBaseTextarea.vue_vue_type_script_setup_true_lang.js +0 -187
  863. package/dist/components/BbBaseTextarea/types.d.ts +0 -170
  864. package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue.d.ts +0 -27
  865. package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue.js +0 -6
  866. package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue_vue_type_script_setup_true_lang.js +0 -519
  867. package/dist/components/BbBaseTimePickerInput/types.d.ts +0 -151
  868. package/dist/components/BbTabs/BbTabsPanes.vue.d.ts +0 -16
  869. package/dist/components/BbTabs/BbTabsPanes.vue.js +0 -6
  870. package/dist/components/BbTabs/BbTabsPanes.vue_vue_type_script_setup_true_lang.js +0 -35
  871. package/dist/components/CommonInputWrapper/CommonInputWrapper.vue.js +0 -6
  872. package/dist/components/CommonInputWrapper/CommonInputWrapper.vue_vue_type_script_setup_true_lang.js +0 -107
  873. package/dist/confirm-variants.d.ts +0 -17
  874. package/dist/dropdown-item-variants.d.ts +0 -17
  875. package/dist/indicator-variants.d.ts +0 -20
  876. package/dist/locale-registry.d.ts +0 -37
  877. package/dist/toast-variants.d.ts +0 -20
  878. package/dist/tooltip-variants.d.ts +0 -17
  879. package/dist/types/InputDirection.d.ts +0 -15
  880. package/dist/validated/BbCheckbox.vue.d.ts +0 -29
  881. package/dist/validated/BbCheckbox.vue.js +0 -5
  882. package/dist/validated/BbCheckbox.vue_vue_type_script_setup_true_lang.js +0 -75
  883. package/dist/validated/BbCheckboxGroup.vue.d.ts +0 -34
  884. package/dist/validated/BbCheckboxGroup.vue.js +0 -5
  885. package/dist/validated/BbCheckboxGroup.vue_vue_type_script_setup_true_lang.js +0 -82
  886. package/dist/validated/BbColorInput.vue.d.ts +0 -37
  887. package/dist/validated/BbColorInput.vue.js +0 -5
  888. package/dist/validated/BbColorInput.vue_vue_type_script_setup_true_lang.js +0 -75
  889. package/dist/validated/BbDatePickerInput.vue.d.ts +0 -41
  890. package/dist/validated/BbDatePickerInput.vue.js +0 -5
  891. package/dist/validated/BbDatePickerInput.vue_vue_type_script_setup_true_lang.js +0 -90
  892. package/dist/validated/BbDropzone.vue.d.ts +0 -24
  893. package/dist/validated/BbDropzone.vue.js +0 -5
  894. package/dist/validated/BbDropzone.vue_vue_type_script_setup_true_lang.js +0 -45
  895. package/dist/validated/BbForm.vue.d.ts +0 -28
  896. package/dist/validated/BbForm.vue_vue_type_script_setup_true_lang.js +0 -42
  897. package/dist/validated/BbNumberInput.vue.d.ts +0 -36
  898. package/dist/validated/BbNumberInput.vue.js +0 -5
  899. package/dist/validated/BbNumberInput.vue_vue_type_script_setup_true_lang.js +0 -72
  900. package/dist/validated/BbRadioGroup.vue.d.ts +0 -34
  901. package/dist/validated/BbRadioGroup.vue.js +0 -5
  902. package/dist/validated/BbRadioGroup.vue_vue_type_script_setup_true_lang.js +0 -78
  903. package/dist/validated/BbRating.vue.d.ts +0 -30
  904. package/dist/validated/BbRating.vue.js +0 -5
  905. package/dist/validated/BbRating.vue_vue_type_script_setup_true_lang.js +0 -63
  906. package/dist/validated/BbSelect.vue.d.ts +0 -46
  907. package/dist/validated/BbSelect.vue.js +0 -5
  908. package/dist/validated/BbSelect.vue_vue_type_script_setup_true_lang.js +0 -109
  909. package/dist/validated/BbSlider.vue.d.ts +0 -36
  910. package/dist/validated/BbSlider.vue.js +0 -5
  911. package/dist/validated/BbSlider.vue_vue_type_script_setup_true_lang.js +0 -69
  912. package/dist/validated/BbSwitch.vue.d.ts +0 -29
  913. package/dist/validated/BbSwitch.vue.js +0 -5
  914. package/dist/validated/BbSwitch.vue_vue_type_script_setup_true_lang.js +0 -75
  915. package/dist/validated/BbSwitchGroup.vue.d.ts +0 -34
  916. package/dist/validated/BbSwitchGroup.vue.js +0 -5
  917. package/dist/validated/BbSwitchGroup.vue_vue_type_script_setup_true_lang.js +0 -82
  918. package/dist/validated/BbTag.vue.d.ts +0 -36
  919. package/dist/validated/BbTag.vue.js +0 -5
  920. package/dist/validated/BbTag.vue_vue_type_script_setup_true_lang.js +0 -72
  921. package/dist/validated/BbTextInput.vue.d.ts +0 -36
  922. package/dist/validated/BbTextInput.vue.js +0 -5
  923. package/dist/validated/BbTextInput.vue_vue_type_script_setup_true_lang.js +0 -72
  924. package/dist/validated/BbTextarea.vue.d.ts +0 -36
  925. package/dist/validated/BbTextarea.vue.js +0 -5
  926. package/dist/validated/BbTextarea.vue_vue_type_script_setup_true_lang.js +0 -70
  927. package/dist/validated/BbTimePickerInput.vue.d.ts +0 -37
  928. package/dist/validated/BbTimePickerInput.vue.js +0 -5
  929. package/dist/validated/BbTimePickerInput.vue_vue_type_script_setup_true_lang.js +0 -81
  930. package/dist/validated/index.d.ts +0 -43
  931. package/dist/validated/useValidatedField.d.ts +0 -93
  932. package/dist/validated/useValidatedField.js +0 -51
  933. package/dist/validated.js +0 -21
  934. /package/dist/components/{BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue.d.ts → BbCalendar/CalendarMonthPanel.vue.d.ts} +0 -0
  935. /package/dist/components/{BbBaseDatePicker/BbBaseDatePickerYearSelector.vue.d.ts → BbCalendar/CalendarYearPanel.vue.d.ts} +0 -0
  936. /package/dist/{components/BbBaseDatePicker/typeahead.d.ts → composables/useTypeahead.d.ts} +0 -0
  937. /package/dist/{components/BbBaseDatePicker/typeahead.js → composables/useTypeahead.js} +0 -0
@@ -8,6 +8,41 @@
8
8
  - Usage rule: Prefer this component for consumer-facing implementations.
9
9
  - Implementation source (only when the contract below is not enough): [source/BbTextInput.md](./source/BbTextInput.md)
10
10
 
11
+ ## Reachable through `BbTextInput`
12
+
13
+ `BbTextInput` mounts other components (all of them: _Component tree_, near the end). These are the parts of its API that land inside them. Prefer these over `:deep()` on an inner class (allowed, unsupported: it can break on upgrade) — and never an import of an internal component.
14
+
15
+ | pt part | Lands on | In |
16
+ | --- | --- | --- |
17
+ | `pt:root` | `div.bb-field` | `CommonField` _(internal)_ |
18
+ | `pt:label` | `component` | `CommonField` _(internal)_ |
19
+ | `pt:description` | `span.bb-field__description` | `CommonField` _(internal)_ |
20
+ | `pt:hint` | `span.bb-field__hint` | `CommonField` _(internal)_ |
21
+ | `pt:message` | `div.bb-field__message` | `CommonField` _(internal)_ |
22
+ | `pt:box` | `span.bb-field-input__box` | `CommonFieldInput` _(internal)_ |
23
+ | `pt:prefix` | `span.bb-field-input__prefix` | `CommonFieldInput` _(internal)_ |
24
+ | `pt:icon` | the root of `BbIcon` | `BbIcon` ([contract](./BbIcon.md)) |
25
+ | `pt:clear` | the root of `ClearableButton` | `ClearableButton` _(internal)_ |
26
+ | `pt:spinner` | the root of `BbSpinner` | `BbSpinner` ([contract](./BbSpinner.md)) |
27
+ | `pt:suffix` | `span.bb-field-input__suffix` | `CommonFieldInput` _(internal)_ |
28
+
29
+ **CSS variables you can set through those parts** — declared deeper in the tree, so set one on the part that reads it (`pt:<part>="[--name:value]"`), never on `BbTextInput`'s root:
30
+
31
+ | Variable | Set through | Declared by | What it is |
32
+ | --- | --- | --- | --- |
33
+ | `--bg` | `pt:box` | `CommonFieldInput` | the shell's fill |
34
+ | `--bg-hover` | `pt:box` | `CommonFieldInput` | fill under the pointer |
35
+ | `--bg-focus` | `pt:box` | `CommonFieldInput` | fill while focus is inside, and under --active |
36
+ | `--bg-disabled` | `pt:box` | `CommonFieldInput` | fill while disabled; beats hover and focus |
37
+ | `--border-color` | `pt:box` | `CommonFieldInput` | The resting border, at the fixed --bb-border-w. Errors and warnings paint their frame over it, so `pt:box="[--border-color:…]"` recolours the rest without hiding the state; a plain `border-*` utility on the base pt:box would hide it (ESLint `no-box-border-color`). |
38
+ | `--border-focus` | `pt:box` | `CommonFieldInput` | frame while focused, or --active |
39
+ | `--ring-size` | `pt:box` | `CommonFieldInput` | ring width; 0 is a variant declining the ring |
40
+ | `--ring-color` | `pt:box` | `CommonFieldInput` | ring colour; state owns it, not variants |
41
+ | `--elev` | `pt:box` | `CommonFieldInput` | Resting lift, composed UNDER the ring at every box-shadow site below. `0 0 0 0 transparent` and not `none`, so the shadow list keeps a constant length and stays interpolable whatever a variant assigns — the same reason `--bb-elev` itself ships that value. |
42
+ | `--frost` | `pt:box` | `CommonFieldInput` | Plate frost — a full `backdrop-filter` value (see --bb-surface-filter). Routed through a local rather than read from the token directly, so a chrome-less variant can decline it: frosting a ghost field gives it the plate it is contractually not supposed to have. |
43
+ | `--inside-label-clearance` | `pt:box`, `pt:prefix`, `pt:suffix` | `CommonFieldInput` | Height and top padding added above the text for a label rendered inside the box. Zero here; the `--inside-label` rules at the bottom of this file raise it to one label line, or two with a description. |
44
+ | `--w` | `pt:icon` | `BbIcon` | `--w` is set inline by BbIcon from the size prop. The `initial` default seals it: without it an ancestor's `--w` (e.g. a dropdown's width bridge) would inherit in and size the icon. The `--size` indirection stays so higher-specificity rules (e.g. `.bb-badge .bb-icon`) can re-point it. |
45
+
11
46
  ## Usage & Guidelines
12
47
 
13
48
  ### When to use
@@ -24,7 +59,7 @@ Pick a sibling when the shape of the data is different:
24
59
  - calendar dates → `BbDatePickerInput`;
25
60
  - choosing from a known set of options → `BbSelect` / `BbRadioGroup`.
26
61
 
27
- `v-model` binds a `string | null` — an emptied field emits `null`, never `''`.
62
+ `v-model` binds a `string | null` — an emptied field emits `null` by default, or `''` when the plugin option `formControls` says so (see the installation guide § `formControls`).
28
63
  `label` is required (hide it visually with `hideLabel`, never drop it).
29
64
 
30
65
  ### Label & label modes
@@ -45,20 +80,25 @@ read from `FormData`.
45
80
  - **`hideLabel`** keeps the label for screen readers but removes it visually —
46
81
  the right move for search boxes whose design shows only a placeholder.
47
82
  - The **`label` slot** replaces the label text and receives
48
- `{ text, hasErrors }`, e.g. to append a required marker that turns red with
83
+ `{ text, hasErrors, hasWarnings }`, e.g. to append a required marker that turns red with
49
84
  the error state.
50
85
 
51
86
  Avoid combining `labelMode="floating"` with a `placeholder` — the resting
52
87
  label already plays that role and the two would overlap.
53
88
 
89
+ A risen floating label is a chip on the box's top border: the surface above,
90
+ the box's fill below, so it masks the line on an `outline` and a `secondary`
91
+ box alike. If you give the box a custom fill (`pt:box="[--bg:…]"`), give the
92
+ chip the same one on the field: `pt:root="[--label-bg:…]"`.
93
+
54
94
  **The three label modes**
55
95
 
56
96
  ```vue
57
97
  <template>
58
- <div class="grid max-w-sm gap-3 rounded-[var(--bb-radius)] border p-4">
98
+ <div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
59
99
  <div>
60
100
  <p class="text-sm font-medium">Profile basics</p>
61
- <p class="text-xs text-[color:var(--bb-text-muted)]">
101
+ <p class="text-xs text-(--bb-text-muted)">
62
102
  Same field, three label placements — pick one per product.
63
103
  </p>
64
104
  </div>
@@ -85,10 +125,10 @@ const inside = ref<string | null>('Bitboss');
85
125
 
86
126
  ```vue
87
127
  <template>
88
- <div class="grid max-w-sm gap-3 rounded-[var(--bb-radius)] border p-4">
128
+ <div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
89
129
  <div>
90
130
  <p class="text-sm font-medium">Workspace settings</p>
91
- <p class="text-xs text-[color:var(--bb-text-muted)]">
131
+ <p class="text-xs text-(--bb-text-muted)">
92
132
  Required fields mark the label — keep the accessible name intact.
93
133
  </p>
94
134
  </div>
@@ -102,11 +142,7 @@ const inside = ref<string | null>('Bitboss');
102
142
  <template #label="{ text, hasErrors }">
103
143
  {{ text }}
104
144
  <span
105
- :class="
106
- hasErrors
107
- ? 'text-[color:var(--bb-danger)]'
108
- : 'text-[color:var(--bb-text-muted)]'
109
- "
145
+ :class="hasErrors ? 'text-(--bb-danger)' : 'text-(--bb-text-muted)'"
110
146
  >
111
147
  *
112
148
  </span>
@@ -142,7 +178,7 @@ Three messaging surfaces, three jobs:
142
178
  referenced from `aria-describedby` while displayed — for a
143
179
  valid-but-noteworthy value (unusual, near a limit, soft-flagged) where a hard
144
180
  error would overstate the problem. A non-empty `warnings` implies the warning
145
- state (same as `errors` implies the error state). **`hasWarning`** forces that
181
+ state (same as `errors` implies the error state). **`hasWarnings`** forces that
146
182
  chrome without a message. Either way you get tinted border, focus ring and a
147
183
  warning icon in amber (`--bb-warn`) — but, unlike `hasErrors`, **no**
148
184
  `aria-invalid`. Errors win when both are set, and the warning messages are
@@ -166,15 +202,45 @@ validation layer should still drive `errors`.
166
202
  </div>
167
203
  ```
168
204
 
205
+ **A description with markup: the `#description` slot.** Every form control
206
+ takes a `#description` slot next to the `description` prop — for a link, a
207
+ bold value, anything beyond plain text. It renders in the same place (under
208
+ the label, above the field), receives `{ text, hasErrors, hasWarnings }` like
209
+ `#label`, and is announced as the field's description, never as part of its
210
+ name. The slot alone is enough: no `description` prop needed.
211
+
212
+ **A description with a link**
213
+
214
+ ```vue
215
+ <template>
216
+ <div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-3">
217
+ <BbTextInput v-model="subdomain" label="Subdomain" name="subdomain">
218
+ <!-- Renders under the label, above the field, and is announced as the
219
+ field's description — never as part of its name. Use the slot when the
220
+ description needs markup; `description="…"` is the plain-text form. -->
221
+ <template #description>
222
+ Your workspace lives at
223
+ <strong>{{ subdomain || 'your-team' }}.example.com</strong>.
224
+ <a class="underline" href="#domains">Use a custom domain</a>
225
+ </template>
226
+ </BbTextInput>
227
+ </div>
228
+ </template>
229
+ <script setup lang="ts">
230
+ import { ref } from 'vue';
231
+ import { BbTextInput } from 'bitboss-ui';
232
+
233
+ const subdomain = ref('');
234
+ </script>
235
+ ```
236
+
169
237
  **Validation states**
170
238
 
171
239
  ```vue
172
240
  <template>
173
241
  <div class="grid max-w-sm gap-3">
174
- <div class="grid gap-2 rounded-[var(--bb-radius)] border p-3">
175
- <p class="text-xs font-medium text-[color:var(--bb-text-muted)]">
176
- Invite teammate
177
- </p>
242
+ <div class="grid gap-2 rounded-(--bb-radius) border p-3">
243
+ <p class="text-xs font-medium text-(--bb-text-muted)">Invite teammate</p>
178
244
  <BbTextInput
179
245
  v-model="email"
180
246
  compact
@@ -186,8 +252,8 @@ validation layer should still drive `errors`.
186
252
  type="email"
187
253
  />
188
254
  </div>
189
- <div class="grid gap-2 rounded-[var(--bb-radius)] border p-3">
190
- <p class="text-xs font-medium text-[color:var(--bb-text-muted)]">
255
+ <div class="grid gap-2 rounded-(--bb-radius) border p-3">
256
+ <p class="text-xs font-medium text-(--bb-text-muted)">
191
257
  Non-blocking hint
192
258
  </p>
193
259
  <BbTextInput
@@ -199,7 +265,7 @@ validation layer should still drive `errors`.
199
265
  :warnings="['This name is very short — is it what you meant?']"
200
266
  />
201
267
  </div>
202
- <div class="rounded-[var(--bb-radius)] border px-2 py-1.5">
268
+ <div class="rounded-(--bb-radius) border px-2 py-1.5">
203
269
  <BbTextInput
204
270
  v-model="search"
205
271
  class="w-full"
@@ -226,7 +292,7 @@ const search = ref<string | null>('billing');
226
292
 
227
293
  The second field carries `warnings` — a non-blocking amber hint in an
228
294
  `aria-live` region and in `aria-describedby`, mirroring `errors`. A non-empty `warnings` lights the state
229
- on its own (use `hasWarning` to force the chrome without messages). When a field
295
+ on its own (use `hasWarnings` to force the chrome without messages). When a field
230
296
  has **both** `errors` and `warnings`, errors win: the field shows error chrome
231
297
  and only the error messages. The last field shows the common a11y move: a search
232
298
  box with a _visually_ hidden label (`hideLabel`) — the accessible name survives
@@ -241,8 +307,8 @@ interactive controls out of them.
241
307
 
242
308
  The append-icon position is shared with the field's status indicators, one at
243
309
  a time by priority: **clear button → spinner (`loading`) → error icon
244
- (`hasErrors`) → your `append:icon`**. The warning icon (`hasWarning`) shares the
245
- error icon's slot — shown when `hasWarning` is set and there is no error. Don't
310
+ (`hasErrors`) → your `append:icon`**. The warning icon (`hasWarnings`) shares the
311
+ error icon's slot — shown when `hasWarnings` is set and there is no error. Don't
246
312
  rely on an `append:icon` staying visible on a field that is also `clearable` or
247
313
  validated.
248
314
 
@@ -251,17 +317,17 @@ The full slot ring, inside → out:
251
317
  - `prefix` / `suffix` — styled inline text hugging the typed value;
252
318
  - `prepend` / `append` — free-form content inside the input chrome (replaces
253
319
  `prefix`/`suffix` when both are given);
254
- - `prepend-outer` / `append-outer` — content outside the chrome, laid out next
320
+ - `prepend:outer` / `append:outer` — content outside the chrome, laid out next
255
321
  to the field; the right home for an adjacent button.
256
322
 
257
323
  **Icons and text affixes**
258
324
 
259
325
  ```vue
260
326
  <template>
261
- <div class="grid max-w-sm gap-3 rounded-[var(--bb-radius)] border p-4">
327
+ <div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
262
328
  <div>
263
329
  <p class="text-sm font-medium">Workspace & billing</p>
264
- <p class="text-xs text-[color:var(--bb-text-muted)]">
330
+ <p class="text-xs text-(--bb-text-muted)">
265
331
  Icons and short affixes live inside the chrome; actions sit outside.
266
332
  </p>
267
333
  </div>
@@ -285,7 +351,7 @@ The full slot ring, inside → out:
285
351
  name="api-key"
286
352
  readonly
287
353
  >
288
- <template #append-outer>
354
+ <template #append:outer>
289
355
  <BbButton
290
356
  aria-label="Copy API key"
291
357
  icon="lucide:copy"
@@ -328,10 +394,10 @@ the status.
328
394
 
329
395
  ```vue
330
396
  <template>
331
- <div class="grid max-w-sm gap-3 rounded-[var(--bb-radius)] border p-4">
397
+ <div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
332
398
  <div>
333
399
  <p class="text-sm font-medium">Claim your handle</p>
334
- <p class="text-xs text-[color:var(--bb-text-muted)]">
400
+ <p class="text-xs text-(--bb-text-muted)">
335
401
  Debounced check — spinner while pending, hint or error on result.
336
402
  </p>
337
403
  </div>
@@ -406,7 +472,7 @@ Pass a [maska](https://beholdr.github.io/maska/v3) config to `mask` to format
406
472
  as the user types — card numbers, phone numbers, license keys. By default
407
473
  `v-model` receives the _unmasked_ value (`'4242424242424242'` for the card
408
474
  below); set `emitMasked` to persist the formatted string instead. A fully
409
- emptied masked field emits `null`, like every other state of this component.
475
+ emptied masked field emits the empty value (`null` by default, `''` with `formControls`), like every other state of this component.
410
476
 
411
477
  The mask is live-reactive: changing the `mask` options at runtime reformats the
412
478
  current value, and toggling `emitMasked` re-emits the model in the new format.
@@ -441,15 +507,23 @@ are `BbNumberInput`'s and `BbDatePickerInput`'s jobs.
441
507
  the saved email or name as a suggestion over the results the user is trying
442
508
  to filter. Semantic tokens belong on identity fields; anything that queries a
443
509
  list turns autofill off.
444
- - `inputMode` steers mobile keyboards independently of `type` (e.g.
445
- `inputMode="numeric"` on a masked code field that must stay `type="text"`).
510
+ - `input-mode` steers mobile keyboards independently of `type` (e.g.
511
+ `input-mode="numeric"` on a masked code field that must stay `type="text"`).
512
+ Any spelling reaches the input (`inputmode`, `inputMode`), on every
513
+ text-like control.
446
514
  - `autofocus` focuses the field on mount; use at most one per view.
447
515
 
448
- Any attribute you set that isn't one of the props documented above (e.g.
449
- `maxlength`, `pattern`, `minlength`, `spellcheck`) lands on the field's outer
450
- container element, not on the native `<input>` — it will not constrain or
451
- affect typing. Use the documented props for anything the input itself needs
452
- to enforce.
516
+ The native attributes that only mean something on the input itself —
517
+ `maxlength`, `minlength`, `pattern`, `spellcheck`, `autocapitalize`,
518
+ `autocorrect`, `enterkeyhint`, `list`, `form`, `dirname` — go straight to the
519
+ native `<input>` (the same holds for BbTextarea, BbNumberInput, BbTag and
520
+ BbColorInput, where `wrap` joins them on the textarea). The controls without
521
+ a text input route only what their native control reads: BbSelect sends
522
+ `form` to its hidden inputs, BbDatePickerInput and BbTimePickerInput send
523
+ `form`, `spellcheck`, `autocapitalize`, `autocorrect` and `enterkeyhint` to
524
+ every segment (each segment keeps its own `maxlength` and parsing). Any other
525
+ attribute you set lands on the field's outer element; reach the input with
526
+ `pt:input="{ attrs: { … } }"`, which also wins over the attributes above.
453
527
 
454
528
  **An OTP field: text type, numeric keyboard, masked**
455
529
 
@@ -459,7 +533,7 @@ to enforce.
459
533
  v-model="state.otp"
460
534
  label="Verification code"
461
535
  autocomplete="one-time-code"
462
- inputMode="numeric"
536
+ input-mode="numeric"
463
537
  :mask="{ mask: '### ###' }"
464
538
  placeholder="123 456"
465
539
  />
@@ -505,7 +579,7 @@ const revealed = ref(false);
505
579
 
506
580
  ### Events & v-model
507
581
 
508
- - `update:modelValue` — every value change; `string`, or `null` when emptied
582
+ - `update:modelValue` — every value change; `string`, or the empty value when emptied (`null` by default, `''` with `formControls`)
509
583
  (with a mask: the unmasked/masked string per `emitMasked`).
510
584
  - `focus` / `blur` — forwarded `FocusEvent`s; they also drive the hint's
511
585
  show-on-focus behavior.
@@ -536,39 +610,40 @@ provisioned values — screen-reader and keyboard users can still reach them.
536
610
  `compact` reduces the control height — apply it per view, not per field, so
537
611
  density stays consistent.
538
612
 
539
- The API also exposes `direction` (horizontal/pattern layouts), `reverse` and
540
- `labelPosition`. `direction` works whenever the **resolved** label mode is
613
+ The API also exposes `layout` (horizontal/pattern layouts), `reverse` and
614
+ `labelPosition`. `layout` works whenever the **resolved** label mode is
541
615
  `'outside'` — which is the config default, so it works out of the box. With
542
616
  `labelMode="floating"` or `"inside"` (via prop or
543
617
  `config.defaultInputLabelMode`) the label is embedded in the field, so those
544
- modes force the vertical layout and ignore `direction`. The same rule applies
545
- to `BbNumberInput`, `BbSelect` and `BbDatePickerInput`; `BbTextarea` has no
546
- label mode at all, so it always honors `direction`.
618
+ modes force the vertical layout and ignore `layout`. The same rule applies
619
+ to `BbNumberInput`, `BbSelect`, `BbDatePickerInput` and `BbTextarea` — all
620
+ five carry `labelMode` and all five fall back to
621
+ `config.defaultInputLabelMode` when it is unset.
547
622
 
548
- **Horizontal row via direction (outside label)**
623
+ **Horizontal row via layout (outside label)**
549
624
 
550
625
  ```vue
551
626
  <template>
552
- <div class="grid max-w-md gap-3 rounded-[var(--bb-radius)] border p-4">
627
+ <div class="grid max-w-md gap-3 rounded-(--bb-radius) border p-4">
553
628
  <div>
554
629
  <p class="text-sm font-medium">Billing contact</p>
555
- <p class="text-xs text-[color:var(--bb-text-muted)]">
630
+ <p class="text-xs text-(--bb-text-muted)">
556
631
  Outside labels only — horizontal rows keep dense forms scannable.
557
632
  </p>
558
633
  </div>
559
634
  <BbTextInput
560
635
  v-model="fullName"
561
636
  compact
562
- direction="horizontal"
563
637
  label="Full name"
638
+ layout="horizontal"
564
639
  name="full-name"
565
640
  placeholder="Ada Lovelace"
566
641
  />
567
642
  <BbTextInput
568
643
  v-model="company"
569
644
  compact
570
- direction="xx xxxxxx"
571
645
  label="Company"
646
+ layout="xx xxxxxx"
572
647
  name="company"
573
648
  placeholder="Bitboss"
574
649
  />
@@ -583,17 +658,17 @@ const company = ref<string | null>('Bitboss');
583
658
  </script>
584
659
  ```
585
660
 
586
- `direction="horizontal"` splits label and field 50/50; a pattern string like
661
+ `layout="horizontal"` splits label and field 50/50; a pattern string like
587
662
  `"xx xxxxxx"` sets proportional column widths (here 25% label / 75% field).
588
663
 
589
664
  **Compact density for dense panels**
590
665
 
591
666
  ```vue
592
667
  <template>
593
- <div class="grid max-w-sm gap-2 rounded-[var(--bb-radius)] border p-3">
668
+ <div class="grid max-w-sm gap-2 rounded-(--bb-radius) border p-3">
594
669
  <div>
595
670
  <p class="text-sm font-medium">Merino Tee — Black / M</p>
596
- <p class="text-xs text-[color:var(--bb-text-muted)]">
671
+ <p class="text-xs text-(--bb-text-muted)">
597
672
  Product identifiers · compact density
598
673
  </p>
599
674
  </div>
@@ -622,6 +697,47 @@ const barcode = ref<string | null>('0 12345 67890 5');
622
697
  </script>
623
698
  ```
624
699
 
700
+ ### Variants
701
+
702
+ `variant` picks the field box's look — and only its look. Height, padding and
703
+ border width are identical across variants, so mixing them in one view never
704
+ reflows anything. The names and tokens are the `BbButton` ones, so a page
705
+ reads one vocabulary for buttons and fields:
706
+
707
+ - **`outline`** (default) — the raised panel with the neutral border.
708
+ - **`secondary`** — a soft tinted surface with a faint border; fields that
709
+ should sit back on a busy panel.
710
+ - **`ghost`** — no border in **any** state, a hover wash as the affordance,
711
+ and the same wash under the focus ring (a ring around nothing reads as a
712
+ glitch). Errors and warnings do not tint it; the icon and
713
+ the message carry the state. This is the inline-edit table cell: the field
714
+ reads as text at rest and needs no `:deep()` to get there.
715
+ - **`none`** — structure only: every colour transparent and **no focus
716
+ ring**. An escape hatch for a fully custom look; prefer registering a
717
+ variant, which keeps the ring.
718
+
719
+ **The variant ladder**
720
+
721
+ ```vue
722
+ <template>
723
+ <div class="grid gap-3 sm:grid-cols-3">
724
+ <BbTextInput label="Outline" model-value="Ada Lovelace" />
725
+ <BbTextInput
726
+ label="Secondary"
727
+ model-value="Ada Lovelace"
728
+ variant="secondary"
729
+ />
730
+ <BbTextInput label="Ghost" model-value="Ada Lovelace" variant="ghost" />
731
+ </div>
732
+ </template>
733
+ ```
734
+
735
+ `variant` is the same prop on `BbTextarea`, `BbNumberInput`, `BbSelect`,
736
+ `BbTag`, `BbDatePickerInput`, `BbTimePickerInput` and `BbColorInput`. Extra
737
+ names are registered through the plugin's `inputVariants` option and styled
738
+ as a token block on `bb-field-input--<name>` — see the installation
739
+ guide.
740
+
625
741
  ### Global config & platforms
626
742
 
627
743
  - `config.defaultInputLabelMode` — project-wide default for `labelMode`
@@ -654,7 +770,7 @@ submit, format checks on blur, errors cleared as the user fixes them.
654
770
  ```vue
655
771
  <template>
656
772
  <form
657
- class="grid max-w-md gap-3 rounded-[var(--bb-radius)] border p-4"
773
+ class="grid max-w-md gap-3 rounded-(--bb-radius) border p-4"
658
774
  novalidate
659
775
  @submit.prevent="submit"
660
776
  >
@@ -662,7 +778,7 @@ submit, format checks on blur, errors cleared as the user fixes them.
662
778
  <p class="text-sm font-medium">
663
779
  Invoice for {{ customer || 'a new client' }}
664
780
  </p>
665
- <p class="text-xs text-[color:var(--bb-text-muted)]">
781
+ <p class="text-xs text-(--bb-text-muted)">
666
782
  Draft INV-2048 · validate on blur / submit, clear as they type
667
783
  </p>
668
784
  </div>
@@ -810,6 +926,220 @@ const formattedTotal = computed(() =>
810
926
  </script>
811
927
  ```
812
928
 
929
+ ### Restyling with passthrough
930
+
931
+ `pt` reaches a named part of the control with a class list — or, in the
932
+ object form, a style and attributes — optionally only while a state is on.
933
+ Parts: `root` (the container), `label`, `description`, `message` (the errors / warnings region — one node each, only one ever shows), `hint` (the helper line — shown on focus, or always with `persistent-hint`), `box` (the bordered field box), `input` (the native control), `icon` (`prepend:icon` + `append:icon` — a broadcast; the state glyphs are chrome), `spinner` (the spinner shown while `loading`), `prefix`, `suffix`, `clear` (the ✕ that empties the field).
934
+ States: `errors`, `warnings` (never beside errors), `loading`, `disabled`, `readonly`, `hasValue` (written `pt:box:has-value`). A name outside that list is a type error and an
935
+ ESLint error.
936
+
937
+ The invoice form above, restyled through those parts: muted icons on
938
+ `pt:icon`, a danger ring on `pt:box:errors`, a primary edge once the field
939
+ holds a value (`pt:box:has-value`), mono on the billing-email `pt:input`.
940
+ Date, number and notes keep library chrome.
941
+
942
+ **pt:icon / pt:box:errors / pt:box:has-value — the invoice text fields**
943
+
944
+ ```vue
945
+ <template>
946
+ <form
947
+ class="grid max-w-md gap-3 rounded-(--bb-radius) border border-(--bb-border) p-4"
948
+ novalidate
949
+ @submit.prevent="onSubmit"
950
+ >
951
+ <div>
952
+ <p class="text-sm font-medium">
953
+ Invoice for {{ customer || 'a new client' }}
954
+ </p>
955
+ <p class="text-xs text-(--bb-text-muted)">
956
+ Draft INV-2048 · validate on blur / submit, clear as they type
957
+ </p>
958
+ </div>
959
+ <BbTextInput
960
+ v-model="customer"
961
+ clearable
962
+ compact
963
+ :errors="errors.customer"
964
+ label="Bill to"
965
+ name="customer"
966
+ placeholder="Company or person"
967
+ prepend:icon="lucide:user"
968
+ pt:box:errors="ring-2 ring-(--bb-danger)"
969
+ pt:box:has-value="border-(--bb-primary)"
970
+ pt:icon="text-(--bb-text-muted)"
971
+ required
972
+ @input="onCustomerInput"
973
+ />
974
+ <BbTextInput
975
+ v-model="email"
976
+ autocomplete="email"
977
+ compact
978
+ :errors="errors.email"
979
+ label="Billing email"
980
+ name="email"
981
+ placeholder="billing@company.com"
982
+ prepend:icon="lucide:mail"
983
+ pt:box:errors="ring-2 ring-(--bb-danger)"
984
+ pt:box:has-value="border-(--bb-primary)"
985
+ pt:icon="text-(--bb-text-muted)"
986
+ pt:input="font-mono text-sm"
987
+ required
988
+ type="email"
989
+ @blur="onEmailBlur"
990
+ @input="onEmailInput"
991
+ />
992
+ <div class="grid gap-3 sm:grid-cols-2">
993
+ <BbDatePickerInput
994
+ v-model="servicePeriod"
995
+ compact
996
+ label="Service period"
997
+ placeholder="Start → end"
998
+ prepend:icon="lucide:calendar"
999
+ range
1000
+ />
1001
+ <BbDatePickerInput
1002
+ v-model="dueDate"
1003
+ compact
1004
+ :errors="errors.dueDate"
1005
+ label="Due date"
1006
+ :min="today"
1007
+ placeholder="YYYY-MM-DD"
1008
+ prepend:icon="lucide:calendar"
1009
+ @update:model-value="onDueDateUpdate"
1010
+ />
1011
+ </div>
1012
+ <div class="grid gap-3 sm:grid-cols-2">
1013
+ <BbNumberInput
1014
+ v-model="quantity"
1015
+ compact
1016
+ label="Quantity"
1017
+ :max="999"
1018
+ :min="1"
1019
+ />
1020
+ <BbNumberInput
1021
+ v-model="unitPrice"
1022
+ compact
1023
+ label="Unit price"
1024
+ :max-precision="2"
1025
+ :min="0"
1026
+ >
1027
+ <template #prefix>$</template>
1028
+ <template #suffix>USD</template>
1029
+ </BbNumberInput>
1030
+ </div>
1031
+ <BbTextarea
1032
+ v-model="notes"
1033
+ auto-grow
1034
+ compact
1035
+ hint="Shown at the bottom of the invoice."
1036
+ label="Notes"
1037
+ persistent-hint
1038
+ placeholder="Payment terms, PO number…"
1039
+ />
1040
+ <div
1041
+ class="flex flex-wrap items-center justify-between gap-2 border-t border-(--bb-border) pt-3"
1042
+ >
1043
+ <p class="text-sm font-medium">
1044
+ {{
1045
+ queued ? `Queued — ${formattedTotal}` : `Total due: ${formattedTotal}`
1046
+ }}
1047
+ </p>
1048
+ <BbButton variant="primary" @click="onSubmit">Queue invoice</BbButton>
1049
+ </div>
1050
+ </form>
1051
+ </template>
1052
+
1053
+ <script setup lang="ts">
1054
+ import { ref, reactive, computed } from 'vue';
1055
+ import dayjs from 'dayjs';
1056
+ import {
1057
+ BbButton,
1058
+ BbTextInput,
1059
+ BbTextarea,
1060
+ BbNumberInput,
1061
+ BbDatePickerInput,
1062
+ } from 'bitboss-ui';
1063
+
1064
+ type InvoiceErrors = { customer: string; email: string; dueDate: string };
1065
+
1066
+ // Same invoice form as `InvoiceForm.vue`, restyled through passthrough on the
1067
+ // text fields: muted icons on `pt:icon`, a danger ring on `pt:box:errors`,
1068
+ // a primary edge once the field holds a value, mono on the email `pt:input`.
1069
+ const customer = ref<string | null>(null);
1070
+ const email = ref<string | null>(null);
1071
+ const servicePeriod = ref<string[]>([]);
1072
+ const dueDate = ref<string | null>(null);
1073
+ const quantity = ref<number>(1);
1074
+ const unitPrice = ref<number>(1200);
1075
+ const notes = ref<string | null>(null);
1076
+ const queued = ref(false);
1077
+
1078
+ const errors = reactive<InvoiceErrors>({
1079
+ customer: '',
1080
+ email: '',
1081
+ dueDate: '',
1082
+ });
1083
+
1084
+ const today = dayjs().format('YYYY-MM-DD');
1085
+
1086
+ const isValidEmail = (value: string) =>
1087
+ /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
1088
+
1089
+ const onCustomerInput = () => {
1090
+ errors.customer = '';
1091
+ };
1092
+
1093
+ const onEmailInput = () => {
1094
+ errors.email = '';
1095
+ };
1096
+
1097
+ const onDueDateUpdate = () => {
1098
+ errors.dueDate = '';
1099
+ };
1100
+
1101
+ const onEmailBlur = () => {
1102
+ if (email.value && !isValidEmail(email.value)) {
1103
+ errors.email = 'Enter a valid email address';
1104
+ }
1105
+ };
1106
+
1107
+ const onSubmit = () => {
1108
+ queued.value = false;
1109
+ errors.customer = customer.value ? '' : 'Tell us who to bill';
1110
+ errors.email = email.value
1111
+ ? isValidEmail(email.value)
1112
+ ? ''
1113
+ : 'Enter a valid email address'
1114
+ : 'A billing email is required';
1115
+ errors.dueDate = dueDate.value ? '' : 'Pick a due date';
1116
+ if (!errors.customer && !errors.email && !errors.dueDate) {
1117
+ queued.value = true;
1118
+ }
1119
+ };
1120
+
1121
+ const formattedTotal = computed(() =>
1122
+ new Intl.NumberFormat('en-US', {
1123
+ style: 'currency',
1124
+ currency: 'USD',
1125
+ }).format((quantity.value ?? 0) * (unitPrice.value ?? 0))
1126
+ );
1127
+ </script>
1128
+ ```
1129
+
1130
+ A listener on `pt:input` concatenates after the control's own handler, never
1131
+ instead of it. Pick a `variant` first — `ghost` or `none` — when the whole box
1132
+ should change; `pt:box` is for the one-off, and
1133
+ `:pt:box="{ style: { '--bg': … } }"` is the sanctioned way to hand the box a
1134
+ look variable. `pt:input` carries native attributes (`autocomplete`,
1135
+ `inputmode`, `data-*`) as well as classes. Classes append to ours, an
1136
+ attribute in `attrs` wins over ours. The full grammar, the merge rules and
1137
+ the global map are in the [passthrough guide](./guides/passthrough.md).
1138
+
1139
+ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
1140
+ `pt` prop) is typed as `BbTextInputProps['pt']`, never an imported `PtValue`: see
1141
+ [passthrough § Typing `pt` in `<script>`](./guides/passthrough.md#typing-pt-in-script).
1142
+
813
1143
  ### Works well with
814
1144
 
815
1145
  - `BbButton` — submit actions; an async `@click` handler gets automatic
@@ -824,16 +1154,16 @@ const formattedTotal = computed(() =>
824
1154
 
825
1155
  ### Gotchas & anti-patterns
826
1156
 
827
- - An emptied field emits `null`, not `''` — write `value ?? ''` when feeding
1157
+ - An emptied field emits `null` by default (`''` with the `formControls` plugin option) — write `value ?? ''` when feeding
828
1158
  APIs that require strings.
829
- - `direction` is ignored under `labelMode="floating"`/`"inside"` — those modes
1159
+ - `layout` is ignored under `labelMode="floating"`/`"inside"` — those modes
830
1160
  embed the label in the field and force the vertical layout (see _Density &
831
1161
  layout_).
832
1162
  - `loading` does not lock the field — it's a status light, not a guard.
833
1163
  - Don't rebuild the clear button in an `append` slot; `clearable` already
834
1164
  handles show/hide, clearing and refocusing.
835
1165
  - Don't put buttons in `prefix`/`suffix` — clicks there focus the input; use
836
- `append-outer`/`prepend-outer` for interactive neighbors.
1166
+ `append:outer`/`prepend:outer` for interactive neighbors.
837
1167
  - Don't validate _while_ the user types their first attempt; validate on
838
1168
  `blur` or submit, then clear errors on `input` (see the invoice example).
839
1169
  - Masked fields emit the **unmasked** value by default — don't strip
@@ -858,79 +1188,127 @@ const formattedTotal = computed(() =>
858
1188
 
859
1189
  ## v-model
860
1190
 
861
- - `v-model` — type: `string \| null`
1191
+ - `v-model` — type: `string \| null \| undefined`
862
1192
 
863
1193
  ## Props
864
1194
 
865
1195
  | Prop | Type | Default | Required | Description |
866
1196
  | --- | --- | --- | --- | --- |
1197
+ | `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `box`, `clear`, `description`, `hint`, `icon`, `input`, `label`, `message`, `prefix`, `root`, `spinner`, `suffix`. States: `disabled`, `errors`, `hasValue`, `loading`, `readonly`, `warnings`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbTextInputProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
867
1198
  | `append:icon` | `string \| undefined` | | | Name of the icon to be added at the end of the input. |
868
1199
  | `autocomplete` | `string \| undefined` | | | Guides to the browser as to the type of information expected in the field. |
869
1200
  | `autofocus` | `Booleanish \| undefined` | | | Sets autofocus on page load. |
870
- | `clearable` | `boolean \| undefined` | | | Displays a clear button when the input has a value and is being interacted with. |
871
- | `compact` | `boolean \| undefined` | | | Displays the component in a compact version. |
1201
+ | `clearable` | `boolean \| undefined` | `false` | | Displays a clear button when the input has a value and is being interacted with. |
1202
+ | `compact` | `boolean \| undefined` | `false` | | Compact density. Swaps `--bb-input-h`, `--bb-input-py` and `--bb-label-spacing-y` for their `-compact` twins on the field, so a `--bb-input-h` you set on the component is ignored while `compact` is on: size a compact field with `--bb-input-h-compact` (and `--bb-input-py-compact`) instead. |
872
1203
  | `description` | `string \| undefined` | | | Descriptive text displayed below the label and above the input. Unlike the hint it is always visible, and it is linked to the input via `aria-describedby` (after any `errors` / `warnings`, before the `hint`). |
873
- | `direction` | `InputDirection \| undefined` | | | Direction of the layout of the component. Can either be a predefined value or a pattern separated by a space like `xx xxxxx`. |
874
- | `disabled` | `boolean \| undefined` | | | Disables the component. |
875
- | `emitMasked` | `boolean \| undefined` | | | Emits the masked value of the input. |
876
- | `errors` | `string \| string[] \| undefined` | | | Can be a string or an array of string containing the messages to display. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, are referenced FIRST from the control's `aria-describedby… |
877
- | `hasErrors` | `boolean \| undefined` | | | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
878
- | `hasWarning` | `boolean \| undefined` | | | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
879
- | `hideLabel` | `boolean \| undefined` | | | Visually hides the label of the input while maintaining accessibility. |
1204
+ | `disabled` | `boolean \| undefined` | `false` | | Disables the component. |
1205
+ | `emitMasked` | `boolean \| undefined` | `false` | | Emits the masked value of the input. |
1206
+ | `errors` | `string \| string[] \| undefined` | | | Can be a string or an array of string containing the messages to display. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, are referenced FIRST from the control's `aria-describedby`, so the reason the field is invalid is re-read whenever the control regains focus. |
1207
+ | `formless` | `boolean \| undefined` | `false` | | Keep this control out of the enclosing `BbForm` entirely: not submitted, not dirty, not reset, not validated. For a control that is not form data (a filter, a "show advanced" switch). |
1208
+ | `hasErrors` | `boolean \| undefined` | `false` | | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
1209
+ | `hasWarnings` | `boolean \| undefined` | `false` | | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
1210
+ | `hideLabel` | `boolean \| undefined` | `false` | | Visually hides the label of the input while maintaining accessibility. |
880
1211
  | `hint` | `string \| undefined` | | | Text box to be displayed near the input, usually to indicate instructions. |
881
- | `id` | `string \| undefined` | | | The identifier of the component. |
882
- | `inputMode` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "none" \| "numeric" \| "decimal" \| undefined` | | | The inputmode of the input. |
1212
+ | `id` | `string \| undefined` | | | The `id` of the native control; the label's `for` and the description and message ids derive from it. Generated when omitted. |
1213
+ | `inputMode` | `"text" \| "none" \| "search" \| "email" \| "url" \| "tel" \| "numeric" \| "decimal" \| undefined` | | | The inputmode of the input. |
883
1214
  | `label` | `string` | | yes | Text content of the label of the element. |
884
- | `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` | | | Label rendering mode. |
1215
+ | `labelMode` | `"outside" \| "floating" \| "inside" \| undefined` | | | Label rendering mode. |
885
1216
  | `labelPosition` | `"left" \| "center" \| "right" \| undefined` | | | Sets the text alignment of the label. |
886
- | `loading` | `boolean \| undefined` | | | Sets the component in a loading state, usually triggering some visual styles. |
1217
+ | `layout` | `FieldLayout \| undefined` | | | How the label and the input sit together: `'vertical'`, `'horizontal'` (50/50), `'auto'`, `'label-fill'` (the label takes the free space, the input keeps its size), `'input-fill'` (the other way round), or a two-word ratio pattern like `'xx xxxxx'`. |
1218
+ | `loading` | `boolean \| undefined` | `false` | | Sets the component in a loading state, usually triggering some visual styles. |
887
1219
  | `mask` | `MaskInputOptions \| undefined` | | | The mask to be applied to the input. Please visit https://beholdr.github.io/maska/v3 for syntax examples. |
888
- | `modelValue` | `string \| null` | | yes | Used by v-model. |
1220
+ | `modelValue` | `string \| null \| undefined` | | | Used by v-model. |
889
1221
  | `name` | `string \| undefined` | | | Defines the name of the input. |
890
- | `persistentHint` | `boolean \| undefined` | | | Keeps the hint displayed. |
1222
+ | `persistentHint` | `boolean \| undefined` | `false` | | Keeps the hint displayed. |
891
1223
  | `placeholder` | `string \| undefined` | | | String displayed when there's no data. |
892
1224
  | `prepend:icon` | `string \| undefined` | | | Name of the icon to be added at the start of the input. |
893
- | `readonly` | `boolean \| undefined` | | | Sets the input in a readonly state. |
894
- | `required` | `boolean \| undefined` | | | Sets the input as required. |
895
- | `reverse` | `boolean \| undefined` | | | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
896
- | `type` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "password" \| undefined` | | | Type of the input. Restricted to the textual input types this component supports — use `BbNumberInput` for numbers and `BbDatePickerInput` for dates. |
897
- | `warnings` | `string \| string[] \| undefined` | | | Warning messages to display beneath the field, in their own `aria-live` region and amber (`--bb-text-warn`). A string or array; a non-empty list implies the warning state. Errors suppress warnings when both are set. While displayed they are… |
1225
+ | `readonly` | `boolean \| undefined` | `false` | | Sets the input in a readonly state. |
1226
+ | `required` | `boolean \| undefined` | `false` | | Sets the input as required. |
1227
+ | `reverse` | `boolean \| undefined` | `false` | | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
1228
+ | `rules` | `RuleExpression<string \| null>` | | | vee-validate rules for this field. Only inside a `BbForm`. |
1229
+ | `type` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "password" \| undefined` | `"text"` | | Type of the input. Restricted to the textual input types this component supports — use `BbNumberInput` for numbers and `BbDatePickerInput` for dates. |
1230
+ | `validationLabel` | `string \| undefined` | | | The field's name in validation messages (`{field}`): "Email is not valid". Defaults to the `label` (or `legend`), then "This field"; the field's `name` never shows. Set it when the label is not a good noun for a sentence (an icon-only label, a question) or is hidden. Only inside a `BbForm`. |
1231
+ | `validationMode` | `'aggressive'` \| `'balanced'` \| `'lazy'` \| `'submit-only'` \| `'submit-live'` | | | When this field checks itself while the user works: `aggressive` (every change), `balanced` (on leave, then every change while it shows an error), `lazy` (on leave only), `submit-only` (on submit only) or `submit-live` (on submit, then every change while it shows an error). "Leave" is blur for a text-like control, and focus leaving the whole control for a picker or a group; a checkbox or switch commits on click. Unset, the enclosing `BbForm`'s `validation-mode` applies, then the app's `formControls.validationMode` (`'balanced'`). Only inside a `BbForm`. |
1232
+ | `variant` | `'outline'` \| `'secondary'` \| `'none'` \| `'ghost'` | `'outline'` | | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any state (errors and warnings show through the icon and the messages); every variant keeps the focus ring. Register extra names with the plugin's `inputVariants` option. `'none'` is a blank starting point: the field keeps its structure and behaviour but takes no look, so your own classes don't fight a built-in one. You then own hover, focus, disabled and the error / warning states. Fine for a one-off; keep inline styling short, and register a real variant (`inputVariants`) when the look recurs. |
1233
+ | `warnings` | `string \| string[] \| undefined` | | | Warning messages to display beneath the field, in their own `aria-live` region and amber (`--bb-text-warn`). A string or array; a non-empty list implies the warning state. Errors suppress warnings when both are set. While displayed they are also referenced from the control's `aria-describedby`, after any errors and before the description/hint. |
1234
+
1235
+ ## Passthrough parts and states
1236
+
1237
+ `pt:<part>="…"` restyles a part; `pt:<part>:<state>="…"` applies only while the state is on. A component-wide state is on for every part at once; a _per node_ state resolves on each node of a broadcast part (one row, one option, one day). Grammar and merge rules: `guides/passthrough.md`. In `<script>`, type a `pt` value as `<Component>Props['pt']` (`<Component>Props<Row>['pt']` on a generic component); `PtValue` is not exported: `guides/passthrough.md` § Typing `pt` in `<script>`.
1238
+
1239
+ | Part | What it is |
1240
+ | --- | --- |
1241
+ | `root` | The field's outer container: the label, the box and the lines under it. |
1242
+ | `label` | The label text above the box (the `label` prop). |
1243
+ | `description` | The muted line under the label (the `description` prop). |
1244
+ | `message` | The errors / warnings line under the box. A node of its own: it can show at the same time as `hint`. |
1245
+ | `hint` | The helper line (the `hint` prop), shown on focus, or always with `persistent-hint`. |
1246
+ | `box` | The bordered box around the input — border, background and radius; the `variant` paints here. |
1247
+ | `input` | The native input element inside the box. |
1248
+ | `icon` | The content icons, prepend and append — a broadcast. Chrome (the clear ✕, a chevron, the error / warning glyph) is never in it. |
1249
+ | `spinner` | The spinner inside the box while `loading`. |
1250
+ | `prefix` | The `#prefix` slot's wrapper, inside the box before the input. |
1251
+ | `suffix` | The `#suffix` slot's wrapper, inside the box after the input. |
1252
+ | `clear` | The ✕ that empties this control (`clearable`) — one node, never a chip's own ✕. |
1253
+
1254
+ States are listed in precedence order: when two are on at once and their entries conflict, the later one wins.
1255
+
1256
+ | State | When it is on |
1257
+ | --- | --- |
1258
+ | `hasValue` | Component-wide: the control holds a value, by its own rule (`0` counts on `BbNumberInput`, `''` on `BbColorInput`). |
1259
+ | `readonly` | Component-wide: the control is `readonly` — shown, focusable, not editable. |
1260
+ | `disabled` | Component-wide: the control is `disabled`. |
1261
+ | `warnings` | Component-wide: the control is in its warning state (`warnings` / `has-warnings`) and not in an error state — errors win, so the two are never on together. |
1262
+ | `errors` | Component-wide: the control is in its error state (`errors` / `has-errors`, or its validation) — the message line and the box turn red. |
1263
+ | `loading` | Component-wide: `loading` is on; the box shows its `spinner`. |
898
1264
 
899
1265
  ## Events
900
1266
 
901
- - `blur` — `(event: "blur", event: FocusEvent): void`
902
- - `change` — `(event: "change", event: Event): void`
903
- - `click` — `(event: "click", event: MouseEvent): void`
904
- - `compositionend` — `(event: "compositionend", event: CompositionEvent): void`
905
- - `compositionstart` — `(event: "compositionstart", event: CompositionEvent): void`
906
- - `focus` — `(event: "focus", event: FocusEvent): void`
907
- - `input` — `(event: "input", event: Event): void`
908
- - `keydown` — `(event: "keydown", event: KeyboardEvent): void`
909
- - `keyup` — `(event: "keyup", event: KeyboardEvent): void`
910
- - `mousedown` — `(event: "mousedown", event: MouseEvent): void`
911
- - `mouseup` — `(event: "mouseup", event: MouseEvent): void`
912
- - `paste` — `(event: "paste", event: ClipboardEvent): void`
913
- - `update:modelValue` — `(event: "update:modelValue", value: string \| null): void`
1267
+ - `blur` — `(event: FocusEvent): void` — Emitted when the native input loses focus. Forwards the original DOM `FocusEvent`.
1268
+ - `change` — `(event: Event): void` — Emitted when the native input fires a change event. Forwards the original DOM `Event`.
1269
+ - `click` — `(event: MouseEvent): void` — Emitted when the input receives a click interaction. Forwards the original DOM `MouseEvent`.
1270
+ - `compositionend` — `(event: CompositionEvent): void` — Emitted when a composition session ends (e.g. CJK IME confirmed). Forwards the original DOM `CompositionEvent`.
1271
+ - `compositionstart` — `(event: CompositionEvent): void` — Emitted when a composition session starts (e.g. CJK IME begins). Forwards the original DOM `CompositionEvent`.
1272
+ - `focus` — `(event: FocusEvent): void` — Emitted when the native input gains focus. Forwards the original DOM `FocusEvent`.
1273
+ - `input` — `(event: Event): void` — Emitted on native input events from the text field. Forwards the original DOM `Event`.
1274
+ - `keydown` — `(event: KeyboardEvent): void` — Emitted for keyboard interaction on the input. Forwards the original DOM `KeyboardEvent`.
1275
+ - `keyup` — `(event: KeyboardEvent): void` — Emitted when a key is released over the input. Forwards the original DOM `KeyboardEvent`.
1276
+ - `mousedown` — `(event: MouseEvent): void` — Emitted when a pointing device button is pressed over the input. Forwards the original DOM `MouseEvent`.
1277
+ - `mouseup` — `(event: MouseEvent): void` — Emitted when a pointing device button is released over the input. Forwards the original DOM `MouseEvent`.
1278
+ - `paste` — `(event: ClipboardEvent): void` — Emitted when content is pasted into the input. Forwards the original DOM `ClipboardEvent`.
1279
+ - `update:modelValue` — `(value: string \| null): void` — Emitted when the value changes. Carries the new string or `null` when cleared. When `mask` is set, emits the masked or unmasked string depending on `emitMasked`.
914
1280
 
915
1281
  ## Slots
916
1282
 
917
- - `append` — scope: `object` — Content rendered after the text input, at the end of the inner container.
918
- - `append-outer` — scope: `object` — Content rendered after the entire text input control, outside the input chrome.
919
- - `label` — scope: `BbTextInputLabelSlotProps` — Replaces the default label text rendered above the input.
1283
+ - `append` — scope: `object` — Content rendered after the text input, at the end of the field box.
1284
+ - `append:outer` — scope: `object` — Content rendered after the entire text input control, outside the input chrome.
1285
+ - `description` — scope: `BbTextInputDescriptionSlotProps` `{ text: string; hasErrors: boolean; hasWarnings: boolean }` — Replaces the description text. Provided alone (no `description` prop) it still renders the description region and wires it into `aria-describedby`.
1286
+ - `label` — scope: `BbTextInputLabelSlotProps` `{ text: string; hasErrors: boolean; hasWarnings: boolean }` — Replaces the default label text rendered above the input.
920
1287
  - `prefix` — scope: `object` — Inline content rendered at the start of the input field area, before the typed text.
921
- - `prepend` — scope: `object` — Content rendered before the text input, at the start of the inner container.
922
- - `prepend-outer` — scope: `object` — Content rendered before the entire text input control, outside the input chrome.
1288
+ - `prepend` — scope: `object` — Content rendered before the text input, at the start of the field box.
1289
+ - `prepend:outer` — scope: `object` — Content rendered before the entire text input control, outside the input chrome.
923
1290
  - `suffix` — scope: `object` — Inline content rendered at the end of the input field area, after the typed text.
924
1291
 
925
- ## Validated variant
1292
+ ## CSS custom properties
926
1293
 
927
- Importing this component from `bitboss-ui/validated` instead of `bitboss-ui` binds it to a vee-validate field. Same props, same events, same slots — plus the ones below. Requires the `vee-validate` peer dependency and a `<BbForm>` (or `useForm()`) ancestor. Full guide: [validated-forms](./guides/validated-forms.md).
1294
+ Set these on the element, or on a class you put on it, to retune this component alone — the sanctioned alternative to reaching past the API with `:deep()`. They are this component's own locals — a **Set on** of `pt:<part>` means the local lives on that part's element, so set it through that entry (`pt:box="[--border-color:var(--color-green-500)]"`); the global `--bb-*` theme tokens are a separate tier (see the [design-tokens guide](./guides/design-tokens.md), or the MCP `list_tokens` tool).
928
1295
 
929
- | Prop | Type | Description |
930
- | --- | --- | --- |
931
- | `rules` | `RuleExpression<string \| null>` | vee-validate rules for this field. |
932
- | `validateOn` | `ValidateTiming[] \| undefined` | Which interactions trigger validation (see `ValidatedFieldProps.validateOn` for the timing vocabulary). |
933
- | `vid` | `string \| undefined` | Explicit vee-validate field name. **Usually omit it** — the name is derived automatically from the control's `label`/`legend`. Only set `vid` when that derivation wouldn't be unique (e.g. v-for rows, or array `v-model`s that share a label).… |
1296
+ | Property | Set on | Default | What it is |
1297
+ | --- | --- | --- | --- |
1298
+ | `--border-color` | `pt:box` | `per variant` | The resting border, at the fixed --bb-border-w. Errors and warnings paint their frame over it, so `pt:box="[--border-color:…]"` recolours the rest without hiding the state; a plain `border-*` utility on the base pt:box would hide it (ESLint `no-box-border-color`). |
1299
+
1300
+ ## Component tree
1301
+
1302
+ `BbTextInput` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `BbTextInput`, and before concluding a part, a token or a behaviour does not exist** — it may live on a component further down. How to read it:
1303
+
1304
+ - **_internal_** nodes are building blocks with no API of their own: you reach them only through `BbTextInput`. A pt part listed as landing there is set on `BbTextInput` (`pt:<part>`).
1305
+ - **_public_** nodes are components with their own contract. `BbTextInput` reaches one only through a pt part of its own that lands on it (shown on the parent node as `part → Component`, e.g. `spinner → BbSpinner`) or through a pt map it hands it (shown as "hands … the pt map", in `BbTextInput`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
1306
+ - **CSS custom properties** listed on a node are declared on THAT node's root and read by elements inside it. Set one on that node's root or on the element inside it that reads it — the pt part that lands there is how you reach it (`pt:box="[--border-color:…]"` on a text input) — never on `BbTextInput`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
1307
+ - Listed nodes are the ones `BbTextInput`'s API reaches or that declare a documented CSS variable; the rest fold into "also mounts". The complete tree, repeats and undocumented locals included, is the `tree` field of this component in `components.json`.
1308
+
1309
+ - `BbTextInput` _(this component)_ — its own template binds: `controlAttrs` → `input.bb-text-input__input`, `input` → `input.bb-text-input__input`
1310
+ - `CommonField` _(internal — not importable, reach it through `BbTextInput`)_ — `BbTextInput`'s pt parts land here: `root` → `div.bb-field`, `label` → `component`, `description` → `span.bb-field__description`, `hint` → `span.bb-field__hint`, `message` → `div.bb-field__message`; also mounts `BbAsterisk`
1311
+ - `CommonFieldInput` _(internal — not importable, reach it through `BbTextInput`)_ — `BbTextInput`'s pt parts land here: `box` → `span.bb-field-input__box`, `prefix` → `span.bb-field-input__prefix`, `icon` → `BbIcon`, `clear` → `ClearableButton`, `spinner` → `BbSpinner`, `suffix` → `span.bb-field-input__suffix`; documented CSS variables: `--bg`, `--bg-hover`, `--bg-focus`, `--bg-disabled`, `--border-color`, `--border-focus`, `--ring-size`, `--ring-color`, `--elev`, `--frost`, `--inside-label-clearance`; also mounts `ErrorIcon`, `WarningIcon`, `ClearableButton`, `BbIcon`, `BbSpinner`
934
1312
 
935
1313
  ## See Also
936
1314