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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (937) hide show
  1. package/README.md +317 -98
  2. package/bin/bitboss-ui-mcp.mjs +1566 -75
  3. package/bin/bitboss-ui.mjs +716 -72
  4. package/dist/ai/BbAccordion.md +178 -56
  5. package/dist/ai/BbAlert.md +140 -28
  6. package/dist/ai/BbAsterisk.md +61 -4
  7. package/dist/ai/BbAvatar.md +194 -53
  8. package/dist/ai/BbBadge.md +250 -50
  9. package/dist/ai/BbBadgeButton.md +74 -21
  10. package/dist/ai/BbBaseButton.md +132 -51
  11. package/dist/ai/BbBaseCheckboxIcon.md +118 -26
  12. package/dist/ai/BbBaseRadioIcon.md +115 -26
  13. package/dist/ai/BbBaseSwitchIcon.md +123 -28
  14. package/dist/ai/BbBreadcrumbs.md +221 -51
  15. package/dist/ai/BbButton.md +389 -107
  16. package/dist/ai/BbCalendar.md +667 -0
  17. package/dist/ai/BbCheckbox.md +242 -80
  18. package/dist/ai/BbCheckboxGroup.md +575 -66
  19. package/dist/ai/BbCollapsible.md +158 -39
  20. package/dist/ai/BbColorInput.md +322 -82
  21. package/dist/ai/BbColorPalette.md +261 -61
  22. package/dist/ai/BbConfirm.md +220 -51
  23. package/dist/ai/BbConfirmPortal.md +1 -1
  24. package/dist/ai/BbDatePicker.md +272 -37
  25. package/dist/ai/BbDatePickerInput.md +321 -92
  26. package/dist/ai/BbDialog.md +492 -87
  27. package/dist/ai/BbDropdown.md +1182 -104
  28. package/dist/ai/BbDropdownButton.md +239 -61
  29. package/dist/ai/BbDropdownGroup.md +5 -5
  30. package/dist/ai/BbDropzone.md +140 -36
  31. package/dist/ai/BbForm.md +1165 -40
  32. package/dist/ai/BbIcon.md +100 -33
  33. package/dist/ai/BbIndicator.md +79 -12
  34. package/dist/ai/BbNumberInput.md +257 -87
  35. package/dist/ai/BbOffCanvas.md +396 -91
  36. package/dist/ai/BbPagination.md +199 -32
  37. package/dist/ai/BbPopover.md +219 -54
  38. package/dist/ai/BbProgress.md +137 -71
  39. package/dist/ai/BbPtScope.md +136 -0
  40. package/dist/ai/BbRadio.md +234 -43
  41. package/dist/ai/BbRadioGroup.md +529 -91
  42. package/dist/ai/BbRating.md +243 -61
  43. package/dist/ai/BbSelect.md +690 -120
  44. package/dist/ai/BbSelectPopover.md +434 -122
  45. package/dist/ai/BbSlider.md +275 -79
  46. package/dist/ai/BbSmoothHeight.md +142 -34
  47. package/dist/ai/BbSpinner.md +179 -81
  48. package/dist/ai/BbSwitch.md +249 -63
  49. package/dist/ai/BbSwitchGroup.md +394 -65
  50. package/dist/ai/BbTable.md +1666 -222
  51. package/dist/ai/BbTabs.md +898 -178
  52. package/dist/ai/BbTabsList.md +81 -7
  53. package/dist/ai/BbTabsPanels.md +77 -0
  54. package/dist/ai/BbTabsRoot.md +16 -15
  55. package/dist/ai/BbTag.md +256 -76
  56. package/dist/ai/BbTextInput.md +480 -102
  57. package/dist/ai/BbTextarea.md +310 -96
  58. package/dist/ai/BbTimePicker.md +159 -24
  59. package/dist/ai/BbTimePickerInput.md +277 -46
  60. package/dist/ai/BbToast.md +286 -40
  61. package/dist/ai/BbToastPortal.md +3 -3
  62. package/dist/ai/BbTooltip.md +187 -34
  63. package/dist/ai/BbTree.md +260 -85
  64. package/dist/ai/ChipsBox.md +43 -2
  65. package/dist/ai/ClearableButton.md +12 -0
  66. package/dist/ai/CommaBox.md +2 -1
  67. package/dist/ai/CommonField.md +63 -0
  68. package/dist/ai/CommonFieldInput.md +90 -0
  69. package/dist/ai/CommonPopover.md +17 -12
  70. package/dist/ai/CommonTimeSelector.md +63 -0
  71. package/dist/ai/ErrorIcon.md +20 -0
  72. package/dist/ai/FlatListBox.md +41 -11
  73. package/dist/ai/GroupedListBox.md +42 -12
  74. package/dist/ai/ListBox.md +46 -11
  75. package/dist/ai/OptionsContainer.md +13 -10
  76. package/dist/ai/WarningIcon.md +20 -0
  77. package/dist/ai/changelog.json +4025 -141
  78. package/dist/ai/components.json +51872 -10136
  79. package/dist/ai/composables/useBbConfig.md +72 -11
  80. package/dist/ai/composables/useBbDropdownContext.md +168 -0
  81. package/dist/ai/composables/useBbFormContext.md +51 -24
  82. package/dist/ai/composables/useBbFormField.md +134 -0
  83. package/dist/ai/composables/useBbTableContext.md +41 -19
  84. package/dist/ai/composables/useConfirm.md +16 -8
  85. package/dist/ai/composables/useCountdown.md +1 -1
  86. package/dist/ai/composables/useId.md +10 -10
  87. package/dist/ai/composables/useMobile.md +17 -10
  88. package/dist/ai/composables/useToast.md +25 -19
  89. package/dist/ai/design-tokens.json +940 -0
  90. package/dist/ai/design-tokens.manifest.yaml +175 -0
  91. package/dist/ai/guides/agent-contract.md +168 -22
  92. package/dist/ai/guides/ai-router.md +79 -40
  93. package/dist/ai/guides/app-layout.md +8 -4
  94. package/dist/ai/guides/coherence-playbook.md +8 -8
  95. package/dist/ai/guides/component-picker.md +42 -34
  96. package/dist/ai/guides/design-language.md +274 -97
  97. package/dist/ai/guides/design-tokens.md +493 -105
  98. package/dist/ai/guides/fetch-items-playbook.md +22 -16
  99. package/dist/ai/guides/icons-policy.md +67 -35
  100. package/dist/ai/guides/inertia-helpers.md +4 -1
  101. package/dist/ai/guides/inline-edit-playbook.md +13 -6
  102. package/dist/ai/guides/installation-and-plugin-setup.md +817 -73
  103. package/dist/ai/guides/migration/components/bb-accordion.md +37 -0
  104. package/dist/ai/guides/migration/components/bb-alert.md +2 -2
  105. package/dist/ai/guides/migration/components/bb-avatar.md +13 -14
  106. package/dist/ai/guides/migration/components/bb-badge.md +5 -5
  107. package/dist/ai/guides/migration/components/bb-breadcrumbs.md +9 -8
  108. package/dist/ai/guides/migration/components/bb-button.md +80 -20
  109. package/dist/ai/guides/migration/components/bb-checkbox-group.md +116 -29
  110. package/dist/ai/guides/migration/components/bb-checkbox.md +53 -10
  111. package/dist/ai/guides/migration/components/bb-chip.md +6 -6
  112. package/dist/ai/guides/migration/components/bb-collapsible.md +5 -5
  113. package/dist/ai/guides/migration/components/bb-color-input.md +5 -5
  114. package/dist/ai/guides/migration/components/bb-color-palette.md +16 -9
  115. package/dist/ai/guides/migration/components/bb-date-picker-input.md +45 -35
  116. package/dist/ai/guides/migration/components/bb-dialog.md +69 -36
  117. package/dist/ai/guides/migration/components/bb-dropdown-button.md +7 -1
  118. package/dist/ai/guides/migration/components/bb-dropdown.md +31 -8
  119. package/dist/ai/guides/migration/components/bb-dropzone.md +8 -0
  120. package/dist/ai/guides/migration/components/bb-icon.md +7 -7
  121. package/dist/ai/guides/migration/components/bb-intersection.md +1 -1
  122. package/dist/ai/guides/migration/components/bb-offcanvas.md +29 -31
  123. package/dist/ai/guides/migration/components/bb-pagination.md +10 -0
  124. package/dist/ai/guides/migration/components/bb-popover.md +19 -11
  125. package/dist/ai/guides/migration/components/bb-radio-group.md +14 -0
  126. package/dist/ai/guides/migration/components/bb-rating.md +61 -24
  127. package/dist/ai/guides/migration/components/bb-select-popover.md +9 -1
  128. package/dist/ai/guides/migration/components/bb-select.md +21 -4
  129. package/dist/ai/guides/migration/components/bb-slider.md +14 -6
  130. package/dist/ai/guides/migration/components/bb-switch-group.md +14 -0
  131. package/dist/ai/guides/migration/components/bb-table.md +574 -33
  132. package/dist/ai/guides/migration/components/bb-tabs.md +91 -41
  133. package/dist/ai/guides/migration/components/bb-tag.md +9 -7
  134. package/dist/ai/guides/migration/components/bb-text-input.md +12 -12
  135. package/dist/ai/guides/migration/components/bb-toast.md +2 -2
  136. package/dist/ai/guides/migration/components/bb-tooltip.md +18 -0
  137. package/dist/ai/guides/migration/components/bb-tree.md +11 -9
  138. package/dist/ai/guides/migration/components/use-confirm.md +9 -1
  139. package/dist/ai/guides/migration/v2-to-v3.md +828 -240
  140. package/dist/ai/guides/migration/v3-beta-css-classes.md +751 -0
  141. package/dist/ai/guides/migration/v3-beta-tooling.md +119 -0
  142. package/dist/ai/guides/options-items-playbook.md +161 -12
  143. package/dist/ai/guides/page-shell.md +1 -1
  144. package/dist/ai/guides/passthrough.md +958 -0
  145. package/dist/ai/guides/preset-components.md +361 -0
  146. package/dist/ai/guides/ssr-prefill.md +127 -0
  147. package/dist/ai/guides/validated-forms.md +466 -55
  148. package/dist/ai/guides/validation-libraries.md +171 -0
  149. package/dist/ai/guides/validation-providers.md +113 -0
  150. package/dist/ai/index.md +45 -44
  151. package/dist/ai/recipes/inertia/approvals-inbox.md +26 -10
  152. package/dist/ai/recipes/inertia/command-palette.md +2 -2
  153. package/dist/ai/recipes/inertia/inline-edit-workspace.md +46 -30
  154. package/dist/ai/recipes/inertia/layout-scaffold.md +6 -2
  155. package/dist/ai/recipes/inertia/onboarding.md +30 -8
  156. package/dist/ai/recipes/inertia/ownership-atlas.md +72 -49
  157. package/dist/ai/recipes/inertia/record-form.md +53 -19
  158. package/dist/ai/recipes/inertia/records-workspace.md +201 -49
  159. package/dist/ai/recipes/inertia/settings-workspace.md +3809 -0
  160. package/dist/ai/recipes/inertia/upload-center.md +54 -43
  161. package/dist/ai/recipes/inertia/wizard-form.md +98 -14
  162. package/dist/ai/recipes/nuxt/approvals-inbox.md +26 -10
  163. package/dist/ai/recipes/nuxt/command-palette.md +2 -2
  164. package/dist/ai/recipes/nuxt/inline-edit-workspace.md +68 -52
  165. package/dist/ai/recipes/nuxt/layout-scaffold.md +6 -2
  166. package/dist/ai/recipes/nuxt/onboarding.md +30 -8
  167. package/dist/ai/recipes/nuxt/record-form.md +66 -22
  168. package/dist/ai/recipes/nuxt/records-workspace.md +199 -48
  169. package/dist/ai/recipes/nuxt/settings-workspace.md +3898 -0
  170. package/dist/ai/recipes/nuxt/upload-center.md +52 -41
  171. package/dist/ai/recipes/nuxt/wizard-form.md +98 -14
  172. package/dist/ai/recipes/vue/approvals-inbox.md +28 -12
  173. package/dist/ai/recipes/vue/command-palette.md +2 -2
  174. package/dist/ai/recipes/vue/inline-edit-workspace.md +69 -53
  175. package/dist/ai/recipes/vue/layout-scaffold.md +6 -2
  176. package/dist/ai/recipes/vue/onboarding.md +32 -8
  177. package/dist/ai/recipes/vue/record-form.md +81 -54
  178. package/dist/ai/recipes/vue/records-workspace.md +198 -49
  179. package/dist/ai/recipes/vue/settings-workspace.md +3836 -0
  180. package/dist/ai/recipes/vue/upload-center.md +53 -42
  181. package/dist/ai/recipes/vue/wizard-form.md +97 -14
  182. package/dist/ai/source/BbAccordion.md +90 -24
  183. package/dist/ai/source/BbAlert.md +209 -62
  184. package/dist/ai/source/BbAsterisk.md +54 -4
  185. package/dist/ai/source/BbAvatar.md +73 -16
  186. package/dist/ai/source/BbBadge.md +265 -97
  187. package/dist/ai/source/BbBadgeButton.md +218 -79
  188. package/dist/ai/source/BbBaseButton.md +108 -12
  189. package/dist/ai/source/BbBaseCheckboxIcon.md +151 -36
  190. package/dist/ai/source/BbBaseRadioIcon.md +121 -17
  191. package/dist/ai/source/BbBaseSwitchIcon.md +138 -28
  192. package/dist/ai/source/BbBreadcrumbs.md +363 -69
  193. package/dist/ai/source/BbButton.md +563 -174
  194. package/dist/ai/source/BbCalendar.md +1744 -0
  195. package/dist/ai/source/BbCheckbox.md +470 -68
  196. package/dist/ai/source/BbCheckboxGroup.md +976 -95
  197. package/dist/ai/source/BbCollapsible.md +96 -8
  198. package/dist/ai/source/BbColorInput.md +597 -67
  199. package/dist/ai/source/BbColorPalette.md +1284 -65
  200. package/dist/ai/source/BbConfirm.md +149 -7
  201. package/dist/ai/source/BbConfirmPortal.md +89 -3
  202. package/dist/ai/source/BbDatePicker.md +527 -381
  203. package/dist/ai/source/BbDatePickerInput.md +2015 -118
  204. package/dist/ai/source/BbDialog.md +531 -64
  205. package/dist/ai/source/BbDropdown.md +885 -175
  206. package/dist/ai/source/BbDropdownButton.md +377 -79
  207. package/dist/ai/source/BbDropdownGroup.md +687 -96
  208. package/dist/ai/source/BbDropzone.md +140 -31
  209. package/dist/ai/source/BbForm.md +875 -17
  210. package/dist/ai/source/BbIcon.md +130 -52
  211. package/dist/ai/source/BbIndicator.md +117 -60
  212. package/dist/ai/source/BbNumberInput.md +667 -84
  213. package/dist/ai/source/BbOffCanvas.md +1007 -261
  214. package/dist/ai/source/BbPagination.md +203 -31
  215. package/dist/ai/source/BbPopover.md +267 -90
  216. package/dist/ai/source/BbProgress.md +88 -26
  217. package/dist/ai/source/BbPtScope.md +54 -0
  218. package/dist/ai/source/BbRadio.md +388 -58
  219. package/dist/ai/source/BbRadioGroup.md +940 -109
  220. package/dist/ai/source/BbRating.md +736 -84
  221. package/dist/ai/source/BbSelect.md +1096 -96
  222. package/dist/ai/source/BbSelectPopover.md +807 -114
  223. package/dist/ai/source/BbSlider.md +1390 -98
  224. package/dist/ai/source/BbSmoothHeight.md +48 -2
  225. package/dist/ai/source/BbSpinner.md +62 -6
  226. package/dist/ai/source/BbSwitch.md +297 -60
  227. package/dist/ai/source/BbSwitchGroup.md +761 -83
  228. package/dist/ai/source/BbTable.md +6950 -1864
  229. package/dist/ai/source/BbTabs.md +368 -111
  230. package/dist/ai/source/BbTabsList.md +503 -146
  231. package/dist/ai/source/BbTabsPanels.md +625 -0
  232. package/dist/ai/source/BbTabsRoot.md +319 -100
  233. package/dist/ai/source/BbTag.md +796 -87
  234. package/dist/ai/source/BbTextInput.md +497 -68
  235. package/dist/ai/source/BbTextarea.md +550 -65
  236. package/dist/ai/source/BbTimePicker.md +395 -69
  237. package/dist/ai/source/BbTimePickerInput.md +1233 -106
  238. package/dist/ai/source/BbToast.md +250 -74
  239. package/dist/ai/source/BbToastPortal.md +210 -66
  240. package/dist/ai/source/BbTooltip.md +181 -30
  241. package/dist/ai/source/BbTree.md +76 -11
  242. package/dist/ai/source/ChipsBox.md +25 -5
  243. package/dist/ai/source/CommaBox.md +21 -6
  244. package/dist/ai/source/{BbBaseInputContainer.md → CommonField.md} +467 -250
  245. package/dist/ai/source/CommonFieldInput.md +848 -0
  246. package/dist/ai/source/CommonPopover.md +116 -30
  247. package/dist/ai/source/CommonTimeSelector.md +726 -0
  248. package/dist/ai/source/ErrorIcon.md +2 -2
  249. package/dist/ai/source/FlatListBox.md +188 -17
  250. package/dist/ai/source/GroupedListBox.md +236 -44
  251. package/dist/ai/source/GuidesComponent.md +14 -7
  252. package/dist/ai/source/ListBox.md +46 -8
  253. package/dist/ai/source/OptionsContainer.md +288 -60
  254. package/dist/ai/source/WarningIcon.md +2 -2
  255. package/dist/assets/css/reset.css_inline.js +1 -1
  256. package/dist/assets/svgs/star.svg_raw.js +4 -0
  257. package/dist/components/BbAccordion/BbAccordion.vue_vue_type_script_setup_true_lang.js +49 -32
  258. package/dist/components/BbAccordion/types.d.ts +35 -3
  259. package/dist/components/BbAccordion/types.js +11 -0
  260. package/dist/components/BbAlert/BbAlert.vue_vue_type_script_setup_true_lang.js +46 -30
  261. package/dist/components/BbAlert/types.d.ts +37 -3
  262. package/dist/components/BbAlert/types.js +13 -0
  263. package/dist/components/BbAsterisk/BbAsterisk.vue.d.ts +3 -1
  264. package/dist/components/BbAsterisk/BbAsterisk.vue_vue_type_script_setup_true_lang.js +23 -8
  265. package/dist/components/BbAsterisk/types.d.ts +18 -0
  266. package/dist/components/BbAsterisk/types.js +7 -0
  267. package/dist/components/BbAvatar/BbAvatar.vue.d.ts +1 -1
  268. package/dist/components/BbAvatar/BbAvatar.vue_vue_type_script_setup_true_lang.js +57 -44
  269. package/dist/components/BbAvatar/types.d.ts +23 -0
  270. package/dist/components/BbAvatar/types.js +7 -0
  271. package/dist/components/BbBadge/BadgeBodyContent.vue_vue_type_script_setup_true_lang.js +24 -18
  272. package/dist/components/BbBadge/BbBadge.vue_vue_type_script_setup_true_lang.js +96 -53
  273. package/dist/components/BbBadge/BbBadgeButton.vue_vue_type_script_setup_true_lang.js +27 -8
  274. package/dist/components/BbBadge/badgeButtonContext.d.ts +25 -8
  275. package/dist/components/BbBadge/types.d.ts +46 -3
  276. package/dist/components/BbBadge/types.js +13 -0
  277. package/dist/components/BbBaseButton/BbBaseButton.vue_vue_type_script_setup_true_lang.js +109 -96
  278. package/dist/components/BbBaseButton/RouterComponent.vue_vue_type_script_setup_true_lang.js +11 -11
  279. package/dist/components/BbBaseButton/types.d.ts +33 -3
  280. package/dist/components/BbBaseButton/types.js +9 -2
  281. package/dist/components/BbBaseCheckboxIcon/BbBaseCheckboxIcon.vue_vue_type_script_setup_true_lang.js +50 -18
  282. package/dist/components/BbBaseCheckboxIcon/types.d.ts +31 -2
  283. package/dist/components/BbBaseCheckboxIcon/types.js +8 -0
  284. package/dist/components/BbBaseRadioIcon/BbBaseRadioIcon.vue_vue_type_script_setup_true_lang.js +45 -15
  285. package/dist/components/BbBaseRadioIcon/types.d.ts +31 -2
  286. package/dist/components/BbBaseRadioIcon/types.js +8 -0
  287. package/dist/components/BbBaseSwitchIcon/BbBaseSwitchIcon.vue_vue_type_script_setup_true_lang.js +48 -16
  288. package/dist/components/BbBaseSwitchIcon/types.d.ts +31 -2
  289. package/dist/components/BbBaseSwitchIcon/types.js +8 -0
  290. package/dist/components/BbBreadcrumbs/BbBreadcrumbs.vue_vue_type_script_setup_true_lang.js +187 -132
  291. package/dist/components/BbBreadcrumbs/types.d.ts +45 -3
  292. package/dist/components/BbBreadcrumbs/types.js +12 -0
  293. package/dist/components/BbButton/BbButton.vue.d.ts +5 -0
  294. package/dist/components/BbButton/BbButton.vue_vue_type_script_setup_true_lang.js +107 -81
  295. package/dist/components/BbButton/types.d.ts +113 -2
  296. package/dist/components/BbButton/types.js +12 -0
  297. package/dist/components/BbCalendar/BbCalendar.vue.d.ts +34 -0
  298. package/dist/components/BbCalendar/BbCalendar.vue.js +6 -0
  299. package/dist/components/BbCalendar/BbCalendar.vue_vue_type_script_setup_true_lang.js +608 -0
  300. package/dist/components/BbCalendar/CalendarMonthPanel.vue.js +5 -0
  301. package/dist/components/BbCalendar/CalendarMonthPanel.vue_vue_type_script_setup_true_lang.js +124 -0
  302. package/dist/components/BbCalendar/CalendarYearPanel.vue.js +5 -0
  303. package/dist/components/BbCalendar/CalendarYearPanel.vue_vue_type_script_setup_true_lang.js +126 -0
  304. package/dist/components/BbCalendar/calendarHost.d.ts +29 -0
  305. package/dist/components/BbCalendar/calendarHost.js +10 -0
  306. package/dist/components/BbCalendar/types.d.ts +225 -0
  307. package/dist/components/BbCalendar/types.js +29 -0
  308. package/dist/components/{BbBaseDatePicker/useDatePickerContext.d.ts → BbCalendar/useCalendarContext.d.ts} +10 -7
  309. package/dist/components/BbCalendar/useCalendarContext.js +11 -0
  310. package/dist/components/BbCalendar/useCalendarGrid.d.ts +208 -0
  311. package/dist/components/BbCalendar/useCalendarGrid.js +274 -0
  312. package/dist/components/BbCalendar/useDayGrid.d.ts +79 -0
  313. package/dist/components/BbCalendar/useDayGrid.js +204 -0
  314. package/dist/components/BbCalendar/useToday.d.ts +23 -0
  315. package/dist/components/BbCalendar/useToday.js +21 -0
  316. package/dist/components/BbCheckbox/BbCheckbox.vue.d.ts +7 -7
  317. package/dist/components/BbCheckbox/BbCheckbox.vue_vue_type_script_setup_true_lang.js +214 -72
  318. package/dist/components/BbCheckbox/types.d.ts +180 -13
  319. package/dist/components/BbCheckbox/types.js +8 -0
  320. package/dist/components/BbCheckboxGroup/BbCheckboxGroup.vue.d.ts +15 -3
  321. package/dist/components/BbCheckboxGroup/BbCheckboxGroup.vue_vue_type_script_setup_true_lang.js +338 -90
  322. package/dist/components/BbCheckboxGroup/types.d.ts +195 -20
  323. package/dist/components/BbCheckboxGroup/types.js +10 -0
  324. package/dist/components/BbCollapsible/BbCollapsible.vue.d.ts +2 -1
  325. package/dist/components/BbCollapsible/BbCollapsible.vue_vue_type_script_setup_true_lang.js +41 -19
  326. package/dist/components/BbCollapsible/types.d.ts +44 -1
  327. package/dist/components/BbCollapsible/types.js +7 -0
  328. package/dist/components/BbColorInput/BbColorInput.vue.d.ts +17 -7
  329. package/dist/components/BbColorInput/BbColorInput.vue_vue_type_script_setup_true_lang.js +330 -86
  330. package/dist/components/BbColorInput/types.d.ts +230 -12
  331. package/dist/components/BbColorInput/types.js +24 -0
  332. package/dist/components/BbColorPalette/BbColorPalette.vue.d.ts +10 -2
  333. package/dist/components/BbColorPalette/BbColorPalette.vue_vue_type_script_setup_true_lang.js +515 -108
  334. package/dist/components/BbColorPalette/types.d.ts +76 -7
  335. package/dist/components/BbColorPalette/types.js +12 -0
  336. package/dist/components/BbConfirm/BbConfirm.vue.d.ts +2 -1
  337. package/dist/components/BbConfirm/BbConfirm.vue_vue_type_script_setup_true_lang.js +125 -76
  338. package/dist/components/BbConfirm/BbConfirmPortal.vue.d.ts +1 -0
  339. package/dist/components/BbConfirm/types.d.ts +49 -0
  340. package/dist/components/BbConfirm/types.js +17 -0
  341. package/dist/components/BbDatePicker/BbDatePicker.vue.d.ts +16 -10
  342. package/dist/components/BbDatePicker/BbDatePicker.vue_vue_type_script_setup_true_lang.js +320 -223
  343. package/dist/components/BbDatePicker/types.d.ts +111 -17
  344. package/dist/components/BbDatePicker/types.js +33 -0
  345. package/dist/components/BbDatePickerInput/BbDatePickerInput.vue.d.ts +16 -4
  346. package/dist/components/BbDatePickerInput/BbDatePickerInput.vue_vue_type_script_setup_true_lang.js +1172 -87
  347. package/dist/components/BbDatePickerInput/types.d.ts +224 -19
  348. package/dist/components/BbDatePickerInput/types.js +39 -0
  349. package/dist/components/BbDialog/BbDialog.vue.d.ts +3 -3
  350. package/dist/components/BbDialog/BbDialog.vue_vue_type_script_setup_true_lang.js +227 -136
  351. package/dist/components/BbDialog/types.d.ts +92 -3
  352. package/dist/components/BbDialog/types.js +16 -0
  353. package/dist/components/BbDialog/useDialogStack.d.ts +12 -0
  354. package/dist/components/BbDialog/useDialogStack.js +9 -2
  355. package/dist/components/BbDropdown/AdaptiveDropdown.vue.d.ts +2 -0
  356. package/dist/components/BbDropdown/AdaptiveDropdown.vue_vue_type_script_setup_true_lang.js +108 -96
  357. package/dist/components/BbDropdown/BbDropdown.vue.d.ts +10 -2
  358. package/dist/components/BbDropdown/BbDropdown.vue_vue_type_script_setup_true_lang.js +337 -268
  359. package/dist/components/BbDropdown/BbDropdownGroup.vue.d.ts +5 -1
  360. package/dist/components/BbDropdown/BbDropdownList.vue.d.ts +8 -2
  361. package/dist/components/BbDropdown/BbDropdownList.vue_vue_type_script_setup_true_lang.js +377 -293
  362. package/dist/components/BbDropdown/DropdownPipelineResolver.vue_vue_type_script_setup_true_lang.js +129 -118
  363. package/dist/components/BbDropdown/normalizeGroups.js +55 -31
  364. package/dist/components/BbDropdown/types.d.ts +288 -30
  365. package/dist/components/BbDropdown/types.js +21 -2
  366. package/dist/components/BbDropdown/useDropdownContext.d.ts +10 -4
  367. package/dist/components/BbDropdown/useDropdownGroupRegistry.d.ts +1 -0
  368. package/dist/components/BbDropdownButton/BbDropdownButton.vue.d.ts +18 -3
  369. package/dist/components/BbDropdownButton/BbDropdownButton.vue_vue_type_script_setup_true_lang.js +172 -40
  370. package/dist/components/BbDropdownButton/types.d.ts +137 -8
  371. package/dist/components/BbDropdownButton/types.js +35 -0
  372. package/dist/components/BbDropzone/BbDropzone.vue.d.ts +2 -2
  373. package/dist/components/BbDropzone/BbDropzone.vue_vue_type_script_setup_true_lang.js +186 -144
  374. package/dist/components/BbDropzone/types.d.ts +38 -4
  375. package/dist/components/BbDropzone/types.js +16 -0
  376. package/dist/components/BbForm/BbForm.vue.d.ts +94 -0
  377. package/dist/{validated → components/BbForm}/BbForm.vue.js +1 -1
  378. package/dist/components/BbForm/BbForm.vue_vue_type_script_setup_true_lang.js +317 -0
  379. package/dist/components/BbForm/BbFormCustomField.d.ts +14 -0
  380. package/dist/components/BbForm/BbFormCustomField.js +43 -0
  381. package/dist/components/BbForm/bindFormField.d.ts +16 -0
  382. package/dist/components/BbForm/bindFormField.js +85 -0
  383. package/dist/components/BbForm/formFields.d.ts +64 -0
  384. package/dist/components/BbForm/formFields.js +11 -0
  385. package/dist/components/BbForm/formSchema.d.ts +56 -0
  386. package/dist/components/BbForm/formSchema.js +196 -0
  387. package/dist/components/BbForm/standardSchema.d.ts +59 -0
  388. package/dist/components/BbIcon/BbIcon.vue_vue_type_script_setup_true_lang.js +58 -48
  389. package/dist/components/BbIcon/iconCache.d.ts +63 -0
  390. package/dist/components/BbIcon/iconCache.js +35 -0
  391. package/dist/components/BbIcon/types.d.ts +22 -2
  392. package/dist/components/BbIcon/types.js +7 -0
  393. package/dist/components/BbIndicator/BbIndicator.vue_vue_type_script_setup_true_lang.js +34 -21
  394. package/dist/components/BbIndicator/types.d.ts +24 -0
  395. package/dist/components/BbIndicator/types.js +7 -0
  396. package/dist/components/BbNumberInput/BbNumberInput.vue.d.ts +12 -8
  397. package/dist/components/BbNumberInput/BbNumberInput.vue_vue_type_script_setup_true_lang.js +308 -85
  398. package/dist/components/BbNumberInput/types.d.ts +201 -18
  399. package/dist/components/BbNumberInput/types.js +8 -0
  400. package/dist/components/BbOffCanvas/BbOffCanvas.vue.d.ts +3 -3
  401. package/dist/components/BbOffCanvas/BbOffCanvas.vue_vue_type_script_setup_true_lang.js +311 -210
  402. package/dist/components/BbOffCanvas/types.d.ts +79 -6
  403. package/dist/components/BbOffCanvas/types.js +15 -0
  404. package/dist/components/BbPagination/BbPagination.vue.d.ts +2 -2
  405. package/dist/components/BbPagination/BbPagination.vue_vue_type_script_setup_true_lang.js +125 -90
  406. package/dist/components/BbPagination/types.d.ts +38 -0
  407. package/dist/components/BbPagination/types.js +13 -0
  408. package/dist/components/BbPopover/BbPopover.vue.d.ts +4 -4
  409. package/dist/components/BbPopover/BbPopover.vue_vue_type_script_setup_true_lang.js +219 -179
  410. package/dist/components/BbPopover/types.d.ts +51 -5
  411. package/dist/components/BbPopover/types.js +14 -0
  412. package/dist/components/BbProgress/BbProgress.vue_vue_type_script_setup_true_lang.js +29 -16
  413. package/dist/components/BbProgress/types.d.ts +25 -0
  414. package/dist/components/BbProgress/types.js +7 -0
  415. package/dist/components/BbPtScope/BbPtScope.vue.d.ts +12 -0
  416. package/dist/components/BbPtScope/BbPtScope.vue.js +5 -0
  417. package/dist/components/BbPtScope/BbPtScope.vue_vue_type_script_setup_true_lang.js +13 -0
  418. package/dist/components/BbPtScope/types.d.ts +15 -0
  419. package/dist/components/BbRadio/BbRadio.vue.d.ts +7 -7
  420. package/dist/components/BbRadio/BbRadio.vue_vue_type_script_setup_true_lang.js +172 -59
  421. package/dist/components/BbRadio/types.d.ts +152 -13
  422. package/dist/components/BbRadio/types.js +8 -0
  423. package/dist/components/BbRadioGroup/BbRadioGroup.vue.d.ts +14 -2
  424. package/dist/components/BbRadioGroup/BbRadioGroup.vue_vue_type_script_setup_true_lang.js +319 -92
  425. package/dist/components/BbRadioGroup/types.d.ts +198 -22
  426. package/dist/components/BbRadioGroup/types.js +10 -0
  427. package/dist/components/BbRating/BbRating.vue.d.ts +10 -8
  428. package/dist/components/BbRating/BbRating.vue_vue_type_script_setup_true_lang.js +259 -78
  429. package/dist/components/BbRating/types.d.ts +174 -13
  430. package/dist/components/BbRating/types.js +21 -0
  431. package/dist/components/BbSelect/BbSelect.vue.d.ts +17 -3
  432. package/dist/components/BbSelect/BbSelect.vue_vue_type_script_setup_true_lang.js +553 -83
  433. package/dist/components/BbSelect/types.d.ts +235 -20
  434. package/dist/components/BbSelect/types.js +41 -0
  435. package/dist/components/BbSelectPopover/BbSelectPopover.vue.d.ts +15 -1
  436. package/dist/components/BbSelectPopover/BbSelectPopover.vue_vue_type_script_setup_true_lang.js +541 -391
  437. package/dist/components/BbSelectPopover/types.d.ts +124 -8
  438. package/dist/components/BbSelectPopover/types.js +24 -0
  439. package/dist/components/BbSlider/BbSlider.vue.d.ts +13 -8
  440. package/dist/components/BbSlider/BbSlider.vue_vue_type_script_setup_true_lang.js +472 -96
  441. package/dist/components/BbSlider/types.d.ts +202 -13
  442. package/dist/components/BbSlider/types.js +26 -0
  443. package/dist/components/BbSmoothHeight/BbSmoothHeight.vue.d.ts +1 -1
  444. package/dist/components/BbSmoothHeight/BbSmoothHeight.vue_vue_type_script_setup_true_lang.js +60 -48
  445. package/dist/components/BbSmoothHeight/types.d.ts +19 -0
  446. package/dist/components/BbSmoothHeight/types.js +7 -0
  447. package/dist/components/BbSpinner/BbSpinner.vue_vue_type_script_setup_true_lang.js +27 -14
  448. package/dist/components/BbSpinner/types.d.ts +22 -1
  449. package/dist/components/BbSpinner/types.js +7 -0
  450. package/dist/components/BbSwitch/BbSwitch.vue.d.ts +7 -7
  451. package/dist/components/BbSwitch/BbSwitch.vue_vue_type_script_setup_true_lang.js +220 -78
  452. package/dist/components/BbSwitch/types.d.ts +25 -10
  453. package/dist/components/BbSwitch/types.js +5 -0
  454. package/dist/components/BbSwitchGroup/BbSwitchGroup.vue.d.ts +14 -2
  455. package/dist/components/BbSwitchGroup/BbSwitchGroup.vue_vue_type_script_setup_true_lang.js +338 -90
  456. package/dist/components/BbSwitchGroup/types.d.ts +30 -7
  457. package/dist/components/BbSwitchGroup/types.js +5 -0
  458. package/dist/components/BbTable/BbTable.vue.d.ts +27 -6
  459. package/dist/components/BbTable/BbTable.vue_vue_type_script_setup_true_lang.js +2013 -685
  460. package/dist/components/BbTable/BbTableDataRow.d.ts +196 -0
  461. package/dist/components/BbTable/BbTableDataRow.js +151 -0
  462. package/dist/components/BbTable/BbTableExpandRow.d.ts +84 -0
  463. package/dist/components/BbTable/BbTableExpandRow.js +62 -0
  464. package/dist/components/BbTable/BbTableSelectToggle.d.ts +120 -0
  465. package/dist/components/BbTable/BbTableSelectToggle.js +122 -0
  466. package/dist/components/BbTable/gridWidgets.d.ts +30 -0
  467. package/dist/components/BbTable/gridWidgets.js +14 -0
  468. package/dist/components/BbTable/types.d.ts +473 -123
  469. package/dist/components/BbTable/types.js +31 -0
  470. package/dist/components/BbTable/utils.d.ts +145 -4
  471. package/dist/components/BbTable/utils.js +154 -37
  472. package/dist/components/BbTabs/BbTabs.vue.d.ts +3 -1
  473. package/dist/components/BbTabs/BbTabs.vue_vue_type_script_setup_true_lang.js +62 -26
  474. package/dist/components/BbTabs/BbTabsList.vue.d.ts +3 -10
  475. package/dist/components/BbTabs/BbTabsList.vue_vue_type_script_setup_true_lang.js +143 -81
  476. package/dist/components/BbTabs/BbTabsPanels.vue.d.ts +12 -0
  477. package/dist/components/{BbBaseSwitch/BbBaseSwitch.vue.js → BbTabs/BbTabsPanels.vue.js} +2 -2
  478. package/dist/components/BbTabs/BbTabsPanels.vue_vue_type_script_setup_true_lang.js +59 -0
  479. package/dist/components/BbTabs/BbTabsRoot.vue.d.ts +3 -1
  480. package/dist/components/BbTabs/BbTabsRoot.vue_vue_type_script_setup_true_lang.js +2 -1
  481. package/dist/components/BbTabs/types.d.ts +183 -23
  482. package/dist/components/BbTabs/types.js +34 -0
  483. package/dist/components/BbTag/BbTag.vue.d.ts +13 -10
  484. package/dist/components/BbTag/BbTag.vue_vue_type_script_setup_true_lang.js +383 -92
  485. package/dist/components/BbTag/types.d.ts +139 -14
  486. package/dist/components/BbTag/types.js +22 -0
  487. package/dist/components/BbTextInput/BbTextInput.vue.d.ts +10 -8
  488. package/dist/components/BbTextInput/BbTextInput.vue_vue_type_script_setup_true_lang.js +257 -84
  489. package/dist/components/BbTextInput/types.d.ts +168 -13
  490. package/dist/components/BbTextInput/types.js +8 -0
  491. package/dist/components/BbTextarea/BbTextarea.vue.d.ts +7 -7
  492. package/dist/components/BbTextarea/BbTextarea.vue_vue_type_script_setup_true_lang.js +291 -94
  493. package/dist/components/BbTextarea/types.d.ts +158 -14
  494. package/dist/components/BbTextarea/types.js +8 -0
  495. package/dist/components/BbTimePicker/BbTimePicker.vue.d.ts +12 -4
  496. package/dist/components/BbTimePicker/BbTimePicker.vue_vue_type_script_setup_true_lang.js +199 -122
  497. package/dist/components/BbTimePicker/types.d.ts +94 -7
  498. package/dist/components/BbTimePicker/types.js +18 -0
  499. package/dist/components/BbTimePickerInput/BbTimePickerInput.vue.d.ts +14 -4
  500. package/dist/components/BbTimePickerInput/BbTimePickerInput.vue_vue_type_script_setup_true_lang.js +749 -86
  501. package/dist/components/BbTimePickerInput/types.d.ts +171 -22
  502. package/dist/components/BbTimePickerInput/types.js +25 -0
  503. package/dist/components/BbToast/BbToast.vue_vue_type_script_setup_true_lang.js +63 -25
  504. package/dist/components/BbToast/BbToastMessage.vue.d.ts +4 -1
  505. package/dist/components/BbToast/BbToastMessage.vue_vue_type_script_setup_true_lang.js +79 -76
  506. package/dist/components/BbToast/BbToastPortal.vue.d.ts +1 -0
  507. package/dist/components/BbToast/BbToastRegion.vue.d.ts +4 -1
  508. package/dist/components/BbToast/BbToastRegion.vue_vue_type_script_setup_true_lang.js +72 -64
  509. package/dist/components/BbToast/types.d.ts +54 -1
  510. package/dist/components/BbToast/types.js +28 -0
  511. package/dist/components/BbTooltip/BbTooltip.vue_vue_type_script_setup_true_lang.js +104 -87
  512. package/dist/components/BbTooltip/types.d.ts +40 -2
  513. package/dist/components/BbTooltip/types.js +7 -0
  514. package/dist/components/BbTree/BbTree.vue.d.ts +15 -3
  515. package/dist/components/BbTree/BbTree.vue_vue_type_script_setup_true_lang.js +51 -29
  516. package/dist/components/BbTree/BbTreeLevel.vue.d.ts +1 -1
  517. package/dist/components/BbTree/BbTreeLevel.vue_vue_type_script_setup_true_lang.js +17 -16
  518. package/dist/components/BbTree/context.d.ts +9 -1
  519. package/dist/components/BbTree/types.d.ts +40 -5
  520. package/dist/components/BbTree/types.js +7 -0
  521. package/dist/components/ChipsBox/ChipsBox.vue_vue_type_script_setup_true_lang.js +46 -44
  522. package/dist/components/ChipsBox/types.d.ts +7 -0
  523. package/dist/components/ClearableButton/ClearableButton.vue_vue_type_script_setup_true_lang.js +5 -5
  524. package/dist/components/CommaBox/CommaBox.vue_vue_type_script_setup_true_lang.js +11 -7
  525. package/dist/components/CommaBox/types.d.ts +7 -0
  526. package/dist/components/{BbBaseInputContainer/BbBaseInputContainer.vue.d.ts → CommonField/CommonField.vue.d.ts} +5 -5
  527. package/dist/components/{BbBaseRadio/BbBaseRadio.vue.js → CommonField/CommonField.vue.js} +2 -2
  528. package/dist/components/CommonField/CommonField.vue_vue_type_script_setup_true_lang.js +189 -0
  529. package/dist/components/CommonField/messageHeightMatrix.d.ts +2 -0
  530. package/dist/components/{BbBaseInputContainer → CommonField}/types.d.ts +52 -16
  531. package/dist/components/{CommonInputWrapper/CommonInputWrapper.vue.d.ts → CommonFieldInput/CommonFieldInput.vue.d.ts} +5 -4
  532. package/dist/components/{BbBaseRadioGroup/BbBaseRadioGroup.vue.js → CommonFieldInput/CommonFieldInput.vue.js} +2 -2
  533. package/dist/components/CommonFieldInput/CommonFieldInput.vue_vue_type_script_setup_true_lang.js +120 -0
  534. package/dist/components/CommonFieldInput/boxBorderMatrix.d.ts +10 -0
  535. package/dist/components/{CommonInputWrapper → CommonFieldInput}/types.d.ts +27 -8
  536. package/dist/components/CommonPopover/CommonPopover.vue.d.ts +11 -2
  537. package/dist/components/CommonPopover/CommonPopover.vue_vue_type_script_setup_true_lang.js +76 -63
  538. package/dist/components/CommonPopover/types.d.ts +27 -8
  539. package/dist/components/{BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue.d.ts → CommonTimeSelector/CommonTimeSelector.vue.d.ts} +21 -2
  540. package/dist/components/{BbBaseColorPalette/BbBaseColorPalette.vue.js → CommonTimeSelector/CommonTimeSelector.vue.js} +2 -2
  541. package/dist/components/CommonTimeSelector/CommonTimeSelector.vue_vue_type_script_setup_true_lang.js +232 -0
  542. package/dist/components/CommonTimeSelector/types.d.ts +6 -0
  543. package/dist/components/FlatListBox/FlatListBox.vue.d.ts +5 -1
  544. package/dist/components/FlatListBox/FlatListBox.vue_vue_type_script_setup_true_lang.js +165 -95
  545. package/dist/components/FlatListBox/types.d.ts +24 -2
  546. package/dist/components/GroupedListBox/GroupedListBox.vue.d.ts +5 -1
  547. package/dist/components/GroupedListBox/GroupedListBox.vue_vue_type_script_setup_true_lang.js +217 -134
  548. package/dist/components/GroupedListBox/types.d.ts +24 -2
  549. package/dist/components/ListBox/ListBox.vue.d.ts +5 -1
  550. package/dist/components/ListBox/ListBox.vue_vue_type_script_setup_true_lang.js +95 -69
  551. package/dist/components/ListBox/types.d.ts +24 -2
  552. package/dist/components/OptionsContainer/OptionsContainer.vue.d.ts +1 -1
  553. package/dist/components/OptionsContainer/OptionsContainer.vue_vue_type_script_setup_true_lang.js +109 -37
  554. package/dist/components/OptionsContainer/types.d.ts +53 -9
  555. package/dist/components/Transitions/ScaleFade.vue_vue_type_script_setup_true_lang.js +8 -8
  556. package/dist/components/Transitions/Slide.vue.js +1 -1
  557. package/dist/composables/useBaseOptions.d.ts +12 -1
  558. package/dist/composables/useBaseOptions.js +77 -37
  559. package/dist/composables/useBbConfig.d.ts +27 -6
  560. package/dist/composables/useBbConfig.js +8 -2
  561. package/dist/composables/useBbDropdownContext.d.ts +5 -0
  562. package/dist/composables/useBbFormContext.d.ts +131 -8
  563. package/dist/composables/useBbFormContext.js +49 -30
  564. package/dist/composables/useBbFormField.d.ts +40 -0
  565. package/dist/composables/useBbFormField.js +39 -0
  566. package/dist/composables/useBbTableContext.d.ts +45 -1
  567. package/dist/composables/useBbTableContext.js +93 -87
  568. package/dist/composables/useBbTabsContext.d.ts +15 -9
  569. package/dist/composables/useBbTabsContext.js +121 -90
  570. package/dist/composables/useClosingInert.d.ts +4 -4
  571. package/dist/composables/useCoarsePointer.js +7 -10
  572. package/dist/composables/useCoherence.js +1 -1
  573. package/dist/composables/useConfig.d.ts +59 -0
  574. package/dist/composables/useConfig.js +15 -0
  575. package/dist/composables/useConfirm.d.ts +39 -7
  576. package/dist/composables/useConfirm.js +50 -41
  577. package/dist/composables/useEscapeStackEntry.d.ts +13 -0
  578. package/dist/composables/useEscapeStackEntry.js +16 -0
  579. package/dist/composables/useFormBinding.d.ts +116 -0
  580. package/dist/composables/useFormBinding.js +34 -0
  581. package/dist/composables/useHydrated.d.ts +18 -0
  582. package/dist/composables/useHydrated.js +13 -7
  583. package/dist/composables/useId.d.ts +4 -3
  584. package/dist/composables/useId.js +1 -7
  585. package/dist/composables/useItemsGetter.d.ts +11 -0
  586. package/dist/composables/useItemsGetter.js +44 -18
  587. package/dist/composables/useKeyboardInset.d.ts +28 -0
  588. package/dist/composables/useKeyboardInset.js +32 -0
  589. package/dist/composables/useLocale.js +10 -7
  590. package/dist/composables/useMobile.js +7 -10
  591. package/dist/composables/usePassthrough.d.ts +228 -0
  592. package/dist/composables/usePassthrough.js +247 -0
  593. package/dist/composables/usePrefill.d.ts +22 -2
  594. package/dist/composables/usePrefill.js +35 -19
  595. package/dist/composables/useSafeAreaInternal.js +1 -1
  596. package/dist/composables/useSegmentedFields.d.ts +2 -2
  597. package/dist/composables/useSsrState.d.ts +20 -0
  598. package/dist/composables/useSsrState.js +13 -0
  599. package/dist/composables/useTableWidthContext.d.ts +24 -4
  600. package/dist/composables/useTableWidthContext.js +31 -28
  601. package/dist/composables/useToast.d.ts +18 -1
  602. package/dist/composables/useToast.js +31 -18
  603. package/dist/composables/useToggleInput.d.ts +44 -0
  604. package/dist/composables/useToggleInput.js +39 -0
  605. package/dist/composables/useViewportWidth.d.ts +5 -25
  606. package/dist/composables/useViewportWidth.js +14 -7
  607. package/dist/deprecation/ai-deprecations.json.d.ts +1977 -289
  608. package/dist/deprecation/ai-deprecations.json.js +1 -1
  609. package/dist/deprecation/removedProps.js +9 -4
  610. package/dist/directives/bbDropdown.d.ts +15 -4
  611. package/dist/directives/bbDropdown.js +31 -9
  612. package/dist/directives/bbTooltip.d.ts +6 -0
  613. package/dist/directives/createPopoverDirective.d.ts +62 -0
  614. package/dist/directives/createPopoverDirective.js +92 -37
  615. package/dist/i18n/index.d.ts +10 -16
  616. package/dist/i18n/locales/cs.json +9 -5
  617. package/dist/i18n/locales/da.json +9 -5
  618. package/dist/i18n/locales/de.json +9 -5
  619. package/dist/i18n/locales/el.json +9 -5
  620. package/dist/i18n/locales/en.json +9 -5
  621. package/dist/i18n/locales/es.json +9 -5
  622. package/dist/i18n/locales/fi.json +9 -5
  623. package/dist/i18n/locales/fr.json +9 -5
  624. package/dist/i18n/locales/hu.json +9 -5
  625. package/dist/i18n/locales/it.json +9 -5
  626. package/dist/i18n/locales/ja.json +9 -5
  627. package/dist/i18n/locales/ko.json +9 -5
  628. package/dist/i18n/locales/nb.json +9 -5
  629. package/dist/i18n/locales/nl.json +9 -5
  630. package/dist/i18n/locales/pl.json +9 -5
  631. package/dist/i18n/locales/pt.json +9 -5
  632. package/dist/i18n/locales/ro.json +9 -5
  633. package/dist/i18n/locales/ru.json +9 -5
  634. package/dist/i18n/locales/sv.json +9 -5
  635. package/dist/i18n/locales/tr.json +9 -5
  636. package/dist/i18n/locales/uk.json +9 -5
  637. package/dist/i18n/locales/zh-cn.json +9 -5
  638. package/dist/icon-scan.d.ts +276 -0
  639. package/dist/icon-scan.js +485 -0
  640. package/dist/icons-whitelist.d.ts +5 -4
  641. package/dist/index.d.ts +40 -21
  642. package/dist/index.js +78 -71
  643. package/dist/llms-full.txt +61164 -27972
  644. package/dist/llms-medium.txt +1482 -366
  645. package/dist/llms.txt +32 -15
  646. package/dist/locale-blueprint.json +9 -5
  647. package/dist/nuxt-auto-imports.d.ts +76 -0
  648. package/dist/nuxt-auto-imports.js +32 -0
  649. package/dist/nuxt-module.d.ts +30 -15
  650. package/dist/nuxt.js +35 -9
  651. package/dist/passthrough-deduper.js +5 -0
  652. package/dist/plugin.d.ts +10 -1
  653. package/dist/plugin.js +29 -19
  654. package/dist/project-dts.d.ts +84 -0
  655. package/dist/project-dts.js +170 -0
  656. package/dist/reset.css +1 -1
  657. package/dist/runtime/nuxt-plugin.js +34 -21
  658. package/dist/styles.css +3 -2
  659. package/dist/types/AlertVariant.d.ts +10 -1
  660. package/dist/types/BadgeVariant.d.ts +16 -5
  661. package/dist/types/ButtonVariant.d.ts +12 -1
  662. package/dist/types/ColumnName.d.ts +30 -3
  663. package/dist/types/CommonProps.d.ts +2 -2
  664. package/dist/types/Config.d.ts +94 -1
  665. package/dist/types/ConfirmVariant.d.ts +8 -1
  666. package/dist/types/DropdownItemVariant.d.ts +8 -1
  667. package/dist/types/FieldLayout.d.ts +32 -0
  668. package/dist/types/IndicatorVariant.d.ts +11 -1
  669. package/dist/types/InputVariant.d.ts +30 -0
  670. package/dist/types/ItemProps.d.ts +50 -0
  671. package/dist/types/Option.d.ts +6 -0
  672. package/dist/types/PtScope.d.ts +15 -0
  673. package/dist/types/RegistryKey.d.ts +10 -0
  674. package/dist/types/TabsVariant.d.ts +25 -0
  675. package/dist/types/ToastVariant.d.ts +12 -2
  676. package/dist/types/TooltipVariant.d.ts +8 -1
  677. package/dist/types/passthrough.d.ts +362 -0
  678. package/dist/types/passthrough.js +78 -0
  679. package/dist/types/ptComponentMap.d.ts +62 -0
  680. package/dist/utilities/functions/hasVnodeListener.d.ts +16 -0
  681. package/dist/utilities/functions/hasVnodeListener.js +12 -0
  682. package/dist/utilities/functions/isImeComposing.d.ts +7 -0
  683. package/dist/utilities/functions/isImeComposing.js +4 -0
  684. package/dist/utilities/functions/itemProps.d.ts +46 -0
  685. package/dist/utilities/functions/itemProps.js +47 -0
  686. package/dist/utilities/functions/slotKey.d.ts +13 -8
  687. package/dist/utilities/functions/slotKey.js +78 -2
  688. package/dist/utilities/functions/snapToStep.js +2 -1
  689. package/dist/utilities/functions/toggleInput.d.ts +98 -0
  690. package/dist/utilities/functions/toggleInput.js +56 -0
  691. package/dist/utilities/functions/warnRemovedAttrs.d.ts +27 -1
  692. package/dist/utilities/functions/warnRemovedAttrs.js +75 -14
  693. package/dist/utilities/misc/listboxMetrics.d.ts +9 -3
  694. package/dist/utilities/misc/listboxMetrics.js +5 -2
  695. package/dist/utilities/misc/ssrStateInjectionKey.d.ts +42 -0
  696. package/dist/utilities/misc/ssrStateInjectionKey.js +4 -0
  697. package/dist/utils/cssLayers.d.ts +91 -0
  698. package/dist/utils/cssLayers.js +43 -0
  699. package/dist/utils/injectLibraryStyles.d.ts +3 -1
  700. package/dist/utils/injectLibraryStyles.js +24 -23
  701. package/dist/utils/overlayEscapeStack.d.ts +10 -0
  702. package/dist/utils/overlayEscapeStack.js +5 -3
  703. package/dist/utils/passthrough.d.ts +67 -0
  704. package/dist/utils/passthrough.js +100 -0
  705. package/dist/utils/passthroughDeduper.d.ts +2 -0
  706. package/dist/utils/ptScope.d.ts +8 -0
  707. package/dist/utils/ptScope.js +4 -0
  708. package/dist/utils/versionCheck.d.ts +19 -0
  709. package/dist/utils/versionCheck.js +18 -0
  710. package/dist/vite-plugin.d.ts +301 -53
  711. package/dist/vite.js +547 -375
  712. package/llms.txt +33 -16
  713. package/package.json +49 -27
  714. package/scripts/lib/check-fix.mjs +129 -0
  715. package/scripts/lib/component-attr-targets.ts +123 -0
  716. package/scripts/lib/component-tree.ts +648 -0
  717. package/scripts/lib/css-class-check.mjs +326 -0
  718. package/scripts/lib/css-class-surface.mjs +292 -0
  719. package/scripts/lib/css-color-resolve.mjs +172 -0
  720. package/scripts/lib/css-local-check.mjs +267 -0
  721. package/scripts/lib/design-token-manifest.mjs +499 -0
  722. package/scripts/lib/doc-sections.mjs +248 -0
  723. package/scripts/lib/ensure-manifest.mjs +28 -5
  724. package/scripts/lib/eslint-disable.mjs +141 -0
  725. package/scripts/lib/eslint-plugin.d.ts +64 -1
  726. package/scripts/lib/eslint-plugin.mjs +1285 -30
  727. package/scripts/lib/hand-imported-styles.mjs +326 -0
  728. package/scripts/lib/hand-roll-hints.mjs +50 -6
  729. package/scripts/lib/html-attributes.mjs +353 -0
  730. package/scripts/lib/local-components.mjs +177 -0
  731. package/scripts/lib/mcp-config.mjs +87 -58
  732. package/scripts/lib/migrate-fix.mjs +62 -3
  733. package/scripts/lib/project-variant-dts.mjs +122 -0
  734. package/scripts/lib/public-type-exports.mjs +273 -0
  735. package/scripts/lib/slot-key.mjs +147 -0
  736. package/scripts/lib/slot-renames.mjs +46 -0
  737. package/scripts/lib/squashed-slot-words.mjs +133 -0
  738. package/scripts/lib/validate-bb-markup.mjs +2213 -76
  739. package/scripts/lib/wrapper-props.mjs +188 -0
  740. package/dist/ai/BbBaseCheckbox.md +0 -49
  741. package/dist/ai/BbBaseCheckboxGroup.md +0 -64
  742. package/dist/ai/BbBaseColorInput.md +0 -65
  743. package/dist/ai/BbBaseColorPalette.md +0 -39
  744. package/dist/ai/BbBaseDatePicker.md +0 -43
  745. package/dist/ai/BbBaseDatePickerInput.md +0 -73
  746. package/dist/ai/BbBaseInputContainer.md +0 -48
  747. package/dist/ai/BbBaseNumberInput.md +0 -71
  748. package/dist/ai/BbBaseRadio.md +0 -46
  749. package/dist/ai/BbBaseRadioGroup.md +0 -64
  750. package/dist/ai/BbBaseRating.md +0 -52
  751. package/dist/ai/BbBaseSelect.md +0 -88
  752. package/dist/ai/BbBaseSlider.md +0 -56
  753. package/dist/ai/BbBaseSwitch.md +0 -49
  754. package/dist/ai/BbBaseSwitchGroup.md +0 -64
  755. package/dist/ai/BbBaseTag.md +0 -68
  756. package/dist/ai/BbBaseTextInput.md +0 -75
  757. package/dist/ai/BbBaseTextarea.md +0 -62
  758. package/dist/ai/BbBaseTimePickerInput.md +0 -62
  759. package/dist/ai/BbTabsPanes.md +0 -27
  760. package/dist/ai/CommonInputWrapper.md +0 -42
  761. package/dist/ai/source/BbBaseCheckbox.md +0 -461
  762. package/dist/ai/source/BbBaseCheckboxGroup.md +0 -554
  763. package/dist/ai/source/BbBaseColorInput.md +0 -431
  764. package/dist/ai/source/BbBaseColorPalette.md +0 -942
  765. package/dist/ai/source/BbBaseDatePicker.md +0 -1448
  766. package/dist/ai/source/BbBaseDatePickerInput.md +0 -1940
  767. package/dist/ai/source/BbBaseNumberInput.md +0 -617
  768. package/dist/ai/source/BbBaseRadio.md +0 -381
  769. package/dist/ai/source/BbBaseRadioGroup.md +0 -539
  770. package/dist/ai/source/BbBaseRating.md +0 -607
  771. package/dist/ai/source/BbBaseSelect.md +0 -945
  772. package/dist/ai/source/BbBaseSlider.md +0 -1144
  773. package/dist/ai/source/BbBaseSwitch.md +0 -246
  774. package/dist/ai/source/BbBaseSwitchGroup.md +0 -302
  775. package/dist/ai/source/BbBaseTag.md +0 -694
  776. package/dist/ai/source/BbBaseTextInput.md +0 -511
  777. package/dist/ai/source/BbBaseTextarea.md +0 -504
  778. package/dist/ai/source/BbBaseTimePickerInput.md +0 -1037
  779. package/dist/ai/source/BbTabsPanes.md +0 -377
  780. package/dist/ai/source/CommonInputWrapper.md +0 -584
  781. package/dist/alert-variants.d.ts +0 -19
  782. package/dist/assets/svgs/sort.svg_raw.js +0 -4
  783. package/dist/badge-variants.d.ts +0 -19
  784. package/dist/button-variants.d.ts +0 -21
  785. package/dist/components/BbBadge/BadgeAppendIcon.vue.d.ts +0 -3
  786. package/dist/components/BbBadge/BadgeAppendIcon.vue.js +0 -5
  787. package/dist/components/BbBadge/BadgeAppendIcon.vue_vue_type_script_setup_true_lang.js +0 -22
  788. package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue.d.ts +0 -40
  789. package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue.js +0 -6
  790. package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue_vue_type_script_setup_true_lang.js +0 -145
  791. package/dist/components/BbBaseCheckbox/types.d.ts +0 -224
  792. package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue.d.ts +0 -19
  793. package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue.js +0 -6
  794. package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue_vue_type_script_setup_true_lang.js +0 -190
  795. package/dist/components/BbBaseCheckboxGroup/types.d.ts +0 -257
  796. package/dist/components/BbBaseColorInput/BbBaseColorInput.vue.d.ts +0 -43
  797. package/dist/components/BbBaseColorInput/BbBaseColorInput.vue.js +0 -6
  798. package/dist/components/BbBaseColorInput/BbBaseColorInput.vue_vue_type_script_setup_true_lang.js +0 -184
  799. package/dist/components/BbBaseColorInput/types.d.ts +0 -219
  800. package/dist/components/BbBaseColorPalette/BbBaseColorPalette.vue.d.ts +0 -13
  801. package/dist/components/BbBaseColorPalette/BbBaseColorPalette.vue_vue_type_script_setup_true_lang.js +0 -395
  802. package/dist/components/BbBaseColorPalette/types.d.ts +0 -40
  803. package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue.d.ts +0 -20
  804. package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue.js +0 -6
  805. package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue_vue_type_script_setup_true_lang.js +0 -407
  806. package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue.d.ts +0 -47
  807. package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue.js +0 -5
  808. package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue_vue_type_script_setup_true_lang.js +0 -318
  809. package/dist/components/BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue.js +0 -5
  810. package/dist/components/BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue_vue_type_script_setup_true_lang.js +0 -115
  811. package/dist/components/BbBaseDatePicker/BbBaseDatePickerYearSelector.vue.js +0 -5
  812. package/dist/components/BbBaseDatePicker/BbBaseDatePickerYearSelector.vue_vue_type_script_setup_true_lang.js +0 -116
  813. package/dist/components/BbBaseDatePicker/types.d.ts +0 -108
  814. package/dist/components/BbBaseDatePicker/useDatePickerContext.js +0 -11
  815. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue.d.ts +0 -31
  816. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue.js +0 -6
  817. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue_vue_type_script_setup_true_lang.js +0 -737
  818. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue.js +0 -6
  819. package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue_vue_type_script_setup_true_lang.js +0 -204
  820. package/dist/components/BbBaseDatePickerInput/types.d.ts +0 -325
  821. package/dist/components/BbBaseInputContainer/BbBaseInputContainer.vue.js +0 -6
  822. package/dist/components/BbBaseInputContainer/BbBaseInputContainer.vue_vue_type_script_setup_true_lang.js +0 -190
  823. package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue.d.ts +0 -52
  824. package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue.js +0 -6
  825. package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue_vue_type_script_setup_true_lang.js +0 -215
  826. package/dist/components/BbBaseNumberInput/types.d.ts +0 -211
  827. package/dist/components/BbBaseRadio/BbBaseRadio.vue.d.ts +0 -33
  828. package/dist/components/BbBaseRadio/BbBaseRadio.vue_vue_type_script_setup_true_lang.js +0 -113
  829. package/dist/components/BbBaseRadio/types.d.ts +0 -179
  830. package/dist/components/BbBaseRadioGroup/BbBaseRadioGroup.vue.d.ts +0 -19
  831. package/dist/components/BbBaseRadioGroup/BbBaseRadioGroup.vue_vue_type_script_setup_true_lang.js +0 -179
  832. package/dist/components/BbBaseRadioGroup/types.d.ts +0 -223
  833. package/dist/components/BbBaseRating/BbBaseRating.vue.d.ts +0 -38
  834. package/dist/components/BbBaseRating/BbBaseRating.vue.js +0 -6
  835. package/dist/components/BbBaseRating/BbBaseRating.vue_vue_type_script_setup_true_lang.js +0 -192
  836. package/dist/components/BbBaseRating/types.d.ts +0 -176
  837. package/dist/components/BbBaseSelect/BbBaseSelect.vue.d.ts +0 -19
  838. package/dist/components/BbBaseSelect/BbBaseSelect.vue.js +0 -6
  839. package/dist/components/BbBaseSelect/BbBaseSelect.vue_vue_type_script_setup_true_lang.js +0 -311
  840. package/dist/components/BbBaseSelect/types.d.ts +0 -297
  841. package/dist/components/BbBaseSlider/BbBaseSlider.vue.d.ts +0 -35
  842. package/dist/components/BbBaseSlider/BbBaseSlider.vue.js +0 -6
  843. package/dist/components/BbBaseSlider/BbBaseSlider.vue_vue_type_script_setup_true_lang.js +0 -340
  844. package/dist/components/BbBaseSlider/types.d.ts +0 -200
  845. package/dist/components/BbBaseSwitch/BbBaseSwitch.vue.d.ts +0 -35
  846. package/dist/components/BbBaseSwitch/BbBaseSwitch.vue_vue_type_script_setup_true_lang.js +0 -146
  847. package/dist/components/BbBaseSwitch/types.d.ts +0 -10
  848. package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue.d.ts +0 -19
  849. package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue.js +0 -6
  850. package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue_vue_type_script_setup_true_lang.js +0 -190
  851. package/dist/components/BbBaseSwitchGroup/types.d.ts +0 -8
  852. package/dist/components/BbBaseTag/BbBaseTag.vue.d.ts +0 -50
  853. package/dist/components/BbBaseTag/BbBaseTag.vue.js +0 -6
  854. package/dist/components/BbBaseTag/BbBaseTag.vue_vue_type_script_setup_true_lang.js +0 -266
  855. package/dist/components/BbBaseTag/types.d.ts +0 -160
  856. package/dist/components/BbBaseTextInput/BbBaseTextInput.vue.d.ts +0 -45
  857. package/dist/components/BbBaseTextInput/BbBaseTextInput.vue.js +0 -6
  858. package/dist/components/BbBaseTextInput/BbBaseTextInput.vue_vue_type_script_setup_true_lang.js +0 -200
  859. package/dist/components/BbBaseTextInput/types.d.ts +0 -209
  860. package/dist/components/BbBaseTextarea/BbBaseTextarea.vue.d.ts +0 -39
  861. package/dist/components/BbBaseTextarea/BbBaseTextarea.vue.js +0 -6
  862. package/dist/components/BbBaseTextarea/BbBaseTextarea.vue_vue_type_script_setup_true_lang.js +0 -187
  863. package/dist/components/BbBaseTextarea/types.d.ts +0 -170
  864. package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue.d.ts +0 -27
  865. package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue.js +0 -6
  866. package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue_vue_type_script_setup_true_lang.js +0 -519
  867. package/dist/components/BbBaseTimePickerInput/types.d.ts +0 -151
  868. package/dist/components/BbTabs/BbTabsPanes.vue.d.ts +0 -16
  869. package/dist/components/BbTabs/BbTabsPanes.vue.js +0 -6
  870. package/dist/components/BbTabs/BbTabsPanes.vue_vue_type_script_setup_true_lang.js +0 -35
  871. package/dist/components/CommonInputWrapper/CommonInputWrapper.vue.js +0 -6
  872. package/dist/components/CommonInputWrapper/CommonInputWrapper.vue_vue_type_script_setup_true_lang.js +0 -107
  873. package/dist/confirm-variants.d.ts +0 -17
  874. package/dist/dropdown-item-variants.d.ts +0 -17
  875. package/dist/indicator-variants.d.ts +0 -20
  876. package/dist/locale-registry.d.ts +0 -37
  877. package/dist/toast-variants.d.ts +0 -20
  878. package/dist/tooltip-variants.d.ts +0 -17
  879. package/dist/types/InputDirection.d.ts +0 -15
  880. package/dist/validated/BbCheckbox.vue.d.ts +0 -29
  881. package/dist/validated/BbCheckbox.vue.js +0 -5
  882. package/dist/validated/BbCheckbox.vue_vue_type_script_setup_true_lang.js +0 -75
  883. package/dist/validated/BbCheckboxGroup.vue.d.ts +0 -34
  884. package/dist/validated/BbCheckboxGroup.vue.js +0 -5
  885. package/dist/validated/BbCheckboxGroup.vue_vue_type_script_setup_true_lang.js +0 -82
  886. package/dist/validated/BbColorInput.vue.d.ts +0 -37
  887. package/dist/validated/BbColorInput.vue.js +0 -5
  888. package/dist/validated/BbColorInput.vue_vue_type_script_setup_true_lang.js +0 -75
  889. package/dist/validated/BbDatePickerInput.vue.d.ts +0 -41
  890. package/dist/validated/BbDatePickerInput.vue.js +0 -5
  891. package/dist/validated/BbDatePickerInput.vue_vue_type_script_setup_true_lang.js +0 -90
  892. package/dist/validated/BbDropzone.vue.d.ts +0 -24
  893. package/dist/validated/BbDropzone.vue.js +0 -5
  894. package/dist/validated/BbDropzone.vue_vue_type_script_setup_true_lang.js +0 -45
  895. package/dist/validated/BbForm.vue.d.ts +0 -28
  896. package/dist/validated/BbForm.vue_vue_type_script_setup_true_lang.js +0 -42
  897. package/dist/validated/BbNumberInput.vue.d.ts +0 -36
  898. package/dist/validated/BbNumberInput.vue.js +0 -5
  899. package/dist/validated/BbNumberInput.vue_vue_type_script_setup_true_lang.js +0 -72
  900. package/dist/validated/BbRadioGroup.vue.d.ts +0 -34
  901. package/dist/validated/BbRadioGroup.vue.js +0 -5
  902. package/dist/validated/BbRadioGroup.vue_vue_type_script_setup_true_lang.js +0 -78
  903. package/dist/validated/BbRating.vue.d.ts +0 -30
  904. package/dist/validated/BbRating.vue.js +0 -5
  905. package/dist/validated/BbRating.vue_vue_type_script_setup_true_lang.js +0 -63
  906. package/dist/validated/BbSelect.vue.d.ts +0 -46
  907. package/dist/validated/BbSelect.vue.js +0 -5
  908. package/dist/validated/BbSelect.vue_vue_type_script_setup_true_lang.js +0 -109
  909. package/dist/validated/BbSlider.vue.d.ts +0 -36
  910. package/dist/validated/BbSlider.vue.js +0 -5
  911. package/dist/validated/BbSlider.vue_vue_type_script_setup_true_lang.js +0 -69
  912. package/dist/validated/BbSwitch.vue.d.ts +0 -29
  913. package/dist/validated/BbSwitch.vue.js +0 -5
  914. package/dist/validated/BbSwitch.vue_vue_type_script_setup_true_lang.js +0 -75
  915. package/dist/validated/BbSwitchGroup.vue.d.ts +0 -34
  916. package/dist/validated/BbSwitchGroup.vue.js +0 -5
  917. package/dist/validated/BbSwitchGroup.vue_vue_type_script_setup_true_lang.js +0 -82
  918. package/dist/validated/BbTag.vue.d.ts +0 -36
  919. package/dist/validated/BbTag.vue.js +0 -5
  920. package/dist/validated/BbTag.vue_vue_type_script_setup_true_lang.js +0 -72
  921. package/dist/validated/BbTextInput.vue.d.ts +0 -36
  922. package/dist/validated/BbTextInput.vue.js +0 -5
  923. package/dist/validated/BbTextInput.vue_vue_type_script_setup_true_lang.js +0 -72
  924. package/dist/validated/BbTextarea.vue.d.ts +0 -36
  925. package/dist/validated/BbTextarea.vue.js +0 -5
  926. package/dist/validated/BbTextarea.vue_vue_type_script_setup_true_lang.js +0 -70
  927. package/dist/validated/BbTimePickerInput.vue.d.ts +0 -37
  928. package/dist/validated/BbTimePickerInput.vue.js +0 -5
  929. package/dist/validated/BbTimePickerInput.vue_vue_type_script_setup_true_lang.js +0 -81
  930. package/dist/validated/index.d.ts +0 -43
  931. package/dist/validated/useValidatedField.d.ts +0 -93
  932. package/dist/validated/useValidatedField.js +0 -51
  933. package/dist/validated.js +0 -21
  934. /package/dist/components/{BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue.d.ts → BbCalendar/CalendarMonthPanel.vue.d.ts} +0 -0
  935. /package/dist/components/{BbBaseDatePicker/BbBaseDatePickerYearSelector.vue.d.ts → BbCalendar/CalendarYearPanel.vue.d.ts} +0 -0
  936. /package/dist/{components/BbBaseDatePicker/typeahead.d.ts → composables/useTypeahead.d.ts} +0 -0
  937. /package/dist/{components/BbBaseDatePicker/typeahead.js → composables/useTypeahead.js} +0 -0
