bitboss-ui 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/ai/BbBaseCheckboxIcon.md

@@ -110,8 +110,8 @@ const selected = ref<string[]>(['email']);
 
 ### Styling
 
-The glyph owns its own tokens, so restyle it by overriding CSS custom properties
-on the element (or an ancestor — they inherit):
+The glyph owns its own tokens, so restyle it by overriding CSS custom
+properties on it:
 
 - `--size` — box edge length (default `16px`)
 - `--r` — corner radius (default `4px`)
@@ -119,6 +119,23 @@ on the element (or an ancestor — they inherit):
 - `--check-color` — checkmark stroke (default `--bb-primary-fg`)
 - `--ring-color` — focus ring color
 
+**On the element itself, not an ancestor.** Each of these is declared on the
+glyph's own class, and a declaration on the element always beats one inherited
+from an ancestor — so `--size` set on a wrapper `div` is simply ignored
+(verified: the glyph stays 16px). Target the glyph class, or pass a `style` /
+`class` that lands on it:
+
+```css
+/* works */
+.bb-base-checkbox-icon {
+	--size: 20px;
+}
+/* does nothing */
+.my-form {
+	--size: 20px;
+}
+```
+
 **Bigger, rounder, recolored**
 
 ```vue
@@ -152,13 +169,13 @@ on the element (or an ancestor — they inherit):
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `checked` | `boolean \| undefined` |  |  | Renders the checked state (fills the box and draws the checkmark). |
-| `disabled` | `boolean \| undefined` |  |  | Disables the glyph (muted fill, not-allowed cursor). Purely visual. |
-| `focusVisible` | `boolean \| undefined` |  |  | Whether keyboard focus is visible (`:focus-visible`). Draws the focus ring. |
-| `hasErrors` | `boolean \| undefined` |  |  | Puts the glyph into the error state (danger border and ring color). |
-| `hasWarning` | `boolean \| undefined` |  |  | Puts the glyph into the warning state (warn border and ring color). Errors take priority when both are set. |
-| `indeterminate` | `boolean \| undefined` |  |  | Renders the indeterminate state (filled box with a dash instead of the checkmark). Takes visual precedence over `checked`. |
-| `readonly` | `boolean \| undefined` |  |  | Renders the read-only affordance (default cursor instead of pointer). |
+| `checked` | `boolean \| undefined` | `false` |  | Renders the checked state (fills the box and draws the checkmark). |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the glyph (muted fill, not-allowed cursor). Purely visual. |
+| `focusVisible` | `boolean \| undefined` | `false` |  | Whether keyboard focus is visible (`:focus-visible`). Draws the focus ring. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Puts the glyph into the error state (danger border and ring color). |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Puts the glyph into the warning state (warn border and ring color). Errors take priority when both are set. |
+| `indeterminate` | `boolean \| undefined` | `false` |  | Renders the indeterminate state (filled box with a dash instead of the checkmark). Takes visual precedence over `checked`. |
+| `readonly` | `boolean \| undefined` | `false` |  | Renders the read-only affordance (default cursor instead of pointer). |
 
 ## Events
 

package/dist/ai/BbBaseColorInput.md

@@ -16,28 +16,28 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `adaptive` | `boolean \| undefined` | `undefined` |  | When `true`, the palette opens as a bottom off-canvas sheet on mobile viewports instead of a floating popover. Forwarded to `BbColorPalette`, which resolves the fallback. When unset, falls back to the global `config.adaptive`. |
+| `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | When `true`, the palette opens as a bottom off-canvas sheet on mobile viewports instead of a floating popover. Forwarded to `BbColorPalette`, which resolves the fallback. When unset, falls back to the global `config.adaptive`. |
 | `alpha` | `boolean \| undefined` | `false` |  | Enable the alpha channel. When true the picker shows an opacity slider and emits / accepts `#RRGGBBAA` hex8 values. |
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to render at the right hand side of the input. |
 | `ariaDescribedby` | `string \| undefined` |  |  | Id(s) of element(s) describing this input for assistive tech (space-separated). Typically includes the container hint id if used within a BaseInputContainer. |
 | `autocomplete` | `string \| undefined` | `"off"` |  | Autocomplete hint for the browser. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Focus the input on mount. |
-| `clearable` | `boolean \| undefined` |  |  | Show a clear button when the input has a value. |
-| `compact` | `boolean \| undefined` |  |  | Display the component in a compact layout. |
-| `disabled` | `boolean \| undefined` |  |  | Disable all interactions. |
-| `eyeDropper` | `boolean \| undefined` |  |  | Show an eyedropper button to sample any color on screen. Uses the native EyeDropper API — hidden automatically on unsupported browsers. |
-| `hasErrors` | `boolean \| undefined` |  |  | Visually mark the component as invalid (also sets aria-invalid on the input). |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
+| `clearable` | `boolean \| undefined` | `false` |  | Show a clear button when the input has a value. |
+| `compact` | `boolean \| undefined` | `false` |  | Display the component in a compact layout. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disable all interactions. |
+| `eyeDropper` | `boolean \| undefined` | `false` |  | Show an eyedropper button to sample any color on screen. Uses the native EyeDropper API — hidden automatically on unsupported browsers. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Visually mark the component as invalid (also sets aria-invalid on the input). |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
 | `id` | `string \| undefined` |  |  | The id attribute for the input element. Defaults to a generated `bb_<unique>` id when omitted. |
-| `loading` | `boolean \| undefined` |  |  | Display the loading state. |
+| `loading` | `boolean \| undefined` | `false` |  | Display the loading state. |
 | `modelValue` | `string \| null` |  | yes | v-model value: `#RRGGBB` hex string or `null` when empty. Example: `#1A2B3C` |
 | `name` | `string \| undefined` |  |  | Name attribute of the input. |
 | `placeholder` | `string \| undefined` |  |  | Placeholder text when there is no value. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to render at the start of the input. |
