bitboss-ui 3.0.0-beta.22 → 3.0.0-beta.23

package/dist/ai/BbBaseColorInput.md

@@ -38,6 +38,7 @@
 | `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` | `250` |  | Transition duration (ms) of the palette popover. Forwarded to `BbColorPalette`, which supplies the default. |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbBaseDatePickerInput.md

@@ -51,6 +51,7 @@
 | `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` | `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… |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbBaseNumberInput.md

@@ -37,6 +37,7 @@
 | `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. |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbBaseSelect.md

@@ -59,6 +59,7 @@
 | `selectedLabelsFn` | `((count: number) => string) \| undefined` |  |  | Function to generate a summary label when selected items exceed `maxSelectedLabels` or overflow the control width. |
 | `stash` | `boolean \| undefined` | `false` |  | Accumulate selected items across searches. |
 | `transitionDuration` | `number \| undefined` | `250` |  | Transition duration (ms) for dropdown animations. Forwarded to `BbSelectPopover`, which supplies the default. |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbBaseTag.md

@@ -37,6 +37,7 @@
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to render at the left hand side of the input. |
 | `readonly` | `boolean \| undefined` | `false` |  | Make the input read-only while keeping tags visible. |
 | `required` | `boolean \| undefined` | `false` |  | Mark the input as required for form validation. |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbBaseTextInput.md

@@ -27,7 +27,7 @@
 | `hasErrors` | `boolean \| undefined` | `false` |  | Apply error styling to the input and set `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. |
-| `inputMode` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "none" \| "numeric" \| "decimal" \| undefined` |  |  | Input mode hint for mobile keyboards. |
+| `inputMode` | `"text" \| "none" \| "search" \| "email" \| "url" \| "tel" \| "numeric" \| "decimal" \| undefined` |  |  | Input mode hint for mobile keyboards. |
 | `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` |  |  | Label rendering mode, forwarded by wrapper components. |
 | `loading` | `boolean \| undefined` | `false` |  | Display the loading state styles. |
 | `mask` | `MaskInputOptions \| undefined` |  |  | Input mask configuration. When provided, enables formatted input with validation. |
@@ -42,6 +42,7 @@
 | `required` | `boolean \| undefined` | `false` |  | Mark the input as required for form validation. |
 | `step` | `string \| undefined` |  |  | Stepping interval for numeric and date inputs. |
 | `type` | `"text" \| "search" \| "email" \| "url" \| "tel" \| "password" \| undefined` | `"text"` |  | HTML input type attribute. Restricted to the textual input types this component supports — use `BbNumberInput` for numbers and `BbDatePickerInput` for dates. |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbBaseTextarea.md

@@ -35,6 +35,7 @@
 | `readonly` | `boolean \| undefined` | `false` |  | Make the textarea read-only while keeping it visible. |
 | `required` | `boolean \| undefined` | `false` |  | Mark the textarea as required for form validation. |
 | `rows` | `string \| number \| undefined` |  |  | Number of visible rows. Without `autoGrow` this is the fixed height; with `autoGrow` it becomes the minimum-height floor the field grows past but never shrinks below. |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbBaseTimePickerInput.md

@@ -43,6 +43,7 @@
 | `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. |
+| `variant` | `InputVariantType \| undefined` |  |  | Visual variant of the field box, forwarded to `CommonInputWrapper`. |
 
 ## Events
 

package/dist/ai/BbColorInput.md

@@ -444,6 +444,19 @@ const form = useForm({ brandColor: '#4f46e5' });
 </template>
 ```
 
+### Variants
+
+`variant` picks the field box's look and nothing else — height, padding and
+border width are identical across variants. `outline` (default) is the raised
+panel with the neutral border, `secondary` a soft tinted surface with a faint
+border, and `ghost` draws **no border in any state**: a hover wash is the
+affordance, the focus ring still shows, and errors or warnings surface through
+the icon and the message rather than a tinted edge. `ghost` is the inline-edit
+table cell (`<BbColorInput compact hide-label variant="ghost" />`) — no
+`:deep()` needed. The names and tokens are the `BbButton` ones; extra names
+register through the plugin's `inputVariants` option. The full ladder is in
+the `BbTextInput` guide.
+
 ### Works well with
 
 - `BbColorPalette` — the same picker on your own trigger, when there's no form.
@@ -516,6 +529,7 @@ const form = useForm({ brandColor: '#4f46e5' });
 | `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. |
 | `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 |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/BbDatePickerInput.md

