bitboss-ui 3.0.0-beta.26 → 3.0.0-beta.28

package/dist/ai/BbTag.md

@@ -560,8 +560,6 @@ Set these on the element, or on a class you put on it, to retune this component
 | Property | Set on | Default | What it is |
 | --- | --- | --- | --- |
 | `--compensation-multiplier` | `.bb-tag__field` | `0.3` | Fraction of the shell's inner padding the chip row is pulled back by when no prepend icon precedes it (see the negative margin below). |
-| `--inner-h` | `.bb-tag__field` | `max( calc(var(--bb-leading) + var(--bb-input-py) * 2), calc(var(--bb-input-h) - …` | The first chip row's height: the tallest of one line plus its vertical padding, the input height less its borders, and the icon box. Feeds `--floating-py` and nothing else. |
-| `--floating-py` | `.bb-tag__field` | `calc((var(--inner-h) - var(--bb-input-icon)) / 2)` | Top offset for centring icons and affixes on that first row — the same value BbTextarea uses for that. Nothing in the library reads it, so this and the compact override below are currently inert. |
 | `--border-color` | `pt:box` | `per variant` | The resting border, at the fixed --bb-border-w. Errors and warnings paint their frame over it, so `pt:box="[--border-color:…]"` recolours the rest without hiding the state; a plain `border-*` utility on the base pt:box would hide it (ESLint… |
 
 ## Component tree

package/dist/ai/BbTextInput.md

@@ -511,8 +511,12 @@ The native attributes that only mean something on the input itself —
 `maxlength`, `minlength`, `pattern`, `spellcheck`, `autocapitalize`,
 `autocorrect`, `enterkeyhint`, `list`, `form`, `dirname` — go straight to the
 native `<input>` (the same holds for BbTextarea, BbNumberInput, BbTag and
-BbColorInput, where `wrap` joins them on the textarea). Any other attribute
-you set lands on the field's outer element; reach the input with
+BbColorInput, where `wrap` joins them on the textarea). The controls without
+a text input route only what their native control reads: BbSelect sends
+`form` to its hidden inputs, BbDatePickerInput and BbTimePickerInput send
+`form`, `spellcheck`, `autocapitalize`, `autocorrect` and `enterkeyhint` to
+every segment (each segment keeps its own `maxlength` and parsing). Any other
+attribute you set lands on the field's outer element; reach the input with
 `pt:input="{ attrs: { … } }"`, which also wins over the attributes above.
 
 **An OTP field: text type, numeric keyboard, masked**

package/dist/ai/BbTimePicker.md

@@ -14,6 +14,7 @@
 
 | pt part | Lands on | In |
 | --- | --- | --- |
+| `pt:panel` | the root of `CommonPopover` | `CommonPopover` _(internal)_ |
 | `pt:sheet` | `pt:root` of `BbOffCanvas` | `BbOffCanvas` ([contract](./BbOffCanvas.md)) |
 | `pt:item` | the root of `BbBaseButton` | `BbBaseButton` ([contract](./BbBaseButton.md)) |
 
@@ -145,6 +146,12 @@ props with `offCanvasProps`). Position the desktop popover with `placement`,
 `offset`, `padding`, `boundary`, and `disableFlip` — the same knobs as the other
 overlays. Escape and backdrop clicks close it; focus returns to the activator.
 
+The sheet can be **dragged down to dismiss** and shows **no ✕** — picking,
+drag, backdrop tap and Escape close it. The time wheels are no-drag zones: a
+swipe there scrolls the wheel and never moves the sheet, even at the top of the
+list. `offCanvasProps` is spread over those defaults: `{ hideClose: false }`
+brings the ✕ back, `{ draggable: false }` pins the sheet.
+
 ### The `v-bb-time` directive
 
 For the leanest case — a time cell in a schedule table where you don't want a
@@ -187,8 +194,10 @@ there is no text field to type into, `BbTimePickerInput` when there is.
 
 `pt` reaches a named part with a class list — or, in the object form, a
 style and attributes — optionally only while a state is on. Parts: `root`
-(the time panel, in the popover and in the sheet alike), `sheet` (the bottom
-sheet around it on a phone — no node on desktop) and `item` (one column entry, a broadcast). States: `open`,
+(the floating element — the bottom sheet on a phone), `panel` (the time box you
+see: the popover's painted bubble on desktop, the box inside the sheet on a
+phone), `sheet` (the bottom
+sheet on a phone only, applied after `root`) and `item` (one column entry, a broadcast). States: `open`,
 and `selected` per entry.
 
 The opening-time cell above, restyled through those parts: the current
