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

package/dist/ai/BbTabs.md

@@ -4,7 +4,7 @@
 
 - Safety level: **Consumer API**
 - Group: **Navigation**
-- Description: Switches between tabbed content views (shadcn-like strip; BbTabRoot enables split layouts).
+- Description: Switches between tabbed content views (shadcn-like strip; the co-located BbTabsRoot / BbTabsList / BbTabsPanes exports enable split layouts).
 - Usage rule: Prefer this component for consumer-facing implementations.
 - Implementation source (only when the contract below is not enough): [source/BbTabs.md](./source/BbTabs.md)
 
@@ -672,7 +672,18 @@ ends.
 					@click="scroll('right')"
 				/>
 			</template>
-			<template v-for="release in releases" :key="release.key" #[release.key]>
+			<!--
+				`slotKey(...)`, never the raw key. A pane's slot name is the
+				NORMALIZED key, so `#[release.key]` only happens to work while the
+				keys are already slug-safe (`v1`…`v9`). Give a release a realistic
+				tag — `v3-1`, `2026-03` — and the raw key stops matching the slot
+				name, and every pane silently renders empty.
+			-->
+			<template
+				v-for="release in releases"
+				:key="release.key"
+				#[slotKey(release.key)]
+			>
 				<p class="pt-3 text-sm text-[color:var(--bb-text-muted)]">
 					{{ release.label }} shipped the design-token overhaul and the tabs
 					keyboard-navigation pass.
@@ -683,7 +694,7 @@ ends.
 </template>
 <script setup lang="ts">
 import { ref } from 'vue';
-import { BbButton, BbTabs } from 'bitboss-ui';
+import { BbButton, BbTabs, slotKey } from 'bitboss-ui';
 import type { BbTabsItem } from 'bitboss-ui';
 
 // A block strip with more triggers than fit: the pill and scroll-into-view keep
@@ -1105,8 +1116,11 @@ route, so it is SSR-safe and shareable:
 - **Don't reach for `BbTabsRoot` by default.** If you only need a strip over its
   panes, `BbTabs` is less markup and identical behavior; split only for markup
   between them.
-- **Every tab disabled throws.** With no `modelValue` and no valid first tab the
-  group has nothing to select — always leave at least one enabled tab.
+- **Every tab disabled renders an inert tablist** — it does not throw. With no
+  `modelValue` and no enabled tab there is nothing to select, so the strip
+  renders with no active tab and no pane (`useBbTabsContext.ts:200-206` handles
+  this deliberately). Nothing warns, so an all-disabled group looks like a
+  rendering bug; leave at least one tab enabled, or hide the strip.
 
 ### Accessibility
 
@@ -1139,18 +1153,18 @@ route, so it is SSR-safe and shareable:
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `block` | `boolean \| undefined` |  |  | Displays the component as full width. |
-| `compact` | `boolean \| undefined` |  |  | Adds a CSS class that applies a compact style to the component. |
+| `block` | `boolean \| undefined` | `false` |  | Displays the component as full width. |
+| `compact` | `boolean \| undefined` | `false` |  | Adds a CSS class that applies a compact style to the component. |
 | `direction` | `"horizontal" \| "vertical" \| undefined` | `"horizontal"` |  | Direction of the tabs component. |
-| `disableAnimateX` | `boolean \| undefined` |  |  | Disables the horizontal slide transition between tab panels (enabled by default). |
-| `disableAnimateY` | `boolean \| undefined` |  |  | Disables the smooth height animation when switching between tab panels (enabled by default). |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component |
-| `eager` | `boolean \| undefined` |  |  | Prevents rendering content before it's made visible. |
+| `disableAnimateX` | `boolean \| undefined` | `false` |  | Disables the horizontal slide transition between tab panels (enabled by default). |
+| `disableAnimateY` | `boolean \| undefined` | `false` |  | Disables the smooth height animation when switching between tab panels (enabled by default). |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component |
+| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
 | `headers` | `Record<string, string> \| undefined` |  |  | Additional HTTP headers forwarded to Inertia when navigation is triggered. Only meaningful in an Inertia context. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `items` | `BbTabsItem<K>[]` |  | yes | Array of items that define the tabs in the component. |
 | `modelValue` | `K \| null \| undefined` |  |  | The current tab key. Used by v-model. |
-| `navigation` | `boolean \| undefined` |  |  | Synchronizes the current tab with the URL query parameter. Pair it with `replace` unless a tab is genuinely a separate destination — see the `replace` prop. |
+| `navigation` | `boolean \| undefined` | `false` |  | Synchronizes the current tab with the URL query parameter. Pair it with `replace` unless a tab is genuinely a separate destination — see the `replace` prop. |
 | `onBefore` | `(() => boolean \| void) \| undefined` |  |  | Inertia lifecycle hook — fired just before the request is sent. Return `false` to cancel the visit. |
 | `onCancel` | `(() => void) \| undefined` |  |  | Inertia lifecycle hook — fired when the request is cancelled. |
 | `onError` | `((errors: Record<string, string>) => void) \| undefined` |  |  | Inertia lifecycle hook — fired when the server returns validation errors. |
@@ -1162,8 +1176,8 @@ route, so it is SSR-safe and shareable:
 | `preserveScroll` | `boolean \| ((props: Record<string, unknown>) => boolean) \| undefined` |  |  | Controls whether Inertia preserves the scroll position after navigation. Only meaningful in an Inertia context. |
 | `preserveState` | `boolean \| ((props: Record<string, unknown>) => boolean) \| null \| undefined` |  |  | Controls whether Inertia preserves the current component state after navigation. Only meaningful in an Inertia context. |
 | `queryKey` | `string \| undefined` | `"tab"` |  | Defines the query key used for URL-based navigation. |
