bitboss-ui 3.0.0-beta.15 → 3.0.0-beta.19

package/README.md

@@ -6,7 +6,7 @@ Vue 3 component library used across BitBoss products. It ships typed building bl
 
 ## What’s in the package
 
-Published artifacts are **`dist/`** (ESM JavaScript, `.d.ts`, the two stylesheets **`styles.css`** and **`reset.css`**, and the `dist/ai/` knowledge base), plus the **`bin/`** CLI, **`scripts/lib/`** (ESLint plugin and markup validator), the root **`llms.txt`**, and this **README**. The sections below match how the library is organised in code and in the [documentation](https://ui-components-docs.vercel.app/).
+Published artifacts are **`dist/`** (ESM JavaScript, `.d.ts`, the two stylesheets **`styles.css`** and **`reset.css`**, and the `dist/ai/` knowledge base), plus the **`bin/`** CLI, **`scripts/lib/`** (ESLint plugin and markup validator), the root **`llms.txt`**, and this **README**. The sections below match how the library is organised in code and in the [documentation](https://ui-components.bitboss.it/).
 
 ### Styles
 
@@ -90,7 +90,7 @@ For the public **Bb\*** components, the package exports matching **props**, **ev
 
 **Primary docs (components, props, guides):**
 
-- [BitBoss UI documentation](https://ui-components-docs.vercel.app/) — site with guides and API reference.
+- [BitBoss UI documentation](https://ui-components.bitboss.it/) — site with guides and API reference.
 
 **For AI coding agents:**
 
@@ -100,10 +100,10 @@ v3 prerelease; pin an exact version (`bitboss-ui@3.0.0-alpha.5`) for stable
 links. Sizes grow with the catalogue — treat them as the current order of
 magnitude, not a contract.
 
-- [Core knowledge base](https://cdn.jsdelivr.net/npm/bitboss-ui@alpha/dist/llms-medium.txt) (~110 KB) — **start here if you can only fetch one file.** Hard rules, setup, component picker, design language, and the full component catalogue.
-- [Index](https://cdn.jsdelivr.net/npm/bitboss-ui@alpha/llms.txt) (~19 KB) — link index into every document.
-- [components.json](https://cdn.jsdelivr.net/npm/bitboss-ui@alpha/dist/ai/components.json) — machine-readable API surface, for programmatic validation.
-- [Complete knowledge base](https://cdn.jsdelivr.net/npm/bitboss-ui@alpha/dist/llms-full.txt) (~3.2 MB) — everything concatenated. Bulk ingestion only; too large to prompt with.
+- [Core knowledge base](https://llms-bitboss-ui.bitboss.it/dist/llms-medium.txt) (~110 KB) — **start here if you can only fetch one file.** Hard rules, setup, component picker, design language, and the full component catalogue.
+- [Index](https://llms-bitboss-ui.bitboss.it/llms.txt) (~19 KB) — link index into every document.
+- [components.json](https://llms-bitboss-ui.bitboss.it/dist/ai/components.json) — machine-readable API surface, for programmatic validation.
+- [Complete knowledge base](https://llms-bitboss-ui.bitboss.it/dist/llms-full.txt) (~3.2 MB) — everything concatenated. Bulk ingestion only; too large to prompt with.
 
 Already installed? Prefer the local copy under `node_modules/bitboss-ui/dist/ai/`,
 run `npx bitboss-ui ai-init` to write agent pointers, and
@@ -328,6 +328,38 @@ migrations — a value that must move to a slot, directive, or CSS — are repor
 with a migration-guide link but left for you. Run `eslint --fix`, then the
 remaining reports are exactly the by-hand cases.
 
+#### The one v2 break a codemod cannot own: `reverse`
+
+`reverse` on `BbCheckbox` / `BbRadio` / `BbSwitch` kept its **name** and
+inverted its **meaning** in v3. Both versions render the same default layout,
+so only explicit values moved:
+
+| v2                            | v3        |
+| ----------------------------- | --------- |
+| `:reverse="false"`            | `reverse` |
+| `reverse` / `:reverse="true"` | delete it |
+
+That is invisible to every other check — `:reverse="false"` is a declared prop,
+correctly typed, holding its own default value — and it cannot go in the
+rename table above, because the table is keyed by prop _name_: an entry for
+`reverse` would rewrite the legitimate v3 spellings too.
+
+So it has its own rule, `bitboss-ui/no-reverse-false` (in `recommended`). It
+flags only a **literal** `:reverse="false"` and offers both corrections as
+editor suggestions — a dynamic `:reverse="isRtl"` that merely evaluates false
+is left alone. For a bulk sweep of a v2 codebase, opt into the fix:
+
+```js
+{
+	rules: {
+		'bitboss-ui/no-reverse-false': ['error', { assumeV2: true }],
+	},
+}
+```
+
+`assumeV2` is off by default because the two readings produce opposite
+layouts — turn it on only for files you know came from v2, then turn it off.
+
 Every real HTML attribute (plus `aria-*` / `data-*`) falls through untouched, so
 attribute inheritance is never flagged. Escape hatches when you do need one:
 
@@ -406,7 +438,7 @@ MIT — see [`LICENSE`](LICENSE).
 
 ## Support
 
-- **Usage and APIs:** see the [documentation](https://ui-components-docs.vercel.app/).
+- **Usage and APIs:** see the [documentation](https://ui-components.bitboss.it/).
 - **Company / licensing / commercial:** [BitBoss](https://www.bitboss.it/).
 
 ### Reporting a bug

package/dist/ai/BbAccordion.md

@@ -529,7 +529,7 @@ is generated for you.
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `eager` | `boolean \| undefined` |  |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
 | `id` | `string \| undefined` |  |  | The identifier of the component. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to trigger opening / closing the collapsible. An accordion with no `v-model` starts closed. |
 | `transitionDuration` | `number \| undefined` | `250` |  | How long the transition has to last in milliseconds |

package/dist/ai/BbAlert.md

@@ -396,7 +396,7 @@ const publish = () => {
 | --- | --- | --- | --- | --- |
 | `ariaLive` | `"off" \| "polite" \| "assertive" \| undefined` |  |  | ARIA live region politeness. Defaults to `'assertive'` for destructive/warning variants, otherwise `'polite'`. |
 | `closeLabel` | `string \| undefined` |  |  | Visually hidden string used to label the close button. |
-| `hideClose` | `boolean \| undefined` |  |  | Defines whether to hide the close button. |
+| `hideClose` | `boolean \| undefined` | `false` |  | Defines whether to hide the close button. |
 | `icon` | `string \| undefined` |  |  | Name of a registered icon to use, or a full raw `<svg>` string (e.g. an SVG file imported with `?raw`). |
 | `iconSize` | `number \| ({ size?: any; } & string) \| keyof Sizes \| undefined` | `"16"` |  | Size of the icon to use. |
 | `modelValue` | `any` | `true` |  | Used by v-model, set type to any to avoid Vue casting it as false. Alerts are visible on mount; the model dismisses them. |

package/dist/ai/BbBadge.md

@@ -714,10 +714,10 @@ selectors like `.bb-badge > .bb-badge__content`, which no longer match.
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
 | `append:icon` | `string \| undefined` |  |  | Icon rendered after the label. On a `clearable` badge it shares the trailing slot with the clear button: the icon shows at rest and the clear button reveals over it on hover/focus. |
-| `clearable` | `boolean \| undefined` |  |  | Renders a trailing clear button and emits `click:clear` when pressed — turns the badge into a dismissible token (the pattern formerly served by `BbChip`). |
+| `clearable` | `boolean \| undefined` | `false` |  | Renders a trailing clear button and emits `click:clear` when pressed — turns the badge into a dismissible token (the pattern formerly served by `BbChip`). |
 | `clearableLabel` | `string \| undefined` |  |  | Accessible label for the clear button. Rarely needed: unset, the name is **composed** from the localized `badge.clearLabel` verb and the badge's own text — "Remove Italy", not a bare "Remove" — which is already the right name in almost ever… |
 | `icon` | `string \| undefined` |  |  | Renders an icon-only badge. When set, `prepend:icon` / `append:icon` are ignored and the default slot becomes the badge's visually hidden accessible label — always provide it. |
-| `loading` | `boolean \| undefined` |  |  | Shows a spinner in place of the leftmost icon, mirroring `BbButton`: it replaces the `icon` glyph or the `prepend:icon` when one is set; when the `append:icon` is the sole icon it replaces that instead (e.g. a select-activator chevron while… |
+| `loading` | `boolean \| undefined` | `false` |  | Shows a spinner in place of the leftmost icon, mirroring `BbButton`: it replaces the `icon` glyph or the `prepend:icon` when one is set; when the `append:icon` is the sole icon it replaces that instead (e.g. a select-activator chevron while… |
 | `prepend:icon` | `string \| undefined` |  |  | Icon rendered before the label. |
 | `size` | `keyof Sizes \| undefined` | `"md"` |  | Preset size of the badge. |
 | `variant` | `keyof BadgeVariantRegistry \| undefined` | `"primary"` |  | Visual variant: `primary`, `secondary`, `destructive`, or `outline`. Register more via the vite plugin `badgeVariants` option and style `.bb-badge--<variant>` (set `--bg` / `--color`). |

package/dist/ai/BbBadgeButton.md

@@ -12,21 +12,21 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `activeClass` | `string \| undefined` |  |  | CSS class applied when the component renders as a link and the target of the link is the current route or the url matches partially. Ported for Inertia compatibility. |
-| `ariaCurrentValue` | `"page" \| "step" \| "location" \| "date" \| "time" \| "true" \| "false" \| undefined` |  |  | Value forwarded to the `aria-current` attribute when the component renders as a router link and the target route is an exact match. Use to communicate the current location to assistive technologies. |
-| `async` | `boolean \| undefined` |  |  | Inertia: runs the visit without blocking — the page stays interactive and several async visits can be in flight at once. |
+| `activeClass` | `string \| undefined` | `'router-link-active'` |  | CSS class applied when the component renders as a link and the target of the link is the current route or the url matches partially. Ported for Inertia compatibility. |
+| `ariaCurrentValue` | `"page" \| "step" \| "location" \| "date" \| "time" \| "true" \| "false" \| undefined` | `'page'` |  | Value forwarded to the `aria-current` attribute when the component renders as a router link and the target route is an exact match. Use to communicate the current location to assistive technologies. |
+| `async` | `boolean \| undefined` | `false` |  | Inertia: runs the visit without blocking — the page stays interactive and several async visits can be in flight at once. |
 | `cacheFor` | `string \| number \| (string \| number)[] \| undefined` |  |  | Inertia: how long a prefetched response stays fresh before it is re-fetched. A single duration, or `[staleAfter, expiresAfter]`. Typed platform-agnostically (matching BbButton) so the library's types never require `@inertiajs/vue3` to be in… |
 | `cacheTags` | `string \| string[] \| undefined` |  |  | Inertia: tags to file this visit's prefetch cache under, so a later request can invalidate the whole tagged group. |
 | `component` | `string \| undefined` |  |  | Inertia: the page component this visit resolves to. Rarely set by hand — the server normally decides it. |
 | `data` | `object \| undefined` |  |  | Request payload forwarded to Inertia when navigating via `href` in an Inertia-enabled app. Ignored when not using Inertia. |
-| `disabled` | `boolean \| undefined` |  |  | Disables user interaction. - When rendering as a native button, sets the `disabled` attribute. - When rendering as a link (anchor/Inertia), removes `href`, adds `aria-disabled="true"`, and prevents navigation while keeping focusable semanti… |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables user interaction. - When rendering as a native button, sets the `disabled` attribute. - When rendering as a link (anchor/Inertia), removes `href`, adds `aria-disabled="true"`, and prevents navigation while keeping focusable semanti… |
 | `download` | `string \| boolean \| undefined` |  |  | Marks an `href` link as a download. Renders a plain `<a download>` doing a native navigation — never an Inertia/router visit — so file downloads (including same-origin, `blob:` and `data:` URLs) work. Pass a string to set the suggested file… |
-| `exactActiveClass` | `string \| undefined` |  |  | CSS class applied when the component renders as a link and the target of the link and the url matches exactly. Ported for Inertia compatibility. |
+| `exactActiveClass` | `string \| undefined` | `'router-link-exact-active'` |  | CSS class applied when the component renders as a link and the target of the link and the url matches exactly. Ported for Inertia compatibility. |
 | `except` | `string[] \| undefined` |  |  | Inertia: the inverse of `only` — properties to EXCLUDE from a partial reload. Pass one or the other, not both. |
-| `external` | `boolean \| undefined` |  |  | Forces an `href` link to render as a plain `<a>` (native navigation), bypassing Inertia/router interception — the same intent as Nuxt's `NuxtLink` `external`. Use for links outside the SPA. One of the native-anchor signals alongside `target… |
+| `external` | `boolean \| undefined` | `false` |  | Forces an `href` link to render as a plain `<a>` (native navigation), bypassing Inertia/router interception — the same intent as Nuxt's `NuxtLink` `external`. Use for links outside the SPA. One of the native-anchor signals alongside `target… |
 | `headers` | `object \| undefined` |  |  | Additional HTTP headers forwarded to Inertia when navigating via `href` in an Inertia-enabled app. |
 | `href` | `string \| undefined` |  |  | Hyperlink reference used when rendering as an anchor (or as an Inertia link in Inertia-enabled apps). If provided and not disabled, the component renders as an anchor/Inertia link. |
-| `instant` | `boolean \| undefined` |  |  | Inertia: navigate optimistically on click and reconcile when the response lands, instead of waiting for the round trip. |
+| `instant` | `boolean \| undefined` | `false` |  | Inertia: navigate optimistically on click and reconcile when the response lands, instead of waiting for the round trip. |
 | `method` | `"get" \| "post" \| "put" \| "patch" \| "delete" \| undefined` |  |  | HTTP method used for Inertia navigation when `href` is provided in an Inertia-enabled app. Ignored otherwise. |
 | `onBefore` | `(() => void) \| undefined` |  |  | Lifecycle hook invoked by Inertia right before the request is sent. |
 | `onCancel` | `(() => void) \| undefined` |  |  | Lifecycle hook invoked by Inertia when a request is cancelled. |
@@ -41,17 +41,17 @@
 | `onSuccess` | `(() => void) \| undefined` |  |  | Lifecycle hook invoked by Inertia when a request succeeds. |
 | `pageProps` | `Record<string, unknown> \| ((currentProps: Record<string, unknown>, sharedProps: Record<string, unknown>) => Record<string, unknown>) \| null \| undefined` |  |  | Inertia: props to merge into the next page optimistically, before the server responds. Either an object or a function of the current props. Typed platform-agnostically (matching BbButton) so the library's types never require `@inertiajs/vue… |
 | `prefetch` | `string \| boolean \| string[] \| undefined` |  |  | Inertia: fetch and cache this link's page ahead of the click. `true` uses the default trigger; a string or list of strings picks them (`'mount'`, `'hover'`, `'click'`). |
-| `preserveScroll` | `boolean \| ((props: Record<string, unknown>) => boolean) \| undefined` |  |  | Controls whether Inertia should preserve the current scroll position after navigation. Can be a boolean or a predicate receiving the visit props. |
-| `preserveState` | `boolean \| ((props: Record<string, unknown>) => boolean) \| null \| undefined` |  |  | Controls whether Inertia should preserve the current state after navigation. Can be a boolean or a predicate receiving the visit props. |
-| `preserveUrl` | `boolean \| undefined` |  |  | Inertia: keep the current URL in the address bar even though the page content changes. |
-| `queryStringArrayFormat` | `"brackets" \| "indices" \| undefined` |  |  | Format to use when serializing array values into the query string for Inertia requests. |
+| `preserveScroll` | `boolean \| ((props: Record<string, unknown>) => boolean) \| undefined` | `false` |  | Controls whether Inertia should preserve the current scroll position after navigation. Can be a boolean or a predicate receiving the visit props. |
+| `preserveState` | `boolean \| ((props: Record<string, unknown>) => boolean) \| null \| undefined` | `false` |  | Controls whether Inertia should preserve the current state after navigation. Can be a boolean or a predicate receiving the visit props. |
+| `preserveUrl` | `boolean \| undefined` | `false` |  | Inertia: keep the current URL in the address bar even though the page content changes. |
+| `queryStringArrayFormat` | `"brackets" \| "indices" \| undefined` | `'brackets'` |  | Format to use when serializing array values into the query string for Inertia requests. |
 | `rel` | `string \| undefined` |  |  | Relationship between the current document and the linked resource. Useful for security when opening new tabs (e.g. `noopener noreferrer`). |
-| `replace` | `boolean \| undefined` |  |  | Uses history replacement instead of push navigation. - With Vue Router (`to`), calls `router.replace`. - With Inertia (`href`), performs a replace visit. |
-| `tag` | `ButtonTag \| undefined` |  |  | Element to render for the plain (non-link, non-router) button: - `'button'` (default) — real button semantics and keyboard behavior - `'div'` / `'span'` — a clickable box nested inside another button or link, where a nested `<button>` would… |
+| `replace` | `boolean \| undefined` | `false` |  | Uses history replacement instead of push navigation. - With Vue Router (`to`), calls `router.replace`. - With Inertia (`href`), performs a replace visit. |
+| `tag` | `ButtonTag \| undefined` | `'button'` |  | Element to render for the plain (non-link, non-router) button: - `'button'` (default) — real button semantics and keyboard behavior - `'div'` / `'span'` — a clickable box nested inside another button or link, where a nested `<button>` would… |
 | `target` | `string \| undefined` |  |  | Target browsing context for anchor/Inertia links (e.g. `_self`, `_blank`). Ignored when rendering as a native button. |
 | `to` | `string \| wt \| bt \| undefined` |  |  | Route location to navigate to. When provided (and not disabled), the component renders as a Vue Router link. |
-| `type` | `"button" \| "submit" \| "reset" \| undefined` |  |  | Native `type` attribute used when rendering as a button (e.g. `button`, `submit`, `reset`). |
-| `viewTransition` | `boolean \| undefined` |  |  | Inertia: run the page swap inside a View Transition, where the browser supports one. |
+| `type` | `"button" \| "submit" \| "reset" \| undefined` | `'button'` |  | Native `type` attribute used when rendering as a button (e.g. `button`, `submit`, `reset`). |
+| `viewTransition` | `boolean \| undefined` | `false` |  | Inertia: run the page swap inside a View Transition, where the browser supports one. |
 
 ## Events
 

package/dist/ai/BbBaseButton.md

@@ -455,22 +455,22 @@ const sent = ref(false);
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `activeClass` | `string \| undefined` |  |  | CSS class applied when the component renders as a link and the target of the link is the current route or the url matches partially. Ported for Inertia compatibility. |
-| `ariaCurrentValue` | `"page" \| "step" \| "location" \| "date" \| "time" \| "true" \| "false" \| undefined` |  |  | Value forwarded to the `aria-current` attribute when the component renders as a router link and the target route is an exact match. Use to communicate the current location to assistive technologies. |
-| `async` | `boolean \| undefined` |  |  | Inertia: runs the visit without blocking — the page stays interactive and several async visits can be in flight at once. |
-| `block` | `boolean \| undefined` |  |  | Makes the component take the full available width (block-level layout). Adds the `bb-base-button--block` modifier class. |
+| `activeClass` | `string \| undefined` | `'router-link-active'` |  | CSS class applied when the component renders as a link and the target of the link is the current route or the url matches partially. Ported for Inertia compatibility. |
+| `ariaCurrentValue` | `"page" \| "step" \| "location" \| "date" \| "time" \| "true" \| "false" \| undefined` | `'page'` |  | Value forwarded to the `aria-current` attribute when the component renders as a router link and the target route is an exact match. Use to communicate the current location to assistive technologies. |
+| `async` | `boolean \| undefined` | `false` |  | Inertia: runs the visit without blocking — the page stays interactive and several async visits can be in flight at once. |
+| `block` | `boolean \| undefined` | `false` |  | Makes the component take the full available width (block-level layout). Adds the `bb-base-button--block` modifier class. |
 | `cacheFor` | `string \| number \| (string \| number)[] \| undefined` |  |  | Inertia: how long a prefetched response stays fresh before it is re-fetched. A single duration, or `[staleAfter, expiresAfter]`. Typed platform-agnostically (matching BbButton) so the library's types never require `@inertiajs/vue3` to be in… |
 | `cacheTags` | `string \| string[] \| undefined` |  |  | Inertia: tags to file this visit's prefetch cache under, so a later request can invalidate the whole tagged group. |
 | `component` | `string \| undefined` |  |  | Inertia: the page component this visit resolves to. Rarely set by hand — the server normally decides it. |
 | `data` | `object \| undefined` |  |  | Request payload forwarded to Inertia when navigating via `href` in an Inertia-enabled app. Ignored when not using Inertia. |
-| `disabled` | `boolean \| undefined` |  |  | Disables user interaction. - When rendering as a native button, sets the `disabled` attribute. - When rendering as a link (anchor/Inertia), removes `href`, adds `aria-disabled="true"`, and prevents navigation while keeping focusable semanti… |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables user interaction. - When rendering as a native button, sets the `disabled` attribute. - When rendering as a link (anchor/Inertia), removes `href`, adds `aria-disabled="true"`, and prevents navigation while keeping focusable semanti… |
 | `download` | `string \| boolean \| undefined` |  |  | Marks an `href` link as a download. Renders a plain `<a download>` doing a native navigation — never an Inertia/router visit — so file downloads (including same-origin, `blob:` and `data:` URLs) work. Pass a string to set the suggested file… |
-| `exactActiveClass` | `string \| undefined` |  |  | CSS class applied when the component renders as a link and the target of the link and the url matches exactly. Ported for Inertia compatibility. |
+| `exactActiveClass` | `string \| undefined` | `'router-link-exact-active'` |  | CSS class applied when the component renders as a link and the target of the link and the url matches exactly. Ported for Inertia compatibility. |
 | `except` | `string[] \| undefined` |  |  | Inertia: the inverse of `only` — properties to EXCLUDE from a partial reload. Pass one or the other, not both. |
-| `external` | `boolean \| undefined` |  |  | Forces an `href` link to render as a plain `<a>` (native navigation), bypassing Inertia/router interception — the same intent as Nuxt's `NuxtLink` `external`. Use for links outside the SPA. One of the native-anchor signals alongside `target… |
+| `external` | `boolean \| undefined` | `false` |  | Forces an `href` link to render as a plain `<a>` (native navigation), bypassing Inertia/router interception — the same intent as Nuxt's `NuxtLink` `external`. Use for links outside the SPA. One of the native-anchor signals alongside `target… |
 | `headers` | `object \| undefined` |  |  | Additional HTTP headers forwarded to Inertia when navigating via `href` in an Inertia-enabled app. |
 | `href` | `string \| undefined` |  |  | Hyperlink reference used when rendering as an anchor (or as an Inertia link in Inertia-enabled apps). If provided and not disabled, the component renders as an anchor/Inertia link. |
-| `instant` | `boolean \| undefined` |  |  | Inertia: navigate optimistically on click and reconcile when the response lands, instead of waiting for the round trip. |
+| `instant` | `boolean \| undefined` | `false` |  | Inertia: navigate optimistically on click and reconcile when the response lands, instead of waiting for the round trip. |
 | `method` | `"get" \| "post" \| "put" \| "patch" \| "delete" \| undefined` |  |  | HTTP method used for Inertia navigation when `href` is provided in an Inertia-enabled app. Ignored otherwise. |
 | `onBefore` | `(() => void) \| undefined` |  |  | Lifecycle hook invoked by Inertia right before the request is sent. |
 | `onCancel` | `(() => void) \| undefined` |  |  | Lifecycle hook invoked by Inertia when a request is cancelled. |
@@ -485,18 +485,18 @@ const sent = ref(false);
 | `onSuccess` | `(() => void) \| undefined` |  |  | Lifecycle hook invoked by Inertia when a request succeeds. |
 | `pageProps` | `Record<string, unknown> \| ((currentProps: Record<string, unknown>, sharedProps: Record<string, unknown>) => Record<string, unknown>) \| null \| undefined` |  |  | Inertia: props to merge into the next page optimistically, before the server responds. Either an object or a function of the current props. Typed platform-agnostically (matching BbButton) so the library's types never require `@inertiajs/vue… |
 | `prefetch` | `string \| boolean \| string[] \| undefined` |  |  | Inertia: fetch and cache this link's page ahead of the click. `true` uses the default trigger; a string or list of strings picks them (`'mount'`, `'hover'`, `'click'`). |
-| `preserveScroll` | `boolean \| ((props: Record<string, unknown>) => boolean) \| undefined` |  |  | Controls whether Inertia should preserve the current scroll position after navigation. Can be a boolean or a predicate receiving the visit props. |
-| `preserveState` | `boolean \| ((props: Record<string, unknown>) => boolean) \| null \| undefined` |  |  | Controls whether Inertia should preserve the current state after navigation. Can be a boolean or a predicate receiving the visit props. |
-| `preserveUrl` | `boolean \| undefined` |  |  | Inertia: keep the current URL in the address bar even though the page content changes. |
-| `queryStringArrayFormat` | `"brackets" \| "indices" \| undefined` |  |  | Format to use when serializing array values into the query string for Inertia requests. |
+| `preserveScroll` | `boolean \| ((props: Record<string, unknown>) => boolean) \| undefined` | `false` |  | Controls whether Inertia should preserve the current scroll position after navigation. Can be a boolean or a predicate receiving the visit props. |
+| `preserveState` | `boolean \| ((props: Record<string, unknown>) => boolean) \| null \| undefined` | `false` |  | Controls whether Inertia should preserve the current state after navigation. Can be a boolean or a predicate receiving the visit props. |
+| `preserveUrl` | `boolean \| undefined` | `false` |  | Inertia: keep the current URL in the address bar even though the page content changes. |
+| `queryStringArrayFormat` | `"brackets" \| "indices" \| undefined` | `'brackets'` |  | Format to use when serializing array values into the query string for Inertia requests. |
 | `rel` | `string \| undefined` |  |  | Relationship between the current document and the linked resource. Useful for security when opening new tabs (e.g. `noopener noreferrer`). |
-| `replace` | `boolean \| undefined` |  |  | Uses history replacement instead of push navigation. - With Vue Router (`to`), calls `router.replace`. - With Inertia (`href`), performs a replace visit. |
-| `tag` | `ButtonTag \| undefined` |  |  | Element to render for the plain (non-link, non-router) button: - `'button'` (default) — real button semantics and keyboard behavior - `'div'` / `'span'` — a clickable box nested inside another button or link, where a nested `<button>` would… |
+| `replace` | `boolean \| undefined` | `false` |  | Uses history replacement instead of push navigation. - With Vue Router (`to`), calls `router.replace`. - With Inertia (`href`), performs a replace visit. |
+| `tag` | `ButtonTag \| undefined` | `'button'` |  | Element to render for the plain (non-link, non-router) button: - `'button'` (default) — real button semantics and keyboard behavior - `'div'` / `'span'` — a clickable box nested inside another button or link, where a nested `<button>` would… |
 | `target` | `string \| undefined` |  |  | Target browsing context for anchor/Inertia links (e.g. `_self`, `_blank`). Ignored when rendering as a native button. |
 | `text` | `string \| undefined` |  |  | Fallback text content rendered when no default slot is provided. |
 | `to` | `string \| wt \| bt \| undefined` |  |  | Route location to navigate to. When provided (and not disabled), the component renders as a Vue Router link. |
 | `type` | `"button" \| "submit" \| "reset" \| undefined` | `"button"` |  | Native `type` attribute used when rendering as a button (e.g. `button`, `submit`, `reset`). |
-| `viewTransition` | `boolean \| undefined` |  |  | Inertia: run the page swap inside a View Transition, where the browser supports one. |
+| `viewTransition` | `boolean \| undefined` | `false` |  | Inertia: run the page swap inside a View Transition, where the browser supports one. |
 
 ## Events
 

package/dist/ai/BbBaseCheckbox.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

package/dist/ai/BbBaseCheckboxGroup.md

@@ -17,27 +17,27 @@
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
 | `ariaDescribedby` | `string \| undefined` |  |  | ID of the element that describes the entire checkbox group for assistive technologies. Forwarded to each generated input as `aria-describedby`. |
-| `autofocus` | `Booleanish \| undefined` |  |  | Automatically focuses the first checkbox on mount when true. Applied only to the first option. |
-| `dependencies` | `unknown[] \| undefined` |  |  | List of reactive values which, when changed, trigger items re-fetching. Useful to reload options based on external inputs. |
+| `autofocus` | `Booleanish \| undefined` | `false` |  | Automatically focuses the first checkbox on mount when true. Applied only to the first option. |
+| `dependencies` | `unknown[] \| undefined` | `[]` |  | List of reactive values which, when changed, trigger items re-fetching. Useful to reload options based on external inputs. |
 | `depsDebounceTime` | `number \| undefined` | `0` |  | Debounce delay (ms) applied when reacting to `dependencies` changes. |
 | `direction` | `"horizontal" \| "vertical" \| undefined` | `"horizontal"` |  | Direction of the group layout. - `horizontal`: options flow in rows - `vertical`: options stack in a column |
-| `disabled` | `boolean \| undefined` |  |  | Disables interaction for the whole group. |
-| `enforceCoherence` | `boolean \| undefined` |  |  | Enforces that `modelValue` contains only values present in `items`. Incoherent values are removed and `update:modelValue` is emitted with a coherent array. Please check out {@link https://ui-components-docs.vercel.app/it/guides/coherence th… |
-| `hasErrors` | `boolean \| undefined` |  |  | Puts the component into an error state adds the error styling class. |
-| `hasWarning` | `boolean \| undefined` |  |  | Puts the component into a warning state. Errors take priority when both are set. |
-| `hideLabel` | `boolean \| undefined` |  |  | Visually hides each option's label text (the text rendered next to every input) while keeping it accessible to screen readers. |
+| `disabled` | `boolean \| undefined` | `false` |  | Disables interaction for the whole group. |
+| `enforceCoherence` | `boolean \| undefined` | `false` |  | Enforces that `modelValue` contains only values present in `items`. Incoherent values are removed and `update:modelValue` is emitted with a coherent array. Please check out {@link https://ui-components.bitboss.it/it/guides/coherence the doc… |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Puts the component into an error state adds the error styling class. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Puts the component into a warning state. Errors take priority when both are set. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Visually hides each option's label text (the text rendered next to every input) while keeping it accessible to screen readers. |
 | `id` | `string \| undefined` |  |  | Identifier of the group. Used to derive per-option IDs for accessible labeling. |
 | `items` | `T[] \| ((prefill: boolean, modelValue?: any) => T[] \| Promise<T[]>)` | `[]` | yes | Items provider. Can be: - An array of items - A sync/async function `(prefill, modelValue) => items` When a function is provided, it is invoked on prefill and when dependencies change to load options dynamically. |
-| `itemText` | `(T extends object ? string \| ((item: T) => string) : (item: T) => string) \| undefined` |  |  | Defines how to derive the display text from an item. Accepts a nested key path into the item or a function `(item) => string`. |
-| `itemValue` | `(T extends object ? string \| ((item: T) => string) : (item: T) => any) \| undefined` |  |  | Defines how to derive the value from an item. Accepts a nested key path into the item or a function `(item) => any`. |
-| `loadingText` | `string \| undefined` |  |  | Text displayed while items are loading. |
+| `itemText` | `(T extends object ? string \| ((item: T) => string) : (item: T) => string) \| undefined` | `JSON.stringify(item)` |  | Defines how to derive the display text from an item. Accepts a nested key path into the item or a function `(item) => string`. |
+| `itemValue` | `(T extends object ? string \| ((item: T) => string) : (item: T) => any) \| undefined` | `JSON.stringify(item)` |  | Defines how to derive the value from an item. Accepts a nested key path into the item or a function `(item) => any`. |
+| `loadingText` | `string \| undefined` | `'Loading...'` |  | Text displayed while items are loading. |
 | `max` | `number \| undefined` | `Infinity` |  | Maximum number of selectable items. |
 | `modelValue` | `any` |  | yes | Selected values for the group. Used with `v-model`. Single value when `multiple` is false, array when `multiple` is true. |
 | `modelValueDebounceTime` | `number \| undefined` | `0` |  | Debounce delay (ms) applied when reacting to `modelValue` changes. |
 | `multiple` | `boolean \| undefined` | `true` |  | Enables multi-selection behavior. When `true`, `modelValue` must be an array and emitted updates are arrays. When `false`, `modelValue` must be a single value (or `null`) and emitted updates are single values. |
 | `name` | `string \| undefined` |  |  | Name attribute applied to each input for form submission. |
-| `noDataText` | `string \| undefined` |  |  | Text displayed when there are no items to show. |
-| `readonly` | `boolean \| undefined` |  |  | Makes all checkboxes read-only. Since checkboxes do not support native `readonly`, inputs are disabled while styled as read-only. |
+| `noDataText` | `string \| undefined` | `'No data to display'` |  | Text displayed when there are no items to show. |
+| `readonly` | `boolean \| undefined` | `false` |  | Makes all checkboxes read-only. Since checkboxes do not support native `readonly`, inputs are disabled while styled as read-only. |
 | `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/BbBaseCheckboxIcon.md

@@ -169,13 +169,13 @@ from an ancestor — so `--size` set on a wrapper `div` is simply ignored
 
 | 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