@@ -256,7 +265,7 @@ typeahead. Always pass a `label` when the trigger is an unlabelled cell or icon.
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `item`, `root`, `sheet`. States: `open`, `selected`. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. |
+| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `item`, `panel`, `root`, `sheet`. States: `open`, `selected`. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. |
 | `activator` | `ElementOrComponentRef \| undefined` |  |  | External activator element or component ref. When provided, the `activator` slot is not rendered and click + ARIA are attached programmatically to the referenced element — mirroring `BbDatePicker`. |
 | `activeSegment` | `BbTimePickerSegment \| undefined` |  |  | Which end the columns edit in range mode (`v-model:active-segment`). Standalone use manages this internally via the in-panel toggle; a host can drive it. Ignored outside `range`. |
 | `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | On mobile, open in a bottom off-canvas sheet instead of a floating popover. When unset, falls back to the global `config.adaptive`. |
@@ -270,7 +279,7 @@ typeahead. Always pass a `label` when the trigger is an unlabelled cell or icon.
 | `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 `[start, end]` array when `range` is true. |
-| `offCanvasProps` | `Partial<BbOffCanvasProps> \| undefined` |  |  | Extra props forwarded to the `BbOffCanvas` sheet when adaptive on mobile. |
+| `offCanvasProps` | `Partial<BbOffCanvasProps> \| undefined` |  |  | Extra props forwarded to the `BbOffCanvas` sheet when `adaptive` is active on mobile (e.g. `title`, `size`, `persistent`). Spread over the defaults: the sheet is `draggable` (the time wheels never drag it) and hides its ✕ (picking, backdrop… |
 | `offset` | `number \| undefined` | `4` |  | Space the popover keeps from the activator. |
 | `padding` | `number \| undefined` |  |  | Minimum empty space to keep from the edge of the page. |
 | `placement` | `Placement \| undefined` |  |  | Position of the popover relative to the activator/anchor. |
@@ -304,7 +313,7 @@ typeahead. Always pass a `label` when the trigger is an unlabelled cell or icon.
 - **CSS custom properties** listed on a node are declared on THAT node's root and read by elements inside it. Set one on that node's root or on the element inside it that reads it — the pt part that lands there is how you reach it (`pt:box="[--border-color:…]"` on a text input) — never on `BbTimePicker`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
 - Listed nodes are the ones `BbTimePicker`'s API reaches or that declare a documented CSS variable; the rest fold into "also mounts". The complete tree, repeats and undocumented locals included, is the `tree` field of this component in `components.json`.
 
-- `BbTimePicker` _(this component)_ — its own template binds: `root` → `div.bb-time-picker__panel`; hands `BbOffCanvas` the pt map `{ sheet: 'root' }` (ours → theirs)
+- `BbTimePicker` _(this component)_ — its own template binds: `panel` → `div`, `panel` → `CommonPopover`; hands `BbOffCanvas` the pt map `{ sheet: 'root' }` (ours → theirs)
   - `CommonTimeSelector` _(internal — not importable, reach it through `BbTimePicker`)_ — `BbTimePicker`'s pt parts land here: `item` → `BbBaseButton`; documented CSS variables: `--time-mark`
     - `BbBaseButton` _(public — [contract](./BbBaseButton.md))_ — its own pt parts (`BbBaseButton`): `root` → `RouterComponent`, `root` → `a`, `root` → `component`; also mounts `RouterComponent`
   - `BbOffCanvas` _(public — [contract](./BbOffCanvas.md))_ — its own pt parts (`BbOffCanvas`): `header` → `div.bb-offcanvas__header`, `title` → `span.bb-offcanvas__title`, `description` → `p.bb-offcanvas__description`, `close` → `CloseButton`, `content` → `div.bb-offcanvas__body`, `footer` → `div.bb-offcanvas__footer`; documented CSS variables: `--stack-x`, `--stack-fill`, `--stack-transition-duration`, `--px`, `--close-size`

package/dist/ai/BbTimePickerInput.md

@@ -14,6 +14,7 @@
 
 | pt part | Lands on | In |
 | --- | --- | --- |
+| `pt:panel` | the root of `CommonPopover` | `CommonPopover` _(internal)_ |
 | `pt:sheet` | `pt:root` of `BbOffCanvas` | `BbOffCanvas` ([contract](./BbOffCanvas.md)) |
 | `pt:root` | `div.bb-field` | `CommonField` _(internal)_ |
 | `pt:label` | `component` | `CommonField` _(internal)_ |
@@ -100,6 +101,13 @@ is required.
 <BbTimePickerInput v-model="state.slotAt" ampm :step="15" label="Pickup slot" />
 ```
 
+Native attributes that describe typing — `spellcheck`, `autocapitalize`,
+`autocorrect`, `enterkeyhint` — and `form` go to **every segment** (each one
+is a real `<input>` that posts its own `<name>-<field>`); `maxlength`,
+`pattern` and `list` are not routed, because each segment sets its own length
+and parses its own digits. Any other attribute lands on the field root; a
+`pt:input` attribute reaches every segment and wins over the routed ones.
+
 ### Bounds & ranges
 
 `min` / `max` (`HH:mm`) clamp typed times when interaction ends — the value
@@ -125,7 +133,9 @@ end]`; typing an inverted pair swaps it on blur with the usual
 
 The popover follows the family's adaptive pattern: on mobile (with the global
 `config.adaptive`, or the `adaptive` prop) the columns open in a bottom sheet