-| `replace` | `boolean \| undefined` |  |  | Uses history replacement instead of push navigation. Prefer `replace` whenever `navigation` is on: the URL still carries the active tab (deep-linkable, survives reload), but switching tabs does not stack a history entry per click, so Back l… |
-| `server` | `boolean \| undefined` |  |  | When true and in an Inertia context, triggers a real server-side Inertia visit instead of a client-only `history.pushState`. |
+| `replace` | `boolean \| undefined` | `false` |  | Replaces history rather than pushing it when changing tab. Recommended default whenever `navigation` is on: the query keeps the active tab (deep-linkable, survives reload) while Back still returns to the page the user came from, instead of … |
+| `server` | `boolean \| undefined` | `false` |  | When true and in an Inertia context, triggers a real server-side Inertia visit instead of a client-only `history.pushState`. |
 
 ## Events
 

package/dist/ai/BbTabsList.md

@@ -24,6 +24,6 @@
 
 ## See Also
 
-- [BbTabs](./BbTabs.md) — Switches between tabbed content views (shadcn-like strip; BbTabRoot enables split layouts).
+- [BbTabs](./BbTabs.md) — Switches between tabbed content views (shadcn-like strip; the co-located BbTabsRoot / BbTabsList / BbTabsPanes exports enable split layouts).
 - [BbTabsRoot](./BbTabsRoot.md) — Provide/inject root that lets BbTabsList and BbTabsPanes live in separate layout slots.
 - [BbTabsPanes](./BbTabsPanes.md) — The pane host of a split BbTabsRoot layout (renders the tab content only).

package/dist/ai/BbTabsPanes.md

@@ -22,6 +22,6 @@
 
 ## See Also
 
-- [BbTabs](./BbTabs.md) — Switches between tabbed content views (shadcn-like strip; BbTabRoot enables split layouts).
+- [BbTabs](./BbTabs.md) — Switches between tabbed content views (shadcn-like strip; the co-located BbTabsRoot / BbTabsList / BbTabsPanes exports enable split layouts).
 - [BbTabsRoot](./BbTabsRoot.md) — Provide/inject root that lets BbTabsList and BbTabsPanes live in separate layout slots.
 - [BbTabsList](./BbTabsList.md) — The trigger strip of a split BbTabsRoot layout (renders the tab buttons only).

package/dist/ai/BbTabsRoot.md

@@ -16,18 +16,18 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `block` | `boolean \| undefined` |  |  | Displays the component as full width. |
-| `compact` | `boolean \| undefined` |  |  | Adds a CSS class that applies a compact style to the component. |
+| `block` | `boolean \| undefined` | `false` |  | Displays the component as full width. |
+| `compact` | `boolean \| undefined` | `false` |  | Adds a CSS class that applies a compact style to the component. |
 | `direction` | `"horizontal" \| "vertical" \| undefined` | `"horizontal"` |  | Direction of the tabs component. |
-| `disableAnimateX` | `boolean \| undefined` |  |  | Disables the horizontal slide transition between tab panels (enabled by default). |
-| `disableAnimateY` | `boolean \| undefined` |  |  | Disables the smooth height animation when switching between tab panels (enabled by default). |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component |
-| `eager` | `boolean \| undefined` |  |  | Prevents rendering content before it's made visible. |
+| `disableAnimateX` | `boolean \| undefined` | `false` |  | Disables the horizontal slide transition between tab panels (enabled by default). |
+| `disableAnimateY` | `boolean \| undefined` | `false` |  | Disables the smooth height animation when switching between tab panels (enabled by default). |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component |
+| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
 | `headers` | `Record<string, string> \| undefined` |  |  | Additional HTTP headers forwarded to Inertia when navigation is triggered. Only meaningful in an Inertia context. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `items` | `BbTabsItem<K>[]` |  | yes | Array of items that define the tabs in the component. |
 | `modelValue` | `K \| null \| undefined` |  |  | The current tab key. Used by v-model. |
-| `navigation` | `boolean \| undefined` |  |  | Synchronizes the current tab with the URL query parameter. Pair it with `replace` unless a tab is genuinely a separate destination — see the `replace` prop. |
+| `navigation` | `boolean \| undefined` | `false` |  | Synchronizes the current tab with the URL query parameter. Pair it with `replace` unless a tab is genuinely a separate destination — see the `replace` prop. |
 | `onBefore` | `(() => boolean \| void) \| undefined` |  |  | Inertia lifecycle hook — fired just before the request is sent. Return `false` to cancel the visit. |
 | `onCancel` | `(() => void) \| undefined` |  |  | Inertia lifecycle hook — fired when the request is cancelled. |
 | `onError` | `((errors: Record<string, string>) => void) \| undefined` |  |  | Inertia lifecycle hook — fired when the server returns validation errors. |
@@ -39,8 +39,8 @@
 | `preserveScroll` | `boolean \| ((props: Record<string, unknown>) => boolean) \| undefined` |  |  | Controls whether Inertia preserves the scroll position after navigation. Only meaningful in an Inertia context. |
 | `preserveState` | `boolean \| ((props: Record<string, unknown>) => boolean) \| null \| undefined` |  |  | Controls whether Inertia preserves the current component state after navigation. Only meaningful in an Inertia context. |
 | `queryKey` | `string \| undefined` | `"tab"` |  | Defines the query key used for URL-based navigation. |
-| `replace` | `boolean \| undefined` |  |  | Uses history replacement instead of push navigation. Prefer `replace` whenever `navigation` is on: the URL still carries the active tab (deep-linkable, survives reload), but switching tabs does not stack a history entry per click, so Back l… |
-| `server` | `boolean \| undefined` |  |  | When true and in an Inertia context, triggers a real server-side Inertia visit instead of a client-only `history.pushState`. |
+| `replace` | `boolean \| undefined` | `false` |  | Replaces history rather than pushing it when changing tab. Recommended default whenever `navigation` is on: the query keeps the active tab (deep-linkable, survives reload) while Back still returns to the page the user came from, instead of … |
+| `server` | `boolean \| undefined` | `false` |  | When true and in an Inertia context, triggers a real server-side Inertia visit instead of a client-only `history.pushState`. |
 
 ## Events
 
@@ -52,6 +52,6 @@
 
 ## See Also
 