-| `readonly` | `boolean \| undefined` |  |  | Make the input read-only. |
-| `required` | `boolean \| undefined` |  |  | Mark the input as required. |
+| `readonly` | `boolean \| undefined` | `false` |  | Make the input read-only. |
+| `required` | `boolean \| undefined` | `false` |  | Mark the input as required. |
 | `swatches` | `boolean \| string[][] \| undefined` |  |  | Controls swatches display in the picker: - `true` — show the built-in Material-palette swatches - `string[][]` — show custom swatches (each inner array = a column of shades) - `false` / omitted — no swatches section |
-| `transitionDuration` | `number \| undefined` |  |  | Transition duration (ms) of the palette popover. Forwarded to `BbColorPalette`, which supplies the default. |
+| `transitionDuration` | `number \| undefined` | `250` |  | Transition duration (ms) of the palette popover. Forwarded to `BbColorPalette`, which supplies the default. |
 
 ## Events
 

package/dist/ai/BbBaseDatePicker.md

@@ -16,19 +16,19 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component. |
 | `firstDayOfWeek` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| undefined` | `1` |  | Defines the first day of the week with `0` meaning Sunday and `6` meaning Saturday. |
-| `floating` | `boolean \| undefined` |  |  | If true the value is a plain calendar string (`YYYY-MM-DD`, or the shape `type` dictates) instead of the default ISO instant. |
+| `floating` | `boolean \| undefined` | `false` |  | If true the value is a plain calendar string (`YYYY-MM-DD`, or the shape `type` dictates) instead of the default ISO instant. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `max` | `string \| undefined` |  |  | Maximum selectable date. |
 | `min` | `string \| undefined` |  |  | Minimum selectable date. |
 | `modelValue` | `string \| string[] \| null` |  | yes | Used by v-model. Can be null, a single string, or an array of strings based on whether a range or single date is needed. |
-| `multiple` | `boolean \| undefined` |  |  | Allows the selection of multiple items. |
-| `range` | `boolean \| undefined` |  |  | Selects a range of dates between two dates. It selects all of the days between start and end. |
-| `readonly` | `boolean \| undefined` |  |  | Sets the input in a readonly state. |
+| `multiple` | `boolean \| undefined` | `false` |  | Allows the selection of multiple items. |
+| `range` | `boolean \| undefined` | `false` |  | Selects a range of dates between two dates. It selects all of the days between start and end. |
+| `readonly` | `boolean \| undefined` | `false` |  | Sets the input in a readonly state. |
 | `selectable` | `((date: string) => boolean) \| undefined` |  |  | Function that accepts a date string and returns a boolean. Returning `false` means the date cannot be selected. The string is shaped by `type`: `YYYY-MM` under `month`, `YYYY` under `year`. |
 | `type` | `DatePickerType \| undefined` | `"date"` |  | What the grid selects: a day (`date`/`datetime`), a month, or a year. The coarse types make the month/year panel terminal instead of a navigation step, and emit `YYYY-MM` / `YYYY`. |
-| `utc` | `boolean \| undefined` |  |  | Emits values as UTC ISO strings (`...Z`) instead of ISO strings carrying the local offset (`...+01:00`). Emission-only: incoming values are parsed identically either way, so the prop can be added or removed without touching stored values. I… |
+| `utc` | `boolean \| undefined` | `false` |  | Emits values as UTC ISO strings (`...Z`) instead of ISO strings carrying the local offset (`...+01:00`). Emission-only: incoming values are parsed identically either way, so the prop can be added or removed without touching stored values. I… |
 
 ## Events
 

package/dist/ai/BbBaseDatePickerInput.md

@@ -17,23 +17,23 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `adaptive` | `boolean \| undefined` | `undefined` |  | On mobile the calendar opens inside a bottom off-canvas sheet instead of a floating popover, mirroring the adaptive behaviour of `BbPopover`/`BbSelectPopover`. When unset, falls back to the global `config.adaptive`. |
-| `ampm` | `boolean \| undefined` |  |  | 12-hour display with an AM/PM segment (requires `type="datetime"`). Purely a field-composition concern: `modelValue` and the `time` model stay 24-hour regardless. Type `A`/`P` (or ArrowUp/Down) to set the meridiem. |
+| `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | On mobile the calendar opens inside a bottom off-canvas sheet instead of a floating popover, mirroring the adaptive behaviour of `BbPopover`/`BbSelectPopover`. When unset, falls back to the global `config.adaptive`. |
+| `ampm` | `boolean \| undefined` | `false` |  | 12-hour display with an AM/PM segment (requires `type="datetime"`). Purely a field-composition concern: `modelValue` and the `time` model stay 24-hour regardless. Type `A`/`P` (or ArrowUp/Down) to set the meridiem. |
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to render at the right hand side of the input. |
 | `ariaDescribedby` | `string \| undefined` |  |  | Additional description id(s) announced by assistive technologies. Usually provided by an outer input container to link hint/error text. |
 | `autocomplete` | `string \| undefined` | `"off"` |  | Browser autocomplete hint for the input. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Focus the first text field automatically when the component mounts. |
-| `clearable` | `boolean \| undefined` |  |  | Displays a clear button whenever a value is present and the control is interactive. |
-| `compact` | `boolean \| undefined` |  |  | Applies the compact density styles to the control. |
+| `clearable` | `boolean \| undefined` | `false` |  | Displays a clear button whenever a value is present and the control is interactive. |
+| `compact` | `boolean \| undefined` | `false` |  | Applies the compact density styles to the control. |
 | `disableCalendar` | `boolean \| "mobile" \| "desktop" \| undefined` | `false` |  | Disables the calendar: hides the trigger button and prevents the popover from opening. Use `'desktop'` to disable it on desktop only (keyboard-first there, calendar-first on mobile — complementing `disableWriting: 'mobile'`) or `'mobile'` t… |
