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

package/README.md

@@ -327,13 +327,13 @@ part you need.
 
 ### CLI commands
 
-| Command                                                                   | What it does                                                                                                                                                                                          |
-| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `npx bitboss-ui ai-init [--update] [--no-mcp]`                            | Writes the agent pointer files and registers the MCP server (installs its optional peers).                                                                                                            |
-| `npx bitboss-ui check [paths… \| --changed] [--fix] [--json]`             | Validates `Bb*` markup in `.vue` / `.md` files against the installed version; `--fix` applies the v2 → v3 renames first; `--changed` checks only the files git sees changed vs HEAD (plus untracked). |
-| `npx bitboss-ui changelog --since <version> [--until <version>] [--json]` | Lists the **breaking** changes between the version you are on and the installed one — what breaks if you bump.                                                                                        |
-| `npx bitboss-ui mcp`                                                      | Starts the MCP server on stdio (harnesses launch it for you after `ai-init`).                                                                                                                         |
-| `npx bitboss-ui --help`                                                   | Every command and flag.                                                                                                                                                                               |
+| Command                                                                   | What it does                                                                                                                                                                                                                             |
+| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `npx bitboss-ui ai-init [--update] [--no-mcp]`                            | Writes the agent pointer files and registers the MCP server (installs its optional peers).                                                                                                                                               |
+| `npx bitboss-ui check [paths… \| --changed] [--fix] [--json]`             | Validates `Bb*` markup in `.vue` / `.md` files against the installed version; `--fix` applies the library's renames first (v2 → v3, and between 3.0 betas); `--changed` checks only the files git sees changed vs HEAD (plus untracked). |
+| `npx bitboss-ui changelog --since <version> [--until <version>] [--json]` | Lists the **breaking** changes between the version you are on and the installed one — what breaks if you bump.                                                                                                                           |
+| `npx bitboss-ui mcp`                                                      | Starts the MCP server on stdio (harnesses launch it for you after `ai-init`).                                                                                                                                                            |
+| `npx bitboss-ui --help`                                                   | Every command and flag.                                                                                                                                                                                                                  |
 
 ### ESLint plugin
 
@@ -533,6 +533,23 @@ const draft = reactive({ name: '' });
 
 `bitboss-ui check` reports the same as `form-v-model`.
 
+#### Item fields: `no-renamed-item-field` and `no-redundant-item-accessor`
+
+Dropdown, tab and breadcrumb items take `value` and `label` (dropdown groups:
+`id`). `bitboss-ui/no-renamed-item-field` (error) rewrites an item literal still
+spelled the old way: `{ key: 'edit', text: 'Edit' }` → `{ value: 'edit', label:
+'Edit' }` on a `BbDropdown` / `BbDropdownButton` row or a crumb, a tab's `key` →
+`value`, a dropdown group's `key` → `id`.
+
+Object items are read by their own `label` (else `text`) and `value`, so an
+accessor naming those fields restates the default.
+`bitboss-ui/no-redundant-item-accessor` (warn) deletes it: `item-text="label"`,
+`item-value="value"`, and `item-text="text"` when no item has a `label`. It only
+reports what removing cannot change.
+
+`bitboss-ui check` reports the same as `renamed-item-field` and
+`redundant-item-accessor`.
+
 #### Rating star colours: `no-star-color`
 
 `bitboss-ui/no-star-color` flags any colour utility in `BbRating`'s `pt:item`,

package/bin/bitboss-ui-mcp.mjs

@@ -2852,7 +2852,7 @@ const SERVER_INSTRUCTIONS = [
 	'- Which component: search_components (empty query = the whole catalog). One component: get_component({ name }), one line per member; members: [names] for whole rows, sections for prose.',
 	'- A type in a props table (BbTableColumn, ButtonVariantType): get_component({ name }) returns its definition and values.',
 	'- After writing markup: validate. Before custom CSS: list_tokens.',
-	'- An old name (v2 or earlier-beta prop, slot, pt key, class) that stopped working: search_docs(the old name). What a bump breaks: list_changes({ since: <your version> }), one line per change.',
+	'- An old name (v2 or earlier-beta prop, slot, item field, pt key, class) that stopped working: search_docs(the old name). What a bump breaks: list_changes({ since: <your version> }), one line per change.',
 	"- pt in <script> (a const, a wrapper's prop): type it <Name>Props['pt']; Pt* types are not exported.",
 	'- Composables: get_composable. Whole pages: list_recipes, get_recipe (prose + files). Long docs answer with an outline: pass sections.',
 ].join('\n');
