bitboss-ui 3.0.0-beta.47 → 3.0.0-beta.49

package/dist/ai/BbTooltip.md

@@ -131,7 +131,8 @@ bitbossUi({ tooltipVariants: ['info', 'success'] });
 The most common real use: a compact row of icon-only actions, each named by a
 tooltip. This companion frames a shared-document chrome — title, muted meta, and
 `size="xs"` ghost buttons grouped with thin dividers. A `:delay="400"` keeps the
-bubbles from flickering while the pointer crosses the dense toolbar.
+bubbles from flickering while the pointer crosses the dense toolbar; once one
+hint shows, its neighbours open at once (the skip delay, below).
 
 **Icon toolbar with tooltips**
 
@@ -248,10 +249,21 @@ is concerned — the whole label (shortcut included) is flattened into the
 
 - `placement` — as above; the `top`/`right`/`bottom`/`left` families with
   `-start`/`-end` variants, auto-flipping near an edge.
-- `delay` (ms, default `0`) holds the tooltip back until the pointer settles —
-  useful on dense toolbars to avoid a flicker of bubbles while the cursor passes
-  over. It delays only the **open**; the close is always a short debounce (so the
-  pointer can travel from the trigger into the bubble without it vanishing).
+- `delay` (ms, default `100`) holds the tooltip back until the pointer settles,
+  so a cursor passing over a row of buttons doesn't flash a bubble at each one;
+  raise it on dense toolbars. It delays only the **open**, and only for a
+  pointer; the close is always a short debounce (so the pointer can travel from
+  the trigger into the bubble without it vanishing).
+- **Keyboard focus shows the hint at once**, whatever `delay` says: a Tab onto a
+  control is never an accident.
+- **The skip delay:** while a tooltip shows, or for 300 ms after one closes, the
+  next tooltip the pointer reaches opens at once. Run the pointer along a
+  toolbar and every hint after the first appears without a wait. It is shared by
+  every `BbTooltip` and `v-bb-tooltip`, needs no setup, and leaves hover cards
+  alone (they keep their own 350 ms). A tooltip that hid because a menu or
+  dialog opened doesn't count.
+- `:delay="0"` shows the tooltip on hover at once (the default before
+  3.0.0-beta.49).
 - `width` caps the bubble so long hints wrap instead of stretching across the
   screen. It is a **maximum, not a fixed width** — the bubble still shrinks to
   short text, so a one-line hint never sits in an oversized box. A bare number
@@ -262,8 +274,10 @@ is concerned — the whole label (shortcut included) is flattened into the
   `.bb-tooltip` in your own CSS.
 - `disabled` suppresses the tooltip entirely — and dismisses it if already open,
   so you can bind it to skip a hint when the label is already visible elsewhere.
-- Content is **lazy** (rendered on first open); `eager` renders it up front, and
-  `transition-duration` (ms) times the fade.
+- The bubble is **lazy** (its popover and content render on the first open,
+  so a closed tooltip costs little in a long table); `eager` renders it up
+  front, and `transition-duration` (ms) times the fade. The description screen
+  readers hear is there from mount either way.
 
 **Delayed, width-capped hint**
 
