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.
- package/README.md +317 -98
- package/bin/bitboss-ui-mcp.mjs +1566 -75
- package/bin/bitboss-ui.mjs +716 -72
- package/dist/ai/BbAccordion.md +178 -56
- package/dist/ai/BbAlert.md +140 -28
- package/dist/ai/BbAsterisk.md +61 -4
- package/dist/ai/BbAvatar.md +194 -53
- package/dist/ai/BbBadge.md +250 -50
- package/dist/ai/BbBadgeButton.md +74 -21
- package/dist/ai/BbBaseButton.md +132 -51
- package/dist/ai/BbBaseCheckboxIcon.md +118 -26
- package/dist/ai/BbBaseRadioIcon.md +115 -26
- package/dist/ai/BbBaseSwitchIcon.md +123 -28
- package/dist/ai/BbBreadcrumbs.md +221 -51
- package/dist/ai/BbButton.md +389 -107
- package/dist/ai/BbCalendar.md +667 -0
- package/dist/ai/BbCheckbox.md +242 -80
- package/dist/ai/BbCheckboxGroup.md +575 -66
- package/dist/ai/BbCollapsible.md +158 -39
- package/dist/ai/BbColorInput.md +322 -82
- package/dist/ai/BbColorPalette.md +261 -61
- package/dist/ai/BbConfirm.md +220 -51
- package/dist/ai/BbConfirmPortal.md +1 -1
- package/dist/ai/BbDatePicker.md +272 -37
- package/dist/ai/BbDatePickerInput.md +321 -92
- package/dist/ai/BbDialog.md +492 -87
- package/dist/ai/BbDropdown.md +1182 -104
- package/dist/ai/BbDropdownButton.md +239 -61
- package/dist/ai/BbDropdownGroup.md +5 -5
- package/dist/ai/BbDropzone.md +140 -36
- package/dist/ai/BbForm.md +1165 -40
- package/dist/ai/BbIcon.md +100 -33
- package/dist/ai/BbIndicator.md +79 -12
- package/dist/ai/BbNumberInput.md +257 -87
- package/dist/ai/BbOffCanvas.md +396 -91
- package/dist/ai/BbPagination.md +199 -32
- package/dist/ai/BbPopover.md +219 -54
- package/dist/ai/BbProgress.md +137 -71
- package/dist/ai/BbPtScope.md +136 -0
- package/dist/ai/BbRadio.md +234 -43
- package/dist/ai/BbRadioGroup.md +529 -91
- package/dist/ai/BbRating.md +243 -61
- package/dist/ai/BbSelect.md +690 -120
- package/dist/ai/BbSelectPopover.md +434 -122
- package/dist/ai/BbSlider.md +275 -79
- package/dist/ai/BbSmoothHeight.md +142 -34
- package/dist/ai/BbSpinner.md +179 -81
- package/dist/ai/BbSwitch.md +249 -63
- package/dist/ai/BbSwitchGroup.md +394 -65
- package/dist/ai/BbTable.md +1666 -222
- package/dist/ai/BbTabs.md +898 -178
- package/dist/ai/BbTabsList.md +81 -7
- package/dist/ai/BbTabsPanels.md +77 -0
- package/dist/ai/BbTabsRoot.md +16 -15
- package/dist/ai/BbTag.md +256 -76
- package/dist/ai/BbTextInput.md +480 -102
- package/dist/ai/BbTextarea.md +310 -96
- package/dist/ai/BbTimePicker.md +159 -24
- package/dist/ai/BbTimePickerInput.md +277 -46
- package/dist/ai/BbToast.md +286 -40
- package/dist/ai/BbToastPortal.md +3 -3
- package/dist/ai/BbTooltip.md +187 -34
- package/dist/ai/BbTree.md +260 -85
- package/dist/ai/ChipsBox.md +43 -2
- package/dist/ai/ClearableButton.md +12 -0
- package/dist/ai/CommaBox.md +2 -1
- package/dist/ai/CommonField.md +63 -0
- package/dist/ai/CommonFieldInput.md +90 -0
- package/dist/ai/CommonPopover.md +17 -12
- package/dist/ai/CommonTimeSelector.md +63 -0
- package/dist/ai/ErrorIcon.md +20 -0
- package/dist/ai/FlatListBox.md +41 -11
- package/dist/ai/GroupedListBox.md +42 -12
- package/dist/ai/ListBox.md +46 -11
- package/dist/ai/OptionsContainer.md +13 -10
- package/dist/ai/WarningIcon.md +20 -0
- package/dist/ai/changelog.json +4025 -141
- package/dist/ai/components.json +51872 -10136
- package/dist/ai/composables/useBbConfig.md +72 -11
- package/dist/ai/composables/useBbDropdownContext.md +168 -0
- package/dist/ai/composables/useBbFormContext.md +51 -24
- package/dist/ai/composables/useBbFormField.md +134 -0
- package/dist/ai/composables/useBbTableContext.md +41 -19
- package/dist/ai/composables/useConfirm.md +16 -8
- package/dist/ai/composables/useCountdown.md +1 -1
- package/dist/ai/composables/useId.md +10 -10
- package/dist/ai/composables/useMobile.md +17 -10
- package/dist/ai/composables/useToast.md +25 -19
- package/dist/ai/design-tokens.json +940 -0
- package/dist/ai/design-tokens.manifest.yaml +175 -0
- package/dist/ai/guides/agent-contract.md +168 -22
- package/dist/ai/guides/ai-router.md +79 -40
- package/dist/ai/guides/app-layout.md +8 -4
- package/dist/ai/guides/coherence-playbook.md +8 -8
- package/dist/ai/guides/component-picker.md +42 -34
- package/dist/ai/guides/design-language.md +274 -97
- package/dist/ai/guides/design-tokens.md +493 -105
- package/dist/ai/guides/fetch-items-playbook.md +22 -16
- package/dist/ai/guides/icons-policy.md +67 -35
- package/dist/ai/guides/inertia-helpers.md +4 -1
- package/dist/ai/guides/inline-edit-playbook.md +13 -6
- package/dist/ai/guides/installation-and-plugin-setup.md +817 -73
- package/dist/ai/guides/migration/components/bb-accordion.md +37 -0
- package/dist/ai/guides/migration/components/bb-alert.md +2 -2
- package/dist/ai/guides/migration/components/bb-avatar.md +13 -14
- package/dist/ai/guides/migration/components/bb-badge.md +5 -5
- package/dist/ai/guides/migration/components/bb-breadcrumbs.md +9 -8
- package/dist/ai/guides/migration/components/bb-button.md +80 -20
- package/dist/ai/guides/migration/components/bb-checkbox-group.md +116 -29
- package/dist/ai/guides/migration/components/bb-checkbox.md +53 -10
- package/dist/ai/guides/migration/components/bb-chip.md +6 -6
- package/dist/ai/guides/migration/components/bb-collapsible.md +5 -5
- package/dist/ai/guides/migration/components/bb-color-input.md +5 -5
- package/dist/ai/guides/migration/components/bb-color-palette.md +16 -9
- package/dist/ai/guides/migration/components/bb-date-picker-input.md +45 -35
- package/dist/ai/guides/migration/components/bb-dialog.md +69 -36
- package/dist/ai/guides/migration/components/bb-dropdown-button.md +7 -1
- package/dist/ai/guides/migration/components/bb-dropdown.md +31 -8
- package/dist/ai/guides/migration/components/bb-dropzone.md +8 -0
- package/dist/ai/guides/migration/components/bb-icon.md +7 -7
- package/dist/ai/guides/migration/components/bb-intersection.md +1 -1
- package/dist/ai/guides/migration/components/bb-offcanvas.md +29 -31
- package/dist/ai/guides/migration/components/bb-pagination.md +10 -0
- package/dist/ai/guides/migration/components/bb-popover.md +19 -11
- package/dist/ai/guides/migration/components/bb-radio-group.md +14 -0
- package/dist/ai/guides/migration/components/bb-rating.md +61 -24
- package/dist/ai/guides/migration/components/bb-select-popover.md +9 -1
- package/dist/ai/guides/migration/components/bb-select.md +21 -4
- package/dist/ai/guides/migration/components/bb-slider.md +14 -6
- package/dist/ai/guides/migration/components/bb-switch-group.md +14 -0
- package/dist/ai/guides/migration/components/bb-table.md +574 -33
- package/dist/ai/guides/migration/components/bb-tabs.md +91 -41
- package/dist/ai/guides/migration/components/bb-tag.md +9 -7
- package/dist/ai/guides/migration/components/bb-text-input.md +12 -12
- package/dist/ai/guides/migration/components/bb-toast.md +2 -2
- package/dist/ai/guides/migration/components/bb-tooltip.md +18 -0
- package/dist/ai/guides/migration/components/bb-tree.md +11 -9
- package/dist/ai/guides/migration/components/use-confirm.md +9 -1
- package/dist/ai/guides/migration/v2-to-v3.md +828 -240
- package/dist/ai/guides/migration/v3-beta-css-classes.md +751 -0
- package/dist/ai/guides/migration/v3-beta-tooling.md +119 -0
- package/dist/ai/guides/options-items-playbook.md +161 -12
- package/dist/ai/guides/page-shell.md +1 -1
- package/dist/ai/guides/passthrough.md +958 -0
- package/dist/ai/guides/preset-components.md +361 -0
- package/dist/ai/guides/ssr-prefill.md +127 -0
- package/dist/ai/guides/validated-forms.md +466 -55
- package/dist/ai/guides/validation-libraries.md +171 -0
- package/dist/ai/guides/validation-providers.md +113 -0
- package/dist/ai/index.md +45 -44
- package/dist/ai/recipes/inertia/approvals-inbox.md +26 -10
- package/dist/ai/recipes/inertia/command-palette.md +2 -2
- package/dist/ai/recipes/inertia/inline-edit-workspace.md +46 -30
- package/dist/ai/recipes/inertia/layout-scaffold.md +6 -2
- package/dist/ai/recipes/inertia/onboarding.md +30 -8
- package/dist/ai/recipes/inertia/ownership-atlas.md +72 -49
- package/dist/ai/recipes/inertia/record-form.md +53 -19
- package/dist/ai/recipes/inertia/records-workspace.md +201 -49
- package/dist/ai/recipes/inertia/settings-workspace.md +3809 -0
- package/dist/ai/recipes/inertia/upload-center.md +54 -43
- package/dist/ai/recipes/inertia/wizard-form.md +98 -14
- package/dist/ai/recipes/nuxt/approvals-inbox.md +26 -10
- package/dist/ai/recipes/nuxt/command-palette.md +2 -2
- package/dist/ai/recipes/nuxt/inline-edit-workspace.md +68 -52
- package/dist/ai/recipes/nuxt/layout-scaffold.md +6 -2
- package/dist/ai/recipes/nuxt/onboarding.md +30 -8
- package/dist/ai/recipes/nuxt/record-form.md +66 -22
- package/dist/ai/recipes/nuxt/records-workspace.md +199 -48
- package/dist/ai/recipes/nuxt/settings-workspace.md +3898 -0
- package/dist/ai/recipes/nuxt/upload-center.md +52 -41
- package/dist/ai/recipes/nuxt/wizard-form.md +98 -14
- package/dist/ai/recipes/vue/approvals-inbox.md +28 -12
- package/dist/ai/recipes/vue/command-palette.md +2 -2
- package/dist/ai/recipes/vue/inline-edit-workspace.md +69 -53
- package/dist/ai/recipes/vue/layout-scaffold.md +6 -2
- package/dist/ai/recipes/vue/onboarding.md +32 -8
- package/dist/ai/recipes/vue/record-form.md +81 -54
- package/dist/ai/recipes/vue/records-workspace.md +198 -49
- package/dist/ai/recipes/vue/settings-workspace.md +3836 -0
- package/dist/ai/recipes/vue/upload-center.md +53 -42
- package/dist/ai/recipes/vue/wizard-form.md +97 -14
- package/dist/ai/source/BbAccordion.md +90 -24
- package/dist/ai/source/BbAlert.md +209 -62
- package/dist/ai/source/BbAsterisk.md +54 -4
- package/dist/ai/source/BbAvatar.md +73 -16
- package/dist/ai/source/BbBadge.md +265 -97
- package/dist/ai/source/BbBadgeButton.md +218 -79
- package/dist/ai/source/BbBaseButton.md +108 -12
- package/dist/ai/source/BbBaseCheckboxIcon.md +151 -36
- package/dist/ai/source/BbBaseRadioIcon.md +121 -17
- package/dist/ai/source/BbBaseSwitchIcon.md +138 -28
- package/dist/ai/source/BbBreadcrumbs.md +363 -69
- package/dist/ai/source/BbButton.md +563 -174
- package/dist/ai/source/BbCalendar.md +1744 -0
- package/dist/ai/source/BbCheckbox.md +470 -68
- package/dist/ai/source/BbCheckboxGroup.md +976 -95
- package/dist/ai/source/BbCollapsible.md +96 -8
- package/dist/ai/source/BbColorInput.md +597 -67
- package/dist/ai/source/BbColorPalette.md +1284 -65
- package/dist/ai/source/BbConfirm.md +149 -7
- package/dist/ai/source/BbConfirmPortal.md +89 -3
- package/dist/ai/source/BbDatePicker.md +527 -381
- package/dist/ai/source/BbDatePickerInput.md +2015 -118
- package/dist/ai/source/BbDialog.md +531 -64
- package/dist/ai/source/BbDropdown.md +885 -175
- package/dist/ai/source/BbDropdownButton.md +377 -79
- package/dist/ai/source/BbDropdownGroup.md +687 -96
- package/dist/ai/source/BbDropzone.md +140 -31
- package/dist/ai/source/BbForm.md +875 -17
- package/dist/ai/source/BbIcon.md +130 -52
- package/dist/ai/source/BbIndicator.md +117 -60
- package/dist/ai/source/BbNumberInput.md +667 -84
- package/dist/ai/source/BbOffCanvas.md +1007 -261
- package/dist/ai/source/BbPagination.md +203 -31
- package/dist/ai/source/BbPopover.md +267 -90
- package/dist/ai/source/BbProgress.md +88 -26
- package/dist/ai/source/BbPtScope.md +54 -0
- package/dist/ai/source/BbRadio.md +388 -58
- package/dist/ai/source/BbRadioGroup.md +940 -109
- package/dist/ai/source/BbRating.md +736 -84
- package/dist/ai/source/BbSelect.md +1096 -96
- package/dist/ai/source/BbSelectPopover.md +807 -114
- package/dist/ai/source/BbSlider.md +1390 -98
- package/dist/ai/source/BbSmoothHeight.md +48 -2
- package/dist/ai/source/BbSpinner.md +62 -6
- package/dist/ai/source/BbSwitch.md +297 -60
- package/dist/ai/source/BbSwitchGroup.md +761 -83
- package/dist/ai/source/BbTable.md +6950 -1864
- package/dist/ai/source/BbTabs.md +368 -111
- package/dist/ai/source/BbTabsList.md +503 -146
- package/dist/ai/source/BbTabsPanels.md +625 -0
- package/dist/ai/source/BbTabsRoot.md +319 -100
- package/dist/ai/source/BbTag.md +796 -87
- package/dist/ai/source/BbTextInput.md +497 -68
- package/dist/ai/source/BbTextarea.md +550 -65
- package/dist/ai/source/BbTimePicker.md +395 -69
- package/dist/ai/source/BbTimePickerInput.md +1233 -106
- package/dist/ai/source/BbToast.md +250 -74
- package/dist/ai/source/BbToastPortal.md +210 -66
- package/dist/ai/source/BbTooltip.md +181 -30
- package/dist/ai/source/BbTree.md +76 -11
- package/dist/ai/source/ChipsBox.md +25 -5
- package/dist/ai/source/CommaBox.md +21 -6
- package/dist/ai/source/{BbBaseInputContainer.md → CommonField.md} +467 -250
- package/dist/ai/source/CommonFieldInput.md +848 -0
- package/dist/ai/source/CommonPopover.md +116 -30
- package/dist/ai/source/CommonTimeSelector.md +726 -0
- package/dist/ai/source/ErrorIcon.md +2 -2
- package/dist/ai/source/FlatListBox.md +188 -17
- package/dist/ai/source/GroupedListBox.md +236 -44
- package/dist/ai/source/GuidesComponent.md +14 -7
- package/dist/ai/source/ListBox.md +46 -8
- package/dist/ai/source/OptionsContainer.md +288 -60
- package/dist/ai/source/WarningIcon.md +2 -2
- package/dist/assets/css/reset.css_inline.js +1 -1
- package/dist/assets/svgs/star.svg_raw.js +4 -0
- package/dist/components/BbAccordion/BbAccordion.vue_vue_type_script_setup_true_lang.js +49 -32
- package/dist/components/BbAccordion/types.d.ts +35 -3
- package/dist/components/BbAccordion/types.js +11 -0
- package/dist/components/BbAlert/BbAlert.vue_vue_type_script_setup_true_lang.js +46 -30
- package/dist/components/BbAlert/types.d.ts +37 -3
- package/dist/components/BbAlert/types.js +13 -0
- package/dist/components/BbAsterisk/BbAsterisk.vue.d.ts +3 -1
- package/dist/components/BbAsterisk/BbAsterisk.vue_vue_type_script_setup_true_lang.js +23 -8
- package/dist/components/BbAsterisk/types.d.ts +18 -0
- package/dist/components/BbAsterisk/types.js +7 -0
- package/dist/components/BbAvatar/BbAvatar.vue.d.ts +1 -1
- package/dist/components/BbAvatar/BbAvatar.vue_vue_type_script_setup_true_lang.js +57 -44
- package/dist/components/BbAvatar/types.d.ts +23 -0
- package/dist/components/BbAvatar/types.js +7 -0
- package/dist/components/BbBadge/BadgeBodyContent.vue_vue_type_script_setup_true_lang.js +24 -18
- package/dist/components/BbBadge/BbBadge.vue_vue_type_script_setup_true_lang.js +96 -53
- package/dist/components/BbBadge/BbBadgeButton.vue_vue_type_script_setup_true_lang.js +27 -8
- package/dist/components/BbBadge/badgeButtonContext.d.ts +25 -8
- package/dist/components/BbBadge/types.d.ts +46 -3
- package/dist/components/BbBadge/types.js +13 -0
- package/dist/components/BbBaseButton/BbBaseButton.vue_vue_type_script_setup_true_lang.js +109 -96
- package/dist/components/BbBaseButton/RouterComponent.vue_vue_type_script_setup_true_lang.js +11 -11
- package/dist/components/BbBaseButton/types.d.ts +33 -3
- package/dist/components/BbBaseButton/types.js +9 -2
- package/dist/components/BbBaseCheckboxIcon/BbBaseCheckboxIcon.vue_vue_type_script_setup_true_lang.js +50 -18
- package/dist/components/BbBaseCheckboxIcon/types.d.ts +31 -2
- package/dist/components/BbBaseCheckboxIcon/types.js +8 -0
- package/dist/components/BbBaseRadioIcon/BbBaseRadioIcon.vue_vue_type_script_setup_true_lang.js +45 -15
- package/dist/components/BbBaseRadioIcon/types.d.ts +31 -2
- package/dist/components/BbBaseRadioIcon/types.js +8 -0
- package/dist/components/BbBaseSwitchIcon/BbBaseSwitchIcon.vue_vue_type_script_setup_true_lang.js +48 -16
- package/dist/components/BbBaseSwitchIcon/types.d.ts +31 -2
- package/dist/components/BbBaseSwitchIcon/types.js +8 -0
- package/dist/components/BbBreadcrumbs/BbBreadcrumbs.vue_vue_type_script_setup_true_lang.js +187 -132
- package/dist/components/BbBreadcrumbs/types.d.ts +45 -3
- package/dist/components/BbBreadcrumbs/types.js +12 -0
- package/dist/components/BbButton/BbButton.vue.d.ts +5 -0
- package/dist/components/BbButton/BbButton.vue_vue_type_script_setup_true_lang.js +107 -81
- package/dist/components/BbButton/types.d.ts +113 -2
- package/dist/components/BbButton/types.js +12 -0
- package/dist/components/BbCalendar/BbCalendar.vue.d.ts +34 -0
- package/dist/components/BbCalendar/BbCalendar.vue.js +6 -0
- package/dist/components/BbCalendar/BbCalendar.vue_vue_type_script_setup_true_lang.js +608 -0
- package/dist/components/BbCalendar/CalendarMonthPanel.vue.js +5 -0
- package/dist/components/BbCalendar/CalendarMonthPanel.vue_vue_type_script_setup_true_lang.js +124 -0
- package/dist/components/BbCalendar/CalendarYearPanel.vue.js +5 -0
- package/dist/components/BbCalendar/CalendarYearPanel.vue_vue_type_script_setup_true_lang.js +126 -0
- package/dist/components/BbCalendar/calendarHost.d.ts +29 -0
- package/dist/components/BbCalendar/calendarHost.js +10 -0
- package/dist/components/BbCalendar/types.d.ts +225 -0
- package/dist/components/BbCalendar/types.js +29 -0
- package/dist/components/{BbBaseDatePicker/useDatePickerContext.d.ts → BbCalendar/useCalendarContext.d.ts} +10 -7
- package/dist/components/BbCalendar/useCalendarContext.js +11 -0
- package/dist/components/BbCalendar/useCalendarGrid.d.ts +208 -0
- package/dist/components/BbCalendar/useCalendarGrid.js +274 -0
- package/dist/components/BbCalendar/useDayGrid.d.ts +79 -0
- package/dist/components/BbCalendar/useDayGrid.js +204 -0
- package/dist/components/BbCalendar/useToday.d.ts +23 -0
- package/dist/components/BbCalendar/useToday.js +21 -0
- package/dist/components/BbCheckbox/BbCheckbox.vue.d.ts +7 -7
- package/dist/components/BbCheckbox/BbCheckbox.vue_vue_type_script_setup_true_lang.js +214 -72
- package/dist/components/BbCheckbox/types.d.ts +180 -13
- package/dist/components/BbCheckbox/types.js +8 -0
- package/dist/components/BbCheckboxGroup/BbCheckboxGroup.vue.d.ts +15 -3
- package/dist/components/BbCheckboxGroup/BbCheckboxGroup.vue_vue_type_script_setup_true_lang.js +338 -90
- package/dist/components/BbCheckboxGroup/types.d.ts +195 -20
- package/dist/components/BbCheckboxGroup/types.js +10 -0
- package/dist/components/BbCollapsible/BbCollapsible.vue.d.ts +2 -1
- package/dist/components/BbCollapsible/BbCollapsible.vue_vue_type_script_setup_true_lang.js +41 -19
- package/dist/components/BbCollapsible/types.d.ts +44 -1
- package/dist/components/BbCollapsible/types.js +7 -0
- package/dist/components/BbColorInput/BbColorInput.vue.d.ts +17 -7
- package/dist/components/BbColorInput/BbColorInput.vue_vue_type_script_setup_true_lang.js +330 -86
- package/dist/components/BbColorInput/types.d.ts +230 -12
- package/dist/components/BbColorInput/types.js +24 -0
- package/dist/components/BbColorPalette/BbColorPalette.vue.d.ts +10 -2
- package/dist/components/BbColorPalette/BbColorPalette.vue_vue_type_script_setup_true_lang.js +515 -108
- package/dist/components/BbColorPalette/types.d.ts +76 -7
- package/dist/components/BbColorPalette/types.js +12 -0
- package/dist/components/BbConfirm/BbConfirm.vue.d.ts +2 -1
- package/dist/components/BbConfirm/BbConfirm.vue_vue_type_script_setup_true_lang.js +125 -76
- package/dist/components/BbConfirm/BbConfirmPortal.vue.d.ts +1 -0
- package/dist/components/BbConfirm/types.d.ts +49 -0
- package/dist/components/BbConfirm/types.js +17 -0
- package/dist/components/BbDatePicker/BbDatePicker.vue.d.ts +16 -10
- package/dist/components/BbDatePicker/BbDatePicker.vue_vue_type_script_setup_true_lang.js +320 -223
- package/dist/components/BbDatePicker/types.d.ts +111 -17
- package/dist/components/BbDatePicker/types.js +33 -0
- package/dist/components/BbDatePickerInput/BbDatePickerInput.vue.d.ts +16 -4
- package/dist/components/BbDatePickerInput/BbDatePickerInput.vue_vue_type_script_setup_true_lang.js +1172 -87
- package/dist/components/BbDatePickerInput/types.d.ts +224 -19
- package/dist/components/BbDatePickerInput/types.js +39 -0
- package/dist/components/BbDialog/BbDialog.vue.d.ts +3 -3
- package/dist/components/BbDialog/BbDialog.vue_vue_type_script_setup_true_lang.js +227 -136
- package/dist/components/BbDialog/types.d.ts +92 -3
- package/dist/components/BbDialog/types.js +16 -0
- package/dist/components/BbDialog/useDialogStack.d.ts +12 -0
- package/dist/components/BbDialog/useDialogStack.js +9 -2
- package/dist/components/BbDropdown/AdaptiveDropdown.vue.d.ts +2 -0
- package/dist/components/BbDropdown/AdaptiveDropdown.vue_vue_type_script_setup_true_lang.js +108 -96
- package/dist/components/BbDropdown/BbDropdown.vue.d.ts +10 -2
- package/dist/components/BbDropdown/BbDropdown.vue_vue_type_script_setup_true_lang.js +337 -268
- package/dist/components/BbDropdown/BbDropdownGroup.vue.d.ts +5 -1
- package/dist/components/BbDropdown/BbDropdownList.vue.d.ts +8 -2
- package/dist/components/BbDropdown/BbDropdownList.vue_vue_type_script_setup_true_lang.js +377 -293
- package/dist/components/BbDropdown/DropdownPipelineResolver.vue_vue_type_script_setup_true_lang.js +129 -118
- package/dist/components/BbDropdown/normalizeGroups.js +55 -31
- package/dist/components/BbDropdown/types.d.ts +288 -30
- package/dist/components/BbDropdown/types.js +21 -2
- package/dist/components/BbDropdown/useDropdownContext.d.ts +10 -4
- package/dist/components/BbDropdown/useDropdownGroupRegistry.d.ts +1 -0
- package/dist/components/BbDropdownButton/BbDropdownButton.vue.d.ts +18 -3
- package/dist/components/BbDropdownButton/BbDropdownButton.vue_vue_type_script_setup_true_lang.js +172 -40
- package/dist/components/BbDropdownButton/types.d.ts +137 -8
- package/dist/components/BbDropdownButton/types.js +35 -0
- package/dist/components/BbDropzone/BbDropzone.vue.d.ts +2 -2
- package/dist/components/BbDropzone/BbDropzone.vue_vue_type_script_setup_true_lang.js +186 -144
- package/dist/components/BbDropzone/types.d.ts +38 -4
- package/dist/components/BbDropzone/types.js +16 -0
- package/dist/components/BbForm/BbForm.vue.d.ts +94 -0
- package/dist/{validated → components/BbForm}/BbForm.vue.js +1 -1
- package/dist/components/BbForm/BbForm.vue_vue_type_script_setup_true_lang.js +317 -0
- package/dist/components/BbForm/BbFormCustomField.d.ts +14 -0
- package/dist/components/BbForm/BbFormCustomField.js +43 -0
- package/dist/components/BbForm/bindFormField.d.ts +16 -0
- package/dist/components/BbForm/bindFormField.js +85 -0
- package/dist/components/BbForm/formFields.d.ts +64 -0
- package/dist/components/BbForm/formFields.js +11 -0
- package/dist/components/BbForm/formSchema.d.ts +56 -0
- package/dist/components/BbForm/formSchema.js +196 -0
- package/dist/components/BbForm/standardSchema.d.ts +59 -0
- package/dist/components/BbIcon/BbIcon.vue_vue_type_script_setup_true_lang.js +58 -48
- package/dist/components/BbIcon/iconCache.d.ts +63 -0
- package/dist/components/BbIcon/iconCache.js +35 -0
- package/dist/components/BbIcon/types.d.ts +22 -2
- package/dist/components/BbIcon/types.js +7 -0
- package/dist/components/BbIndicator/BbIndicator.vue_vue_type_script_setup_true_lang.js +34 -21
- package/dist/components/BbIndicator/types.d.ts +24 -0
- package/dist/components/BbIndicator/types.js +7 -0
- package/dist/components/BbNumberInput/BbNumberInput.vue.d.ts +12 -8
- package/dist/components/BbNumberInput/BbNumberInput.vue_vue_type_script_setup_true_lang.js +308 -85
- package/dist/components/BbNumberInput/types.d.ts +201 -18
- package/dist/components/BbNumberInput/types.js +8 -0
- package/dist/components/BbOffCanvas/BbOffCanvas.vue.d.ts +3 -3
- package/dist/components/BbOffCanvas/BbOffCanvas.vue_vue_type_script_setup_true_lang.js +311 -210
- package/dist/components/BbOffCanvas/types.d.ts +79 -6
- package/dist/components/BbOffCanvas/types.js +15 -0
- package/dist/components/BbPagination/BbPagination.vue.d.ts +2 -2
- package/dist/components/BbPagination/BbPagination.vue_vue_type_script_setup_true_lang.js +125 -90
- package/dist/components/BbPagination/types.d.ts +38 -0
- package/dist/components/BbPagination/types.js +13 -0
- package/dist/components/BbPopover/BbPopover.vue.d.ts +4 -4
- package/dist/components/BbPopover/BbPopover.vue_vue_type_script_setup_true_lang.js +219 -179
- package/dist/components/BbPopover/types.d.ts +51 -5
- package/dist/components/BbPopover/types.js +14 -0
- package/dist/components/BbProgress/BbProgress.vue_vue_type_script_setup_true_lang.js +29 -16
- package/dist/components/BbProgress/types.d.ts +25 -0
- package/dist/components/BbProgress/types.js +7 -0
- package/dist/components/BbPtScope/BbPtScope.vue.d.ts +12 -0
- package/dist/components/BbPtScope/BbPtScope.vue.js +5 -0
- package/dist/components/BbPtScope/BbPtScope.vue_vue_type_script_setup_true_lang.js +13 -0
- package/dist/components/BbPtScope/types.d.ts +15 -0
- package/dist/components/BbRadio/BbRadio.vue.d.ts +7 -7
- package/dist/components/BbRadio/BbRadio.vue_vue_type_script_setup_true_lang.js +172 -59
- package/dist/components/BbRadio/types.d.ts +152 -13
- package/dist/components/BbRadio/types.js +8 -0
- package/dist/components/BbRadioGroup/BbRadioGroup.vue.d.ts +14 -2
- package/dist/components/BbRadioGroup/BbRadioGroup.vue_vue_type_script_setup_true_lang.js +319 -92
- package/dist/components/BbRadioGroup/types.d.ts +198 -22
- package/dist/components/BbRadioGroup/types.js +10 -0
- package/dist/components/BbRating/BbRating.vue.d.ts +10 -8
- package/dist/components/BbRating/BbRating.vue_vue_type_script_setup_true_lang.js +259 -78
- package/dist/components/BbRating/types.d.ts +174 -13
- package/dist/components/BbRating/types.js +21 -0
- package/dist/components/BbSelect/BbSelect.vue.d.ts +17 -3
- package/dist/components/BbSelect/BbSelect.vue_vue_type_script_setup_true_lang.js +553 -83
- package/dist/components/BbSelect/types.d.ts +235 -20
- package/dist/components/BbSelect/types.js +41 -0
- package/dist/components/BbSelectPopover/BbSelectPopover.vue.d.ts +15 -1
- package/dist/components/BbSelectPopover/BbSelectPopover.vue_vue_type_script_setup_true_lang.js +541 -391
- package/dist/components/BbSelectPopover/types.d.ts +124 -8
- package/dist/components/BbSelectPopover/types.js +24 -0
- package/dist/components/BbSlider/BbSlider.vue.d.ts +13 -8
- package/dist/components/BbSlider/BbSlider.vue_vue_type_script_setup_true_lang.js +472 -96
- package/dist/components/BbSlider/types.d.ts +202 -13
- package/dist/components/BbSlider/types.js +26 -0
- package/dist/components/BbSmoothHeight/BbSmoothHeight.vue.d.ts +1 -1
- package/dist/components/BbSmoothHeight/BbSmoothHeight.vue_vue_type_script_setup_true_lang.js +60 -48
- package/dist/components/BbSmoothHeight/types.d.ts +19 -0
- package/dist/components/BbSmoothHeight/types.js +7 -0
- package/dist/components/BbSpinner/BbSpinner.vue_vue_type_script_setup_true_lang.js +27 -14
- package/dist/components/BbSpinner/types.d.ts +22 -1
- package/dist/components/BbSpinner/types.js +7 -0
- package/dist/components/BbSwitch/BbSwitch.vue.d.ts +7 -7
- package/dist/components/BbSwitch/BbSwitch.vue_vue_type_script_setup_true_lang.js +220 -78
- package/dist/components/BbSwitch/types.d.ts +25 -10
- package/dist/components/BbSwitch/types.js +5 -0
- package/dist/components/BbSwitchGroup/BbSwitchGroup.vue.d.ts +14 -2
- package/dist/components/BbSwitchGroup/BbSwitchGroup.vue_vue_type_script_setup_true_lang.js +338 -90
- package/dist/components/BbSwitchGroup/types.d.ts +30 -7
- package/dist/components/BbSwitchGroup/types.js +5 -0
- package/dist/components/BbTable/BbTable.vue.d.ts +27 -6
- package/dist/components/BbTable/BbTable.vue_vue_type_script_setup_true_lang.js +2013 -685
- package/dist/components/BbTable/BbTableDataRow.d.ts +196 -0
- package/dist/components/BbTable/BbTableDataRow.js +151 -0
- package/dist/components/BbTable/BbTableExpandRow.d.ts +84 -0
- package/dist/components/BbTable/BbTableExpandRow.js +62 -0
- package/dist/components/BbTable/BbTableSelectToggle.d.ts +120 -0
- package/dist/components/BbTable/BbTableSelectToggle.js +122 -0
- package/dist/components/BbTable/gridWidgets.d.ts +30 -0
- package/dist/components/BbTable/gridWidgets.js +14 -0
- package/dist/components/BbTable/types.d.ts +473 -123
- package/dist/components/BbTable/types.js +31 -0
- package/dist/components/BbTable/utils.d.ts +145 -4
- package/dist/components/BbTable/utils.js +154 -37
- package/dist/components/BbTabs/BbTabs.vue.d.ts +3 -1
- package/dist/components/BbTabs/BbTabs.vue_vue_type_script_setup_true_lang.js +62 -26
- package/dist/components/BbTabs/BbTabsList.vue.d.ts +3 -10
- package/dist/components/BbTabs/BbTabsList.vue_vue_type_script_setup_true_lang.js +143 -81
- package/dist/components/BbTabs/BbTabsPanels.vue.d.ts +12 -0
- package/dist/components/{BbBaseSwitch/BbBaseSwitch.vue.js → BbTabs/BbTabsPanels.vue.js} +2 -2
- package/dist/components/BbTabs/BbTabsPanels.vue_vue_type_script_setup_true_lang.js +59 -0
- package/dist/components/BbTabs/BbTabsRoot.vue.d.ts +3 -1
- package/dist/components/BbTabs/BbTabsRoot.vue_vue_type_script_setup_true_lang.js +2 -1
- package/dist/components/BbTabs/types.d.ts +183 -23
- package/dist/components/BbTabs/types.js +34 -0
- package/dist/components/BbTag/BbTag.vue.d.ts +13 -10
- package/dist/components/BbTag/BbTag.vue_vue_type_script_setup_true_lang.js +383 -92
- package/dist/components/BbTag/types.d.ts +139 -14
- package/dist/components/BbTag/types.js +22 -0
- package/dist/components/BbTextInput/BbTextInput.vue.d.ts +10 -8
- package/dist/components/BbTextInput/BbTextInput.vue_vue_type_script_setup_true_lang.js +257 -84
- package/dist/components/BbTextInput/types.d.ts +168 -13
- package/dist/components/BbTextInput/types.js +8 -0
- package/dist/components/BbTextarea/BbTextarea.vue.d.ts +7 -7
- package/dist/components/BbTextarea/BbTextarea.vue_vue_type_script_setup_true_lang.js +291 -94
- package/dist/components/BbTextarea/types.d.ts +158 -14
- package/dist/components/BbTextarea/types.js +8 -0
- package/dist/components/BbTimePicker/BbTimePicker.vue.d.ts +12 -4
- package/dist/components/BbTimePicker/BbTimePicker.vue_vue_type_script_setup_true_lang.js +199 -122
- package/dist/components/BbTimePicker/types.d.ts +94 -7
- package/dist/components/BbTimePicker/types.js +18 -0
- package/dist/components/BbTimePickerInput/BbTimePickerInput.vue.d.ts +14 -4
- package/dist/components/BbTimePickerInput/BbTimePickerInput.vue_vue_type_script_setup_true_lang.js +749 -86
- package/dist/components/BbTimePickerInput/types.d.ts +171 -22
- package/dist/components/BbTimePickerInput/types.js +25 -0
- package/dist/components/BbToast/BbToast.vue_vue_type_script_setup_true_lang.js +63 -25
- package/dist/components/BbToast/BbToastMessage.vue.d.ts +4 -1
- package/dist/components/BbToast/BbToastMessage.vue_vue_type_script_setup_true_lang.js +79 -76
- package/dist/components/BbToast/BbToastPortal.vue.d.ts +1 -0
- package/dist/components/BbToast/BbToastRegion.vue.d.ts +4 -1
- package/dist/components/BbToast/BbToastRegion.vue_vue_type_script_setup_true_lang.js +72 -64
- package/dist/components/BbToast/types.d.ts +54 -1
- package/dist/components/BbToast/types.js +28 -0
- package/dist/components/BbTooltip/BbTooltip.vue_vue_type_script_setup_true_lang.js +104 -87
- package/dist/components/BbTooltip/types.d.ts +40 -2
- package/dist/components/BbTooltip/types.js +7 -0
- package/dist/components/BbTree/BbTree.vue.d.ts +15 -3
- package/dist/components/BbTree/BbTree.vue_vue_type_script_setup_true_lang.js +51 -29
- package/dist/components/BbTree/BbTreeLevel.vue.d.ts +1 -1
- package/dist/components/BbTree/BbTreeLevel.vue_vue_type_script_setup_true_lang.js +17 -16
- package/dist/components/BbTree/context.d.ts +9 -1
- package/dist/components/BbTree/types.d.ts +40 -5
- package/dist/components/BbTree/types.js +7 -0
- package/dist/components/ChipsBox/ChipsBox.vue_vue_type_script_setup_true_lang.js +46 -44
- package/dist/components/ChipsBox/types.d.ts +7 -0
- package/dist/components/ClearableButton/ClearableButton.vue_vue_type_script_setup_true_lang.js +5 -5
- package/dist/components/CommaBox/CommaBox.vue_vue_type_script_setup_true_lang.js +11 -7
- package/dist/components/CommaBox/types.d.ts +7 -0
- package/dist/components/{BbBaseInputContainer/BbBaseInputContainer.vue.d.ts → CommonField/CommonField.vue.d.ts} +5 -5
- package/dist/components/{BbBaseRadio/BbBaseRadio.vue.js → CommonField/CommonField.vue.js} +2 -2
- package/dist/components/CommonField/CommonField.vue_vue_type_script_setup_true_lang.js +189 -0
- package/dist/components/CommonField/messageHeightMatrix.d.ts +2 -0
- package/dist/components/{BbBaseInputContainer → CommonField}/types.d.ts +52 -16
- package/dist/components/{CommonInputWrapper/CommonInputWrapper.vue.d.ts → CommonFieldInput/CommonFieldInput.vue.d.ts} +5 -4
- package/dist/components/{BbBaseRadioGroup/BbBaseRadioGroup.vue.js → CommonFieldInput/CommonFieldInput.vue.js} +2 -2
- package/dist/components/CommonFieldInput/CommonFieldInput.vue_vue_type_script_setup_true_lang.js +120 -0
- package/dist/components/CommonFieldInput/boxBorderMatrix.d.ts +10 -0
- package/dist/components/{CommonInputWrapper → CommonFieldInput}/types.d.ts +27 -8
- package/dist/components/CommonPopover/CommonPopover.vue.d.ts +11 -2
- package/dist/components/CommonPopover/CommonPopover.vue_vue_type_script_setup_true_lang.js +76 -63
- package/dist/components/CommonPopover/types.d.ts +27 -8
- package/dist/components/{BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue.d.ts → CommonTimeSelector/CommonTimeSelector.vue.d.ts} +21 -2
- package/dist/components/{BbBaseColorPalette/BbBaseColorPalette.vue.js → CommonTimeSelector/CommonTimeSelector.vue.js} +2 -2
- package/dist/components/CommonTimeSelector/CommonTimeSelector.vue_vue_type_script_setup_true_lang.js +232 -0
- package/dist/components/CommonTimeSelector/types.d.ts +6 -0
- package/dist/components/FlatListBox/FlatListBox.vue.d.ts +5 -1
- package/dist/components/FlatListBox/FlatListBox.vue_vue_type_script_setup_true_lang.js +165 -95
- package/dist/components/FlatListBox/types.d.ts +24 -2
- package/dist/components/GroupedListBox/GroupedListBox.vue.d.ts +5 -1
- package/dist/components/GroupedListBox/GroupedListBox.vue_vue_type_script_setup_true_lang.js +217 -134
- package/dist/components/GroupedListBox/types.d.ts +24 -2
- package/dist/components/ListBox/ListBox.vue.d.ts +5 -1
- package/dist/components/ListBox/ListBox.vue_vue_type_script_setup_true_lang.js +95 -69
- package/dist/components/ListBox/types.d.ts +24 -2
- package/dist/components/OptionsContainer/OptionsContainer.vue.d.ts +1 -1
- package/dist/components/OptionsContainer/OptionsContainer.vue_vue_type_script_setup_true_lang.js +109 -37
- package/dist/components/OptionsContainer/types.d.ts +53 -9
- package/dist/components/Transitions/ScaleFade.vue_vue_type_script_setup_true_lang.js +8 -8
- package/dist/components/Transitions/Slide.vue.js +1 -1
- package/dist/composables/useBaseOptions.d.ts +12 -1
- package/dist/composables/useBaseOptions.js +77 -37
- package/dist/composables/useBbConfig.d.ts +27 -6
- package/dist/composables/useBbConfig.js +8 -2
- package/dist/composables/useBbDropdownContext.d.ts +5 -0
- package/dist/composables/useBbFormContext.d.ts +131 -8
- package/dist/composables/useBbFormContext.js +49 -30
- package/dist/composables/useBbFormField.d.ts +40 -0
- package/dist/composables/useBbFormField.js +39 -0
- package/dist/composables/useBbTableContext.d.ts +45 -1
- package/dist/composables/useBbTableContext.js +93 -87
- package/dist/composables/useBbTabsContext.d.ts +15 -9
- package/dist/composables/useBbTabsContext.js +121 -90
- package/dist/composables/useClosingInert.d.ts +4 -4
- package/dist/composables/useCoarsePointer.js +7 -10
- package/dist/composables/useCoherence.js +1 -1
- package/dist/composables/useConfig.d.ts +59 -0
- package/dist/composables/useConfig.js +15 -0
- package/dist/composables/useConfirm.d.ts +39 -7
- package/dist/composables/useConfirm.js +50 -41
- package/dist/composables/useEscapeStackEntry.d.ts +13 -0
- package/dist/composables/useEscapeStackEntry.js +16 -0
- package/dist/composables/useFormBinding.d.ts +116 -0
- package/dist/composables/useFormBinding.js +34 -0
- package/dist/composables/useHydrated.d.ts +18 -0
- package/dist/composables/useHydrated.js +13 -7
- package/dist/composables/useId.d.ts +4 -3
- package/dist/composables/useId.js +1 -7
- package/dist/composables/useItemsGetter.d.ts +11 -0
- package/dist/composables/useItemsGetter.js +44 -18
- package/dist/composables/useKeyboardInset.d.ts +28 -0
- package/dist/composables/useKeyboardInset.js +32 -0
- package/dist/composables/useLocale.js +10 -7
- package/dist/composables/useMobile.js +7 -10
- package/dist/composables/usePassthrough.d.ts +228 -0
- package/dist/composables/usePassthrough.js +247 -0
- package/dist/composables/usePrefill.d.ts +22 -2
- package/dist/composables/usePrefill.js +35 -19
- package/dist/composables/useSafeAreaInternal.js +1 -1
- package/dist/composables/useSegmentedFields.d.ts +2 -2
- package/dist/composables/useSsrState.d.ts +20 -0
- package/dist/composables/useSsrState.js +13 -0
- package/dist/composables/useTableWidthContext.d.ts +24 -4
- package/dist/composables/useTableWidthContext.js +31 -28
- package/dist/composables/useToast.d.ts +18 -1
- package/dist/composables/useToast.js +31 -18
- package/dist/composables/useToggleInput.d.ts +44 -0
- package/dist/composables/useToggleInput.js +39 -0
- package/dist/composables/useViewportWidth.d.ts +5 -25
- package/dist/composables/useViewportWidth.js +14 -7
- package/dist/deprecation/ai-deprecations.json.d.ts +1977 -289
- package/dist/deprecation/ai-deprecations.json.js +1 -1
- package/dist/deprecation/removedProps.js +9 -4
- package/dist/directives/bbDropdown.d.ts +15 -4
- package/dist/directives/bbDropdown.js +31 -9
- package/dist/directives/bbTooltip.d.ts +6 -0
- package/dist/directives/createPopoverDirective.d.ts +62 -0
- package/dist/directives/createPopoverDirective.js +92 -37
- package/dist/i18n/index.d.ts +10 -16
- package/dist/i18n/locales/cs.json +9 -5
- package/dist/i18n/locales/da.json +9 -5
- package/dist/i18n/locales/de.json +9 -5
- package/dist/i18n/locales/el.json +9 -5
- package/dist/i18n/locales/en.json +9 -5
- package/dist/i18n/locales/es.json +9 -5
- package/dist/i18n/locales/fi.json +9 -5
- package/dist/i18n/locales/fr.json +9 -5
- package/dist/i18n/locales/hu.json +9 -5
- package/dist/i18n/locales/it.json +9 -5
- package/dist/i18n/locales/ja.json +9 -5
- package/dist/i18n/locales/ko.json +9 -5
- package/dist/i18n/locales/nb.json +9 -5
- package/dist/i18n/locales/nl.json +9 -5
- package/dist/i18n/locales/pl.json +9 -5
- package/dist/i18n/locales/pt.json +9 -5
- package/dist/i18n/locales/ro.json +9 -5
- package/dist/i18n/locales/ru.json +9 -5
- package/dist/i18n/locales/sv.json +9 -5
- package/dist/i18n/locales/tr.json +9 -5
- package/dist/i18n/locales/uk.json +9 -5
- package/dist/i18n/locales/zh-cn.json +9 -5
- package/dist/icon-scan.d.ts +276 -0
- package/dist/icon-scan.js +485 -0
- package/dist/icons-whitelist.d.ts +5 -4
- package/dist/index.d.ts +40 -21
- package/dist/index.js +78 -71
- package/dist/llms-full.txt +61164 -27972
- package/dist/llms-medium.txt +1482 -366
- package/dist/llms.txt +32 -15
- package/dist/locale-blueprint.json +9 -5
- package/dist/nuxt-auto-imports.d.ts +76 -0
- package/dist/nuxt-auto-imports.js +32 -0
- package/dist/nuxt-module.d.ts +30 -15
- package/dist/nuxt.js +35 -9
- package/dist/passthrough-deduper.js +5 -0
- package/dist/plugin.d.ts +10 -1
- package/dist/plugin.js +29 -19
- package/dist/project-dts.d.ts +84 -0
- package/dist/project-dts.js +170 -0
- package/dist/reset.css +1 -1
- package/dist/runtime/nuxt-plugin.js +34 -21
- package/dist/styles.css +3 -2
- package/dist/types/AlertVariant.d.ts +10 -1
- package/dist/types/BadgeVariant.d.ts +16 -5
- package/dist/types/ButtonVariant.d.ts +12 -1
- package/dist/types/ColumnName.d.ts +30 -3
- package/dist/types/CommonProps.d.ts +2 -2
- package/dist/types/Config.d.ts +94 -1
- package/dist/types/ConfirmVariant.d.ts +8 -1
- package/dist/types/DropdownItemVariant.d.ts +8 -1
- package/dist/types/FieldLayout.d.ts +32 -0
- package/dist/types/IndicatorVariant.d.ts +11 -1
- package/dist/types/InputVariant.d.ts +30 -0
- package/dist/types/ItemProps.d.ts +50 -0
- package/dist/types/Option.d.ts +6 -0
- package/dist/types/PtScope.d.ts +15 -0
- package/dist/types/RegistryKey.d.ts +10 -0
- package/dist/types/TabsVariant.d.ts +25 -0
- package/dist/types/ToastVariant.d.ts +12 -2
- package/dist/types/TooltipVariant.d.ts +8 -1
- package/dist/types/passthrough.d.ts +362 -0
- package/dist/types/passthrough.js +78 -0
- package/dist/types/ptComponentMap.d.ts +62 -0
- package/dist/utilities/functions/hasVnodeListener.d.ts +16 -0
- package/dist/utilities/functions/hasVnodeListener.js +12 -0
- package/dist/utilities/functions/isImeComposing.d.ts +7 -0
- package/dist/utilities/functions/isImeComposing.js +4 -0
- package/dist/utilities/functions/itemProps.d.ts +46 -0
- package/dist/utilities/functions/itemProps.js +47 -0
- package/dist/utilities/functions/slotKey.d.ts +13 -8
- package/dist/utilities/functions/slotKey.js +78 -2
- package/dist/utilities/functions/snapToStep.js +2 -1
- package/dist/utilities/functions/toggleInput.d.ts +98 -0
- package/dist/utilities/functions/toggleInput.js +56 -0
- package/dist/utilities/functions/warnRemovedAttrs.d.ts +27 -1
- package/dist/utilities/functions/warnRemovedAttrs.js +75 -14
- package/dist/utilities/misc/listboxMetrics.d.ts +9 -3
- package/dist/utilities/misc/listboxMetrics.js +5 -2
- package/dist/utilities/misc/ssrStateInjectionKey.d.ts +42 -0
- package/dist/utilities/misc/ssrStateInjectionKey.js +4 -0
- package/dist/utils/cssLayers.d.ts +91 -0
- package/dist/utils/cssLayers.js +43 -0
- package/dist/utils/injectLibraryStyles.d.ts +3 -1
- package/dist/utils/injectLibraryStyles.js +24 -23
- package/dist/utils/overlayEscapeStack.d.ts +10 -0
- package/dist/utils/overlayEscapeStack.js +5 -3
- package/dist/utils/passthrough.d.ts +67 -0
- package/dist/utils/passthrough.js +100 -0
- package/dist/utils/passthroughDeduper.d.ts +2 -0
- package/dist/utils/ptScope.d.ts +8 -0
- package/dist/utils/ptScope.js +4 -0
- package/dist/utils/versionCheck.d.ts +19 -0
- package/dist/utils/versionCheck.js +18 -0
- package/dist/vite-plugin.d.ts +301 -53
- package/dist/vite.js +547 -375
- package/llms.txt +33 -16
- package/package.json +49 -27
- package/scripts/lib/check-fix.mjs +129 -0
- package/scripts/lib/component-attr-targets.ts +123 -0
- package/scripts/lib/component-tree.ts +648 -0
- package/scripts/lib/css-class-check.mjs +326 -0
- package/scripts/lib/css-class-surface.mjs +292 -0
- package/scripts/lib/css-color-resolve.mjs +172 -0
- package/scripts/lib/css-local-check.mjs +267 -0
- package/scripts/lib/design-token-manifest.mjs +499 -0
- package/scripts/lib/doc-sections.mjs +248 -0
- package/scripts/lib/ensure-manifest.mjs +28 -5
- package/scripts/lib/eslint-disable.mjs +141 -0
- package/scripts/lib/eslint-plugin.d.ts +64 -1
- package/scripts/lib/eslint-plugin.mjs +1285 -30
- package/scripts/lib/hand-imported-styles.mjs +326 -0
- package/scripts/lib/hand-roll-hints.mjs +50 -6
- package/scripts/lib/html-attributes.mjs +353 -0
- package/scripts/lib/local-components.mjs +177 -0
- package/scripts/lib/mcp-config.mjs +87 -58
- package/scripts/lib/migrate-fix.mjs +62 -3
- package/scripts/lib/project-variant-dts.mjs +122 -0
- package/scripts/lib/public-type-exports.mjs +273 -0
- package/scripts/lib/slot-key.mjs +147 -0
- package/scripts/lib/slot-renames.mjs +46 -0
- package/scripts/lib/squashed-slot-words.mjs +133 -0
- package/scripts/lib/validate-bb-markup.mjs +2213 -76
- package/scripts/lib/wrapper-props.mjs +188 -0
- package/dist/ai/BbBaseCheckbox.md +0 -49
- package/dist/ai/BbBaseCheckboxGroup.md +0 -64
- package/dist/ai/BbBaseColorInput.md +0 -65
- package/dist/ai/BbBaseColorPalette.md +0 -39
- package/dist/ai/BbBaseDatePicker.md +0 -43
- package/dist/ai/BbBaseDatePickerInput.md +0 -73
- package/dist/ai/BbBaseInputContainer.md +0 -48
- package/dist/ai/BbBaseNumberInput.md +0 -71
- package/dist/ai/BbBaseRadio.md +0 -46
- package/dist/ai/BbBaseRadioGroup.md +0 -64
- package/dist/ai/BbBaseRating.md +0 -52
- package/dist/ai/BbBaseSelect.md +0 -88
- package/dist/ai/BbBaseSlider.md +0 -56
- package/dist/ai/BbBaseSwitch.md +0 -49
- package/dist/ai/BbBaseSwitchGroup.md +0 -64
- package/dist/ai/BbBaseTag.md +0 -68
- package/dist/ai/BbBaseTextInput.md +0 -75
- package/dist/ai/BbBaseTextarea.md +0 -62
- package/dist/ai/BbBaseTimePickerInput.md +0 -62
- package/dist/ai/BbTabsPanes.md +0 -27
- package/dist/ai/CommonInputWrapper.md +0 -42
- package/dist/ai/source/BbBaseCheckbox.md +0 -461
- package/dist/ai/source/BbBaseCheckboxGroup.md +0 -554
- package/dist/ai/source/BbBaseColorInput.md +0 -431
- package/dist/ai/source/BbBaseColorPalette.md +0 -942
- package/dist/ai/source/BbBaseDatePicker.md +0 -1448
- package/dist/ai/source/BbBaseDatePickerInput.md +0 -1940
- package/dist/ai/source/BbBaseNumberInput.md +0 -617
- package/dist/ai/source/BbBaseRadio.md +0 -381
- package/dist/ai/source/BbBaseRadioGroup.md +0 -539
- package/dist/ai/source/BbBaseRating.md +0 -607
- package/dist/ai/source/BbBaseSelect.md +0 -945
- package/dist/ai/source/BbBaseSlider.md +0 -1144
- package/dist/ai/source/BbBaseSwitch.md +0 -246
- package/dist/ai/source/BbBaseSwitchGroup.md +0 -302
- package/dist/ai/source/BbBaseTag.md +0 -694
- package/dist/ai/source/BbBaseTextInput.md +0 -511
- package/dist/ai/source/BbBaseTextarea.md +0 -504
- package/dist/ai/source/BbBaseTimePickerInput.md +0 -1037
- package/dist/ai/source/BbTabsPanes.md +0 -377
- package/dist/ai/source/CommonInputWrapper.md +0 -584
- package/dist/alert-variants.d.ts +0 -19
- package/dist/assets/svgs/sort.svg_raw.js +0 -4
- package/dist/badge-variants.d.ts +0 -19
- package/dist/button-variants.d.ts +0 -21
- package/dist/components/BbBadge/BadgeAppendIcon.vue.d.ts +0 -3
- package/dist/components/BbBadge/BadgeAppendIcon.vue.js +0 -5
- package/dist/components/BbBadge/BadgeAppendIcon.vue_vue_type_script_setup_true_lang.js +0 -22
- package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue.d.ts +0 -40
- package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue.js +0 -6
- package/dist/components/BbBaseCheckbox/BbBaseCheckbox.vue_vue_type_script_setup_true_lang.js +0 -145
- package/dist/components/BbBaseCheckbox/types.d.ts +0 -224
- package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue.d.ts +0 -19
- package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue.js +0 -6
- package/dist/components/BbBaseCheckboxGroup/BbBaseCheckboxGroup.vue_vue_type_script_setup_true_lang.js +0 -190
- package/dist/components/BbBaseCheckboxGroup/types.d.ts +0 -257
- package/dist/components/BbBaseColorInput/BbBaseColorInput.vue.d.ts +0 -43
- package/dist/components/BbBaseColorInput/BbBaseColorInput.vue.js +0 -6
- package/dist/components/BbBaseColorInput/BbBaseColorInput.vue_vue_type_script_setup_true_lang.js +0 -184
- package/dist/components/BbBaseColorInput/types.d.ts +0 -219
- package/dist/components/BbBaseColorPalette/BbBaseColorPalette.vue.d.ts +0 -13
- package/dist/components/BbBaseColorPalette/BbBaseColorPalette.vue_vue_type_script_setup_true_lang.js +0 -395
- package/dist/components/BbBaseColorPalette/types.d.ts +0 -40
- package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue.d.ts +0 -20
- package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue.js +0 -6
- package/dist/components/BbBaseDatePicker/BbBaseDatePicker.vue_vue_type_script_setup_true_lang.js +0 -407
- package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue.d.ts +0 -47
- package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue.js +0 -5
- package/dist/components/BbBaseDatePicker/BbBaseDatePickerInputDaySelector.vue_vue_type_script_setup_true_lang.js +0 -318
- package/dist/components/BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue.js +0 -5
- package/dist/components/BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue_vue_type_script_setup_true_lang.js +0 -115
- package/dist/components/BbBaseDatePicker/BbBaseDatePickerYearSelector.vue.js +0 -5
- package/dist/components/BbBaseDatePicker/BbBaseDatePickerYearSelector.vue_vue_type_script_setup_true_lang.js +0 -116
- package/dist/components/BbBaseDatePicker/types.d.ts +0 -108
- package/dist/components/BbBaseDatePicker/useDatePickerContext.js +0 -11
- package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue.d.ts +0 -31
- package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue.js +0 -6
- package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerInput.vue_vue_type_script_setup_true_lang.js +0 -737
- package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue.js +0 -6
- package/dist/components/BbBaseDatePickerInput/BbBaseDatePickerTimeSelector.vue_vue_type_script_setup_true_lang.js +0 -204
- package/dist/components/BbBaseDatePickerInput/types.d.ts +0 -325
- package/dist/components/BbBaseInputContainer/BbBaseInputContainer.vue.js +0 -6
- package/dist/components/BbBaseInputContainer/BbBaseInputContainer.vue_vue_type_script_setup_true_lang.js +0 -190
- package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue.d.ts +0 -52
- package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue.js +0 -6
- package/dist/components/BbBaseNumberInput/BbBaseNumberInput.vue_vue_type_script_setup_true_lang.js +0 -215
- package/dist/components/BbBaseNumberInput/types.d.ts +0 -211
- package/dist/components/BbBaseRadio/BbBaseRadio.vue.d.ts +0 -33
- package/dist/components/BbBaseRadio/BbBaseRadio.vue_vue_type_script_setup_true_lang.js +0 -113
- package/dist/components/BbBaseRadio/types.d.ts +0 -179
- package/dist/components/BbBaseRadioGroup/BbBaseRadioGroup.vue.d.ts +0 -19
- package/dist/components/BbBaseRadioGroup/BbBaseRadioGroup.vue_vue_type_script_setup_true_lang.js +0 -179
- package/dist/components/BbBaseRadioGroup/types.d.ts +0 -223
- package/dist/components/BbBaseRating/BbBaseRating.vue.d.ts +0 -38
- package/dist/components/BbBaseRating/BbBaseRating.vue.js +0 -6
- package/dist/components/BbBaseRating/BbBaseRating.vue_vue_type_script_setup_true_lang.js +0 -192
- package/dist/components/BbBaseRating/types.d.ts +0 -176
- package/dist/components/BbBaseSelect/BbBaseSelect.vue.d.ts +0 -19
- package/dist/components/BbBaseSelect/BbBaseSelect.vue.js +0 -6
- package/dist/components/BbBaseSelect/BbBaseSelect.vue_vue_type_script_setup_true_lang.js +0 -311
- package/dist/components/BbBaseSelect/types.d.ts +0 -297
- package/dist/components/BbBaseSlider/BbBaseSlider.vue.d.ts +0 -35
- package/dist/components/BbBaseSlider/BbBaseSlider.vue.js +0 -6
- package/dist/components/BbBaseSlider/BbBaseSlider.vue_vue_type_script_setup_true_lang.js +0 -340
- package/dist/components/BbBaseSlider/types.d.ts +0 -200
- package/dist/components/BbBaseSwitch/BbBaseSwitch.vue.d.ts +0 -35
- package/dist/components/BbBaseSwitch/BbBaseSwitch.vue_vue_type_script_setup_true_lang.js +0 -146
- package/dist/components/BbBaseSwitch/types.d.ts +0 -10
- package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue.d.ts +0 -19
- package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue.js +0 -6
- package/dist/components/BbBaseSwitchGroup/BbBaseSwitchGroup.vue_vue_type_script_setup_true_lang.js +0 -190
- package/dist/components/BbBaseSwitchGroup/types.d.ts +0 -8
- package/dist/components/BbBaseTag/BbBaseTag.vue.d.ts +0 -50
- package/dist/components/BbBaseTag/BbBaseTag.vue.js +0 -6
- package/dist/components/BbBaseTag/BbBaseTag.vue_vue_type_script_setup_true_lang.js +0 -266
- package/dist/components/BbBaseTag/types.d.ts +0 -160
- package/dist/components/BbBaseTextInput/BbBaseTextInput.vue.d.ts +0 -45
- package/dist/components/BbBaseTextInput/BbBaseTextInput.vue.js +0 -6
- package/dist/components/BbBaseTextInput/BbBaseTextInput.vue_vue_type_script_setup_true_lang.js +0 -200
- package/dist/components/BbBaseTextInput/types.d.ts +0 -209
- package/dist/components/BbBaseTextarea/BbBaseTextarea.vue.d.ts +0 -39
- package/dist/components/BbBaseTextarea/BbBaseTextarea.vue.js +0 -6
- package/dist/components/BbBaseTextarea/BbBaseTextarea.vue_vue_type_script_setup_true_lang.js +0 -187
- package/dist/components/BbBaseTextarea/types.d.ts +0 -170
- package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue.d.ts +0 -27
- package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue.js +0 -6
- package/dist/components/BbBaseTimePickerInput/BbBaseTimePickerInput.vue_vue_type_script_setup_true_lang.js +0 -519
- package/dist/components/BbBaseTimePickerInput/types.d.ts +0 -151
- package/dist/components/BbTabs/BbTabsPanes.vue.d.ts +0 -16
- package/dist/components/BbTabs/BbTabsPanes.vue.js +0 -6
- package/dist/components/BbTabs/BbTabsPanes.vue_vue_type_script_setup_true_lang.js +0 -35
- package/dist/components/CommonInputWrapper/CommonInputWrapper.vue.js +0 -6
- package/dist/components/CommonInputWrapper/CommonInputWrapper.vue_vue_type_script_setup_true_lang.js +0 -107
- package/dist/confirm-variants.d.ts +0 -17
- package/dist/dropdown-item-variants.d.ts +0 -17
- package/dist/indicator-variants.d.ts +0 -20
- package/dist/locale-registry.d.ts +0 -37
- package/dist/toast-variants.d.ts +0 -20
- package/dist/tooltip-variants.d.ts +0 -17
- package/dist/types/InputDirection.d.ts +0 -15
- package/dist/validated/BbCheckbox.vue.d.ts +0 -29
- package/dist/validated/BbCheckbox.vue.js +0 -5
- package/dist/validated/BbCheckbox.vue_vue_type_script_setup_true_lang.js +0 -75
- package/dist/validated/BbCheckboxGroup.vue.d.ts +0 -34
- package/dist/validated/BbCheckboxGroup.vue.js +0 -5
- package/dist/validated/BbCheckboxGroup.vue_vue_type_script_setup_true_lang.js +0 -82
- package/dist/validated/BbColorInput.vue.d.ts +0 -37
- package/dist/validated/BbColorInput.vue.js +0 -5
- package/dist/validated/BbColorInput.vue_vue_type_script_setup_true_lang.js +0 -75
- package/dist/validated/BbDatePickerInput.vue.d.ts +0 -41
- package/dist/validated/BbDatePickerInput.vue.js +0 -5
- package/dist/validated/BbDatePickerInput.vue_vue_type_script_setup_true_lang.js +0 -90
- package/dist/validated/BbDropzone.vue.d.ts +0 -24
- package/dist/validated/BbDropzone.vue.js +0 -5
- package/dist/validated/BbDropzone.vue_vue_type_script_setup_true_lang.js +0 -45
- package/dist/validated/BbForm.vue.d.ts +0 -28
- package/dist/validated/BbForm.vue_vue_type_script_setup_true_lang.js +0 -42
- package/dist/validated/BbNumberInput.vue.d.ts +0 -36
- package/dist/validated/BbNumberInput.vue.js +0 -5
- package/dist/validated/BbNumberInput.vue_vue_type_script_setup_true_lang.js +0 -72
- package/dist/validated/BbRadioGroup.vue.d.ts +0 -34
- package/dist/validated/BbRadioGroup.vue.js +0 -5
- package/dist/validated/BbRadioGroup.vue_vue_type_script_setup_true_lang.js +0 -78
- package/dist/validated/BbRating.vue.d.ts +0 -30
- package/dist/validated/BbRating.vue.js +0 -5
- package/dist/validated/BbRating.vue_vue_type_script_setup_true_lang.js +0 -63
- package/dist/validated/BbSelect.vue.d.ts +0 -46
- package/dist/validated/BbSelect.vue.js +0 -5
- package/dist/validated/BbSelect.vue_vue_type_script_setup_true_lang.js +0 -109
- package/dist/validated/BbSlider.vue.d.ts +0 -36
- package/dist/validated/BbSlider.vue.js +0 -5
- package/dist/validated/BbSlider.vue_vue_type_script_setup_true_lang.js +0 -69
- package/dist/validated/BbSwitch.vue.d.ts +0 -29
- package/dist/validated/BbSwitch.vue.js +0 -5
- package/dist/validated/BbSwitch.vue_vue_type_script_setup_true_lang.js +0 -75
- package/dist/validated/BbSwitchGroup.vue.d.ts +0 -34
- package/dist/validated/BbSwitchGroup.vue.js +0 -5
- package/dist/validated/BbSwitchGroup.vue_vue_type_script_setup_true_lang.js +0 -82
- package/dist/validated/BbTag.vue.d.ts +0 -36
- package/dist/validated/BbTag.vue.js +0 -5
- package/dist/validated/BbTag.vue_vue_type_script_setup_true_lang.js +0 -72
- package/dist/validated/BbTextInput.vue.d.ts +0 -36
- package/dist/validated/BbTextInput.vue.js +0 -5
- package/dist/validated/BbTextInput.vue_vue_type_script_setup_true_lang.js +0 -72
- package/dist/validated/BbTextarea.vue.d.ts +0 -36
- package/dist/validated/BbTextarea.vue.js +0 -5
- package/dist/validated/BbTextarea.vue_vue_type_script_setup_true_lang.js +0 -70
- package/dist/validated/BbTimePickerInput.vue.d.ts +0 -37
- package/dist/validated/BbTimePickerInput.vue.js +0 -5
- package/dist/validated/BbTimePickerInput.vue_vue_type_script_setup_true_lang.js +0 -81
- package/dist/validated/index.d.ts +0 -43
- package/dist/validated/useValidatedField.d.ts +0 -93
- package/dist/validated/useValidatedField.js +0 -51
- package/dist/validated.js +0 -21
- /package/dist/components/{BbBaseDatePicker/BbBaseDatePickerMonthSelector.vue.d.ts → BbCalendar/CalendarMonthPanel.vue.d.ts} +0 -0
- /package/dist/components/{BbBaseDatePicker/BbBaseDatePickerYearSelector.vue.d.ts → BbCalendar/CalendarYearPanel.vue.d.ts} +0 -0
- /package/dist/{components/BbBaseDatePicker/typeahead.d.ts → composables/useTypeahead.d.ts} +0 -0
- /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
|
|
49
|
-
|
|
|
50
|
-
| `--bb-primary`
|
|
51
|
-
| `--bb-primary-fg`
|
|
52
|
-
| `--bb-
|
|
53
|
-
| `--bb-
|
|
54
|
-
| `--bb-
|
|
55
|
-
| `--bb-
|
|
56
|
-
| `--bb-
|
|
57
|
-
| `--bb-
|
|
58
|
-
| `--bb-
|
|
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 `
|
|
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)
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
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
|
|
93
|
-
they are ordinary custom properties — but that reuse is the
|
|
94
|
-
the project's contrast budget; the library only promises
|
|
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.
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
`--bb-primary
|
|
104
|
-
|
|
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
|
|
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 (`
|
|
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
|
|
177
|
-
| --------------------- |
|
|
178
|
-
| `--bb-radius` | `8px`
|
|
179
|
-
| `--bb-radius-surface` | `calc(var(--bb-radius) * 1.8)`
|
|
180
|
-
| `--bb-radius-sm` | `max(4px, calc(
|
|
181
|
-
| `--bb-border-w` | `1px`
|
|
182
|
-
| `--bb-
|
|
183
|
-
| `--bb-
|
|
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
|
|
209
|
-
the
|
|
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
|
|
226
|
-
|
|
|
227
|
-
| `--bb-overlay`
|
|
228
|
-
| `--bb-overlay-
|
|
229
|
-
| `--bb-
|
|
230
|
-
| `--bb-
|
|
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
|
|
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
|
-
|
|
277
|
-
|
|
278
|
-
|
|
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 (`<
|
|
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
|
-
|
|
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
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
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
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
`
|
|
425
|
-
|
|
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
|
-
|
|
430
|
-
|
|
431
|
-
|
|
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
|
|
447
|
-
|
|
448
|
-
|
|
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
|
-
|
|
456
|
-
renders the library's own light theme.
|
|
457
|
-
|
|
458
|
-
|
|
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
|
-
|
|
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`
|
|
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
|
|
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
|
|
652
|
-
|
|
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.
|