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
package/dist/ai/BbTextInput.md
CHANGED
|
@@ -8,6 +8,41 @@
|
|
|
8
8
|
- Usage rule: Prefer this component for consumer-facing implementations.
|
|
9
9
|
- Implementation source (only when the contract below is not enough): [source/BbTextInput.md](./source/BbTextInput.md)
|
|
10
10
|
|
|
11
|
+
## Reachable through `BbTextInput`
|
|
12
|
+
|
|
13
|
+
`BbTextInput` mounts other components (all of them: _Component tree_, near the end). These are the parts of its API that land inside them. Prefer these over `:deep()` on an inner class (allowed, unsupported: it can break on upgrade) — and never an import of an internal component.
|
|
14
|
+
|
|
15
|
+
| pt part | Lands on | In |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| `pt:root` | `div.bb-field` | `CommonField` _(internal)_ |
|
|
18
|
+
| `pt:label` | `component` | `CommonField` _(internal)_ |
|
|
19
|
+
| `pt:description` | `span.bb-field__description` | `CommonField` _(internal)_ |
|
|
20
|
+
| `pt:hint` | `span.bb-field__hint` | `CommonField` _(internal)_ |
|
|
21
|
+
| `pt:message` | `div.bb-field__message` | `CommonField` _(internal)_ |
|
|
22
|
+
| `pt:box` | `span.bb-field-input__box` | `CommonFieldInput` _(internal)_ |
|
|
23
|
+
| `pt:prefix` | `span.bb-field-input__prefix` | `CommonFieldInput` _(internal)_ |
|
|
24
|
+
| `pt:icon` | the root of `BbIcon` | `BbIcon` ([contract](./BbIcon.md)) |
|
|
25
|
+
| `pt:clear` | the root of `ClearableButton` | `ClearableButton` _(internal)_ |
|
|
26
|
+
| `pt:spinner` | the root of `BbSpinner` | `BbSpinner` ([contract](./BbSpinner.md)) |
|
|
27
|
+
| `pt:suffix` | `span.bb-field-input__suffix` | `CommonFieldInput` _(internal)_ |
|
|
28
|
+
|
|
29
|
+
**CSS variables you can set through those parts** — declared deeper in the tree, so set one on the part that reads it (`pt:<part>="[--name:value]"`), never on `BbTextInput`'s root:
|
|
30
|
+
|
|
31
|
+
| Variable | Set through | Declared by | What it is |
|
|
32
|
+
| --- | --- | --- | --- |
|
|
33
|
+
| `--bg` | `pt:box` | `CommonFieldInput` | the shell's fill |
|
|
34
|
+
| `--bg-hover` | `pt:box` | `CommonFieldInput` | fill under the pointer |
|
|
35
|
+
| `--bg-focus` | `pt:box` | `CommonFieldInput` | fill while focus is inside, and under --active |
|
|
36
|
+
| `--bg-disabled` | `pt:box` | `CommonFieldInput` | fill while disabled; beats hover and focus |
|
|
37
|
+
| `--border-color` | `pt:box` | `CommonFieldInput` | The resting border, at the fixed --bb-border-w. Errors and warnings paint their frame over it, so `pt:box="[--border-color:…]"` recolours the rest without hiding the state; a plain `border-*` utility on the base pt:box would hide it (ESLint `no-box-border-color`). |
|
|
38
|
+
| `--border-focus` | `pt:box` | `CommonFieldInput` | frame while focused, or --active |
|
|
39
|
+
| `--ring-size` | `pt:box` | `CommonFieldInput` | ring width; 0 is a variant declining the ring |
|
|
40
|
+
| `--ring-color` | `pt:box` | `CommonFieldInput` | ring colour; state owns it, not variants |
|
|
41
|
+
| `--elev` | `pt:box` | `CommonFieldInput` | Resting lift, composed UNDER the ring at every box-shadow site below. `0 0 0 0 transparent` and not `none`, so the shadow list keeps a constant length and stays interpolable whatever a variant assigns — the same reason `--bb-elev` itself ships that value. |
|
|
42
|
+
| `--frost` | `pt:box` | `CommonFieldInput` | Plate frost — a full `backdrop-filter` value (see --bb-surface-filter). Routed through a local rather than read from the token directly, so a chrome-less variant can decline it: frosting a ghost field gives it the plate it is contractually not supposed to have. |
|
|
43
|
+
| `--inside-label-clearance` | `pt:box`, `pt:prefix`, `pt:suffix` | `CommonFieldInput` | Height and top padding added above the text for a label rendered inside the box. Zero here; the `--inside-label` rules at the bottom of this file raise it to one label line, or two with a description. |
|
|
44
|
+
| `--w` | `pt:icon` | `BbIcon` | `--w` is set inline by BbIcon from the size prop. The `initial` default seals it: without it an ancestor's `--w` (e.g. a dropdown's width bridge) would inherit in and size the icon. The `--size` indirection stays so higher-specificity rules (e.g. `.bb-badge .bb-icon`) can re-point it. |
|
|
45
|
+
|
|
11
46
|
## Usage & Guidelines
|
|
12
47
|
|
|
13
48
|
### When to use
|
|
@@ -24,7 +59,7 @@ Pick a sibling when the shape of the data is different:
|
|
|
24
59
|
- calendar dates → `BbDatePickerInput`;
|
|
25
60
|
- choosing from a known set of options → `BbSelect` / `BbRadioGroup`.
|
|
26
61
|
|
|
27
|
-
`v-model` binds a `string | null` — an emptied field emits `null
|
|
62
|
+
`v-model` binds a `string | null` — an emptied field emits `null` by default, or `''` when the plugin option `formControls` says so (see the installation guide § `formControls`).
|
|
28
63
|
`label` is required (hide it visually with `hideLabel`, never drop it).
|
|
29
64
|
|
|
30
65
|
### Label & label modes
|
|
@@ -45,20 +80,25 @@ read from `FormData`.
|
|
|
45
80
|
- **`hideLabel`** keeps the label for screen readers but removes it visually —
|
|
46
81
|
the right move for search boxes whose design shows only a placeholder.
|
|
47
82
|
- The **`label` slot** replaces the label text and receives
|
|
48
|
-
`{ text, hasErrors }`, e.g. to append a required marker that turns red with
|
|
83
|
+
`{ text, hasErrors, hasWarnings }`, e.g. to append a required marker that turns red with
|
|
49
84
|
the error state.
|
|
50
85
|
|
|
51
86
|
Avoid combining `labelMode="floating"` with a `placeholder` — the resting
|
|
52
87
|
label already plays that role and the two would overlap.
|
|
53
88
|
|
|
89
|
+
A risen floating label is a chip on the box's top border: the surface above,
|
|
90
|
+
the box's fill below, so it masks the line on an `outline` and a `secondary`
|
|
91
|
+
box alike. If you give the box a custom fill (`pt:box="[--bg:…]"`), give the
|
|
92
|
+
chip the same one on the field: `pt:root="[--label-bg:…]"`.
|
|
93
|
+
|
|
54
94
|
**The three label modes**
|
|
55
95
|
|
|
56
96
|
```vue
|
|
57
97
|
<template>
|
|
58
|
-
<div class="grid max-w-sm gap-3 rounded-
|
|
98
|
+
<div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
|
|
59
99
|
<div>
|
|
60
100
|
<p class="text-sm font-medium">Profile basics</p>
|
|
61
|
-
<p class="text-xs text-
|
|
101
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
62
102
|
Same field, three label placements — pick one per product.
|
|
63
103
|
</p>
|
|
64
104
|
</div>
|
|
@@ -85,10 +125,10 @@ const inside = ref<string | null>('Bitboss');
|
|
|
85
125
|
|
|
86
126
|
```vue
|
|
87
127
|
<template>
|
|
88
|
-
<div class="grid max-w-sm gap-3 rounded-
|
|
128
|
+
<div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
|
|
89
129
|
<div>
|
|
90
130
|
<p class="text-sm font-medium">Workspace settings</p>
|
|
91
|
-
<p class="text-xs text-
|
|
131
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
92
132
|
Required fields mark the label — keep the accessible name intact.
|
|
93
133
|
</p>
|
|
94
134
|
</div>
|
|
@@ -102,11 +142,7 @@ const inside = ref<string | null>('Bitboss');
|
|
|
102
142
|
<template #label="{ text, hasErrors }">
|
|
103
143
|
{{ text }}
|
|
104
144
|
<span
|
|
105
|
-
:class="
|
|
106
|
-
hasErrors
|
|
107
|
-
? 'text-[color:var(--bb-danger)]'
|
|
108
|
-
: 'text-[color:var(--bb-text-muted)]'
|
|
109
|
-
"
|
|
145
|
+
:class="hasErrors ? 'text-(--bb-danger)' : 'text-(--bb-text-muted)'"
|
|
110
146
|
>
|
|
111
147
|
*
|
|
112
148
|
</span>
|
|
@@ -142,7 +178,7 @@ Three messaging surfaces, three jobs:
|
|
|
142
178
|
referenced from `aria-describedby` while displayed — for a
|
|
143
179
|
valid-but-noteworthy value (unusual, near a limit, soft-flagged) where a hard
|
|
144
180
|
error would overstate the problem. A non-empty `warnings` implies the warning
|
|
145
|
-
state (same as `errors` implies the error state). **`
|
|
181
|
+
state (same as `errors` implies the error state). **`hasWarnings`** forces that
|
|
146
182
|
chrome without a message. Either way you get tinted border, focus ring and a
|
|
147
183
|
warning icon in amber (`--bb-warn`) — but, unlike `hasErrors`, **no**
|
|
148
184
|
`aria-invalid`. Errors win when both are set, and the warning messages are
|
|
@@ -166,15 +202,45 @@ validation layer should still drive `errors`.
|
|
|
166
202
|
</div>
|
|
167
203
|
```
|
|
168
204
|
|
|
205
|
+
**A description with markup: the `#description` slot.** Every form control
|
|
206
|
+
takes a `#description` slot next to the `description` prop — for a link, a
|
|
207
|
+
bold value, anything beyond plain text. It renders in the same place (under
|
|
208
|
+
the label, above the field), receives `{ text, hasErrors, hasWarnings }` like
|
|
209
|
+
`#label`, and is announced as the field's description, never as part of its
|
|
210
|
+
name. The slot alone is enough: no `description` prop needed.
|
|
211
|
+
|
|
212
|
+
**A description with a link**
|
|
213
|
+
|
|
214
|
+
```vue
|
|
215
|
+
<template>
|
|
216
|
+
<div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-3">
|
|
217
|
+
<BbTextInput v-model="subdomain" label="Subdomain" name="subdomain">
|
|
218
|
+
<!-- Renders under the label, above the field, and is announced as the
|
|
219
|
+
field's description — never as part of its name. Use the slot when the
|
|
220
|
+
description needs markup; `description="…"` is the plain-text form. -->
|
|
221
|
+
<template #description>
|
|
222
|
+
Your workspace lives at
|
|
223
|
+
<strong>{{ subdomain || 'your-team' }}.example.com</strong>.
|
|
224
|
+
<a class="underline" href="#domains">Use a custom domain</a>
|
|
225
|
+
</template>
|
|
226
|
+
</BbTextInput>
|
|
227
|
+
</div>
|
|
228
|
+
</template>
|
|
229
|
+
<script setup lang="ts">
|
|
230
|
+
import { ref } from 'vue';
|
|
231
|
+
import { BbTextInput } from 'bitboss-ui';
|
|
232
|
+
|
|
233
|
+
const subdomain = ref('');
|
|
234
|
+
</script>
|
|
235
|
+
```
|
|
236
|
+
|
|
169
237
|
**Validation states**
|
|
170
238
|
|
|
171
239
|
```vue
|
|
172
240
|
<template>
|
|
173
241
|
<div class="grid max-w-sm gap-3">
|
|
174
|
-
<div class="grid gap-2 rounded-
|
|
175
|
-
<p class="text-xs font-medium text-
|
|
176
|
-
Invite teammate
|
|
177
|
-
</p>
|
|
242
|
+
<div class="grid gap-2 rounded-(--bb-radius) border p-3">
|
|
243
|
+
<p class="text-xs font-medium text-(--bb-text-muted)">Invite teammate</p>
|
|
178
244
|
<BbTextInput
|
|
179
245
|
v-model="email"
|
|
180
246
|
compact
|
|
@@ -186,8 +252,8 @@ validation layer should still drive `errors`.
|
|
|
186
252
|
type="email"
|
|
187
253
|
/>
|
|
188
254
|
</div>
|
|
189
|
-
<div class="grid gap-2 rounded-
|
|
190
|
-
<p class="text-xs font-medium text-
|
|
255
|
+
<div class="grid gap-2 rounded-(--bb-radius) border p-3">
|
|
256
|
+
<p class="text-xs font-medium text-(--bb-text-muted)">
|
|
191
257
|
Non-blocking hint
|
|
192
258
|
</p>
|
|
193
259
|
<BbTextInput
|
|
@@ -199,7 +265,7 @@ validation layer should still drive `errors`.
|
|
|
199
265
|
:warnings="['This name is very short — is it what you meant?']"
|
|
200
266
|
/>
|
|
201
267
|
</div>
|
|
202
|
-
<div class="rounded-
|
|
268
|
+
<div class="rounded-(--bb-radius) border px-2 py-1.5">
|
|
203
269
|
<BbTextInput
|
|
204
270
|
v-model="search"
|
|
205
271
|
class="w-full"
|
|
@@ -226,7 +292,7 @@ const search = ref<string | null>('billing');
|
|
|
226
292
|
|
|
227
293
|
The second field carries `warnings` — a non-blocking amber hint in an
|
|
228
294
|
`aria-live` region and in `aria-describedby`, mirroring `errors`. A non-empty `warnings` lights the state
|
|
229
|
-
on its own (use `
|
|
295
|
+
on its own (use `hasWarnings` to force the chrome without messages). When a field
|
|
230
296
|
has **both** `errors` and `warnings`, errors win: the field shows error chrome
|
|
231
297
|
and only the error messages. The last field shows the common a11y move: a search
|
|
232
298
|
box with a _visually_ hidden label (`hideLabel`) — the accessible name survives
|
|
@@ -241,8 +307,8 @@ interactive controls out of them.
|
|
|
241
307
|
|
|
242
308
|
The append-icon position is shared with the field's status indicators, one at
|
|
243
309
|
a time by priority: **clear button → spinner (`loading`) → error icon
|
|
244
|
-
(`hasErrors`) → your `append:icon`**. The warning icon (`
|
|
245
|
-
error icon's slot — shown when `
|
|
310
|
+
(`hasErrors`) → your `append:icon`**. The warning icon (`hasWarnings`) shares the
|
|
311
|
+
error icon's slot — shown when `hasWarnings` is set and there is no error. Don't
|
|
246
312
|
rely on an `append:icon` staying visible on a field that is also `clearable` or
|
|
247
313
|
validated.
|
|
248
314
|
|
|
@@ -251,17 +317,17 @@ The full slot ring, inside → out:
|
|
|
251
317
|
- `prefix` / `suffix` — styled inline text hugging the typed value;
|
|
252
318
|
- `prepend` / `append` — free-form content inside the input chrome (replaces
|
|
253
319
|
`prefix`/`suffix` when both are given);
|
|
254
|
-
- `prepend
|
|
320
|
+
- `prepend:outer` / `append:outer` — content outside the chrome, laid out next
|
|
255
321
|
to the field; the right home for an adjacent button.
|
|
256
322
|
|
|
257
323
|
**Icons and text affixes**
|
|
258
324
|
|
|
259
325
|
```vue
|
|
260
326
|
<template>
|
|
261
|
-
<div class="grid max-w-sm gap-3 rounded-
|
|
327
|
+
<div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
|
|
262
328
|
<div>
|
|
263
329
|
<p class="text-sm font-medium">Workspace & billing</p>
|
|
264
|
-
<p class="text-xs text-
|
|
330
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
265
331
|
Icons and short affixes live inside the chrome; actions sit outside.
|
|
266
332
|
</p>
|
|
267
333
|
</div>
|
|
@@ -285,7 +351,7 @@ The full slot ring, inside → out:
|
|
|
285
351
|
name="api-key"
|
|
286
352
|
readonly
|
|
287
353
|
>
|
|
288
|
-
<template #append
|
|
354
|
+
<template #append:outer>
|
|
289
355
|
<BbButton
|
|
290
356
|
aria-label="Copy API key"
|
|
291
357
|
icon="lucide:copy"
|
|
@@ -328,10 +394,10 @@ the status.
|
|
|
328
394
|
|
|
329
395
|
```vue
|
|
330
396
|
<template>
|
|
331
|
-
<div class="grid max-w-sm gap-3 rounded-
|
|
397
|
+
<div class="grid max-w-sm gap-3 rounded-(--bb-radius) border p-4">
|
|
332
398
|
<div>
|
|
333
399
|
<p class="text-sm font-medium">Claim your handle</p>
|
|
334
|
-
<p class="text-xs text-
|
|
400
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
335
401
|
Debounced check — spinner while pending, hint or error on result.
|
|
336
402
|
</p>
|
|
337
403
|
</div>
|
|
@@ -406,7 +472,7 @@ Pass a [maska](https://beholdr.github.io/maska/v3) config to `mask` to format
|
|
|
406
472
|
as the user types — card numbers, phone numbers, license keys. By default
|
|
407
473
|
`v-model` receives the _unmasked_ value (`'4242424242424242'` for the card
|
|
408
474
|
below); set `emitMasked` to persist the formatted string instead. A fully
|
|
409
|
-
emptied masked field emits `null
|
|
475
|
+
emptied masked field emits the empty value (`null` by default, `''` with `formControls`), like every other state of this component.
|
|
410
476
|
|
|
411
477
|
The mask is live-reactive: changing the `mask` options at runtime reformats the
|
|
412
478
|
current value, and toggling `emitMasked` re-emits the model in the new format.
|
|
@@ -441,15 +507,23 @@ are `BbNumberInput`'s and `BbDatePickerInput`'s jobs.
|
|
|
441
507
|
the saved email or name as a suggestion over the results the user is trying
|
|
442
508
|
to filter. Semantic tokens belong on identity fields; anything that queries a
|
|
443
509
|
list turns autofill off.
|
|
444
|
-
- `
|
|
445
|
-
`
|
|
510
|
+
- `input-mode` steers mobile keyboards independently of `type` (e.g.
|
|
511
|
+
`input-mode="numeric"` on a masked code field that must stay `type="text"`).
|
|
512
|
+
Any spelling reaches the input (`inputmode`, `inputMode`), on every
|
|
513
|
+
text-like control.
|
|
446
514
|
- `autofocus` focuses the field on mount; use at most one per view.
|
|
447
515
|
|
|
448
|
-
|
|
449
|
-
`maxlength`, `
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
516
|
+
The native attributes that only mean something on the input itself —
|
|
517
|
+
`maxlength`, `minlength`, `pattern`, `spellcheck`, `autocapitalize`,
|
|
518
|
+
`autocorrect`, `enterkeyhint`, `list`, `form`, `dirname` — go straight to the
|
|
519
|
+
native `<input>` (the same holds for BbTextarea, BbNumberInput, BbTag and
|
|
520
|
+
BbColorInput, where `wrap` joins them on the textarea). The controls without
|
|
521
|
+
a text input route only what their native control reads: BbSelect sends
|
|
522
|
+
`form` to its hidden inputs, BbDatePickerInput and BbTimePickerInput send
|
|
523
|
+
`form`, `spellcheck`, `autocapitalize`, `autocorrect` and `enterkeyhint` to
|
|
524
|
+
every segment (each segment keeps its own `maxlength` and parsing). Any other
|
|
525
|
+
attribute you set lands on the field's outer element; reach the input with
|
|
526
|
+
`pt:input="{ attrs: { … } }"`, which also wins over the attributes above.
|
|
453
527
|
|
|
454
528
|
**An OTP field: text type, numeric keyboard, masked**
|
|
455
529
|
|
|
@@ -459,7 +533,7 @@ to enforce.
|
|
|
459
533
|
v-model="state.otp"
|
|
460
534
|
label="Verification code"
|
|
461
535
|
autocomplete="one-time-code"
|
|
462
|
-
|
|
536
|
+
input-mode="numeric"
|
|
463
537
|
:mask="{ mask: '### ###' }"
|
|
464
538
|
placeholder="123 456"
|
|
465
539
|
/>
|
|
@@ -505,7 +579,7 @@ const revealed = ref(false);
|
|
|
505
579
|
|
|
506
580
|
### Events & v-model
|
|
507
581
|
|
|
508
|
-
- `update:modelValue` — every value change; `string`, or `null`
|
|
582
|
+
- `update:modelValue` — every value change; `string`, or the empty value when emptied (`null` by default, `''` with `formControls`)
|
|
509
583
|
(with a mask: the unmasked/masked string per `emitMasked`).
|
|
510
584
|
- `focus` / `blur` — forwarded `FocusEvent`s; they also drive the hint's
|
|
511
585
|
show-on-focus behavior.
|
|
@@ -536,39 +610,40 @@ provisioned values — screen-reader and keyboard users can still reach them.
|
|
|
536
610
|
`compact` reduces the control height — apply it per view, not per field, so
|
|
537
611
|
density stays consistent.
|
|
538
612
|
|
|
539
|
-
The API also exposes `
|
|
540
|
-
`labelPosition`. `
|
|
613
|
+
The API also exposes `layout` (horizontal/pattern layouts), `reverse` and
|
|
614
|
+
`labelPosition`. `layout` works whenever the **resolved** label mode is
|
|
541
615
|
`'outside'` — which is the config default, so it works out of the box. With
|
|
542
616
|
`labelMode="floating"` or `"inside"` (via prop or
|
|
543
617
|
`config.defaultInputLabelMode`) the label is embedded in the field, so those
|
|
544
|
-
modes force the vertical layout and ignore `
|
|
545
|
-
to `BbNumberInput`, `BbSelect` and `
|
|
546
|
-
|
|
618
|
+
modes force the vertical layout and ignore `layout`. The same rule applies
|
|
619
|
+
to `BbNumberInput`, `BbSelect`, `BbDatePickerInput` and `BbTextarea` — all
|
|
620
|
+
five carry `labelMode` and all five fall back to
|
|
621
|
+
`config.defaultInputLabelMode` when it is unset.
|
|
547
622
|
|
|
548
|
-
**Horizontal row via
|
|
623
|
+
**Horizontal row via layout (outside label)**
|
|
549
624
|
|
|
550
625
|
```vue
|
|
551
626
|
<template>
|
|
552
|
-
<div class="grid max-w-md gap-3 rounded-
|
|
627
|
+
<div class="grid max-w-md gap-3 rounded-(--bb-radius) border p-4">
|
|
553
628
|
<div>
|
|
554
629
|
<p class="text-sm font-medium">Billing contact</p>
|
|
555
|
-
<p class="text-xs text-
|
|
630
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
556
631
|
Outside labels only — horizontal rows keep dense forms scannable.
|
|
557
632
|
</p>
|
|
558
633
|
</div>
|
|
559
634
|
<BbTextInput
|
|
560
635
|
v-model="fullName"
|
|
561
636
|
compact
|
|
562
|
-
direction="horizontal"
|
|
563
637
|
label="Full name"
|
|
638
|
+
layout="horizontal"
|
|
564
639
|
name="full-name"
|
|
565
640
|
placeholder="Ada Lovelace"
|
|
566
641
|
/>
|
|
567
642
|
<BbTextInput
|
|
568
643
|
v-model="company"
|
|
569
644
|
compact
|
|
570
|
-
direction="xx xxxxxx"
|
|
571
645
|
label="Company"
|
|
646
|
+
layout="xx xxxxxx"
|
|
572
647
|
name="company"
|
|
573
648
|
placeholder="Bitboss"
|
|
574
649
|
/>
|
|
@@ -583,17 +658,17 @@ const company = ref<string | null>('Bitboss');
|
|
|
583
658
|
</script>
|
|
584
659
|
```
|
|
585
660
|
|
|
586
|
-
`
|
|
661
|
+
`layout="horizontal"` splits label and field 50/50; a pattern string like
|
|
587
662
|
`"xx xxxxxx"` sets proportional column widths (here 25% label / 75% field).
|
|
588
663
|
|
|
589
664
|
**Compact density for dense panels**
|
|
590
665
|
|
|
591
666
|
```vue
|
|
592
667
|
<template>
|
|
593
|
-
<div class="grid max-w-sm gap-2 rounded-
|
|
668
|
+
<div class="grid max-w-sm gap-2 rounded-(--bb-radius) border p-3">
|
|
594
669
|
<div>
|
|
595
670
|
<p class="text-sm font-medium">Merino Tee — Black / M</p>
|
|
596
|
-
<p class="text-xs text-
|
|
671
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
597
672
|
Product identifiers · compact density
|
|
598
673
|
</p>
|
|
599
674
|
</div>
|
|
@@ -622,6 +697,47 @@ const barcode = ref<string | null>('0 12345 67890 5');
|
|
|
622
697
|
</script>
|
|
623
698
|
```
|
|
624
699
|
|
|
700
|
+
### Variants
|
|
701
|
+
|
|
702
|
+
`variant` picks the field box's look — and only its look. Height, padding and
|
|
703
|
+
border width are identical across variants, so mixing them in one view never
|
|
704
|
+
reflows anything. The names and tokens are the `BbButton` ones, so a page
|
|
705
|
+
reads one vocabulary for buttons and fields:
|
|
706
|
+
|
|
707
|
+
- **`outline`** (default) — the raised panel with the neutral border.
|
|
708
|
+
- **`secondary`** — a soft tinted surface with a faint border; fields that
|
|
709
|
+
should sit back on a busy panel.
|
|
710
|
+
- **`ghost`** — no border in **any** state, a hover wash as the affordance,
|
|
711
|
+
and the same wash under the focus ring (a ring around nothing reads as a
|
|
712
|
+
glitch). Errors and warnings do not tint it; the icon and
|
|
713
|
+
the message carry the state. This is the inline-edit table cell: the field
|
|
714
|
+
reads as text at rest and needs no `:deep()` to get there.
|
|
715
|
+
- **`none`** — structure only: every colour transparent and **no focus
|
|
716
|
+
ring**. An escape hatch for a fully custom look; prefer registering a
|
|
717
|
+
variant, which keeps the ring.
|
|
718
|
+
|
|
719
|
+
**The variant ladder**
|
|
720
|
+
|
|
721
|
+
```vue
|
|
722
|
+
<template>
|
|
723
|
+
<div class="grid gap-3 sm:grid-cols-3">
|
|
724
|
+
<BbTextInput label="Outline" model-value="Ada Lovelace" />
|
|
725
|
+
<BbTextInput
|
|
726
|
+
label="Secondary"
|
|
727
|
+
model-value="Ada Lovelace"
|
|
728
|
+
variant="secondary"
|
|
729
|
+
/>
|
|
730
|
+
<BbTextInput label="Ghost" model-value="Ada Lovelace" variant="ghost" />
|
|
731
|
+
</div>
|
|
732
|
+
</template>
|
|
733
|
+
```
|
|
734
|
+
|
|
735
|
+
`variant` is the same prop on `BbTextarea`, `BbNumberInput`, `BbSelect`,
|
|
736
|
+
`BbTag`, `BbDatePickerInput`, `BbTimePickerInput` and `BbColorInput`. Extra
|
|
737
|
+
names are registered through the plugin's `inputVariants` option and styled
|
|
738
|
+
as a token block on `bb-field-input--<name>` — see the installation
|
|
739
|
+
guide.
|
|
740
|
+
|
|
625
741
|
### Global config & platforms
|
|
626
742
|
|
|
627
743
|
- `config.defaultInputLabelMode` — project-wide default for `labelMode`
|
|
@@ -654,7 +770,7 @@ submit, format checks on blur, errors cleared as the user fixes them.
|
|
|
654
770
|
```vue
|
|
655
771
|
<template>
|
|
656
772
|
<form
|
|
657
|
-
class="grid max-w-md gap-3 rounded-
|
|
773
|
+
class="grid max-w-md gap-3 rounded-(--bb-radius) border p-4"
|
|
658
774
|
novalidate
|
|
659
775
|
@submit.prevent="submit"
|
|
660
776
|
>
|
|
@@ -662,7 +778,7 @@ submit, format checks on blur, errors cleared as the user fixes them.
|
|
|
662
778
|
<p class="text-sm font-medium">
|
|
663
779
|
Invoice for {{ customer || 'a new client' }}
|
|
664
780
|
</p>
|
|
665
|
-
<p class="text-xs text-
|
|
781
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
666
782
|
Draft INV-2048 · validate on blur / submit, clear as they type
|
|
667
783
|
</p>
|
|
668
784
|
</div>
|
|
@@ -810,6 +926,220 @@ const formattedTotal = computed(() =>
|
|
|
810
926
|
</script>
|
|
811
927
|
```
|
|
812
928
|
|
|
929
|
+
### Restyling with passthrough
|
|
930
|
+
|
|
931
|
+
`pt` reaches a named part of the control with a class list — or, in the
|
|
932
|
+
object form, a style and attributes — optionally only while a state is on.
|
|
933
|
+
Parts: `root` (the container), `label`, `description`, `message` (the errors / warnings region — one node each, only one ever shows), `hint` (the helper line — shown on focus, or always with `persistent-hint`), `box` (the bordered field box), `input` (the native control), `icon` (`prepend:icon` + `append:icon` — a broadcast; the state glyphs are chrome), `spinner` (the spinner shown while `loading`), `prefix`, `suffix`, `clear` (the ✕ that empties the field).
|
|
934
|
+
States: `errors`, `warnings` (never beside errors), `loading`, `disabled`, `readonly`, `hasValue` (written `pt:box:has-value`). A name outside that list is a type error and an
|
|
935
|
+
ESLint error.
|
|
936
|
+
|
|
937
|
+
The invoice form above, restyled through those parts: muted icons on
|
|
938
|
+
`pt:icon`, a danger ring on `pt:box:errors`, a primary edge once the field
|
|
939
|
+
holds a value (`pt:box:has-value`), mono on the billing-email `pt:input`.
|
|
940
|
+
Date, number and notes keep library chrome.
|
|
941
|
+
|
|
942
|
+
**pt:icon / pt:box:errors / pt:box:has-value — the invoice text fields**
|
|
943
|
+
|
|
944
|
+
```vue
|
|
945
|
+
<template>
|
|
946
|
+
<form
|
|
947
|
+
class="grid max-w-md gap-3 rounded-(--bb-radius) border border-(--bb-border) p-4"
|
|
948
|
+
novalidate
|
|
949
|
+
@submit.prevent="onSubmit"
|
|
950
|
+
>
|
|
951
|
+
<div>
|
|
952
|
+
<p class="text-sm font-medium">
|
|
953
|
+
Invoice for {{ customer || 'a new client' }}
|
|
954
|
+
</p>
|
|
955
|
+
<p class="text-xs text-(--bb-text-muted)">
|
|
956
|
+
Draft INV-2048 · validate on blur / submit, clear as they type
|
|
957
|
+
</p>
|
|
958
|
+
</div>
|
|
959
|
+
<BbTextInput
|
|
960
|
+
v-model="customer"
|
|
961
|
+
clearable
|
|
962
|
+
compact
|
|
963
|
+
:errors="errors.customer"
|
|
964
|
+
label="Bill to"
|
|
965
|
+
name="customer"
|
|
966
|
+
placeholder="Company or person"
|
|
967
|
+
prepend:icon="lucide:user"
|
|
968
|
+
pt:box:errors="ring-2 ring-(--bb-danger)"
|
|
969
|
+
pt:box:has-value="border-(--bb-primary)"
|
|
970
|
+
pt:icon="text-(--bb-text-muted)"
|
|
971
|
+
required
|
|
972
|
+
@input="onCustomerInput"
|
|
973
|
+
/>
|
|
974
|
+
<BbTextInput
|
|
975
|
+
v-model="email"
|
|
976
|
+
autocomplete="email"
|
|
977
|
+
compact
|
|
978
|
+
:errors="errors.email"
|
|
979
|
+
label="Billing email"
|
|
980
|
+
name="email"
|
|
981
|
+
placeholder="billing@company.com"
|
|
982
|
+
prepend:icon="lucide:mail"
|
|
983
|
+
pt:box:errors="ring-2 ring-(--bb-danger)"
|
|
984
|
+
pt:box:has-value="border-(--bb-primary)"
|
|
985
|
+
pt:icon="text-(--bb-text-muted)"
|
|
986
|
+
pt:input="font-mono text-sm"
|
|
987
|
+
required
|
|
988
|
+
type="email"
|
|
989
|
+
@blur="onEmailBlur"
|
|
990
|
+
@input="onEmailInput"
|
|
991
|
+
/>
|
|
992
|
+
<div class="grid gap-3 sm:grid-cols-2">
|
|
993
|
+
<BbDatePickerInput
|
|
994
|
+
v-model="servicePeriod"
|
|
995
|
+
compact
|
|
996
|
+
label="Service period"
|
|
997
|
+
placeholder="Start → end"
|
|
998
|
+
prepend:icon="lucide:calendar"
|
|
999
|
+
range
|
|
1000
|
+
/>
|
|
1001
|
+
<BbDatePickerInput
|
|
1002
|
+
v-model="dueDate"
|
|
1003
|
+
compact
|
|
1004
|
+
:errors="errors.dueDate"
|
|
1005
|
+
label="Due date"
|
|
1006
|
+
:min="today"
|
|
1007
|
+
placeholder="YYYY-MM-DD"
|
|
1008
|
+
prepend:icon="lucide:calendar"
|
|
1009
|
+
@update:model-value="onDueDateUpdate"
|
|
1010
|
+
/>
|
|
1011
|
+
</div>
|
|
1012
|
+
<div class="grid gap-3 sm:grid-cols-2">
|
|
1013
|
+
<BbNumberInput
|
|
1014
|
+
v-model="quantity"
|
|
1015
|
+
compact
|
|
1016
|
+
label="Quantity"
|
|
1017
|
+
:max="999"
|
|
1018
|
+
:min="1"
|
|
1019
|
+
/>
|
|
1020
|
+
<BbNumberInput
|
|
1021
|
+
v-model="unitPrice"
|
|
1022
|
+
compact
|
|
1023
|
+
label="Unit price"
|
|
1024
|
+
:max-precision="2"
|
|
1025
|
+
:min="0"
|
|
1026
|
+
>
|
|
1027
|
+
<template #prefix>$</template>
|
|
1028
|
+
<template #suffix>USD</template>
|
|
1029
|
+
</BbNumberInput>
|
|
1030
|
+
</div>
|
|
1031
|
+
<BbTextarea
|
|
1032
|
+
v-model="notes"
|
|
1033
|
+
auto-grow
|
|
1034
|
+
compact
|
|
1035
|
+
hint="Shown at the bottom of the invoice."
|
|
1036
|
+
label="Notes"
|
|
1037
|
+
persistent-hint
|
|
1038
|
+
placeholder="Payment terms, PO number…"
|
|
1039
|
+
/>
|
|
1040
|
+
<div
|
|
1041
|
+
class="flex flex-wrap items-center justify-between gap-2 border-t border-(--bb-border) pt-3"
|
|
1042
|
+
>
|
|
1043
|
+
<p class="text-sm font-medium">
|
|
1044
|
+
{{
|
|
1045
|
+
queued ? `Queued — ${formattedTotal}` : `Total due: ${formattedTotal}`
|
|
1046
|
+
}}
|
|
1047
|
+
</p>
|
|
1048
|
+
<BbButton variant="primary" @click="onSubmit">Queue invoice</BbButton>
|
|
1049
|
+
</div>
|
|
1050
|
+
</form>
|
|
1051
|
+
</template>
|
|
1052
|
+
|
|
1053
|
+
<script setup lang="ts">
|
|
1054
|
+
import { ref, reactive, computed } from 'vue';
|
|
1055
|
+
import dayjs from 'dayjs';
|
|
1056
|
+
import {
|
|
1057
|
+
BbButton,
|
|
1058
|
+
BbTextInput,
|
|
1059
|
+
BbTextarea,
|
|
1060
|
+
BbNumberInput,
|
|
1061
|
+
BbDatePickerInput,
|
|
1062
|
+
} from 'bitboss-ui';
|
|
1063
|
+
|
|
1064
|
+
type InvoiceErrors = { customer: string; email: string; dueDate: string };
|
|
1065
|
+
|
|
1066
|
+
// Same invoice form as `InvoiceForm.vue`, restyled through passthrough on the
|
|
1067
|
+
// text fields: muted icons on `pt:icon`, a danger ring on `pt:box:errors`,
|
|
1068
|
+
// a primary edge once the field holds a value, mono on the email `pt:input`.
|
|
1069
|
+
const customer = ref<string | null>(null);
|
|
1070
|
+
const email = ref<string | null>(null);
|
|
1071
|
+
const servicePeriod = ref<string[]>([]);
|
|
1072
|
+
const dueDate = ref<string | null>(null);
|
|
1073
|
+
const quantity = ref<number>(1);
|
|
1074
|
+
const unitPrice = ref<number>(1200);
|
|
1075
|
+
const notes = ref<string | null>(null);
|
|
1076
|
+
const queued = ref(false);
|
|
1077
|
+
|
|
1078
|
+
const errors = reactive<InvoiceErrors>({
|
|
1079
|
+
customer: '',
|
|
1080
|
+
email: '',
|
|
1081
|
+
dueDate: '',
|
|
1082
|
+
});
|
|
1083
|
+
|
|
1084
|
+
const today = dayjs().format('YYYY-MM-DD');
|
|
1085
|
+
|
|
1086
|
+
const isValidEmail = (value: string) =>
|
|
1087
|
+
/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
|
|
1088
|
+
|
|
1089
|
+
const onCustomerInput = () => {
|
|
1090
|
+
errors.customer = '';
|
|
1091
|
+
};
|
|
1092
|
+
|
|
1093
|
+
const onEmailInput = () => {
|
|
1094
|
+
errors.email = '';
|
|
1095
|
+
};
|
|
1096
|
+
|
|
1097
|
+
const onDueDateUpdate = () => {
|
|
1098
|
+
errors.dueDate = '';
|
|
1099
|
+
};
|
|
1100
|
+
|
|
1101
|
+
const onEmailBlur = () => {
|
|
1102
|
+
if (email.value && !isValidEmail(email.value)) {
|
|
1103
|
+
errors.email = 'Enter a valid email address';
|
|
1104
|
+
}
|
|
1105
|
+
};
|
|
1106
|
+
|
|
1107
|
+
const onSubmit = () => {
|
|
1108
|
+
queued.value = false;
|
|
1109
|
+
errors.customer = customer.value ? '' : 'Tell us who to bill';
|
|
1110
|
+
errors.email = email.value
|
|
1111
|
+
? isValidEmail(email.value)
|
|
1112
|
+
? ''
|
|
1113
|
+
: 'Enter a valid email address'
|
|
1114
|
+
: 'A billing email is required';
|
|
1115
|
+
errors.dueDate = dueDate.value ? '' : 'Pick a due date';
|
|
1116
|
+
if (!errors.customer && !errors.email && !errors.dueDate) {
|
|
1117
|
+
queued.value = true;
|
|
1118
|
+
}
|
|
1119
|
+
};
|
|
1120
|
+
|
|
1121
|
+
const formattedTotal = computed(() =>
|
|
1122
|
+
new Intl.NumberFormat('en-US', {
|
|
1123
|
+
style: 'currency',
|
|
1124
|
+
currency: 'USD',
|
|
1125
|
+
}).format((quantity.value ?? 0) * (unitPrice.value ?? 0))
|
|
1126
|
+
);
|
|
1127
|
+
</script>
|
|
1128
|
+
```
|
|
1129
|
+
|
|
1130
|
+
A listener on `pt:input` concatenates after the control's own handler, never
|
|
1131
|
+
instead of it. Pick a `variant` first — `ghost` or `none` — when the whole box
|
|
1132
|
+
should change; `pt:box` is for the one-off, and
|
|
1133
|
+
`:pt:box="{ style: { '--bg': … } }"` is the sanctioned way to hand the box a
|
|
1134
|
+
look variable. `pt:input` carries native attributes (`autocomplete`,
|
|
1135
|
+
`inputmode`, `data-*`) as well as classes. Classes append to ours, an
|
|
1136
|
+
attribute in `attrs` wins over ours. The full grammar, the merge rules and
|
|
1137
|
+
the global map are in the [passthrough guide](./guides/passthrough.md).
|
|
1138
|
+
|
|
1139
|
+
A `pt` value written in `<script>` (a constant, a preset, a wrapper's
|
|
1140
|
+
`pt` prop) is typed as `BbTextInputProps['pt']`, never an imported `PtValue`: see
|
|
1141
|
+
[passthrough § Typing `pt` in `<script>`](./guides/passthrough.md#typing-pt-in-script).
|
|
1142
|
+
|
|
813
1143
|
### Works well with
|
|
814
1144
|
|
|
815
1145
|
- `BbButton` — submit actions; an async `@click` handler gets automatic
|
|
@@ -824,16 +1154,16 @@ const formattedTotal = computed(() =>
|
|
|
824
1154
|
|
|
825
1155
|
### Gotchas & anti-patterns
|
|
826
1156
|
|
|
827
|
-
- An emptied field emits `null
|
|
1157
|
+
- An emptied field emits `null` by default (`''` with the `formControls` plugin option) — write `value ?? ''` when feeding
|
|
828
1158
|
APIs that require strings.
|
|
829
|
-
- `
|
|
1159
|
+
- `layout` is ignored under `labelMode="floating"`/`"inside"` — those modes
|
|
830
1160
|
embed the label in the field and force the vertical layout (see _Density &
|
|
831
1161
|
layout_).
|
|
832
1162
|
- `loading` does not lock the field — it's a status light, not a guard.
|
|
833
1163
|
- Don't rebuild the clear button in an `append` slot; `clearable` already
|
|
834
1164
|
handles show/hide, clearing and refocusing.
|
|
835
1165
|
- Don't put buttons in `prefix`/`suffix` — clicks there focus the input; use
|
|
836
|
-
`append
|
|
1166
|
+
`append:outer`/`prepend:outer` for interactive neighbors.
|
|
837
1167
|
- Don't validate _while_ the user types their first attempt; validate on
|
|
838
1168
|
`blur` or submit, then clear errors on `input` (see the invoice example).
|
|
839
1169
|
- Masked fields emit the **unmasked** value by default — don't strip
|
|
@@ -858,79 +1188,127 @@ const formattedTotal = computed(() =>
|
|
|
858
1188
|
|
|
859
1189
|
## v-model
|
|
860
1190
|
|
|
861
|
-
- `v-model` — type: `string \| null`
|
|
1191
|
+
- `v-model` — type: `string \| null \| undefined`
|
|
862
1192
|
|
|
863
1193
|
## Props
|
|
864
1194
|
|
|
865
1195
|
| Prop | Type | Default | Required | Description |
|
|
866
1196
|
| --- | --- | --- | --- | --- |
|
|
1197
|
+
| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `box`, `clear`, `description`, `hint`, `icon`, `input`, `label`, `message`, `prefix`, `root`, `spinner`, `suffix`. States: `disabled`, `errors`, `hasValue`, `loading`, `readonly`, `warnings`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbTextInputProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
|
|
867
1198
|
| `append:icon` | `string \| undefined` | | | Name of the icon to be added at the end of the input. |
|
|
868
1199
|
| `autocomplete` | `string \| undefined` | | | Guides to the browser as to the type of information expected in the field. |
|
|
869
1200
|
| `autofocus` | `Booleanish \| undefined` | | | Sets autofocus on page load. |
|
|
870
|
-
| `clearable` | `boolean \| undefined` |
|
|
871
|
-
| `compact` | `boolean \| undefined` |
|
|
1201
|
+
| `clearable` | `boolean \| undefined` | `false` | | Displays a clear button when the input has a value and is being interacted with. |
|
|
1202
|
+
| `compact` | `boolean \| undefined` | `false` | | Compact density. Swaps `--bb-input-h`, `--bb-input-py` and `--bb-label-spacing-y` for their `-compact` twins on the field, so a `--bb-input-h` you set on the component is ignored while `compact` is on: size a compact field with `--bb-input-h-compact` (and `--bb-input-py-compact`) instead. |
|
|
872
1203
|
| `description` | `string \| undefined` | | | Descriptive text displayed below the label and above the input. Unlike the hint it is always visible, and it is linked to the input via `aria-describedby` (after any `errors` / `warnings`, before the `hint`). |
|
|
873
|
-
| `
|
|
874
|
-
| `
|
|
875
|
-
| `
|
|
876
|
-
| `
|
|
877
|
-
| `hasErrors` | `boolean \| undefined` |
|
|
878
|
-
| `
|
|
879
|
-
| `hideLabel` | `boolean \| undefined` |
|
|
1204
|
+
| `disabled` | `boolean \| undefined` | `false` | | Disables the component. |
|
|
1205
|
+
| `emitMasked` | `boolean \| undefined` | `false` | | Emits the masked value of the input. |
|
|
1206
|
+
| `errors` | `string \| string[] \| undefined` | | | Can be a string or an array of string containing the messages to display. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, are referenced FIRST from the control's `aria-describedby`, so the reason the field is invalid is re-read whenever the control regains focus. |
|
|
1207
|
+
| `formless` | `boolean \| undefined` | `false` | | Keep this control out of the enclosing `BbForm` entirely: not submitted, not dirty, not reset, not validated. For a control that is not form data (a filter, a "show advanced" switch). |
|
|
1208
|
+
| `hasErrors` | `boolean \| undefined` | `false` | | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
|
|
1209
|
+
| `hasWarnings` | `boolean \| undefined` | `false` | | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
|
|
1210
|
+
| `hideLabel` | `boolean \| undefined` | `false` | | Visually hides the label of the input while maintaining accessibility. |
|
|
880
1211
|
| `hint` | `string \| undefined` | | | Text box to be displayed near the input, usually to indicate instructions. |
|
|
881
|
-
| `id` | `string \| undefined` | | | The
|
|
882
|
-
| `inputMode` | `"text" \| "
|
|
1212
|
+
| `id` | `string \| undefined` | | | The `id` of the native control; the label's `for` and the description and message ids derive from it. Generated when omitted. |
|
|
1213
|
+
| `inputMode` | `"text" \| "none" \| "search" \| "email" \| "url" \| "tel" \| "numeric" \| "decimal" \| undefined` | | | The inputmode of the input. |
|
|
883
1214
|
| `label` | `string` | | yes | Text content of the label of the element. |
|
|
884
|
-
| `labelMode` | `"
|
|
1215
|
+
| `labelMode` | `"outside" \| "floating" \| "inside" \| undefined` | | | Label rendering mode. |
|
|
885
1216
|
| `labelPosition` | `"left" \| "center" \| "right" \| undefined` | | | Sets the text alignment of the label. |
|
|
886
|
-
| `
|
|
1217
|
+
| `layout` | `FieldLayout \| undefined` | | | How the label and the input sit together: `'vertical'`, `'horizontal'` (50/50), `'auto'`, `'label-fill'` (the label takes the free space, the input keeps its size), `'input-fill'` (the other way round), or a two-word ratio pattern like `'xx xxxxx'`. |
|
|
1218
|
+
| `loading` | `boolean \| undefined` | `false` | | Sets the component in a loading state, usually triggering some visual styles. |
|
|
887
1219
|
| `mask` | `MaskInputOptions \| undefined` | | | The mask to be applied to the input. Please visit https://beholdr.github.io/maska/v3 for syntax examples. |
|
|
888
|
-
| `modelValue` | `string \| null` | |
|
|
1220
|
+
| `modelValue` | `string \| null \| undefined` | | | Used by v-model. |
|
|
889
1221
|
| `name` | `string \| undefined` | | | Defines the name of the input. |
|
|
890
|
-
| `persistentHint` | `boolean \| undefined` |
|
|
1222
|
+
| `persistentHint` | `boolean \| undefined` | `false` | | Keeps the hint displayed. |
|
|
891
1223
|
| `placeholder` | `string \| undefined` | | | String displayed when there's no data. |
|
|
892
1224
|
| `prepend:icon` | `string \| undefined` | | | Name of the icon to be added at the start of the input. |
|
|
893
|
-
| `readonly` | `boolean \| undefined` |
|
|
894
|
-
| `required` | `boolean \| undefined` |
|
|
895
|
-
| `reverse` | `boolean \| undefined` |
|
|
896
|
-
| `
|
|
897
|
-
| `
|
|
1225
|
+
| `readonly` | `boolean \| undefined` | `false` | | Sets the input in a readonly state. |
|
|
1226
|
+
| `required` | `boolean \| undefined` | `false` | | Sets the input as required. |
|
|
1227
|
+
| `reverse` | `boolean \| undefined` | `false` | | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
|
|
1228
|
+
| `rules` | `RuleExpression<string \| null>` | | | vee-validate rules for this field. Only inside a `BbForm`. |
|
|
1229
|
+
| `type` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "password" \| undefined` | `"text"` | | Type of the input. Restricted to the textual input types this component supports — use `BbNumberInput` for numbers and `BbDatePickerInput` for dates. |
|
|
1230
|
+
| `validationLabel` | `string \| undefined` | | | The field's name in validation messages (`{field}`): "Email is not valid". Defaults to the `label` (or `legend`), then "This field"; the field's `name` never shows. Set it when the label is not a good noun for a sentence (an icon-only label, a question) or is hidden. Only inside a `BbForm`. |
|
|
1231
|
+
| `validationMode` | `'aggressive'` \| `'balanced'` \| `'lazy'` \| `'submit-only'` \| `'submit-live'` | | | When this field checks itself while the user works: `aggressive` (every change), `balanced` (on leave, then every change while it shows an error), `lazy` (on leave only), `submit-only` (on submit only) or `submit-live` (on submit, then every change while it shows an error). "Leave" is blur for a text-like control, and focus leaving the whole control for a picker or a group; a checkbox or switch commits on click. Unset, the enclosing `BbForm`'s `validation-mode` applies, then the app's `formControls.validationMode` (`'balanced'`). Only inside a `BbForm`. |
|
|
1232
|
+
| `variant` | `'outline'` \| `'secondary'` \| `'none'` \| `'ghost'` | `'outline'` | | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any state (errors and warnings show through the icon and the messages); every variant keeps the focus ring. Register extra names with the plugin's `inputVariants` option. `'none'` is a blank starting point: the field keeps its structure and behaviour but takes no look, so your own classes don't fight a built-in one. You then own hover, focus, disabled and the error / warning states. Fine for a one-off; keep inline styling short, and register a real variant (`inputVariants`) when the look recurs. |
|
|
1233
|
+
| `warnings` | `string \| string[] \| undefined` | | | Warning messages to display beneath the field, in their own `aria-live` region and amber (`--bb-text-warn`). A string or array; a non-empty list implies the warning state. Errors suppress warnings when both are set. While displayed they are also referenced from the control's `aria-describedby`, after any errors and before the description/hint. |
|
|
1234
|
+
|
|
1235
|
+
## Passthrough parts and states
|
|
1236
|
+
|
|
1237
|
+
`pt:<part>="…"` restyles a part; `pt:<part>:<state>="…"` applies only while the state is on. A component-wide state is on for every part at once; a _per node_ state resolves on each node of a broadcast part (one row, one option, one day). Grammar and merge rules: `guides/passthrough.md`. In `<script>`, type a `pt` value as `<Component>Props['pt']` (`<Component>Props<Row>['pt']` on a generic component); `PtValue` is not exported: `guides/passthrough.md` § Typing `pt` in `<script>`.
|
|
1238
|
+
|
|
1239
|
+
| Part | What it is |
|
|
1240
|
+
| --- | --- |
|
|
1241
|
+
| `root` | The field's outer container: the label, the box and the lines under it. |
|
|
1242
|
+
| `label` | The label text above the box (the `label` prop). |
|
|
1243
|
+
| `description` | The muted line under the label (the `description` prop). |
|
|
1244
|
+
| `message` | The errors / warnings line under the box. A node of its own: it can show at the same time as `hint`. |
|
|
1245
|
+
| `hint` | The helper line (the `hint` prop), shown on focus, or always with `persistent-hint`. |
|
|
1246
|
+
| `box` | The bordered box around the input — border, background and radius; the `variant` paints here. |
|
|
1247
|
+
| `input` | The native input element inside the box. |
|
|
1248
|
+
| `icon` | The content icons, prepend and append — a broadcast. Chrome (the clear ✕, a chevron, the error / warning glyph) is never in it. |
|
|
1249
|
+
| `spinner` | The spinner inside the box while `loading`. |
|
|
1250
|
+
| `prefix` | The `#prefix` slot's wrapper, inside the box before the input. |
|
|
1251
|
+
| `suffix` | The `#suffix` slot's wrapper, inside the box after the input. |
|
|
1252
|
+
| `clear` | The ✕ that empties this control (`clearable`) — one node, never a chip's own ✕. |
|
|
1253
|
+
|
|
1254
|
+
States are listed in precedence order: when two are on at once and their entries conflict, the later one wins.
|
|
1255
|
+
|
|
1256
|
+
| State | When it is on |
|
|
1257
|
+
| --- | --- |
|
|
1258
|
+
| `hasValue` | Component-wide: the control holds a value, by its own rule (`0` counts on `BbNumberInput`, `''` on `BbColorInput`). |
|
|
1259
|
+
| `readonly` | Component-wide: the control is `readonly` — shown, focusable, not editable. |
|
|
1260
|
+
| `disabled` | Component-wide: the control is `disabled`. |
|
|
1261
|
+
| `warnings` | Component-wide: the control is in its warning state (`warnings` / `has-warnings`) and not in an error state — errors win, so the two are never on together. |
|
|
1262
|
+
| `errors` | Component-wide: the control is in its error state (`errors` / `has-errors`, or its validation) — the message line and the box turn red. |
|
|
1263
|
+
| `loading` | Component-wide: `loading` is on; the box shows its `spinner`. |
|
|
898
1264
|
|
|
899
1265
|
## Events
|
|
900
1266
|
|
|
901
|
-
- `blur` — `(event:
|
|
902
|
-
- `change` — `(event:
|
|
903
|
-
- `click` — `(event:
|
|
904
|
-
- `compositionend` — `(event:
|
|
905
|
-
- `compositionstart` — `(event:
|
|
906
|
-
- `focus` — `(event:
|
|
907
|
-
- `input` — `(event:
|
|
908
|
-
- `keydown` — `(event:
|
|
909
|
-
- `keyup` — `(event:
|
|
910
|
-
- `mousedown` — `(event:
|
|
911
|
-
- `mouseup` — `(event:
|
|
912
|
-
- `paste` — `(event:
|
|
913
|
-
- `update:modelValue` — `(
|
|
1267
|
+
- `blur` — `(event: FocusEvent): void` — Emitted when the native input loses focus. Forwards the original DOM `FocusEvent`.
|
|
1268
|
+
- `change` — `(event: Event): void` — Emitted when the native input fires a change event. Forwards the original DOM `Event`.
|
|
1269
|
+
- `click` — `(event: MouseEvent): void` — Emitted when the input receives a click interaction. Forwards the original DOM `MouseEvent`.
|
|
1270
|
+
- `compositionend` — `(event: CompositionEvent): void` — Emitted when a composition session ends (e.g. CJK IME confirmed). Forwards the original DOM `CompositionEvent`.
|
|
1271
|
+
- `compositionstart` — `(event: CompositionEvent): void` — Emitted when a composition session starts (e.g. CJK IME begins). Forwards the original DOM `CompositionEvent`.
|
|
1272
|
+
- `focus` — `(event: FocusEvent): void` — Emitted when the native input gains focus. Forwards the original DOM `FocusEvent`.
|
|
1273
|
+
- `input` — `(event: Event): void` — Emitted on native input events from the text field. Forwards the original DOM `Event`.
|
|
1274
|
+
- `keydown` — `(event: KeyboardEvent): void` — Emitted for keyboard interaction on the input. Forwards the original DOM `KeyboardEvent`.
|
|
1275
|
+
- `keyup` — `(event: KeyboardEvent): void` — Emitted when a key is released over the input. Forwards the original DOM `KeyboardEvent`.
|
|
1276
|
+
- `mousedown` — `(event: MouseEvent): void` — Emitted when a pointing device button is pressed over the input. Forwards the original DOM `MouseEvent`.
|
|
1277
|
+
- `mouseup` — `(event: MouseEvent): void` — Emitted when a pointing device button is released over the input. Forwards the original DOM `MouseEvent`.
|
|
1278
|
+
- `paste` — `(event: ClipboardEvent): void` — Emitted when content is pasted into the input. Forwards the original DOM `ClipboardEvent`.
|
|
1279
|
+
- `update:modelValue` — `(value: string \| null): void` — Emitted when the value changes. Carries the new string or `null` when cleared. When `mask` is set, emits the masked or unmasked string depending on `emitMasked`.
|
|
914
1280
|
|
|
915
1281
|
## Slots
|
|
916
1282
|
|
|
917
|
-
- `append` — scope: `object` — Content rendered after the text input, at the end of the
|
|
918
|
-
- `append
|
|
919
|
-
- `
|
|
1283
|
+
- `append` — scope: `object` — Content rendered after the text input, at the end of the field box.
|
|
1284
|
+
- `append:outer` — scope: `object` — Content rendered after the entire text input control, outside the input chrome.
|
|
1285
|
+
- `description` — scope: `BbTextInputDescriptionSlotProps` `{ text: string; hasErrors: boolean; hasWarnings: boolean }` — Replaces the description text. Provided alone (no `description` prop) it still renders the description region and wires it into `aria-describedby`.
|
|
1286
|
+
- `label` — scope: `BbTextInputLabelSlotProps` `{ text: string; hasErrors: boolean; hasWarnings: boolean }` — Replaces the default label text rendered above the input.
|
|
920
1287
|
- `prefix` — scope: `object` — Inline content rendered at the start of the input field area, before the typed text.
|
|
921
|
-
- `prepend` — scope: `object` — Content rendered before the text input, at the start of the
|
|
922
|
-
- `prepend
|
|
1288
|
+
- `prepend` — scope: `object` — Content rendered before the text input, at the start of the field box.
|
|
1289
|
+
- `prepend:outer` — scope: `object` — Content rendered before the entire text input control, outside the input chrome.
|
|
923
1290
|
- `suffix` — scope: `object` — Inline content rendered at the end of the input field area, after the typed text.
|
|
924
1291
|
|
|
925
|
-
##
|
|
1292
|
+
## CSS custom properties
|
|
926
1293
|
|
|
927
|
-
|
|
1294
|
+
Set these on the element, or on a class you put on it, to retune this component alone — the sanctioned alternative to reaching past the API with `:deep()`. They are this component's own locals — a **Set on** of `pt:<part>` means the local lives on that part's element, so set it through that entry (`pt:box="[--border-color:var(--color-green-500)]"`); the global `--bb-*` theme tokens are a separate tier (see the [design-tokens guide](./guides/design-tokens.md), or the MCP `list_tokens` tool).
|
|
928
1295
|
|
|
929
|
-
|
|
|
930
|
-
| --- | --- | --- |
|
|
931
|
-
| `
|
|
932
|
-
|
|
933
|
-
|
|
1296
|
+
| Property | Set on | Default | What it is |
|
|
1297
|
+
| --- | --- | --- | --- |
|
|
1298
|
+
| `--border-color` | `pt:box` | `per variant` | The resting border, at the fixed --bb-border-w. Errors and warnings paint their frame over it, so `pt:box="[--border-color:…]"` recolours the rest without hiding the state; a plain `border-*` utility on the base pt:box would hide it (ESLint `no-box-border-color`). |
|
|
1299
|
+
|
|
1300
|
+
## Component tree
|
|
1301
|
+
|
|
1302
|
+
`BbTextInput` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `BbTextInput`, and before concluding a part, a token or a behaviour does not exist** — it may live on a component further down. How to read it:
|
|
1303
|
+
|
|
1304
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `BbTextInput`. A pt part listed as landing there is set on `BbTextInput` (`pt:<part>`).
|
|
1305
|
+
- **_public_** nodes are components with their own contract. `BbTextInput` reaches one only through a pt part of its own that lands on it (shown on the parent node as `part → Component`, e.g. `spinner → BbSpinner`) or through a pt map it hands it (shown as "hands … the pt map", in `BbTextInput`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
1306
|
+
- **CSS custom properties** listed on a node are declared on THAT node's root and read by elements inside it. Set one on that node's root or on the element inside it that reads it — the pt part that lands there is how you reach it (`pt:box="[--border-color:…]"` on a text input) — never on `BbTextInput`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
1307
|
+
- Listed nodes are the ones `BbTextInput`'s API reaches or that declare a documented CSS variable; the rest fold into "also mounts". The complete tree, repeats and undocumented locals included, is the `tree` field of this component in `components.json`.
|
|
1308
|
+
|
|
1309
|
+
- `BbTextInput` _(this component)_ — its own template binds: `controlAttrs` → `input.bb-text-input__input`, `input` → `input.bb-text-input__input`
|
|
1310
|
+
- `CommonField` _(internal — not importable, reach it through `BbTextInput`)_ — `BbTextInput`'s pt parts land here: `root` → `div.bb-field`, `label` → `component`, `description` → `span.bb-field__description`, `hint` → `span.bb-field__hint`, `message` → `div.bb-field__message`; also mounts `BbAsterisk`
|
|
1311
|
+
- `CommonFieldInput` _(internal — not importable, reach it through `BbTextInput`)_ — `BbTextInput`'s pt parts land here: `box` → `span.bb-field-input__box`, `prefix` → `span.bb-field-input__prefix`, `icon` → `BbIcon`, `clear` → `ClearableButton`, `spinner` → `BbSpinner`, `suffix` → `span.bb-field-input__suffix`; documented CSS variables: `--bg`, `--bg-hover`, `--bg-focus`, `--bg-disabled`, `--border-color`, `--border-focus`, `--ring-size`, `--ring-color`, `--elev`, `--frost`, `--inside-label-clearance`; also mounts `ErrorIcon`, `WarningIcon`, `ClearableButton`, `BbIcon`, `BbSpinner`
|
|
934
1312
|
|
|
935
1313
|
## See Also
|
|
936
1314
|
|