-- [BbTabs](./BbTabs.md) — Switches between tabbed content views (shadcn-like strip; BbTabRoot enables split layouts).
+- [BbTabs](./BbTabs.md) — Switches between tabbed content views (shadcn-like strip; the co-located BbTabsRoot / BbTabsList / BbTabsPanes exports enable split layouts).
 - [BbTabsList](./BbTabsList.md) — The trigger strip of a split BbTabsRoot layout (renders the tab buttons only).
 - [BbTabsPanes](./BbTabsPanes.md) — The pane host of a split BbTabsRoot layout (renders the tab content only).

package/dist/ai/BbTag.md

@@ -363,33 +363,33 @@ only sets the label's text alignment.
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to be added at the end of the input. |
 | `autocomplete` | `string \| undefined` |  |  | Guides to the browser as to the type of information expected in the field. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Sets autofocus on page load. |
-| `caseSensitive` | `boolean \| undefined` |  |  | Compare tags case-sensitively when rejecting duplicates, so `Vue` and `vue` can both exist. By default matching folds case, because two chips differing only in case read as duplicates to a user. Either way the tag is stored with the casing … |
-| `clearable` | `boolean \| undefined` |  |  | Displays a clear button when the input has a value and is being interacted with. |
-| `comma` | `boolean \| undefined` |  |  | Sets the display model for selected values to a list of comma separated string. In this mode the user cannot deselect an option by pressing the close button. |
-| `compact` | `boolean \| undefined` |  |  | Sets the component in a compact mode. |
+| `caseSensitive` | `boolean \| undefined` | `false` |  | Compare tags case-sensitively when rejecting duplicates, so `Vue` and `vue` can both exist. By default matching folds case, because two chips differing only in case read as duplicates to a user. Either way the tag is stored with the casing … |
+| `clearable` | `boolean \| undefined` | `false` |  | Displays a clear button when the input has a value and is being interacted with. |
+| `comma` | `boolean \| undefined` | `false` |  | Sets the display model for selected values to a list of comma separated string. In this mode the user cannot deselect an option by pressing the close button. |
+| `compact` | `boolean \| undefined` | `false` |  | Sets the component in a compact mode. |
 | `description` | `string \| undefined` |  |  | Descriptive text displayed below the label and above the input. Unlike the hint it is always visible, and it is linked to the input via `aria-describedby` (after any `errors` / `warnings`, before the `hint`). |
 | `direction` | `InputDirection \| undefined` |  |  | Direction of the layout of the component. Can either be a predefined value or a pattern separated by a space like `xx xxxxx`. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component. |
 | `divider` | `string \| string[] \| undefined` |  |  | The divider key used to separate values from one another. By default it is "Enter". Accepts a single key or an array of keys (e.g. `['Enter', ',']`) — any of them commits the current text. |
 | `errors` | `string \| string[] \| undefined` |  |  | Can be a string or an array of string containing the messages to display. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, are referenced FIRST from the control's `aria-describedby… |
-| `hasErrors` | `boolean \| undefined` |  |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
-| `hasWarning` | `boolean \| undefined` |  |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
-| `hideLabel` | `boolean \| undefined` |  |  | Visually hides the label of the input while maintaining accessibility. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Visually hides the label of the input while maintaining accessibility. |
 | `hint` | `string \| undefined` |  |  | Text box to be displayed near the input, usually to indicate instructions. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `label` | `string` |  | yes | Text content of the label of the element. |
 | `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` |  |  | Where the label sits relative to the field: `outside` above it, `inside` within the control, or `floating` (starts inside, lifts on focus/value). Defaults to `config.defaultInputLabelMode`, like the other inputs. |
 | `labelPosition` | `"left" \| "center" \| "right" \| undefined` |  |  | Sets the text alignment of the label. |
-| `loading` | `boolean \| undefined` |  |  | Sets the component in a loading state, usually triggering some visual styles. |
+| `loading` | `boolean \| undefined` | `false` |  | Sets the component in a loading state, usually triggering some visual styles. |
 | `max` | `number \| undefined` |  |  | Maximum number of selected items. |
 | `modelValue` | `string[]` |  | yes | Used by v-model. Contains all selected tags. |
 | `name` | `string \| undefined` |  |  | Defines the name of the input. |
-| `persistentHint` | `boolean \| undefined` |  |  | Keeps the hint displayed. |
+| `persistentHint` | `boolean \| undefined` | `false` |  | Keeps the hint displayed. |
 | `placeholder` | `string \| undefined` |  |  | String displayed when there's no data. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to be added at the start of the input. |
-| `readonly` | `boolean \| undefined` |  |  | Sets the input in a readonly state. |
-| `required` | `boolean \| undefined` |  |  | Sets the input as required. |
-| `reverse` | `boolean \| undefined` |  |  | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
+| `readonly` | `boolean \| undefined` | `false` |  | Sets the input in a readonly state. |
+| `required` | `boolean \| undefined` | `false` |  | Sets the input as required. |
+| `reverse` | `boolean \| undefined` | `false` |  | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
 | `warnings` | `string \| string[] \| undefined` |  |  | Warning messages to display beneath the field, in their own `aria-live` region and amber (`--bb-text-warn`). A string or array; a non-empty list implies the warning state. Errors suppress warnings when both are set. While displayed they are… |
 
 ## Events
@@ -434,5 +434,5 @@ Importing this component from `bitboss-ui/validated` instead of `bitboss-ui` bin
 
 ## See Also
 
-- [BbBadge](./BbBadge.md) — Displays compact status counters or labels, the floating mode acts as notification dot.
+- [BbBadge](./BbBadge.md) — Displays a compact inline status counter or label. It sits in the flow — for a bubble or dot anchored OVER another element, use BbIndicator (includes the co-located BbBadgeButton export).
 - [BbSelect](./BbSelect.md) — Selects one or many options from structured data.

package/dist/ai/BbTextInput.md

@@ -45,7 +45,7 @@ read from `FormData`.
 - **`hideLabel`** keeps the label for screen readers but removes it visually —
   the right move for search boxes whose design shows only a placeholder.
 - The **`label` slot** replaces the label text and receives
