bitboss-ui 3.0.0-beta.4 → 3.0.0-beta.42

package/dist/ai/BbBaseTextInput.md

@@ -1,75 +0,0 @@
-# BbBaseTextInput
-
-## Agent Contract
-
-- Safety level: **Reference Only - Internal**
-- Group: **Reference Only - Base Primitive**
-- Description: Internal low-level text input primitive.
-- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
-- Implementation source (only when the contract below is not enough): [source/BbBaseTextInput.md](./source/BbBaseTextInput.md)
-
-## v-model
-
-- `v-model` — type: `string \| null`
-
-## Props
-
-| Prop | Type | Default | Required | Description |
-| --- | --- | --- | --- | --- |
-| `append:icon` | `string \| undefined` |  |  | Name of the icon to render at the right hand side of the input. |
-| `ariaDescribedby` | `string \| undefined` |  |  | Id(s) of elements describing this input for assistive technologies. |
-| `autocomplete` | `string \| undefined` |  |  | Browser autocomplete hint for the input field. |
-| `autofocus` | `Booleanish \| undefined` |  |  | Focus the input automatically on 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 all interactions with the input. |
-| `emitMasked` | `boolean \| undefined` |  |  | When using a mask, emit the formatted (masked) value instead of the raw input. |
-| `hasErrors` | `boolean \| undefined` |  |  | Apply error styling to the input and set `aria-invalid`. |
-| `hasWarning` | `boolean \| undefined` |  |  | 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. |
-| `labelMode` | `"floating" \| "outside" \| "inside" \| undefined` |  |  | Label rendering mode, forwarded by wrapper components. |
-| `loading` | `boolean \| undefined` |  |  | Display the loading state styles. |
-| `mask` | `MaskInputOptions \| undefined` |  |  | Input mask configuration. When provided, enables formatted input with validation. |
-| `max` | `string \| undefined` |  |  | Maximum value for numeric and date inputs. |
-| `maxlength` | `number \| undefined` |  |  | Maximum number of characters the input will accept. |
-| `min` | `string \| undefined` |  |  | Minimum value for numeric and date inputs. |
-| `modelValue` | `string \| null` |  | yes | v-model value: the input text, or `null` when empty. |
-| `name` | `string \| undefined` |  |  | Name attribute forwarded to the input element. |
-| `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 it visible. |
-| `required` | `boolean \| undefined` |  |  | 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. |
-
-## Events
-
-- `blur` — `(event: "blur", event: FocusEvent): void`
-- `change` — `(event: "change", event: Event): void`
-- `click` — `(event: "click", event: MouseEvent): void`
-- `compositionend` — `(event: "compositionend", event: CompositionEvent): void`
-- `compositionstart` — `(event: "compositionstart", event: CompositionEvent): void`
-- `focus` — `(event: "focus", event: FocusEvent): void`
-- `input` — `(event: "input", event: Event): void`
-- `keydown` — `(event: "keydown", event: KeyboardEvent): void`
-- `keyup` — `(event: "keyup", event: KeyboardEvent): void`
-- `mousedown` — `(event: "mousedown", event: MouseEvent): void`
-- `mouseup` — `(event: "mouseup", event: MouseEvent): void`
-- `paste` — `(event: "paste", event: ClipboardEvent): void`
-- `update:modelValue` — `(event: "update:modelValue", value: string \| null): void`
-
-## Slots
-
-- `append` — scope: `object` — Content rendered after the text input, at the end of the inner container.
-- `append-outer` — scope: `object` — Content rendered after the entire text input control, outside the input chrome.
-- `prefix` — scope: `object` — Inline content rendered at the start of the input field area, before the typed text.
-- `prepend` — scope: `object` — Content rendered before the text input, at the start of the inner container.
-- `prepend-outer` — scope: `object` — Content rendered before the entire text input control, outside the input chrome.
-- `suffix` — scope: `object` — Inline content rendered at the end of the input field area, after the typed text.
-
-## Exposed (template ref)
-
-- `blur`: `() => void \| undefined`
-- `focus`: `() => void \| undefined`
-- `select`: `() => void \| undefined`

package/dist/ai/BbBaseTextarea.md

@@ -1,62 +0,0 @@
-# BbBaseTextarea
-
-## Agent Contract
-
-- Safety level: **Reference Only - Internal**
-- Group: **Reference Only - Base Primitive**
-- Description: Internal low-level textarea primitive.
-- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
-- Implementation source (only when the contract below is not enough): [source/BbBaseTextarea.md](./source/BbBaseTextarea.md)
-
-## v-model
-
-- `v-model` — type: `string \| null`
-
-## Props
-
-| Prop | Type | Default | Required | Description |
-| --- | --- | --- | --- | --- |
-| `append:icon` | `string \| undefined` |  |  | Name of the icon to render at the right hand side of the textarea. |
-| `ariaDescribedby` | `string \| undefined` |  |  | Id(s) of elements describing this textarea for assistive technologies. |
-| `autocomplete` | `string \| undefined` |  |  | Browser autocomplete hint for the textarea. |
-| `autofocus` | `Booleanish \| undefined` |  |  | Focus the textarea automatically on mount. |
-| `autoGrow` | `boolean \| undefined` |  |  | Automatically expand the textarea height to fit its content. Composes with `rows`: when both are set, `rows` acts as the minimum-height floor the field grows past but never shrinks below. |
-| `clearable` | `boolean \| undefined` |  |  | Show a clear button whenever text is present and the control is interactive. |
-| `compact` | `boolean \| undefined` |  |  | Apply the compact density variant. |
-| `disabled` | `boolean \| undefined` |  |  | Disable all interactions with the textarea. |
-| `hasErrors` | `boolean \| undefined` |  |  | Apply error styling to the textarea. |
-| `hasWarning` | `boolean \| undefined` |  |  | Apply warning styling (same chrome as errors, `--bb-warn` color). Suppressed when `hasErrors` is also set. |
-| `id` | `string \| undefined` |  |  | Explicit id for the textarea element. |
-| `loading` | `boolean \| undefined` |  |  | Display the loading state styles. |
-| `modelValue` | `string \| null` |  | yes | v-model value: the text content, or `null` when empty. |
-| `name` | `string \| undefined` |  |  | Name attribute forwarded to the textarea element. |
-| `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 textarea. |
-| `readonly` | `boolean \| undefined` |  |  | Make the textarea read-only while keeping it visible. |
-| `required` | `boolean \| undefined` |  |  | 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. |
-
-## Events
-
-- `blur` — `(event: "blur", event: FocusEvent): void`
-- `change` — `(event: "change", event: Event): void`
-- `click` — `(event: "click", event: MouseEvent): void`
-- `compositionend` — `(event: "compositionend", event: CompositionEvent): void`
-- `compositionstart` — `(event: "compositionstart", event: CompositionEvent): void`
-- `focus` — `(event: "focus", event: FocusEvent): void`
-- `input` — `(event: "input", event: Event): void`
-- `keydown` — `(event: "keydown", event: KeyboardEvent): void`
-- `keyup` — `(event: "keyup", event: KeyboardEvent): void`
-- `mousedown` — `(event: "mousedown", event: MouseEvent): void`
-- `mouseup` — `(event: "mouseup", event: MouseEvent): void`
-- `paste` — `(event: "paste", event: ClipboardEvent): void`
-- `update:modelValue` — `(event: "update:modelValue", value: string \| null): void`
-
-## Slots
-
-- `append` — scope: `Record<string, never>` — Content rendered after the textarea, at the end of the inner container.
-- `append-outer` — scope: `Record<string, never>` — Content rendered after the entire textarea control, outside the input chrome.
-- `prefix` — scope: `Record<string, never>` — Inline content rendered at the start of the textarea field area, before the text.
-- `prepend` — scope: `Record<string, never>` — Content rendered before the textarea, at the start of the inner container.
-- `prepend-outer` — scope: `Record<string, never>` — Content rendered before the entire textarea control, outside the input chrome.
-- `suffix` — scope: `Record<string, never>` — Inline content rendered at the end of the textarea field area, after the text.