@@ -8,6 +8,21 @@
8
8
  - Usage rule: Prefer this component for consumer-facing implementations.
9
9
  - Implementation source (only when the contract below is not enough): [source/BbOffCanvas.md](./source/BbOffCanvas.md)
10
10
 
11
+ ## Reachable through `BbOffCanvas`
12
+
13
+ `BbOffCanvas` mounts other components (all of them: _Component tree_, near the end). These are the parts of its API that land inside them. Prefer these over `:deep()` on an inner class (allowed, unsupported: it can break on upgrade) — and never an import of an internal component.
14
+
15
+ | pt part | Lands on | In |
16
+ | --- | --- | --- |
17
+ | `pt:close` | the root of `CloseButton` | `CloseButton` _(internal)_ |
18
+
19
+ **CSS variables you can set through those parts** — declared deeper in the tree, so set one on the part that reads it (`pt:<part>="[--name:value]"`), never on `BbOffCanvas`'s root:
20
+
21
+ | Variable | Set through | Declared by | What it is |
22
+ | --- | --- | --- | --- |
23
+ | `--size` | `pt:close` | `CloseButton` | the button box — the hit target, not the glyph |
24
+ | `--p` | `pt:close` | `CloseButton` | padding inside that box; what is left of --size is the glyph |
25
+
11
26
  ## Usage & Guidelines
