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

package/bin/bitboss-ui.mjs

@@ -78,6 +78,11 @@ import {
 import { applyBitbossFixes } from '../scripts/lib/check-fix.mjs';
 import { stringControlsFor } from '../scripts/lib/text-null-value.mjs';
 import { projectResolution } from '../scripts/lib/unimported-components.mjs';
+import {
+	MAY_HAVE_PORTALS,
+	portalFindings,
+	projectPortalIndex,
+} from '../scripts/lib/portal-names.mjs';
 import { cssClassFindings } from '../scripts/lib/css-class-check.mjs';
 import {
 	cssLocalFindings,
@@ -1083,6 +1088,43 @@ async function checkCommand(
 		}
 	}
 
+	// Q63.8: portal names, judged against the whole project's declarations
+	// and call sites (scripts too: `confirm({ portal })` lives there). A full
+	// run reads every source file; explicit paths / `--changed`, only those.
+	// Markdown fences are never read: a doc names portals it never declares.
+	{
+		const portalIndex = projectPortalIndex(projectRoot);
+		const PORTAL_SOURCE = /\.(?:vue|[cm]?[jt]sx?)$/;
+		const TEST_FILE = /\.(?:test|spec)(?:-d)?\.[cm]?[jt]sx?$/;
+		const portalScope = (
+			changed ? changed.all : globs.length ? files : projectSources
+		).filter(
+			(path) =>
+				PORTAL_SOURCE.test(path) &&
+				!path.endsWith('.d.ts') &&
+				!TEST_FILE.test(path)
+		);
+		for (const path of portalScope) {
+			let content;
+			try {
+				content = readText(path);
+			} catch {
+				continue;
+			}
+			if (!MAY_HAVE_PORTALS.test(content)) continue;
+			const isDisabled = disabledChecker(content);
+			for (const finding of portalFindings(content, path, portalIndex)) {
+				if (isDisabled(finding.line, ruleForFinding(finding))) {
+					suppressed++;
+					continue;
+				}
+				const entry = { file: relative(projectRoot, path), ...finding };
+				if (finding.severity === 'warning') warnings.push(entry);
+				else findings.push(entry);
+			}
+		}
+	}
+
 	for (const [name, file] of projectLocal) warnLocal(name, file);
 	// Q60.6: a `vue-tsc` below 3, read from package.json. One line, never
 	// fatal. (A missing `checkUnknownComponents` is no longer warned about:
@@ -1410,6 +1452,13 @@ Commands:
                       \`v-bb-hover-card="user-card"\` without the inner
                       quotes: an expression, not a portal name; write
                       \`"'user-card'"\`),
+                      \`unknown-portal\` (\`v-bb-hover-card\` /
+                      \`v-bb-popover\` / \`confirm()\` names a portal no
+                      \`<…Portal name>\` in the project declares; did-you-mean
+                      in the message), \`portal-family-mismatch\` (a
+                      hover-card portal opened by \`v-bb-popover\`, or the
+                      other way round; literal names only, a \`:name\`
+                      binding or a non-literal call site is never judged),
                       \`positional-provider\` (an \`items\` provider with
                       positional arguments: it receives one object,
                       \`({ query, reason, modelValue, signal })\`),
@@ -1470,7 +1519,9 @@ Commands:
                       component uses the \`Bb\` prefix; rename it),
                       \`single-reason\` (an \`items\` provider that tests
                       \`reason\` against one cause other than \`'search'\`;
-                      check \`reason !== 'search'\`), \`vue-tsc-major\`
+                      check \`reason !== 'search'\`), \`unused-portal\` (a
+                      \`<…Portal name>\` nothing opens: no call site and the
+                      name in no string of the project), \`vue-tsc-major\`
                       (\`vue-tsc\` below 3 in package.json: the generic
                       components' props go unchecked).
   changelog [--since <version>] [--until <version>] [--json]

package/dist/ai/BbAccordion.md

@@ -643,7 +643,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | 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: `header`, `panel`, `root`. States: `open`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbAccordionProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
-| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Renders the content at mount, while closed, instead of on the first open. Closed content is `inert` and `aria-hidden` either way. |
 | `headingLevel` | `1 \| 2 \| 3 \| 4 \| 5 \| 6 \| undefined` |  |  | Wraps the header button in a heading of this level (`<h1>`–`<h6>`), the APG accordion shape, so the header joins the page's outline. Match the level to where the accordion sits (a section under an `<h2>` takes `3`). No visual change: the heading's margins and font are reset. Omitted, there is no heading. |
 | `id` | `string \| undefined` |  |  | The root's `id`; the header button's id (`<id>_header`) derives from it. Generated when omitted. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to trigger opening / closing the collapsible. An accordion with no `v-model` starts closed. |

package/dist/ai/BbButton.md

@@ -494,6 +494,11 @@ const activeView = ref<IssueView>('list');
 </script>
 ```
 
+A toggle that is on carries `aria-pressed="true"` and the class
+`bb-button--pressed`. Restyle that state with `pt:root:pressed` (or
+`pt:icon:pressed`, `pt:text:pressed`), not with a selector of your own: it is
+the state's contract.
+
 Listen to `update:modelValue` only if you need side effects; state itself is
 handled. For form-ish multi-selection prefer `BbCheckboxGroup` /
 `BbRadioGroup`; toggle buttons are for immediate, tool-bar-like state.
@@ -835,8 +840,11 @@ label span). Typography inherits from `root`, so reach for `text` only when a
 class must apply to the label ALONE — `truncate` on a long label that must not
 clip the icons beside it. That span also carries the margin the label slides by
 while the spinner is in, so a margin of your own fights the slide. States:
-`loading`, `disabled`. A name outside that list is a type error and an ESLint
-error.
+`loading`, `disabled`, `pressed` (a `v-model` toggle that is on). A name
+outside that list is a type error and an ESLint error. There is no `active`
+state: a pointer press is Tailwind's `active:` variant (`pt:root="active:scale-95"`).
+There is no `current` state either: a link to the current route is
+`active-class` / `exact-active-class` (see Active state above).
 
 **pt: a part, a part while loading, the object form**
 
@@ -1090,7 +1098,7 @@ Anti-patterns:
 
 | 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: `icon`, `root`, `spinner`, `text`. States: `disabled`, `loading`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbButtonProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
+| `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: `icon`, `root`, `spinner`, `text`. States: `disabled`, `loading`, `pressed`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbButtonProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
 | `activeClass` | `string \| undefined` |  |  | Class to apply when the link is active. |
 | `append:icon` | `string \| undefined` |  |  | Icon to be added on the right of the text. |
 | `ariaCurrentValue` | `"page" \| "step" \| "location" \| "date" \| "time" \| "true" \| "false" \| undefined` | `'page'` |  | Value passed to the attribute `aria-current` when the link is exact active. |
@@ -1160,6 +1168,7 @@ States are listed in precedence order: when two are on at once and their entries
 
 | State | When it is on |
 | --- | --- |
+| `pressed` | Component-wide: a toggle button (`v-model`) is on — `aria-pressed="true"`, `--pressed` on the root. |
 | `disabled` | Component-wide: the button is `disabled`. |
 | `loading` | Component-wide: `loading` is on — the spinner shows and the button ignores the pointer. |
 

package/dist/ai/BbCollapsible.md

@@ -525,7 +525,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | 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: `content`, `root`. States: `open`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbCollapsibleProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
-| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Renders the content at mount, while closed, instead of on the first open. Closed content is `inert` and `aria-hidden` either way. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to trigger opening / closing the collapsible. Optional, matching the runtime: `withDefaults` supplies `false`, so an omitted binding renders closed and Vue never warns. It was typed required while carrying that default, which made the manifest publish a row that was `required: true` AND `default: false` — a contradiction that read as a generator bug. |
 | `tag` | `'div'` \| `'span'` | `"span"` |  | Element rendered as the root, and mirrored by the inner animating element — so the pair is span-in-span or div-in-div, both valid. Keep the default inside phrasing content (a `<p>`); use `'div'` when the body is block content (paragraphs, lists, forms), which a `span` may not contain. |
 | `transitionDuration` | `number \| undefined` | `250` |  | How long the transition has to last in milliseconds |

package/dist/ai/BbColorPalette.md

@@ -760,7 +760,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `boundary` | `ElementOrComponentRefOrSelector \| undefined` |  |  | Constrains the popover within a bounding element. Accepts an HTMLElement, a Vue component ref, or a CSS selector string. |
 | `disabled` | `boolean \| undefined` | `false` |  | Disable all interaction (activator and palette). |
 | `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 palette panel at mount instead of on the first open (the phone sheet's too). |
 | `eyeDropper` | `boolean \| undefined` | `false` |  | Show an eyedropper button inside the palette to sample any color on screen. Uses the native EyeDropper API — hidden automatically on unsupported browsers. |
 | `label` | `string \| undefined` |  |  | Accessible label. The activator is named by it followed by the activator's own text, through `aria-labelledby`. Defaults to the locale string for "Open color picker" when omitted. |
 | `modelValue` | `string \| null` |  | yes | v-model: the current color as a `#RRGGBB` hex string (or `#RRGGBBAA` when `alpha` is enabled), or `null` when empty. |

package/dist/ai/BbConfirm.md

@@ -654,6 +654,14 @@ const removeMember = async () => {
 When the portal owns its own action buttons, pass `actions: false` to hide the
 standard footer and resolve from inside the slot with its `yes` / `no` helpers.
 
+**Names are checked.** `bitboss-ui check` and the ESLint rule
+`bitboss-ui/portal-names` (in `recommended`) read every literal
+`confirm({ portal: 'name' })` in your scripts against the
+`<BbConfirmPortal name>`s in your templates: a name no file declares fails,
+with a did-you-mean, and `bitboss-ui/unused-portal` warns on a portal nothing
+opens. A `portal` held in a variable, or `confirm(options)`, is never judged.
+The slot's `props` is `any` per key, so `props.member.name` needs no cast.
+
 ### Size, fullscreen and focus
 
 - `size` picks a maximum-width preset (`'xs'` … `'2xl'`, resolvable through

package/dist/ai/BbConfirmPortal.md

@@ -20,7 +20,7 @@
 
 ## Slots
 
-- `default` — scope: `{ yes: () => void; no: () => void; props: Record<string, unknown>; }`
+- `default` — scope: `BbConfirmPortalSlotProps` `{ props: P; yes: () => void; no: () => void }`
 
 ## See Also
 

package/dist/ai/BbDropdown.md

@@ -2158,7 +2158,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `boundary` | `string \| Record<string, any> \| HTMLElement \| null \| undefined` |  |  | Constrains the dropdown within a bounding element. Accepts an HTMLElement, a Vue component ref, or a CSS selector string. |
 | `compact` | `boolean \| undefined` | `false` |  | Apply the compact density variant — the same ladder `BbSelect` uses, on both surfaces: flyout rows go 28px → 24px, sheet rows 44px → 36px. The label size does not change; density here is height, as it is for a select. A menu row is a touch target in a way a select option is not quite — a mis-tap fires the neighbouring COMMAND rather than picking the wrong value — so the compact sheet stops at 36px and never follows the flyout down to 24px. That is the same floor the select's sheet holds. |
 | `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 menu panel at mount instead of on the first open (the phone sheet's too). |
 | `emptyText` | `string \| undefined` |  |  | Default placeholder text shown when a pipeline group resolves to no items. A group's own `emptyText` overrides this; both fall back to the localized `common.emptyText` (`'No data to display'`). |
 | `enforceCoherence` | `boolean \| undefined` | `false` |  | Default for pipeline groups: drop selections that are no longer present in a group's current items (e.g. after a `dependencies` re-fetch) from the selection and `v-model`. A group's own `enforceCoherence` overrides this. |
 | `failedText` | `string \| undefined` |  |  | Default placeholder text shown when a pipeline group's latest load FAILED (its `items` getter threw). A group's own `failedText` overrides this; both fall back to the localized `common.failedText` (`"Couldn't load items"`). |

package/dist/ai/BbDropdownButton.md

@@ -637,7 +637,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `compact` | `boolean \| undefined` | `false` |  | Apply the compact density variant — the same ladder `BbSelect` uses, on both surfaces: flyout rows go 28px → 24px, sheet rows 44px → 36px. The label size does not change; density here is height, as it is for a select. A menu row is a touch target in a way a select option is not quite — a mis-tap fires the neighbouring COMMAND rather than picking the wrong value — so the compact sheet stops at 36px and never follows the flyout down to 24px. That is the same floor the select's sheet holds. |
 | `disableAutoLoading` | `boolean \| undefined` | `false` |  | Disables the automatic loading state that tracks async actions (enabled by default). Only affects the main action button: the split toggle half still mirrors the dropdown's internal async-action loading state. |
 | `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 menu panel at mount instead of on the first open (the phone sheet's too). |
 | `id` | `string \| undefined` |  |  | Names this dropdown: the activator's id (unless it already has one), the menu's `menu_<id>`, and the key `useBbDropdownContext(id)` and a companion `BbDropdownGroup` pair by. Generated when omitted. |
 | `items` | `BbDropdownItem[]` | `[]` | yes | Array used to render each dropdown button. They can act as `button`, as `a`, or as `router-link` as they are based on the functionality provided by `BbBaseButton`. Pass a flat array for a single group, nest arrays for divider-separated groups, or pass {@link InternalGroup} objects for titled / selectable sections. An item may carry its own `items` to open a submenu. The shapes can be mixed. |
 | `loading` | `boolean \| undefined` | `false` |  | Triggers a loading indicator. |

package/dist/ai/BbHoverCard.md

@@ -292,7 +292,8 @@ A directive has no slot, so the card's body is a **portal**, as in
   `person-card` is `person` minus `card`, and nothing opens (`check` flags it).
   The portal's slot gets `{ props, close }`.
 - **A component:** `v-bb-hover-card="PersonCard"` renders `PersonCard` in the
-  card. It can close the card with `emit('close')`.
+  card, with `portalProps` as its real props. It gets no `close`: content that
+  needs one is a named portal, or the `BbHoverCard` component.
 - **The object form** takes either one as `portal`, data for it as
   `portalProps` (the named portal's `props`, or the component's real props),
   and any `BbHoverCard` prop: `{ portal: 'person-card', portalProps: { person },
@@ -302,6 +303,15 @@ The portal's content sees the page around it, as if it were written inline:
 a component portal injects from where the trigger is, a named portal from
 where its `<BbHoverCardPortal>` is declared.
 
+**Names are checked.** A name is a string on one side and a `<BbHoverCardPortal
+name>` on the other, so `bitboss-ui check` and the ESLint rules (in
+`recommended`) read both across the project: `bitboss-ui/portal-names`
+fails on a name no file declares, with a did-you-mean (`'renam'` → `rename`),
+and on a popover portal opened by `v-bb-hover-card` (it names the family the portal belongs to); `bitboss-ui/unused-portal` warns on a
+`<BbHoverCardPortal>` nothing opens. Only literal names are judged: a `:name`
+binding or a name held in a variable is never reported. The slot's `props`
+is `any` per key, so `props.person.name` needs no cast.
+
 **A card per row, from the directive**
 
 ```vue
@@ -328,11 +338,11 @@ where its `<BbHoverCardPortal>` is declared.
 	<BbHoverCardPortal v-slot="{ props }" name="person-card">
 		<div class="grid gap-0.5">
 			<div class="font-medium text-(--bb-text)">
-				{{ (props.person as Person).name }}
+				{{ props.person.name }}
 			</div>
 			<div class="text-xs text-(--bb-text-muted)">
-				{{ (props.person as Person).team }} ·
-				{{ (props.person as Person).city }}
+				{{ props.person.team }} ·
+				{{ props.person.city }}
 			</div>
 		</div>
 	</BbHoverCardPortal>
@@ -454,7 +464,7 @@ value written in `<script>` is typed as `BbHoverCardProps['pt']`.
 | `boundary` | `ElementOrComponentRefOrSelector \| undefined` |  |  | Constrains the card within a bounding element. When provided, the card 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` | `350` |  | The delay in milliseconds before the card is shown: how long the pointer rests on the activator, or keyboard focus stays on it. BbTooltip's name; a different default, because a card that opened on every pass of the pointer would be in the way. Closing has a fixed grace instead (see the guide § Timing and the safe zone). |
 | `disabled` | `boolean \| undefined` | `false` |  | Disables the component. Disabling an open card closes it. |
-| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Renders the card's content at mount instead of on the first open. |
 | `id` | `string \| undefined` |  |  | The activator's id (the card is `bbhc_<id>`, and is labelled by it once it holds a control). Generated when omitted. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to open / close the card. A card with no `v-model` starts closed and is driven by hover and keyboard focus. |
 | `offset` | `number \| undefined` | `4` |  | Space the floating container will maintain from the activator. |

package/dist/ai/BbHoverCardPortal.md

@@ -20,7 +20,7 @@
 
 ## Slots
 
-- `default` — scope: `DirectivePortalSlotProps` `{ props: Record<string, unknown>; close: () => void }` — The card's body. `props` is the directive's `portalProps`; `close` closes the card.
+- `default` — scope: `BbHoverCardPortalSlotProps` `{ props: P; close: () => void }` — The card's body. `props` is the directive's `portalProps`; `close` closes the card.
 
 ## See Also
 

package/dist/ai/BbPopover.md

@@ -360,8 +360,9 @@ A directive has no slot, so the body is a **portal**, as in `BbConfirm`:
   it). The portal's slot gets `{ props, close }`: `props` is your
   `portalProps`, `close` closes the popover.
 - **A component:** `v-bb-popover="RenameForm"` renders `RenameForm` in the
-  popover; `portalProps` arrive as its real props, and `emit('close')` closes
-  the popover.
+  popover; `portalProps` arrive as its real props. It has no way to close the
+  popover: content that needs `close` is a named portal (its slot has it), or
+  the `BbPopover` component.
 - **The object form** takes either one as `portal`, `portalProps`, and any
   `BbPopover` prop (`width`, `scrollable`, `trigger`, …):
   `{ portal: 'rename-report', portalProps: { report }, width: 260 }`. The
@@ -376,6 +377,15 @@ a field in a named portal declared inside the form. A `<BbPtScope>` around the
 trigger styles the popover too. A component portal remounts on every open, so keep anything that must
 survive between openings outside it.
 
+**Names are checked.** A name is a string on one side and a `<BbPopoverPortal
+name>` on the other, so `bitboss-ui check` and the ESLint rules (in
+`recommended`) read both across the project: `bitboss-ui/portal-names`
+fails on a name no file declares, with a did-you-mean (`'renam'` → `rename`),
+and on a hover-card portal opened by `v-bb-popover` (it names the family the portal belongs to); `bitboss-ui/unused-portal` warns on a
+`<BbPopoverPortal>` nothing opens. Only literal names are judged: a `:name`
+binding or a name held in a variable is never reported. The slot's `props`
+is `any` per key, so `props.report.title` needs no cast.
+
 **Rename on every row, from the directive**
 
 ```vue
@@ -404,26 +414,17 @@ survive between openings outside it.
 
 	<!-- Declared once; renders only in the popover that opens. -->
 	<BbPopoverPortal v-slot="{ props, close }" name="rename-report">
-		<form
-			class="grid gap-2"
-			@submit.prevent="rename(props.report as Report, close)"
-		>
+		<form class="grid gap-2" @submit.prevent="rename(props.report, close)">
 			<BbTextInput
 				label="Title"
-				:model-value="draftOf(props.report as Report)"
-				@update:model-value="drafts[(props.report as Report).id] = $event ?? ''"
+				:model-value="draftOf(props.report)"
+				@update:model-value="drafts[props.report.id] = $event ?? ''"
 			/>
 			<div class="flex justify-end gap-2">
-				<BbButton
-					variant="ghost"
-					@click="discard(props.report as Report, close)"
-				>
+				<BbButton variant="ghost" @click="discard(props.report, close)">
 					Cancel
 				</BbButton>
-				<BbButton
-					:disabled="!draftOf(props.report as Report).trim()"
-					type="submit"
-				>
+				<BbButton :disabled="!draftOf(props.report).trim()" type="submit">
 					Save
 				</BbButton>
 			</div>
@@ -867,7 +868,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | On mobile viewports (below `config.mobileMaxWidth`), render the popover as a bottom-anchored, auto-sized off-canvas sheet instead of a floating panel. The `header`, `default` and `footer` slots are forwarded to the sheet. The `width` prop is intentionally ignored in this mode (it means a different thing for a sheet); pass `offCanvasProps` to size or otherwise customise the sheet. When unset, falls back to the global `config.adaptive`. |
 | `boundary` | `ElementOrComponentRefOrSelector \| undefined` |  |  | Constrains the popover within a bounding element. When provided, the popover will not overflow this container's bounds (e.g. a sidebar). Accepts an HTMLElement, a Vue component ref, or a CSS selector string. |
 | `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 panel's content at mount instead of on the first open (the phone sheet's too). |
 | `focusTarget` | `string \| undefined` |  |  | Selector for the element that receives focus after opening. Defaults to the first focusable element inside the popover. |
 | `id` | `string \| undefined` |  |  | The activator's id (the panel is `bbp_<id>` and is labelled by it). Generated when omitted. |
 | `modelValue` | `boolean \| undefined` | `false` |  | Used by v-model to open / close the popover. A popover with no `v-model` starts closed and is driven by its `trigger`. |

package/dist/ai/BbPopoverPortal.md

@@ -20,7 +20,7 @@
 
 ## Slots
 
-- `default` — scope: `DirectivePortalSlotProps` `{ props: Record<string, unknown>; close: () => void }` — The popover body. `props` is the directive's `portalProps`; `close` closes the popover.
+- `default` — scope: `BbPopoverPortalSlotProps` `{ props: P; close: () => void }` — The popover body. `props` is the directive's `portalProps`; `close` closes the popover.
 
 ## See Also
 

package/dist/ai/BbTabs.md

@@ -1834,7 +1834,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `disableAnimateX` | `boolean \| undefined` | `false` |  | Disables the horizontal slide transition between tab panels (enabled by default). |
 | `disableAnimateY` | `boolean \| undefined` | `false` |  | Disables the smooth height animation when switching between tab panels (enabled by default). |
 | `disabled` | `boolean \| undefined` | `false` |  | Disables the component |
-| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Renders every tab's panel at mount and keeps it mounted, hidden while inactive, instead of only the active one. One tab alone: its item's `eager`. |
 | `headers` | `Record<string, string> \| undefined` |  |  | Additional HTTP headers forwarded to Inertia when navigation is triggered. Only meaningful in an Inertia context. |
 | `id` | `string \| undefined` |  |  | The root's `id`, and the key `useBbTabsContext(id)` pairs by. Generated when omitted. |
 | `items` | `BbTabsItem<K>[]` |  | yes | Array of items that define the tabs in the component. |

package/dist/ai/BbTabsRoot.md

@@ -22,7 +22,7 @@
 | `disableAnimateX` | `boolean \| undefined` | `false` |  | Disables the horizontal slide transition between tab panels (enabled by default). |
 | `disableAnimateY` | `boolean \| undefined` | `false` |  | Disables the smooth height animation when switching between tab panels (enabled by default). |
 | `disabled` | `boolean \| undefined` | `false` |  | Disables the component |
-| `eager` | `boolean \| undefined` | `false` |  | Prevents rendering content before it's made visible. |
+| `eager` | `boolean \| undefined` | `false` |  | Renders every tab's panel at mount and keeps it mounted, hidden while inactive, instead of only the active one. One tab alone: its item's `eager`. |
 | `headers` | `Record<string, string> \| undefined` |  |  | Additional HTTP headers forwarded to Inertia when navigation is triggered. Only meaningful in an Inertia context. |
 | `id` | `string \| undefined` |  |  | The root's `id`, and the key `useBbTabsContext(id)` pairs by. Generated when omitted. |
 | `items` | `BbTabsItem<K>[]` |  | yes | Array of items that define the tabs in the component. |

package/dist/ai/BbTooltip.md

@@ -262,8 +262,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**
 
@@ -584,7 +586,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `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. |
 | `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/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,7 +1,7 @@
 {
 	"schemaVersion": 3,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.47",
+	"version": "3.0.0-beta.48",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"legend": {
@@ -58,7 +58,8 @@
 		"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"
 	],
 	"unpublished": [
 		"3.0.0-alpha.2",
@@ -78,15 +79,15 @@
 		"3.0.0-beta.40"
 	],
 	"summary": {
-		"renames": 213,
-		"behaviourBreaks": 172,
+		"renames": 214,
+		"behaviourBreaks": 174,
 		"bySurface": {
 			"prop": 15,
 			"option": 1,
 			"pt": 14,
 			"slot": 14,
 			"cssVar": 32,
-			"class": 137
+			"class": 138
 		},
 		"unreleased": 0
 	},
@@ -2944,6 +2945,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 +5611,31 @@
 			"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"
 		}
 	]
 }