package/dist/ai/BbBaseTimePickerInput.md

@@ -1,62 +0,0 @@
-# BbBaseTimePickerInput
-
-## Agent Contract
-
-- Safety level: **Reference Only - Internal**
-- Group: **Reference Only - Base Primitive**
-- Description: Internal low-level time-picker input primitive.
-- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
-- Implementation source (only when the contract below is not enough): [source/BbBaseTimePickerInput.md](./source/BbBaseTimePickerInput.md)
-
-## v-model
-
-- `v-model` — type: `string \| string[] \| null`
-
-## Props
-
-| Prop | Type | Default | Required | Description |
-| --- | --- | --- | --- | --- |
-| `adaptive` | `boolean \| undefined` | `undefined` |  | On mobile the time columns open inside a bottom off-canvas sheet instead of a floating popover. When unset, falls back to the global `config.adaptive`. |
-| `ampm` | `boolean \| undefined` |  |  | 12-hour display with an AM/PM segment. Purely a field-composition concern: the model stays 24-hour. Type `A`/`P` (or ArrowUp/Down) to set the meridiem. |
-| `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. |
-| `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. |
-| `disabled` | `boolean \| undefined` |  |  | Disables the input, clock trigger, and popover. |
-| `disableWriting` | `boolean \| "mobile" \| "desktop" \| undefined` | `false` |  | Controls whether manual typing is disabled inside the text fields. Use `'mobile'` / `'desktop'` to disable typing on one platform only. |
-| `hasErrors` | `boolean \| undefined` |  |  | Marks the control as invalid, applying error styles and `aria-invalid`. |
-| `hasWarning` | `boolean \| undefined` |  |  | 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 value. |
-| `loading` | `boolean \| undefined` |  |  | Shows loading visuals on the input. |
-| `max` | `string \| undefined` |  |  | Maximum selectable time in `HH:mm` format. Values outside the pattern throw during setup to surface configuration mistakes. |
-| `min` | `string \| undefined` |  |  | Minimum selectable time in `HH:mm` format. Values outside the pattern throw during setup to surface configuration mistakes. |
-| `modelValue` | `string \| string[] \| null` |  | yes | v-model value: `null` for empty, a 24-hour `HH:mm` (or `HH:mm:ss` with `seconds`) string, or a two-element array when `range` is true. |
-| `name` | `string \| undefined` |  |  | Name attribute forwarded to the native inputs (suffixed per field). |
-| `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 shown when empty; defaults to the localized format hint. |
-| `prepend:icon` | `string \| undefined` |  |  | Icon name rendered before the input field. |
-| `range` | `boolean \| undefined` |  |  | Range selection: v-model expects a two-element array `[start, end]`. An inverted pair swaps on finalize with an `end_before_start` error. |
-| `readonly` | `boolean \| undefined` |  |  | Makes the text fields read-only and prevents opening the popover. |
-| `required` | `boolean \| undefined` |  |  | Marks the inputs as required to the browser. |
-| `seconds` | `boolean \| undefined` |  |  | Adds the seconds segment. Without it an incoming value carrying seconds displays truncated and zeroes out on the next user commit. |
-| `step` | `number \| undefined` |  |  | Minute granularity for the minute column and its arrow stepping. Constrains what the columns produce, never what typing accepts. |
-| `transitionDuration` | `number \| undefined` |  |  | Transition duration, in milliseconds, for the popover appearance. |
-
-## Events
-
-- `active` — `(event: "active"): void`
-- `error` — `(event: "error", error: TimePickerInputError): void`
-- `focus` — `(event: "focus", event: FocusEvent): void`
-- `inactive` — `(event: "inactive"): void`
-- `update:modelValue` — `(event: "update:modelValue", value: string \| string[] \| null): void`
-
-## Slots
-
-- `append` — scope: `object` — Content rendered after the time fields (before the clock button).
-- `append-outer` — scope: `object` — Content rendered after the entire control, outside the input chrome.
-- `prefix` — scope: `object` — Inline content at the start of the field area.
-- `prepend` — scope: `object` — Content rendered before the time fields, at the start of the inner container.
-- `prepend-outer` — scope: `object` — Content rendered before the entire control, outside the input chrome.
-- `suffix` — scope: `object` — Inline content at the end of the field area.

package/dist/ai/BbTabsPanes.md

@@ -1,27 +0,0 @@
-# BbTabsPanes
-
-## Agent Contract
-
-- Safety level: **Consumer API**
-- Group: **Navigation**
-- Description: The pane host of a split BbTabsRoot layout (renders the tab content only).
-- Usage rule: Prefer this component for consumer-facing implementations.
-- Implementation source (only when the contract below is not enough): [source/BbTabsPanes.md](./source/BbTabsPanes.md)
-
-## Props
-
-- None.
-
-## Events
-
-- None.
-
-## Slots
-
-- None.
-
-## See Also
-
-- [BbTabs](./BbTabs.md) — Switches between tabbed content views (shadcn-like strip; BbTabRoot enables split layouts).
-- [BbTabsRoot](./BbTabsRoot.md) — Provide/inject root that lets BbTabsList and BbTabsPanes live in separate layout slots.
-- [BbTabsList](./BbTabsList.md) — The trigger strip of a split BbTabsRoot layout (renders the tab buttons only).

package/dist/ai/CommonInputWrapper.md

@@ -1,42 +0,0 @@
-# CommonInputWrapper
-
-## Agent Contract
-
-- Safety level: **Reference Only - Internal**
-- Group: **Layout & Utility**
-- Description: Shared wrapper utility for composed input controls.
-- Usage rule: Do not use this component in consumer-facing solutions unless explicitly requested.
-- Implementation source (only when the contract below is not enough): [source/CommonInputWrapper.md](./source/CommonInputWrapper.md)
-
-## Props
-
-| Prop | Type | Default | Required | Description |
-| --- | --- | --- | --- | --- |
-| `active` | `boolean \| undefined` |  |  | Whether the input is in active/focused state (e.g. open dropdown). |
-| `append:icon` | `string \| undefined` |  |  | Name of the icon to be added at the end of the input. |
-| `clearable` | `boolean \| undefined` |  |  | Whether the input is clearable. |
-| `compact` | `boolean \| undefined` |  |  | Whether the input is in compact mode. |
-| `disabled` | `boolean \| undefined` |  |  | Whether the input is disabled. |
-| `hasErrors` | `boolean \| undefined` |  |  | Whether the input has validation errors. |
-| `hasValue` | `boolean \| undefined` | `undefined` |  | Whether the wrapped control currently has a value that can be cleared. |
-| `hasWarning` | `boolean \| undefined` |  |  | Whether the input has a warning state. Visually identical to `hasErrors` but uses `--bb-warn` chrome; errors take priority when both are set. |
-| `loading` | `boolean \| undefined` |  |  | Whether the input is in a loading state. |
-| `prepend:icon` | `string \| undefined` |  |  | Name of the icon to be added at the start of the input. |
-| `preventFocus` | `boolean \| undefined` |  |  | Prevents the wrapper from focusing the inner input on click. |
-| `readonly` | `boolean \| undefined` |  |  | Whether the input is readonly. |
-| `reserveAppendSpace` | `boolean \| undefined` |  |  | Keeps trailing action/icon space reserved even when currently empty. |
-
-## Events
-
-- `click:clear` — `(event: "click:clear"): void`
-- `container:click` — `(event: "container:click"): void`
-
-## Slots
-
-- `append` — scope: `object` — Wraps the trailing suffix area. Renders a `<span>` containing the `suffix` sub-slot by default.
-- `append-outer` — scope: `object` — Content appended outside the inner input container.
-- `default` — scope: `object` — The main input element (e.g. `<input>` or `<textarea>`).
-- `prefix` — scope: `object` — Content rendered as an inline text prefix inside the prepend span.
-- `prepend` — scope: `object` — Wraps the leading prefix area. Renders a `<span>` containing the `prefix` sub-slot by default.
-- `prepend-outer` — scope: `object` — Content prepended outside the inner input container.
-- `suffix` — scope: `object` — Content rendered as an inline text suffix inside the append span.