-| `disabled` | `boolean \| undefined` |  |  | Disables the input, calendar trigger, and popover. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the input, calendar trigger, and popover. |
 | `disableWriting` | `boolean \| "mobile" \| "desktop" \| undefined` | `false` |  | Controls whether manual typing is disabled inside the text fields. Use `'mobile'` to disable typing only on mobile, `'desktop'` to disable typing only on desktop. Applies to both single and range modes. |
 | `firstDayOfWeek` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| undefined` |  |  | Sets the first day of the week for the calendar (0 = Sunday, 6 = Saturday). |
-| `floating` | `boolean \| undefined` |  |  | Emit dates formatted as `YYYY-MM-DD` instead of ISO strings. |
-| `hasErrors` | `boolean \| undefined` |  |  | Marks the control as invalid, applying error styles and setting `aria-invalid`. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
+| `floating` | `boolean \| undefined` | `false` |  | Emit dates formatted as `YYYY-MM-DD` instead of ISO strings. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Marks the control as invalid, applying error styles and setting `aria-invalid`. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
 | `id` | `string \| undefined` |  |  | Explicit id for the input element. Falls back to an auto-generated `bdpi-<uid>` value. |
-| `loading` | `boolean \| undefined` |  |  | Shows loading visuals on the input. |
+| `loading` | `boolean \| undefined` | `false` |  | Shows loading visuals on the input. |
 | `max` | `string \| undefined` |  |  | Maximum selectable date in `YYYY-MM-DD` format — or, with `type="datetime"`, `YYYY-MM-DDTHH:mm` to tighten the boundary day to a minute. Values outside both patterns throw during setup to surface configuration mistakes. |
 | `min` | `string \| undefined` |  |  | Minimum selectable date in `YYYY-MM-DD` format — or, with `type="datetime"`, `YYYY-MM-DDTHH:mm` to tighten the boundary day to a minute. Values outside both patterns throw during setup to surface configuration mistakes. |
 | `modelValue` | `string \| string[] \| null` |  | yes | v-model value. Use `null` for empty, a single string for single selection, or a two-element string array (`[start, end]`) when `range` is true. |
@@ -41,16 +41,16 @@
 | `offCanvasProps` | `Partial<BbOffCanvasProps> \| undefined` |  |  | Extra props forwarded to the `BbOffCanvas` sheet when `adaptive` is active on mobile (e.g. `title`, `size`, `persistent`). |
 | `placeholder` | `string \| undefined` |  |  | Placeholder text displayed when no value is present. Defaults to the localized format hint (`baseDatePickerInput.dateFormatSingle` / `dateFormatRange` — e.g. `MM/DD/YYYY` for `en`, `GG/MM/AAAA` for `it`). |
 | `prepend:icon` | `string \| undefined` |  |  | Icon name rendered before the input field. |
-| `range` | `boolean \| undefined` |  |  | Enables range selection. When active, v-model expects a two-element array `[start, end]`. Users can still type into the start and end segments unless `disableWriting` disables typing. |
-| `readonly` | `boolean \| undefined` |  |  | Makes the text fields read-only and prevents opening the calendar. |
-| `required` | `boolean \| undefined` |  |  | Marks the inputs as required to the browser. |
-| `seconds` | `boolean \| undefined` |  |  | Adds the seconds segment (requires `type="datetime"`). Without it, an incoming value carrying seconds displays truncated and is left untouched until the user commits an edit, at which point seconds zero out. |
+| `range` | `boolean \| undefined` | `false` |  | Enables range selection. When active, v-model expects a two-element array `[start, end]`. Users can still type into the start and end segments unless `disableWriting` disables typing. |
+| `readonly` | `boolean \| undefined` | `false` |  | Makes the text fields read-only and prevents opening the calendar. |
+| `required` | `boolean \| undefined` | `false` |  | Marks the inputs as required to the browser. |
+| `seconds` | `boolean \| undefined` | `false` |  | Adds the seconds segment (requires `type="datetime"`). Without it, an incoming value carrying seconds displays truncated and is left untouched until the user commits an edit, at which point seconds zero out. |
 | `selectable` | `((date: string) => boolean) \| undefined` |  |  | Predicate invoked for each candidate date. Return `false` to disable selection for that value. |
-| `step` | `number \| undefined` |  |  | Minute granularity for the calendar's minute column and arrow stepping (requires `type="datetime"`). Constrains what the component produces, never what it accepts: a typed off-grid value (e.g. `10:07` with `step: 15`) is emitted verbatim, a… |
+| `step` | `number \| undefined` | `1` |  | Minute granularity for the calendar's minute column and arrow stepping (requires `type="datetime"`). Constrains what the component produces, never what it accepts: a typed off-grid value (e.g. `10:07` with `step: 15`) is emitted verbatim, a… |
 | `time` | `string \| string[] \| null \| undefined` |  |  | Companion model for the time part (`v-model:time`), always 24-hour `HH:mm` / `HH:mm:ss` regardless of display. With `floating` it is the only carrier of the time; otherwise it mirrors the time inside `modelValue` (same digits) and writing i… |
 | `transitionDuration` | `number \| undefined` |  |  | Transition duration, in milliseconds, for the popover appearance. |
 | `type` | `DatePickerType \| undefined` | `"date"` |  | What the field edits, and therefore its segments and emitted shape. - `date` (default) — `DD/MM/YYYY`. - `datetime` — adds the time segments and the calendar's time rail. - `month` — `MM/YYYY`, emitting `YYYY-MM`. - `year` — `YYYY`, emittin… |
-| `utc` | `boolean \| undefined` |  |  | Emits values as UTC ISO strings (`...Z`) instead of ISO strings carrying the local offset (`...+01:00`). Emission-only: incoming values are parsed identically either way, so the prop can be added or removed without touching stored values. F… |
+| `utc` | `boolean \| undefined` | `false` |  | Emits values as UTC ISO strings (`...Z`) instead of ISO strings carrying the local offset (`...+01:00`). Emission-only: incoming values are parsed identically either way, so the prop can be added or removed without touching stored values. F… |
 
 ## Events
 

package/dist/ai/BbBaseInputContainer.md

@@ -12,29 +12,29 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `clearable` | `boolean \| undefined` |  |  | Whether the inner control exposes a clear action. |
-| `compact` | `boolean \| undefined` |  |  | Apply the compact density variant to the container. |
+| `clearable` | `boolean \| undefined` | `false` |  | Whether the inner control exposes a clear action. |
+| `compact` | `boolean \| undefined` | `false` |  | Apply the compact density variant to the container. |
 | `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 `floati… |
 | `direction` | `InputDirection \| undefined` | `"vertical"` |  | Controls label/input layout. Accepts `'vertical'`, `'horizontal'`, `'auto'`, 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'`. |