12
27
 
13
28
  ### When to use
@@ -35,20 +50,20 @@ width), and `side`, `draggable` and `stack-gap` are off-canvas-only.
35
50
 
36
51
  `v-model` owns visibility — there is no imperative `open()`. Bind a boolean and
37
52
  flip it. The panel dismisses itself on the header close button, the `Escape`
38
- key, and a backdrop click; the `default` slot also receives a `close` callback
39
- for buttons inside the body, and footer buttons simply set the model back to
40
- `false`.
53
+ key, and a backdrop click. The `default`, `header` and `footer` slots also
54
+ receive a `close` callback, so a footer Cancel button can call `close` — or
55
+ set the model back to `false`, which is the same thing.
41
56
 
42
57
  **A right-hand panel**
43
58
 
44
59
  ```vue
45
60
  <template>
46
61
  <div
47
- class="flex max-w-sm items-center justify-between gap-3 rounded-[var(--bb-radius)] border p-3"
62
+ class="flex max-w-sm items-center justify-between gap-3 rounded-(--bb-radius) border p-3"
48
63
  >
49
64
  <div class="min-w-0">
50
65
  <p class="m-0 text-sm font-medium">Workspace</p>
51
- <p class="m-0 text-xs text-[color:var(--bb-text-muted)]">
66
+ <p class="m-0 text-xs text-(--bb-text-muted)">
52
67
  3 updates since yesterday
53
68
  </p>
54
69
  </div>
@@ -59,7 +74,7 @@ for buttons inside the body, and footer buttons simply set the model back to
59
74
  <div class="grid gap-3 text-sm">
60
75
  <div v-for="entry in activity" :key="entry.id" class="grid gap-0.5">
61
76
  <p class="m-0">{{ entry.text }}</p>
62
- <p class="m-0 text-xs text-[color:var(--bb-text-muted)]">
77
+ <p class="m-0 text-xs text-(--bb-text-muted)">
63
78
  {{ entry.when }}
64
79
  </p>
65
80
  </div>
@@ -114,9 +129,7 @@ dimension `size` controls.
114
129
 
115
130
  ```vue