@@ -644,6 +644,19 @@ sheet), its events differ from a plain input:
 />
 ```
 
+### Variants
+
+`variant` picks the field box's look and nothing else — height, padding and
+border width are identical across variants. `outline` (default) is the raised
+panel with the neutral border, `secondary` a soft tinted surface with a faint
+border, and `ghost` draws **no border in any state**: a hover wash is the
+affordance, the focus ring still shows, and errors or warnings surface through
+the icon and the message rather than a tinted edge. `ghost` is the inline-edit
+table cell (`<BbDatePickerInput compact hide-label variant="ghost" />`) — no
+`:deep()` needed. The names and tokens are the `BbButton` ones; extra names
+register through the plugin's `inputVariants` option. The full ladder is in
+the `BbTextInput` guide.
+
 ### Works well with
 
 - `BbTextInput` / `BbTextarea` / `BbNumberInput` — same chrome; mix in one form.
@@ -739,6 +752,7 @@ label>')` matches nothing; query each segment by its own label instead. See
 | `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` | `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… |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/BbNumberInput.md

@@ -615,6 +615,19 @@ const timeoutSeconds = ref<number | null>(30);
 />
 ```
 
+### Variants
+
+`variant` picks the field box's look and nothing else — height, padding and
+border width are identical across variants. `outline` (default) is the raised
+panel with the neutral border, `secondary` a soft tinted surface with a faint
+border, and `ghost` draws **no border in any state**: a hover wash is the
+affordance, the focus ring still shows, and errors or warnings surface through
+the icon and the message rather than a tinted edge. `ghost` is the inline-edit
+table cell (`<BbNumberInput compact hide-label variant="ghost" />`) — no
+`:deep()` needed. The names and tokens are the `BbButton` ones; extra names
+register through the plugin's `inputVariants` option. The full ladder is in
+the `BbTextInput` guide.
+
 ### Works well with
 
 - `BbSlider` — when a bounded number is better dragged than typed, or pair the
@@ -687,6 +700,7 @@ const timeoutSeconds = ref<number | null>(30);
 | `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. |
 | `step` | `number \| undefined` |  |  | Incremental unit used in the exposed `increase` and `decrease` functions. It is NOT applied to manual input as a step of 5 would prevent the user from inserting a value like `115` because of rounding down. |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/BbSelect.md

@@ -1348,6 +1348,19 @@ Platform notes:
 - The desktop panel is anchored to the control; the mobile sheet manages its
   own backdrop, Escape and focus.
 
+### Variants
+
+`variant` picks the field box's look and nothing else — height, padding and
+border width are identical across variants. `outline` (default) is the raised
+panel with the neutral border, `secondary` a soft tinted surface with a faint
+border, and `ghost` draws **no border in any state**: a hover wash is the
+affordance, the focus ring still shows, and errors or warnings surface through
+the icon and the message rather than a tinted edge. `ghost` is the inline-edit
+table cell (`<BbSelect compact hide-label variant="ghost" />`) — no
+`:deep()` needed. The names and tokens are the `BbButton` ones; extra names
+register through the plugin's `inputVariants` option. The full ladder is in
+the `BbTextInput` guide.
+
 ### Works well with
 
 - `BbSelectPopover` — the same engine on a custom trigger (status pills,
@@ -1494,6 +1507,7 @@ Platform notes:
 | `selectedLabelsFn` | `((count: number) => string) \| undefined` |  |  | Function that returns a string to be displayed when the number of selected labels is greater than `maxSelectedLabels`. |
 | `stash` | `boolean \| undefined` | `false` |  | Adds a stash to accumulate selected values across searches. |
 | `transitionDuration` | `number \| undefined` | `250` |  | How long the transition has to last in milliseconds. |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/BbTag.md

@@ -287,6 +287,19 @@ const topics = ref<string[]>(['Product updates', 'Engineering', 'Design']);
   with `errors` / `has-errors` for validation messaging; the input exposes
   `aria-invalid` in the error state.
 
+### Variants
+
+`variant` picks the field box's look and nothing else — height, padding and
+border width are identical across variants. `outline` (default) is the raised
+panel with the neutral border, `secondary` a soft tinted surface with a faint
+border, and `ghost` draws **no border in any state**: a hover wash is the
+affordance, the focus ring still shows, and errors or warnings surface through
+the icon and the message rather than a tinted edge. `ghost` is the inline-edit
+table cell (`<BbTag compact hide-label variant="ghost" />`) — no
+`:deep()` needed. The names and tokens are the `BbButton` ones; extra names
+register through the plugin's `inputVariants` option. The full ladder is in
+the `BbTextInput` guide.
+
 ### Works well with
 
 - `BbSelect` — when the values come from a known list instead of free text.
@@ -379,6 +392,7 @@ only sets the label's text alignment.
 | `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. |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/BbTextInput.md