-| `disabled` | `boolean \| undefined` |  |  | Whether the inner control is disabled. |
+| `disabled` | `boolean \| undefined` | `false` |  | Whether the inner control is disabled. |
 | `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 expos… |
-| `hasErrors` | `boolean \| undefined` |  |  | Forces the error state independently of `errors`, useful to pre-style the container. |
-| `hasValue` | `boolean \| undefined` |  |  | Whether the inner control currently contains a value. |
-| `hasWarning` | `boolean \| undefined` |  |  | Forces the warning state independently of `warnings`. Same chrome as errors but with `--bb-warn`; errors take priority when both are set. |
-| `hideLabel` | `boolean \| undefined` |  |  | Hide the visual label while keeping it available to assistive technology. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Forces the error state independently of `errors`, useful to pre-style the container. |
+| `hasValue` | `boolean \| undefined` | `false` |  | Whether the inner control currently contains a value. |
+| `hasWarning` | `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. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Hide the visual label while keeping it available to assistive technology. |
 | `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. |
 | `id` | `string \| undefined` |  |  | Explicit id for the container and associated input. Falls back to an auto-generated id when omitted. |
-| `inputPosition` | `"left" \| "center" \| "right" \| undefined` |  |  | Horizontal alignment of the input column when direction is horizontal or custom. Unset, it follows the layout: `'right'` in a horizontal/ratio split (beside the left-hand label), `'left'` otherwise — and `direction` is `'vertical'` by defau… |
+| `inputPosition` | `"left" \| "center" \| "right" \| undefined` | `'left'` |  | Horizontal alignment of the input column when direction is horizontal or custom. Unset, it follows the layout: `'right'` in a horizontal/ratio split (beside the left-hand label), `'left'` otherwise — and `direction` is `'vertical'` by defau… |
 | `label` | `string` |  | yes | Visible label text for the field. Also used to derive a fallback name. |
 | `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` |  |  | Label rendering mode. |
 | `labelPosition` | `"left" \| "center" \| "right" \| undefined` | `"left"` |  | Horizontal alignment for the label column. |
 | `labelTag` | `LabelTag \| undefined` | `"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. |
-| `loading` | `boolean \| undefined` |  |  | Whether the inner control is in a loading state. |
-| `mobile` | `boolean \| undefined` |  |  | Whether the inner control is in mobile viewport mode. |
+| `loading` | `boolean \| undefined` | `false` |  | Whether the inner control is in a loading state. |
+| `mobile` | `boolean \| undefined` | `false` |  | Whether the inner control is in mobile viewport mode. |
 | `name` | `string \| undefined` |  |  | Explicit name attribute forwarded to the input. When omitted, a slug derived from `label` is used. |
-| `readonly` | `boolean \| undefined` |  |  | Whether the inner control is readonly. |
+| `readonly` | `boolean \| undefined` | `false` |  | Whether the inner control is readonly. |
 | `reverse` | `boolean \| undefined` | `false` |  | Swap the label and input columns. |
-| `showHint` | `boolean \| undefined` |  |  | Keep the hint permanently visible, regardless of focus. |
+| `showHint` | `boolean \| undefined` | `false` |  | Keep the hint permanently visible, regardless of focus. |
 | `tag` | `ContainerTag \| undefined` | `"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. |
 | `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-wa… |
 

package/dist/ai/BbBaseNumberInput.md

@@ -20,13 +20,13 @@
 | `ariaDescribedby` | `string \| undefined` |  |  | Id(s) of descriptive elements announced by screen readers. |
 | `autocomplete` | `string \| undefined` | `"off"` |  | Browser autocomplete hint for the field. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Focus the input automatically after mount. |
-| `clearable` | `boolean \| undefined` |  |  | Show a clear button whenever a value is present and the control is interactive. |
-| `compact` | `boolean \| undefined` |  |  | Apply the compact density variant. |
-| `disabled` | `boolean \| undefined` |  |  | Disable manual input and the exposed increase/decrease helpers. |
-| `hasErrors` | `boolean \| undefined` |  |  | Force the error state; also toggles `aria-invalid`. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
+| `clearable` | `boolean \| undefined` | `false` |  | Show a clear button whenever a value is present and the control is interactive. |
+| `compact` | `boolean \| undefined` | `false` |  | Apply the compact density variant. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disable manual input and the exposed increase/decrease helpers. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Force the error state; also toggles `aria-invalid`. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
 | `id` | `string \| undefined` |  |  | Explicit id forwarded to the native input. |
-| `loading` | `boolean \| undefined` |  |  | Display the loading state styles. |
+| `loading` | `boolean \| undefined` | `false` |  | Display the loading state styles. |
 | `max` | `number \| undefined` | `Number.MAX_SAFE_INTEGER` |  | Upper bound for clamping user input and helper increments. |
 | `maxPrecision` | `number \| undefined` | `8` |  | Maximum number of decimal digits retained after processing. |
 | `min` | `number \| undefined` | `Number.MIN_SAFE_INTEGER` |  | Lower bound for clamping user input and helper decrements. |
@@ -34,8 +34,8 @@
 | `name` | `string \| undefined` |  |  | Name attribute forwarded to the native input. |
 | `placeholder` | `string \| undefined` |  |  | Placeholder text when no value is present. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to render at the left hand side of the input. |
-| `readonly` | `boolean \| undefined` |  |  | Make the input read-only while keeping its value visible. |
-| `required` | `boolean \| undefined` |  |  | Mark the input as required for form validation. |
+| `readonly` | `boolean \| undefined` | `false` |  | Make the input read-only while keeping its value visible. |
+| `required` | `boolean \| undefined` | `false` |  | Mark the input as required for form validation. |
 | `step` | `number \| undefined` | `1` |  | Increment used by the `increase`/`decrease` helpers. Manual typing is never forced to this step. |
 
 ## Events