-  `{ text, hasErrors }`, e.g. to append a required marker that turns red with
+  `{ text, hasErrors, hasWarning }`, e.g. to append a required marker that turns red with
   the error state.
 
 Avoid combining `labelMode="floating"` with a `placeholder` — the resting
@@ -542,8 +542,9 @@ The API also exposes `direction` (horizontal/pattern layouts), `reverse` and
 `labelMode="floating"` or `"inside"` (via prop or
 `config.defaultInputLabelMode`) the label is embedded in the field, so those
 modes force the vertical layout and ignore `direction`. The same rule applies
-to `BbNumberInput`, `BbSelect` and `BbDatePickerInput`; `BbTextarea` has no
-label mode at all, so it always honors `direction`.
+to `BbNumberInput`, `BbSelect`, `BbDatePickerInput` and `BbTextarea` — all
+five carry `labelMode` and all five fall back to
+`config.defaultInputLabelMode` when it is unset.
 
 **Horizontal row via direction (outside label)**
 
@@ -867,32 +868,32 @@ const formattedTotal = computed(() =>
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to be added at the end of the input. |
 | `autocomplete` | `string \| undefined` |  |  | Guides to the browser as to the type of information expected in the field. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Sets autofocus on page load. |
-| `clearable` | `boolean \| undefined` |  |  | Displays a clear button when the input has a value and is being interacted with. |
-| `compact` | `boolean \| undefined` |  |  | Displays the component in a compact version. |
+| `clearable` | `boolean \| undefined` | `false` |  | Displays a clear button when the input has a value and is being interacted with. |
+| `compact` | `boolean \| undefined` | `false` |  | Displays the component in a compact version. |
 | `description` | `string \| undefined` |  |  | Descriptive text displayed below the label and above the input. Unlike the hint it is always visible, and it is linked to the input via `aria-describedby` (after any `errors` / `warnings`, before the `hint`). |
 | `direction` | `InputDirection \| undefined` |  |  | Direction of the layout of the component. Can either be a predefined value or a pattern separated by a space like `xx xxxxx`. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component. |
-| `emitMasked` | `boolean \| undefined` |  |  | Emits the masked value of the input. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component. |
+| `emitMasked` | `boolean \| undefined` | `false` |  | Emits the masked value of the input. |
 | `errors` | `string \| string[] \| undefined` |  |  | Can be a string or an array of string containing the messages to display. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, are referenced FIRST from the control's `aria-describedby… |
-| `hasErrors` | `boolean \| undefined` |  |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
-| `hasWarning` | `boolean \| undefined` |  |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
-| `hideLabel` | `boolean \| undefined` |  |  | Visually hides the label of the input while maintaining accessibility. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Visually hides the label of the input while maintaining accessibility. |
 | `hint` | `string \| undefined` |  |  | Text box to be displayed near the input, usually to indicate instructions. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `inputMode` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "none" \| "numeric" \| "decimal" \| undefined` |  |  | The inputmode of the input. |
 | `label` | `string` |  | yes | Text content of the label of the element. |
 | `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` |  |  | Label rendering mode. |
 | `labelPosition` | `"left" \| "center" \| "right" \| undefined` |  |  | Sets the text alignment of the label. |
-| `loading` | `boolean \| undefined` |  |  | Sets the component in a loading state, usually triggering some visual styles. |
+| `loading` | `boolean \| undefined` | `false` |  | Sets the component in a loading state, usually triggering some visual styles. |
 | `mask` | `MaskInputOptions \| undefined` |  |  | The mask to be applied to the input. Please visit https://beholdr.github.io/maska/v3 for syntax examples. |
 | `modelValue` | `string \| null` |  | yes | Used by v-model. |
 | `name` | `string \| undefined` |  |  | Defines the name of the input. |
-| `persistentHint` | `boolean \| undefined` |  |  | Keeps the hint displayed. |
+| `persistentHint` | `boolean \| undefined` | `false` |  | Keeps the hint displayed. |
 | `placeholder` | `string \| undefined` |  |  | String displayed when there's no data. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to be added at the start of the input. |
-| `readonly` | `boolean \| undefined` |  |  | Sets the input in a readonly state. |
-| `required` | `boolean \| undefined` |  |  | Sets the input as required. |
-| `reverse` | `boolean \| undefined` |  |  | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
+| `readonly` | `boolean \| undefined` | `false` |  | Sets the input in a readonly state. |
+| `required` | `boolean \| undefined` | `false` |  | Sets the input as required. |
+| `reverse` | `boolean \| undefined` | `false` |  | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
 | `type` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "password" \| undefined` |  |  | Type of the input. Restricted to the textual input types this component supports — use `BbNumberInput` for numbers and `BbDatePickerInput` for dates. |
 | `warnings` | `string \| string[] \| undefined` |  |  | Warning messages to display beneath the field, in their own `aria-live` region and amber (`--bb-text-warn`). A string or array; a non-empty list implies the warning state. Errors suppress warnings when both are set. While displayed they are… |
 

package/dist/ai/BbTextarea.md

@@ -44,7 +44,7 @@ form or read from `FormData`.
   inside the top edge). Unset, it falls back to
   `config.defaultInputLabelMode` — so a project that floats its single-line
   inputs gets floating textarea labels for free.
-- The **`label` slot** replaces the label text and receives `{ text, hasErrors }`
+- The **`label` slot** replaces the label text and receives `{ text, hasErrors, hasWarning }`
   — e.g. to append a required marker that turns red in the error state.
 
 **Label, hidden label, and a custom label slot**
@@ -804,30 +804,30 @@ comment composer above).
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to be added at the end of the input. |
 | `autocomplete` | `string \| undefined` |  |  | Guides to the browser as to the type of information expected in the field. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Sets autofocus on page load. |
