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

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/changelog.json

@@ -1,14 +1,14 @@
 {
 	"schemaVersion": 3,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.48",
+	"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>.",
@@ -59,7 +59,8 @@
 		"3.0.0-beta.45",
 		"3.0.0-beta.46",
 		"3.0.0-beta.47",
-		"3.0.0-beta.48"
+		"3.0.0-beta.48",
+		"3.0.0-beta.49"
 	],
 	"unpublished": [
 		"3.0.0-alpha.2",
@@ -79,13 +80,14 @@
 		"3.0.0-beta.40"
 	],
 	"summary": {
-		"renames": 214,
-		"behaviourBreaks": 174,
+		"renames": 220,
+		"behaviourBreaks": 187,
 		"bySurface": {
 			"prop": 15,
 			"option": 1,
 			"pt": 14,
 			"slot": 14,
+			"item": 6,
 			"cssVar": 32,
 			"class": 138
 		},
@@ -785,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",
@@ -5636,6 +5720,173 @@
 			"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"
 		}
 	]
 }