package/dist/ai/BbBaseRadio.md

@@ -19,14 +19,14 @@
 | `ariaDescribedby` | `string \| undefined` |  |  | Id(s) of descriptive elements associated with the radio. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Focus the control automatically after mount. |
 | `checked` | `boolean \| undefined` | `undefined` |  | Force the radio into a checked state regardless of `modelValue`. |
-| `disabled` | `boolean \| undefined` |  |  | Disable the radio. When combined with `readonly`, the control is also disabled to mimic native behaviour. |
-| `hasErrors` | `boolean \| undefined` |  |  | Apply the error styling class. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply the warning styling class. Errors take priority when both are set. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disable the radio. When combined with `readonly`, the control is also disabled to mimic native behaviour. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Apply the error styling class. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply the warning styling class. Errors take priority when both are set. |
 | `id` | `string \| undefined` |  |  | Explicit id for the underlying input element. |
 | `modelValue` | `any` |  |  | Current v-model value used to determine checked state. |
 | `name` | `string \| undefined` |  | yes | Shared group name for the radio input (required to join options). |
-| `readonly` | `boolean \| undefined` |  |  | Treat the radio as read-only. Implemented by disabling the input while preserving styling hooks. |
-| `required` | `boolean \| undefined` |  |  | Mark the radio as required within its group. |
+| `readonly` | `boolean \| undefined` | `false` |  | Treat the radio as read-only. Implemented by disabling the input while preserving styling hooks. |
+| `required` | `boolean \| undefined` | `false` |  | Mark the radio as required within its group. |
 | `value` | `any` |  | yes | Value emitted when the radio becomes checked. Accepts any serializable value. |
 
 ## Events

package/dist/ai/BbBaseRadioGroup.md

@@ -22,11 +22,11 @@
 | `dependencies` | `unknown[] \| undefined` |  |  | Additional dependencies that trigger item reloading when changed. |
 | `depsDebounceTime` | `number \| undefined` | `0` |  | Debounce delay (ms) for dependency-triggered reloads. |
 | `direction` | `"horizontal" \| "vertical" \| undefined` | `"horizontal"` |  | Direction of the layout of the inputs inside the fieldset. |
-| `disabled` | `boolean \| undefined` |  |  | Disable all radios in the group. |
-| `enforceCoherence` | `boolean \| undefined` |  |  | Reset modelValue to `null` if it no longer matches available items (enforces coherence). |
-| `hasErrors` | `boolean \| undefined` |  |  | Apply error styling to the group. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling to the group. Errors take priority when both are set. |
-| `hideLabel` | `boolean \| undefined` |  |  | Hide the visual label while keeping it accessible. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disable all radios in the group. |
+| `enforceCoherence` | `boolean \| undefined` | `false` |  | Reset modelValue to `null` if it no longer matches available items (enforces coherence). |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Apply error styling to the group. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply warning styling to the group. Errors take priority when both are set. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Hide the visual label while keeping it accessible. |
 | `id` | `string \| undefined` |  |  | Explicit id for the fieldset. Used to generate ids for individual radios. |
 | `items` | `T[] \| ((prefill: boolean, modelValue?: any) => T[] \| Promise<T[]>)` | `[]` | yes | Array of items or function to load them asynchronously. |
 | `itemText` | `(T extends object ? NestedKeyOf<T> \| ((item: T) => string) : ((item: T) => string) \| undefined) \| undefined` |  |  | Path to item property for display text or function to extract it. |
@@ -36,8 +36,8 @@
 | `modelValueDebounceTime` | `number \| undefined` | `0` |  | Debounce delay (ms) for modelValue change handling. |
 | `name` | `string \| undefined` |  | yes | Shared name for all radios in the group (required for grouping). |
 | `noDataText` | `string \| undefined` |  |  | Message displayed when no items are available. |
-| `readonly` | `boolean \| undefined` |  |  | Make all radios read-only. |
-| `required` | `boolean \| undefined` |  |  | Mark at least one radio as required. |
+| `readonly` | `boolean \| undefined` | `false` |  | Make all radios read-only. |
+| `required` | `boolean \| undefined` | `false` |  | Mark at least one radio as required. |
 | `selectable` | `boolean \| ((item: T) => boolean) \| undefined` | `true` |  | Defines whether options are selectable. Can be a global boolean that affects all options or a function that accepts an item and returns a boolean that only affects that item. Non-selectable options are rendered disabled. |
 
 ## Events

package/dist/ai/BbBaseRadioIcon.md

@@ -130,14 +130,30 @@ const selected = ref('team');
 
 ### Styling
 
-Restyle by overriding the glyph's CSS custom properties on the element (or an
-ancestor — they inherit):
+Restyle by overriding the glyph's CSS custom properties on it:
 
 - `--size` — ring diameter (default `16px`)
-- `--space` — gap between ring and dot when checked (default `6px`)
+- `--space` — gap between ring and dot when checked (default `2px`)
 - `--color` — dot color (default `--bb-primary`)
 - `--ring-color` — focus ring color
 
