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
@@ -10,6 +10,83 @@ deliberately small: we are not shipping a design system, we are shipping
10
10
  **affordances**. A token earns its place only when overriding it is a decision
11
11
  a real consumer would make. Everything else is a formula.
12
12
 
13
+ Machine-readable paint for agents that look for DESIGN.md or `tokens.json` is
14
+ [`design-tokens.json`](../design-tokens.json) and
15
+ [`design-tokens.manifest.yaml`](../design-tokens.manifest.yaml), generated from
16
+ `src/assets/css/variables.css`. Grep `--bb-*`. Do not grep `--color-*` or
17
+ `--radius-*`. The `fixtures/inertia/DESIGN.md` in this repository is the Inertia
18
+ fixture, not this library.
19
+
20
+ **No font token.** Components have no font token; they inherit the page's
21
+ `font-family`. Always set one on `body` (or a `.bb-theme` island), e.g.
22
+ `font-family: system-ui, sans-serif`: an app that sets none renders in the
23
+ browser's default serif. The optional reset (`resetCss: true` /
24
+ `bitboss-ui/reset.css`) sets that `system-ui` stack on `body` at zero
25
+ specificity; your own `font-family` still wins.
26
+
27
+ ## Component paint locals
28
+
29
+ From the outside, a surface has a background and text on it. Those names are
30
+ the same on every component that is a surface:
31
+
32
+ | Local | Meaning |
33
+ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
34
+ | `--bg` | This thing's background (badge, table, dialog, toast card, input shell, avatar, tooltip, button, …) |
35
+ | `--fg` | Text and icons on that background |
36
+ | `--bg-hover` / `--bg-pressed` | Only where hover or press is a different paint (buttons, input shells) — see the state matrix below |
37
+ | `--border-color` | This thing's border — on a field box, the RESTING border: errors and warnings paint over it (see _The field box_ below) |
38
+ | `--ring-color` / `--ring-size` | Focus ring colour and width (badge, button, input shells, glyphs); the component composes the shadow from them |
39
+ | `--fg-muted` | Secondary text on the same surface (alert body) |
40
+ | `--icon-color` | A status glyph that is not the card text (toast) |
41
+ | `--row-bg` | A row's background when it differs from the table |
42
+ | `--accent` | Accent on a binary/meter **glyph** or bar (checkbox, radio, switch, rating, the error and warning icons; the bar of a slider and a progress, whose track is `--track-color`). Not a surface. |
43
+
44
+ **States multiply the paint, with one rule for the names.** A state that
45
+ paints differently gets the same three words with the state as a suffix, and
46
+ a state that defaults to the resting look still gets its own token so a
47
+ consumer can move it. The button is the one component that carries the whole
48
+ matrix today; input shells carry the rows they need (`--bg-hover`,
49
+ `--bg-disabled`, `--bg-focus`, `--border-focus`), and a new state on any
50
+ surface follows the same grid rather than minting a name:
51
+
52
+ | State | Background | Text / icons | Border | Extra |
53
+ | -------- | --------------- | --------------- | ------------------- | ---------------------------------- |
54
+ | rest | `--bg` | `--fg` | `--border-color` | |
55
+ | hover | `--bg-hover` | `--fg-hover` | `--border-hover` | focus-visible paints the hover row |
56
+ | pressed | `--bg-pressed` | `--fg-pressed` | `--border-pressed` | `[aria-pressed='true']` |
57
+ | disabled | `--bg-disabled` | `--fg-disabled` | `--border-disabled` | `--opacity-disabled` (default `1`) |
58
+
59
+ On the button, the hover and pressed rows default to the resting values
60
+ (`--fg-hover: var(--fg)`, …) so only the fill moves unless a variant or a
61
+ consumer says otherwise; the disabled row defaults to the muted grey. Set the
62
+ disabled row back to the resting tokens and `--opacity-disabled: .5` for the
63
+ "fade instead of grey" style (BbButton guide § Disabled: fade instead of
64
+ grey). A loading button never reads the disabled row — loading keeps the
65
+ variant colours by ruling (DECISIONS.md, 2026-09-17).
66
+
67
+ No `--bb-button-bg`. No leftover aliases — `--color` is retired entirely, so
68
+ there is no surface-versus-glyph split to memorise (`--bg-color`
69
+ is not `--bg`). Beta names do not survive into stable; the migration guide
70
+ carries the rename.
71
+
72
+ Two backgrounds on one component keep two names (`--list-bg` /
73
+ `--indicator-bg` on tabs). Overlay dim stays `--bb-overlay`. Resize handles and similar chrome
74
+ keep painting `--bb-*` directly.
75
+
76
+ **Locals shadow, so the names must differ.** Component locals are unprefixed
77
+ and shadow custom properties of the same name for the component's whole
78
+ subtree, slot content included. To map a local to an app-level variable the
79
+ two names must differ: `--r: var(--radius)`, never `--radius: var(--radius)`
80
+ — on the declaring element that is a cycle, the value is invalid and the
81
+ corner collapses to 0. That is why the locals use short spellings (`--r`,
82
+ `--bw`, `--fs`, `--px`, `--py`) and the ring is `--ring-color` +
83
+ `--ring-size`: shadcn's globals `--radius` and `--ring` are safe to read
84
+ (`--r: var(--radius)`, `--ring-color: var(--ring)`). `--accent` still shares
85
+ shadcn's name — it is a documented family name — so write
86
+ `--accent: var(--accent)` on a component root and the accent disappears the
87
+ same way; map it from a differently named app variable
88
+ (`--accent: var(--app-accent)`).
89
+
13
90
  ## Principles
14
91
 