-| `autoGrow` | `boolean \| undefined` |  |  | Expands the textarea to match its content. |
-| `clearable` | `boolean \| undefined` |  |  | Displays a clear button when the input has a value and is being interacted with. |
-| `compact` | `boolean \| undefined` |  |  | Sets the component in a compact state. |
+| `autoGrow` | `boolean \| undefined` | `false` |  | Expands the textarea to match its content. |
+| `clearable` | `boolean \| undefined` | `false` |  | Displays a clear button when the input has a value and is being interacted with. |
+| `compact` | `boolean \| undefined` | `false` |  | Sets the component in a compact state. |
 | `description` | `string \| undefined` |  |  | Descriptive text displayed below the label and above the input. Unlike the hint it is always visible, and it is linked to the input via `aria-describedby` (after any `errors` / `warnings`, before the `hint`). |
 | `direction` | `InputDirection \| undefined` |  |  | Direction of the layout of the component. Can either be a predefined value or a pattern separated by a space like `xx xxxxx`. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component. |
 | `errors` | `string \| string[] \| undefined` |  |  | Can be a string or an array of string containing the messages to display. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, are referenced FIRST from the control's `aria-describedby… |
-| `hasErrors` | `boolean \| undefined` |  |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
-| `hasWarning` | `boolean \| undefined` |  |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
-| `hideLabel` | `boolean \| undefined` |  |  | Visually hides the label of the input while maintaining accessibility. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Visually hides the label of the input while maintaining accessibility. |
 | `hint` | `string \| undefined` |  |  | Text box to be displayed near the input, usually to indicate instructions. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `label` | `string` |  | yes | Text content of the label of the element. |
 | `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` |  |  | Label rendering mode. `'outside'` (default) sits the label above/beside the field; `'floating'`/`'inside'` overlay it, like the other text inputs. |
 | `labelPosition` | `"left" \| "center" \| "right" \| undefined` |  |  | Sets the text alignment of the label. |
-| `loading` | `boolean \| undefined` |  |  | Sets the component in a loading state, usually triggering some visual styles. |
+| `loading` | `boolean \| undefined` | `false` |  | Sets the component in a loading state, usually triggering some visual styles. |
 | `modelValue` | `string \| null` |  | yes | Used by v-model. |
 | `name` | `string \| undefined` |  |  | Defines the name of the input. |
-| `persistentHint` | `boolean \| undefined` |  |  | Keeps the hint displayed. |
+| `persistentHint` | `boolean \| undefined` | `false` |  | Keeps the hint displayed. |
 | `placeholder` | `string \| undefined` |  |  | String displayed when there's no data. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to be added at the start of the input. |
-| `readonly` | `boolean \| undefined` |  |  | Sets the input in a readonly state. |
-| `required` | `boolean \| undefined` |  |  | Sets the input as required. |
-| `reverse` | `boolean \| undefined` |  |  | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
+| `readonly` | `boolean \| undefined` | `false` |  | Sets the input in a readonly state. |
+| `required` | `boolean \| undefined` | `false` |  | Sets the input as required. |
+| `reverse` | `boolean \| undefined` | `false` |  | Reverses the layout. Applicable in every direction the order of the label and the input is swapped. |
 | `rows` | `string \| number \| undefined` |  |  | Sets the number of visible text lines for the control. |
 | `warnings` | `string \| string[] \| undefined` |  |  | Warning messages to display beneath the field, in their own `aria-live` region and amber (`--bb-text-warn`). A string or array; a non-empty list implies the warning state. Errors suppress warnings when both are set. While displayed they are… |
 

package/dist/ai/BbTimePicker.md

@@ -192,13 +192,13 @@ typeahead. Always pass a `label` when the trigger is an unlabelled cell or icon.
 | --- | --- | --- | --- | --- |
 | `activator` | `ElementOrComponentRef \| undefined` |  |  | External activator element or component ref. When provided, the `activator` slot is not rendered and click + ARIA are attached programmatically to the referenced element — mirroring `BbDatePicker`. |
 | `activeSegment` | `BbTimePickerSegment \| undefined` |  |  | Which end the columns edit in range mode (`v-model:active-segment`). Standalone use manages this internally via the in-panel toggle; a host can drive it. Ignored outside `range`. |