-(`offCanvasProps` forwards extras). `disableWriting` (`true` / `'mobile'` /
+that drags down to dismiss and shows no ✕ (the wheels never drag it;
+`offCanvasProps` is spread over those defaults — `{ hideClose: false }` brings
+the ✕ back). `disableWriting` (`true` / `'mobile'` /
 `'desktop'`) turns off typing per platform — the columns then carry the
 interaction.
 
@@ -155,7 +165,7 @@ the `BbTextInput` guide.
 
 `pt` reaches a named part of the control with a class list — or, in the
 object form, a style and attributes — optionally only while a state is on.
-Parts: `root` (the container), `label`, `description`, `message` (the errors / warnings region — one node each, only one ever shows), `hint` (the helper line — shown on focus, or always with `persistent-hint`), `box` (the bordered field box), `input` (the native control), `icon` (`prepend:icon` + `append:icon` — a broadcast; the state glyphs are chrome), `spinner` (the spinner shown while `loading`), `prefix`, `suffix`, `clear` (the ✕ that empties the field). Plus `panel` (the time columns, in the popover and in the sheet alike), `sheet` (the bottom sheet around them on a phone only) and `item` (one column entry, a broadcast). `input` is every segment field; the clock trigger is chrome.
+Parts: `root` (the container), `label`, `description`, `message` (the errors / warnings region — one node each, only one ever shows), `hint` (the helper line — shown on focus, or always with `persistent-hint`), `box` (the bordered field box), `input` (the native control), `icon` (`prepend:icon` + `append:icon` — a broadcast; the state glyphs are chrome), `spinner` (the spinner shown while `loading`), `prefix`, `suffix`, `clear` (the ✕ that empties the field). Plus `panel` (the time box you see — the popover's painted bubble on desktop, the box inside the sheet on a phone), `sheet` (the bottom sheet on a phone only) and `item` (one column entry, a broadcast). `input` is every segment field; the clock trigger is chrome.
 States: `errors`, `warnings` (never beside errors), `loading`, `disabled`, `readonly`, `has-value` (written `pt:box:has-value`). Plus `open` (the panel is showing) and `selected`, resolved per entry. A name outside that list is a type error and an
 ESLint error.
 
@@ -290,7 +300,7 @@ Messages _also_ render in an `aria-live="polite"` region.
 | `min` | `string \| undefined` |  |  | Minimum selectable time in `HH:mm` format. Values outside the pattern throw during setup to surface configuration mistakes. |
 | `modelValue` | `string \| string[] \| null` |  | yes | v-model value: `null` for empty, a 24-hour `HH:mm` (or `HH:mm:ss` with `seconds`) string, or a two-element array when `range` is true. |
 | `name` | `string \| undefined` |  |  | Defines the name of the input. |
-| `offCanvasProps` | `Partial<BbOffCanvasProps> \| undefined` |  |  | Extra props forwarded to the `BbOffCanvas` sheet when `adaptive` is active on mobile (e.g. `title`, `size`, `persistent`). |
+| `offCanvasProps` | `Partial<BbOffCanvasProps> \| undefined` |  |  | Extra props forwarded to the `BbOffCanvas` sheet when `adaptive` is active on mobile (e.g. `title`, `size`, `persistent`). Spread over the defaults: the sheet is `draggable` (the time wheels never drag it) and hides its ✕ (picking, backdrop… |
 | `persistentHint` | `boolean \| undefined` | `false` |  | Keeps the hint displayed. |
 | `placeholder` | `string \| undefined` |  |  | String displayed when there's no data. |
 | `prepend:icon` | `string \| undefined` |  |  | Name of the icon to be added at the start of the input. |
@@ -354,7 +364,7 @@ Set these on the element, or on a class you put on it, to retune this component
 - **CSS custom properties** listed on a node are declared on THAT node's root and read by elements inside it. Set one on that node's root or on the element inside it that reads it — the pt part that lands there is how you reach it (`pt:box="[--border-color:…]"` on a text input) — never on `BbTimePickerInput`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
 - Listed nodes are the ones `BbTimePickerInput`'s API reaches or that declare a documented CSS variable; the rest fold into "also mounts". The complete tree, repeats and undocumented locals included, is the `tree` field of this component in `components.json`.
 
-- `BbTimePickerInput` _(this component)_ — its own template binds: `input` → `input.bb-segmented-field__field`, `suffix` → `span.bb-field-input__suffix`, `panel` → `div.bb-time-picker-input__panel`; hands `BbOffCanvas` the pt map `{ sheet: 'root' }` (ours → theirs)
+- `BbTimePickerInput` _(this component)_ — its own template binds: `controlAttrs` → `input.bb-segmented-field__field`, `input` → `input.bb-segmented-field__field`, `suffix` → `span.bb-field-input__suffix`, `panel` → `div`, `panel` → `CommonPopover`; hands `BbOffCanvas` the pt map `{ sheet: 'root' }` (ours → theirs)
   - `BbOffCanvas` _(public — [contract](./BbOffCanvas.md))_ — its own pt parts (`BbOffCanvas`): `header` → `div.bb-offcanvas__header`, `title` → `span.bb-offcanvas__title`, `description` → `p.bb-offcanvas__description`, `close` → `CloseButton`, `content` → `div.bb-offcanvas__body`, `footer` → `div.bb-offcanvas__footer`; documented CSS variables: `--stack-x`, `--stack-fill`, `--stack-transition-duration`, `--px`, `--close-size`
     - `CloseButton` _(internal — not importable, reach it through `BbOffCanvas`)_ — documented CSS variables: `--size`, `--p`
   - `CommonField` _(internal — not importable, reach it through `BbTimePickerInput`)_ — `BbTimePickerInput`'s pt parts land here: `root` → `div.bb-field`, `label` → `component`, `description` → `span.bb-field__description`, `hint` → `span.bb-field__hint-text`, `message` → `div.bb-field__errors`, `message` → `div.bb-field__warnings`

package/dist/ai/BbToast.md

@@ -57,6 +57,14 @@ import { BbToast } from 'bitboss-ui';
 </script>
 ```
 
+**Areas with their own look.** A toast takes the passthrough scope and the
+tokens of the place its HOST is mounted, not of the code that fired it. When
+the app is split into areas that each wrap their pages in `<BbPtScope>`
+([passthrough guide](./guides/passthrough.md) § Named scopes), mount one
+`<BbToast />` inside each area's layout, within its scope, and none at the app
+root. That still means one host at a time — as long as **every** page renders
+inside exactly one of those layouts.
+
 On Nuxt the host goes in `app.vue`; on Inertia, in the `createInertiaApp`
 render root — one mount above the router, so every page shares it and no page
 mounts its own. **Every example on this page mounts its own `<BbToast />` only
@@ -736,8 +744,8 @@ The full grammar, the merge rules and the global map are in the
 
 - **No host, no toasts**: `toast(...)` without a mounted `<BbToast />`
   enqueues silently — and the messages never expire, because the dismiss timer
-  lives inside the host. Mount exactly one host, at the app root — never one per
-  page or per component.
+  lives inside the host. Mount exactly one host at a time: at the app root
+  (or one per area layout, see _Setup_) — never one per page or per component.
 - Don't hand-roll notification markup or timers; between variants, upsert,
   portals, and persistence the component covers it.
 - Don't put must-act information only in a toast — it self-dismisses.

package/dist/ai/changelog.json

@@ -1,7 +1,7 @@
 {
 	"schemaVersion": 2,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.26",
+	"version": "3.0.0-beta.28",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"releases": [
@@ -39,11 +39,13 @@
 		"3.0.0-beta.23",
 		"3.0.0-beta.24",
 		"3.0.0-beta.25",
-		"3.0.0-beta.26"
+		"3.0.0-beta.26",
+		"3.0.0-beta.27",
+		"3.0.0-beta.28"
 	],
 	"summary": {
 		"renames": 64,
-		"behaviourBreaks": 64,
+		"behaviourBreaks": 72,
 		"unreleased": 0
 	},
 	"breaking": [
@@ -564,10 +566,10 @@
 				".bb-color-palette"
 			],
 			"from": ".bb-base-color-palette (the picker root)",
-			"to": ".bb-color-palette__picker",
+			"to": ".bb-color-palette__panel (__picker until Queue 37)",
 			"since": "",
 			"default": "",
-			"firstReleasedIn": "3.0.0-beta.26"
+			"firstReleasedIn": "3.0.0-beta.28"
 		},
 		{
 			"kind": "rename",
@@ -949,6 +951,13 @@
 			"guide": "components/bb-popover.md",
 			"firstReleasedIn": "3.0.0-beta.17"
 		},
+		{
+			"kind": "behaviour",
+			"description": "Picker pt surfaces: BbColorPalette / BbTimePicker / BbDatePicker pt:root moves from the inner content box to the floating element (the sheet on a phone); the box is the new pt:panel (the bubble). BbSelect / BbDatePickerInput / BbTimePickerInput pt:panel now land on the painted bubble, not the floating element / inner box. Classes __picker / __calendar → __panel",
+			"ruling": "Q37",
+			"guide": "ai/guides/passthrough.md (picker surfaces)",
+			"firstReleasedIn": "3.0.0-beta.27"
+		},
 		{
 			"kind": "behaviour",
 			"description": "BbDropdown fetched (pipeline) rows no longer copy BbBaseButton props / icons / variant / onClick / disabled off the raw item — every field beyond text and value comes only from itemProps",
@@ -1235,6 +1244,55 @@
 			"ruling": "owner 2026-09-16 (date-picker pt parts)",
 			"guide": "v2-to-v3.md §5.6",
 			"firstReleasedIn": "3.0.0-beta.26"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbDropdown defineExpose({ open }) (v3 prereleases only; v2 had no such handle) removed → show / hide events (and shown / hidden); BbDropdownButton reads them",
+			"ruling": "Q30.4 (owner 2026-09-16)",
+			"guide": "none — a v2 app never had it; components/bb-dropdown.md lists the surviving loading row",
+			"firstReleasedIn": "3.0.0-beta.28"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbDatePicker defineExpose({ calendarEl }) (v3 prereleases only) removed → the calendar is reachable through its pt:panel / pt:day parts and the show / shown events",
+			"ruling": "Q30.4 (owner 2026-09-16)",
+			"guide": "none — v2 had no standalone BbDatePicker",
+			"firstReleasedIn": "3.0.0-beta.28"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbDatePicker / BbTimePicker / BbColorPalette: a consumer class / $attrs lands on the floating element (the popover; the sheet on a phone) — before 3.0.0-beta.28 it was dropped on the fragment root with a Vue warning",
+			"ruling": "Q39 (P11)",
+			"guide": "ai/guides/passthrough.md (picker surfaces)",
+			"firstReleasedIn": "3.0.0-beta.28"
+		},
+		{
+			"kind": "behaviour",
+			"description": "Open overlays close on KeepAlive deactivation: BbDialog / BbOffCanvas / BbPopover / BbTooltip emit update:modelValue false, BbDropdown / BbSelectPopover / the three standalone pickers emit hide; a BbTable resize or drag in flight is cancelled (nothing emitted). Before, a cached open surface kept its document listeners and a modal <dialog> lost its top layer",
+			"ruling": "Q39.6 (2026-09-16)",
+			"guide": "none needed — a cached surface reopens as usual; noted in each component's source",
+			"firstReleasedIn": "3.0.0-beta.28"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbDropdownButton declares pt:item:selected / pt:item-text:selected / pt:item-icon:selected / pt:item-description:selected (additive; the entry parts only)",
+			"ruling": "Q39.2 (2026-09-16)",
+			"guide": "none — additive",
+			"firstReleasedIn": "3.0.0-beta.28"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbSelect routes a consumer form attribute to its hidden inputs; BbDatePickerInput / BbTimePickerInput route form, spellcheck, autocapitalize, autocorrect, enterkeyhint to every segment (they used to land on .bb-field)",
+			"ruling": "Q39.1 (2026-09-16)",
+			"guide": "components/bb-text-input.md (family note)",
+			"firstReleasedIn": "3.0.0-beta.28"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable virtual: the first frame renders a window of rows from the estimates (server render and the client's first frame alike; was an empty body until the first virtualizer flush). Scroll height settles once the first measurements land, a frame or two after mount",
+			"ruling": "Q36 (2026-09-17)",
+			"guide": "none — additive; nothing observable after the first frame",
+			"firstReleasedIn": "3.0.0-beta.28"
 		}
 	]
 }