15
92
  1. **Cheap by default.** Reuse an existing token (possibly through `calc()` /
@@ -45,17 +122,25 @@ that is a feature.
45
122
 
46
123
  ### Brand knobs (what a theme builder sets)
47
124
 
48
- | Token | Default (light) | Dark | Meaning |
49
- | ------------------- | ------------------ | ------------------ | --------------------------------------------------------------------- |
50
- | `--bb-primary` | `rgb(0 0 0)` | `white` | Brand accent |
51
- | `--bb-primary-fg` | `white` (fallback) | `black` (fallback) | Text/icons **on** primary — **auto-contrasts** (see note) |
52
- | `--bb-danger` | `rgb(217 59 48)` | rose-400 | Errors, destructive intent |
53
- | `--bb-warn` | `rgb(240 131 88)` | amber-500 | Warning **chrome/icons** (`hasWarning`) — ranks below danger |
54
- | `--bb-text-warn` | `rgb(180 83 9)` | amber-500 | Warning **message text** — deeper amber, text-contrast budget |
55
- | `--bb-panel` | `rgb(255 255 255)` | `#313638` | Raised surfaces (cards, inputs, popovers, dialogs) |
56
- | `--bb-text` | `rgb(0 0 0)` | `white` | Foreground |
57
- | `--bb-border` | zinc-300 | zinc-600 | Hairlines; pair with `--bb-border-w` |
58
- | `--bb-ring-opacity` | `15%` | `40%` | Ring strength; `--bb-ring`/`--bb-ring-danger`/`--bb-ring-warn` follow |
125
+ | Token | Default (light) | Dark | Meaning |
126
+ | --------------------- | ------------------ | ------------------ | -------------------------------------------------------------------------------------------------------------- |
127
+ | `--bb-primary` | `rgb(0 0 0)` | `white` | Brand accent |
128
+ | `--bb-primary-fg` | `white` (fallback) | `black` (fallback) | Text/icons **on** primary — **auto-contrasts** (see note) |
129
+ | `--bb-primary-border` | tracks primary | tracks primary | Outline of a primary plate — pin when the fill would hide the stroke |
130
+ | `--bb-link-fg` | tracks primary | tracks primary | Link-style button text — pin when primary would not read as copy |
131
+ | `--bb-danger` | `rgb(217 59 48)` | rose-400 | Errors, destructive intent |
132
+ | `--bb-danger-fg` | `white` | `black` | Text/icons **on** a danger fill — pinned, not auto-contrasted |
133
+ | `--bb-success` | green-700 | green-700 | Positive / complete — a **fill** (toast, indicator `success`); not text on dark: below 4.5:1 on the dark panel |
134
+ | `--bb-success-fg` | `white` | `white` | Text/icons **on** success |
135
+ | `--bb-info` | blue-600 | blue-600 | Informational — a **fill** (toast, indicator `info`); not text on dark, same reason |
136
+ | `--bb-info-fg` | `white` | `white` | Text/icons **on** info |
137
+ | `--bb-warn` | `rgb(240 131 88)` | amber-500 | Warning **chrome/icons** (`hasWarnings`) — ranks below danger |
138
+ | `--bb-text-warn` | `rgb(180 83 9)` | amber-500 | Warning **message text** — deeper amber, text-contrast budget |
139
+ | `--bb-warn-fg` | `white` | `white` | Text/icons **on** a warn fill. Below the contrast budget by ruling — see below |
140
+ | `--bb-panel` | `rgb(255 255 255)` | `#313638` | Raised surfaces (cards, inputs, popovers, dialogs) |
141
+ | `--bb-text` | `rgb(0 0 0)` | `white` | Foreground |
142
+ | `--bb-border` | zinc-300 | zinc-600 | Hairlines; pair with `--bb-border-w` |
143
+ | `--bb-ring-opacity` | `15%` | `40%` | Ring strength; `--bb-ring`/`--bb-ring-danger`/`--bb-ring-warn` follow |
59
144
 
60
145
  **`--bb-warn` / `--bb-text-warn` are the only shared status tokens besides
61
146
  `--bb-danger`.** They color the **warning input state** as a chrome/text split,
@@ -71,53 +156,127 @@ separation and close enough to be mistaken for an error (owner ruling
71
156
  and IS real text, so it keeps the ≥4.5:1 budget (amber-700, 5.0:1). A single
72
157
  token dark enough for the copy browns the chrome, so there are two. Every form control
73
158
  takes `warnings` (messages, also referenced from the control's
74
- `aria-describedby` while displayed) and `hasWarning` (force the chrome),
159
+ `aria-describedby` while displayed) and `hasWarnings` (force the chrome),
75
160
  mirroring `errors`/`hasErrors`; `errors` win and suppress warnings when both
76
161
  are set. It is deliberately **not** a badge/button `warning` _variant_ (those
77
- stay locked — see design-language.md); there is still no
78
- `--bb-success`/`--bb-info`. All three status tokens carry their own dark-theme
79
- values (rose-400 / amber-500 / amber-500) so 13-14px status text keeps ≥4.5:1
80
- contrast on the dark panel — amber-500 clears both budgets there (5.7:1), so
81
- the chrome/text split is a light-theme distinction only.
82
-
83
- **This set is closed by ruling (2026-07-30): state colors are project-owned.**
84
- The library ships `--bb-danger`, `--bb-warn`, and `--bb-text-warn` because its
85
- **own** built-in states consume them (error/warning input chrome and message
86
- text, `destructive` variants) — and it will not grow the vocabulary: no
87
- `--bb-success`, no `--bb-info`, no `--bb-good`, no color ramps or meter/gauge
88
- palettes. A design that needs status color beyond those — a strength meter, a
89
- health score, an SLA bar, a capacity gauge, a multi-step ramp — mints its
90
- **own** accents in project CSS (the local-`--accent` recipe in
162
+ stay locked — see design-language.md). `--bb-success` and `--bb-info` exist
163
+ because toast and indicator already ship those variants and a platform could
164
+ not retint them at all; they are knobs, not ramps, and they add no new
165
+ variants anywhere. All three status tokens carry their own dark-theme values
166
+ (rose-400 / amber-500 / amber-500) so 13-14px status text keeps ≥4.5:1 on the
167
+ dark panel — amber-500 clears both budgets there (5.7:1), so the chrome/text
168
+ split is a light-theme distinction only.
169
+
170
+ **`--bb-danger` is a fill AND running copy, and there is no split for it.**
171
+ Unlike warn, danger has no `--bb-text-danger`: the shipped `rgb(217 59 48)`
172
+ measures 4.55:1 on the panel, so one value served both roles and a second name
173
+ would have been cruft. That makes the budget a **constraint on any repin** — a
174
+ danger you choose for how it reads as a fill must still clear 4.5:1 as 14px
175
+ text, because eight places paint it as copy: the field-error message, the
176
+ destructive alert's title and body, three destructive dropdown item sites, the
177
+ select popover, the dropzone error and the required asterisk. `--bb-destructive-fg`
178
+ does **not** reach any of them — it is the label on a destructive
179
+ button, badge or tooltip, and nothing else.
180
+
181
+ **The destructive variant sits under the floor, by ruling (2026-09-12.)**
182
+ Measured from rendered pixels against the shipped defaults, in both schemes:
183
+
184
+ | destructive | light | dark |
185
+ | ------------- | ------ | ------ |
186
+ | label at rest | 4.13:1 | 4.33:1 |
187
+ | label hovered | 3.79:1 | 3.69:1 |
188
+ | label pressed | 3.31:1 | 3.21:1 |
189
+ | badge | 3.63:1 | 3.81:1 |
190
+
191
+ `--bb-danger` clears 4.5:1 on the panel, which is where it is a message; it
192
+ does not clear it on its own 8% wash, which is where it is a button label.
193
+ Every other variant clears the floor comfortably — primary 18.03:1, secondary
194
+ 16.14:1 light and 11.70:1 dark.
195
+
196
+ **Leave it alone.** The owner ruled against changing the variant, on the same
197
+ grounds as `--bb-warn-fg` below: the destructive wash reading as _danger_ is
198
+ what the control is for, and a foreground darkened to clear the ratio stops
199
+ reading as the danger colour. The numbers are recorded here so the next probe
200
+ finds a ruling rather than a bug. A project bound by a strict audit darkens
201
+ `--bb-destructive-fg`, which is derived and therefore pinnable from the knob
202
+ layer without a selector:
203
+
204
+ ```css
205
+ .bb-theme {
206
+ --bb-destructive-fg: color-mix(in oklab, var(--bb-danger) 80%, black);
207
+ }
208
+ ```
209
+
210
+ See plans/THEME-GLASS-OBSTACLES.md §6 for the alternatives that were weighed.
211
+
212
+ **The warning ALERT does not follow `--bb-warn`.** It is twelve hardcoded hex
213
+ declarations behind a `light-dark()`, deliberately: the palette is the shadcn
214
+ amber and the ruling that pinned it is recorded above the variant. `--bb-warn`
215
+ is the salmon _chrome_ colour, ΔE 0.148 from danger, so deriving the alert from
216
+ it would trade a documented palette for a different one. A theme that wants the
217
+ alert to follow its own warn colour retints it in four declarations on one
218
+ class — `--bg`, `--border-color`, `--fg` and `--fg-muted`, all four
219
+ load-bearing — and the `light-dark()` branch it lands on is decided by
220
+ `color-scheme`, which a `.bb-theme` island must set itself.
221
+
222
+ **Ramps stay closed (2026-07-30, narrowed 2026-09-12).** The library ships a
223
+ status colour only where its **own** built-in states consume one. It will not
224
+ grow a scale: no `--bb-good`, no 50–900 ladders, no meter or gauge palettes. A
225
+ strength meter or an SLA bar mints its own accents in project CSS.
226
+
227
+ **The `-fg` values are pinned, not auto-contrasted.** `contrast-color()`
228
+ maximises ratio, and on a saturated red that means black — measured on
229
+ `--bb-danger`, white is 4.55:1 and black 4.62:1, so auto-contrast picked a
230
+ black label that read as a mistake. Each foreground is a literal chosen to
231
+ clear 4.5:1: white on danger (4.55), success (5.02) and info (5.17).
232
+ `--bb-success` is green-700 rather than green-600 for that reason — white on
233
+ green-600 is 3.30:1. In the dark scheme `--bb-danger` lightens to rose-400, so
234
+ its foreground flips to ink (7.80:1). Repin a foreground whenever you repin the
235
+ fill under it.
236
+
237
+ **`--bb-warn-fg` is the exception, by ruling (2026-09-12).** White on the
238
+ salmon `--bb-warn` measures **2.59:1**, below the 4.5:1 budget every other
239
+ value here clears. Ink on the same salmon is 8.09:1 but reads as a mistake,
240
+ which is what the ruling responds to; darkening the fill to the amber the
241
+ library already ships for warning copy would have given white 5.02:1 and was
242
+ rejected in favour of keeping the warn colour. It applies to a warn SOLID,
243
+ which today is only the indicator bubble — a short numeral rather than running
244
+ copy — and it stays white in the dark scheme too (2.15:1 on amber-500). A strength meter, health score, SLA bar, or multi-step
245
+ ramp mints its **own** accents in project CSS (the local-`--accent` recipe in
91
246
  design-language.md's soft-palette section is the sanctioned shape). Reusing
92
- `--bb-danger`/`--bb-warn`/`--bb-text-warn` inside project CSS is allowed —
93
- they are ordinary custom properties — but that reuse is the project's call and
94
- the project's contrast budget; the library only promises their meaning within
95
- its own components.
247
+ `--bb-danger` / `--bb-warn` / `--bb-text-warn` inside project CSS
248
+ is allowed — they are ordinary custom properties — but that reuse is the
249
+ project's call and the project's contrast budget; the library only promises
250
+ their meaning within its own components.
96
251
 
97
252
  **`--bb-primary-fg` auto-contrasts.** Where the browser supports CSS
98
253
  `contrast-color()`, `--bb-primary-fg` is derived to black or white — whichever
99
254
  reads on `--bb-primary` — so setting only `--bb-primary` still yields legible
100
- text/icons on primary fills. The light/dark values in the table are the
101
- **fallback** used when `contrast-color()` is unsupported; a theme that targets
102
- those browsers should set a matching fallback for its brand color. Setting
103
- `--bb-primary-fg` explicitly always wins over both (normal cascade), so a theme
104
- can pin an exact foreground.
255
+ text/icons on primary fills. Auto-contrast is specified on **scheme roots**
256
+ (`:root`, `.light`, `.dark`) at specificity 0, so a same-element pin still
257
+ wins. It does **not** re-run on `.bb-theme`: `--bb-primary-fg` is a knob and
258
+ inherits. An island that retunes `--bb-primary` should set `--bb-primary-fg`
259
+ too when the inherited foreground no longer reads. The light/dark values in
260
+ the table are the **fallback** used when `contrast-color()` is unsupported; a
261
+ theme that targets those browsers should set a matching fallback for its brand
262
+ color. Setting `--bb-primary-fg` explicitly always wins over both (normal
263
+ cascade), so a theme can pin an exact foreground.
105
264
 
106
265
  ### Derived colors (follow the knobs automatically; still overridable)
107
266
 
108
- | Token | Formula (all `in oklab`) | Used for |
109
- | -------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
110
- | `--bb-muted` | `mix(var(--bb-text) 6%, var(--bb-panel))` | Static subtle fills: disabled surfaces |
111
- | `--bb-track` | `mix(var(--bb-text) 15%, var(--bb-panel))` | Recessed control-track surface (switch/slider rails, input wells) — a distinct surface that must contrast a panel-coloured thumb, so it sits **above** the 2/4/6/8 chrome fills |
112
- | `--bb-hover` | `mix(var(--bb-text) 4%, var(--bb-panel))` | Hover fill for **affordances** — ghost/outline buttons, pagination, nav links |
113
- | `--bb-surface-hover` | `mix(var(--bb-text) 2%, var(--bb-panel))` | Hover fill for **passive surfaces** — table rows, list items, picker day cells (fainter) |
114
- | `--bb-pressed` | `mix(var(--bb-text) 8%, var(--bb-panel))` | Neutral pressed/active fill |
115
- | `--bb-text-muted` | `mix(var(--bb-text) 60%, transparent)` | Secondary text, icons, placeholders, hints |
116
- | `--bb-text-faint` | `mix(var(--bb-text) 45%, transparent)` | Disabled foregrounds |
117
- | `--bb-ring` | `mix(var(--bb-primary) var(--bb-ring-opacity), transparent)` | Focus ring — primary & link variants |
118
- | `--bb-ring-danger` | same formula over `--bb-danger` | Focus ring in error states (destructive) |
119
- | `--bb-ring-warn` | same formula over `--bb-warn` | Focus ring in the warning input state (`hasWarning`) |
120
- | `--bb-ring-neutral` | same formula over `--bb-text` | Focus ring for the neutral variants (secondary/outline/ghost) — grey, never primary-tinted |
267
+ | Token | Formula (all `in oklab`) | Used for |
268
+ | -------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
269
+ | `--bb-muted` | `mix(var(--bb-text) 6%, var(--bb-panel))` | Static subtle fills: disabled surfaces |
270
+ | `--bb-track` | `mix(var(--bb-text) 15%, var(--bb-panel))` | Recessed control-track surface — the switch track, the slider rail and the progress track all read it. A distinct surface that must contrast a panel-coloured thumb, so it sits **above** the 2/4/6/8 chrome fills |
271
+ | `--bb-hover` | `mix(var(--bb-text) 4%, var(--bb-panel))` | Hover fill for **affordances** — ghost/outline buttons, pagination, nav links |
272
+ | `--bb-surface-hover` | `mix(var(--bb-text) 2%, var(--bb-panel))` | Hover fill for **passive surfaces** — table rows, list items, picker day cells (fainter) |
273
+ | `--bb-pressed` | `mix(var(--bb-text) 8%, var(--bb-panel))` | Neutral pressed/active fill |
274
+ | `--bb-text-muted` | `mix(var(--bb-text) 60%, transparent)` | Secondary text, icons, placeholders, hints |
275
+ | `--bb-text-faint` | `mix(var(--bb-text) 45%, transparent)` | Disabled foregrounds |
276
+ | `--bb-ring` | `mix(var(--bb-primary) var(--bb-ring-opacity), transparent)` | Focus ring — primary & link variants |
277
+ | `--bb-ring-danger` | same formula over `--bb-danger` | Focus ring in error states (destructive) |
278
+ | `--bb-ring-warn` | same formula over `--bb-warn` | Focus ring in the warning input state (`hasWarnings`) |
279
+ | `--bb-ring-neutral` | same formula over `--bb-text` | Focus ring for the neutral variants (secondary/outline/ghost) — grey, never primary-tinted |
121
280
 
122
281
  These neutral-chrome percentages (2/4/6/8) are deliberately off the emphasis
123
282
  ladder: they live only in `variables.css`, which the checker exempts as the
@@ -173,14 +332,77 @@ ladder formulas instead of these tokens, so a state name never lies.
173
332
 
174
333
  ### Shape & elevation
175
334
 
176
- | Token | Default | Notes |
177
- | --------------------- | ---------------------------------------- | ------------------------------------------------------------------- |
178
- | `--bb-radius` | `8px` | THE knob — controls tier: buttons, inputs, tab strips |
179
- | `--bb-radius-surface` | `calc(var(--bb-radius) * 1.8)` | Surfaces tier: dialogs, off-canvas sheets |
180
- | `--bb-radius-sm` | `max(4px, calc(var(--bb-radius) * 0.6))` | Nested-bits tier: table controls, toast close, calendar footer btns |
181
- | `--bb-border-w` | `1px` | |
182
- | `--bb-ring-size` | `2px` | Focus ring thickness |
183
- | `--bb-shadow` | soft 2-layer | The single elevation shadow |
335
+ | Token | Default | Notes |
336
+ | --------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
337
+ | `--bb-radius` | `8px` | THE knob — controls tier: buttons, inputs, tab strips |
338
+ | `--bb-radius-surface` | `calc(var(--bb-radius) * 1.8)` | Surfaces tier: dialogs, off-canvas sheets |
339
+ | `--bb-radius-sm` | `min(r, max(4px, calc(r * 0.6)))` | Nested-bits tier: table controls, toast close, calendar footer btns. The 4px floor keeps nested chrome from vanishing, and the `min()` keeps it from ever exceeding `--bb-radius` — so a 2px or 0px world needs no second pin. |
340
+ | `--bb-border-w` | `1px` | Hairline thickness — plates (buttons, inputs, dialogs, alerts) and internal dividers |
341
+ | `--bb-border-w-sm` | `min(bw, max(1px, calc(bw / 2)))` | Nested / small hairline — xs/sm buttons, badges, indicators, glyphs. Same shape as the radius tier: a 1px floor, capped by `--bb-border-w`, so a 0.5px or borderless theme is not handed a thicker hairline than its plates. Default (1px) matches `--bb-border-w`. |
342
+ | `--bb-ring-size` | `2px` | Focus ring thickness |
343
+ | `--bb-shadow` | soft 2-layer | Overlay elevation (dialogs, popovers, menus, toasts) |
344
+ | `--bb-shadow-sm` | small 2-layer (dark: ×5 alpha) | The small lift of a **selected segment** inside a track — the tab strip's indicator, the time picker's active range end. Re-declared for dark like `--bb-shadow` (a light-alpha lift vanishes on a dark track). Not `--bb-elev`: that is the theme's resting lift on every control and is transparent by default; this one ships visible. |
345
+ | `--bb-elev` | `0 0 0 0 transparent` | Resting lift on **controls** (buttons, inputs, badges, alerts, checkbox, slider thumb, tab pill). A full `box-shadow`, composed under the focus ring, so one knob covers a soft lift (`0 1px 2px rgb(0 0 0 / 0.05)`) and a hard offset (`4px 4px 0 0 #111`) alike. The default is a transparent layer, not `none`, so the shadow list keeps a constant length and stays interpolable. `--bb-shadow` is the overlay lift; this is the resting one. Ghost / link / none buttons stay flat whatever the theme sets. Avatar and the Indicator bubble carry it via `--bb-elev-sm`; BbDropzone (no plate of its own — the surface is your content) and BbProgress (a recessed track, not a raised plate) deliberately do not. |
346
+ | `--bb-elev-sm` | `var(--bb-elev)` | The same lift on **small chrome** — badges, checkbox and radio glyphs, the slider thumb, the colour swatch, xs/sm buttons, the active pagination chip. It inherits `--bb-elev`, so a soft shadow needs one knob; only a hard offset needs the second value, because a hard offset has no falloff and its weight is purely relative to the box (a 4px offset is 11% of an xl button and 25% of a 16px glyph). It cannot be derived — CSS cannot halve the offsets inside a shadow string. |
347
+
348
+ A four-knob chrome shift is `border-w` + `elev` + `shadow` + `radius`, and
349
+ both nested tiers follow from the first and last, so there is no second pin
350
+ to remember. Loud fills also pin `--bb-primary-border` and `--bb-link-fg`
351
+ (they track `--bb-primary` until set, so a yellow fill has no stroke and
352
+ yellow link copy until you point them at `--bb-text`) — pin them at **every**
353
+ boundary you use, `.dark` included, because the derived block re-specifies
354
+ them.
355
+
356
+ Give a knob a unit. `--bb-border-w: 0` (unitless) makes `calc(0 / 2)` a
357
+ `<number>`, which is a calc type error, and the hairline falls back to the UA
358
+ `medium` — 3px, the opposite of what you asked for. `0px` is correct.
359
+
360
+ Primary badges ship `--bw: 0`; a stroked-chip theme sets
361
+ `.bb-badge--primary { --bw: var(--bb-border-w-sm) }`. The used width
362
+ is **not** capped — `--bw` is a documented override and a cap would
363
+ silently swallow a consumer's value. Overlay bubbles read `--bubble-border-w`
364
+ through a fallback, so a surface can still set it on an ancestor; unset it is
365
+ `--bb-border-w`. Nested glyphs (radio, checkbox, color indicator, palette
366
+ thumbs) and the date-picker time rail use `--bb-border-w` /
367
+ `--bb-border-w-sm`.
368
+
369
+ A theme that scopes a rule to an input variant should know that
370
+ **`variant="none"` emits no modifier class** — the binding is
371
+ `variant !== 'none'` — and the same is true of BbButton's `none`. It is
372
+ addressable only as the absence of the others. That asymmetry is the contract
373
+ working: `none` means "opt out of variant styling", so there is deliberately
374
+ nothing to select. The shell's look variables are built around it — `--elev`
375
+ and `--frost` default to flat and unfrosted on the root, and the variants that
376
+ draw a shell opt in, precisely because `none` cannot be reached by any selector.
377
+
378
+ Raised plates and input shells frost via `--bb-surface-filter` (default
379
+ `none`): the dialog, the off-canvas sheet, every popover bubble, the toast
380
+ card, the input shell, the alert and the table.
381
+
382
+ It holds a **whole `backdrop-filter` value**, not a length — the same shape as
383
+ `--bb-elev` — so one knob carries `saturate()`, `brightness()` or `contrast()`
384
+ alongside the blur:
385
+
386
+ ```css
387
+ .bb-theme {
388
+ --bb-surface-filter: blur(22px) saturate(1.8);
389
+ --bb-panel: rgb(12 9 30 / 0.52); /* give the filter something to read */
390
+ }
391
+ ```
392
+
393
+ Saturation is not decoration: it is what makes colour bloom through glass
394
+ rather than going grey, and it is the half of the canonical recipe a
395
+ length-shaped knob could not express.
396
+
397
+ The default is `none` because that is `backdrop-filter`'s own initial value, so
398
+ the declaration each plate carries is a **measured** no-op — no containing
399
+ block for fixed descendants, no stacking context, no composited backdrop root.
400
+ A length cannot do that: `blur(0px)` creates all three, which is why this knob
401
+ used to need a style query wrapped around every consumer.
402
+
403
+ Set it on a boundary (`:root`, a `.bb-theme` island), not on a plate — the
404
+ plates read the inherited value. `--bb-overlay-blur` is a different token: it
405
+ is the DIM behind a modal, and it is still a length.
184
406
 
185
407
  Radius is tiered **by role, not by size**; both extra tiers derive from the
186
408
  one knob (still individually pinnable). Two more radius rules: concentric
@@ -190,11 +412,11 @@ multipliers — never literals.
190
412
 
191
413
  ### Scale
192
414
 
193
- | Token | Default | Notes |
194
- | ---------------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
195
- | `--bb-control-h` | `32px` | Master control height. Inputs are exactly this; buttons/tabs derive their size scale from it via `calc()` offsets |
196
- | `--bb-fs` | `14px` | Master font size. Component font sizes derive via `calc()` offsets |
197
- | `--bb-panel-p` | `16px` | Content padding of large surfaces (dialog, off-canvas; header/footer paddings derive from it) |
415
+ | Token | Default | Notes |
416
+ | ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
417
+ | `--bb-control-h` | `32px` | Master control height. Inputs are exactly this; buttons/tabs derive their size scale from it via `calc()` offsets |
418
+ | `--bb-fs` | `14px` | Master font size. Component font sizes derive via `calc()` offsets |
419
+ | `--bb-panel-p` | `16px` | Content padding of large surfaces (dialog, off-canvas; header/footer paddings derive from it). Axis split via the component locals `--px`/`--py` on `.bb-dialog` / `.bb-offcanvas`, each branching off `var(--bb-panel-p)`; set the pair (on the component's class) only when the axes differ |
198
420
 
199
421
  ### Motion
200
422
 
@@ -205,8 +427,9 @@ multipliers — never literals.
205
427
  | `--bb-transition-medium` | `250ms` — overlays, most moves |
206
428
  | `--bb-ease` | `cubic-bezier(0.4, 0, 0.2, 1)` — the only easing curve |
207
429
 
208
- (`--bb-transition-slow`: `350ms`, for large-surface consumer animations —
209
- the library itself uses `medium` for those.)
430
+ (`--bb-transition-slow`: `350ms`, for large-surface animations. The library
431
+ uses it in one place — the tab-pane slide, `BbTabs/tab-panes.css` — and
432
+ `medium` everywhere else.)
210
433
 
211
434
  **`--bb-transition-immediate` is not a fourth speed — it is OFF**, and it exists
212
435
  so the `prefers-reduced-motion` branches name what they are doing instead of
@@ -222,12 +445,14 @@ to hardcode past it.
222
445
 
223
446
  ### Overlays
224
447
 
225
- | Token | Default | Notes |
226
- | ------------------- | ------------------ | ----------------------------------- |
227
- | `--bb-overlay` | `rgb(0 0 0 / 0.1)` | Backdrop dim color+opacity in one |
228
- | `--bb-overlay-blur` | `2px` | Backdrop blur |
229
- | `--bb-z-overlay` | `10` | Overlay z-index |
230
- | `--bb-arrow` | `1` | Popover arrows on (`1`) / off (`0`) |
448
+ | Token | Default | Notes |
449
+ | ---------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
450
+ | `--bb-overlay` | `rgb(0 0 0 / 0.1)` | Backdrop dim color+opacity in one — the bottom-most open panel's backdrop |
451
+ | `--bb-overlay-stacked` | derived: `--bb-overlay` | Dim painted by a dialog or off-canvas stacked over another open one, on top of everything beneath it (the parent included). Derived, so a theme that only sets `--bb-overlay` gets a matching value; `transparent` gives a single dim under the whole pile |
452
+ | `--bb-overlay-blur` | `2px` | Backdrop blur — only the bottom-most open panel's backdrop carries it, whatever the depth |
453
+ | `--bb-surface-filter` | `none` | Frost on raised plates (dialog, sheet, bubble, toast, alert, table, input shell). A full `backdrop-filter` value — `blur(22px) saturate(1.8)` — not a length. Glass themes set it and give `--bb-panel` an alpha. |
454
+ | `--bb-z-overlay` | `10` | Overlay z-index |
455
+ | `--bb-arrow` | `1` | Popover arrows on (`1`) / off (`0`) |
231
456
 
232
457
  ### Input family
233
458
 
@@ -253,13 +478,64 @@ shared metrics are global — but they derive from the scale knobs:
253
478
  --bb-label-spacing-x: 8px;
254
479
  --bb-label-lh: calc(var(--bb-label-fs) + 4px);
255
480
  --bb-label-lh-sm: max(16px, calc(var(--bb-label-fs-sm) * 1.5));
481
+ /* The description, and the text under the field, each with the label's set */
482
+ --bb-description-fs: var(--bb-fs);
483
+ --bb-description-fs-sm: calc(var(--bb-fs) - 2px); /* under an inside label */
484
+ --bb-description-weight: 400;
485
+ --bb-description-lh: calc(var(--bb-description-fs) + 4px);
486
+ --bb-description-lh-sm: max(16px, calc(var(--bb-description-fs-sm) * 1.5));
487
+ --bb-message-fs: var(--bb-fs); /* hint, errors, warnings — shared */
488
+ --bb-message-weight: 400;
489
+ --bb-message-lh: calc(var(--bb-message-fs) + 4px);
256
490
  ```
257
491
 
258
- The theme layer stays small — **91 `--bb-*` tokens** today (the number
492
+ The label, the description (also a group row's description) and the message
493
+ text (hint, errors, warnings, one shared set because they take turns in the
494
+ same place) are three separate families, so a theme sizes each on its own.
495
+ All three derive from `--bb-fs`, so a density retune moves them together.
496
+
497
+ The literals (`--bb-input-px`, `--bb-label-weight`, …) are knobs. The
498
+ formulas (`--bb-input-h`, `--bb-label-fs`, `--bb-leading`, …) live in the
499
+ derived block with the colors, so an island that retunes `--bb-control-h` /
500
+ `--bb-fs` retunes height and type as well.
501
+
502
+ The theme layer stays small — **112 `--bb-*` tokens** today (the number
259
503
  `npm run check:tokens` prints; the canonical, complete list is
260
504
  `src/assets/css/variables.css`), down from ~140 in v2. The blocks above show the
261
505
  representative groups, not every token.
262
506
 
507
+ ### The field box: the resting border sits under the state
508
+
509
+ The eight text-like controls (`BbTextInput`, `BbTextarea`, `BbNumberInput`,
510
+ `BbSelect`, `BbTag`, `BbColorInput`, `BbDatePickerInput`, `BbTimePickerInput`)
511
+ share one bordered box — the `span.bb-field-input__box` inside the box row —
512
+ reached with `pt:box`. Its border has two layers, and
513
+ the state layer always wins (owner, 2026-09-15):
514
+
515
+ - **Rest:** `--border-color`, set on the box. Errors and warnings paint their
516
+ frame over it, focused or not, so recolouring the rest never makes an
517
+ invalid field look valid. Its default, on the `outline` box, is the theme
518
+ token **`--bb-field-border`** (itself `var(--bb-border)`), which the
519
+ inside-label shells of the option groups, `BbRating` and `BbSlider` read
520
+ too: set `--bb-field-border` to restyle every field's border at once, and
521
+ nothing else (buttons and badges keep `--bb-outline-border`).
522
+ - **State:** a `pt:box:<state>` entry is that state itself, so a plain
523
+ utility is right there.
524
+
525
+ ```vue
526
+ <BbTextInput
527
+ pt:box="[--border-color:var(--color-green-500)]"
528
+ pt:box:errors="border-red-800"
529
+ />
530
+ ```
531
+
532
+ A plain `border-green-500` on the **base** `pt:box` sets `border-color`
533
+ itself and beats the state frame — the field stays green under errors.
534
+ ESLint's `bitboss-ui/no-box-border-color` flags it and suggests the token.
535
+ Glyphs (checkbox, radio, switch) are not field boxes and keep their own rule:
536
+ `pt:icon="text-violet-500"`. Each control's contract lists the token under
537
+ _CSS custom properties_, **Set on** `pt:box`.
538
+
263
539
  ## Tier 2 — component tokens (`--*`)
264
540
 
265
541
  Defined on the component's **root class** in the component's own CSS file.
@@ -272,10 +548,13 @@ Rules:
272
548
  component seals itself.
273
549
  3. **Short names are for self-consumption only.** `--h`, `--px`, `--gap`,
274
550
  `--fs`, `--r` are fine while the rules using them target the component's
275
- own boxes. If a value must be read _inside a nested foreign component_
276
- (e.g. dialog padding positioning the close button, which is itself a
277
- button defining `--px`), the token gets a distinctive name (`--dialog-px`)
278
- or — better — the formula moves to an element the component owns.
551
+ own boxes. If a value must be read _inside a nested foreign component_,
552
+ prefer moving the formula to an element the component owns, or a
553
+ distinctive name. One ruled exception (2026-08-25): the dialog/off-canvas
554
+ padding pair `--px`/`--py` is read by the nested close button's inset
555
+ formula — safe because `BbCloseButton` declares neither, a constraint that
556
+ component must keep (minting `--px`/`--py` there would silently mask the
557
+ surface's value and break the inset).
279
558
  4. **Mint only what varies.** A size variant that overrides four locals is
280
559
  four tokens, not four × six sizes. Per-size lookup tables
281
560
  (`--h-xs … --h-2xl`) are allowed only when a responsive matrix genuinely
@@ -292,12 +571,38 @@ Rules:
292
571
  SelectPopover to read) keep a distinctive name per rule 3.
293
572
 
294
573
  Component tokens are still real affordances: a consumer can retune one
295
- instance (`<BbTabs style="--list-h: 40px">`) or a whole page scope. They are
574
+ instance (`<BbTree style="--indent: 14px">`) or a whole page scope. They are
296
575
  just not global namespace.
297
576
 
298
577
  ### Overriding one from a consumer app
299
578
 
300
- Three rules, in order of how often they are broken.
579
+ Four rules, in order of how often they are broken.
580
+
581
+ **0. Set it on the element that declares it.** Sealing (rule 2 above) is what
582
+ makes an inline style on the component root work — and it is also what makes
583
+ the same style _silently do nothing_ when the token lives on an inner element.
584
+ The inner declaration is not overridden by an inherited value; it replaces it.
585
+ `BbTabs` declares `--list-h` on `.bb-tabs-list`, not on `.bb-tabs`:
586
+
587
+ ```css
588
+ /* works — the list is the element that declares it */
589
+ .bb-tabs-list {
590
+ --list-h: 40px;
591
+ }
592
+ ```
593
+
594
+ ```vue
595
+ <!-- does nothing — .bb-tabs-list re-declares --list-h and masks this -->
596
+ <BbTabs style="--list-h: 40px" />
597
+ ```
598
+
599
+ Grep the component's CSS in `dist/ai/source/<Name>.md` for the declaration
600
+ before choosing a selector — and when the token is not in that file, look it up
601
+ in the contract's **Component tree**: every node lists the CSS custom
602
+ properties it declares and the pt part that reaches its elements (a text
603
+ input's `--border-color` is declared by `CommonFieldInput`, one level
604
+ down, and set with `pt:box`). A masked token produces no warning and no visual
605
+ change.
301
606
 
302
607
  **1. Override only what you actually render.** Several components expose a
303
608
  per-size lookup table (`--icon-size-xs … --icon-size-2xl`, `--h-xs … --h-2xl`)
@@ -331,7 +636,10 @@ silently does nothing on every `size="sm"` one — the confusing half-failure th
331
636
  sends people to the shotgun in rule 1. The per-size entry has no competing
332
637
  declaration, so it always wins. (A scope selector of equal-or-greater
333
638
  specificity also works, but you have to keep winning that race; overriding the
334
- entry does not.)
639
+ entry does not. If your app is on Tailwind v4 or otherwise layered, the race
640
+ has a structural answer: `cssLayers` in the build plugin puts the library in a
641
+ layer below your utilities, and a utility then wins without any specificity at
642
+ all — see the install guide § Cascade layers.)
335
643
 
336
644
  **3. Scope it to the component, never `:root`.** Short names are deliberately
337
645
  reused across components — `--icon-size` is read by `BbButton`, `BbBadge` and
@@ -396,11 +704,28 @@ else changes.
396
704
 
397
705
  ## Dark mode
398
706
 
399
- One name per token. `:root`/`.light` declares light values; `.dark`
400
- re-declares **only the knobs that change** (primary, primary-fg, panel, text,
401
- border, ring opacity). Component tokens and ladder formulas follow
402
- automatically because they are declared on the components themselves. The
403
- old `--x-light`/`--x-dark`/`--x` triple is gone.
707
+ One name per token. `:root`/`.light` declares light knobs; `.dark` re-declares
708
+ **only the knobs that change** (primary, panel, text, border, danger, warn,
709
+ text-warn, shadow, overlay, ring-opacity — and `--bb-primary-fg` as a fallback
710
+ when `contrast-color()` is unsupported). Derived tokens follow automatically
711
+ because their formulas are re-specified at every theme boundary (`.dark`
712
+ included), not because they live on the components. The old
713
+ `--x-light`/`--x-dark`/`--x` triple is gone.
714
+
715
+ **Pinning a dark value.** The library's dark block is `:root .dark,
716
+ :root.dark` (specificity 0,2,0). With the library unlayered (the default), a
717
+ bare `.dark { --bb-primary: … }` in your sheet LOSES to it, however late it
718
+ loads; write the same selector pair instead:
719
+
720
+ ```css
721
+ :root .dark,
722
+ :root.dark {
723
+ --bb-primary: rgb(15 118 110);
724
+ }
725
+ ```
726
+
727
+ With `cssLayers` your unlayered sheet outranks the layered library, and a bare
728
+ `.dark { … }` works too. Light pins (`:root`, `.light`) work either way.
404
729
 
405
730
  The `:root`/`.light` and `.dark` blocks also each set the UA `color-scheme`
406
731
  (`light` / `dark`) alongside the tokens. This is deliberate and load-bearing:
@@ -416,19 +741,53 @@ buttons) invisible. `color-scheme` therefore always follows the class, never
416
741
 
417
742
  One CSS mechanic to respect: **a custom property resolves its `var()`
418
743
  references on the element where it is declared, not where it is consumed.**
419
- That is why the derived color tokens (`--bb-hover`, `--bb-ring`…) are
420
- declared on _both_ scheme scopes in variables.css — declared only on
421
- `:root` they would bake in the light knobs and `.dark` would inherit stale
422
- values. The same applies to consumers: overriding a knob on an arbitrary
423
- scope (`.brand { --bb-primary: … }`) does not re-derive them — re-apply the
424
- `light`/`dark` class on that scope, or override the derived tokens directly.
425
- Root-level theming (what the theme builder emits) is unaffected.
744
+ Derived tokens (`--bb-hover`, `--bb-ring`, `--bb-radius-surface`,
745
+ `--bb-input-h`, the variant matrix, …) are therefore **re-specified** on every
746
+ theme boundary — `:root`, `.light`, `.dark`, and `.bb-theme` — so `var()`
747
+ resolves against that element's knobs. Knobs themselves **inherit**. The
748
+ formula block uses `:where()`, specificity 0: a pin on
749
+ `:root { --bb-hover: … }` still wins on `:root`, and inherits until a nested
750
+ boundary re-specifies the formula.
751
+
752
+ **Branded island** — one class plus the knobs it actually changes. `.bb-theme`
753
+ re-runs formulas **without** resetting scheme knobs, so a toolbar inherits the
754
+ page's panel/text/dark values and only retints what you set:
755
+
756
+ ```html
757
+ <div class="bb-theme" style="--bb-primary: #2563eb">…</div>
758
+ ```
759
+
760
+ ```css
761
+ .toolbar.bb-theme {
762
+ --bb-primary: #2563eb;
763
+ }
764
+ ```
765
+
766
+ `--bb-primary-fg` inherits with the other knobs. Pin it on the island when the
767
+ new primary needs a different foreground; auto-contrast does not re-run here.
768
+
769
+ Do **not** sprinkle `.bb-theme` on components. It is an island root. Nested
770
+ tables, sticky columns and header affixes inherit unprefixed plumbing
771
+ (`--offset-*`, `--cell-h`, `--table-*-track-*`, `--stuck-*`, `--bg`,
772
+ `--row-bg`) from `.bb-table`; a boundary on a cell would retint `--bb-*`
773
+ there and leave that plumbing on a different ancestor.
774
+
775
+ `.light` / `.dark` still reset the **scheme knobs** to the library scheme
776
+ **and** re-run formulas — that is the documented way to preview the
777
+ other scheme inside a page. Use `.bb-theme` when the scheme stays and only
778
+ some knobs change. A knob override **without** `.bb-theme` (or `.light` /
779
+ `.dark`) still does not re-derive: the used `--bb-ring` stays the ancestor's
780
+ baked mix.
781
+
782
+ Root-level theming (`:root` / `.light` and `:root .dark, :root.dark` CSS in
783
+ your own sheet — the build plugin has no `theme` option) is the zero-class
784
+ path: the boundary is already there.
426
785
 
427
786
  ### Registered knobs (`@property`)
428
787
 
429
- Nine tokens are registered in `variables.css`: the eight color knobs with
430
- `syntax: '<color>'`, and `--bb-ring-opacity` with `syntax: '<percentage>'`.
431
- All are `inherits: true`.
788
+ Color knobs in `variables.css` are registered with `syntax: '<color>'`,
789
+ and `--bb-ring-opacity` with `syntax: '<percentage>'`. All are
790
+ `inherits: true`.
432
791
 
433
792
  **Registration types them, and a typed property rejects.** A declaration that
434
793
  does not parse as the declared syntax is invalid at computed-value time — the
@@ -443,19 +802,22 @@ every derivation that mixes it. It is also the trap. Write
443
802
  } /* wrong: not a <percentage> */
444
803
  ```
445
804
 
446
- and nothing errors — not the build, not the console. The computed value is
447
- just `25%`, and every ring paints 1.67× stronger than the `15%` you asked for
448
- (opacity is the ring's strength; its thickness is `--bb-ring-size`).
805
+ and nothing errors — not the build, not the console. The declaration is
806
+ discarded and the token lands on the registered `initial-value: 15%` — which
807
+ happens to be the very value this override asked for, so a light page looks
808
+ right by accident. Write `0.4` on a dark page instead and the ring quietly
809
+ drops from the shipped `40%` to `15%` (opacity is the ring's strength; its
810
+ thickness is `--bb-ring-size`).
449
811
  Percentages need the `%`; colors must be a `<color>` (`transparent` and
450
812
  `currentColor` qualify, `none` and a mistyped hex do not). Nothing in the
451
813
  toolchain catches it either: `bitboss-ui check` reads `.vue`/`.md`, never
452
814
  stylesheets.
453
815
 
454
816
  Fail-soft is only soft when the initial value is close to the real one. Every
455
- color knob is registered at its light default, so a rejected color override
456
- renders the library's own light theme. `--bb-ring-opacity` is registered at
457
- `25%`, which matches neither shipped scope (light `15%`, dark `40%`), so a
458
- rejected value there is the one that shows.
817
+ registered knob — `--bb-ring-opacity` included — is registered at its light
818
+ default, so a rejected override renders the library's own light theme. On a
819
+ dark page that is still visible: a rejected `--bb-ring-opacity` lands on the
820
+ light `15%` against the shipped dark `40%`.
459
821
 
460
822
  Typed knobs are also **animatable**. Add `.theme-animated`
461
823
  (main.css) to the element that carries the scheme class or theme overrides:
@@ -475,8 +837,32 @@ switch instantly. Component tokens stay unregistered (see "Why not
475
837
 
476
838
  This is also the theme-builder contract: a theme is _two small blocks of the
477
839
  same ~10 declarations_. Changing `--bb-primary`, `--bb-radius`,
478
- `--bb-control-h`, `--bb-panel`, `--bb-danger` overhauls the entire library
479
- with no other edits.
840
+ `--bb-control-h`, `--bb-panel`, `--bb-danger` overhauls the entire library with
841
+ no other edits. An island is `.bb-theme` plus the knobs it actually changes,
842
+ not a copy of this file.
843
+
844
+ ## Asking the library which tokens you may set
845
+
846
+ A theme builder needs one thing the token list alone does not give: **which
847
+ names are yours to set**. Setting a derived value is the documented trap — it
848
+ stops tracking the knob it was computed from.
849
+
850
+ The MCP server answers that. `list_tokens` reports every `--bb-*` name with its
851
+ light value, its dark override, and a `kind`:
852
+
853
+ | `kind` | meaning | count today |
854
+ | --------------- | ---------------------------------------------------------------------------------------------------------------------- | ----------- |
855
+ | `knob` | yours to set | 41 |
856
+ | `derived` | a formula recomputed at every theme boundary — set the knob it came from instead | 57 |
857
+ | `knob-tracking` | a knob that follows another until you pin it, and the pin must be repeated at every boundary you use, `.dark` included | 3 |
858
+
859
+ The three in the last row are `--bb-primary-fg`, `--bb-primary-border` and
860
+ `--bb-link-fg`.
861
+
862
+ `kind` is **not** a curated list. It is read from the shipped stylesheet, where
863
+ the split is structural: knobs are declared on the plain scheme roots, formulas
864
+ inside the `:where(…)` boundary block. There is nothing to keep in sync, and
865
+ `check:mcp` pins it.
480
866
 
481
867
  ## Reading tokens outside CSS
482
868
 
@@ -609,9 +995,10 @@ escape the host dialog's `overflow: hidden` and centering transform.
609
995
  | `--bb-overlay-color` + `--bb-overlay-opacity` | `--bb-overlay` (one color with alpha) |
610
996
  | `--bb-overlay-z-index` | `--bb-z-overlay` |
611
997
  | inline ring `color-mix()` formulas | `--bb-ring` / `--bb-ring-danger` (strength knob: `--bb-ring-opacity`) |
612
- | `--bb-dialog-px/pt/pb/gap/…` | `--bb-panel-p` (+ local derivations) |
998
+ | `--bb-dialog-px/pt/pb/gap/…` | `--bb-panel-p` + the local axis pair `--px`/`--py` on the surface roots |
613
999
  | `--bb-button-*`, `--bb-tabs-*`, `--bb-checkbox-*`, `--bb-radio-*`, `--bb-switch-*`, `--bb-rating-*`, `--bb-slider-*`, `--bb-table-cell-h`, `--bb-progress-track` | unprefixed locals in each component's CSS |
614
- | `--bb-table-offset-*`, `--bb-table-fill`, `--bb-table-natural-width` (JS plumbing) | unprefixed locals on `.bb-table` (`--offset-*`, `--fill`, `--natural-width`) |
1000
+ | `--bb-table-offset-*` (JS plumbing) | unprefixed locals on `.bb-table` (`--offset-*`) |
1001
+ | `--bb-table-fill`, `--bb-table-natural-width` | **removed** with the grid substrate — nothing publishes them any more (v3.0) |
615
1002
  | `--bb-table-{id}-track-{key}` (parent→nested width bridge) | `--table-{id}-track-{key}` (distinctive cross-component name, rule 3) |
616
1003
  | `--bb-select-option-*`, `--bb-primary-base`, all `--x-light`/`--x-dark` shadows | deleted (dead) |
617
1004
 
@@ -648,8 +1035,9 @@ Registering component tokens (`@property --w { inherits: false; … }`) looks
648
1035
  like it would replace the seal rule structurally, but it breaks the system:
649
1036
 
650
1037
  - `inherits: false` stops the root→descendant flow _inside_ a component
651
- (declare on `.bb-base-switch`, consume on `__icon` — that is inheritance),
652
- which is also what makes `style="--list-h: 40px"` overrides work. CSS
1038
+ (declare on a component's root, consume on one of its elements — that is
1039
+ inheritance),
1040
+ which is also what makes `style="--indent: 14px"` overrides work. CSS
653
1041
  cannot express "inherit within my subtree but not into nested components".
654
1042
  - A registered property always has a value, so `var(--max-h, none)`
655
1043
  fallbacks never fire again — our sealing pattern dies.