-| `adaptive` | `boolean \| undefined` | `undefined` |  | On mobile, open in a bottom off-canvas sheet instead of a floating popover. When unset, falls back to the global `config.adaptive`. |
-| `ampm` | `boolean \| undefined` |  |  | 12-hour display with an AM/PM column; emitted values stay 24-hour. |
+| `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | On mobile, open in a bottom off-canvas sheet instead of a floating popover. When unset, falls back to the global `config.adaptive`. |
+| `ampm` | `boolean \| undefined` | `false` |  | 12-hour display with an AM/PM column; emitted values stay 24-hour. |
 | `anchor` | `ElementOrComponentRef \| undefined` |  |  | Element or component ref the popover positions itself relative to. Defaults to the activator when omitted (anchor to a larger row while a smaller element stays the click target). |
 | `boundary` | `ElementOrComponentRefOrSelector \| undefined` |  |  | Constrains the popover within a bounding element or CSS selector. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the activator and the columns. |
-| `disableFlip` | `boolean \| undefined` |  |  | Disable the automatic flip to the opposite side on overflow. |
-| `eager` | `boolean \| undefined` |  |  | Render popover content before it is first shown. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the activator and the columns. |
+| `disableFlip` | `boolean \| undefined` | `false` |  | Disable the automatic flip to the opposite side on overflow. |
+| `eager` | `boolean \| undefined` | `false` |  | Render popover content before it is first shown. |
 | `label` | `string \| undefined` |  |  | Accessible label applied to the activator via `aria-label`. |
 | `max` | `string \| undefined` |  |  | Maximum selectable time in `HH:mm` format. Values outside the pattern throw during setup to surface configuration mistakes. |
 | `min` | `string \| undefined` |  |  | Minimum selectable time in `HH:mm` format. Values outside the pattern throw during setup to surface configuration mistakes. |
@@ -207,11 +207,11 @@ typeahead. Always pass a `label` when the trigger is an unlabelled cell or icon.
 | `offset` | `number \| undefined` | `4` |  | Space the popover keeps from the activator. |
 | `padding` | `number \| undefined` |  |  | Minimum empty space to keep from the edge of the page. |
 | `placement` | `Placement \| undefined` |  |  | Position of the popover relative to the activator/anchor. |
-| `range` | `boolean \| undefined` |  |  | Range selection: the value is a two-element `[start, end]` array. |
-| `readonly` | `boolean \| undefined` |  |  | Prevents opening while keeping the activator visible. |
-| `seconds` | `boolean \| undefined` |  |  | Adds the seconds column. |
-| `step` | `number \| undefined` |  |  | Minute-column granularity and arrow stepping. |
-| `transitionDuration` | `number \| undefined` | `transitions.medium` |  | Popover/sheet transition duration in milliseconds. |
+| `range` | `boolean \| undefined` | `false` |  | Range selection: the value is a two-element `[start, end]` array. |
+| `readonly` | `boolean \| undefined` | `false` |  | Prevents opening while keeping the activator visible. |
+| `seconds` | `boolean \| undefined` | `false` |  | Adds the seconds column. |
+| `step` | `number \| undefined` | `1` |  | Minute-column granularity and arrow stepping. |
+| `transitionDuration` | `number \| undefined` | `250` |  | Popover/sheet transition duration in milliseconds. |
 
 ## Events
 

package/dist/ai/BbTimePickerInput.md

@@ -129,41 +129,41 @@ Messages _also_ render in an `aria-live="polite"` region.
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `adaptive` | `boolean \| undefined` | `undefined` |  | On mobile the time columns open inside a bottom off-canvas sheet instead of a floating popover. When unset, falls back to the global `config.adaptive`. |
-| `ampm` | `boolean \| undefined` |  |  | 12-hour display with an AM/PM segment. Purely a field-composition concern: the model stays 24-hour. Type `A`/`P` (or ArrowUp/Down) to set the meridiem. |
+| `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | On mobile the time columns open inside a bottom off-canvas sheet instead of a floating popover. When unset, falls back to the global `config.adaptive`. |
+| `ampm` | `boolean \| undefined` | `false` |  | 12-hour display with an AM/PM segment. Purely a field-composition concern: the model stays 24-hour. Type `A`/`P` (or ArrowUp/Down) to set the meridiem. |
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to be added at the end of the input. |
 | `autocomplete` | `string \| undefined` |  |  | Guides the browser as to the type of information expected in the field. |
 | `autofocus` | `Booleanish \| undefined` |  |  | Sets autofocus on page load. |
-| `clearable` | `boolean \| undefined` |  |  | Displays a clear button when the input has a value and is being interacted with. |
-| `compact` | `boolean \| undefined` |  |  | Sets the component in a compact state. |
+| `clearable` | `boolean \| undefined` | `false` |  | Displays a clear button when the input has a value and is being interacted with. |
+| `compact` | `boolean \| undefined` | `false` |  | Sets the component in a compact state. |
 | `description` | `string \| undefined` |  |  | Descriptive text displayed below the label and above the input. Always visible and linked to the input via `aria-describedby` (after any `errors` / `warnings`, before the `hint`). |
 | `direction` | `InputDirection \| undefined` |  |  | Direction of the layout of the component. Can either be a predefined value or a pattern separated by a space like `xx xxxxx`. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component. |
-| `disableWriting` | `boolean \| "mobile" \| "desktop" \| undefined` |  |  | Disables typing into the input. Use `'mobile'` / `'desktop'` to disable typing on one platform only. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component. |
+| `disableWriting` | `boolean \| "mobile" \| "desktop" \| undefined` | `false` |  | Disables typing into the input. Use `'mobile'` / `'desktop'` to disable typing on one platform only. |
 | `errors` | `string \| string[] \| undefined` |  |  | Can be a string or an array of string containing the messages to display. They render in an `aria-live="polite"` region (announced when they appear) and, while the list is non-empty, are referenced FIRST from the segment inputs' `aria-descr… |
-| `hasErrors` | `boolean \| undefined` |  |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
-| `hasWarning` | `boolean \| undefined` |  |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
-| `hideLabel` | `boolean \| undefined` |  |  | Visually hides the label of the input while maintaining accessibility. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Define if the component should be in a warning state. Same chrome as errors with `--bb-warn`; errors take priority. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Visually hides the label of the input while maintaining accessibility. |
 | `hint` | `string \| undefined` |  |  | Text box to be displayed near the input, usually to indicate instructions. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `label` | `string` |  | yes | Text content of the label of the element. |
 | `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` |  |  | Label rendering mode. |
 | `labelPosition` | `"left" \| "center" \| "right" \| undefined` |  |  | Sets the text alignment of the label. |
-| `loading` | `boolean \| undefined` |  |  | Sets the component in a loading state, usually triggering some visual styles. |
+| `loading` | `boolean \| undefined` | `false` |  | Sets the component in a loading state, usually triggering some visual styles. |
 | `max` | `string \| undefined` |  |  | Maximum selectable time in `HH:mm` format. Values outside the pattern throw during setup to surface configuration mistakes. |
 | `min` | `string \| undefined` |  |  | Minimum selectable time in `HH:mm` format. Values outside the pattern throw during setup to surface configuration mistakes. |
 | `modelValue` | `string \| string[] \| null` |  | yes | v-model value: `null` for empty, a 24-hour `HH:mm` (or `HH:mm:ss` with `seconds`) string, or a two-element array when `range` is true. |
 | `name` | `string \| undefined` |  |  | Defines the name of the input. |
 | `offCanvasProps` | `Partial<BbOffCanvasProps> \| undefined` |  |  | Extra props forwarded to the `BbOffCanvas` sheet when `adaptive` is active on mobile (e.g. `title`, `size`, `persistent`). |
-| `persistentHint` | `boolean \| undefined` |  |  | Keeps the hint displayed. |
+| `persistentHint` | `boolean \| undefined` | `false` |  | Keeps the hint displayed. |
 | `placeholder` | `string \| undefined` |  |  | String displayed when there's no data. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to be added at the start of the input. |