+**On the element itself, not an ancestor.** Each of these is declared on the
+glyph's own class, and a declaration on the element always beats one inherited
+from an ancestor — so `--size` set on a wrapper `div` is simply ignored
+(verified: the glyph stays at its 16px default). Target the glyph class, or pass a `style` /
+`class` that lands on it:
+
+```css
+/* works */
+.bb-base-radio-icon {
+	--size: 20px;
+}
+/* does nothing */
+.my-form {
+	--size: 20px;
+}
+```
+
 **Bigger and recolored**
 
 ```vue
@@ -168,12 +184,12 @@ ancestor — they inherit):
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `checked` | `boolean \| undefined` |  |  | Renders the checked state (grows the inner dot). |
-| `disabled` | `boolean \| undefined` |  |  | Disables the glyph (muted fill, not-allowed cursor). Purely visual. |
-| `focusVisible` | `boolean \| undefined` |  |  | Whether keyboard focus is visible (`:focus-visible`). Draws the focus ring. |
-| `hasErrors` | `boolean \| undefined` |  |  | Puts the glyph into the error state (danger border and ring color). |
-| `hasWarning` | `boolean \| undefined` |  |  | Puts the glyph into the warning state (warn border and ring color). Errors take priority when both are set. |
-| `readonly` | `boolean \| undefined` |  |  | Renders the read-only affordance (default cursor instead of pointer). |
+| `checked` | `boolean \| undefined` | `false` |  | Renders the checked state (grows the inner dot). |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the glyph (muted fill, not-allowed cursor). Purely visual. |
+| `focusVisible` | `boolean \| undefined` | `false` |  | Whether keyboard focus is visible (`:focus-visible`). Draws the focus ring. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Puts the glyph into the error state (danger border and ring color). |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Puts the glyph into the warning state (warn border and ring color). Errors take priority when both are set. |
+| `readonly` | `boolean \| undefined` | `false` |  | Renders the read-only affordance (default cursor instead of pointer). |
 
 ## Events
 

package/dist/ai/BbBaseRating.md

@@ -20,14 +20,14 @@
 | `ariaLabelledby` | `string \| undefined` |  |  | Id(s) of the element(s) that NAME this rating group. Supplying one is what promotes the inner container to `role="radiogroup"` (Q4.5): an unnamed `radiogroup` announces as a bare "radio group" and is no better than the role-less `<span>` it… |
 | `autofocus` | `Booleanish \| undefined` |  |  | Sets autofocus on page load. |
 | `clearable` | `boolean \| undefined` | `false` |  | Allows clearing the selected rating by clicking the current value. |
-| `disabled` | `boolean \| undefined` |  |  | Disable all interactions with the rating. |
-| `hasErrors` | `boolean \| undefined` |  |  | Apply error styling to the rating. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disable all interactions with the rating. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Apply error styling to the rating. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
 | `id` | `string \| undefined` |  |  | Explicit id for the rating container. Used to generate ids for individual stars. |
 | `modelValue` | `number \| null` |  | yes | v-model value: the selected rating (1 to `stars`) or `null` for no selection. |
 | `name` | `string` |  | yes | Shared name attribute for all star radio inputs (required for grouping). |
-| `readonly` | `boolean \| undefined` |  |  | Make the rating read-only while keeping it visible. |
-| `required` | `boolean \| undefined` |  |  | Mark the rating as required. |
+| `readonly` | `boolean \| undefined` | `false` |  | Make the rating read-only while keeping it visible. |
+| `required` | `boolean \| undefined` | `false` |  | Mark the rating as required. |
 | `size` | `number \| ({ size?: any; } & string) \| keyof Sizes \| undefined` |  |  | Rating icon size. Accepts preset keys or any custom CSS length unit (e.g. `56ch`, `2rem`, `48px`) — applied verbatim, percentages included. |
 | `stars` | `number \| undefined` | `5` |  | Maximum number of stars to render and maximum selectable rating value. |
 

package/dist/ai/BbBaseSelect.md

@@ -16,49 +16,49 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `adaptive` | `boolean \| undefined` | `undefined` |  | When `true`, the options panel opens as a bottom off-canvas sheet on mobile viewports instead of a floating popover; on desktop it stays a popover. When unset, falls back to the global `config.adaptive`. |
+| `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | When `true`, the options panel opens as a bottom off-canvas sheet on mobile viewports instead of a floating popover; on desktop it stays a popover. When unset, falls back to the global `config.adaptive`. |
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to render at the right hand side of the control. |
 | `ariaDescribedby` | `string \| string[] \| undefined` |  |  | Id(s) of elements describing this select for assistive technologies. |
-| `autocomplete` | `string \| undefined` |  |  | Browser autocomplete hint forwarded to the search input inside the dropdown. |
+| `autocomplete` | `string \| undefined` | `'off'` |  | Browser autocomplete hint forwarded to the search input inside the dropdown. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Focuses the activator button on page load. |
-| `clearable` | `boolean \| undefined` |  |  | Show a clear button whenever a value is present and the control is interactive. |
-| `comma` | `boolean \| undefined` |  |  | Display selected values as a comma-separated string instead of individual chips. |
-| `compact` | `boolean \| undefined` |  |  | Apply the compact density variant. |
-| `dependencies` | `any[] \| undefined` |  |  | Additional dependencies that trigger item reloading when changed. |
-| `depsDebounceTime` | `number \| undefined` |  |  | Debounce delay (ms) for dependency-triggered reloads. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component. |
-| `disableWriting` | `boolean \| "mobile" \| "desktop" \| undefined` |  |  | Controls whether the search input is shown inside the dropdown panel. Use `'mobile'` to hide it only on mobile, `'desktop'` to hide it only on desktop. |
-| `enforceCoherence` | `boolean \| undefined` |  |  | Reset modelValue to `null` or empty array if it no longer matches available items. |
-| `filterBy` | `string[] \| undefined` |  |  | Property paths used to filter options when the user types in the search input. When empty (default) options are matched against their display text. When non-empty the provided paths are searched instead of the display text. To disable filte… |
+| `clearable` | `boolean \| undefined` | `false` |  | Show a clear button whenever a value is present and the control is interactive. |
+| `comma` | `boolean \| undefined` | `false` |  | Display selected values as a comma-separated string instead of individual chips. |
+| `compact` | `boolean \| undefined` | `false` |  | Apply the compact density variant. |
+| `dependencies` | `any[] \| undefined` | `[]` |  | Additional dependencies that trigger item reloading when changed. |
+| `depsDebounceTime` | `number \| undefined` | `0` |  | Debounce delay (ms) for dependency-triggered reloads. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component. |
+| `disableWriting` | `boolean \| "mobile" \| "desktop" \| undefined` | `false` |  | Controls whether the search input is shown inside the dropdown panel. Use `'mobile'` to hide it only on mobile, `'desktop'` to hide it only on desktop. |
+| `enforceCoherence` | `boolean \| undefined` | `false` |  | Reset modelValue to `null` or empty array if it no longer matches available items. |
+| `filterBy` | `string[] \| undefined` | `[]` |  | Property paths used to filter options when the user types in the search input. When empty (default) options are matched against their display text. When non-empty the provided paths are searched instead of the display text. To disable filte… |
 | `groupBy` | `string \| ((item: Item) => string \| number \| symbol) \| undefined` |  |  | Path or function used to group options. |