116
131
  <template>
117
- <div
118
- class="flex max-w-md flex-wrap gap-2 rounded-[var(--bb-radius)] border p-3"
119
- >
132
+ <div class="flex max-w-md flex-wrap gap-2 rounded-(--bb-radius) border p-3">
120
133
  <BbButton
121
134
  v-for="edge in edges"
122
135
  :key="edge"
@@ -161,13 +174,68 @@ header and footer stay pinned.
161
174
 
162
175
  - Use the `title` slot to restyle just the title text — it stays wired to
163
176
  `aria-labelledby` and receives the `title` prop as `text`.
164
- - Unlike `BbDialog`, the **`header` slot is fully supported here** and replaces
165
- the whole header section; it receives `titleId`, `title` and `close`, so you
166
- can build a custom header and still keep the accessible name wired through
167
- `titleId`.
177
+ - **`description`** adds one muted line under the title — the panel's subtitle,
178
+ and the only thing `aria-describedby` points at. Keep it to a sentence; the
179
+ body is deliberately not described. The `description` slot takes markup and
180
+ receives the prop as `text`. A panel without one keeps its original
181
+ single-row header.
182
+ - The **`header` slot** replaces the whole header section; it receives
183
+ `titleId`, `title` and `close`, so you can build a custom header and still
184
+ keep the accessible name wired through `titleId`. `BbDialog` supports the
185
+ same slot with the same payload, and forwards it to its adaptive sheet — the
186
+ two surfaces are symmetric here.
168
187
  - Omitting `title` (and the `header` slot) removes the header entirely — you