-| `range` | `boolean \| undefined` |  |  | Range selection: v-model expects a two-element array `[start, end]`. An inverted pair swaps on finalize with an `end_before_start` error. |
-| `readonly` | `boolean \| undefined` |  |  | Sets the input in a readonly state. |
-| `required` | `boolean \| undefined` |  |  | Sets the input as required. |
-| `reverse` | `boolean \| undefined` |  |  | Reverses the layout: the order of the label and the input is swapped. |
-| `seconds` | `boolean \| undefined` |  |  | Adds the seconds segment. Without it an incoming value carrying seconds displays truncated and zeroes out on the next user commit. |
-| `step` | `number \| undefined` |  |  | Minute granularity for the minute column and its arrow stepping. Constrains what the columns produce, never what typing accepts. |
+| `range` | `boolean \| undefined` | `false` |  | Range selection: v-model expects a two-element array `[start, end]`. An inverted pair swaps on finalize with an `end_before_start` error. |
+| `readonly` | `boolean \| undefined` | `false` |  | Sets the input in a readonly state. |
+| `required` | `boolean \| undefined` | `false` |  | Sets the input as required. |
+| `reverse` | `boolean \| undefined` | `false` |  | Reverses the layout: the order of the label and the input is swapped. |
+| `seconds` | `boolean \| undefined` | `false` |  | Adds the seconds segment. Without it an incoming value carrying seconds displays truncated and zeroes out on the next user commit. |
+| `step` | `number \| undefined` | `1` |  | Minute granularity for the minute column and its arrow stepping. Constrains what the columns produce, never what typing accepts. |
 | `transitionDuration` | `number \| undefined` |  |  | Transition duration, in milliseconds, for the popover appearance. |
 | `warnings` | `string \| string[] \| undefined` |  |  | Warning messages to display beneath the field, in their own `aria-live` region and amber (`--bb-text-warn`). A string or array; a non-empty list implies the warning state. Errors suppress warnings when both are set. While displayed they are… |
 

package/dist/ai/BbToast.md

@@ -4,7 +4,7 @@
 
 - Safety level: **Consumer API**
 - Group: **Feedback**
-- Description: Shows transient notification messages.
+- Description: Shows transient notification messages (includes the co-located BbToastPortal export).
 - Usage rule: Prefer this component for consumer-facing implementations.
 - Implementation source (only when the contract below is not enough): [source/BbToast.md](./source/BbToast.md)
 

package/dist/ai/BbToastPortal.md

@@ -24,5 +24,5 @@
 
 ## See Also
 
-- [BbToast](./BbToast.md) — Shows transient notification messages.
+- [BbToast](./BbToast.md) — Shows transient notification messages (includes the co-located BbToastPortal export).
 - [useToast](./composables/useToast.md)

package/dist/ai/BbTooltip.md

