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/ChipsBox.md
CHANGED
|
@@ -8,17 +8,46 @@
|
|
|
8
8
|
- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
|
|
9
9
|
- Implementation source (only when the contract below is not enough): [source/ChipsBox.md](./source/ChipsBox.md)
|
|
10
10
|
|
|
11
|
+
## Reachable through `ChipsBox`
|
|
12
|
+
|
|
13
|
+
`ChipsBox` 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:badge` | the root of `BbBadge` | `BbBadge` ([contract](./BbBadge.md)) |
|
|
18
|
+
|
|
19
|
+
**CSS variables you can set through those parts** — declared deeper in the tree, so set one on the part that reads it (`pt:<part>="[--name:value]"`), never on `ChipsBox`'s root:
|
|
20
|
+
|
|
21
|
+
| Variable | Set through | Declared by | What it is |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| `--bg` | `pt:badge` | `BbBadge` | pill fill |
|
|
24
|
+
| `--fg` | `pt:badge` | `BbBadge` | label, icons and the clear glyph |
|
|
25
|
+
| `--bw` | `pt:badge` | `BbBadge` | Pill border. The `border` shorthand is always present, so the width is what turns it on — the filled variants leave it at 0 and the bordered ones (secondary/destructive/outline) step up to `--bb-border-w-sm`. Nothing compensates for it: the stroke sits between the label and the pill edge. |
|
|
26
|
+
| `--ring-color` | `pt:badge` | `BbBadge` | focus ring colour, per variant |
|
|
27
|
+
| `--ring-size` | `pt:badge` | `BbBadge` | focus ring width |
|
|
28
|
+
| `--min-size-md` | `pt:badge` | `BbBadge` | 18px at the default |
|
|
29
|
+
| `--min-size` | `pt:badge` | `BbBadge` | pill min height and min width |
|
|
30
|
+
| `--elev` | `pt:badge` | `BbBadge` | Resting lift. Invisible while `--bb-elev` is its default transparent layer. A chip is small enough that a theme wanting a different lift here than on a button sets `--elev` on this class. |
|
|
31
|
+
| `--r` | `pt:badge` | `BbBadge` | Pill corners; the body and trailing wrappers round their outer edges to match |
|
|
32
|
+
| `--fs` | `pt:badge` | `BbBadge` | 12px at the default (Q49.25) |
|
|
33
|
+
| `--icon-size` | `pt:badge` | `BbBadge` | leading/append icons (passed to BbIcon as --size) |
|
|
34
|
+
| `--gap` | `pt:badge` | `BbBadge` | space between label, icons and the trailing side |
|
|
35
|
+
| `--px` | `pt:badge` | `BbBadge` | base side padding; the modifiers below scale it per side |
|
|
36
|
+
| `--clear-size` | `pt:badge` | `BbBadge` | clear button's glyph box (the circle painted on hover is 2px smaller) |
|
|
37
|
+
| `--pad-left` | `pt:badge` | `BbBadge` | Side-owned padding: the body and trailing wrappers carry the pill's inline padding (and its radius) so their hit areas run flush to the border. The modifiers below retune these vars instead of the pill's own padding. |
|
|
38
|
+
|
|
11
39
|
## Props
|
|
12
40
|
|
|
13
41
|
| Prop | Type | Default | Required | Description |
|
|
14
42
|
| --- | --- | --- | --- | --- |
|
|
15
|
-
| `disabled` | `boolean \| undefined` |
|
|
43
|
+
| `disabled` | `boolean \| undefined` | `false` | | Whether the component is disabled. |
|
|
16
44
|
| `options` | `Option[]` | | yes | List of options to render as chips. |
|
|
45
|
+
| `passthrough` | `PtBindings<"badge", "highlighted"> \| undefined` | | | Passthrough bindings resolved by the public control: `badge` is one chip, resolved per chip through `part()` with its `highlighted` and its option's raw item. Internal. |
|
|
17
46
|
| `size` | `"xs" \| "sm" \| "md" \| "lg" \| "xl" \| "2xl" \| undefined` | | | The size of the chips. |
|
|
18
47
|
|
|
19
48
|
## Events
|
|
20
49
|
|
|
21
|
-
- `option:unselected` — `(
|
|
50
|
+
- `option:unselected` — `(option: Option): void` — Emitted when the user clears (removes) an option chip.
|
|
22
51
|
|
|
23
52
|
## Slots
|
|
24
53
|
|
|
@@ -36,3 +65,15 @@
|
|
|
36
65
|
- `focusNext`: `() => void`
|
|
37
66
|
- `focusPrevious`: `() => Promise<void>`
|
|
38
67
|
- `getHighlighted`: `() => Option \| undefined`
|
|
68
|
+
|
|
69
|
+
## Component tree
|
|
70
|
+
|
|
71
|
+
`ChipsBox` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `ChipsBox`, 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:
|
|
72
|
+
|
|
73
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `ChipsBox`. A pt part listed as landing there is set on `ChipsBox` (`pt:<part>`).
|
|
74
|
+
- **_public_** nodes are components with their own contract. `ChipsBox` 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 `ChipsBox`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
75
|
+
- **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 `ChipsBox`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
76
|
+
- Listed nodes are the ones `ChipsBox`'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`.
|
|
77
|
+
|
|
78
|
+
- `ChipsBox` _(this component)_ — its own template binds: `badge` → `BbBadge`
|
|
79
|
+
- `BbBadge` _(public — [contract](./BbBadge.md))_ — its own pt parts (`BbBadge`): `spinner` → `BbSpinner`, `icon` → `BbIcon`, `clear` → `button.bb-badge__clear`; documented CSS variables: `--bg`, `--fg`, `--bw`, `--ring-color`, `--ring-size`, `--min-size-md`, `--min-size`, `--elev`, `--r`, `--fs`, `--icon-size`, `--gap`, `--px`, `--clear-size`, `--pad-left`; also mounts `BbIcon`, `BbSpinner`, `BadgeBodyContent`
|
|
@@ -21,3 +21,15 @@
|
|
|
21
21
|
## Slots
|
|
22
22
|
|
|
23
23
|
- None.
|
|
24
|
+
|
|
25
|
+
## Component tree
|
|
26
|
+
|
|
27
|
+
`ClearableButton` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `ClearableButton`, 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:
|
|
28
|
+
|
|
29
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `ClearableButton`. A pt part listed as landing there is set on `ClearableButton` (`pt:<part>`).
|
|
30
|
+
- **_public_** nodes are components with their own contract. `ClearableButton` 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 `ClearableButton`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
31
|
+
- **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 `ClearableButton`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
32
|
+
- Listed nodes are the ones `ClearableButton`'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`.
|
|
33
|
+
|
|
34
|
+
- `ClearableButton` _(this component)_
|
|
35
|
+
- Also mounts `BbIcon`
|
package/dist/ai/CommaBox.md
CHANGED
|
@@ -13,10 +13,11 @@
|
|
|
13
13
|
| Prop | Type | Default | Required | Description |
|
|
14
14
|
| --- | --- | --- | --- | --- |
|
|
15
15
|
| `options` | `Option[]` | | yes | List of options to render as comma-separated text items. |
|
|
16
|
+
| `passthrough` | `PtBindings<"comma", "highlighted"> \| undefined` | | | Passthrough bindings resolved by the public control: `comma` is one entry, resolved per entry through `part()` with its `highlighted` and its option's raw item. Internal. |
|
|
16
17
|
|
|
17
18
|
## Events
|
|
18
19
|
|
|
19
|
-
- `option:unselected` — `(
|
|
20
|
+
- `option:unselected` — `(option: Option): void` — Emitted when the user removes an option.
|
|
20
21
|
|
|
21
22
|
## Slots
|
|
22
23
|
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# CommonField
|
|
2
|
+
|
|
3
|
+
## Agent Contract
|
|
4
|
+
|
|
5
|
+
- Safety level: **Reference Only - Internal**
|
|
6
|
+
- Group: **Reference Only - Base Primitive**
|
|
7
|
+
- Description: Internal wrapper for labels, hints, validation, and shared input layout.
|
|
8
|
+
- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
|
|
9
|
+
- Implementation source (only when the contract below is not enough): [source/CommonField.md](./source/CommonField.md)
|
|
10
|
+
|
|
11
|
+
## Props
|
|
12
|
+
|
|
13
|
+
| Prop | Type | Default | Required | Description |
|
|
14
|
+
| --- | --- | --- | --- | --- |
|
|
15
|
+
| `clearable` | `boolean \| undefined` | `false` | | Whether the inner control exposes a clear action. |
|
|
16
|
+
| `compact` | `boolean \| undefined` | `false` | | Apply the compact density variant to the container. |
|
|
17
|
+
| `description` | `string \| undefined` | | | Always-visible descriptive text rendered below the label and above the input, in muted foreground color. When present, its id is exposed to the input slot via `ariaDescribedby`, after any error/warning ids and before the hint id. In `floating` label mode it renders as a single line above the field and the label floats past it; in `inside` label mode it renders as a second single line under the label, growing the field. |
|
|
18
|
+
| `disabled` | `boolean \| undefined` | `false` | | Whether the inner control is disabled. |
|
|
19
|
+
| `errors` | `string \| string[] \| undefined` | | | Messages displayed beneath the input. Accepts a string or array; values are rendered one per line. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, their container id is also exposed to the input slot via `ariaDescribedby` — first in the list — so the reason the field is invalid is re-read whenever the control regains focus. |
|
|
20
|
+
| `hasErrors` | `boolean \| undefined` | `false` | | Forces the error state independently of `errors`, useful to pre-style the container. |
|
|
21
|
+
| `hasValue` | `boolean \| undefined` | `false` | | Whether the inner control currently contains a value. |
|
|
22
|
+
| `hasWarnings` | `boolean \| undefined` | `false` | | Forces the warning state independently of `warnings`. Same chrome as errors but with `--bb-warn`; errors take priority when both are set. |
|
|
23
|
+
| `hideLabel` | `boolean \| undefined` | `false` | | Hide the visual label while keeping it available to assistive technology. |
|
|
24
|
+
| `hint` | `string \| undefined` | | | Hint text rendered below the input. While shown, its id is exposed to the input slot via `ariaDescribedby` — last in the list, after any error/warning ids and the description id. |
|
|
25
|
+
| `id` | `string \| undefined` | | | Explicit id for the container and associated input. Falls back to an auto-generated id when omitted. |
|
|
26
|
+
| `inputPosition` | `"left" \| "center" \| "right" \| undefined` | `'left'` | | Horizontal alignment of the input column when the layout is side by side. Unset, it follows the layout: `'right'` in a horizontal/ratio split (beside the left-hand label), `'left'` otherwise — and `layout` is `'vertical'` by default, so the effective default is `'left'`. |
|
|
27
|
+
| `label` | `string` | | yes | Visible label text for the field. Also used to derive a fallback name. |
|
|
28
|
+
| `labelMode` | `"outside" \| "floating" \| "inside" \| undefined` | | | Label rendering mode. |
|
|
29
|
+
| `labelPosition` | `"left" \| "center" \| "right" \| undefined` | `"left"` | | Horizontal alignment for the label column. |
|
|
30
|
+
| `labelTag` | `'span'` \| `'label'` \| `'legend'` | `"label"` | | Element used for the label: `label` (default), `legend` inside a `fieldset` container, or `span` when the text must not steal the click because the control already carries its own label. |
|
|
31
|
+
| `layout` | `FieldLayout \| undefined` | `"vertical"` | | Controls label/input layout. Accepts `'vertical'`, `'horizontal'`, `'auto'`, `'label-fill'`, `'input-fill'`, or a two-token ratio pattern such as `"xx xxxxx"` that sizes the label/input columns by token length. An unrecognized value warns and falls back to `'auto'`. |
|
|
32
|
+
| `loading` | `boolean \| undefined` | `false` | | Whether the inner control is in a loading state. |
|
|
33
|
+
| `mobile` | `boolean \| undefined` | `false` | | Whether the inner control is in mobile viewport mode. |
|
|
34
|
+
| `name` | `string \| undefined` | | | Explicit name attribute forwarded to the input. When omitted, a slug derived from `label` is used. |
|
|
35
|
+
| `passthrough` | `PtBindings<FieldPtPart> \| undefined` | | | Passthrough bindings resolved by the public control (`usePassthrough`), one `v-bind` object per part this container renders: `root`, `label`, `description`, `message` (the errors AND the warnings node — only one ever shows). Bound last on each node. Internal: the public control's `pt:*` props are the consumer-facing surface. |
|
|
36
|
+
| `readonly` | `boolean \| undefined` | `false` | | Whether the inner control is readonly. |
|
|
37
|
+
| `reverse` | `boolean \| undefined` | `false` | | Swap the label and input columns. |
|
|
38
|
+
| `showAsterisk` | `boolean \| undefined` | `false` | | Render the required marker (`BbAsterisk`) after the label text. The control decides (useFormBinding); a `#label` slot gets it as `showAsterisk` and renders its own. |
|
|
39
|
+
| `showHint` | `boolean \| undefined` | `false` | | Keep the hint permanently visible, regardless of focus. |
|
|
40
|
+
| `tag` | `'div'` \| `'span'` \| `'label'` \| `'fieldset'` | `"span"` | | Element used for the inner wrapper: `span` (default) to remain inline, `div` for a block wrapper, `fieldset` for grouped controls (pair it with `labelTag="legend"`), or `label` to make the whole wrapper activate the control. |
|
|
41
|
+
| `warnings` | `string \| string[] \| undefined` | | | Warning messages displayed beneath the input, in their own `aria-live` region. Accepts a string or array; values are rendered one per line, in `--bb-text-warn` amber (the text-contrast half of the warning pair — the chrome stays on `--bb-warn`). A non-empty list implies the warning state (mirroring how `errors` implies the error state); errors suppress warning messages when both are set. While displayed, the container id is also exposed to the input slot via `ariaDescribedby` (after any errors, before description/hint). |
|
|
42
|
+
|
|
43
|
+
## Events
|
|
44
|
+
|
|
45
|
+
- None.
|
|
46
|
+
|
|
47
|
+
## Slots
|
|
48
|
+
|
|
49
|
+
- `description` — scope: `CommonFieldLabelSlotProps` `{ text: string; hasErrors: boolean; hasWarnings: boolean; showAsterisk?: boolean }` — Replaces the description text. Rendering the slot alone (no `description` prop) shows the description region and wires it into `aria-describedby`. Stacks below the label, never beside it.
|
|
50
|
+
- `input` — scope: `CommonFieldInputSlotProps` `{ id: string; name: string; hasErrors: boolean; hasWarnings: boolean; ariaDescribedby: string; ariaLabelledby: string }` — The form control to render, positioned in the input column. Receives pre-computed wiring attributes so the inner input can be correctly associated with the label and hint.
|
|
51
|
+
- `label` — scope: `CommonFieldLabelSlotProps` `{ text: string; hasErrors: boolean; hasWarnings: boolean; showAsterisk?: boolean }` — Replaces the default label text. The outer label element and its `for` association are always rendered.
|
|
52
|
+
|
|
53
|
+
## Component tree
|
|
54
|
+
|
|
55
|
+
`CommonField` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `CommonField`, 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:
|
|
56
|
+
|
|
57
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `CommonField`. A pt part listed as landing there is set on `CommonField` (`pt:<part>`).
|
|
58
|
+
- **_public_** nodes are components with their own contract. `CommonField` 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 `CommonField`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
59
|
+
- **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 `CommonField`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
60
|
+
- Listed nodes are the ones `CommonField`'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`.
|
|
61
|
+
|
|
62
|
+
- `CommonField` _(this component)_ — its own template binds: `root` → `div.bb-field`, `label` → `component`, `description` → `span.bb-field__description`, `hint` → `span.bb-field__hint`, `message` → `div.bb-field__message`
|
|
63
|
+
- Also mounts `BbAsterisk`
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# CommonFieldInput
|
|
2
|
+
|
|
3
|
+
## Agent Contract
|
|
4
|
+
|
|
5
|
+
- Safety level: **Reference Only - Internal**
|
|
6
|
+
- Group: **Layout & Utility**
|
|
7
|
+
- Description: Shared wrapper utility for composed input controls.
|
|
8
|
+
- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
|
|
9
|
+
- Implementation source (only when the contract below is not enough): [source/CommonFieldInput.md](./source/CommonFieldInput.md)
|
|
10
|
+
|
|
11
|
+
## Reachable through `CommonFieldInput`
|
|
12
|
+
|
|
13
|
+
`CommonFieldInput` 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:icon` | the root of `BbIcon` | `BbIcon` ([contract](./BbIcon.md)) |
|
|
18
|
+
| `pt:clear` | the root of `ClearableButton` | `ClearableButton` _(internal)_ |
|
|
19
|
+
| `pt:spinner` | the root of `BbSpinner` | `BbSpinner` ([contract](./BbSpinner.md)) |
|
|
20
|
+
|
|
21
|
+
**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 `CommonFieldInput`'s root:
|
|
22
|
+
|
|
23
|
+
| Variable | Set through | Declared by | What it is |
|
|
24
|
+
| --- | --- | --- | --- |
|
|
25
|
+
| `--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. |
|
|
26
|
+
|
|
27
|
+
## Props
|
|
28
|
+
|
|
29
|
+
| Prop | Type | Default | Required | Description |
|
|
30
|
+
| --- | --- | --- | --- | --- |
|
|
31
|
+
| `active` | `boolean \| undefined` | `false` | | Whether the input is in active/focused state (e.g. open dropdown). |
|
|
32
|
+
| `append:icon` | `string \| undefined` | | | Name of the icon to be added at the end of the input. |
|
|
33
|
+
| `clearable` | `boolean \| undefined` | `false` | | Whether the input is clearable. |
|
|
34
|
+
| `compact` | `boolean \| undefined` | `false` | | Whether the input is in compact mode. |
|
|
35
|
+
| `disabled` | `boolean \| undefined` | `false` | | Whether the input is disabled. |
|
|
36
|
+
| `hasErrors` | `boolean \| undefined` | `false` | | Whether the input has validation errors. |
|
|
37
|
+
| `hasValue` | `boolean \| undefined` | `undefined` | | Whether the wrapped control currently has a value that can be cleared. |
|
|
38
|
+
| `hasWarnings` | `boolean \| undefined` | `false` | | Whether the input has a warning state. Visually identical to `hasErrors` but uses `--bb-warn` chrome; errors take priority when both are set. |
|
|
39
|
+
| `loading` | `boolean \| undefined` | `false` | | Whether the input is in a loading state. |
|
|
40
|
+
| `passthrough` | `PtBindings<FieldInputPtPart> \| undefined` | | | Passthrough bindings resolved by the public control, one `v-bind` object per part this wrapper renders: `box` (the bordered box), `icon` (the prepend AND append content icons — a broadcast; the clear button and the error/warning glyphs are chrome and never in it), `spinner` (the `BbSpinner` shown while `loading`), `prefix`, `suffix`, `clear`. Bound last on each node. Internal. |
|
|
41
|
+
| `prepend:icon` | `string \| undefined` | | | Name of the icon to be added at the start of the input. |
|
|
42
|
+
| `preventFocus` | `boolean \| undefined` | `false` | | Prevents the wrapper from focusing the inner input on click. |
|
|
43
|
+
| `readonly` | `boolean \| undefined` | `false` | | Whether the input is readonly. |
|
|
44
|
+
| `reserveAppendSpace` | `boolean \| undefined` | `false` | | Keeps trailing action/icon space reserved even when currently empty. |
|
|
45
|
+
| `variant` | `'outline'` \| `'secondary'` \| `'none'` \| `'ghost'` | `"outline"` | | Visual variant of the field box. Controls colours only — background, border colour, focus border — while height, padding and border WIDTH stay identical across variants, so switching one never reflows a form. Mirrors the equally named `BbButton` variants. |
|
|
46
|
+
|
|
47
|
+
## Events
|
|
48
|
+
|
|
49
|
+
- `click:clear` — `(): void` — Emitted when the clear button is clicked.
|
|
50
|
+
- `container:click` — `(): void` — Emitted when the input is clicked.
|
|
51
|
+
|
|
52
|
+
## Slots
|
|
53
|
+
|
|
54
|
+
- `append` — scope: `object` — Wraps the trailing suffix area. Renders a `<span>` containing the `suffix` sub-slot by default.
|
|
55
|
+
- `append:outer` — scope: `object` — Content appended outside the field box.
|
|
56
|
+
- `default` — scope: `object` — The main input element (e.g. `<input>` or `<textarea>`).
|
|
57
|
+
- `prefix` — scope: `object` — Content rendered as an inline text prefix inside the prepend span.
|
|
58
|
+
- `prepend` — scope: `object` — Wraps the leading prefix area. Renders a `<span>` containing the `prefix` sub-slot by default.
|
|
59
|
+
- `prepend:outer` — scope: `object` — Content prepended outside the field box.
|
|
60
|
+
- `suffix` — scope: `object` — Content rendered as an inline text suffix inside the append span.
|
|
61
|
+
|
|
62
|
+
## CSS custom properties
|
|
63
|
+
|
|
64
|
+
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).
|
|
65
|
+
|
|
66
|
+
| Property | Set on | Default | What it is |
|
|
67
|
+
| --- | --- | --- | --- |
|
|
68
|
+
| `--bg` | `.bb-field-input` | `transparent` | the shell's fill |
|
|
69
|
+
| `--bg-hover` | `.bb-field-input` | `var(--bg)` | fill under the pointer |
|
|
70
|
+
| `--bg-focus` | `.bb-field-input` | `var(--bg)` | fill while focus is inside, and under --active |
|
|
71
|
+
| `--bg-disabled` | `.bb-field-input` | `var(--bg)` | fill while disabled; beats hover and focus |
|
|
72
|
+
| `--border-color` | `.bb-field-input` | `transparent` | 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`). |
|
|
73
|
+
| `--border-focus` | `.bb-field-input` | `var(--border-color)` | frame while focused, or --active |
|
|
74
|
+
| `--ring-size` | `.bb-field-input` | `0px` | ring width; 0 is a variant declining the ring |
|
|
75
|
+
| `--ring-color` | `.bb-field-input` | `var(--bb-ring)` | ring colour; state owns it, not variants |
|
|
76
|
+
| `--elev` | `.bb-field-input` | `0 0 0 0 transparent` | 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. |
|
|
77
|
+
| `--frost` | `.bb-field-input` | `none` | 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. |
|
|
78
|
+
| `--inside-label-clearance` | `.bb-field-input__box` | `0px` | 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. |
|
|
79
|
+
|
|
80
|
+
## Component tree
|
|
81
|
+
|
|
82
|
+
`CommonFieldInput` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `CommonFieldInput`, 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:
|
|
83
|
+
|
|
84
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `CommonFieldInput`. A pt part listed as landing there is set on `CommonFieldInput` (`pt:<part>`).
|
|
85
|
+
- **_public_** nodes are components with their own contract. `CommonFieldInput` 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 `CommonFieldInput`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
86
|
+
- **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 `CommonFieldInput`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
87
|
+
- Listed nodes are the ones `CommonFieldInput`'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`.
|
|
88
|
+
|
|
89
|
+
- `CommonFieldInput` _(this component)_ — its own template binds: `box` → `span.bb-field-input__box`, `prefix` → `span.bb-field-input__prefix`, `icon` → `BbIcon`, `clear` → `ClearableButton`, `spinner` → `BbSpinner`, `suffix` → `span.bb-field-input__suffix`
|
|
90
|
+
- Also mounts `ErrorIcon`, `WarningIcon`, `ClearableButton`, `BbIcon`, `BbSpinner`
|
package/dist/ai/CommonPopover.md
CHANGED
|
@@ -18,24 +18,29 @@
|
|
|
18
18
|
| --- | --- | --- | --- | --- |
|
|
19
19
|
| `anchor` | `any` | | | The element the popover positions itself relative to. Accepts an HTMLElement, a Vue component ref, or a virtual element with a `getBoundingClientRect` method. |
|
|
20
20
|
| `arrowPadding` | `number \| undefined` | | | Space the arrow will maintain to the edge of the dropdown. Useful when the floating element has border radius so it won't appear broken |
|
|
21
|
-
| `boundary` | `string \| Record<string, any> \| HTMLElement \| null \| undefined` | | | Constrains the popover's *placement* within a bounding element: `flip` and `shift` keep the popover inside these bounds. Does NOT clamp the popover's size — a short boundary (e.g. a single-line nav) will not collapse the bubble. Use {@link
|
|
22
|
-
| `
|
|
23
|
-
| `
|
|
24
|
-
| `
|
|
25
|
-
| `
|
|
26
|
-
| `
|
|
21
|
+
| `boundary` | `string \| Record<string, any> \| HTMLElement \| null \| undefined` | | | Constrains the popover's *placement* within a bounding element: `flip` and `shift` keep the popover inside these bounds. Does NOT clamp the popover's size — a short boundary (e.g. a single-line nav) will not collapse the bubble. Use {@link overflowBoundary } to cap the reported `availableHeight`. Accepts an HTMLElement, a Vue component ref, or a CSS selector string. |
|
|
22
|
+
| `bubbleAttrs` | `Record<string, unknown> \| ((space: CommonPopoverAvailableSpace) => Record<string, unknown>) \| undefined` | | | Attributes bound on the bubble element (`class`, `style`, `inert`, …), merged after its own `bb-common-popover__bubble` class. Lets the owning component make the bubble its layout container instead of nesting a second box inside it. The function form receives the same free space as the default slot, for attributes that depend on it (a height cap). |
|
|
23
|
+
| `dialog` | `boolean \| undefined` | `false` | | Renders the popover as a `<dialog>` element (modal overlay) instead of a `<span>` with the Popover API. |
|
|
24
|
+
| `disableFlip` | `boolean \| undefined` | `false` | | Disables the automatic flip to the opposite side when the popover would overflow (flipping is on by default). |
|
|
25
|
+
| `eager` | `boolean \| undefined` | `false` | | Prevents rendering content before it's made visible. |
|
|
26
|
+
| `forceAutoUpdate` | `boolean \| undefined` | `false` | | Keeps floating-ui's `autoUpdate` (scroll/resize/resize-observer tracking) running while the popover is closed. By default the position is only tracked while the popover is open, so idle popovers attach no listeners. Enable this only when the anchor moves while the popover is closed and the next open must be pixel-perfect immediately. |
|
|
27
|
+
| `hideArrow` | `boolean \| undefined` | `false` | | Hides the arrow indicator. |
|
|
27
28
|
| `modelValue` | `boolean \| undefined` | `false` | | Used by v-model to show / hide the bubble. Closed until the owning component opens it. |
|
|
28
29
|
| `offset` | `number \| undefined` | | | Space the floating container will maintain from the activator. |
|
|
29
|
-
| `overflowBoundary` | `string \| Record<string, any> \| HTMLElement \| null \| undefined` | | | Bounding element the `size` middleware measures free space against, driving the `availableHeight`/`availableWidth` slot props. Defaults to the clipping ancestors (ultimately the viewport) when omitted, so the popover can grow to the full
|
|
30
|
+
| `overflowBoundary` | `string \| Record<string, any> \| HTMLElement \| null \| undefined` | | | Bounding element the `size` middleware measures free space against, driving the `availableHeight`/`availableWidth` slot props. Defaults to the clipping ancestors (ultimately the viewport) when omitted, so the popover can grow to the full available space regardless of a small positioning {@link boundary }. Accepts an HTMLElement, a Vue component ref, or a CSS selector string. |
|
|
30
31
|
| `padding` | `number \| undefined` | `0` | | Minimum empty space to keep from the edge of the page |
|
|
31
|
-
| `placement` | `
|
|
32
|
-
| `tag` | `
|
|
33
|
-
| `transitionDuration` | `number \| undefined` | `
|
|
32
|
+
| `placement` | `'left'` \| `'right'` \| `'top'` \| `'top-start'` \| `'top-end'` \| `'right-start'` \| `'right-end'` \| `'bottom'` \| `'bottom-start'` \| `'bottom-end'` \| `'left-start'` \| `'left-end'` | | | Position of the overlay in respect to the related activator. |
|
|
33
|
+
| `tag` | `'div'` \| `'span'` | `"div"` | | Element rendered as the popover wrapper (and as the bubble inside it). Overridden to `dialog` when `dialog` is `true`. The wrapper is `position: fixed` either way, so this only decides markup validity: `div` is correct wherever the bubble holds block content (menus, panels, grids), `span` for the rare mount point that only accepts phrasing content — e.g. inside `CommonField`'s inline control column. |
|
|
34
|
+
| `transitionDuration` | `number \| undefined` | `250` | | How long the transition has to last in milliseconds |
|
|
34
35
|
|
|
35
36
|
## Events
|
|
36
37
|
|
|
37
|
-
- `
|
|
38
|
+
- `hidden` — `(): void` — Emitted once the popover has left the top layer after its close transition.
|
|
39
|
+
- `hide` — `(): void` — Emitted as soon as the popover starts to close (the model becomes `false`).
|
|
40
|
+
- `show` — `(): void` — Emitted as soon as the popover starts to open (the model becomes `true`).
|
|
41
|
+
- `shown` — `(): void` — Emitted once the popover is open and its open transition has finished.
|
|
42
|
+
- `update:modelValue` — `(value: boolean): void` — Emitted with the new value whenever `v-model` changes.
|
|
38
43
|
|
|
39
44
|
## Slots
|
|
40
45
|
|
|
41
|
-
- `default` — scope: `{ availableWidth: number
|
|
46
|
+
- `default` — scope: `CommonPopoverAvailableSpace` `{ availableWidth: number; availableHeight: number }` — Content rendered inside the popover bubble. Receives the free space between the anchor and the boundary edge for the resolved placement, so the content can cap its own scroll container. Both are `undefined` until the first reposition measurement.
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# CommonTimeSelector
|
|
2
|
+
|
|
3
|
+
## Agent Contract
|
|
4
|
+
|
|
5
|
+
- Safety level: **Reference Only - Internal**
|
|
6
|
+
- Group: **Inputs**
|
|
7
|
+
- Description: Shared hour/minute(/second/AM-PM) time rail used by BbDatePicker, BbTimePicker and BbTimePickerInput.
|
|
8
|
+
- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
|
|
9
|
+
- Implementation source (only when the contract below is not enough): [source/CommonTimeSelector.md](./source/CommonTimeSelector.md)
|
|
10
|
+
|
|
11
|
+
## Reachable through `CommonTimeSelector`
|
|
12
|
+
|
|
13
|
+
`CommonTimeSelector` 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:item` | the root of `BbBaseButton` | `BbBaseButton` ([contract](./BbBaseButton.md)) |
|
|
18
|
+
|
|
19
|
+
## Props
|
|
20
|
+
|
|
21
|
+
| Prop | Type | Default | Required | Description |
|
|
22
|
+
| --- | --- | --- | --- | --- |
|
|
23
|
+
| `ampm` | `boolean \| undefined` | `false` | | 12-hour hour column plus an AM/PM column; emitted hours stay 24-hour. |
|
|
24
|
+
| `disabled` | `boolean \| undefined` | `false` | | Every column is inert: nothing can be picked. |
|
|
25
|
+
| `hour` | `string` | | yes | Current hour as a 24-hour field string (may be empty). |
|
|
26
|
+
| `max` | `string \| undefined` | | | Latest selectable time, `HH:mm`; the same rules as `min`. |
|
|
27
|
+
| `meridiem` | `string \| undefined` | | | Current meridiem field value (`AM`/`PM`, may be empty). |
|
|
28
|
+
| `min` | `string \| undefined` | | | Earliest / latest selectable time, `HH:mm` (seconds ignored — the bounds are minute-granular, like the pickers' clamp). An entry no in-range time can use is disabled: an hour with no grid minute in range, a minute out of range for the selected hour (for every hour while none is selected), an AM / PM half with no hour in range. |
|
|
29
|
+
| `minute` | `string` | | yes | Current minute field string (may be empty). |
|
|
30
|
+
| `passthrough` | `PtBindings<"header" \| "item" \| "cellColumnHeader", "disabled" \| "selected"> \| undefined` | | | The owning picker's passthrough resolver: `header` on the readout, `cellColumnHeader` on each column's letters, `item` per entry with `selected` / `disabled`. Internal. |
|
|
31
|
+
| `second` | `string` | | yes | Current second field string (may be empty). |
|
|
32
|
+
| `seconds` | `boolean \| undefined` | `false` | | Renders the seconds column. |
|
|
33
|
+
| `step` | `number \| undefined` | | | Minute-column granularity; off-grid values highlight nothing. |
|
|
34
|
+
|
|
35
|
+
## Events
|
|
36
|
+
|
|
37
|
+
- `select` — `(payload: { unit: TimeUnit; value: string; }): void` — A column entry was chosen. `hour` is always the 24-hour value (already combined with the meridiem in `ampm` mode); `meridiem` carries `AM`/`PM`. Numeric values arrive zero-padded.
|
|
38
|
+
|
|
39
|
+
## Slots
|
|
40
|
+
|
|
41
|
+
- None.
|
|
42
|
+
|
|
43
|
+
## CSS custom properties
|
|
44
|
+
|
|
45
|
+
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).
|
|
46
|
+
|
|
47
|
+
| Property | Default | What it is |
|
|
48
|
+
| --- | --- | --- |
|
|
49
|
+
| `--time-row-h` | `28px` | |
|
|
50
|
+
| `--time-col-w` | `44px` | |
|
|
51
|
+
| `--time-mark` | `24px` | Visible mark = the day-cell mark (--cell - 4). Hit area stays the full row; only the painted knob matches the calendar's. |
|
|
52
|
+
|
|
53
|
+
## Component tree
|
|
54
|
+
|
|
55
|
+
`CommonTimeSelector` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `CommonTimeSelector`, 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:
|
|
56
|
+
|
|
57
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `CommonTimeSelector`. A pt part listed as landing there is set on `CommonTimeSelector` (`pt:<part>`).
|
|
58
|
+
- **_public_** nodes are components with their own contract. `CommonTimeSelector` 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 `CommonTimeSelector`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
59
|
+
- **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 `CommonTimeSelector`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
60
|
+
- Listed nodes are the ones `CommonTimeSelector`'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`.
|
|
61
|
+
|
|
62
|
+
- `CommonTimeSelector` _(this component)_ — its own template binds: `header` → `div.bb-time-selector__header`, `cellColumnHeader` → `div.bb-time-selector__cell-column-header`, `item` → `BbBaseButton`
|
|
63
|
+
- `BbBaseButton` _(public — [contract](./BbBaseButton.md))_ — its own pt parts (`BbBaseButton`): `root` → `RouterComponent`, `root` → `a`, `root` → `component`; also mounts `RouterComponent`
|
package/dist/ai/ErrorIcon.md
CHANGED
|
@@ -19,3 +19,23 @@
|
|
|
19
19
|
## Slots
|
|
20
20
|
|
|
21
21
|
- None.
|
|
22
|
+
|
|
23
|
+
## CSS custom properties
|
|
24
|
+
|
|
25
|
+
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).
|
|
26
|
+
|
|
27
|
+
| Property | Default | What it is |
|
|
28
|
+
| --- | --- | --- |
|
|
29
|
+
| `--accent` | `var(--bb-danger)` | |
|
|
30
|
+
|
|
31
|
+
## Component tree
|
|
32
|
+
|
|
33
|
+
`ErrorIcon` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `ErrorIcon`, 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:
|
|
34
|
+
|
|
35
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `ErrorIcon`. A pt part listed as landing there is set on `ErrorIcon` (`pt:<part>`).
|
|
36
|
+
- **_public_** nodes are components with their own contract. `ErrorIcon` 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 `ErrorIcon`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
37
|
+
- **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 `ErrorIcon`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
38
|
+
- Listed nodes are the ones `ErrorIcon`'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`.
|
|
39
|
+
|
|
40
|
+
- `ErrorIcon` _(this component)_
|
|
41
|
+
- Also mounts `BbIcon`
|
package/dist/ai/FlatListBox.md
CHANGED
|
@@ -8,31 +8,61 @@
|
|
|
8
8
|
- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
|
|
9
9
|
- Implementation source (only when the contract below is not enough): [source/FlatListBox.md](./source/FlatListBox.md)
|
|
10
10
|
|
|
11
|
+
## Reachable through `FlatListBox`
|
|
12
|
+
|
|
13
|
+
`FlatListBox` 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:itemIcon` | the root of `BbIcon` | `BbIcon` ([contract](./BbIcon.md)) |
|
|
18
|
+
|
|
19
|
+
**CSS variables you can set through those parts** — declared deeper in the tree, so set one on the part that reads it (`pt:<part>="[--name:value]"`), never on `FlatListBox`'s root:
|
|
20
|
+
|
|
21
|
+
| Variable | Set through | Declared by | What it is |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| `--w` | `pt:itemIcon` | `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. |
|
|
24
|
+
|
|
11
25
|
## Props
|
|
12
26
|
|
|
13
27
|
| Prop | Type | Default | Required | Description |
|
|
14
28
|
| --- | --- | --- | --- | --- |
|
|
15
|
-
| `compact` | `boolean \| undefined` |
|
|
29
|
+
| `compact` | `boolean \| undefined` | `false` | | Sets the listbox in a compact state. |
|
|
30
|
+
| `described` | `boolean \| undefined` | `false` | | Every row carries a one-line description under its label (the owner's `itemProps` declares a `description`). Rows get a fixed two-line height and the description ellipsizes; an explicit `optionHeight` still wins. |
|
|
31
|
+
| `emptyText` | `string \| undefined` | | | Text shown when no options are available. |
|
|
16
32
|
| `id` | `string \| undefined` | | | Id applied to the `role="listbox"` element itself (not the wrapper), so a combobox's `aria-controls` reference resolves to the listbox role. |
|
|
17
|
-
| `
|
|
33
|
+
| `listLabel` | `string \| undefined` | | | |
|
|
34
|
+
| `listLabelledby` | `string \| undefined` | | | Accessible name of the `role="listbox"` element: the ids that name the combobox it pops up from (`listLabelledby`), else a plain label (`listLabel`). Internal. |
|
|
35
|
+
| `loading` | `boolean \| undefined` | `false` | | Shows the listbox in a loading state. |
|
|
18
36
|
| `loadingText` | `string \| undefined` | | | Text shown while options are loading. |
|
|
19
|
-
| `multiple` | `boolean \| undefined` |
|
|
20
|
-
| `
|
|
21
|
-
| `open` | `boolean \| undefined` | | | Whether the listbox is open (visible). |
|
|
37
|
+
| `multiple` | `boolean \| undefined` | `false` | | Allows multiple options to be selected simultaneously. |
|
|
38
|
+
| `open` | `boolean \| undefined` | `false` | | Whether the listbox is open (visible). |
|
|
22
39
|
| `optionHeight` | `number \| undefined` | | | Fixed height (in px) for each option row. Defaults to 28px (24px compact; 44px / 36px on mobile viewports). An explicit value wins on every viewport. |
|
|
23
40
|
| `options` | `Option<Item>[]` | | yes | List of options to display. |
|
|
24
|
-
| `
|
|
41
|
+
| `passthrough` | `PtBindings<"list" \| "itemDescription" \| "itemText" \| "itemIcon" \| "option", "disabled" \| "selected"> \| undefined` | | | Passthrough resolver handed down by the select popover: `list` is the `role="listbox"` node (bound whole); `option` is one option, resolved per node with its own `selected` / `disabled`. Internal. |
|
|
42
|
+
| `transitionDuration` | `number \| undefined` | `250` | | Duration of open/close transition in milliseconds. |
|
|
25
43
|
|
|
26
44
|
## Events
|
|
27
45
|
|
|
28
|
-
- `focused:change` — `(
|
|
29
|
-
- `option:selected` — `(
|
|
30
|
-
- `option:unselected` — `(
|
|
46
|
+
- `focused:change` — `(id: string \| undefined): void` — Emitted when the keyboard-focused option changes.
|
|
47
|
+
- `option:selected` — `(option: Option): void` — Emitted when an option is selected by the user.
|
|
48
|
+
- `option:unselected` — `(option: Option): void` — Emitted when a previously selected option is deselected.
|
|
31
49
|
|
|
32
50
|
## Slots
|
|
33
51
|
|
|
52
|
+
- `empty` — scope: `object` — Content shown when no options are available (replaces the default "no data" text).
|
|
34
53
|
- `loading` — scope: `object` — Content shown while items are loading (replaces the default loading text).
|
|
35
|
-
- `
|
|
36
|
-
- `option` — scope: `FlatListBoxOptionSlotProps<Item>` — Replaces the default rendering of each option row.
|
|
54
|
+
- `option` — scope: `FlatListBoxOptionSlotProps<Item>` `{ disabled: boolean; focused: boolean; index: number; item: Item; selected: boolean; text: string; value: any; description: string }` — Replaces the default rendering of each option row.
|
|
37
55
|
- `options:append` — scope: `object` — Content appended inside the options list, after the last option.
|
|
38
56
|
- `options:prepend` — scope: `object` — Content prepended inside the options list, before the first option.
|
|
57
|
+
|
|
58
|
+
## Component tree
|
|
59
|
+
|
|
60
|
+
`FlatListBox` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `FlatListBox`, 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:
|
|
61
|
+
|
|
62
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `FlatListBox`. A pt part listed as landing there is set on `FlatListBox` (`pt:<part>`).
|
|
63
|
+
- **_public_** nodes are components with their own contract. `FlatListBox` 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 `FlatListBox`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
64
|
+
- **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 `FlatListBox`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
65
|
+
- Listed nodes are the ones `FlatListBox`'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`.
|
|
66
|
+
|
|
67
|
+
- `FlatListBox` _(this component)_ — its own template binds: `list` → `span.bb-listbox__list`, `option` → `span.bb-listbox__option`, `itemIcon` → `BbIcon`, `itemText` → `span.bb-listbox__item-text`, `itemDescription` → `span.bb-listbox__item-description`
|
|
68
|
+
- Also mounts `BbIcon`
|
|
@@ -8,33 +8,63 @@
|
|
|
8
8
|
- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
|
|
9
9
|
- Implementation source (only when the contract below is not enough): [source/GroupedListBox.md](./source/GroupedListBox.md)
|
|
10
10
|
|
|
11
|
+
## Reachable through `GroupedListBox`
|
|
12
|
+
|
|
13
|
+
`GroupedListBox` 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:itemIcon` | the root of `BbIcon` | `BbIcon` ([contract](./BbIcon.md)) |
|
|
18
|
+
|
|
19
|
+
**CSS variables you can set through those parts** — declared deeper in the tree, so set one on the part that reads it (`pt:<part>="[--name:value]"`), never on `GroupedListBox`'s root:
|
|
20
|
+
|
|
21
|
+
| Variable | Set through | Declared by | What it is |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| `--w` | `pt:itemIcon` | `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. |
|
|
24
|
+
|
|
11
25
|
## Props
|
|
12
26
|
|
|
13
27
|
| Prop | Type | Default | Required | Description |
|
|
14
28
|
| --- | --- | --- | --- | --- |
|
|
15
|
-
| `compact` | `boolean \| undefined` |
|
|
29
|
+
| `compact` | `boolean \| undefined` | `false` | | Sets the listbox in a compact state. |
|
|
30
|
+
| `described` | `boolean \| undefined` | `false` | | Every row carries a one-line description under its label (the owner's `itemProps` declares a `description`). Rows get a fixed two-line height and the description ellipsizes; an explicit `optionHeight` still wins. |
|
|
31
|
+
| `emptyText` | `string \| undefined` | | | Text shown when no options are available. |
|
|
16
32
|
| `groups` | `GroupedOptions[]` | | yes | List of option groups to display. |
|
|
17
33
|
| `headerHeight` | `number \| undefined` | | | Height of group headers (px). Defaults to 32px (24px compact; 36px / 32px on mobile viewports). An explicit value wins on every viewport. |
|
|
18
34
|
| `id` | `string \| undefined` | | | Id applied to the `role="listbox"` element itself (not the wrapper), so a combobox's `aria-controls` reference resolves to the listbox role. |
|
|
19
|
-
| `
|
|
35
|
+
| `listLabel` | `string \| undefined` | | | |
|
|
36
|
+
| `listLabelledby` | `string \| undefined` | | | Accessible name of the `role="listbox"` element: the ids that name the combobox it pops up from (`listLabelledby`), else a plain label (`listLabel`). Internal. |
|
|
37
|
+
| `loading` | `boolean \| undefined` | `false` | | Shows the listbox in a loading state. |
|
|
20
38
|
| `loadingText` | `string \| undefined` | | | Text shown while options are loading. |
|
|
21
|
-
| `multiple` | `boolean \| undefined` |
|
|
22
|
-
| `
|
|
23
|
-
| `open` | `boolean \| undefined` | | | Whether the listbox is open (visible). |
|
|
39
|
+
| `multiple` | `boolean \| undefined` | `false` | | Allows multiple options to be selected simultaneously. |
|
|
40
|
+
| `open` | `boolean \| undefined` | `false` | | Whether the listbox is open (visible). |
|
|
24
41
|
| `optionHeight` | `number \| undefined` | | | Fixed height (in px) for each option row. Defaults to 28px (24px compact; 44px / 36px on mobile viewports). An explicit value wins on every viewport. |
|
|
25
|
-
| `
|
|
42
|
+
| `passthrough` | `PtBindings<"list" \| "itemDescription" \| "itemText" \| "itemIcon" \| "option", "disabled" \| "selected"> \| undefined` | | | Passthrough resolver handed down by the select popover: `list` is the `role="listbox"` node (bound whole); `option` is one option, resolved per node with its own `selected` / `disabled`. Internal. |
|
|
43
|
+
| `transitionDuration` | `number \| undefined` | `250` | | Duration of open/close transition in milliseconds. |
|
|
26
44
|
|
|
27
45
|
## Events
|
|
28
46
|
|
|
29
|
-
- `focused:change` — `(
|
|
30
|
-
- `option:selected` — `(
|
|
31
|
-
- `option:unselected` — `(
|
|
47
|
+
- `focused:change` — `(id: string \| undefined): void` — Emitted when the keyboard-focused option changes.
|
|
48
|
+
- `option:selected` — `(option: Option): void` — Emitted when an option is selected by the user.
|
|
49
|
+
- `option:unselected` — `(option: Option): void` — Emitted when a previously selected option is deselected.
|
|
32
50
|
|
|
33
51
|
## Slots
|
|
34
52
|
|
|
35
|
-
- `
|
|
53
|
+
- `empty` — scope: `object` — Content shown when no options are available (replaces the default "no data" text).
|
|
54
|
+
- `group` — scope: `GroupedListBoxGroupSlotProps<Item>` `{ text: string; item: Item; index: number; length: number; disabled: boolean }` — Replaces the default group header rendered above each group of options.
|
|
36
55
|
- `loading` — scope: `object` — Content shown while items are loading (replaces the default loading text).
|
|
37
|
-
- `
|
|
38
|
-
- `option` — scope: `GroupedListBoxOptionSlotProps<Item>` — Replaces the default rendering of each option row within a group.
|
|
56
|
+
- `option` — scope: `GroupedListBoxOptionSlotProps<Item>` `{ disabled: boolean; focused: boolean; index: number; item: Item; selected: boolean; text: string; value: any; description: string }` — Replaces the default rendering of each option row within a group.
|
|
39
57
|
- `options:append` — scope: `object` — Content appended inside the options list, after the last group.
|
|
40
58
|
- `options:prepend` — scope: `object` — Content prepended inside the options list, before the first group.
|
|
59
|
+
|
|
60
|
+
## Component tree
|
|
61
|
+
|
|
62
|
+
`GroupedListBox` is not one component: rendering it mounts every component below, and each one is live inside it. **Read this before styling, theming or debugging `GroupedListBox`, 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:
|
|
63
|
+
|
|
64
|
+
- **_internal_** nodes are building blocks with no API of their own: you reach them only through `GroupedListBox`. A pt part listed as landing there is set on `GroupedListBox` (`pt:<part>`).
|
|
65
|
+
- **_public_** nodes are components with their own contract. `GroupedListBox` 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 `GroupedListBox`'s words → the child's). The child's other props and parts are not exposed; its contract explains what it renders.
|
|
66
|
+
- **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 `GroupedListBox`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
|
|
67
|
+
- Listed nodes are the ones `GroupedListBox`'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`.
|
|
68
|
+
|
|
69
|
+
- `GroupedListBox` _(this component)_ — its own template binds: `list` → `span.bb-listbox__list`, `option` → `span.bb-listbox__option`, `itemIcon` → `BbIcon`, `itemText` → `span.bb-listbox__item-text`, `itemDescription` → `span.bb-listbox__item-description`
|
|
70
|
+
- Also mounts `BbIcon`
|