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
@@ -31,19 +31,16 @@ goes stable, so never reach for it here.
31
31
 
32
32
  Peer dependency: `vue ^3.5.12` — the only required one. `@inertiajs/vue3` is an **optional** peer, needed only in Inertia apps.
33
33
 
34
- `@iconify/collections` is an **optional** peer too, and npm never installs
35
- optional peers automatically — install it yourself if you want the dev-time
36
- provider-icon diagnostics:
37
-
38
- ```bash
39
- npm install -D @iconify/collections
40
- ```
41
-
42
- Without it the plugin has no list of valid Iconify prefixes, so the dev-overlay
43
- errors below (the "install `@iconify-json/<prefix>`" hint and the "did you
44
- mean …?" suggestion for a mistyped icon name) never fire — a wrong provider
45
- icon then surfaces only as `BbIcon`'s generic runtime `Icon "…" does not exist.`
46
- Nothing else changes: icons that resolve still render, in dev and in production.
34
+ You do **not** need `@iconify/collections`. It is declared as an optional peer
35
+ for one reason only: when it happens to be installed, the dev-overlay message
36
+ for an unknown icon prefix can say for certain whether that prefix is a real
37
+ Iconify set ("requires `@iconify-json/mdi`, run …") or not ("neither an
38
+ installed set nor a known Iconify prefix"). Without it the same overlay fires
39
+ with a hedged wording ("no installed icon set has the prefix `mdi`; if it is an
40
+ Iconify set, run …"). A mistyped name inside a set you **have** installed
41
+ (`lucide:eye-misspelled`) is diagnosed from the set's own data in both cases,
42
+ with a "did you mean …?" suggestion. Nothing else changes: icons that resolve
43
+ still render, in dev and in production.
47
44
 
48
45
  **Known-good toolchain:** TypeScript **5.x or 6.x** if your build gate runs
49
46
  `vue-tsc`. Both type-check cleanly against the shipped `.d.ts`; the library
@@ -62,17 +59,19 @@ declared with `generic="T"` emits as a generic _function_ (`declare const
62
59
  __VLS_export: <T = any>(__VLS_props …) => VNode`) rather than the
63
60
  `DefineComponent<…>` object non-generic components get. Vue Language Tools 2
64
61
  does not read props out of that shape, so under `vue-tsc` 2 the template
65
- type-checker silently type-checks **nothing** about the props of these nine
62
+ type-checker silently type-checks **nothing** about the props of these ten
66
63
  public components:
67
64
 
68
65
  `BbSelect` · `BbSelectPopover` · `BbTable` · `BbTabs` · `BbTabsRoot` ·
69
- `BbTree` · `BbRadioGroup` · `BbCheckboxGroup` · `BbSwitchGroup`
66
+ `BbTree` · `BbRadioGroup` · `BbCheckboxGroup` · `BbSwitchGroup` · `BbForm`
67
+ (generic over its `schema` so
68
+ `@submit` is typed from the schema)
70
69
 
71
70
  (and their `BbBase*` primitives). Missing required props, misspelled props,
72
71
  wrong value types — all pass. The trap is that the failure is partial and
73
72
  invisible: unknown-**component** checking still fires, non-generic components
74
73
  like `BbButton` and `BbTextInput` still reject bad props, so the gate is
75
- visibly working and you conclude the generic nine are covered too. A real
74
+ visibly working and you conclude the generic ten are covered too. A real
76
75
  consumer shipped `<BbRadioGroup label="…">` (the prop is `legend`) through six
77
76
  release slices on `vue-tsc@^2.2.12` with a green `--noEmit`; the same file under
78
77
  `vue-tsc` 3.2.8 fails immediately with TS2345 + TS2322.
@@ -109,18 +108,30 @@ without your own polyfill strategy (untested, unsupported).
109
108
  // vite.config.ts
110
109
  import { defineConfig } from 'vite';
111
110
  import vue from '@vitejs/plugin-vue';
112
- import { bitbossUi } from 'bitboss-ui/vite';
111
+ import { bitbossUi, TAILWIND_V4_LAYERS } from 'bitboss-ui/vite';
113
112
 
114
113
  export default defineConfig({
115
114
  plugins: [
116
115
  vue(),
117
116
  bitbossUi({
118
117
  iconDir: './src/assets/icons',
118
+ // Tailwind v4: keep this line (§5 Cascade layers). v3 or plain CSS: drop it.
119
+ cssLayers: TAILWIND_V4_LAYERS,
119
120
  }),
120
121
  ],
121
122
  });
122
123
  ```
123
124
 
125
+ **On Tailwind v4, `cssLayers` is not optional in practice.** Tailwind v4 puts
126
+ its utilities in a cascade layer, and unlayered CSS beats every layered rule;
127
+ without the line above the library's CSS is unlayered, so a utility on a
128
+ `Bb*` component or a `pt:*` part does nothing. §5 has the full story.
129
+
130
+ **Do not import `bitboss-ui/styles.css` yourself** while `injectStyles` is on
131
+ (the default): `app.use(bitbossUiPlugin)` below injects it, into its layer. A hand import
132
+ adds a second, unlayered copy, and that copy outranks your utilities again.
133
+ `npx bitboss-ui check` reports one (`hand-imported-styles`).
134
+
124
135
  ```ts
125
136
  // main.ts
126
137
  import { createApp } from 'vue';
@@ -132,6 +143,10 @@ app.use(bitbossUiPlugin);
132
143
  app.mount('#app');
133
144
  ```
134
145
 
146
+ The plugin registers no components globally: import each one where you use it
147
+ (`import { BbButton, BbSelect } from 'bitboss-ui'`). Guide examples leave those
148
+ imports out. In Nuxt, `autoImport: true` registers them instead (§3).
149
+
135
150
  If the icon folder does not exist yet, create it (`mkdir -p src/assets/icons`) and keep the path aligned with `iconDir`.
136
151
 
137
152
  ## 3) Nuxt
@@ -140,16 +155,65 @@ The Nuxt module wraps the same Vite plugin and auto-registers the runtime plugin
140
155
 
141
156
  ```ts
142
157
  // nuxt.config.ts
158
+ import { TAILWIND_V4_LAYERS } from 'bitboss-ui/vite';
159
+
143
160
  export default defineNuxtConfig({
144
161
  modules: ['bitboss-ui/nuxt'],
145
162
  bitboss: {
146
163
  iconDir: './assets/icons', // module default
164
+ // Tailwind v4: keep this line (§5 Cascade layers). v3 or plain CSS: drop it.
165
+ cssLayers: TAILWIND_V4_LAYERS,
147
166
  },
148
167
  });
149
168
  ```
150
169
 
151
170
  All options below go under the `bitboss` config key. `nuxtLinkName` controls which globally registered component renders router links (default `'NuxtLink'`).
152
171
 
172
+ This module supersedes the standalone `@bitboss-dev/bitboss-ui-nuxt` package, which was the v2 Nuxt integration — uninstall it (see [Migration v2 → v3](./migration/v2-to-v3.md)).
173
+
174
+ **SSR needs nothing from you.** The library must be bundled into the server
175
+ build (it imports `virtual:bitboss-ui/*` modules only the build plugin can
176
+ resolve — see `ssrViewportWidth` below), and Nuxt already does that: every
177
+ package listed in `modules` goes on `build.transpile`, and since the module
178
+ ships inside `bitboss-ui` the whole package is inlined into both the dev and the
179
+ production server bundle. Verified against a registry-style (tarball) install
180
+ on Nuxt 4.5; the plugin's own `ssr.noExternal` entry is a no-op there.
181
+
182
+ ### `autoImport?: boolean | { components?: boolean; composables?: boolean; validated?: boolean }` (default: `false`, Nuxt only)
183
+
184
+ Registers the library's components and composables with Nuxt's auto-import system, so templates write `<BbButton>` and `useToast()` with no import line:
185
+
186
+ ```ts
187
+ // nuxt.config.ts
188
+ export default defineNuxtConfig({
189
+ modules: ['bitboss-ui/nuxt'],
190
+ bitboss: {
191
+ iconDir: './assets/icons',
192
+ autoImport: true,
193
+ },
194
+ });
195
+ ```
196
+
197
+ `true` means `{ components: true, composables: true }`, `BbForm` and
198
+ `useBbFormContext` included; pass the object form to narrow it. (The
199
+ `validated: true` option is gone since 3.0.0-beta.41: the form controls are the
200
+ form-aware ones everywhere.)
201
+
202
+ **It is off by default on purpose, and leaving it off is the better setup.**
203
+ Explicit imports are what make `vueCompilerOptions.checkUnknownComponents` (see
204
+ section 9) able to fail the build on a mistyped or unimported `Bb*` tag; with
205
+ auto-imports on, every `Bb*` tag resolves and that gate goes quiet. Reach for it
206
+ when you are moving an app off `@bitboss-dev/bitboss-ui-nuxt`, whose templates
207
+ were written against auto-imported components, and adding the imports is a
208
+ separate commit from the upgrade.
209
+
210
+ Two things it deliberately does not do. It never overrides your own components:
211
+ a `~/components/BbButton.vue` in the app keeps winning, and the library only
212
+ fills names the app has not claimed. And it never registers the library's
213
+ `useId` — Nuxt already auto-imports Vue's, and shadowing it would silently
214
+ redirect every existing `useId()` call in the app; import that one explicitly if
215
+ you want it.
216
+
153
217
  ## 4) Inertia
154
218
 
155
219
  Inertia apps are Vite apps: configure `bitboss-ui/vite` exactly as in section 2, install `@inertiajs/vue3`, then install the runtime plugin in `createInertiaApp`:
@@ -176,6 +240,23 @@ defaults, analytics, whatever — that keeps winning: a component registered und
176
240
  `inertiaLinkName` (default `'Link'`) is always preferred over the imported one.
177
241
  Register it under a different name and point `inertiaLinkName` at it.
178
242
 
243
+ **Inertia SSR** (`build:ssr` and the dev SSR endpoint alike) needs no extra
244
+ config: the build plugin adds `ssr: { noExternal: ['bitboss-ui'] }` for you,
245
+ because the library imports `virtual:bitboss-ui/*` modules that only the
246
+ plugin can resolve — externalised to Node, a server render fails with
247
+ `ERR_UNSUPPORTED_ESM_URL_SCHEME … 'virtual:'` and Inertia silently falls back
248
+ to client rendering. If your `vite.config.ts` still carries that line from
249
+ before 3.0.0-beta.29, it can go (the plugin never duplicates yours).
250
+
251
+ **Upgrading under Docker / Laravel Sail.** After `npm install` of a new
252
+ version, stop the dev server, delete `node_modules/.vite`, and start it again
253
+ — all inside the container that runs Vite. A server started before the
254
+ install keeps serving the previous version's pre-bundled JS next to the new
255
+ CSS, which looks exactly like a regression. From 3.0.0-beta.35 on, the page says so in dev: a console warning names both versions when the JS and `styles.css` disagree, and the first dev start after an upgrade prints the `npx bitboss-ui changelog --since <old version>` command that lists what broke. The `bitboss-ui` CLI (`check`,
256
+ `changelog`) runs on Node 20.19 or later, so the container's Node works; a
257
+ quoted glob argument (`check 'resources/**/*.vue'`) needs Node 22, so pass
258
+ the directory instead (`check resources/js`).
259
+
179
260
  ## 5) Styling
180
261
 
181
262
  Two runtime options control CSS:
@@ -185,7 +266,7 @@ Two runtime options control CSS:
185
266
 
186
267
  Guaranteed order when injected: **reset → library styles → all other stylesheets**, so app-local CSS can always override the library.
187
268
 
188
- `resetCss` stays opt-in because Tailwind projects already ship Preflight — a second reset is usually unnecessary.
269
+ `resetCss` stays opt-in because Tailwind projects already ship Preflight — a second reset is usually unnecessary. A reset of SOME kind is a prerequisite of the components, not a nicety: every size in the component sheets is written for `border-box`, and native controls and fieldsets are expected to arrive without their browser chrome. Preflight provides all of that; on a page with neither Preflight nor this file, a selectable table's fieldset grows a groove border and a 36px cell renders 49px. `reset.css` is optional only in the sense that you may bring your own — the component test suite runs against this file, with no Tailwind on the page.
189
270
 
190
271
  **Tailwind v4 cascade layers vs. scoped `<style>`:** Tailwind v4's `@import
191
272
  'tailwindcss'` puts every utility class in `@layer utilities`. A Vue SFC's
@@ -254,24 +335,239 @@ Leave `resetCss` at `false` here — Preflight already reset everything.
254
335
  Nothing else about the plugin changes; `injectStyles` controls only whether the
255
336
  library injects its own `<style>`.
256
337
 
257
- **Tailwind v4 apps do not need this** — source order does not decide their ties
258
- at all. `@import 'tailwindcss'` puts Preflight in a real `@layer base` and
259
- utilities in `@layer utilities`, and layered rules lose to unlayered rules of
260
- equal specificity **regardless of source order**. `dist/styles.css` declares no
261
- `@layer`, so the library wins those ties wherever it is injected: leave
262
- auto-injection on. The same mechanic bites the other way, and silently — a
263
- utility cannot re-size a Bb component either. `<BbButton class="h-12 px-6">`
264
- loses to the library's own `.bb-button { height: var(--h); padding-left:
265
- var(--px); padding-right: var(--px) }` (equal specificity, unlayered), with no
266
- warning from anything. Size Bb components through their props and tokens, never
267
- utilities. (Same trap as the scoped-`<style>` case above, one level up.)
338
+ **Tailwind v4 apps do not need `injectStyles: false`** — source order does not
339
+ decide their ties at all. `@import 'tailwindcss'` puts Preflight in a real
340
+ `@layer base` and utilities in `@layer utilities`, and **a layered rule loses to
341
+ an unlayered one regardless of source order**. Leave auto-injection on and use
342
+ `cssLayers` below.
343
+
344
+ ### Cascade layers — the switch that decides who wins a tie
345
+
346
+ The cascade weighs **layer before specificity**. Unlayered CSS beats every
347
+ layered rule, however specific the layered one is. That one fact means there is
348
+ no single correct default, so the option is opt-in and you tell the library
349
+ where it sits:
350
+
351
+ | your CSS | `cssLayers` | who wins a tie |
352
+ | -------------------------------------------- | ----------------------------------- | ---------------------------------------------- |
353
+ | no layers (plain CSS, Tailwind v3) | unset (default) | source order — library first, so your CSS wins |
354
+ | Tailwind v4, or any layered CSS | your full order, ours in it (below) | exactly what your array says |
355
+ | no layers, and you want to override anything | `['bitboss-ui']` | you do, always |
356
+
357
+ The value is always an array: your complete layer order with `bitboss-ui` in
358
+ it, and `bitboss-ui-reset` immediately before it **when `resetCss` is on**.
359
+ With the reset off you may list `bitboss-ui-reset` anyway — an unused layer is
360
+ just empty — so the constant below works in every project, and you do not need
361
+ to know that Tailwind carries a reset of its own to use it.
362
+
363
+ **We do not ask you to add an `@layer` line to your stylesheet.** The plugin
364
+ injects the declaration ahead of its own rules, and a layer's position is fixed
365
+ by its first mention — so the order you configure is the order you get.
366
+
367
+ #### Tailwind v4
368
+
369
+ ```ts
370
+ // vite.config.ts — or the `bitboss` key in nuxt.config.ts
371
+ import { bitbossUi, TAILWIND_V4_LAYERS } from 'bitboss-ui/vite';
372
+
373
+ bitbossUi({
374
+ iconDir: './assets/icons',
375
+ cssLayers: TAILWIND_V4_LAYERS,
376
+ });
377
+ ```
378
+
379
+ `TAILWIND_V4_LAYERS` is
380
+ `['theme', 'base', 'bitboss-ui-reset', 'bitboss-ui', 'components', 'utilities']`:
381
+ Tailwind's own order with ours **after `base`**, so Preflight cannot outrank
382
+ the components, and **before `utilities`**, so `<BbButton class="px-6">`
383
+ works. Prefer the constant to the literal — a six-item array that has to be
384
+ exactly right is the kind of thing a typo turns into a silent loss of every
385
+ tie.
386
+
387
+ The same order decides your own CSS overrides on library classes (allowed for
388
+ fine-tuning, unsupported — [design-language](./design-language.md) § Hard
389
+ Rules): a rule written in a layer that comes **after** `bitboss-ui` in this
390
+ array (`components`, `utilities`), or left unlayered, beats the library's
391
+ declaration with no specificity games — a single class selector is enough.
392
+ Keep those overrides in one project stylesheet or one `@layer` block so an
393
+ upgrade has a single place to re-check.
394
+
395
+ #### Server-rendered apps (Nuxt, Inertia SSR)
396
+
397
+ The runtime plugin injects the stylesheet **in the browser only**, so a server
398
+ render needs the sheet from somewhere else.
399
+
400
+ **Nuxt: nothing to do.** With `cssLayers` set, the module adds the layered
401
+ sheet to `nuxt.options.css` itself, first, so the server's HTML is styled and
402
+ the layer order is declared before Tailwind's; the browser injection is
403
+ switched off so the sheet loads once. Set `injectStyles: false` to opt out and
404
+ import the CSS yourself, as below.
405
+
406
+ **Vite SSR, Inertia SSR:** import the sheet from your CSS entry, into its
407
+ layer, and switch the injection off:
408
+
409
+ ```css
410
+ /* app.css — the order line FIRST: a layer's place is fixed by its first
411
+ mention, and with the injection off nothing else declares ours. */
412
+ @layer theme, base, bitboss-ui-reset, bitboss-ui, components, utilities;
413
+ @import 'tailwindcss';
414
+ @import 'bitboss-ui/styles.css' layer(bitboss-ui);
415
+ ```
416
+
417
+ ```ts
418
+ bitbossUi({ cssLayers: TAILWIND_V4_LAYERS, injectStyles: false });
419
+ ```
420
+
421
+ The order line is `TAILWIND_V4_LAYERS` written out. Without it `bitboss-ui`
422
+ would be first mentioned after Tailwind's own layers and outrank every
423
+ utility. Before
424
+ 3.0.0-beta.36 the package exported the sheets under the `import` condition
425
+ only, so Tailwind's resolver refused this `@import` and a `node_modules/…`
426
+ path was the only way in.
427
+
428
+ #### Tailwind v3, or plain CSS
429
+
430
+ Leave `cssLayers` unset. v3 emits unlayered CSS, and two unlayered stylesheets
431
+ are decided by source order — which auto-injection already puts in your favour.
432
+
433
+ On Tailwind v3, also point `passthroughDeduper` at a module using
434
+ `tailwind-merge@2` (the bundled v3 speaks Tailwind v4 class names), or set it
435
+ to `false`.
436
+
437
+ #### Tailwind v3 — making utilities win anyway (opt-in)
438
+
439
+ v3 has no native layers of its own, but you can put its output into real ones
440
+ by wrapping the directives yourself. This is the shape PrimeVue documents, and
441
+ it is the only way to get v4's behaviour on v3:
442
+
443
+ ```css
444
+ /* your Tailwind entry, e.g. app.css */
445
+ @layer tailwind-base, bitboss-ui-reset, bitboss-ui, tailwind-utilities;
446
+
447
+ @layer tailwind-base {
448
+ @tailwind base;
449
+ }
450
+
451
+ @layer tailwind-utilities {
452
+ @tailwind components;
453
+ @tailwind utilities;
454
+ }
455
+ ```
456
+
457
+ ```ts
458
+ bitbossUi({
459
+ iconDir: './assets/icons',
460
+ cssLayers: [
461
+ 'tailwind-base',
462
+ 'bitboss-ui-reset',
463
+ 'bitboss-ui',
464
+ 'tailwind-utilities',
465
+ ],
466
+ });
467
+ ```
468
+
469
+ Both halves are required and they must agree: the CSS puts Tailwind's expanded
470
+ output INTO the layers, and `cssLayers` puts us between them. Verified against
471
+ a real v3 build — `.p-4` on a `Bb*` component wins, and Preflight no longer
472
+ outranks the components.
473
+
474
+ This is the one case where you write an `@layer` line yourself, because the
475
+ line has to wrap YOUR directives and we cannot reach them. Ours is emitted as
476
+ usual; the two declarations name the same order, and a layer's position is
477
+ fixed by its first mention, so they agree rather than fight.
478
+
479
+ #### "I just want to override things and not think about it"
480
+
481
+ ```ts
482
+ bitbossUi({
483
+ iconDir: './assets/icons',
484
+ cssLayers: ['bitboss-ui'], // ['bitboss-ui-reset', 'bitboss-ui'] with resetCss: true
485
+ });
486
+ ```
487
+
488
+ Declares our layer(s) and nothing else. All of your unlayered CSS then wins,
489
+ whatever its specificity.
490
+
491
+ > **Do not use this if your app loads a baseline stylesheet.** A reset is
492
+ > unlayered CSS made of element selectors, which is the exact combination this
493
+ > value inverts: `normalize.css`, your own `baseline.css`, or **Tailwind v3's
494
+ > Preflight** stop losing to our components on specificity and start outranking
495
+ > them outright. Measured on a real v3 build, a component rule of
496
+ > `margin: 5px` renders as `0px` — Preflight's `margin: 0` wins. The library
497
+ > does not look "overridable", it looks broken: controls lose their height,
498
+ > padding and borders, and nothing warns. If you want utilities to win on v3,
499
+ > use the layer hack above, which keeps the reset below us where it belongs.
500
+
501
+ Two further consequences: your global element rules (`button {}`, `input {}`)
502
+ now outrank component internals too — and this is the **wrong** value for a
503
+ layered app, because your own layers are declared later and land above ours,
504
+ Preflight included. A Tailwind v4 app uses the array above.
505
+
506
+ #### What "the utility loses" actually means
507
+
508
+ Not "utilities stop working on `Bb*` components". The cascade picks a winner
509
+ **per property**, so a layered utility loses only where we declare that exact
510
+ property on that element. Anything we leave alone is uncontested and simply
511
+ applies. Measured against the shipped sheet, v4 with `cssLayers` unset:
512
+
513
+ | on a `BbButton` | outcome | why |
514
+ | --------------- | ---------------- | ------------------------------------- |
515
+ | `w-20` | applies | we never declare `width` |
516
+ | `h-12` | applies | we declare `min-height`, not `height` |
517
+ | `m-4` | applies | we never declare `margin` |
518
+ | `p-4` | **half applies** | top/bottom land, left/right lose |
519
+ | `px-6` | no effect | we declare both padding longhands |
520
+ | `rounded-lg` | no effect | we declare `border-radius` |
521
+ | `text-lg` | no effect | we declare `font-size` |
522
+ | `gap-2` | no effect | we declare `gap` |
523
+
524
+ **The shorthand row is the one that hurts.** A clean loss is legible: you write
525
+ `px-6`, nothing moves, you go looking. `p-4` expands to four longhands, we
526
+ declare only the horizontal two, so their vertical padding applies while our
527
+ horizontal survives — a component nobody designed, with no signal that anything
528
+ was overridden.
529
+
530
+ So `cssLayers` does not turn utilities from broken into working. It turns them
531
+ from a per-property lottery into "always wins". **Predictability is the
532
+ feature, not capability** — and it is why the fix is worth taking even in an app
533
+ where the handful of utilities you tried happened to land.
534
+
535
+ #### Symptoms and what they mean
536
+
537
+ | what you see | cause | fix |
538
+ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------- |
539
+ | a Tailwind utility on a `Bb*` component does nothing, or half-applies | v4 utilities are layered, the library is not — see the per-property table above | `cssLayers: TAILWIND_V4_LAYERS` |
540
+ | every component lost its background / border | you listed only our two layers in a layered (v4) app | `cssLayers: TAILWIND_V4_LAYERS` |
541
+ | your global `button {}` reset suddenly restyles component internals | you listed only our two layers in an unlayered app | that is what it does — use the full order, or unset |
542
+ | components lost their height / padding / borders on **v3** | you listed only our layers while a reset or Preflight is unlayered | use the v3 layer hack, or leave `cssLayers` unset |
543
+ | nothing changed after setting `cssLayers` | the option lives in the **build plugin**, not in `app.use()` | set it in `vite.config.ts` / `nuxt.config.ts` |
544
+ | build fails naming a layer | your array omits `bitboss-ui` (or the reset layer with `resetCss: true`) | the error prints a working array — copy it |
545
+
546
+ A malformed value **fails the build**, never the browser: a wrong layer order is
547
+ invisible at runtime, because the CSS still parses and merely loses every tie.
548
+
549
+ #### The one thing layers do not fix
550
+
551
+ Layers decide ties between rules. They do not help when a component's own
552
+ inline `style` sets a property, because inline styles beat every layer. Where a
553
+ component needs to be positioned or sized by its parent, it exposes a CSS
554
+ variable, and that hook works in every configuration:
555
+
556
+ ```html
557
+ <!-- takes the row's slack; works on v3, v4, layered or not -->
558
+ <BbBreadcrumbs class="min-w-0" style="--flex-grow: 1" :items="crumbs" />
559
+ ```
560
+
561
+ Reach for the documented variable before reaching for a utility.
268
562
 
269
563
  ## 6) Icons
270
564
 
271
- - `iconDir` (required) is scanned recursively for `.svg` files; each file becomes `local:<basename>`.
272
- - Provider icons (`lucide:pencil`, `mdi:home`, …) require the matching `@iconify-json/<prefix>` package installed in the consumer app. Missing packages/icons produce actionable dev-overlay errors **only when the optional `@iconify/collections` peer is installed** (see [Install](#1-install)); otherwise you get `BbIcon`'s generic runtime error instead. Production builds report neither — this is a dev-time aid.
273
- - Production builds bundle **only statically referenced** provider icons — write icon names as literal strings (`icon="lucide:trash-2"`), never assemble them dynamically.
274
- - The plugin also writes `node_modules/.bitboss-ui/local-icons.json` and (in dev, unless `vscodeSettings: false`) wires `.vscode/settings.json` so the Iconify editor extension previews local icons.
565
+ - `iconDir` (default `'./assets/icons'`) is scanned recursively for `.svg` files; each file becomes `local:<basename>`. **`local:` ships everything.**
566
+ - Provider icons (`lucide:pencil`, `mdi:home`, …) require the matching `@iconify-json/<prefix>` package installed in the consumer app. **Providers ship only what is scanned or whitelisted**: the plugin reads the whole project as bytes — every file under the Vite root, PHP and Blade and JSON and SQL included — for `<prefix>:<name>` literals of the installed sets, and emits one lazy chunk per name that resolves. Skipped: gitignored paths (every `.gitignore` level), `node_modules`, `vendor`, `storage`, the build `outDir`, hidden paths, binaries, and `iconsScanner.exclude` globs; `iconsScanner.include` adds locations. The scan is cached by content hash under `node_modules/.cache/bitboss-ui/`, runs on 2–4 worker threads once a project passes ~1500 files (a cold scan is disk-bound, and the threads let a slow disk serve reads in parallel — roughly 0.2 s for 10k files on a laptop), prints one line (file count, elapsed, threads) after a cold scan, and stays silent when warm.
567
+ - **This holds in dev exactly as in prod.** Dev registers the same scanned-plus-whitelisted set, re-scans a file on every save, and hot-updates the registry — a new literal renders without a restart, and a name that is neither scanned nor whitelisted fails on first render in dev instead of after deploy.
568
+ - **Names the scanner cannot see** — composed at runtime, stored in a database, chosen in an admin UI — go in `iconWhitelist` (exact names or globs). An entry that resolves in no installed set fails the build with the actionable message.
569
+ - **A name that does not resolve renders the built-in placeholder** (a question mark in a circle, sized and coloured like the icon it replaces, with `data-bb-icon-missing="<name>"`) and logs one `console.error` per name per page load, in both environments; dev also raises the Vite error overlay. The message is the fix: a mistyped name inside an installed set gets a "did you mean …?" hint, a real icon nobody wrote as a literal is told to use `iconWhitelist`, and an uninstalled prefix gets the list of installed sets plus the `npm install -D @iconify-json/<prefix>` command (the optional `@iconify/collections` peer only sharpens that wording, see [Install](#1-install)). A missing `local:` icon names the `.svg` that is not in `iconDir`. `BbIcon` never throws for a missing name, so the surrounding tree stays mounted.
570
+ - In dev (unless `vscodeSettings: false`) the plugin also writes `.vscode/bitboss-ui.local-icons.json` and wires `.vscode/settings.json` so the Iconify editor extension previews local icons and Tailwind IntelliSense completes inside `pt:*` / `:pt`. The collection lives in the project tree, not under `node_modules`, so a host editor sees what a container (Sail, a named `node_modules` volume) wrote.
275
571
 
276
572
  Policy for choosing icons: [Icons Policy](./icons-policy.md).
277
573
 
@@ -279,9 +575,39 @@ Policy for choosing icons: [Icons Policy](./icons-policy.md).
279
575
 
280
576
  Options are the same for `bitboss-ui/vite` and the `bitboss` key in Nuxt.
281
577
 
282
- ### `iconDir: string` (required)
578
+ ### `iconDir?: string` (default: `'./assets/icons'`)
579
+
580
+ Path to local SVG icons, absolute or relative to project root. Scanned recursively; file basename (without extension) becomes the icon name, addressable as `local:<name>`. Every file in it ships. Only needed when you use `local:` icons: a missing folder at the default path is silent, while a custom `iconDir` that resolves to a missing or SVG-less folder logs a build warning.
581
+
582
+ ### `iconsScanner?: { include?: string[]; exclude?: string[]; maxFileSize?: number }`
583
+
584
+ Tunes the provider-icon source scan (see [Icons](#6-icons)). All three are optional and additive to the defaults; the root is always scanned.
585
+
586
+ - `include` — extra paths or globs scanned **in addition** to the Vite root: a vendor package that carries icon names, a directory outside the root (`'../shared/ui'`, `'vendor/acme/ui-kit/**/*.php'`). Relative entries resolve against the root. An entry is explicit, so the built-in skips (`vendor`, hidden segments, `.gitignore` files above it) do not apply to the entry itself — only to what lies beneath it. The Nuxt module adds the project `rootDir` here automatically, because Nuxt roots Vite at `app/`.
587
+ - `exclude` — globs removed from the scan on top of the defaults, in gitignore syntax, relative to the root (`['resources/legacy/**', '**/*.sql']`).
588
+ - `maxFileSize` — bytes. Exists only so a database dump is not read into memory; the default is 256 MiB, so a real source file is never skipped for its size.
589
+
590
+ ```ts
591
+ bitbossUi({
592
+ iconDir: './resources/icons',
593
+ iconsScanner: {
594
+ include: ['vendor/acme/ui-kit/src'],
595
+ exclude: ['database/dumps/**'],
596
+ },
597
+ });
598
+ ```
599
+
600
+ ### `iconWhitelist?: string[]`
283
601
 
284
- Path to local SVG icons, absolute or relative to project root. Scanned recursively; file basename (without extension) becomes the icon name, addressable as `local:<name>`.
602
+ Provider icons that **always** ship, scanned or not — exact names (`'tabler:crown'`) and globs (`'tabler:calendar-*'`, expanded against the installed set). This is the home of every name the scanner cannot see as a literal: composed at runtime, read from a database, picked by an admin. An entry that resolves in no installed set — a typo, an uninstalled prefix, a glob matching nothing — **fails the build** with the same actionable message the dev overlay shows for a missing icon. `local:` names never belong here (they all ship already).
603
+
604
+ ```ts
605
+ bitbossUi({
606
+ iconDir: './resources/icons',
607
+ // `icon` is stored per category in the database; the admin picks from these.
608
+ iconWhitelist: ['tabler:category', 'tabler:tag', 'tabler:calendar-*'],
609
+ });
610
+ ```
285
611
 
286
612
  ### `injectStyles?: boolean` (default: `true`)
287
613
 
@@ -289,32 +615,224 @@ Auto-inject the library stylesheet at runtime. If `false`, you must `import 'bit
289
615
 
290
616
  ### `resetCss?: boolean` (default: `false`)
291
617
 
292
- Inject the reset stylesheet (always ordered before the library stylesheet). Keep `false` and import `bitboss-ui/reset.css` if you prefer explicit control.
618
+ Inject the reset stylesheet (always ordered before the library stylesheet). Keep `false` and import `bitboss-ui/reset.css` if you prefer explicit control. Besides the box-model and form-control resets it sets a `system-ui` font stack on `body` (zero specificity: any `font-family` you set wins).
619
+
620
+ ### `cssLayers?: string[]` (default: unset)
621
+
622
+ Wraps the library's stylesheets in CSS cascade layers and declares where they
623
+ sit. Opt-in. Full guide with copy-paste blocks in §5 → _Cascade layers_.
624
+
625
+ The value is your app's **complete** layer order with `bitboss-ui` in it, and
626
+ `bitboss-ui-reset` before it when `resetCss` is on (listing it anyway is fine).
627
+ Unset means unlayered, today's behaviour, right for plain CSS and Tailwind v3.
628
+
629
+ ```ts
630
+ import { bitbossUi, TAILWIND_V4_LAYERS } from 'bitboss-ui/vite';
631
+
632
+ // Tailwind v4 — ['theme', 'base', 'bitboss-ui-reset', 'bitboss-ui', 'components', 'utilities']
633
+ cssLayers: TAILWIND_V4_LAYERS;
634
+ // no layers of your own, and you want to override anything
635
+ cssLayers: ['bitboss-ui']; // ['bitboss-ui-reset', 'bitboss-ui'] with resetCss: true
636
+ ```
637
+
638
+ You do not add an `@layer` line to your own CSS — the plugin emits the
639
+ declaration ahead of its rules. An invalid array, or a boolean, fails the build
640
+ with a message containing a working replacement.
641
+
642
+ ### `pt?: PtGlobalMap` (default: `{}`)
643
+
644
+ The global passthrough map — what every instance of a component starts from,
645
+ keyed by component name, then by `part` or `part:state`:
646
+
647
+ ```ts
648
+ bitbossUi({
649
+ pt: {
650
+ BbButton: {
651
+ icon: 'text-slate-500',
652
+ 'icon:loading': { class: 'opacity-50', attrs: { 'data-track': 'busy' } },
653
+ },
654
+ },
655
+ });
656
+ ```
657
+
658
+ Every component has an entry available — the parts and states of each are in
659
+ the passthrough guide's table (form controls share one family vocabulary, so
660
+ "every field box is square" is one line per control today). A per-instance
661
+ `pt` / `pt:<part>` merges after it: classes append (a conflicting utility is
662
+ replaced — see `passthroughDeduper`), styles merge, attributes win. It ships as JSON inside the config module, so it is
663
+ **data only** — a function anywhere in it fails the build, naming the path and
664
+ the per-instance form to bind the listener with instead. Component names and
665
+ part words are typed (wrap a map kept in its own file in `definePt`, exported
666
+ from `bitboss-ui/vite` and `bitboss-ui/nuxt`) and checked against the manifest
667
+ at build time. **Build-time only**: this option is the single source — there
668
+ is no per-app plugin option, no `setConfig`, and `useConfig().pt` is frozen.
669
+ Grammar, merge rules and the part/state vocabulary:
670
+ [passthrough](./passthrough.md).
671
+
672
+ ### `ptScopes?: Record<string, PtGlobalMap>` (default: none)
673
+
674
+ Named maps with the same shape and rules as `pt`, applied only inside a
675
+ `<BbPtScope name="…">` subtree — a backoffice and a member area sharing every
676
+ component but not a look. Per key: `pt`, then the active scopes from the
677
+ outermost `<BbPtScope>` in, then the instance's `class` / `pt` / `pt:*`. The
678
+ names become the `BbPtScopeName` union `<BbPtScope name>` accepts, generated
679
+ when the dev server or a build runs. Order, nesting, overlays and where the
680
+ toast / confirm hosts go: [passthrough](./passthrough.md) § Named scopes.
681
+
682
+ ```ts
683
+ import { definePt } from 'bitboss-ui/vite';
684
+
685
+ bitbossUi({
686
+ ptScopes: {
687
+ webapp: definePt({ BbButton: { root: 'rounded-full' } }),
688
+ backoffice: definePt({ BbButton: { root: 'rounded-md' } }),
689
+ },
690
+ });
691
+ ```
293
692
 
294
693
  ### `injectDirectives?: boolean` (default: `true`)
295
694
 
296
695
  Registers the global `v-bb-tooltip`, `v-bb-dropdown`, `v-bb-color`, `v-bb-date` and `v-bb-time` directives when the runtime plugin installs — all five, on both the Vue and the Nuxt runtime. Each registration is skipped if the app already declared a directive under that name, so disable the option only if you want none of them.
297
696
 
697
+ ### `passthroughDeduper?: false | string` (default: the bundled `tailwind-merge`)
698
+
699
+ Removes conflicting utilities from every resolved passthrough class list, so
700
+ a later source wins by precedence rather than by stylesheet order:
701
+ `pt:icon="text-slate-400"` with `pt:icon:loading="text-red-500"` leaves only
702
+ `text-red-500` on the icon while loading.
703
+
704
+ - **Unset** — the bundled `tailwind-merge` v3, which understands Tailwind v4.
705
+ It is a regular dependency of `bitboss-ui`; there is nothing to install.
706
+ - **`false`** — off. Classes append and the stylesheet decides conflicts.
707
+ - **A module path** (relative to the project root) or a package name whose
708
+ default export is `(className: string) => string`, pure and idempotent.
709
+ Use it for Tailwind v3 (`tailwind-merge@2`), a Tailwind `prefix`, or custom
710
+ theme tokens:
711
+
712
+ ```ts
713
+ // src/utils/pt-merge.ts
714
+ import { extendTailwindMerge } from 'tailwind-merge';
715
+
716
+ const merge = extendTailwindMerge({
717
+ extend: { classGroups: { 'font-size': [{ text: ['body', 'caption'] }] } },
718
+ });
719
+ export default (className: string) => merge(className);
720
+ ```
721
+
722
+ ```ts
723
+ bitbossUi({ passthroughDeduper: './src/utils/pt-merge.ts' });
724
+ ```
725
+
726
+ It only touches passthrough classes — the component's own BEM classes are
727
+ kept — and a class of yours shaped like a utility is treated as one. Details:
728
+ [passthrough](./passthrough.md) § Conflicting utilities.
729
+
298
730
  ### `adaptive?: boolean` (default: `true`)
299
731
 
300
732
  Default for the `adaptive` prop of surface components (BbDialog, BbPopover, BbDropdown, BbSelect): when true they open as a bottom sheet on mobile (below `mobileMaxWidth`) instead of their floating surface. An explicit per-component `adaptive` prop always wins.
301
733
 
734
+ ### `autoDisableWritingThreshold?: number` (default: `6`)
735
+
736
+ The select family (BbSelect and BbSelectPopover) hides the search field under this many options by default: an unset `disable-writing` means `'auto'`, and an **array** `items` with **fewer** options than the threshold (disabled options count, group headers don't) opens without a field — decided when the panel opens and held until it closes. A provider (function) `items`, or a consumer listening to `option:add`, always keeps the field. A non-negative integer — the build fails on anything else. Set `autoDisableWritingThreshold: 0` to keep every search field (the behaviour before `'auto'`). There is deliberately no global "hide every search field" option: hiding or forcing a field is the per-instance `disable-writing` (`true` / `false` / `'mobile'` / `'desktop'`), which always wins over `'auto'`.
737
+
302
738
  ### `vscodeSettings?: boolean` (default: `true`)
303
739
 
304
- When `true`, the **dev server** adds `./node_modules/.bitboss-ui/local-icons.json` to `"iconify.customCollectionJsonPaths"` in the project's `.vscode/settings.json` on boot, so the Iconify IntelliSense extension previews your local icons. The write is idempotent (it happens at most once) and splice-based — comments, formatting, and key order in a hand-written JSONC file all survive — and the plugin logs exactly what it changed the one time it does. Set to `false` if the plugin should never touch `.vscode/settings.json`; in that case add the entry manually to keep the previews.
740
+ When `true`, the **dev server** writes three editor hints into the project's `.vscode/settings.json` on boot:
741
+
742
+ 1. `./.vscode/bitboss-ui.local-icons.json` on `"iconify.customCollectionJsonPaths"`, so the Iconify IntelliSense extension previews your local icons. The plugin writes that collection too (regenerated on every SVG change) — into the project tree rather than `node_modules`, because a container-owned `node_modules` (Sail, a named volume, a separate host install for the IDE) is invisible to the host editor. Earlier betas wrote it to `./node_modules/.bitboss-ui/local-icons.json`; if your settings still list that path, drop the entry by hand (the plugin does not migrate it).
743
+ 2. Tailwind `"classAttributes"` / `"experimental.classRegex"` so completions, hovers and linting run inside passthrough — the static attribute form (`pt:icon="…"`), bound expressions (`:pt:icon="open ? '…' : '…'"`), the object forms (`:pt="{ icon: '…' }"`, `:pt:icon="{ class: '…' }"`), and the global map in `bitbossUi({ pt })`.
744
+ 3. `"editor.quickSuggestions": { "strings": "on" }`, so those completions trigger while typing (VS Code leaves string suggestions off by default).
745
+
746
+ The write is idempotent (it happens at most once per missing entry) and splice-based — comments, formatting, and key order in a hand-written JSONC file all survive — and the plugin logs exactly what it changed the one time it does. Replacing `classAttributes` would drop the defaults (`class`, `className`, `ngClass`, `class:list`), so the plugin keeps them when it inserts the key. Set to `false` if the plugin should never touch `.vscode/` (the settings file and the local-icons collection alike); in that case add the entries manually (and install [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)):
747
+
748
+ ```json
749
+ {
750
+ "iconify.customCollectionJsonPaths": [
751
+ "./.vscode/bitboss-ui.local-icons.json"
752
+ ],
753
+ "tailwindCSS.classAttributes": [
754
+ "class",
755
+ "className",
756
+ "ngClass",
757
+ "class:list",
758
+ "pt(?::[\\w-]+)*"
759
+ ],
760
+ "tailwindCSS.experimental.classRegex": [
761
+ [
762
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*\"([\\s\\S]*?)\"",
763
+ "\\?\\s*'([^\\s':][^']*)'"
764
+ ],
765
+ [
766
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*\"([\\s\\S]*?)\"",
767
+ "'([^\\s':][^']*)'(?!\\s*:)"
768
+ ],
769
+ [
770
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*\"([\\s\\S]*?)\"",
771
+ "\\?\\s*\"([^\\s\":][^\"]*)\""
772
+ ],
773
+ [
774
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*\"([\\s\\S]*?)\"",
775
+ "\"([^\\s\":][^\"]*)\"(?!\\s*:)"
776
+ ],
777
+ [
778
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*\"([\\s\\S]*?)\"",
779
+ "\\?\\s*`([^\\s`:][^`]*)`"
780
+ ],
781
+ [
782
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*\"([\\s\\S]*?)\"",
783
+ "`([^\\s`:][^`]*)`(?!\\s*:)"
784
+ ],
785
+ [
786
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*'([\\s\\S]*?)'",
787
+ "\\?\\s*'([^\\s':][^']*)'"
788
+ ],
789
+ [
790
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*'([\\s\\S]*?)'",
791
+ "'([^\\s':][^']*)'(?!\\s*:)"
792
+ ],
793
+ [
794
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*'([\\s\\S]*?)'",
795
+ "\\?\\s*\"([^\\s\":][^\"]*)\""
796
+ ],
797
+ [
798
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*'([\\s\\S]*?)'",
799
+ "\"([^\\s\":][^\"]*)\"(?!\\s*:)"
800
+ ],
801
+ [
802
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*'([\\s\\S]*?)'",
803
+ "\\?\\s*`([^\\s`:][^`]*)`"
804
+ ],
805
+ [
806
+ "(?:^|[\\s:(])(?:v-bind:)?pt(?::[\\w-]+)*\\s*=\\s*'([\\s\\S]*?)'",
807
+ "`([^\\s`:][^`]*)`(?!\\s*:)"
808
+ ],
809
+ ["\\bpt\\s*:\\s*\\{([\\s\\S]*?)\\}", "\\?\\s*'([^\\s':][^']*)'"],
810
+ ["\\bpt\\s*:\\s*\\{([\\s\\S]*?)\\}", "'([^\\s':][^']*)'(?!\\s*:)"],
811
+ ["\\bpt\\s*:\\s*\\{([\\s\\S]*?)\\}", "\\?\\s*\"([^\\s\":][^\"]*)\""],
812
+ ["\\bpt\\s*:\\s*\\{([\\s\\S]*?)\\}", "\"([^\\s\":][^\"]*)\"(?!\\s*:)"],
813
+ ["\\bpt\\s*:\\s*\\{([\\s\\S]*?)\\}", "\\?\\s*`([^\\s`:][^`]*)`"],
814
+ ["\\bpt\\s*:\\s*\\{([\\s\\S]*?)\\}", "`([^\\s`:][^`]*)`(?!\\s*:)"]
815
+ ],
816
+ "editor.quickSuggestions": {
817
+ "strings": "on"
818
+ }
819
+ }
820
+ ```
821
+
822
+ Reload the window once after the first write. See [passthrough](./passthrough.md) § Tailwind IntelliSense.
305
823
 
306
824
  ### `mcp?: boolean` (default: `false`)
307
825
 
308
- When `true`, the **dev server** registers the bitboss-ui MCP server in each project-scoped agent-harness config on boot — `.mcp.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.vscode/mcp.json` (VS Code / Copilot) — so agents can query the knowledge base with no manual setup. The write is merge-safe (leaves other servers alone) and idempotent (only logs when it actually changes a file). Windsurf is intentionally **not** written here: its config is global (`~/.codeium`), and silently editing a home-dir file that affects every project on the machine from a dev-server boot would be surprising — run `npx bitboss-ui ai-init --mcp` to register Windsurf too. This flag is the zero-command equivalent of that command's project-scoped writes. The MCP server's own runtime — `@modelcontextprotocol/sdk` and `zod` — ships as **optional peer dependencies** (~12 MB, more than every runtime dependency of the library combined, and loaded by nothing else), so install them with `npm i -D @modelcontextprotocol/sdk zod` before the harness first launches the server; both this flag and `ai-init --mcp` warn when they are missing.
826
+ When `true`, the **dev server** registers the bitboss-ui MCP server in each project-scoped agent-harness config on boot — `.mcp.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.vscode/mcp.json` (VS Code / Copilot) — so agents can query the knowledge base with no manual setup. The write is merge-safe (leaves other servers alone) and idempotent (only logs when it actually changes a file). This flag is the zero-command equivalent of `npx bitboss-ui ai-init`'s registration; unlike that command it never installs anything. The MCP server's own runtime — `@modelcontextprotocol/sdk` and `zod` — ships as **optional peer dependencies** (~12 MB, more than every runtime dependency of the library combined, and loaded by nothing else), so they must be installed before the harness first launches the server — `ai-init` installs them with your package manager, and this flag warns when they are missing.
309
827
 
310
828
  **MCP is a convenience, not a requirement, and skipping it costs no
311
829
  knowledge.** The server is a reader over files the install already put on disk
312
830
  — every tool `readFileSync`s out of `node_modules/bitboss-ui/dist/ai/` (plus
313
831
  `dist/styles.css` for the token lookup). An agent that opens that directory
314
832
  itself has the identical knowledge base, `npx bitboss-ui check` runs without the
315
- peers, and `ai-init` (no `--mcp`) still writes the harness pointers. If you are
833
+ peers, and `ai-init --no-mcp` still writes the harness pointers. If you are
316
834
  migrating under a "no new dependencies" constraint, leave `mcp` at `false`,
317
- skip `--mcp`, and point your agent at `dist/ai/guides/ai-router.md`.
835
+ run `ai-init --no-mcp`, and point your agent at `dist/ai/guides/ai-router.md`.
318
836
 
319
837
  ### `inertiaLinkName?: string` (default: `'Link'`)
320
838
 
@@ -347,7 +865,14 @@ used from the first paint.
347
865
  **Client-only SPA?** Ignore this — the real width is known from the first paint,
348
866
  so `adaptive` surfaces are correct immediately.
349
867
 
350
- **Server-rendering (Nuxt / Inertia SSR)?** By default the server renders
868
+ **Server-rendering (Nuxt / Inertia SSR)?** One thing to know about the server
869
+ bundle first: `bitboss-ui` must be **bundled into it**, never left as an
870
+ external Node import, because the library imports `virtual:bitboss-ui/*`
871
+ modules that only the build plugin can resolve — the plugin's `config()` hook
872
+ therefore returns `ssr: { noExternal: ['bitboss-ui'] }` (merged with any
873
+ `noExternal` you set; `true` is left alone), and a custom SSR setup that
874
+ bypasses Vite's config merging has to keep that invariant itself. Then, by
875
+ default the server renders
351
876
  desktop-shaped; a mobile visitor's first paint is desktop-shaped and adjusts
352
877
  once the client measures the real width (for closed overlays this is invisible —
353
878
  they're not on screen yet; a Vue hydration warning may appear in dev). Set this
@@ -363,11 +888,12 @@ bitbossUi({
363
888
 
364
889
  This is a **single global default baked in at build time** (it comes from the
365
890
  Vite plugin config), so it is the same for every request — it is _not_ a
366
- per-request value. There is no per-request/per-visitor override today: the
367
- viewport signal is a process-wide singleton, so a mobile layout that must be
368
- correct on the server's first paint (e.g. a modal already open on load) needs a
369
- client adjustment after hydration, or a fixed `ssrViewportWidth` matching your
370
- audience.
891
+ per-request value. There is no per-request/per-visitor override: the viewport
892
+ signal is a process-wide singleton, so a mobile layout that must be correct on
893
+ the server's first paint (e.g. a modal already open on load) needs a client
894
+ adjustment after hydration, or a fixed `ssrViewportWidth` matching your
895
+ audience. (Unlike `locale`, which **is** per-request — see below. A width
896
+ cannot be derived from a request without UA sniffing; a locale can.)
371
897
 
372
898
  ### `defaultInputLabelMode?: 'outside' | 'floating' | 'inside'` (default: `'outside'`)
373
899
 
@@ -375,9 +901,24 @@ Default label rendering mode for input-like components; set globally instead of
375
901
 
376
902
  ### `requiredAsterisk?: boolean` (default: `false`)
377
903
 
378
- Marks required fields with a red asterisk beside the label/legend. Presentational only — it keys off the standard `required` prop and changes neither validation nor native `required` semantics. The marker is applied by the [`bitboss-ui/validated`](./validated-forms.md) controls — a field that is `required`, or whose `rules` contain a `required` rule; other rules never raise it, because they only apply once a value exists. Core controls ignore the flag, so on a hand-wired form render the exported `BbAsterisk` in your own label content.
904
+ Marks required fields with a red asterisk beside the label/legend. Presentational only — it keys off the standard `required` prop and changes neither validation nor native `required` semantics. The marker is applied by the form controls (see [Validated Forms](./validated-forms.md)) — a field that is `required`, or, inside a `BbForm`, whose `rules` contain a `required` rule; other rules never raise it, because they only apply once a value exists. Core controls ignore the flag, so on a hand-wired form render the exported `BbAsterisk` in your own label content.
905
+
906
+ ### `formControls?: { textInputNullValue?: null | ''; textareaNullValue?: null | ''; validationMode?: ValidationMode }` (default: `null`, `null`, `'balanced'`)
907
+
908
+ What an emptied `BbTextInput` / `BbTextarea` emits (typed empty, the clear
909
+ button, an empty mask): `null`, the default, or `''`. Pick what your backend
910
+ and your validation expect. With `''`, a schema such as
911
+ `z.string().min(1, 'Required')` shows your message on an emptied field
912
+ instead of the library's type error for `null` — see
913
+ [validation-libraries](./validation-libraries.md) § What needs a tweak. Set it
914
+ once here, or per app with `app.use(bitbossUiPlugin, { formControls: { … } })`
915
+ (merged key by key). It changes only what an EMPTIED field emits: a field
916
+ nobody touched keeps the value your page gave it, so in `''` mode start text
917
+ values as `''`.
918
+
919
+ ### `locale?: LocaleKey` (default: `'en'`)
379
920
 
380
- ### `locale?: LocaleKey` (default: `'it'`)
921
+ English since 3.0.0-beta.41 (it was `'it'`): an Italian app sets `locale: 'it'`.
381
922
 
382
923
  Global locale for the library's built-in strings (empty states, close/clear
383
924
  labels, screen-reader announcements, confirm buttons, …). The library ships
@@ -385,9 +926,32 @@ labels, screen-reader announcements, confirm buttons, …). The library ships
385
926
  pl, tr, ru, uk, cs, ro, hu, el, sv, da, nb, fi, ja, ko, zh-cn — but shipping ≠
386
927
  bundling: only the **enabled** locales enter your build (next option). Runtime
387
928
  switching: `useBbConfig().setConfig({ locale })` — to a locale you enabled.
388
- `setConfig` is client-only: on an SSR server the config is a process-wide
389
- singleton (same rule as `ssrViewportWidth` — no per-request override), so a
390
- per-request call would leak one visitor's locale into other renders.
929
+
930
+ **Per-request locale under SSR** is supported as of 3.0.0-beta.15: the config
931
+ is held per Vue app, and SSR builds one app per request, so pass it where you
932
+ create the app — `app.use(bitbossUiPlugin, { locale: localeFor(request) })`.
933
+ That is correct on the server's first paint, which is what crawlers index and
934
+ what a JS-disabled reader keeps.
935
+
936
+ **In Nuxt, do not call `app.use`** — the module registers the runtime plugin,
937
+ which provides the per-app config itself (fixed in 3.0.0-beta.19, Q20.4;
938
+ before that Nuxt had no per-app config at all and every `setConfig` wrote the
939
+ process-global). Set a per-request locale from your own Nuxt plugin, which
940
+ runs per request on the server:
941
+ `nuxtApp.vueApp.runWithContext(() => useBbConfig().setConfig({ locale }))` —
942
+ the `runWithContext` is what hands the write this app's injection context,
943
+ since a plugin has an app but no component instance.
944
+
945
+ `setConfig` still works for runtime switching; during a server render call it
946
+ from a component's `setup` (or inside `runWithContext`), where it can resolve
947
+ the current app. With neither there is no app to address, the write lands on
948
+ the build-time defaults, and it leaks between concurrent visitors — it warns in
949
+ dev when it sees that, keyed off where the write actually landed rather than
950
+ the call site. See [useBbConfig](../composables/useBbConfig.md).
951
+
952
+ Note this is a **different rule** from `ssrViewportWidth` above, which really
953
+ is a build-time global: a width cannot be known per request without sniffing,
954
+ a locale can.
391
955
 
392
956
  ### `enabledLocales?: BuiltinLocaleKey[]` (default: your `locale` + `'en'`)
393
957
 
@@ -412,9 +976,11 @@ bundle cost. Wanting every built-in means writing the list, so the cost is
412
976
  visible in your config where reviewers can see it.
413
977
 
414
978
  **Selecting a non-enabled locale is a compile error**, not a silent runtime
415
- fallback: the generated `locale-registry.d.ts` registers only the enabled
416
- built-ins, so `setConfig({ locale: 'ja' })` fails to type-check until `'ja'` is
417
- enabled. Run dev once after changing the list.
979
+ fallback: your project's `bitboss-ui.d.ts` (see
980
+ [Variant registries](#variant-registries)) lists only the enabled locales, so
981
+ `setConfig({ locale: 'ja' })` fails to type-check until `'ja'` is enabled.
982
+ Start the dev server or run a build once after changing the list, and commit
983
+ the file. Before that file exists, every built-in locale type-checks.
418
984
 
419
985
  ### Custom locales are not a supported surface
420
986
 
@@ -454,15 +1020,79 @@ Provide only the keys you want to override, e.g. `dialogDefaultSizes: { md: 500,
454
1020
 
455
1021
  ### Variant registries
456
1022
 
457
- Each option **appends** custom names to the default set (trimmed, deduplicated) and regenerates a typed union (`*-variants.d.ts`) on build start. Unstyled custom variants only add a class hook — supply their CSS yourself.
1023
+ Each option **appends** custom names to the default set (trimmed, deduplicated). Unstyled custom variants only add a class hook — supply their CSS yourself.
1024
+
1025
+ **The types come from one file in your project: `bitboss-ui.d.ts`. Commit
1026
+ it.** The plugin writes it when the dev server starts, on `vite build`, and
1027
+ under Vitest, from your `bitbossUi()` options: your custom variant names, the
1028
+ enabled locales, and your `ptScopes` names. It lands next to your first script
1029
+ entry (`resources/js/bitboss-ui.d.ts` in a Laravel app), else in `src/`, else
1030
+ at the Vite root (`app/` under Nuxt 4); the `dts` option moves it, or
1031
+ `dts: false` turns it off. Commit it with the config change, and a teammate's
1032
+ or CI's `vue-tsc` is correct without running Vite. A host editor and a Docker
1033
+ or Sail container agree, because the file lives in the project tree they
1034
+ share; nothing about types is read from `node_modules`.
1035
+
1036
+ - **Built-in variants need no file.** They are declared in the package.
1037
+ - **Custom variants, narrowed locales and `ptScopes` need the committed file.**
1038
+ Without it, a custom name fails exactly like a typo
1039
+ (`Type '"brand"' is not assignable to type 'ButtonVariantType'`).
1040
+ **`npx bitboss-ui check` writes it too**, without starting Vite: after you
1041
+ register a name in `vite.config.*` / `nuxt.config.*`, run `check` and the
1042
+ name type-checks (it reads the variant options when they are an inline
1043
+ object of string literals, and leaves the locales and `ptScopes` as the
1044
+ plugin last wrote them). The next dev start completes the file. Commit it.
1045
+ - **With no `ptScopes` at all**, every `<BbPtScope name>` is rejected, and the
1046
+ error text says so: `not assignable to type 'bitboss-ui: no ptScopes
1047
+ configured — …'`.
1048
+ - The plugin rewrites the file only when its names change, so a formatter that
1049
+ restyles it does not cause churn. It prints one line when it writes, and
1050
+ warns once if the file sits outside your TypeScript project (then point `dts`
1051
+ at your app sources, for example `resources/js/`).
1052
+ - Do not edit it by hand, and do not add a second `declare module` for these
1053
+ interfaces elsewhere.
1054
+
1055
+ **A variant computed in script widens to `string`.** A ternary or a `.map()`
1056
+ that returns variant names infers `string`, and `string` is not a variant
1057
+ type: the list is locked on purpose, so a typo is a compile error. There is
1058
+ no `string` fallback. Every variant component exports its type, which
1059
+ includes your registered names (`ButtonVariantType`, `BadgeVariantType`,
1060
+ `AlertVariantType`, `InputVariantType`, `TabsVariantType`, …): annotate the
1061
+ function or the field with it, or cast one value (`as BadgeVariantType`).
1062
+ The same question for a `pt` object built in script has its own answer:
1063
+ [passthrough](./passthrough.md) § Typing `pt` in `<script>`.
1064
+
1065
+ ```ts
1066
+ import type { BadgeVariantType } from 'bitboss-ui';
1067
+
1068
+ type Invoice = { id: number; status: 'paid' | 'overdue' | 'draft' };
1069
+
1070
+ export const statusVariant = (status: Invoice['status']): BadgeVariantType =>
1071
+ status === 'overdue'
1072
+ ? 'destructive'
1073
+ : status === 'paid'
1074
+ ? 'primary'
1075
+ : 'outline';
1076
+
1077
+ export const badges = (invoices: Invoice[]) =>
1078
+ invoices.map((invoice) => ({
1079
+ id: invoice.id,
1080
+ variant: statusVariant(invoice.status),
1081
+ }));
1082
+ ```
1083
+
1084
+ A one-off look that is not worth registering: `variant="none"` (BbButton,
1085
+ BbBadge, the text-like inputs, BbTabs) drops the variant class and keeps the
1086
+ base tokens, so set the component's `--bg` / `--fg` yourself. A cast to an
1087
+ unregistered name also works at runtime (its class is still emitted for your
1088
+ CSS), but a registered name is the supported way.
458
1089
 
459
- **The generated `*-variants.d.ts` files are per-project output, not a portable
460
- variant list.** They mirror the plugin config of the project that last ran the
461
- plugin in that folder, and are rewritten by every build/dev/test process. Your
462
- project's registry is what **your** plugin config declares — never trust names
463
- read out of another checkout's copy (e.g. the library repo's own tracked seeds
464
- list variants that exist only in its dev showcase). Each generated file now
465
- says this in its header.
1090
+ **Upgrading from 3.0.0-beta.33 or earlier:** the old `*-variants.d.ts`,
1091
+ `locale-registry.d.ts` and `pt-scope-registry.d.ts` files under
1092
+ `node_modules/bitboss-ui/` are gone. After upgrading, start the dev server or
1093
+ run a build once (or `npx bitboss-ui check`, for the variant names) and commit
1094
+ the new `bitboss-ui.d.ts`. CI that type-checks
1095
+ before building needs that commit.
466
1096
 
467
1097
  | Option | Defaults | Class hook for custom entries |
468
1098
  | ---------------------- | ------------------------------------------------------- | ----------------------------------- |
@@ -473,7 +1103,75 @@ says this in its header.
473
1103
  | `confirmVariants` | `default, destructive` | `bb-confirm--<name>` |
474
1104
  | `dropdownItemVariants` | `default, destructive` | `bb-dropdown__item--variant-<name>` |
475
1105
  | `tooltipVariants` | `default, destructive` | `bb-tooltip--<name>` |
476
- | `toastVariants` | `default, success, info, warning, destructive` | `bb-toast-message--<name>` |
1106
+ | `toastVariants` | `default, success, info, warning, destructive` | `bb-toast__panel--<name>` |
1107
+ | `inputVariants` | `outline, secondary, ghost` | `bb-field-input--<name>` |
1108
+ | `tabsVariants` | `pill, line, none` | `bb-tabs-list--<name>` |
1109
+
1110
+ `tabsVariants` is the `variant` prop of `BbTabs` / `BbTabsList` (the class
1111
+ lands on the strip). Like `inputVariants`, a custom entry is a **token block,
1112
+ not a rule set**: the shipped looks are presets of the strip's own custom
1113
+ properties (`--list-bg`, `--list-border`, `--trigger-gap`, `--active-fg`,
1114
+ `--active-fw`, `--indicator-bg`, `--indicator-h`, …), and a registered name
1115
+ sets the same ones —
1116
+
1117
+ ```css
1118
+ /* a registered `tabsVariants: ['brand-line']` — an underline in the brand colour */
1119
+ .bb-tabs-list--brand-line {
1120
+ --list-bg: transparent;
1121
+ --list-border: var(--bb-border);
1122
+ --p: 0px;
1123
+ --indicator-bg: var(--bb-primary);
1124
+ --indicator-border: transparent;
1125
+ --indicator-shadow: none;
1126
+ --elev: none;
1127
+ --indicator-h: 2px; /* a bar on the bottom edge; `initial` is the full pill */
1128
+ --active-fg: var(--bb-primary);
1129
+ --active-fw: 700;
1130
+ }
1131
+ ```
1132
+
1133
+ The `BbTabs` guide (_Variants_) has the whole token table and two more
1134
+ recipes (`soft`, `outline`).
1135
+
1136
+ `inputVariants` is the `variant` prop of the eight text-like controls
1137
+ (`BbTextInput`, `BbTextarea`, `BbNumberInput`, `BbSelect`, `BbTag`,
1138
+ `BbDatePickerInput`, `BbTimePickerInput`, `BbColorInput`). Its class hook is
1139
+ the shared field box, and a custom entry is a **token block, not a rule set**:
1140
+ the box's geometry (height, padding, border width) never changes with the
1141
+ variant, so a variant only assigns the look variables the box reads —
1142
+
1143
+ ```css
1144
+ /* a registered `inputVariants: ['brand']` */
1145
+ .bb-field-input--brand {
1146
+ --bg: color-mix(in oklab, var(--bb-primary) 8%, var(--bb-panel));
1147
+ --bg-hover: color-mix(in oklab, var(--bb-primary) 12%, var(--bb-panel));
1148
+ --bg-disabled: var(--bb-muted);
1149
+ /* resting colours only — errors / warnings paint over them (below) */
1150
+ --border-color: color-mix(in oklab, var(--bb-primary) 40%, var(--bb-border));
1151
+ --border-focus: var(--bb-primary);
1152
+ /* the focus ring: leave this out and the variant has none, like `none` */
1153
+ --ring-size: var(--bb-ring-size);
1154
+ /* what the box paints under the ring (ghost/secondary use their hover wash) */
1155
+ --bg-focus: var(--bg-hover);
1156
+ /* the resting lift and the plate frost: a variant that draws a shell takes
1157
+ both, the way `outline` and `secondary` do. Leave them out and the
1158
+ variant is flat and unfrosted, like `ghost` and `none`. Both are no-ops
1159
+ until a theme sets `--bb-elev` / `--bb-surface-filter`, so omitting them
1160
+ looks correct until someone themes the material. */
1161
+ --elev: var(--bb-elev);
1162
+ --frost: var(--bb-surface-filter);
1163
+ }
1164
+ /* take the errors / warnings frame like `outline`; leave this rule out to
1165
+ stay unframed like `ghost` */
1166
+ .bb-field-input--brand > .bb-field-input__box {
1167
+ --state-frame: var(--state-border);
1168
+ }
1169
+ ```
1170
+
1171
+ The ring's **colour** is state-owned (primary, danger under errors, warn under
1172
+ warnings) and never a variant's business; whether a ring is **drawn** is the
1173
+ variant's call through `--ring-size` — the three built-ins draw it, `none` does
1174
+ not, and a custom variant chooses.
477
1175
 
478
1176
  Variant props are locked to the registered set (`keyof <X>VariantRegistry`):
479
1177
  an unregistered name is a compile error, not a silently unstyled render.
@@ -492,21 +1190,22 @@ than inventing hues.
492
1190
 
493
1191
  ## 8) AI Knowledge Base
494
1192
 
495
- The package ships its agent docs in `node_modules/bitboss-ui/dist/ai/`. **Start at** `guides/ai-router.md`, then the catalogue `index.md`. Run `npx bitboss-ui ai-init` in the consumer project to inject harness-agnostic pointers (AGENTS.md, Cursor rules, Copilot instructions, Claude skill, Windsurf rules) so coding agents discover them without a vendor lock-in. After generating Bb\* markup, run `npx bitboss-ui check` (supports `--json`) so unknown props fail before review.
1193
+ The package ships its agent docs in `node_modules/bitboss-ui/dist/ai/`. **Start at** `guides/ai-router.md`. Open one contract or one recipe next. The catalogue `index.md` is a last resort. Paint tokens are `design-tokens.json` (DESIGN.md-shaped twin: `design-tokens.manifest.yaml`), not a repo-root `DESIGN.md`. Run `npx bitboss-ui ai-init` in the consumer project to inject harness-agnostic pointers (AGENTS.md, Cursor rules, Copilot instructions, Claude skill, Windsurf rules) so coding agents discover them without a vendor lock-in. After generating Bb\* markup, run `npx bitboss-ui check` (supports `--json`) so unknown props fail before review.
496
1194
 
497
1195
  **Three tiers ship under `dist/ai/`**, and the third one is easy to miss:
498
1196
  `guides/` + `recipes/` are the authored prose; `<Name>.md` at the root is the
499
1197
  generated typed contract for each component (props, slots, events, examples);
500
1198
  `source/<Name>.md` is that same component's **complete implementation** —
501
1199
  `.vue` template, `types.ts` and `index.css` in one file, one per component
502
- including the internal ones the package does not export. Read the source tier
503
- when the contract cannot answer the question — the usual case is rebuilding
504
- chrome around a control the library does not ship, since the class names such a
505
- template emits are already styled by the public `bitboss-ui/styles.css`.
1200
+ including the internal ones the package does not export. Open `source/<Name>.md` only when you are rebuilding chrome the library does not ship. It is not the second hop after the picker.
1201
+
1202
+ `ai-init` also registers a live MCP server (on by default; `--no-mcp` skips it) (`node node_modules/bitboss-ui/bin/bitboss-ui.mjs mcp` — the installed binary, not `npx`, so it can never fetch from the registry, its optional peers resolve in your project rather than in an npx cache, and it cannot drift behind an upgrade) the harness launches on demand — it merges the entry (never overwriting other servers) into `.mcp.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.vscode/mcp.json` (VS Code / Copilot) — the same three the plugin's `mcp: true` dev-server flag (§7) writes. Windsurf reads only a global home-dir config, so it is not registered; add the entry to `~/.codeium/windsurf/mcp_config.json` yourself if you use it. `ai-init` also installs the server's optional peers — `@modelcontextprotocol/sdk` and `zod`, ~12 MB used only by the MCP server and not dependencies of the library — as dev dependencies with your package manager (from the lockfile), and prints the command if the install fails. **The server is optional and `--no-mcp` loses you nothing but the transport** — the server only reads the `dist/ai/` files listed above, so run `ai-init --no-mcp` (no config, no install) and let the agent read that directory if you cannot add the peers (see `mcp?: boolean` in §7).
506
1203
 
507
- Add `--mcp` to also register a live MCP server (`npx bitboss-ui@<installed version> mcp`, pinned so npx can never fetch a different version from the registry) the harness launches on demand — it merges the entry (never overwriting other servers) into `.mcp.json` (Claude Code), `.cursor/mcp.json` (Cursor), `.vscode/mcp.json` (VS Code / Copilot), and `~/.codeium/windsurf/mcp_config.json` (Windsurf). **Windsurf's config is global** — it has no per-project scope, so registering it affects every project on the machine; that is why only the explicit `ai-init --mcp` command writes it, while the plugin's `mcp: true` dev-server flag (§7) auto-registers the project-scoped harnesses only. Install the server's optional peers first — `npm i -D @modelcontextprotocol/sdk zod` — they are not dependencies of the library (~12 MB used only by the MCP server); the command warns if they are absent. **`--mcp` is optional and skipping it loses you nothing but the transport** — the server only reads the `dist/ai/` files listed above, so run plain `ai-init` and let the agent read that directory if you cannot add the peers (see `mcp?: boolean` in §7).
1204
+ For a human-in-the-loop (and agent) safety net, add the `bitboss-ui/eslint-plugin` flat-config plugin (`...bitbossUi.configs.recommended`) so unknown/removed `Bb*` props surface as ESLint errors in the editor and CI — the same manifest checks as `bitboss-ui check`, reusing your `eslint-plugin-vue` parser. Real HTML attributes fall through untouched; escape hatches are the standard `<!-- eslint-disable-next-line bitboss-ui/no-unknown-attributes -->` and the rule's `allowAttributes` / `allowComponents` options. `bitboss-ui check` honours the same disable comments in `.vue` files (`-line`, `-next-line`, and `disable`/`enable` ranges, bare or naming the `bitboss-ui/*` rule), so a finding you silenced on purpose does not fail the CLI either; it prints a count of what it skipped. `npx bitboss-ui check --fix` applies the same auto-migrations without touching your ESLint config: it runs only the `bitboss-ui/*` rules' fixes on the matched `.vue` files (it needs `eslint` and `vue-eslint-parser` installed, which any `eslint-plugin-vue` setup has), then reports whatever is left. **`eslint --fix` also auto-migrates deprecated v2 props** (renames, boolean-polarity inversions like `allowWriting`→`disableWriting`, value remaps like BbToast `placement`→`position`, and deletion of inert removed props); structural migrations that need a slot/directive/CSS are reported but left by hand. One deliberate boundary: the rule's "did you mean `<prop>`?" hints for a mistyped/unknown attribute are advisory message text, not fixes — `eslint --fix` (including an unattended run in a pre-commit hook) never applies them; only the registered v2→v3 migrations above are auto-fixed. A guess applied blind across a codebase would be a silent behavior change, so acting on a hint is always a per-site decision. **This library is TS-first (recipes ship `<script setup lang="ts">`, some with `generic="T"`), so wire `@typescript-eslint/parser` for both `.ts` and `.vue` files** — without it `vue-eslint-parser` throws a `Parsing error` on those files, which means no rule (including `no-unknown-attributes`) runs on them at all. See the README "ESLint plugin" section for the full config snippet (both parser blocks + the `npm i -D @typescript-eslint/parser` line) and the fix table. `recommended` also enables `bitboss-ui/no-active-class-on-root-link`: `active-class` on a link-capable `Bb*` component (`BbButton`/`BbBaseButton`/`BbBadgeButton`) matches by path PREFIX, so a link whose target is the literal root (`href="/"` / `to="/"`) reads as "active" on every URL — the rule flags that combination and points you at `exact-active-class` instead.
508
1205
 
509
- For a human-in-the-loop (and agent) safety net, add the `bitboss-ui/eslint-plugin` flat-config plugin (`...bitbossUi.configs.recommended`) so unknown/removed `Bb*` props surface as ESLint errors in the editor and CI — the same manifest checks as `bitboss-ui check`, reusing your `eslint-plugin-vue` parser. Real HTML attributes fall through untouched; escape hatches are the standard `<!-- eslint-disable-next-line bitboss-ui/no-unknown-attributes -->` and the rule's `allowAttributes` / `allowComponents` options. **`eslint --fix` also auto-migrates deprecated v2 props** (renames, boolean-polarity inversions like `allowWriting`→`disableWriting`, value remaps like BbToast `placement`→`position`, and deletion of inert removed props); structural migrations that need a slot/directive/CSS are reported but left by hand. **This library is TS-first (recipes ship `<script setup lang="ts">`, some with `generic="T"`), so wire `@typescript-eslint/parser` for both `.ts` and `.vue` files** — without it `vue-eslint-parser` throws a `Parsing error` on those files, which means no rule (including `no-unknown-attributes`) runs on them at all. See the README "ESLint plugin" section for the full config snippet (both parser blocks + the `npm i -D @typescript-eslint/parser` line) and the fix table. `recommended` also enables `bitboss-ui/no-active-class-on-root-link`: `active-class` on a link-capable `Bb*` component (`BbButton`/`BbBaseButton`/`BbBadgeButton`) matches by path PREFIX, so a link whose target is the literal root (`href="/"` / `to="/"`) reads as "active" on every URL — the rule flags that combination and points you at `exact-active-class` instead.
1206
+ Two rules in `recommended` are `warn` rather than `error`, because each describes markup that may be deliberate. `bitboss-ui/no-unknown-event` flags an `@event` the component does not emit (it falls through to the root element, so it may be a considered native listener). `bitboss-ui/no-unknown-token` flags a bare `var(--bb-…)` naming a token the installed package does not declare, in a `<style>` block or a static `style="…"` attribute — an undefined custom property is invalid-at-computed-value-time, so CSS discards the **entire declaration** and the rule silently does nothing at runtime. Supplying a fallback (`var(--bb-canvas, #f8fafc)`) is defined behaviour and is never reported; `allowTokens` exempts names you define yourself. The token list is read from the `dist/styles.css` you installed, so it cannot claim a token is invented when your version declares it, and with no stylesheet present the rule stays silent. Before reaching for a `--bb-*` name at all, re-read the two tiers above: a name the library does not declare usually means the knob you want is a **component** token, not a gap in the global set. `bitboss-ui check` carries two further advisory hints that are deliberately not ESLint rules — the hand-rolled avatar and spinner detectors — because both are guesses, and a lint rule that fires on correct code teaches people to ignore all of them.
1207
+
1208
+ `bitboss-ui check` also has one finding with no ESLint twin: `object-items-without-text`. It flags object `items` on an item-driven control (`BbSelect`, `BbSelectPopover`, `BbRadioGroup`, `BbCheckboxGroup`, `BbSwitchGroup`, and each `BbDropdown` group with `group: true`) when `item-text` (a group's `itemText`) is not set. Without it every label is `JSON.stringify(item)`, and without `item-value` the whole object is the value. Setting `item-text` without `item-value` is a deliberate whole-object value and is not flagged, and string items never are. **Its reach is the same file only:** an inline `:items="[…]"`, or a top-level `const x = […]` (or `ref([…])` / `reactive([…])`) in the file's `<script setup>` bound as `:items="x"`. An imported array, a computed or a fetched list is not read, and `check` never guesses at one. Silence one site with `<!-- eslint-disable-next-line bitboss-ui/require-partner-prop -->`.
510
1209
 
511
1210
  **The manifest ships with the package** — `dist/ai/components.json` is inside
512
1211
  the tarball, and the rules resolve it relative to their own file, so a normal
@@ -516,20 +1215,65 @@ nothing), the rules cannot check anything: they now **warn once** saying they
516
1215
  are inactive rather than passing silently. Pass `failClosed: true` to a rule's
517
1216
  options if you would rather CI stop than under-check.
518
1217
 
519
- It also enables `bitboss-ui/require-partner-prop`: an opt-in prop set without its documented required partner — BbTable `keyboard-navigation` / `v-model:highlighted` without `row-class` (the shipped tint says "current row"; `row-class` says why, and is how you override it), or `loading-text` without `:loading` bound — compiles and mounts clean and just does nothing; the rule names the missing partner and quotes why.
1218
+ Alongside `components` the manifest carries a `types` array: the public TYPE
1219
+ exports (`BbTableColumn`, `BbDropdownItem`, …), each with the component and prop
1220
+ it is written on. That is how `check`, the ESLint rules and the MCP server tell
1221
+ a type used as a tag from a typo and from a component your app owns — three
1222
+ cases that used to share one message and one (usually wrong) remedy.
1223
+
1224
+ #### Your own components named `Bb…`
1225
+
1226
+ **In short: `check` leaves your own `<BbRichEditor>` alone (no findings, never
1227
+ rewritten) and prints ONE warning, `local-bb-component`, suggesting a rename
1228
+ to your app's prefix (`AppRichEditor`).** Don't name them that way: `Bb` is bitboss-ui's prefix, and a future release
1229
+ could ship a component with the same name. Use your app's prefix (`App…`,
1230
+ `Acme…`). If you already have one, `check`, the ESLint rules and `check --fix`
1231
+ leave it alone with no configuration, as long as they can see it is yours:
1232
+
1233
+ - it is imported from a path that is not `bitboss-ui`, in the file that uses it
1234
+ (`import BbRichEditor from './BbRichEditor.vue'`), or
1235
+ - a `.vue` file in the project's `components/` directories has that name, by
1236
+ file name or by Nuxt's path-prefix naming (`components/bb/RichEditor.vue` is
1237
+ `BbRichEditor`).
1238
+
1239
+ Such a tag gets no findings and is never rewritten. `check` prints one warning
1240
+ per component (`local-bb-component`) suggesting the rename. A library component
1241
+ imported under another name (`import { BbButton as BbSave } from 'bitboss-ui'`)
1242
+ is checked as `BbButton`. A `Bb*` tag that is neither in the manifest nor
1243
+ provably yours stays an `unknown-component` error: that is how a typo
1244
+ (`<BbButon>`), an invented name or a removed component is caught.
1245
+
1246
+ **`allowComponents` is for the rest — a component registered globally (so no
1247
+ import shows), and a per-tag off switch, not the suppression of one message.**
1248
+ An allowlisted name is skipped whole: no unknown-component finding, no warning,
1249
+ and no prop, event, v-model or slot check on that tag, permanently. Never reach
1250
+ for it to quieten a `Bb*` name the library itself exports.
1251
+
1252
+ `recommended` also enables **`bitboss-ui/no-reverse-false`**, which covers the one v2 break a rename table cannot: `reverse` on `BbCheckbox` / `BbRadio` / `BbSwitch` kept its NAME and inverted its MEANING in v3, so the v2 spelling `:reverse="false"` (control on the right) is now a no-op that renders the control on the LEFT. Nothing else catches it — it is a declared prop, correctly typed, holding its own default value — and it cannot be expressed as a rename, because a rename entry is keyed by prop name and would rewrite the legitimate v3 spellings too. The rule flags only a LITERAL `:reverse="false"` (a dynamic `:reverse="isRtl"` that evaluates false is left alone) and offers both corrections as editor suggestions; pass `{ assumeV2: true }` to promote the v2-intent rewrite to a real `--fix` for a bulk sweep, then remove it — the two readings produce opposite layouts, so it must never be on by default. See [the migration guide](../guides/migration/components/bb-checkbox.md).
1253
+
1254
+ `recommended` also enables **`bitboss-ui/no-box-border-color`**: a colour-shade `border-*` utility (`border-green-500`, never `border-2`) in the **base** `pt:box` of a text-like control hides the errors / warnings frame, because a border utility beats the state colour. It suggests `[--border-color:var(--color-green-500)]`, the resting-border token the frame outranks. State entries (`pt:box:errors="border-red-800"`) are the state itself and are never reported. Literal classes only.
1255
+
1256
+ `recommended` also enables **`bitboss-ui/no-star-color`**: any colour utility (`text-*`, `fill-*`, `stroke-*`: a shade, a keyword, `text-(--var)` or an arbitrary colour; never `text-sm` or `stroke-2`) in `BbRating`'s `pt:item`, base or any state, freezes the stars, because the rating paints each star's colour per state (filled, the hover preview, errors) and a colour utility beats that. Set `--accent` / `--empty` / `--border-color` on `pt:root` instead. No autofix: the fix moves to another attribute.
1257
+
1258
+ `recommended` also enables **`bitboss-ui/no-state-text-color`**: a colour-shade `text-*` utility (`text-red-800`, never `text-xs`) in `pt:icon:errors` / `warnings` / `disabled` on `BbCheckbox` / `BbRadio` / `BbSwitch` and their groups (or `pt:root:<state>` on their glyphs) paints nothing, because those states paint from the glyph's own `--accent`, not from `color` — and CSS cannot tell a state entry's colour from the resting `pt:icon` one. For errors and warnings the rule suggests `[--accent:var(--color-red-800)]`, which does recolour the state; for disabled it explains and suggests a fill or border utility. Literal classes only.
1259
+
1260
+ `recommended` also enables **`bitboss-ui/require-accessible-name`**: an icon-only `BbButton` (an `icon`, `prepend:icon` or `append:icon`, and no words in the default slot, no `text`, no `aria-label` / `aria-labelledby` / `title`), an icon-only `BbBadge` (`icon` and an empty default slot, which is its label) or a `BbProgress` with no `label` / `aria-label` / `aria-labelledby` renders with no accessible name, so a screen reader announces a bare "button" or "progress bar". The fix is words in the slot, `<BbButton icon="lucide:trash">Elimina</BbButton>`: with `icon` set they are visually hidden and still name the button. `BbSpinner` has no such rule: without `label` it is decorative, which is correct. `bitboss-ui check` reports the same finding as `nameless-control`. For raw HTML controls, use `eslint-plugin-vuejs-accessibility`.
1261
+
1262
+ It also enables `bitboss-ui/require-partner-prop`: an opt-in prop set without its documented required partner — BbTable `keyboard-navigation` / `v-model:highlighted` without `row-class` (the shipped tint says "current row"; `row-class` says why, and is how you override it), `loading-text` without `:loading` bound, or `method` on BbButton / BbBadgeButton / BbBaseButton without `href` (only an `href` becomes an Inertia visit; `to` is a RouterLink) — compiles and mounts clean and just does nothing; the rule names the missing partner and quotes why.
520
1263
 
521
1264
  ## 9) Setup Verification Checklist
522
1265
 
523
1266
  - [ ] package installed (plus `@iconify-json/*` packages for every provider prefix used);
524
1267
  - [ ] build plugin configured: `bitboss-ui/vite` plugin or `bitboss-ui/nuxt` module (`bitboss` config key);
525
- - [ ] `iconDir` points at an existing SVG folder;
1268
+ - [ ] using `local:` icons? `iconDir` points at an existing SVG folder;
526
1269
  - [ ] runtime plugin installed: `app.use(bitbossUiPlugin)` (automatic in Nuxt);
527
1270
  - [ ] style strategy chosen: auto injection (default) or `injectStyles: false` + `import 'bitboss-ui/styles.css'` — auto injection is always library-first, so a Tailwind **v3** app that needs Preflight to load before the library must take the second option (§5);
528
1271
  - [ ] if a reset is required: `resetCss: true` or `import 'bitboss-ui/reset.css'`;
529
1272
  - [ ] Inertia apps: `@inertiajs/vue3` installed (no link registration needed; set `inertiaLinkName` only if you register your own link wrapper).
530
1273
  - [ ] building the [Layout Scaffold](../recipes/vue/layout-scaffold.md)? `npm i @vueuse/core` — `usePageShellContext.ts` imports `injectLocal`/`provideLocal` from it. This library depends on it too, so it can resolve via hoisting without being declared — don't rely on that; declare it in your own `package.json` or a strict installer (pnpm, Yarn PnP) will fail to resolve it.
531
1274
  - [ ] `vite.config.ts` (and any other build config, e.g. `eslint.config.js`) is inside your project's type-check scope — a `tsconfig.node.json` project reference is the conventional shape. Otherwise `bitbossUi(...)`'s typed options (`locale`, the `*Variants` registries, `iconDefaultSizes`, …) are never checked by `vue-tsc --noEmit`, silently defeating the compile-time guarantees this guide documents (e.g. "selecting a non-enabled locale is a compile error").
532
- - [ ] `vue-tsc` is **3.x** (`npx vue-tsc --version`). On 2.x the template type-checker cannot read props off the generic-function declarations this library emits for `BbSelect`, `BbSelectPopover`, `BbTable`, `BbTabs`, `BbTree`, `BbRadioGroup`, `BbCheckboxGroup` and `BbSwitchGroup`, so their props go **entirely unchecked** — missing, misspelled and wrongly-typed props all pass — while unknown-component checking and every non-generic component keep erroring normally, which is exactly why a 2.x gate reads as healthy. See "Known-good toolchain" in [1) Install](#1-install).
1275
+ - [ ] `vue-tsc` is **3.x** (`npx vue-tsc --version`). On 2.x the template type-checker cannot read props off the generic-function declarations this library emits for `BbSelect`, `BbSelectPopover`, `BbTable`, `BbTabs`, `BbTree`, `BbRadioGroup`, `BbCheckboxGroup`, `BbSwitchGroup` and `BbForm`, so their props go **entirely unchecked** — missing, misspelled and wrongly-typed props all pass — while unknown-component checking and every non-generic component keep erroring normally, which is exactly why a 2.x gate reads as healthy. See "Known-good toolchain" in [1) Install](#1-install).
1276
+ - [ ] `tsconfig.json` sets `"vueCompilerOptions": { "strictTemplates": true }`. Without it Vue Language Tools 3 lets an unknown ATTRIBUTE through on any component — a misspelt prop, a `pt:icno` — with no error; with it every `Bb*` template attribute is checked against the declared props (`pt:<part>` and `pt:<part>:<state>` included). The ESLint rule catches the same misspellings, but only where it runs.
533
1277
  - [ ] `tsconfig.json` sets `"vueCompilerOptions": { "checkUnknownComponents": true }`. Vue Language Tools 3 (`vue-tsc`) treats unknown-component checking as **opt-in** — without this flag, a `<BbTabs>` used without its import (or after a typo, or dropped by a bad auto-import config) type-checks clean, lints clean, and passes `bitboss-ui check` (none of the three gates resolve component tags), then renders as a silent unregistered custom element in the browser: no error anywhere, just a missing widget in production. With the flag, `vue-tsc --noEmit` names the exact tag and line (`Property 'BbTabs' does not exist on type '{}'.`) on the offending file, with no false positives from the library itself — nothing in `bitboss-ui`'s runtime plugin globally registers `Bb*` components (only the `v-bb-*` directives are global), so every `Bb*` tag in your templates is expected to resolve through an explicit import.
534
1278
 
535
1279
  If one of the checks fails, fix setup before creating component examples.