169
188
  then own the accessible name.
170
189
 
190
+ **A described panel (via the #description slot)**
191
+
192
+ ```vue
193
+ <template>
194
+ <BbButton
195
+ prepend:icon="lucide:user-plus"
196
+ variant="outline"
197
+ @click="open = true"
198
+ >
199
+ Invite teammate
200
+ </BbButton>
201
+ <BbOffCanvas v-model="open" side="right" title="Invite teammate">
202
+ <!-- The slot takes markup where the prop would only take a string. -->
203
+ <template #description>
204
+ They join the <strong>Northwind</strong> workspace as a viewer.
205
+ </template>
206
+ <div class="grid gap-3">
207
+ <BbTextInput
208
+ v-model="email"
209
+ compact
210
+ label="Email"
211
+ placeholder="ada@northwind.co"
212
+ type="email"
213
+ />
214
+ </div>
215
+ <template #footer>
216
+ <div class="flex justify-end gap-2">
217
+ <BbButton variant="ghost" @click="open = false">Cancel</BbButton>
218
+ <BbButton
219
+ :disabled="!email.trim()"
220
+ variant="primary"
221
+ @click="open = false"
222
+ >
223
+ Send invite
224
+ </BbButton>
225
+ </div>
226
+ </template>
227
+ </BbOffCanvas>
228
+ </template>
229
+
230
+ <script setup lang="ts">
231
+ import { ref } from 'vue';
232
+ import { BbButton, BbOffCanvas, BbTextInput } from 'bitboss-ui';
233
+
234
+ const open = ref(false);
235
+ const email = ref('');
236
+ </script>
237
+ ```
238
+
171
239
  ### A filters drawer
172
240
 
173
241
  The archetypal off-canvas: search + toggles in the `default` slot, Apply/Reset
@@ -179,11 +247,11 @@ This companion seeds typed filter state and resets it in place.
179
247
  ```vue
180
248
  <template>
181
249
  <div
182
- class="flex max-w-sm items-center justify-between gap-3 rounded-[var(--bb-radius)] border p-3"
250
+ class="flex max-w-sm items-center justify-between gap-3 rounded-(--bb-radius) border p-3"
183
251
  >
184
252
  <div class="min-w-0">
185
253
  <p class="m-0 text-sm font-medium">Invoices</p>
186
- <p class="m-0 text-xs text-[color:var(--bb-text-muted)]">
254
+ <p class="m-0 text-xs text-(--bb-text-muted)">
187
255
  {{ matchingLabel }}
188
256
  </p>
189
257
  </div>
@@ -266,10 +334,8 @@ record" action to `BbButton`'s `href` rather than a click handler.
266
334
 
267
335
  ```vue
268
336
  <template>
269
- <div class="grid max-w-sm gap-1 rounded-[var(--bb-radius)] border p-1">
270
- <p
271
- class="m-0 px-2 pt-1.5 text-xs font-medium text-[color:var(--bb-text-muted)]"
272
- >
337
+ <div class="grid max-w-sm gap-1 rounded-(--bb-radius) border p-1">
338
+ <p class="m-0 px-2 pt-1.5 text-xs font-medium text-(--bb-text-muted)">
273
339
  Members
274
340
  </p>
275
341
  <BbButton
@@ -281,12 +347,7 @@ record" action to `BbButton`'s `href` rather than a click handler.
281
347
  @click="openDetail(member)"
282
348
  >
283
349
  <span class="flex min-w-0 items-center gap-2">
284
- <BbAvatar
285
- :alt="member.name"
286
- size="32"
287
- :src="member.src"
288
- :timeout="demoAvatarTimeout"
289
- >
350
+ <BbAvatar :alt="member.name" size="32" :src="member.src">
290
351
  {{ member.initials }}
291
352
  </BbAvatar>
292
353
  <span class="truncate">{{ member.name }}</span>
@@ -296,12 +357,7 @@ record" action to `BbButton`'s `href` rather than a click handler.
296
357
  <BbOffCanvas v-model="open" side="right" size="sm" :title="selected?.name">
297
358
  <div v-if="selected" class="grid gap-4 text-sm">
298
359
  <div class="flex items-start gap-3">
299
- <BbAvatar
300
- :alt="selected.name"
301
- size="56"
302
- :src="selected.src"
303
- :timeout="demoAvatarTimeout"
304
- >
360
+ <BbAvatar :alt="selected.name" size="56" :src="selected.src">
305
361
  {{ selected.initials }}
306
362
  </BbAvatar>
307
363
  <div class="grid min-w-0 gap-1.5">
@@ -317,7 +373,7 @@ record" action to `BbButton`'s `href` rather than a click handler.
317
373
  :key="row.label"
318
374
  class="flex items-baseline justify-between gap-3"
319
375
  >
320
- <dt class="shrink-0 text-xs text-[color:var(--bb-text-muted)]">
376
+ <dt class="shrink-0 text-xs text-(--bb-text-muted)">
321
377
  {{ row.label }}
322
378
  </dt>
323
379
  <dd class="m-0 truncate text-right">{{ row.value }}</dd>
@@ -341,10 +397,18 @@ record" action to `BbButton`'s `href` rather than a click handler.
341
397
  <script setup lang="ts">
342
398
  import { computed, ref } from 'vue';
343
399
  import { BbAvatar, BbBadge, BbButton, BbOffCanvas } from 'bitboss-ui';
344
- import {
345
- demoAvatarTimeout,
346
- demoFaces,
347
- } from '@/components/BbAvatar/examples/demoAvatars';
400
+
401
+ // Self-contained demo data: each portrait is an inline SVG data URI, so the
402
+ // example loads nothing over the network. Any image URL works here; swap in
403
+ // your own.
404
+ const face = (bg: string, fg: string) =>
405
+ `data:image/svg+xml,${encodeURIComponent(
406
+ `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" fill="${bg}"/><circle cx="32" cy="25" r="11" fill="${fg}"/><path d="M11 64c1-13 10-20 21-20s20 7 21 20z" fill="${fg}"/></svg>`
407
+ )}`;
408
+ const faces = {
409
+ ada: face('#fde2d4', '#b45a3c'),
410
+ grace: face('#dbeafe', '#1e4fa8'),
411
+ };
348
412
 
349
413
  type MemberStatus = 'Active' | 'Away';
350
414
 
@@ -372,7 +436,7 @@ const members: Member[] = [
372
436
  team: 'Platform',
373
437
  status: 'Active',
374
438
  statusVariant: 'soft-green',
375
- src: demoFaces.ada,
439
+ src: faces.ada,
376
440
  },
377
441
  {
378
442
  id: 2,
@@ -384,7 +448,7 @@ const members: Member[] = [
384
448
  team: 'Billing',
385
449
  status: 'Away',
386
450
  statusVariant: 'soft-amber',
387
- src: demoFaces.grace,
451
+ src: faces.grace,
388
452
  },
389
453
  ];
390
454
 
@@ -412,18 +476,18 @@ const openDetail = (member: Member) => {
412
476
  Canonical source: ai/guides/design-language.md § Using color. -->
413
477
  <style>
414
478
  .bb-badge.bb-badge--soft-green {
415
- --accent: #16a34a;
479
+ --accent: var(--bb-success);
416
480
  }
417
481
  .bb-badge.bb-badge--soft-amber {
418
- --accent: #d97706;
482
+ --accent: var(--bb-warn);
419
483
  }
420
484
  .bb-badge.bb-badge--soft-green,
421
485
  .bb-badge.bb-badge--soft-amber {
422
486
  --bg: color-mix(in oklab, var(--accent) 15%, var(--bb-panel));
423
- --color: color-mix(in oklab, var(--accent) 80%, var(--bb-text));
424
- --border-width: 1px;
487
+ --fg: color-mix(in oklab, var(--accent) 80%, var(--bb-text));
488
+ --bw: 1px;
425
489
  --border-color: color-mix(in oklab, var(--accent) 25%, var(--bb-panel));
426
- --ring: color-mix(in oklab, var(--accent) 45%, transparent);
490
+ --ring-color: color-mix(in oklab, var(--accent) 45%, transparent);
427
491
  }
428
492
  </style>
429
493
  ```
