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

package/dist/ai/changelog.json

@@ -1,12 +1,47 @@
 {
-	"schemaVersion": 1,
+	"schemaVersion": 2,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.21",
+	"version": "3.0.0-beta.23",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
+	"releases": [
+		"3.0.0-alpha.1",
+		"3.0.0-alpha.2",
+		"3.0.0-alpha.3",
+		"3.0.0-alpha.4",
+		"3.0.0-alpha.5",
+		"3.0.0-alpha.6",
+		"3.0.0-alpha.7",
+		"3.0.0-alpha.8",
+		"3.0.0-alpha.9",
+		"3.0.0-beta.0",
+		"3.0.0-beta.1",
+		"3.0.0-beta.2",
+		"3.0.0-beta.3",
+		"3.0.0-beta.4",
+		"3.0.0-beta.5",
+		"3.0.0-beta.6",
+		"3.0.0-beta.7",
+		"3.0.0-beta.8",
+		"3.0.0-beta.9",
+		"3.0.0-beta.10",
+		"3.0.0-beta.11",
+		"3.0.0-beta.12",
+		"3.0.0-beta.13",
+		"3.0.0-beta.15",
+		"3.0.0-beta.16",
+		"3.0.0-beta.17",
+		"3.0.0-beta.18",
+		"3.0.0-beta.19",
+		"3.0.0-beta.20",
+		"3.0.0-beta.21",
+		"3.0.0-beta.22",
+		"3.0.0-beta.23"
+	],
 	"summary": {
 		"renames": 9,
-		"behaviourBreaks": 50
+		"behaviourBreaks": 52,
+		"unreleased": 0
 	},
 	"breaking": [
 		{
@@ -17,7 +52,8 @@
 			"from": "querykey",
 			"to": "queryKey",
 			"since": "2026-07-15, unreleased",
-			"default": "'page'"
+			"default": "'page'",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "rename",
@@ -28,7 +64,8 @@
 			"from": "querykey",
 			"to": "queryKey",
 			"since": "2026-07-15, unreleased",
-			"default": "'tab'"
+			"default": "'tab'",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "rename",
@@ -38,7 +75,8 @@
 			"from": "direction",
 			"to": "side",
 			"since": "2026-07-19, unreleased",
-			"default": "'left'"
+			"default": "'left'",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "rename",
@@ -48,7 +86,8 @@
 			"from": "hidePopover",
 			"to": "disableCalendar",
 			"since": "2026-07-23, unreleased",
-			"default": "false"
+			"default": "false",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "rename",
@@ -59,7 +98,8 @@
 			"from": "datetime",
 			"to": "type",
 			"since": "2026-08-05, unreleased",
-			"default": "'date'"
+			"default": "'date'",
+			"firstReleasedIn": "3.0.0-alpha.5"
 		},
 		{
 			"kind": "rename",
@@ -70,7 +110,8 @@
 			"from": "enabledWhileLoading",
 			"to": "interactiveWhileLoading",
 			"since": "2026-07-24, unreleased",
-			"default": "false"
+			"default": "false",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "rename",
@@ -80,7 +121,8 @@
 			"from": "canvasProps",
 			"to": "offCanvasProps",
 			"since": "2026-07-19, unreleased",
-			"default": "{}"
+			"default": "{}",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "rename",
@@ -94,7 +136,8 @@
 			"from": "offcanvasProps",
 			"to": "offCanvasProps",
 			"since": "2026-07-19, unreleased",
-			"default": "{}"
+			"default": "{}",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "rename",
@@ -104,307 +147,372 @@
 			"from": "total",
 			"to": "totalItems",
 			"since": "2026-08-06, unreleased",
-			"default": "0"
+			"default": "0",
+			"firstReleasedIn": "3.0.0-alpha.5"
 		},
 		{
 			"kind": "behaviour",
 			"description": "Variant types locked to registries (8 components); IconRegistry export removed",
 			"ruling": "A#5",
-			"guide": "v2-to-v3.md §variants"
+			"guide": "v2-to-v3.md §variants",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbBase* input controls + CommonInputWrapper/CommonInputOuterContainer un-exported (reference-only); BbBaseButton + glyphs stay",
 			"ruling": "G3.3",
-			"guide": "v2-to-v3.md §5.1"
+			"guide": "v2-to-v3.md §5.1",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "hideArrow/showArrow/arrowPadding removed (BbPopover, BbSelectPopover, BbColorPalette, BbDropdown)",
 			"ruling": "B#10",
-			"guide": "components/bb-popover.md (+siblings)"
+			"guide": "components/bb-popover.md (+siblings)",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTree ARIA tree roles removed; collapsed branches inert",
 			"ruling": "D#25",
-			"guide": "components/bb-tree.md"
+			"guide": "components/bb-tree.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTag trims entries + case-folds duplicate matching (new case-sensitive)",
 			"ruling": "D#24 / F2.1b",
-			"guide": "components/bb-tag.md"
+			"guide": "components/bb-tag.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbBreadcrumbs item key narrowed string \\",
 			"ruling": "number → string",
-			"guide": "F2.1"
+			"guide": "F2.1",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "slotKey slot-name normalization (BbBreadcrumbs, BbTree, BbBaseDatePicker)",
 			"ruling": "A#7 / F2.2",
-			"guide": "per-component files"
+			"guide": "per-component files",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTabs: label-<key> → label:<key>, pane slots + URL slug + DOM ids normalized",
 			"ruling": "A#7 / F2.2",
-			"guide": "components/bb-tabs.md"
+			"guide": "components/bb-tabs.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "enforce-coherence + seeded value prunes on mount",
 			"ruling": "E1",
-			"guide": "components/bb-select.md / bb-select-popover.md"
+			"guide": "components/bb-select.md / bb-select-popover.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable: #loading first-load-only; rows/header inert while loading",
 			"ruling": "E4",
-			"guide": "components/bb-table.md"
+			"guide": "components/bb-table.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "Single select: second click on the selected option no longer clears",
 			"ruling": "E5",
-			"guide": "components/bb-select.md / bb-select-popover.md"
+			"guide": "components/bb-select.md / bb-select-popover.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "prefill: false is search-first (was indistinguishable from 'interaction')",
 			"ruling": "E6",
-			"guide": "components/bb-select.md / bb-select-popover.md"
+			"guide": "components/bb-select.md / bb-select-popover.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbSwitchGroup multiple: false now honored — bare-value emit (was a silent no-op, always arrays)",
 			"ruling": "DECISIONS §G",
-			"guide": "components/bb-checkbox-group.md"
+			"guide": "components/bb-checkbox-group.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbSelect hidden inputs: empty selection posts no field (was name=null for single-empty)",
 			"ruling": "DECISIONS §G",
-			"guide": "components/bb-select.md"
+			"guide": "components/bb-select.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbPopover defineExpose (show/close/isOpen via template ref) removed → v-model",
 			"ruling": "F#/expose",
-			"guide": "components/bb-popover.md"
+			"guide": "components/bb-popover.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTextInput defineExpose (focus/blur/select via template ref) removed → autofocus/native input",
 			"ruling": "F#/expose",
-			"guide": "components/bb-text-input.md"
+			"guide": "components/bb-text-input.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbNumberInput defineExpose (increase/decrease via template ref) removed → slot scope / v-model",
 			"ruling": "F#/expose",
-			"guide": "components/bb-text-input.md (sibling note)"
+			"guide": "components/bb-text-input.md (sibling note)",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbDropdown defineExpose (loading via template ref) removed → activator slot scope loading",
 			"ruling": "F#/expose",
-			"guide": "components/bb-dropdown.md"
+			"guide": "components/bb-dropdown.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "confirm(): a superseding call now resolves the previous promise false (was never settled — hung)",
 			"ruling": "DECISIONS §G",
-			"guide": "components/use-confirm.md"
+			"guide": "components/use-confirm.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbDropdown group heading text → label; new hideLabel keeps label without a heading (items keep text)",
 			"ruling": "F#/dropdown-label",
-			"guide": "components/bb-dropdown.md"
+			"guide": "components/bb-dropdown.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "tag props narrowed to per-family unions (BbButton/BbBaseButton, BbSmoothHeight, BbDropzone, BbBaseInputContainer tag+labelTag)",
 			"ruling": "F#/tag-unions",
-			"guide": "components/bb-button.md (+siblings)"
+			"guide": "components/bb-button.md (+siblings)",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "CommonPopover wrapper+bubble <span> → <div> (BbPopover/BbDropdown/submenus); BbTooltip + BbSelectPopover stay span",
 			"ruling": "F#/tag-unions",
-			"guide": "components/bb-popover.md, components/bb-dropdown.md"
+			"guide": "components/bb-popover.md, components/bb-dropdown.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbPopover panel PARTS <span> → <div> (__panel, __header, __content, __footer) — finishes the wrapper change one level in",
 			"ruling": "Q18.14",
-			"guide": "components/bb-popover.md"
+			"guide": "components/bb-popover.md",
+			"firstReleasedIn": "3.0.0-beta.17"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbSmoothHeight inner measuring element mirrors tag (was always <div>) — span now yields span-in-span",
 			"ruling": "F#/tag-unions",
-			"guide": "components/bb-smooth-height.md (new)"
+			"guide": "components/bb-smooth-height.md (new)",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbBadge DOM: label/icons now wrapped in .bb-badge__body + .bb-badge__trailing; only direct-child CSS selectors break",
 			"ruling": "F#/badge-sides",
-			"guide": "components/bb-badge.md"
+			"guide": "components/bb-badge.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "Checkbox/radio/switch **groups**: disabled and selectable: false now disable a SELECTED option too (it was interactive, so the selection could be cleared)",
 			"ruling": "Q18.1",
-			"guide": "components/bb-checkbox-group.md"
+			"guide": "components/bb-checkbox-group.md",
+			"firstReleasedIn": "3.0.0-beta.16"
 		},
 		{
 			"kind": "behaviour",
 			"description": "bitbossUiPlugin takes per-app config overrides (app.use(plugin, { locale })); setConfig from module scope now warns — it can only reach the build-time defaults",
 			"ruling": "Q18.2",
-			"guide": "v2-to-v3.md"
+			"guide": "v2-to-v3.md",
+			"firstReleasedIn": "3.0.0-beta.16"
 		},
 		{
 			"kind": "behaviour",
 			"description": "Segmented-field anatomy uses ONE neutral element family, bb-segmented-field__*, on BOTH the date and time inputs — __fields(--empty/--range), __placeholder, __field-sizer, __field (+ all segment modifiers), __separator(--range), __calendar-btn→__trigger-btn(--active), __calendar-icon→__trigger-icon. **Breaking for the DATE input**, whose element classes were previously bb-base-date-picker-input__*. Block names are unchanged (.bb-base-date-picker-input / .bb-base-time-picker-input are still the roots), so single-control rules stay expressible. Dropped: __calendar/__calendar--shown and __clock-btn (all styled nowhere)",
 			"ruling": "DECISIONS §I",
-			"guide": "components/bb-date-picker-input.md"
+			"guide": "components/bb-date-picker-input.md",
+			"firstReleasedIn": "3.0.0-alpha.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "bb-base-input-container__layout--hidden-label no longer rendered — it duplicated --reverse exactly and was styled nowhere",
 			"ruling": "DECISIONS §I",
-			"guide": "components/bb-text-input.md (family note)"
+			"guide": "components/bb-text-input.md (family note)",
+			"firstReleasedIn": "3.0.0-alpha.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbSpinner dot modifiers namespaced: .circle--N → .bb-spinner__circle--N",
 			"ruling": "DECISIONS §I",
-			"guide": "components/bb-spinner.md"
+			"guide": "components/bb-spinner.md",
+			"firstReleasedIn": "3.0.0-alpha.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "Listbox option rows drop their v2 autocomplete-option* class names; states and inner parts move onto bb-listbox__option* (--focused/--selected/--disabled, -label, -check)",
 			"ruling": "DECISIONS §I",
-			"guide": "components/bb-select.md (+ bb-select-popover.md pointer)"
+			"guide": "components/bb-select.md (+ bb-select-popover.md pointer)",
+			"firstReleasedIn": "3.0.0-alpha.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable #no-data fills the table's own full-width <td> (was: the slot replaced the empty-state <tr>)",
 			"ruling": "F#/no-data-shell",
-			"guide": "components/bb-table.md"
+			"guide": "components/bb-table.md",
+			"firstReleasedIn": "3.0.0-alpha.1"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable row events click:row / contextmenu:row / dblclick:row emit (event, item) with item the RAW record (was the internal row wrapper with the record at row.item) and no trailing selected boolean",
 			"ruling": "owner 2026-08-25, plans/BBTABLE-GRID.md",
-			"guide": "components/bb-table.md § Row events"
+			"guide": "components/bb-table.md § Row events",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable: hiding a column with thClass/tdClass + display: none (the v2/early-v3 narrow-screen recipe) no longer works — a hidden grid item keeps its track and shifts the following cells; set hidden: true on the column instead (filtering it out of columns was the beta.20 doctrine and lost the key from a partial order — DECISIONS § Column visibility, 2026-09-07)",
 			"ruling": "grid substrate, plans/BBTABLE-GRID.md",
-			"guide": "components/bb-table.md § Do not override; guide § Narrow screens"
+			"guide": "components/bb-table.md § Do not override; guide § Narrow screens",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable actions prop removed — the #actions slot creates the column (a prop without the slot rendered an empty column; now it renders nothing)",
 			"ruling": "DECISIONS § Column pins, 2026-09-07",
-			"guide": "components/bb-table.md § The #actions slot creates the actions column"
+			"guide": "components/bb-table.md § The #actions slot creates the actions column",
+			"firstReleasedIn": "3.0.0-beta.21"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable fixedColumns (rendered-slot indices) removed — fixed: 'left' \\",
 			"ruling": "'right' on the column definition + fixed-select / fixed-actions; pins follow the column through a reorder, sticky in place as before",
-			"guide": "DECISIONS § Column pins, 2026-09-07"
+			"guide": "DECISIONS § Column pins, 2026-09-07",
+			"firstReleasedIn": "3.0.0-beta.21"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable column snap takes the PARENT's column key ('select' / 'actions' by name, inclusive pairs, 'key.5' fractions) instead of a gridline index; --table-{id}-track-{index} became --table-{id}-track-{key} (slot-name spelling). Numeric snaps are ignored at runtime",
 			"ruling": "DECISIONS § Keyed snap, 2026-09-07",
-			"guide": "components/bb-table.md § snap names the parent column"
+			"guide": "components/bb-table.md § snap names the parent column",
+			"firstReleasedIn": "3.0.0-beta.21"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable highlight is opt-in: with highlighted unbound (or bound as undefined) clicking a row no longer applies bb-table-data__row--highlighted / aria-current — the table used to drive defineModel's local fallback, an unreadable state the app could not clear. Bind ref(null), not ref(); a context seed counts. click:row is unaffected",
 			"ruling": "owner 2026-08-27",
-			"guide": "components/bb-table.md § Highlight is opt-in"
+			"guide": "components/bb-table.md § Highlight is opt-in",
+			"firstReleasedIn": "3.0.0-beta.9"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable renders a CSS grid of divs with ARIA roles, not a <table>: every element selector under .bb-table (table/thead/tbody/tfoot/caption/tr/th/td/colgroup/col) matches nothing. Every .bb-table* class survives; .bb-table__table/__head/__body/__foot + [role=row]/[role=columnheader]/[role=cell] are the blessed translation (no data-* hooks, no shim classes)",
 			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem",
-			"guide": "components/bb-table.md § Selector translation"
+			"guide": "components/bb-table.md § Selector translation",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable #thead / #tbody / #tfoot inner markup: role-complete <div role=\"row\"> holding <div role=\"columnheader\\",
 			"ruling": "cell\"> — never <tr>/<th>/<td>; #tfoot's columnCount now feeds grid-column: span N / 1 / -1 (+ aria-colspan), not colspan. A custom #thead over an empty table publishes no tracks",
-			"guide": "plans/BBTABLE-GRID.md § Non-negotiables (exception 1)"
+			"guide": "plans/BBTABLE-GRID.md § Non-negotiables (exception 1)",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable --fill custom property removed (not republished) — it fed the fixed-layout self-correction loop the grid does not have",
 			"ruling": "plans/BBTABLE-GRID.md § Tracks (RULED 2026-08-26)",
-			"guide": "components/bb-table.md § --fill and --natural-width are removed"
+			"guide": "components/bb-table.md § --fill and --natural-width are removed",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable --natural-width custom property removed (not republished) — republishing the resolved-track sum would publish the container width under a \"natural\" name",
 			"ruling": "plans/BBTABLE-GRID.md § Tracks (RULED 2026-08-26)",
-			"guide": "components/bb-table.md § --fill and --natural-width are removed"
+			"guide": "components/bb-table.md § --fill and --natural-width are removed",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable track-distribution drift: surplus split equally among auto columns (748/52 → 544/256), constrained wrapping grows tracks by equal increments (~22% narrower long column, taller rows), frozen+auto ≤ ~19px/column, all-frozen tables no longer inflate the select/actions columns, scroll-container cells no longer floor the column (max-width: 0 ellipsis trick breaks), % widths in an overflowing table resolve against min-content (30%: 181 → 303px), expand-row content never widens parent columns, orphan snap → auto. Overflow threshold, wrap floor, frozen px and fixed equal split are exact",
 			"ruling": "plans/BBTABLE-GRID.md § Tracks + § v2.1",
-			"guide": "components/bb-table.md § Column widths: what holds and what drifts"
+			"guide": "components/bb-table.md § Column widths: what holds and what drifts",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable copy-to-spreadsheet degrades: Chrome's selection serializer keys off computed display, so a selected grid pastes one value per line (was one cell per column). Accepted; sanctioned path = app-level \"copy as TSV from the items model\" recipe (queued, not shipped)",
 			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem (7)",
-			"guide": "components/bb-table.md § Copy-to-spreadsheet degrades"
+			"guide": "components/bb-table.md § Copy-to-spreadsheet degrades",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable print header repetition lost — <thead> page-repetition has no grid equivalent; data rows get break-inside: avoid",
 			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem (8)",
-			"guide": "components/bb-table.md § Print: header repetition is gone"
+			"guide": "components/bb-table.md § Print: header repetition is gone",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable: global element CSS (table/td resets, .prose table, stray td { padding }) silently stops reaching the table — immunity benefit AND a silent look change on pages that leaned on it",
 			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem (9)",
-			"guide": "components/bb-table.md § Global element CSS no longer reaches the table"
+			"guide": "components/bb-table.md § Global element CSS no longer reaches the table",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable browser floor raised to subgrid engines (Chrome/Edge 117, Firefox 71, Safari 16), block align-content centring from Chrome 123 / Safari 17.4 / Firefox 125; no @supports fallback",
 			"ruling": "plans/BBTABLE-GRID.md § Non-negotiables + § CSS port rules",
-			"guide": "components/bb-table.md § Browser floor"
+			"guide": "components/bb-table.md § Browser floor",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable contain: inline-size (+ min-width: 0, grid-column: 1 / -1) on the expand / no-data / loading cells is load-bearing — overriding it lets full-span content resize the tracks (runaway loop with a nested inheriting table); joins gap: 0 on the root and nowrap on the actions cell in the do-not-override list",
 			"ruling": "plans/BBTABLE-GRID.md § Measurement & track publishing",
-			"guide": "components/bb-table.md § Do not override"
+			"guide": "components/bb-table.md § Do not override",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable caption reading-order micro-drift: .bb-table-caption is a div before the role=table root (named via aria-labelledby), no longer the table's first child",
 			"ruling": "plans/BBTABLE-GRID.md § Accessibility",
-			"guide": "components/bb-table.md § Small semantic and visual changes"
+			"guide": "components/bb-table.md § Small semantic and visual changes",
+			"firstReleasedIn": "3.0.0-beta.6"
 		},
 		{
 			"kind": "behaviour",
 			"description": "BbTable busy bar now rides with the stuck header under fixed-headers (sticky moved to the .bb-table__head rowgroup; multi-row #thead heads stack instead of overlapping; aria-rowcount = totalItems + 1)",
 			"ruling": "plans/BBTABLE-GRID.md § Sticky + § v2.1",
-			"guide": "components/bb-table.md § Small semantic and visual changes"
+			"guide": "components/bb-table.md § Small semantic and visual changes",
+			"firstReleasedIn": "3.0.0-beta.6"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTooltip width compiles to max-width, not width — the bubble wraps at the measure but still shrinks to short text (a 150px hint no longer sits in a 300px box). Unset bubbles gain a 40ch default cap (--max-w on .bb-tooltip) instead of running the viewport width. Values v2 mis-parsed now work: '20rem' was read as 20px, and 'auto'/calc()/min() threw during render. % is still measured against the activator. BbPopover / BbDropdown / BbSelectPopover width is untouched and still fixes",
+			"ruling": "owner 2026-09-09",
+			"guide": "components/bb-tooltip.md § width caps the bubble instead of fixing it",
+			"firstReleasedIn": "3.0.0-beta.22"
+		},
+		{
+			"kind": "behaviour",
+			"description": "Every component's visually-hidden helper class renamed .sr-only → .bb-sr-only (accessible names, status announcements, the clipped native inputs behind checkbox/radio/switch/rating/slider). Only a consumer selector reaching INTO a component for .sr-only breaks; a consumer's own Tailwind sr-only is untouched. Reason: the library must not share a class name with the consumer's utility layer — under cascade layers the consumer's utilities copy outranks ours, and a project redefining .sr-only would silently restyle our internals. Phase 0 of the cascade-layers work",
+			"ruling": "owner 2026-09-09 (Tailwind-name isolation)",
+			"guide": "v2-to-v3.md §5.6",
+			"firstReleasedIn": "3.0.0-beta.22"
 		}
 	]
 }