@@ -617,6 +617,47 @@ const barcode = ref<string | null>('0 12345 67890 5');
 </script>
 ```
 
+### Variants
+
+`variant` picks the field box's look — and only its look. Height, padding and
+border width are identical across variants, so mixing them in one view never
+reflows anything. The names and tokens are the `BbButton` ones, so a page
+reads one vocabulary for buttons and fields:
+
+- **`outline`** (default) — the raised panel with the neutral border.
+- **`secondary`** — a soft tinted surface with a faint border; fields that
+  should sit back on a busy panel.
+- **`ghost`** — no border in **any** state, a hover wash as the affordance,
+  and the same wash under the focus ring (a ring around nothing reads as a
+  glitch). Errors and warnings do not tint it; the icon and
+  the message carry the state. This is the inline-edit table cell: the field
+  reads as text at rest and needs no `:deep()` to get there.
+- **`none`** — structure only: every colour transparent and **no focus
+  ring**. An escape hatch for a fully custom look; prefer registering a
+  variant, which keeps the ring.
+
+**The variant ladder**
+
+```vue
+<template>
+	<div class="grid gap-3 sm:grid-cols-3">
+		<BbTextInput label="Outline" model-value="Ada Lovelace" />
+		<BbTextInput
+			label="Secondary"
+			model-value="Ada Lovelace"
+			variant="secondary"
+		/>
+		<BbTextInput label="Ghost" model-value="Ada Lovelace" variant="ghost" />
+	</div>
+</template>
+```
+
+`variant` is the same prop on `BbTextarea`, `BbNumberInput`, `BbSelect`,
+`BbTag`, `BbDatePickerInput`, `BbTimePickerInput` and `BbColorInput`. Extra
+names are registered through the plugin's `inputVariants` option and styled
+as a token block on `common-input-wrapper--<name>` — see the installation
+guide.
+
 ### Global config & platforms
 
 - `config.defaultInputLabelMode` — project-wide default for `labelMode`
@@ -874,7 +915,7 @@ const formattedTotal = computed(() =>
 | `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. |
+| `inputMode` | `"text" \| "none" \| "search" \| "email" \| "url" \| "tel" \| "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. |
@@ -889,6 +930,7 @@ const formattedTotal = computed(() =>
 | `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. |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/BbTextarea.md

@@ -745,6 +745,19 @@ comment composer above).
 />
 ```
 
+### Variants
+
+`variant` picks the field box's look and nothing else — height, padding and
+border width are identical across variants. `outline` (default) is the raised
+panel with the neutral border, `secondary` a soft tinted surface with a faint
+border, and `ghost` draws **no border in any state**: a hover wash is the
+affordance, the focus ring still shows, and errors or warnings surface through
+the icon and the message rather than a tinted edge. `ghost` is the inline-edit
+table cell (`<BbTextarea compact hide-label variant="ghost" />`) — no
+`:deep()` needed. The names and tokens are the `BbButton` ones; extra names
+register through the plugin's `inputVariants` option. The full ladder is in
+the `BbTextInput` guide.
+
 ### Works well with
 
 - `BbTextInput` / `BbNumberInput` / `BbDatePickerInput` — same chrome and
@@ -823,6 +836,7 @@ comment composer above).
 | `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. |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/BbTimePickerInput.md

@@ -101,6 +101,19 @@ interaction.
 | `active`/`inactive` | —                            | focus enters / leaves the whole control |
 | `focus`             | `FocusEvent`                 | a native field gains focus              |
 
+### Variants
+
+`variant` picks the field box's look and nothing else — height, padding and
+border width are identical across variants. `outline` (default) is the raised
+panel with the neutral border, `secondary` a soft tinted surface with a faint
+border, and `ghost` draws **no border in any state**: a hover wash is the
+affordance, the focus ring still shows, and errors or warnings surface through
+the icon and the message rather than a tinted edge. `ghost` is the inline-edit
+table cell (`<BbTimePickerInput compact hide-label variant="ghost" />`) — no
+`:deep()` needed. The names and tokens are the `BbButton` ones; extra names
+register through the plugin's `inputVariants` option. The full ladder is in
+the `BbTextInput` guide.
+
 ### Gotchas & anti-patterns
 
 - **Don't parse the value with `new Date('14:30')`** — it's a wall-clock
@@ -165,6 +178,7 @@ Messages _also_ render in an `aria-live="polite"` region.
 | `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. |
+| `variant` | `InputVariantType \| undefined` | `'outline'` |  | Visual variant of the field box — the same names and tokens as the `BbButton` variants. Colours only: height, padding and border width are identical across variants, so a form never reflows when one changes. `'ghost'` has no border in any s… |
 | `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

package/dist/ai/CommonInputWrapper.md

@@ -25,6 +25,7 @@
 | `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. |
+| `variant` | `InputVariantType \| undefined` | `"outline"` |  | Visual variant of the field box. Controls colours only — background, border colour, focus border — while height, padding and border WIDTH stay identical across variants, so switching one never reflows a form. Mirrors the equally named `BbBu… |
 
 ## Events
 

package/dist/ai/changelog.json

@@ -1,7 +1,7 @@
 {
 	"schemaVersion": 2,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.22",
+	"version": "3.0.0-beta.23",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"releases": [
@@ -35,7 +35,8 @@
 		"3.0.0-beta.19",
 		"3.0.0-beta.20",
 		"3.0.0-beta.21",
-		"3.0.0-beta.22"
+		"3.0.0-beta.22",
+		"3.0.0-beta.23"
 	],
 	"summary": {
 		"renames": 9,