@@ -442,11 +506,11 @@ treatment in the list, and account/sign-out sit in the footer.
442
506
  ```vue
443
507
  <template>
444
508
  <div
445
- class="flex max-w-sm items-center justify-between gap-2 rounded-[var(--bb-radius)] border p-2"
509
+ class="flex max-w-sm items-center justify-between gap-2 rounded-(--bb-radius) border p-2"
446
510
  >
447
511
  <div class="min-w-0">
448
512
  <p class="m-0 truncate text-sm font-medium">Acme Billing</p>
449
- <p class="m-0 text-xs text-[color:var(--bb-text-muted)]">Workspace</p>
513
+ <p class="m-0 text-xs text-(--bb-text-muted)">Workspace</p>
450
514
  </div>
451
515
  <BbButton
452
516
  aria-label="Open navigation"
@@ -459,9 +523,7 @@ treatment in the list, and account/sign-out sit in the footer.
459
523
  </div>
460
524
  <BbOffCanvas v-model="open" side="left" size="xs" title="Acme Billing">
461
525
  <nav aria-label="Primary" class="grid gap-1">
462
- <p
463
- class="m-0 px-1 pb-0.5 text-xs font-medium text-[color:var(--bb-text-muted)]"
464
- >
526
+ <p class="m-0 px-1 pb-0.5 text-xs font-medium text-(--bb-text-muted)">
465
527
  Navigate
466
528
  </p>
467
529
  <BbButton
@@ -566,16 +628,37 @@ Set `draggable` to let the user flick the panel toward its edge to dismiss; a
566
628
  grab handle appears on the inner edge as the affordance. A draggable,
567
629
  `auto`-sized bottom panel is the canonical mobile sheet.
568
630
 
569
- The gesture is physical, not just a tap target:
570
-
571
- - Dragging past **a quarter of the panel's extent**, or a fast **flick toward
572
- the edge**, dismisses it; a shorter drag springs back to fully open.
573
- - On a vertical (top/bottom) sheet with a scrollable body, the drag **hands off
574
- to native scrolling** first — you only start dragging the sheet once the body
575
- is scrolled to its edge, so scrolling a long sheet never accidentally closes
576
- it.
577
- - `persistent` / `disabled` still win: a drag that would dismiss instead plays
631
+ The gesture is powered by VueUse `useSwipe` with a **fixed pixel threshold**
632
+ (not a fraction of the panel height), so a tall filters sheet and a short menu
633
+ dismiss with the same motion:
634
+
635
+ - Swiping **about 50px toward the exit edge** dismisses it; a shorter swipe
636
+ springs back. Motion matches Vaul: the sheet exits on inline `transform`
637
+ (iOS easing, 500ms) while the backdrop fades on the same clock. Styles stay
638
+ frozen off-screen until the normal close wait finishes, so `dialog.close()`
639
+ does not flash the panel or jump the blur. Escape / backdrop / × still use
640
+ the open/close `translate` path.
641
+ - Only travel on the dismiss axis counts — a mostly horizontal flick on a short
642
+ bottom sheet does not latch or close it.
643
+ - On a vertical sheet with a scrollable body, the swipe **hands off to native
644
+ scrolling** first — you only drag the sheet once every scrollable ancestor
645
+ under the finger is at its dismiss edge (latched at touchstart, so a row
646
+ button and the empty panel chrome behave the same). A downward flick that
647
+ starts by scrolling _into_ the list stays a scroll for the rest of the
648
+ gesture; once the sheet is following the finger, reversing back to rest
649
+ does not start a scroll — lift to cancel.
650
+ - `persistent` / `disabled` still win: a swipe that would dismiss instead plays
578
651
  the "deny" nudge and springs back.
652
+ - Content with drag interactions of its own (a colour square, a slider, a
653
+ signature pad) opts out with `data-bb-no-drag`: a gesture that starts inside
654
+ such an element never drags the panel. BbColorPalette marks its canvas and
655
+ sliders this way.
656
+ - The handle's box is three tokens on the panel root, not a part:
657
+ `--handle-w` (its length along the edge — `36px`; on a left / right panel
658
+ the axes swap and this is its height), `--handle-h` (its thickness —
659
+ `4px`) and `--handle-bg` (its fill — `var(--bb-border)`). Set them on the
660
+ root — `pt:root="[--handle-w:40px] [--handle-h:6px]"` here, or `pt:sheet`
661
+ on a popover, select or picker that becomes this sheet on a phone.
579
662
 
580
663
  **A draggable bottom sheet**
581
664
 
@@ -602,28 +685,36 @@ The gesture is physical, not just a tap target:
602
685
 
603
686
  Give panels the same `stack` name and they step back behind one another as you
604
687
  drill in: opening a child shifts the parent inward by `stack-gap` (default
605
- `60`px), leaving a peeking band of it visible so the hierarchy reads clearly.
688
+ `60`px), leaving a peeking band of it visible so the hierarchy reads clearly. When the child closes, the parent steps forward again in the same motion, in lockstep with the child sliding out.
606
689
  Closing the child brings the parent forward. Panels with **different names (or
607
690
  none) are independent** and simply layer by open order.
608
691
 
609
- Only the top two open panels keep their dimmed/blurred backdrop; deeper ones go
610
- transparent, so a three-deep stack does not stack three backdrops. Use a stack
611
- for master → detail flows where the trail should stay visible; if the parent
612
- should be fully replaced instead, that is what `BbDialog`'s `stack` (which swaps
613
- rather than peeks) is for.
692
+ Each stacked panel dims the panels beneath it (via `--bb-overlay-stacked`, the same
693
+ dim as `--bb-overlay` by default); only the bottom-most blurs. So a child opening
694
+ over a parent visibly darkens the parent, closing it fades that dim out with it,
695
+ and the bottom panel's blurred backdrop is never handed off — nothing behind
696
+ brightens or re-blurs, and a three-deep stack still costs one blur pass. Set
697
+ `--bb-overlay-stacked: transparent` for a single dim under the whole pile.
698
+ Backdrop layering follows **open order across all off-canvases**, whatever their
699
+ `stack` name — the name only controls the step-back. Use a stack for master →
700
+ detail flows where the trail should stay visible; if the parent should be fully
701
+ replaced instead, that is what `BbDialog`'s `stack` (which swaps rather than
702
+ peeks) is for.
703
+
704
+ Known limitation: a `BbDialog` pile and a `BbOffCanvas` pile keep separate
705
+ registries, so an off-canvas opened over a dialog is the bottom of its own pile
706
+ and paints its own blur (and vice versa). Mixed piles are out of scope.
614
707
 
615
708
  **Master → detail, stacked**
616
709
 
617
710
  ```vue