-| `hasErrors` | `boolean \| undefined` |  |  | Apply error styling to the select. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Apply error styling to the select. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
 | `headerHeight` | `number \| undefined` |  |  | Height of group headers in the listbox (px). |
 | `id` | `string \| undefined` |  |  | Explicit id for the control element. Also used to generate listbox and search input ids. |
 | `itemHeight` | `number \| undefined` |  |  | Height of options in the listbox (px). |
 | `items` | `Item[] \| ((query: string, prefill: boolean, modelValue: any) => Promise<Item[]>) \| ((query: string, prefill: boolean, modelValue: any) => Item[])` |  | yes | Array of items or async loader function. Loader functions receive `(query, prefill, modelValue)`; `modelValue` is the raw v-model: an array in `multiple` mode, the raw model value (possibly `null`) in single mode. |
 | `itemText` | `string \| ((item: Item) => string) \| undefined` |  |  | Path or function to extract display text from an item. |
 | `itemValue` | `string \| ((item: Item) => string) \| undefined` |  |  | Path or function to extract a value from an item. |
-| `loading` | `boolean \| undefined` |  |  | Display the loading state. |
+| `loading` | `boolean \| undefined` | `false` |  | Display the loading state. |
 | `loadingText` | `string \| undefined` |  |  | Message shown while items are loading. |
-| `max` | `number \| undefined` |  |  | Maximum number of selectable items. |
+| `max` | `number \| undefined` | `Infinity` |  | Maximum number of selectable items. |
 | `maxSelectedLabels` | `number \| undefined` | `Infinity` |  | Maximum number of labels shown before collapsing to a count summary. When set, this takes precedence over width-based overflow detection. |
 | `modelValue` | `any` |  | yes | v-model value. Array when `multiple` is true. |
 | `modelValueDebounceTime` | `number \| undefined` | `0` |  | Debounce delay (ms) for modelValue change handling. |
-| `multiple` | `boolean \| undefined` |  |  | Enable multiple item selection. Requires modelValue to be an array. |
+| `multiple` | `boolean \| undefined` | `false` |  | Enable multiple item selection. Requires modelValue to be an array. |
 | `name` | `string \| undefined` |  |  | Name attribute forwarded to hidden inputs for form submission. |
 | `noDataText` | `string \| undefined` |  |  | Message displayed when no options match. |
 | `offCanvasProps` | `Partial<BbOffCanvasProps> \| undefined` |  |  | Extra props forwarded to the `BbOffCanvas` sheet when `adaptive` is active on mobile. |
 | `placeholder` | `string \| undefined` |  |  | Placeholder text shown when no value is selected. |
 | `prefill` | `boolean \| "interaction" \| undefined` | `"interaction"` |  | Controls when items are pre-loaded. `'interaction'` loads on first user interaction, `true` loads immediately, `false` is *search-first*: with a provider, nothing loads until the user types (opening alone does not), and the panel shows a "s… |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to render at the left hand side of the control. |
-| `queryDebounceTime` | `number \| undefined` |  |  | Debounce delay (ms) before triggering search queries after user input. |
-| `readonly` | `boolean \| undefined` |  |  | Make the control read-only while keeping the dropdown accessible. |
-| `required` | `boolean \| undefined` |  |  | Marks the field as required for form validation. A visually-hidden sentinel input is used so native browser constraint validation fires. |
+| `queryDebounceTime` | `number \| undefined` | `500` |  | Debounce delay (ms) before triggering search queries after user input. |
+| `readonly` | `boolean \| undefined` | `false` |  | Make the control read-only while keeping the dropdown accessible. |
+| `required` | `boolean \| undefined` | `false` |  | Marks the field as required for form validation. A visually-hidden sentinel input is used so native browser constraint validation fires. |
 | `selectable` | `boolean \| ((item: Item) => boolean) \| undefined` | `true` |  | Defines whether options are selectable. Can be a global boolean that affects all options or a function that accepts an item and returns a boolean that only affects that item. Non-selectable options are rendered disabled. |
 | `selectedLabelsFn` | `((count: number) => string) \| undefined` |  |  | Function to generate a summary label when selected items exceed `maxSelectedLabels` or overflow the control width. |
-| `stash` | `boolean \| undefined` |  |  | Accumulate selected items across searches. |
-| `transitionDuration` | `number \| undefined` |  |  | Transition duration (ms) for dropdown animations. Forwarded to `BbSelectPopover`, which supplies the default. |
+| `stash` | `boolean \| undefined` | `false` |  | Accumulate selected items across searches. |
+| `transitionDuration` | `number \| undefined` | `250` |  | Transition duration (ms) for dropdown animations. Forwarded to `BbSelectPopover`, which supplies the default. |
 
 ## Events
 
@@ -76,6 +76,7 @@
 
 - `append` — scope: `BaseSelectActivatorSlotProps`
 - `append-outer` — scope: `BaseSelectOuterSlotProps`
+- `chip` — scope: `BaseSelectChipSlotProps<Item>` — Replaces the default badge rendered for each selection in `multiple` mode.
 - `footer` — scope: `BaseSelectPanelSlotProps` — Content pinned to the bottom of the panel, below the options list.
 - `group` — scope: `BaseSelectGroupSlotProps<Item>`
 - `header` — scope: `BaseSelectPanelSlotProps` — Content pinned to the top of the panel, above the search field.

package/dist/ai/BbBaseSlider.md

@@ -18,22 +18,22 @@
 | --- | --- | --- | --- | --- |
 | `ariaDescribedby` | `string \| undefined` |  |  | Id(s) of elements describing this slider for assistive technologies. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Focus the slider on mount. |