@@ -82,11 +82,13 @@ bubble (`top` by default; the `top` / `right` / `bottom` / `left` families with
 - `'default'` — the inverted (primary) bubble.
 - `'destructive'` — danger-tinted, for a warning-flavored hint.
 
-Any other string becomes a bare `bb-tooltip--<name>` class hook for a
-project-styled variant — **you supply its CSS**. Register the names you use in
-the vite plugin's `tooltipVariants` array to get type-safe autocomplete on the
-`variant` prop; unregistered strings still work as raw hooks, just without the
-suggestion.
+Registering a name in the vite plugin's `tooltipVariants` array is **not
+optional**: `variant` is typed `keyof TooltipVariantRegistry`, so out of the box
+only `default` and `destructive` compile and `variant="info"` is a type error —
+`info` and `success` being exactly the names people invent. Register the name
+(recommended) and the class hook `bb-tooltip--<name>` is interpolated at
+runtime for **your** CSS to style. For a genuine one-off, a cast forces it
+through; the class is still emitted.
 
 **Default and destructive**
 
@@ -456,15 +458,15 @@ const files: SharedFile[] = [
 | `arrowPadding` | `number \| undefined` | `10` |  | Space the arrow will maintain to the edge of the tooltip bubble. Useful when the floating element has border radius so it won't appear broken |
 | `boundary` | `ElementOrComponentRefOrSelector \| undefined` |  |  | Constrains the tooltip within a bounding element. When provided, the tooltip will not overflow this container's bounds (e.g. a sidebar). Accepts an HTMLElement, a Vue component ref, or a CSS selector string. |
 | `delay` | `number \| undefined` | `0` |  | The delay in milliseconds before the tooltip is shown. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the component |
-| `eager` | `boolean \| undefined` |  |  | Prevents rendering content before it's made visible. |
-| `hideArrow` | `boolean \| undefined` |  |  | Hides the tooltip arrow. A tooltip shows its arrow by default (it's the one popover-family surface where an arrow is meaningful — a speech bubble pointing at its anchor); set this to drop it. |
-| `id` | `string \| undefined` |  |  | The identifier of the component. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables the component |
+| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `hideArrow` | `boolean \| undefined` | `false` |  | Hides the tooltip arrow. A tooltip shows its arrow by default (it's the one popover-family surface where an arrow is meaningful — a speech bubble pointing at its anchor); set this to drop it. |
+| `id` | `string \| undefined` |  |  | Seed for the tooltip's internal id. It is **prefixed** (`bb_<id>`) and set on the inner content element, not on the root — so `document.getElementById(theIdYouPassed)` finds nothing. Pass it to make the generated id stable (SSR snapshots, t… |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to show / hide the tooltip. A tooltip with no `v-model` starts hidden and is driven by hover / focus. |
 | `padding` | `number \| undefined` | `10` |  | Minimum empty space to keep from the edge of the page |
 | `placement` | `Placement \| undefined` | `"top"` |  | Position of the overlay in respect to the related activator. |
 | `text` | `string \| undefined` |  |  | Text content of the component. |
-| `transitionDuration` | `number \| undefined` | `transitions.medium` |  | How long the transition has to last in milliseconds |
+| `transitionDuration` | `number \| undefined` | `250` |  | How long the transition has to last in milliseconds |
 | `variant` | `keyof TooltipVariantRegistry \| undefined` | `"default"` |  | Visual variant. `'default'` is the inverted (primary) bubble, `'destructive'` is the danger-tinted bubble for warnings. Any other string is applied as a `bb-tooltip--<name>` class hook. |
 | `width` | `string \| number \| undefined` |  |  | Width of the tooltip bubble in pixels, or as a percentage of the activator. |
 

package/dist/ai/BbTree.md

@@ -1033,7 +1033,7 @@ row) with that in mind.
 | `expandable` | `BbTreeExpandable<Meta> \| undefined` |  |  | Defines nodes as expandable. It can be a global boolean, or a function that receives the node, its depth, and its parent and returns a boolean. |
 | `expandedItems` | `any[] \| undefined` | `[]` |  | Live expansion state: the list of expanded node values (see `itemValue`). Branch nodes not explicitly collapsed via `expanded: false` seed the list when they first appear in `items`; from then on this model is the single source of truth. |
 | `items` | `BbTreeItem<Meta>[]` | `[]` | yes | Tree-like structure of nodes to render. |
-| `itemValue` | `ItemAccessor<Meta> \| undefined` |  |  | Identity of a node, used to hash entries of `expandedItems` and to name per-node slots. A string reads that key from `meta`; a function receives `meta` and returns the value. |
+| `itemValue` | `ItemAccessor<Meta> \| undefined` | `the whole `meta` object` |  | Identity of a node, used to hash entries of `expandedItems` and to name per-node slots. A string reads that key from `meta`; a function receives `meta` and returns the value. |
 
 ## Events
 

package/dist/ai/ChipsBox.md

@@ -12,7 +12,7 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `disabled` | `boolean \| undefined` |  |  | Whether the component is disabled. |
+| `disabled` | `boolean \| undefined` | `false` |  | Whether the component is disabled. |
 | `options` | `Option[]` |  | yes | List of options to render as chips. |
 | `size` | `"xs" \| "sm" \| "md" \| "lg" \| "xl" \| "2xl" \| undefined` |  |  | The size of the chips. |
 

package/dist/ai/CommonInputWrapper.md

@@ -12,19 +12,19 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `active` | `boolean \| undefined` |  |  | Whether the input is in active/focused state (e.g. open dropdown). |
+| `active` | `boolean \| undefined` | `false` |  | Whether the input is in active/focused state (e.g. open dropdown). |
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to be added at the end of the input. |
-| `clearable` | `boolean \| undefined` |  |  | Whether the input is clearable. |
-| `compact` | `boolean \| undefined` |  |  | Whether the input is in compact mode. |
-| `disabled` | `boolean \| undefined` |  |  | Whether the input is disabled. |
-| `hasErrors` | `boolean \| undefined` |  |  | Whether the input has validation errors. |
+| `clearable` | `boolean \| undefined` | `false` |  | Whether the input is clearable. |
+| `compact` | `boolean \| undefined` | `false` |  | Whether the input is in compact mode. |
+| `disabled` | `boolean \| undefined` | `false` |  | Whether the input is disabled. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Whether the input has validation errors. |
 | `hasValue` | `boolean \| undefined` | `undefined` |  | Whether the wrapped control currently has a value that can be cleared. |
-| `hasWarning` | `boolean \| undefined` |  |  | Whether the input has a warning state. Visually identical to `hasErrors` but uses `--bb-warn` chrome; errors take priority when both are set. |
-| `loading` | `boolean \| undefined` |  |  | Whether the input is in a loading state. |
+| `hasWarning` | `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. |
+| `loading` | `boolean \| undefined` | `false` |  | Whether the input is in a loading state. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to be added at the start of the input. |
-| `preventFocus` | `boolean \| undefined` |  |  | Prevents the wrapper from focusing the inner input on click. |
-| `readonly` | `boolean \| undefined` |  |  | Whether the input is readonly. |
-| `reserveAppendSpace` | `boolean \| undefined` |  |  | Keeps trailing action/icon space reserved even when currently empty. |
+| `preventFocus` | `boolean \| undefined` | `false` |  | Prevents the wrapper from focusing the inner input on click. |
+| `readonly` | `boolean \| undefined` | `false` |  | Whether the input is readonly. |
+| `reserveAppendSpace` | `boolean \| undefined` | `false` |  | Keeps trailing action/icon space reserved even when currently empty. |
 
 ## Events
 

package/dist/ai/CommonPopover.md

@@ -19,18 +19,18 @@
 | `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. |
 | `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 |
 | `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 … |
-| `dialog` | `boolean \| undefined` |  |  | Renders the popover as a `<dialog>` element (modal overlay) instead of a `<span>` with the Popover API. |
-| `disableFlip` | `boolean \| undefined` |  |  | Disables the automatic flip to the opposite side when the popover would overflow (flipping is on by default). |
-| `eager` | `boolean \| undefined` |  |  | Prevents rendering content before it's made visible. |
-| `forceAutoUpdate` | `boolean \| undefined` |  |  | 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 th… |
-| `hideArrow` | `boolean \| undefined` |  |  | Hides the arrow indicator. |
+| `dialog` | `boolean \| undefined` | `false` |  | Renders the popover as a `<dialog>` element (modal overlay) instead of a `<span>` with the Popover API. |
+| `disableFlip` | `boolean \| undefined` | `false` |  | Disables the automatic flip to the opposite side when the popover would overflow (flipping is on by default). |
+| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `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 th… |
+| `hideArrow` | `boolean \| undefined` | `false` |  | Hides the arrow indicator. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to show / hide the bubble. Closed until the owning component opens it. |
 | `offset` | `number \| undefined` |  |  | Space the floating container will maintain from the activator. |
 | `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 av… |
 | `padding` | `number \| undefined` | `0` |  | Minimum empty space to keep from the edge of the page |
 | `placement` | `Placement \| undefined` |  |  | Position of the overlay in respect to the related activator. |
 | `tag` | `PopoverTag \| undefined` | `"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 h… |
-| `transitionDuration` | `number \| undefined` | `transitions.medium` |  | How long the transition has to last in milliseconds |
+| `transitionDuration` | `number \| undefined` | `250` |  | How long the transition has to last in milliseconds |
 
 ## Events