@@ -508,7 +522,8 @@ type ToolbarAction = {
 // Same document-toolbar hints as `IconButtonTooltips.vue`, restyled through
 // passthrough: a muted wash on `pt:panel` (the bubble — default is the
 // inverted primary), `pt:root:open` adds a drop shadow while showing. Hover
-// a glyph to see the pt; delay 400 matches dense toolbars.
+// a glyph to see the pt; `delay` 400 (the default is 100) holds the first hint
+// back in a dense toolbar, and the next glyph's hint opens at once (skip delay).
 const actions: ToolbarAction[] = [
 	{ label: 'Undo', icon: 'lucide:undo-2' },
 	{ label: 'Redo', icon: 'lucide:redo-2' },
@@ -562,9 +577,10 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
   The node it points at is `hidden`: read as the activator's description, never
   as page text of its own, and still read inside an open `BbDialog` (the
   directive's node lives at the end of `<body>`, which a modal makes inert).
-- The tooltip opens on keyboard focus (`:focus-visible`) and on hover, and closes
-  on blur, mouse-leave, or `Escape`. A mouse click does not open it (hover
-  already covers the pointer), so it never pops over the thing you just clicked.
+- The tooltip opens on keyboard focus (`:focus-visible`, at once) and on hover
+  (after `delay`), and closes on blur, mouse-leave, or `Escape`. A mouse click
+  does not open it (hover already covers the pointer), so it never pops over the
+  thing you just clicked.
 - Because the bubble is not focusable and holds no interactive content, never
   place a link or button inside it — use `BbPopover` for that.
 - The tooltip supplements an accessible name; it does not provide one. Icon-only
@@ -582,9 +598,9 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `activator` | `ElementOrComponentRef \| undefined` |  |  | External activator element or component ref. When provided, the activator slot is not rendered and event listeners are attached programmatically to the referenced element. |
 | `arrowPadding` | `number \| undefined` | `10` |  | Space the arrow will maintain to the edge of the tooltip bubble. Useful when the floating element has border radius so it won't appear broken |
 | `boundary` | `ElementOrComponentRefOrSelector \| undefined` |  |  | Constrains the tooltip within a bounding element. When provided, the tooltip will not overflow this container's bounds (e.g. a sidebar). Accepts an HTMLElement, a Vue component ref, or a CSS selector string. |
-| `delay` | `number \| undefined` | `0` |  | The delay in milliseconds before the tooltip is shown. |
+| `delay` | `number \| undefined` | `100` |  | How long, in milliseconds, a pointer has to rest on the activator before the tooltip shows; it keeps hints from flashing under a pointer passing by. Keyboard focus shows it at once whatever this says, and so does a pointer arriving while another tooltip shows or within 300 ms of one closing (the skip delay, shared by every tooltip). `0` shows it on hover at once. |
 | `disabled` | `boolean \| undefined` | `false` |  | Disables the component |
-| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Renders the tooltip's popover and content at mount instead of on the first open. The description screen readers hear exists from mount either way. |
 | `hideArrow` | `boolean \| undefined` | `false` |  | Hides the tooltip arrow. A tooltip shows its arrow by default (it's the one popover-family surface where an arrow is meaningful — a speech bubble pointing at its anchor); set this to drop it. |
 | `id` | `string \| undefined` |  |  | Seed for the tooltip's internal id. It is **prefixed** (`bb_<id>`) and set on the inner content element, not on the root — so `document.getElementById(theIdYouPassed)` finds nothing. Pass it to make the generated id stable (SSR snapshots, tests), not to look the element up. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to show / hide the tooltip. A tooltip with no `v-model` starts hidden and is driven by hover / focus. |

package/dist/ai/BbTree.md

@@ -755,10 +755,10 @@ const items = ref<Array<BbTreeItem<FileNode>>>([
 
 /* Trunk: vertical line continuing past a node while siblings follow. */
 .connector-tree .bb-tree__children > .bb-tree__item:not(:last-child)::before {
-	border-left: 1px solid var(--line);
+	border-inline-start: 1px solid var(--line);
 	bottom: 0;
 	content: '';
-	left: calc(var(--indent) / -2);
+	inset-inline-start: calc(var(--indent) / -2);
 	position: absolute;
 	top: calc(var(--gap) * -1);
 }
@@ -770,11 +770,11 @@ const items = ref<Array<BbTreeItem<FileNode>>>([
 
 .connector-tree .bb-tree__children > .bb-tree__item > .bb-tree__row::before {
 	border-bottom: 1px solid var(--line);
-	border-bottom-left-radius: var(--bb-radius-sm);
-	border-left: 1px solid var(--line);
+	border-end-start-radius: var(--bb-radius-sm);
+	border-inline-start: 1px solid var(--line);
 	content: '';
 	height: calc(50% + var(--gap));
-	left: calc(var(--indent) / -2);
+	inset-inline-start: calc(var(--indent) / -2);
 	position: absolute;
 	top: calc(var(--gap) * -1);
 	width: calc(var(--indent) / 2);
@@ -803,10 +803,13 @@ your node markup:
 
 ### Large trees and lazy-loaded branches
 
-The whole tree stays mounted: collapsed branches are hidden by CSS, not
-removed, and there is no virtualization. For hundreds of nodes that is fine;
-for folders of unbounded size, don't ship the entire hierarchy up front — load
-children when a branch first opens. `items` is watched deeply, so appending
+A collapsed branch builds its rows the first time it opens and keeps them
+after that (closing hides them by CSS, inert), so a mostly collapsed tree of
+thousands of nodes mounts only what is open. A node you reveal through
+`expandedItems` (a search hit, "expand all") is in the DOM after the next
+tick. There is no virtualization of open branches. For folders of unbounded
+size, don't ship the entire hierarchy up front either: load children when a
+branch first opens. `items` is watched deeply, so appending
 `children` to a node updates the tree in place, and newly appeared branches
 follow the same seeding rules (`expanded: false` keeps them collapsed).
 
@@ -1192,8 +1195,8 @@ States are listed in precedence order: when two are on at once and their entries
 ## Slots
 
 - `default` — scope: `BbTreeNodeSlotProps<Meta>` `{ meta: Meta; item: BbTreeItem<Meta>; parent?: BbTreeItem<Meta>; index: number; depth: number; value: any; expanded: boolean; expandable: boolean; toggleExpanded: () => void; expandProps: BbTreeExpandControllerProps }`
-- `#<value>` (named from data) — scope: `BbTreeNodeSlotProps<Meta>` — One node, by its resolved `item-value` (string or number) through `slotKey`; beats `<depth>`, which beats `default`. Reserved keys (their slot is one of this component's own, so a key spelled like them is an error): `default`.
-- `#<depth>` (named from data) — scope: `BbTreeNodeSlotProps<Meta>` — Every node at one depth (`0` = root); a numeric value can share this name. Reserved keys (their slot is one of this component's own, so a key spelled like them is an error): `default`.
+- `#<value>` (named from data) — scope: `BbTreeNodeSlotProps<Meta>` — One node, by its resolved `item-value` (string or number) through `slotKey`; beats `<depth>`, which beats `default`. Reserved names (their slot is one of this component's own, so an item value or column key spelled like them is an error): `default`.
+- `#<depth>` (named from data) — scope: `BbTreeNodeSlotProps<Meta>` — Every node at one depth (`0` = root); a numeric value can share this name. Reserved names (their slot is one of this component's own, so an item value or column key spelled like them is an error): `default`.
 - `#<value>:children` (named from data) — scope: `BbTreeNodeSlotProps<Meta>` — One node's children container, stopping the recursion there; beats `<depth>:children`. Renders for leaves too.
 - `#<depth>:children` (named from data) — scope: `BbTreeNodeSlotProps<Meta>` — The children container of every node at one depth.
 

package/dist/ai/CommonPopover.md

@@ -22,7 +22,7 @@
 | `bubbleAttrs` | `Record<string, unknown> \| ((space: CommonPopoverAvailableSpace) => Record<string, unknown>) \| undefined` |  |  | Attributes bound on the bubble element (`class`, `style`, `inert`, …), merged after its own `bb-common-popover__bubble` class. Lets the owning component make the bubble its layout container instead of nesting a second box inside it. The function form receives the same free space as the default slot, for attributes that depend on it (a height cap). |
 | `dialog` | `boolean \| undefined` | `false` |  | Renders the popover as a `<dialog>` element (modal overlay) instead of a `<span>` with the Popover API. |
 | `disableFlip` | `boolean \| undefined` | `false` |  | Disables the automatic flip to the opposite side when the popover would overflow (flipping is on by default). |
-| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Renders the bubble's content at mount instead of on the first open. Either way it stays rendered once it has been. |
 | `forceAutoUpdate` | `boolean \| undefined` | `false` |  | Keeps floating-ui's `autoUpdate` (scroll/resize/resize-observer tracking) running while the popover is closed. By default the position is only tracked while the popover is open, so idle popovers attach no listeners. Enable this only when the anchor moves while the popover is closed and the next open must be pixel-perfect immediately. |
 | `hideArrow` | `boolean \| undefined` | `false` |  | Hides the arrow indicator. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to show / hide the bubble. Closed until the owning component opens it. |

package/dist/ai/changelog.json

@@ -1,14 +1,14 @@
 {
 	"schemaVersion": 3,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.47",
+	"version": "3.0.0-beta.49",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"legend": {
 		"id": "the row's stable id: `fNNN` = its row in the register (FOLLOWUPS §F), `css:<class>` = its pair in the class-rename map. Never reused; unchanged when a row is reworded.",
 		"breaking": "every BREAKING change of the v2 → v3 line: register renames, then class renames, then behaviour breaks. Features and fixes are not tracked: an empty slice means nothing breaks.",
 		"kind": "rename = an old name with a successor, or removed (from → to); behaviour = a change that keeps the name (description says what changed).",
-		"surface": "on a rename, what the name is: prop | slot (without the #) | pt (the attribute spelling, camelCase words) | cssVar | class | option (a field of a composable or function argument). Apply a row only on its own surface.",
+		"surface": "on a rename, what the name is: prop | slot (without the #) | pt (the attribute spelling, camelCase words) | cssVar | class | option (a field of a composable or function argument) | item (a field of an `items` entry: `items[].key` is a row's, `items[group].key` a dropdown group's). Apply a row only on its own surface.",
 		"from / to": "the old and new name, nothing else. to = null: removed with no single successor (the note says what to do). Several names in one cell (`--pad-x / --pad-y` → `--px / --py`) pair in order; `<x>` is one dynamic segment; a class row renames its modifiers too (`.old--x` → `.new--x`).",
 		"note": "the prose the register row carries beside the names (a qualifier, the removed-with-hint advice, the modifiers that follow). Absent when there is none.",
 		"firstReleasedIn": "the first published version that shipped the change; null = not released yet. Filter with bitboss-ui changelog --since <your version>.",
@@ -58,7 +58,9 @@
 		"3.0.0-beta.44",
 		"3.0.0-beta.45",
 		"3.0.0-beta.46",
-		"3.0.0-beta.47"
+		"3.0.0-beta.47",
+		"3.0.0-beta.48",
+		"3.0.0-beta.49"
 	],
 	"unpublished": [
 		"3.0.0-alpha.2",
@@ -78,15 +80,16 @@
 		"3.0.0-beta.40"
 	],
 	"summary": {
-		"renames": 213,
-		"behaviourBreaks": 172,
+		"renames": 220,
+		"behaviourBreaks": 187,
 		"bySurface": {
 			"prop": 15,
 			"option": 1,
 			"pt": 14,
 			"slot": 14,
+			"item": 6,
 			"cssVar": 32,
-			"class": 137
+			"class": 138
 		},
 		"unreleased": 0
 	},
@@ -784,6 +787,88 @@
 			"default": "—",
 			"firstReleasedIn": "3.0.0-beta.44"
 		},
+		{
+			"id": "f310",
+			"kind": "rename",
+			"surface": "item",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"from": "items[].key",
+			"to": "items[].value",
+			"since": "2026-10-07, 3.0.0-beta.49 (Q64.2; a row's value is any type, compared by hash: the v-model value, its #<value> slots; v2 rows were { key, text } too)",
+			"default": "—",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f311",
+			"kind": "rename",
+			"surface": "item",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"from": "items[].text",
+			"to": "items[].label",
+			"since": "2026-10-07, 3.0.0-beta.49 (Q64.2; BbDropdownButton's main button reads items[0].label)",
+			"default": "—",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f312",
+			"kind": "rename",
+			"surface": "item",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"from": "items[group].key",
+			"to": "items[group].id",
+			"since": "2026-10-07, 3.0.0-beta.49 (Q64.2; the <BbDropdownGroup id> word; groups are v3-only, so beta-only)",
+			"default": "—",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f313",
+			"kind": "rename",
+			"surface": "item",
+			"components": [
+				"BbTabs",
+				"BbTabsRoot"
+			],
+			"from": "items[].key",
+			"to": "items[].value",
+			"since": "2026-10-07, 3.0.0-beta.49 (Q64.4; v-model carries it; #<value> / #<value>:label, same characters)",
+			"default": "—",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f314",
+			"kind": "rename",
+			"surface": "item",
+			"components": [
+				"BbBreadcrumbs"
+			],
+			"from": "items[].key",
+			"to": "items[].value",
+			"since": "2026-10-07, 3.0.0-beta.49 (Q64.5; names the crumb's slots; a hidden crumb is a dropdown row)",
+			"default": "—",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f315",
+			"kind": "rename",
+			"surface": "item",
+			"components": [
+				"BbBreadcrumbs"
+			],
+			"from": "items[].text",
+			"to": "items[].label",
+			"since": "2026-10-07, 3.0.0-beta.49 (Q64.5)",
+			"default": "—",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
 		{
 			"id": "f015",
 			"kind": "rename",
@@ -2944,6 +3029,20 @@
 			"firstReleasedIn": "3.0.0-beta.36",
 			"guide": "ai/guides/migration/v3-beta-css-classes.md"
 		},
+		{
+			"id": "css:bb-button--active",
+			"kind": "rename",
+			"surface": "class",
+			"components": [
+				".bb-button"
+			],
+			"from": ".bb-button--active",
+			"to": ".bb-button--pressed",
+			"since": "",
+			"default": "",
+			"firstReleasedIn": "3.0.0-beta.48",
+			"guide": "ai/guides/migration/v3-beta-css-classes.md"
+		},
 		{
 			"id": "css:bb-commabox-item--focused",
 			"kind": "rename",
@@ -5596,6 +5695,198 @@
 			"ruling": "owner 2026-10-06 (Q60.9)",
 			"guide": "v2-to-v3.md § 6 item 45 + BbTabs.guide.md § Arrow keys on server strips / § Accessibility",
 			"firstReleasedIn": "3.0.0-beta.47"
+		},
+		{
+			"id": "f306",
+			"kind": "behaviour",
+			"summary": "`v-bb-popover` / `v-bb-hover-card` component portals get no `close`: `emit('close')` closes nothing; use a named portal's slot `close` or the component",
+			"components": [
+				"BbPopover",
+				"BbHoverCard"
+			],
+			"description": "A component portal of v-bb-popover / v-bb-hover-card (v-bb-popover=\"NoteForm\", { portal: NoteForm }) no longer receives an onClose listener, so its emit('close') closes nothing (shipped in 3.0.0-beta.47 for one release). Only a named portal's slot gets close; content that must close its panel becomes a <BbPopoverPortal> / <BbHoverCardPortal> or uses the BbPopover / BbHoverCard component",
+			"ruling": "owner 2026-10-06",
+			"guide": "v2-to-v3.md § 6 item 46 + BbPopover.guide.md / BbHoverCard.guide.md § the directive",
+			"firstReleasedIn": "3.0.0-beta.48"
+		},
+		{
+			"id": "f307",
+			"kind": "behaviour",
+			"summary": "BbButton toggle on: `bb-button--active` → `bb-button--pressed`; new `pt:*:pressed` state",
+			"components": [
+				"BbButton"
+			],
+			"description": "A toggle BbButton (v-model) that is on carries bb-button--pressed, not bb-button--active (no alias): it is pressed (aria-pressed=\"true\"), not \"active\". A rule on .bb-button--active stops matching. Style the on state with the new pt:root:pressed (any part, the state is component-wide), or a selector on .bb-button--pressed / [aria-pressed='true']. There is no active pt state (a pointer press is Tailwind's active: variant) and no current one (activeClass / exactActiveClass)",
+			"ruling": "owner 2026-10-06 (Q60.14, button half)",
+			"guide": "v2-to-v3.md § 6 item 47 + v3-beta-css-classes.md (class row) + BbButton.guide.md § Toggle buttons",
+			"firstReleasedIn": "3.0.0-beta.48"
+		},
+		{
+			"id": "f308",
+			"kind": "behaviour",
+			"summary": "BbTooltip / `v-bb-tooltip`: hover `delay` default 0 → 100 ms; keyboard focus shows at once; 300 ms skip delay between tooltips; `:delay=\"0\"` restores the instant hover open",
+			"components": [
+				"BbTooltip"
+			],
+			"description": "BbTooltip and v-bb-tooltip wait 100 ms on hover before showing (the delay default was 0); keyboard focus shows them at once whatever delay says, and a tooltip the pointer reaches while another shows or within 300 ms of one closing skips its delay (shared by every tooltip, hover cards excluded). A test or flow that hovered and expected the bubble on the next tick waits ~100 ms now; :delay=\"0\" (or { delay: 0 }) restores the instant hover open",
+			"ruling": "owner 2026-10-07 (Q60.22 c)",
+			"guide": "v2-to-v3.md § 6 item 48 + BbTooltip.guide.md § Placement, timing, width and disabling",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f309",
+			"kind": "behaviour",
+			"summary": "Option surfaces read `label` / `text` and `value` by default: `{ label, value }` items need no accessors; a `value` key now becomes the v-model value",
+			"components": [
+				"BbSelect",
+				"BbSelectPopover",
+				"BbRadioGroup",
+				"BbCheckboxGroup",
+				"BbSwitchGroup",
+				"BbDropdown"
+			],
+			"description": "With no item-text / item-value, an option on BbSelect, BbSelectPopover, BbRadioGroup, BbCheckboxGroup, BbSwitchGroup and a mapped BbDropdown group reads its own label (else text) as text and its own value (whatever it holds, null included) as value; before, JSON.stringify(item) and the whole object. Object items with a value key and no item-value now put item.value in v-model (:item-value=\"(item) => item\" keeps the old value). An explicit accessor wins; primitives and BbTable rows unchanged",
+			"ruling": "owner 2026-10-07 (Q60.24)",
+			"guide": "v2-to-v3.md § 6 item 49 + the five guides' items section + options-items-playbook.md",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f316",
+			"kind": "behaviour",
+			"summary": "A single dropdown group with a `null` v-model shows its `value: null` row checked (the None row); a hand-written group's v-model holds row `value`s, not `key` strings",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"description": "A single-choice BbDropdown / BbDropdownButton group whose v-model is null (or that has no selection) shows its value: null row checked, the \"None\" row, as BbSelect / BbRadioGroup already do (they match by hash); picking it emits null. A hand-written group's v-model holds its rows' values (any type, compared by hash) where it held their key strings",
+			"ruling": "owner 2026-10-07 (Q64.3)",
+			"guide": "v2-to-v3.md § 6 item 50 + components/bb-dropdown.md",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f317",
+			"kind": "behaviour",
+			"summary": "Slots and useBbDropdownContext follow the fields: `{ text }` → `{ label }`; slot `group.key` → `group.id`; `#empty` `groupKey` → `groupId`; context by `id`, `selectedOptions[].label`",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton",
+				"BbTabs",
+				"BbBreadcrumbs"
+			],
+			"description": "Slot scopes and useBbDropdownContext follow the item fields: the row slots of BbDropdown / BbDropdownButton, BbTabs' #<value>:label / #label and BbBreadcrumbs' crumb slots hand { label } where they handed { text }; a row slot's group carries id (was key); the #loading / #empty slots' groupKey is groupId; useBbDropdownContext keys its groups by id and its selectedOptions[] carry label (was text). A destructured { text } reads undefined, no error",
+			"ruling": "owner 2026-10-07 (Q64.2–Q64.5)",
+			"guide": "v2-to-v3.md § 6 item 51 + components/bb-dropdown.md / bb-tabs.md / bb-breadcrumbs.md",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f318",
+			"kind": "behaviour",
+			"summary": "`bitboss-ui check` kinds: `missing-key` → `missing-value` / `missing-id`, `duplicate-row-text` → `duplicate-row-label`; new `renamed-item-field` (ESLint `no-renamed-item-field`)",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"description": "bitboss-ui check kinds follow the dropdown fields: missing-key is missing-value (a selectable group's row) or missing-id (a selectable group), duplicate-row-text is duplicate-row-label; the old fields themselves are the new renamed-item-field (check --fix, ESLint bitboss-ui/no-renamed-item-field). A script that matches the old kind names in check --json output needs the new ones (ESLint disable comments name rules, unchanged)",
+			"ruling": "owner 2026-10-07 (Q64.2)",
+			"guide": "v3-beta-tooling.md",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f319",
+			"kind": "behaviour",
+			"summary": "BbPopover is non-modal by default (page stays live, outside click closes and lands, Tab out closes); `modal` restores the modal dialog; the phone sheet stays modal",
+			"components": [
+				"BbPopover"
+			],
+			"description": "BbPopover is a non-modal dialog by default: a role=\"dialog\" panel without aria-modal, the page behind stays clickable, focusable and scrollable, an outside click closes it and still reaches its target (focus stays there), Escape closes it, and Tab past the last control (or Shift+Tab before the first) leaves and closes it. modal (new, default false) restores the modal <dialog> exactly (focus trap, inert page, no scroll). The phone sheet stays modal either way. Applies to v-bb-popover and the popover portals too (modal through the directive's options)",
+			"ruling": "owner 2026-10-07 (Q60.10)",
+			"guide": "v2-to-v3.md § 6 item 52 + BbPopover.guide.md § Accessibility",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f320",
+			"kind": "behaviour",
+			"summary": "BbForm locks while a promise `@submit` runs: joined fields read-only, `type=submit` buttons spin; opt out with `disable-submit-lock`",
+			"components": [
+				"BbForm",
+				"BbButton"
+			],
+			"description": "While a @submit that returned a promise is pending, every field joined to the BbForm is read-only (never disabled; aria-readonly) and every type=\"submit\" BbButton inside spins; both end when it settles. A sync submit never locks. Opt out with disable-submit-lock. A useBbFormField handle gains readonly",
+			"ruling": "owner 2026-10-07 (Q60.17)",
+			"guide": "v2-to-v3.md § 6 item 53 + BbForm.guide.md § While it saves",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f321",
+			"kind": "behaviour",
+			"summary": "Adjacent `group` toggle BbButtons are one Tab stop with ArrowLeft/Right, Home/End inside (roving tabindex); aria-pressed unchanged",
+			"components": [
+				"BbButton"
+			],
+			"description": "Adjacent group toggle BbButtons (each with a v-model, side by side under one parent) are one Tab stop: Tab lands on the pressed button (else the one last focused, else the first), ArrowLeft / ArrowRight (mirrored under dir=\"rtl\", wrapping) and Home / End move focus between them, Space / Enter toggle; disabled and loading buttons are skipped. Each button keeps aria-pressed; group buttons without a v-model, a lone toggle and toggles split by another element keep one Tab stop each. A keyboard test that Tabs through such a set reaches one button, not each",
+			"ruling": "owner 2026-10-07 (Q44.25-001)",
+			"guide": "v2-to-v3.md § 6 item 54 + BbButton.guide.md § Toggle buttons",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f322",
+			"kind": "behaviour",
+			"summary": "BbNumberInput formats live in the locale (`10.005,6`): the DOM text is formatted, paste reads locale grouping and `(1,234.56)` as negative; `disable-formatting` restores the old field",
+			"components": [
+				"BbNumberInput"
+			],
+			"description": "BbNumberInput shows its number the locale's way while the user types (Q60.25: 10005,6 shows 10.005,6 in it, 10,005.6 in en; grouping per CLDR, so it shows 1000 and then 10.000). The DOM text is the formatted one: event.target.value, pt:input listeners and a consumer maxlength / pattern see it. A typed , or . is always the decimal (Q51.2's key-by-key reclassify stays); a pasted number written the locale's way is read that way (it 1.000 pasted is 1000, was 1; en 1,234 pasted is 1234, was 1.234), and a paste keeps only the FIRST number inside the text (Q60.25b round 5 + owner round 7: $1,234.56 - $2,000 is 1234.56, never the digits run together; (1,234.56) is -1234.56, was 1234.56; 1.2E+05 is 120000, was 1.205; 15 m² is 15, was 152). Leading zeros stay while focused (1.|005 Backspace leaves 005); blur rebuilds the text from the model (1,50 → 1,5); a bare - keeps the last valid value in the model instead of emitting null. disable-formatting (new) restores the previous field exactly; min-precision (new, additive) pads decimals",
+			"ruling": "owner 2026-10-07 (Q60.25)",
+			"guide": "v2-to-v3.md § 6 item 55 + BbNumberInput.guide.md § Locale display",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f323",
+			"kind": "behaviour",
+			"summary": "BbNumberInput posts through a hidden input carrying `name` and the raw value; the visible input has no `name` (`form.elements[name]` is the hidden one)",
+			"components": [
+				"BbNumberInput"
+			],
+			"description": "BbNumberInput posts through a hidden input: name moves to a sibling <input type=\"hidden\"> carrying the raw period value (10005.6), and the visible input has no name. form.elements[name], input[name=x] and FormData find the hidden input; a test or script that typed into input[name=x] targets the spinbutton (input[role=\"spinbutton\"]). Not with disable-formatting",
+			"ruling": "owner 2026-10-07 (Q60.25)",
+			"guide": "v2-to-v3.md § 6 item 55 + BbNumberInput.guide.md § Locale display",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f324",
+			"kind": "behaviour",
+			"summary": "BbNumberInput `currency` / `unit` paint the symbol inside the text (`$1,234.50`, `20 kg`); `event.target.value`, `pt:input`, `maxlength` / `pattern` see it; the model stays the number",
+			"components": [
+				"BbNumberInput"
+			],
+			"description": "BbNumberInput currency (new, ISO 4217) / unit (new, an Intl unit) paint the symbol or unit INSIDE the editable text, the locale's way ($1,234.50, 1234,50 €, CHF-1’234.56, 20 kg, 15%): event.target.value, pt:input listeners and a consumer maxlength / pattern see the shell too (a maxlength counts it); Home / End move the caret to the number's edges, never the value; the unit follows the number's plural (1 hr, 2 hrs) and at rest aria-valuetext is the spoken amount (1,234.50 US dollars). unit is typed (BbNumberUnit: kilowatt, square-meter are type errors). The model stays the number (unit=\"percent\" showing 15% is 15); currency sets the decimals unless min-precision / max-precision are set; disable-formatting ignores both",
+			"ruling": "owner 2026-10-07 (Q60.25b)",
+			"guide": "v2-to-v3.md § 6 item 55 + BbNumberInput.guide.md § Currency & unit fields",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f325",
+			"kind": "behaviour",
+			"summary": "BbNumberInput with `max-precision` below 3: a second typed `,` / `.` is refused (`1.234,50` in EUR stays `1,23 €`); at 0 a typed mark refuses later digits (`12,5` is 12)",
+			"components": [
+				"BbNumberInput"
+			],
+			"description": "BbNumberInput with max-precision=\"0\" (and a 0-digit currency, JPY): a typed , or . stays in the text and the digits after it are refused (12,5 is 12, was 125, a 100× amount); blur drops the mark. A paste of 12,5 truncates to 12 (never rounded). With max-precision below 3 (0–2, every currency field) a second typed , / . is refused once a decimal exists (owner: no hold rule): it EUR 1.234,50 stays 1,23 €, en 1,234 is 1.23; Q51.2's reclassify (1.234,56 → 1234.56) works only in fields with 3+ decimals",
+			"ruling": "owner 2026-10-07 (Q60.25b)",
+			"guide": "v2-to-v3.md § 6 item 55 + BbNumberInput.guide.md § Bounds & precision, § Locale display",
+			"firstReleasedIn": "3.0.0-beta.49"
+		},
+		{
+			"id": "f326",
+			"kind": "behaviour",
+			"summary": "BbNumberInput: `-` typed anywhere flips the sign in every field (was only at the start); a digit typed before the minus lands after it",
+			"components": [
+				"BbNumberInput"
+			],
+			"description": "BbNumberInput: - typed anywhere flips the sign (was: only at the start; elsewhere ignored), in every field; the caret stays on its digit, and a digit typed before a negative's minus lands after it (-512, was a broken 5-12). Not with disable-formatting (the old field)",
+			"ruling": "owner 2026-10-07 (Q60.25b)",
+			"guide": "v2-to-v3.md § 6 item 55 + BbNumberInput.guide.md § Locale display",
+			"firstReleasedIn": "3.0.0-beta.49"
 		}
 	]
 }