@@ -3018,9 +3018,21 @@ function buildServer() {
 					.optional()
 					.describe("Only this component's breaks, e.g. 'BbSelect'."),
 				surface: z
-					.enum(['prop', 'slot', 'pt', 'cssVar', 'class', 'option', 'method'])
+					.enum([
+						'prop',
+						'slot',
+						'pt',
+						'cssVar',
+						'class',
+						'option',
+						'method',
+						'event',
+						'item',
+					])
 					.optional()
-					.describe('Only renames of this surface.'),
+					.describe(
+						'Only renames of this surface (`item` = a field of an `items` entry, e.g. a dropdown row `key` → `value`).'
+					),
 				kind: z
 					.enum(['rename', 'behaviour'])
 					.optional()

package/bin/bitboss-ui.mjs

@@ -37,6 +37,9 @@
  *             it may never have been one anywhere. `printFindingLegend` says
  *             so in the output, because two migrating fleets each spent real
  *             time discovering it the hard way.
+ *   add       Copy Inertia helpers into the app as files it owns
+ *             (scripts/lib/helpers-add.mjs); `helpers list|diff|update`
+ *             reports on them and refreshes the ones the app has not edited.
  *   changelog Breaking changes between two releases — `--since <version>`
  *             answers "what breaks if I bump", without MCP. Reads the
  *             installed `dist/ai/changelog.json`.
@@ -78,6 +81,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,
@@ -88,6 +96,7 @@ import {
 	HAND_IMPORTED_STYLES_EXTENSIONS,
 	handImportedStylesFindings,
 } from '../scripts/lib/hand-imported-styles.mjs';
+import { unknownLocaleFindings } from '../scripts/lib/locale-check.mjs';
 import { syncProjectVariantDts } from '../scripts/lib/project-variant-dts.mjs';
 import { refuseLinkedTarget } from '../scripts/lib/linked-target.mjs';
 import {
@@ -143,7 +152,7 @@ function coreRules(version) {
 3. **Prefer \`Bb*\` consumer components**; never use entries marked "Reference Only - Internal" unless the user explicitly asks for internals. (\`BbBaseButton\` and the \`BbBase*Icon\` glyphs are consumer API; the \`Common*\` building blocks are not.)
 4. **Never invent prop/event/slot names** — open \`${KNOWLEDGE_BASE}/<ComponentName>.md\` (Usage & Guidelines first) or its API file \`${KNOWLEDGE_BASE}/manifest/components/<ComponentName>.json\` (one member per line; the list is \`${KNOWLEDGE_BASE}/manifest/index.json\`). Never read \`components.json\` whole: it is the 1.2 MB file the tools use.
 5. **Icons**: discover names first; never invent them (\`${KNOWLEDGE_BASE}/guides/icons-policy.md\`).
-6. **Item-driven components**: declarative \`items\` / \`item-text\` / \`item-value\`, \`dependencies\`, \`enforce-coherence\` — no manual watchers for coherence.
+6. **Item-driven components**: declarative \`items\` (an object row reads its own \`label\` and \`value\`; \`item-text\` / \`item-value\` only for other field names, never to restate those two), \`dependencies\`, \`enforce-coherence\` — no manual watchers for coherence.
 7. **Whole pages**: one recipe under \`${KNOWLEDGE_BASE}/recipes/{vue|nuxt|inertia}/\` (see the router table).
 8. **CSS near components**: \`${KNOWLEDGE_BASE}/guides/design-language.md\`. Paint as data is \`${KNOWLEDGE_BASE}/design-tokens.json\` and \`design-tokens.manifest.yaml\` (DESIGN.md-shaped). Grep \`--bb-*\`, not \`--color-*\` or \`--radius-*\`. A repo-root DESIGN.md is not this library. Two token tiers, and reaching for the wrong one is why apps end up re-skinning by class: \`--bb-*\` is the small GLOBAL theme tier (brand knobs, no numeric ramp — there is no \`--bb-primary-800\`), while each component declares its own **unprefixed** \`--*\` tokens for its look (\`.bb-table { --cell-h: 32px }\`). A missing \`--bb-*\` name is not a gap in the library — it means the knob you want is a component token. Set it on the element that DECLARES it (grep \`${KNOWLEDGE_BASE}/source/<ComponentName>.md\`); a value set further out is masked, not inherited. Prefer tokens, variants and \`pt\`; CSS on \`.bb-*__*\` internals is allowed for fine-tuning but unsupported: it can break on upgrade. \`.bb-common-*\` / \`.bb-field*\` internals: expect it to break. (\`.bb-base-button\` and the three \`.bb-base-*-icon\` glyph classes are consumer API — a supported hook, not an internal.) An override on an internal is a signal to check for a \`pt\` part or request one. A Tailwind utility on a \`Bb*\` component that does nothing is rule 9, not a library bug. One primary action per view region.
 9. **Tailwind v4 app: turn on cascade layers when you set bitboss-ui up**, not later when a class "doesn't work". In the build plugin: \`import { bitbossUi, TAILWIND_V4_LAYERS } from 'bitboss-ui/vite'\` and \`bitbossUi({ cssLayers: TAILWIND_V4_LAYERS })\` (Nuxt: \`bitboss: { cssLayers: TAILWIND_V4_LAYERS }\`, same import). Tailwind v4 emits layered CSS; without this the library's CSS is unlayered and beats every utility you put on a \`Bb*\` component or a \`pt:*\` part, whatever the specificity. With it, your utilities win. You still need the runtime plugin (\`app.use(bitbossUiPlugin)\`; Nuxt does it for you): it is what injects the sheet, into that layer. **Do not also \`@import 'bitboss-ui/styles.css'\`**: a hand import adds a second, unlayered copy and undoes the setting. Tailwind v3 or plain CSS: leave it unset. Details: \`${KNOWLEDGE_BASE}/guides/installation-and-plugin-setup.md\` § Cascade layers.
@@ -152,8 +161,9 @@ function coreRules(version) {
 12. **Never name your own components \`Bb…\`** — that prefix is bitboss-ui's. Use your app's prefix (\`App…\`, \`Acme…\`). \`check\` leaves an app's own \`Bb*\` component alone but warns: a future bitboss-ui component could take the name.
 13. **Set \`locale\` explicitly** in the build plugin (\`bitbossUi({ locale: 'it' })\` / nuxt \`bitboss: { locale: 'it' }\`) for any app that is not English: the built-in strings default to English (\`'en'\`, since 3.0.0-beta.41; it was \`'it'\`).
 14. **After writing bitboss-ui markup**, run \`npx bitboss-ui check\` — validates \`Bb*\` usage against the installed \`components.json\` and catches invented/removed props before review. In an edit loop, \`npx bitboss-ui check --changed\` checks only the files git sees changed; run the full check before you finish.
+15. **Inertia apps: install the app-side helpers with \`npx bitboss-ui add <name>\`** (\`useQueryObject\`, \`usePromiseForm\`, \`useTableContext\`, …; \`npx bitboss-ui helpers list\` names them). Never paste them from the guide. If \`add\` or \`helpers update\` refuses, stop and show the user its output and \`npx bitboss-ui helpers diff <name>\`; never edit \`bitboss-ui.lock.json\`, and never delete a helper file to get past a refusal.
 
-After upgrading bitboss-ui, re-run: \`npx bitboss-ui ai-init\``;
+After upgrading bitboss-ui, re-run: \`npx bitboss-ui ai-init\` (Inertia apps: then \`npx bitboss-ui helpers update\`)`;
 }
 
 // A blank line after the start marker and before the end marker: an HTML
@@ -1083,6 +1093,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:
@@ -1105,6 +1152,16 @@ async function checkCommand(
 			readText
 		)
 	);
+	// A locale the library does not ship, in the build config and in
+	// `setConfig({ locale })` (owner 2026-10-07: `en-UK` → `en-GB`).
+	findings.push(
+		...unknownLocaleFindings(
+			projectRoot,
+			styleScan.map((path) => ({ path, relPath: relative(projectRoot, path) })),
+			manifest,
+			readText
+		)
+	);
 	// Q46.5: `.bb-*` selectors in the app's stylesheets (the `.vue` `<style>`
 	// blocks are read by the validator above).
 	for (const path of styleScan) {
@@ -1298,6 +1355,37 @@ Commands:
                       tsconfig unless it is already named (Nuxt: says where).
                       \`--no-mcp\` skips the server and the install. Idempotent —
                       safe to re-run after upgrades.
+  add <id…> | --all [--dir <path>] [--dry-run] [--json]
+                      Copy Inertia helpers (\`helpers list\`; --all for every
+                      one) into the app as
+                      files it owns, with every file they import, and record
+                      them in bitboss-ui.lock.json. Creates missing files and
+                      adopts identical ones; never changes an existing file.
+                      Prints the install line for missing npm packages; never
+                      runs it. First run: --dir, else
+                      resources/js/composables/inertia-helpers (Laravel) or
+                      src/composables/inertia-helpers.
+  helpers [list] [--json]
+                      Every helper id, what it does, its files and packages,
+                      and its state in this app.
+  helpers diff [id…] [--json]
+                      The state of every installed helper file; with ids, the
+                      difference between your copy and this bitboss-ui's.
+                      Exit 1 when something differs. Comments never count as
+                      edits: a stale file's comments are replaced by update.
+  helpers update [id…] [--dry-run] [--json]
+                      Replace helper files that hold an older bitboss-ui
+                      version (formatting does not matter); keep the files
+                      you edited; refuse a group of helpers where you edited a
+                      file bitboss-ui also changed. \`npm update bitboss-ui\`
+                      does not touch your copies: run this after upgrading.
+                      add/helpers exit codes: 0 done or nothing to do; 1 usage
+                      error or diff found a difference; 2 refused (add wrote
+                      nothing); 3 a precondition failed, nothing written; 4 a
+                      write failed and was rolled back. No --force: to take
+                      bitboss-ui's copy over your edit, delete the file and
+                      run add again. --yes is accepted and does nothing (the
+                      commands never prompt).
   check [glob…] [--changed] [--json] [--allow-empty] [--allow-component <Name>]
                       [--no-hints] [--manifest <path>] [--fix]
                       Validate \`Bb*\` markup in .vue/.md files against the
@@ -1330,8 +1418,8 @@ Commands:
                       under \`--manifest\`.
 
                       \`--fix\` first applies the ESLint plugin's fixes (the
-                      registered v2→v3 renames, polarity flips and value
-                      remaps) to the matched .vue files with ONLY the
+                      registered renames — v2→v3 and between 3.0 betas, item
+                      fields included — polarity flips and value remaps) to the matched .vue files with ONLY the
                       bitboss-ui rules — your own ESLint config is not used —
                       then reports what is left. Needs \`eslint\` and
                       \`vue-eslint-parser\` in the project.
@@ -1388,9 +1476,18 @@ Commands:
                       \`dist/\`), \`not-exported-type\` (a \`Pt*\` pt type
                       imported from bitboss-ui: type pt through
                       \`<Component>Props['pt']\` instead),
-                      \`missing-key\` / \`duplicate-row-text\` (a
-                      BbDropdown row or group that needs a \`key\`: selectable,
-                      or identical keyless text in one group),
+                      \`missing-value\` / \`missing-id\` /
+                      \`duplicate-row-label\` (a BbDropdown row in a
+                      selectable group without a \`value\`, a selectable
+                      group without an \`id\`, or two value-less rows with
+                      the same \`label\` in one group; before
+                      3.0.0-beta.49 \`missing-key\` / \`duplicate-row-text\`),
+                      \`renamed-item-field\` (a dropdown row \`key\` /
+                      \`text\`, a dropdown group \`key\`, a tab \`key\` or a
+                      crumb \`key\` / \`text\` in an inline or same-file
+                      items array: rows and crumbs take \`value\` /
+                      \`label\`, tabs \`value\`, groups \`id\`; \`--fix\`
+                      rewrites it),
                       \`unknown-variant\` (a variant name from another
                       library, e.g. \`danger\` on BbAlert / BbBadge; the
                       message names ours),
@@ -1410,6 +1507,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 })\`),
@@ -1439,17 +1543,23 @@ Commands:
                       \`--fix\` rewrites it), \`missing-partner-prop\`,
                       \`partner-prop\`,
                       \`validated-only-prop\`, \`object-items-without-text\`
-                      (object \`items\` with no \`item-text\`; reads only
+                      (object \`items\` with neither a \`label\` nor a
+                      \`text\` field and no \`item-text\`; reads only
                       an inline array, or a \`const\` array, \`ref([…])\` or
                       \`reactive([…])\` in the same file's
-                      \`<script setup>\`), \`reserved-key\` (a key
-                      whose slot name is one of the component's own slots,
-                      e.g. a BbTable column keyed \`actions\`; read from the
-                      manifest, same-file keys only), \`hand-imported-styles\`
+                      \`<script setup>\`), \`reserved-key\` (a column
+                      \`key\` or item \`value\` whose slot name is one of
+                      the component's own slots, e.g. a BbTable column keyed
+                      \`actions\`; read from the manifest, same-file items
+                      only), \`hand-imported-styles\`
                       (\`bitboss-ui/styles.css\` imported in CSS, a script or
                       Nuxt's \`css\` while \`injectStyles\` is on: delete it;
                       read only when vite.config / nuxt.config says so),
-                      \`unknown-class\` (a selector on a \`.bb-*\` class the
+                      \`unknown-locale\` (a \`locale\` / \`enabledLocales\`
+                      literal in vite.config / nuxt.config, or a
+                      \`setConfig({ locale })\`, that bitboss-ui does not
+                      ship; \`suggestion\` is the nearest one: en-UK →
+                      en-GB), \`unknown-class\` (a selector on a \`.bb-*\` class the
                       library does not render, in a stylesheet or a
                       \`<style>\` block; \`suggestion\` is the nearest real
                       one), \`renamed-class\` (a class the library renamed;
@@ -1470,7 +1580,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]
@@ -1615,6 +1727,47 @@ switch (command) {
 		await main();
 		break;
 	}
+	case 'add':
+	case 'helpers': {
+		const { values, positionals } = parseCommandArgs(
+			command,
+			commandArgs,
+			{
+				json: { type: 'boolean' },
+				'dry-run': { type: 'boolean' },
+				yes: { type: 'boolean', short: 'y' },
+				...(command === 'add'
+					? { dir: { type: 'string' }, all: { type: 'boolean' } }
+					: {}),
+			},
+			{ allowPositionals: true }
+		);
+		const [sub, ...rest] =
+			command === 'add' ? ['add', ...positionals] : positionals;
+		const subcommand = command === 'add' ? 'add' : (sub ?? 'list');
+		if (subcommand === 'list' && values['dry-run']) {
+			console.error(
+				'[bitboss-ui] helpers list: --dry-run applies to add and update'
+			);
+			process.exit(1);
+		}
+		const { runHelpers } = await import('../scripts/lib/helpers-add.mjs');
+		const result = await runHelpers({
+			command: subcommand,
+			ids: command === 'add' ? positionals : rest,
+			options: {
+				dir: values.dir,
+				dryRun: values['dry-run'] ?? false,
+				all: values.all ?? false,
+			},
+			cwd: process.cwd(),
+			packageRoot: PACKAGE_ROOT,
+		});
+		if (values.json) console.log(JSON.stringify(result.report));
+		else (result.stderr ? console.error : console.log)(result.lines.join('\n'));
+		process.exitCode = result.code;
+		break;
+	}
 	case 'help':
 	case '--help':
 	case '-h':

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/BbAvatar.md

@@ -257,7 +257,7 @@ const hiddenCount = computed(() => reviewers.length - maxVisible);
 }
 
 .stack :deep(.bb-avatar + .bb-avatar) {
-	margin-left: -12px;
+	margin-inline-start: -12px;
 }
 </style>
 ```