-| `compact` | `boolean \| undefined` |  |  | Apply the compact density variant. |
-| `disabled` | `boolean \| undefined` |  |  | Disable all interactions with the slider. |
-| `disableThumbTranslate` | `boolean \| undefined` |  |  | Disables the proportional thumb translation that keeps thumbs centered on the track (enabled by default). Set it when displaying ticks for better alignment. |
-| `hasErrors` | `boolean \| undefined` |  |  | Apply error styling to the slider. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
+| `compact` | `boolean \| undefined` | `false` |  | Apply the compact density variant. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disable all interactions with the slider. |
+| `disableThumbTranslate` | `boolean \| undefined` | `false` |  | Disables the proportional thumb translation that keeps thumbs centered on the track (enabled by default). Set it when displaying ticks for better alignment. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Apply error styling to the slider. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
 | `id` | `string \| undefined` |  |  | Explicit id for the slider container. Used to generate ids for thumbs. |
 | `max` | `number \| undefined` | `100` |  | Upper bound for slider values. |
 | `maxPrecision` | `number \| undefined` | `2` |  | Maximum decimal places to retain in emitted values. |
 | `min` | `number \| undefined` | `0` |  | Lower bound for slider values. |
 | `modelValue` | `number \| number[] \| null` | `0` | yes | v-model value. Single number for single slider, two-element array for range. |
 | `name` | `string \| undefined` |  |  | Defines the name of the input. |
-| `range` | `boolean \| undefined` |  |  | Enable range selection with two thumbs. When true, modelValue must be an array. |
-| `readonly` | `boolean \| undefined` |  |  | Make the slider read-only while keeping it visible. |
-| `required` | `boolean \| undefined` |  |  | Mark the slider as required. |
+| `range` | `boolean \| undefined` | `false` |  | Enable range selection with two thumbs. When true, modelValue must be an array. |
+| `readonly` | `boolean \| undefined` | `false` |  | Make the slider read-only while keeping it visible. |
+| `required` | `boolean \| undefined` | `false` |  | Mark the slider as required. |
 | `step` | `number \| undefined` | `1` |  | Granularity step for value changes via keyboard or pointer interaction. |
-| `ticks` | `boolean \| undefined` |  |  | Show tick marks at each step interval. |
+| `ticks` | `boolean \| undefined` | `false` |  | Show tick marks at each step interval. |
 
 ## Events
 

package/dist/ai/BbBaseSwitch.md

@@ -17,19 +17,19 @@
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
 | `ariaDescribedby` | `string \| undefined` |  |  | ID of the element that describes this checkbox for assistive technologies. Forwarded to the input as `aria-describedby`. |
-| `autofocus` | `Booleanish \| undefined` |  |  | Automatically focuses the checkbox when the page/component loads. Use sparingly to avoid usability issues. |
+| `autofocus` | `Booleanish \| undefined` | `false` |  | Automatically focuses the checkbox when the page/component loads. Use sparingly to avoid usability issues. |
 | `checked` | `boolean \| undefined` | `undefined` |  | Forces the checkbox checked state (controlled prop). When omitted, the checked state is derived from `modelValue === trueValue`. Deliberately `undefined` rather than `false`, so "unset" stays distinguishable from an explicit `:checked="fals… |
-| `disabled` | `boolean \| undefined` |  |  | Disables user interaction. Also applied when `readonly` is set, since native checkboxes do not support `readonly`. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables user interaction. Also applied when `readonly` is set, since native checkboxes do not support `readonly`. |
 | `falseValue` | `any` | `false` |  | Value submitted/emitted when the checkbox is unchecked. Accepts any serializable value. Serialized to a string for form submission. |
-| `hasErrors` | `boolean \| undefined` |  |  | Puts the component into an error state (adds error styling class `bb-base-checkbox--errors`). |
-| `hasWarning` | `boolean \| undefined` |  |  | Puts the component into a warning state (adds `bb-base-checkbox--warnings`). Errors take priority when both are set. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Puts the component into an error state (adds error styling class `bb-base-checkbox--errors`). |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Puts the component into a warning state (adds `bb-base-checkbox--warnings`). Errors take priority when both are set. |
 | `id` | `string \| undefined` |  |  | Identifier forwarded to the input. |
-| `indeterminate` | `boolean \| undefined` |  |  | Renders the checkbox in the indeterminate state (neither checked nor unchecked). Note: the native `indeterminate` state resets on user click; this component re-applies it to keep UI and prop aligned. |
+| `indeterminate` | `boolean \| undefined` | `false` |  | Renders the checkbox in the indeterminate state (neither checked nor unchecked). Note: the native `indeterminate` state resets on user click; this component re-applies it to keep UI and prop aligned. |
 | `modelValue` | `any` |  |  | Bound value for `v-model`. When it equals `trueValue` the checkbox is considered checked, otherwise unchecked. |
 | `name` | `string \| undefined` |  |  | Name attribute of the input, used during form submission. |
-| `readonly` | `boolean \| undefined` |  |  | Puts the input in a read-only state. Since checkboxes do not support native `readonly`, the input is disabled while styled as read-only. |
-| `required` | `boolean \| undefined` |  |  | Marks the input as required for form validation. |
-| `submitWhenFalse` | `boolean \| undefined` |  |  | When unchecked, submits a hidden input with `falseValue` so that a value is still posted with the form. When checked, the visible input submits `trueValue` as usual. |
+| `readonly` | `boolean \| undefined` | `false` |  | Puts the input in a read-only state. Since checkboxes do not support native `readonly`, the input is disabled while styled as read-only. |
+| `required` | `boolean \| undefined` | `false` |  | Marks the input as required for form validation. |
+| `submitWhenFalse` | `boolean \| undefined` | `false` |  | When unchecked, submits a hidden input with `falseValue` so that a value is still posted with the form. When checked, the visible input submits `trueValue` as usual. |
 | `trueValue` | `any` | `true` |  | Value submitted/emitted when the checkbox is checked. Accepts any serializable value. Serialized to a string for form submission. |
 
 ## Events