618
711
  <template>
619
712
  <div
620
- class="flex max-w-sm items-center justify-between gap-3 rounded-[var(--bb-radius)] border p-3"
713
+ class="flex max-w-sm items-center justify-between gap-3 rounded-(--bb-radius) border p-3"
621
714
  >
622
715
  <div class="min-w-0">
623
716
  <p class="m-0 text-sm font-medium">Team</p>
624
- <p class="m-0 text-xs text-[color:var(--bb-text-muted)]">
625
- Drill into a member
626
- </p>
717
+ <p class="m-0 text-xs text-(--bb-text-muted)">Drill into a member</p>
627
718
  </div>
628
719
  <BbButton variant="outline" @click="listOpen = true">
629
720
  Team members
@@ -658,13 +749,11 @@ rather than peeks) is for.
658
749
  >
659
750
  <div v-if="selected" class="grid gap-2 text-sm">
660
751
  <p class="m-0">
661
- <span class="text-xs text-[color:var(--bb-text-muted)]">Role</span
662
- ><br />
752
+ <span class="text-xs text-(--bb-text-muted)">Role</span><br />
663
753
  {{ selected.role }}
664
754
  </p>
665
755
  <p class="m-0">
666
- <span class="text-xs text-[color:var(--bb-text-muted)]">Joined</span
667
- ><br />
756
+ <span class="text-xs text-(--bb-text-muted)">Joined</span><br />
668
757
  {{ selected.joined }}
669
758
  </p>
670
759
  </div>
@@ -743,11 +832,11 @@ half-typed edits never survive a close.
743
832
  ```vue
744
833
  <template>
745
834
  <div
746
- class="flex max-w-sm items-center justify-between gap-3 rounded-[var(--bb-radius)] border p-3"
835
+ class="flex max-w-sm items-center justify-between gap-3 rounded-(--bb-radius) border p-3"
747
836
  >
748
837
  <div class="min-w-0">
749
838
  <p class="m-0 text-sm font-medium">INV-2043</p>
750
- <p class="m-0 truncate text-xs text-[color:var(--bb-text-muted)]">
839
+ <p class="m-0 truncate text-xs text-(--bb-text-muted)">
751
840
  {{ saved }}
752
841
  </p>
753
842
  </div>
@@ -794,6 +883,10 @@ Every dismissal path is governed by two props:
794
883
  - `disabled` — same guard, different intent: the surface is busy (a save in
795
884
  flight). Combine with disabling your footer actions.
796
885
 
886
+ Under `prefers-reduced-motion: reduce` the panel appears and leaves in place
887
+ with a fade instead of sliding, and the deny nudge becomes a flash of the focus
888
+ ring. A drag you perform yourself still follows your finger.
889
+
797
890
  Two more knobs shape the surface:
798
891
 
799
892
  - `hide-close` removes the header close button. (The close button is shown by
@@ -814,11 +907,11 @@ genuine click that starts and ends on the backdrop (≤4px travel) does.
814
907
  ```vue
815
908
  <template>
816
909
  <div
817
- class="flex max-w-sm items-center justify-between gap-3 rounded-[var(--bb-radius)] border p-3"
910
+ class="flex max-w-sm items-center justify-between gap-3 rounded-(--bb-radius) border p-3"
818
911
  >
819
912
  <div class="min-w-0">
820
913
  <p class="m-0 text-sm font-medium">PR #1842</p>
821
- <p class="m-0 text-xs text-[color:var(--bb-text-muted)]">
914
+ <p class="m-0 text-xs text-(--bb-text-muted)">
822
915
  Needs a reviewer before merge
823
916
  </p>
824
917
  </div>
@@ -839,7 +932,7 @@ genuine click that starts and ends on the backdrop (≤4px travel) does.
839
932
  label="Reviewer"
840
933
  placeholder="Name or email"
841
934
  />
842
- <p class="m-0 text-xs text-[color:var(--bb-text-muted)]">
935
+ <p class="m-0 text-xs text-(--bb-text-muted)">
843
936
  Backdrop and Escape stay locked — resolve from the footer.
844
937
  </p>
845
938
  </div>
@@ -877,6 +970,131 @@ The panel is a native `<dialog>` opened with `showModal()` — the same mechanic
877
970
  special wiring. `BbToast` regions re-home into the open panel so toasts fired
878
971
  from a drawer stay clickable.
879
972
 
