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