973
+ **Don't teleport overlays out of an open dialog or sheet.** A
974
+ `<Teleport to="body">` (or any `z-index` layer) opened from inside renders
975
+ _under_ the modal and is inert: no clicks, no focus. For anything that floats,
976
+ use a component that joins the top layer: `BbPopover` for anchored content,
977
+ `BbDropdown` for menus, a nested `BbOffCanvas` / `BbDialog` for panels,
978
+ `useToast` for notifications. Opened later, they paint above the current modal
979
+ and stay interactive.
980
+
981
+ ### Restyling with passthrough
982
+
983
+ `pt` reaches a named part of the sheet with a class list — or, in the
984
+ object form, a style and attributes — optionally only while a state is on.
985
+ Parts: `root` (the `<dialog>` — the sheet itself), `header`, `title` and
986
+ `description` (the two lines inside the header — a `#header` slot replaces
987
+ them), `content` (the scrolling body, which carries the body's padding —
988
+ `pt:content="px-8"` or `[--py:20px]` sets it), `footer` and `close` (the ✕). States: `open`, and `fullscreen` while the panel
989
+ fills the viewport (with `fullscreen="mobile"` it flips with the viewport;
990
+ it wins a conflict with `open`). The backdrop is
991
+ `::backdrop` — CSS, not `pt`.
992
+
993
+ The invoice-filters drawer above, restyled through those parts: a muted wash
994
+ on `pt:header`, Apply/Reset laid out on `pt:footer` (the band is not flex by
995
+ default), a muted ✕ on `pt:close`, a primary ring with offset while
996
+ `pt:root:open`. There is no `panel` — the sheet IS the `<dialog>`.
997
+
998
+ **pt:header — invoice filters, a wash on the band**
999
+
1000
+ ```vue
1001
+ <template>
1002
+ <div
1003
+ class="flex max-w-sm items-center justify-between gap-3 rounded-(--bb-radius) border border-(--bb-border) p-3"
1004
+ >
1005
+ <div class="min-w-0">
1006
+ <p class="m-0 text-sm font-medium">Invoices</p>
1007
+ <p class="m-0 text-xs text-(--bb-text-muted)">
1008
+ {{ matchingLabel }}
1009
+ </p>
1010
+ </div>
1011
+ <BbButton
1012
+ prepend:icon="lucide:sliders-horizontal"
1013
+ variant="outline"
1014
+ @click="open = true"
1015
+ >
1016
+ Filters
1017
+ </BbButton>
1018
+ </div>
1019
+ <BbOffCanvas
1020
+ v-model="open"
1021
+ pt:close="text-(--bb-text-muted)"
1022
+ pt:content="text-sm"
1023
+ pt:footer="flex justify-end gap-2"
1024
+ pt:header="bg-(--bb-muted)"
1025
+ pt:root:open="ring-2 ring-offset-2 ring-(--bb-primary)"
1026
+ side="right"
1027
+ title="Filter invoices"
1028
+ >
1029
+ <div class="grid gap-3">
1030
+ <BbTextInput
1031
+ v-model="filters.query"
1032
+ compact
1033
+ label="Search"
1034
+ placeholder="Invoice #, customer…"
1035
+ />
1036
+ <BbCheckbox v-model="filters.overdue" label="Only overdue" />
1037
+ <BbCheckbox v-model="filters.unpaid" label="Only unpaid" />
1038
+ </div>
1039
+ <template #footer>
1040
+ <BbButton variant="ghost" @click="reset">Reset</BbButton>
1041
+ <BbButton variant="primary" @click="open = false">Apply</BbButton>
1042
+ </template>
1043
+ </BbOffCanvas>
1044
+ </template>
1045
+
1046
+ <script setup lang="ts">
1047
+ import { computed, reactive, ref } from 'vue';
1048
+ import { BbButton, BbCheckbox, BbOffCanvas, BbTextInput } from 'bitboss-ui';
1049
+
1050
+ type InvoiceFilterState = {
1051
+ query: string;
1052
+ overdue: boolean;
1053
+ unpaid: boolean;
1054
+ };
1055
+
1056
+ // Same invoice-filters drawer as `InvoiceFilters.vue`, restyled through
1057
+ // passthrough: a muted wash on `pt:header`, footer actions on `pt:footer`
1058
+ // (the band is not flex by default), muted ✕ on `pt:close`, a primary ring
1059
+ // with offset while `pt:root:open`. There is no `panel` — the sheet IS the
1060
+ // `<dialog>`. Backdrop is `::backdrop`, CSS not pt.
1061
+ const open = ref(false);
1062
+ const filters = reactive<InvoiceFilterState>({
1063
+ query: '',
1064
+ overdue: false,
1065
+ unpaid: true,
1066
+ });
1067
+
1068
+ const activeCount = computed(() => {
1069
+ let count = 0;
1070
+ if (filters.query.trim()) count += 1;
1071
+ if (filters.overdue) count += 1;
1072
+ if (filters.unpaid) count += 1;
1073
+ return count;
1074
+ });
1075
+
1076
+ const matchingLabel = computed(() => {
1077
+ const n = activeCount.value;
1078
+ if (n === 0) return '48 total · no filters';
1079
+ return `12 matching · ${n} filter${n === 1 ? '' : 's'} on`;
1080
+ });
1081
+
1082
+ /** Clear every filter back to the empty baseline. */
1083
+ const reset = () => {
1084
+ filters.query = '';
1085
+ filters.overdue = false;
1086
+ filters.unpaid = false;
1087
+ };
1088
+ </script>
1089
+ ```
1090
+
1091
+ The full grammar, the merge rules and the global map are in the
1092
+ [passthrough guide](./guides/passthrough.md).
1093
+
1094
+ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
1095
+ `pt` prop) is typed as `BbOffCanvasProps['pt']`, never an imported `PtValue`: see
1096
+ [passthrough § Typing `pt` in `<script>`](./guides/passthrough.md#typing-pt-in-script).
1097
+
880
1098
  ### Works well with
881
1099
 
882
1100
  - `BbDialog` — the same content as a blocking modal when the task is focused
@@ -903,6 +1121,24 @@ The panel is a native `<dialog>` opened with `showModal()` — the same mechanic
903
1121
  `persistent`; the close paths already guard correctly.
904
1122
  - **Don't stack unrelated drawers** expecting them to peek — the peeking band
905
1123
  only appears for panels sharing a `stack` name and side.
1124
+ - **Don't forget `viewport-fit=cover`** in the page's viewport meta. Every
1125
+ screen edge a panel touches keeps its content clear of the phone's notch,
1126
+ status bar or home indicator by padding its BANDS, not the panel: a bottom
1127
+ sheet's last band (the footer, or the body with no footer) at the bottom,
1128
+ a drawer's first band (the header) at the top and its last band at the
1129
+ bottom, and every band at the side it docks to — nothing on a screen
1130
+ without insets. So a coloured `pt:header` / `pt:footer` still fills to the
1131
+ screen edge. Without `viewport-fit=cover`, iOS keeps the inset strips out
1132
+ of the page and the panel stops short of them. Your own padding on that
1133
+ side of a band (`pt:footer="pb-4"`, `pt:content="p-0"`) replaces the inset
1134
+ room too; add it back if you need it:
1135
+ `pb-[calc(1rem+env(safe-area-inset-bottom))]`.
1136
+ - **Typing in a sheet on a phone**: while a text field inside the panel has
1137
+ focus and the on-screen keyboard covers the page, a panel that reaches the
1138
+ bottom edge lifts above it (a bottom sheet rides up, a drawer or fullscreen
1139
+ panel shortens) and the field scrolls back into view. Where the browser
1140
+ already resizes the page for the keyboard (`interactive-widget=resizes-content`
1141
+ on Android) nothing extra happens.
906
1142
 
907
1143
  ### Accessibility
908
1144
 
@@ -912,6 +1148,8 @@ The panel is a native `<dialog>` opened with `showModal()` — the same mechanic
912
1148
  - The panel is a true modal (`showModal()`): focus is contained within it, the
913
1149
  page behind is inert, and focus returns to the trigger when it closes.
914
1150
  `focus-target` only chooses where focus **starts**.
1151
+ - `description` is what `aria-describedby` points at, so the panel announces
1152
+ its purpose and not just its name.
915
1153
  - The header close button carries a localized `aria-label` out of the box
916
1154
  (`config.locale`).
917
1155
  - Draggable dismissal is a convenience, not the only way out — the close button,
@@ -928,35 +1166,102 @@ The panel is a native `<dialog>` opened with `showModal()` — the same mechanic
928
1166
 
929
1167
  | Prop | Type | Default | Required | Description |
930
1168
  | --- | --- | --- | --- | --- |
931
- | `disabled` | `boolean \| undefined` | | | Disable EVERY user-initiated dismissal: backdrop click, Escape, drag-to-dismiss AND the header close (×) button (denied attempts play the deny nudge). Use it while an operation is in flight (e.g. a save) so the drawer cannot be dismissed mi… |
932
- | `draggable` | `boolean \| undefined` | `false` | | Enable drag-to-dismiss. The panel can be dragged from anywhere toward its edge to close, and a grab handle is shown on the inner edge as the affordance. When `false`, the panel is static (dismiss via the close button, backdrop, or Escape on… |
933
- | `eager` | `boolean \| undefined` | | | Render offcanvas content immediately instead of waiting for the first open. |
1169
+ | `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `close`, `content`, `description`, `footer`, `header`, `root`, `title`. States: `fullscreen`, `open`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbOffCanvasProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
1170
+ | `description` | `string \| undefined` | | | One short line under the title, in the header — the shadcn `DialogDescription` shape: same block as the title, lower hierarchy, muted. It is also what `aria-describedby` points at. That wiring was dropped in v3 along with the old `description` prop, on the reasoning that pointing it at arbitrary body content would read whole forms aloud — true, and the reason it aims at THIS element only. Keep it to a sentence; anything longer belongs in the body. |
1171
+ | `disabled` | `boolean \| undefined` | `false` | | Disable EVERY user-initiated dismissal: backdrop click, Escape, drag-to-dismiss AND the header close (×) button (denied attempts play the deny nudge). Use it while an operation is in flight (e.g. a save) so the drawer cannot be dismissed mid-work. Compare `persistent`, which blocks backdrop/Escape but leaves the × working. Programmatic close (v-model) is still allowed. |
1172
+ | `draggable` | `boolean \| undefined` | `false` | | Enable drag-to-dismiss via VueUse `useSwipe` (fixed ~50px threshold toward the exit edge, including from the scrollable body once it is at its scroll edge). A grab handle on the inner edge is the visual cue. When `false`, the panel is static (dismiss via the close button, backdrop, or Escape only). A gesture that starts inside an element marked `data-bb-no-drag` never drags the panel — for content with drag interactions of its own. |
1173
+ | `eager` | `boolean \| undefined` | `false` | | Render offcanvas content immediately instead of waiting for the first open. |
934
1174
  | `focusTarget` | `string \| undefined` | | | CSS selector of the element to focus after opening. Defaults to the first tabbable element. |
935
1175
  | `fullscreen` | `boolean \| "mobile" \| undefined` | | | Display the offcanvas fullscreen. Use `'mobile'` to restrict fullscreen to small devices. |
936
- | `hideClose` | `boolean \| undefined` | | | Hides the default close (×) button in the header (e.g. for a `persistent` drawer you don't want dismissible — the × otherwise still closes a persistent drawer). |
1176
+ | `hideClose` | `boolean \| undefined` | `false` | | Hides the default close (×) button in the header (e.g. for a `persistent` drawer you don't want dismissible — the × otherwise still closes a persistent drawer). |
937
1177
  | `modelValue` | `boolean \| undefined` | `false` | | Used by v-model to open / close the panel. A panel with no `v-model` starts closed. |
938
- | `persistent` | `boolean \| undefined` | | | Prevent closing via outside clicks, Escape key or drag-to-dismiss. The header close (×) button STILL closes a persistent drawer — that is the documented escape hatch; combine with `hideClose` to remove it, or use `disabled` to block every d… |
1178
+ | `persistent` | `boolean \| undefined` | `false` | | Prevent closing via outside clicks, Escape key or drag-to-dismiss. The header close (×) button STILL closes a persistent drawer — that is the documented escape hatch; combine with `hideClose` to remove it, or use `disabled` to block every dismissal. Programmatic close is still allowed. |
939
1179
  | `side` | `"left" \| "right" \| "top" \| "bottom" \| undefined` | `"left"` | | Which viewport edge the offcanvas docks to (and slides in from). |
940
- | `size` | `Responsive<OffCanvasSize> \| undefined` | `"sm"` | | Controls the maximum size of the offcanvas panel. Accepts named presets from `'xs'` to `'2xl'`, `'auto'`, a custom CSS size string, or a numeric pixel value — or a per-breakpoint map (e.g. `{ default: 'sm', lg: 'lg' }`) to switch responsive… |
1180
+ | `size` | `Responsive<OffCanvasSize> \| undefined` | `"sm"` | | Controls the maximum size of the offcanvas panel. Accepts named presets from `'xs'` to `'2xl'`, `'auto'`, a custom CSS size string, or a numeric pixel value — or a per-breakpoint map (e.g. `{ default: 'sm', lg: 'lg' }`) to switch responsively. |
941
1181
  | `stack` | `string \| undefined` | | | Name of the stack this drawer belongs to. Drawers sharing the same `stack` value step back behind one another as later ones open; drawers in different stacks never affect each other. When omitted, the drawer stacks with nothing. |
942
1182
  | `stackGap` | `number \| undefined` | `60` | | Pixels each stacked parent drawer shifts inward when a child opens on top, leaving a peeking band of the parent visible. |
943
1183
  | `title` | `string \| undefined` | | | Title text announced to assistive technologies. If omitted, no header is rendered and accessibility must be handled manually. |
944
- | `transitionDuration` | `number \| undefined` | `transitions.medium` | | Controls the duration of the open and close animations. |
1184
+ | `transitionDuration` | `number \| undefined` | `250` | | Controls the duration of the open and close animations. |
1185
+
1186
+ ## Passthrough parts and states
1187
+
1188
+ `pt:<part>="…"` restyles a part; `pt:<part>:<state>="…"` applies only while the state is on. A component-wide state is on for every part at once; a _per node_ state resolves on each node of a broadcast part (one row, one option, one day). Grammar and merge rules: `guides/passthrough.md`. In `<script>`, type a `pt` value as `<Component>Props['pt']` (`<Component>Props<Row>['pt']` on a generic component); `PtValue` is not exported: `guides/passthrough.md` § Typing `pt` in `<script>`.
1189
+
1190
+ | Part | What it is |
1191
+ | --- | --- |
1192
+ | `root` | The `<dialog>` — the sheet itself (no separate `panel`). The backdrop is `::backdrop`: CSS, not `pt`. |
1193
+ | `header` | The header band. |
1194
+ | `title` | The title line inside the header. Not rendered when a `#header` slot replaces the header. |
1195
+ | `description` | The description line inside the header. Not rendered when a `#header` slot replaces the header. |
1196
+ | `content` | The scrolling body. It carries the body's padding (`--px`, `--py`, `--dialog-gap`), so `pt:content="px-8"` or `[--py:20px]` sets it. |
1197
+ | `footer` | The footer band. |
1198
+ | `close` | The ✕. |
1199
+
1200
+ States are listed in precedence order: when two are on at once and their entries conflict, the later one wins.
1201
+
1202
+ | State | When it is on |
1203
+ | --- | --- |
1204
+ | `open` | Component-wide: the sheet is open (follows `v-model`). |
1205
+ | `fullscreen` | Component-wide: the panel fills the viewport (square, edge to edge) — always with `fullscreen`, and with `fullscreen="mobile"` only while the viewport is a phone, so it can flip at runtime. Listed after `open`, so a `pt:root:fullscreen` entry wins a conflict with `pt:root:open`. Reachable from any adaptive component through `offCanvasProps: { fullscreen: true, 'pt:root:fullscreen': '…' }`. |
945
1206
 
946
1207
  ## Events
947
1208
 
948
- - `hidden` — `(event: "hidden"): void`
949
- - `hide` — `(event: "hide"): void`
950
- - `show` — `(event: "show"): void`
951
- - `shown` — `(event: "shown"): void`
952
- - `update:modelValue` — `(event: "update:modelValue", value: boolean): void`
1209
+ - `hidden` — `(): void` — Emitted after the close transition completes and the offcanvas is fully dismissed.
1210
+ - `hide` — `(): void` — Emitted as soon as the user triggers the close action (model becomes false).
1211
+ - `show` — `(): void` — Emitted as soon as the user triggers the open action (model becomes true).
1212
+ - `shown` — `(): void` — Emitted after the offcanvas is fully opened using `showModal()`.
1213
+ - `update:modelValue` — `(value: boolean): void` — Emitted with the new value whenever `v-model` changes.
953
1214
 
954
1215
  ## Slots
955
1216
 
956
1217
  - `default` — scope: `{ close: () => void; }` — Primary body content of the off-canvas panel, rendered in the scrollable body area.
957
- - `footer` — scope: `object` — Content rendered in the panel footer, below the body area. Typically used for action buttons.
958
- - `header` — scope: `BbOffCanvasHeaderSlotProps` — Replaces the entire off-canvas header section (title + close button). Maintains accessibility wiring via the provided props.
959
- - `title` — scope: `BbOffCanvasTitleSlotProps` — Replaces the default title text inside the header. Remains linked to the panel through `aria-labelledby`.
1218
+ - `description` — scope: `BbOffCanvasDescriptionSlotProps` `{ text: string }` — Replaces the description text under the title. Renders the header even when `title` and `description` are unset — a slotted description is a description, the same rule `#title` follows.
1219
+ - `footer` — scope: `BbOffCanvasFooterSlotProps` `{ close: () => void }` — Content rendered in the panel footer, below the body area. Typically used for action buttons.
1220
+ - `header` — scope: `BbOffCanvasHeaderSlotProps` `{ titleId: string; close: () => void; title: string }` — Replaces the entire off-canvas header section (title + close button). Maintains accessibility wiring via the provided props.
1221
+ - `title` — scope: `BbOffCanvasTitleSlotProps` `{ text: string }` — Replaces the default title text inside the header. Remains linked to the panel through `aria-labelledby`. Providing this slot renders the header even when `title` is unset — a slotted title is a title.
1222
+
1223
+ ## CSS custom properties
1224
+
1225
+ Set these on the element, or on a class you put on it, to retune this component alone — the sanctioned alternative to reaching past the API with `:deep()`. They are this component's own locals — a **Set on** of `pt:<part>` means the local lives on that part's element, so set it through that entry (`pt:box="[--border-color:var(--color-green-500)]"`); the global `--bb-*` theme tokens are a separate tier (see the [design-tokens guide](./guides/design-tokens.md), or the MCP `list_tokens` tool).
1226
+
1227
+ | Property | Set on | Default | What it is |
1228
+ | --- | --- | --- | --- |
1229
+ | `--translate-x` | `.bb-offcanvas` | `0%` | |
1230
+ | `--translate-y` | `.bb-offcanvas` | `0%` | |
1231
+ | `--translate` | `.bb-offcanvas` | `1` | |
1232
+ | `--stack-x` | `.bb-offcanvas` | `0px` | Inward shift applied to a parent panel while a child is stacked on top. |
1233
+ | `--stack-y` | `.bb-offcanvas` | `0px` | |
1234
+ | `--stack-fill` | `.bb-offcanvas` | `0px` | Length of the pad (see `::after`) that fills from the panel's anchored edge out to the screen edge, so no empty band shows when a descendant is dragged away or shrinks. |
1235
+ | `--stack-transition-duration` | `.bb-offcanvas` | `var(--transition-duration)` | Duration for the stack shift + pad. Zeroed while a peer resizes so parents track the live size instead of lagging behind a 250ms animation. |
1236
+ | `--px` | `.bb-offcanvas` | `var(--bb-panel-p)` | Axis split of --bb-panel-p: --px (inline) / --py (block), each branching off it. Set the pair only when the axes differ; setting --bb-panel-p alone keeps them equal. Local on this root class (not :root) so scoped --bb-panel-p overrides keep reaching the slots; for per-part asymmetry, scope --py to the part class. |
1237
+ | `--py` | `.bb-offcanvas` | `var(--bb-panel-p)` | |
1238
+ | `--handle-w` | `.bb-offcanvas` | `36px` | The drag handle's length along the anchored edge (`draggable`); on a left / right panel the axes swap and this is its height. Set through `pt:root` here, or `pt:sheet` on the component that becomes this sheet. |
1239
+ | `--handle-h` | `.bb-offcanvas` | `4px` | The drag handle's thickness — its height on a bottom / top panel, its width on a left / right one. |
1240
+ | `--handle-bg` | `.bb-offcanvas` | `var(--bb-border)` | The drag handle's fill. |
1241
+ | `--transition-timing-function` | `.bb-offcanvas` | `var(--bb-ease)` | |
1242
+ | `--bg` | `.bb-offcanvas` | `var(--bb-panel)` | |
1243
+ | `--fg` | `.bb-offcanvas` | `var(--bb-text)` | |
1244
+ | `--safe-top` | `.bb-offcanvas` | `env(safe-area-inset-top, 0px)` | * Safe areas (Q44.20, owner 2026-09-22): every screen edge a panel touches * absorbs that edge's inset the way the chin below always did — on the * BANDS, never on the panel, so a band's fill runs to the screen edge while * its content clears the notch, status bar or home indicator. * --safe-* the device insets (`env()`; 0 when unsupported or without * `viewport-fit=cover`) — a knob, e.g. for a test or a frame; * --inset-* the inset THIS panel absorbs: `--safe-*` on the edges it * touches, 0 elsewhere. Header / body / footer add it: the * first band on top, the last band at the bottom, every band * at the sides. |
1245
+ | `--safe-right` | `.bb-offcanvas` | `env(safe-area-inset-right, 0px)` | |
1246
+ | `--safe-bottom` | `.bb-offcanvas` | `env(safe-area-inset-bottom, 0px)` | |
1247
+ | `--safe-left` | `.bb-offcanvas` | `env(safe-area-inset-left, 0px)` | |
1248
+ | `--inset-top` | `.bb-offcanvas` | `0px` | |
1249
+ | `--inset-right` | `.bb-offcanvas` | `0px` | |
1250
+ | `--inset-bottom` | `.bb-offcanvas` | `0px` | |
1251
+ | `--inset-left` | `.bb-offcanvas` | `0px` | |
1252
+ | `--close-size` | `.bb-offcanvas__header` | `28px` | Shared by the close control and by the space the title reserves for it, * so the two can never drift apart. |
1253
+
1254
+ ## Component tree
1255
+
1256
+ `BbOffCanvas` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `BbOffCanvas`, and before concluding a part, a token or a behaviour does not exist** — it may live on a component further down. How to read it:
1257
+
1258
+ - **_internal_** nodes are building blocks with no API of their own: you reach them only through `BbOffCanvas`. A pt part listed as landing there is set on `BbOffCanvas` (`pt:<part>`).
1259
+ - **_public_** nodes are components with their own contract. `BbOffCanvas` reaches one only through a pt part of its own that lands on it (shown on the parent node as `part → Component`, e.g. `spinner → BbSpinner`) or through a pt map it hands it (shown as "hands … the pt map", in `BbOffCanvas`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
1260
+ - **CSS custom properties** listed on a node are declared on THAT node's root and read by elements inside it. Set one on that node's root or on the element inside it that reads it — the pt part that lands there is how you reach it (`pt:box="[--border-color:…]"` on a text input) — never on `BbOffCanvas`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
1261
+ - Listed nodes are the ones `BbOffCanvas`'s API reaches or that declare a documented CSS variable; the rest fold into "also mounts". The complete tree, repeats and undocumented locals included, is the `tree` field of this component in `components.json`.
1262
+
1263
+ - `BbOffCanvas` _(this component)_ — its own template binds: `header` → `div.bb-offcanvas__header`, `title` → `span.bb-offcanvas__title`, `description` → `p.bb-offcanvas__description`, `close` → `CloseButton`, `content` → `div.bb-offcanvas__content`, `footer` → `div.bb-offcanvas__footer`
1264
+ - `CloseButton` _(internal — not importable, reach it through `BbOffCanvas`)_ — documented CSS variables: `--size`, `--p`
960
1265
 
961
1266
  ## See Also
962
1267