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

package/llms.txt

@@ -7,7 +7,7 @@ Note: the `dist/` paths below resolve inside the installed npm package (`node_mo
 ## AI Knowledge Base
 
 - [Core knowledge base](https://llms-bitboss-ui.bitboss.it/dist/llms-medium.txt): **Fetch this if you can only fetch one file** — hard rules, setup, component picker, design language, and the full component catalogue in ~250 KB.
-- [Complete knowledge base](https://llms-bitboss-ui.bitboss.it/dist/llms-full.txt): Everything concatenated (~5.8 MB). Bulk ingestion only — too large to prompt with.
+- [Complete knowledge base](https://llms-bitboss-ui.bitboss.it/dist/llms-full.txt): Everything concatenated (~5.9 MB). Bulk ingestion only — too large to prompt with.
 - [AI Router](dist/ai/guides/ai-router.md): **Start here** — tiny hop map for any coding agent (which file to open next).
 - [Component index](dist/ai/index.md): Full component catalogue with agent rules, grouped by category. Each entry links a typed contract (props/events/slots/v-model).
 - [Component API files](dist/ai/manifest/index.json): Machine-readable API, one JSON file per component (`manifest/components/<Name>.json`: every prop, event, slot, v-model and pt part, one per line, plus the public types it uses) — open the index, then the one component. The same data in one ~1.2 MB file for tools is [components.json](dist/ai/components.json); its `types` array lists the public TYPE exports with a `usage` tier (`api` = the ones you reach for) and, on the `api` ones, a `usedBy` array naming the component and prop or event each is the type OF — `BbTableColumn` is `usedBy` `BbTable.columns`, a value you pass, not a tag you write. This file is props and events, not paint.
@@ -35,18 +35,18 @@ Note: the `dist/` paths below resolve inside the installed npm package (`node_mo
 - [Migration v2→v3: BbAlert](dist/ai/guides/migration/components/bb-alert.md): showClose inverted to hideClose, theme replaced by typed variant.
 - [Migration v2→v3: BbAvatar](dist/ai/guides/migration/components/bb-avatar.md): The color prop is removed — retheme the fallback through the --bg / --fg locals.
 - [Migration v2→v3: BbBadge (and where your v2 badges went)](dist/ai/guides/migration/components/bb-badge.md): The v2 BbBadge (floating count/dot) is now BbIndicator; the v3 BbBadge is a new inline pill that also replaces BbChip.
-- [Migration v2→v3: BbBreadcrumbs](dist/ai/guides/migration/components/bb-breadcrumbs.md): Item keys must be strings, the text divider prop is gone, per-item slot names are normalized.
+- [Migration v2→v3: BbBreadcrumbs](dist/ai/guides/migration/components/bb-breadcrumbs.md): Items are { label, value } (were { key, text }), the text divider prop is gone, per-item slot names are normalized.
 - [Migration v2→v3: BbButton](dist/ai/guides/migration/components/bb-button.md): Async click handlers now auto-track loading (behavior flip), built-in tooltip props removed, variant locked to the registry. Leftover v2 --border-color on .bb-button* still paints.
 - [Migration v2→v3: BbCheckbox / BbRadio / BbSwitch](dist/ai/guides/migration/components/bb-checkbox.md): reverse polarity inverted (explicit values flip, default layout unchanged), checked narrowed to boolean, color removed, BbRadio's name no longer required.
-- [Migration v2→v3: BbCheckboxGroup / BbRadioGroup / BbSwitchGroup](dist/ai/guides/migration/components/bb-checkbox-group.md): labelPosition renamed legendPosition, per-item disabled is now inert (use selectable), color and the option affix slots removed, BbRadioGroup's name no longer required, the shared bb-cr-container CSS block split into one per group, and the --bb-checkbox-* / --bb-radio-* / --bb-switch-* globals replaced by glyph locals.
+- [Migration v2→v3: BbCheckboxGroup / BbRadioGroup / BbSwitchGroup](dist/ai/guides/migration/components/bb-checkbox-group.md): labelPosition renamed legendPosition, per-item disabled is now inert (use selectable), color and the option affix slots removed, BbRadioGroup's name no longer required, the shared bb-cr-container CSS block split into one per group, and the --bb-checkbox-* / --bb-radio-* / --bb-switch-* globals replaced by glyph locals, and object items now read their own label / value by default.
 - [Migration v2→v3: BbChip (removed)](dist/ai/guides/migration/components/bb-chip.md): BbChip is gone — BbBadge with clearable is the replacement; non-clearable chips were badges all along.
 - [Migration v2→v3: BbCollapsible](dist/ai/guides/migration/components/bb-collapsible.md): `tag` narrows to `'span' | 'div'` and defaults to `span`; the inner element mirrors it.
 - [Migration v2→v3: BbColorInput](dist/ai/guides/migration/components/bb-color-input.md): picker renamed to eyeDropper.
 - [Migration v2→v3: BbColorPalette](dist/ai/guides/migration/components/bb-color-palette.md): flip inverted to disableFlip, showArrow removed, picker renamed eyeDropper, update:open dropped, model updates never emit null.
 - [Migration v2→v3: BbDatePickerInput](dist/ai/guides/migration/components/bb-date-picker-input.md): allowWriting inverted to disableWriting and hidePopover renamed to disableCalendar, both with a changed token set; the width prop is removed; adaptive mobile sheet by default; non-floating output carries the local offset instead of UTC `Z` (new `utc` prop restores v2 output).
 - [Migration v2→v3: BbDialog](dist/ai/guides/migration/components/bb-dialog.md): showClose inverted to hideClose, #close removed (description restored in beta.19), default widths changed, adaptive bottom sheet on mobile by default, --bb-dialog-* tokens replaced by --bb-panel-p plus locals.
-- [Migration v2→v3: BbDropdown](dist/ai/guides/migration/components/bb-dropdown.md): Items now expect text as the label and can carry variants/submenus; arrowPadding removed; adaptive mobile sheet on by default.
-- [Migration v2→v3: BbDropdownButton](dist/ai/guides/migration/components/bb-dropdown-button.md): autoLoading renamed to disableAutoLoading, disabledWhileLoading and theme removed.
+- [Migration v2→v3: BbDropdown](dist/ai/guides/migration/components/bb-dropdown.md): Rows are { label, value } (v2 and v3 up to beta.48 { key, text }), groups are named by id; rows can carry variants/submenus; arrowPadding removed; adaptive mobile sheet on by default.
+- [Migration v2→v3: BbDropdownButton](dist/ai/guides/migration/components/bb-dropdown-button.md): autoLoading renamed to disableAutoLoading, disabledWhileLoading and theme removed; items are { label, value } rows like BbDropdown's.
 - [Migration v2→v3: BbDropzone](dist/ai/guides/migration/components/bb-dropzone.md): modelValue is typed, accept no longer throws and takes bare tokens, and the hidden native-submit input only renders when name is set.
 - [Migration v2→v3: BbIcon](dist/ai/guides/migration/components/bb-icon.md): The required prop is renamed type→icon, color is removed, and the xxl size key becomes 2xl.
 - [Migration v2→v3: BbIntersection](dist/ai/guides/migration/components/bb-intersection.md): Removed with no replacement — it wrapped IntersectionObserver and carried no styling; use @vueuse/core's useIntersectionObserver.
@@ -55,14 +55,14 @@ Note: the `dist/` paths below resolve inside the installed npm package (`node_mo
 - [Migration v2→v3: BbPopover](dist/ai/guides/migration/components/bb-popover.md): Built-in close button, restoreFocus, theme, and the arrow are gone; close affordances move into your content.
 - [Migration v2→v3: BbRadioGroup](dist/ai/guides/migration/components/bb-radio-group.md): Shares its migration with BbCheckboxGroup — see bb-checkbox-group.md.
 - [Migration v2→v3: BbRating](dist/ai/guides/migration/components/bb-rating.md): color removed; name no longer required; the star classes moved from .bb-base-rating to the .bb-rating block (--highlighted became --filled/--empty); --bb-rating-size demoted to a local --size on .bb-rating__stars; input-position finally works.
-- [Migration v2→v3: BbSelect](dist/ai/guides/migration/components/bb-select.md): allowWriting inverted to disableWriting, filterBy narrowed to string[], prefill value renamed, chevron/options slots removed, and two behavior changes (second click, mount-time coherence).
+- [Migration v2→v3: BbSelect](dist/ai/guides/migration/components/bb-select.md): allowWriting inverted to disableWriting, filterBy narrowed to string[], prefill value renamed, chevron/options slots removed, and three behavior changes (second click, mount-time coherence, object items read their own label / value).
 - [Migration v2→v3: BbSelectPopover](dist/ai/guides/migration/components/bb-select-popover.md): flip and allowWriting inverted, arrow props removed, filterBy narrowed, options slots replaced by header/footer; shares BbSelect's behavior changes.
 - [Migration v2→v3: BbSlider](dist/ai/guides/migration/components/bb-slider.md): thumbTranslate inverted to disableThumbTranslate; string model values and color removed.
 - [Migration v2→v3: BbSmoothHeight](dist/ai/guides/migration/components/bb-smooth-height.md): The `tag` prop is narrowed to `div | span`, and the inner measuring element now mirrors it instead of always being a `<div>`.
 - [Migration v2→v3: BbSpinner](dist/ai/guides/migration/components/bb-spinner.md): The color prop is removed; spinners follow currentColor.
 - [Migration v2→v3: BbSwitchGroup](dist/ai/guides/migration/components/bb-switch-group.md): Shares its migration with BbCheckboxGroup — see bb-checkbox-group.md.
 - [Migration v2→v3: BbTable](dist/ai/guides/migration/components/bb-table.md): The table renders as a CSS grid of divs with ARIA roles, not a <table> — every element selector (table/thead/tbody/tr/th/td) under .bb-table matches nothing, #thead/#tbody/#tfoot take role-complete div rows, --fill/--natural-width are gone, column widths drift within documented bounds, copy-to-spreadsheet and print header repetition degrade; allowSelectAll inverted to disableSelectAll; loading no longer blanks populated tables and now inerts rows; #loading is first-load-only; #empty fills a full-width cell instead of replacing the row; row events drop the selected argument; columns gained sortable + rowClass, which collide with same-named consumer fields.
-- [Migration v2→v3: BbTabs (was BbTab)](dist/ai/guides/migration/components/bb-tabs.md): Component renamed; querykey→queryKey; animations default on; label slots renamed, header:* slots → wrapper:*, and all dynamic names/URL slugs normalized; the entire .bb-tab BEM tree renamed to .bb-tabs / .bb-tabs-list / .bb-tabs-panels.
+- [Migration v2→v3: BbTabs (was BbTab)](dist/ai/guides/migration/components/bb-tabs.md): Component renamed; item key→value (v-model carries it); querykey→queryKey; animations default on; label slots renamed, header:* slots → wrapper:*, and all dynamic names/URL slugs normalized; the entire .bb-tab BEM tree renamed to .bb-tabs / .bb-tabs-list / .bb-tabs-panels.
 - [Migration v2→v3: BbTag](dist/ai/guides/migration/components/bb-tag.md): modelValue is strictly string[] now, multiple is removed, and duplicates are rejected case-insensitively by default.
 - [Migration v2→v3: BbTextInput](dist/ai/guides/migration/components/bb-text-input.md): The type prop narrows to the text-like input types — number/date values must move to their dedicated components; a bare `floating` attribute was never a prop, the spelling is label-mode="floating".
 - [Migration v2→v3: BbToast and toast()](dist/ai/guides/migration/components/bb-toast.md): Host placement becomes position with a corner-based value set; toast() options rewritten (variant, duration, actions, portal).

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bitboss-ui",
-	"version": "3.0.0-beta.47",
+	"version": "3.0.0-beta.49",
 	"description": "Vue 3 component library by BitBoss: forms, selects, layout, overlays, and more.",
 	"license": "MIT",
 	"type": "module",
@@ -91,7 +91,7 @@
 		"preview": "vite preview",
 		"storybook": "storybook dev -p 6006",
 		"test": "node scripts/ensure-manifest.mjs && vitest run && node scripts/check-guide-types.mjs && npm run check:test-types && node scripts/check-fixture-types.mjs && node scripts/check-recipes.mjs && node scripts/check-examples.mjs && node scripts/recipes.mjs --check && node scripts/check-doc-drift.mjs && node scripts/check-doc-ts.mjs && node scripts/run-ai-evals.mjs && node scripts/check-mcp.mjs && node scripts/check-tokens.mjs && node scripts/check-pins.mjs && node scripts/check-deprecation-register.mjs && node scripts/check-inertia-link-props.mjs && node --experimental-strip-types scripts/check-api-consistency.ts --strict && node --experimental-strip-types scripts/check-default-docs.ts && node --experimental-strip-types scripts/generate-component-docs.ts --strict && node scripts/check-doc-links.mjs && node scripts/generate-css-migration.mjs --check",
-		"test:fixtures": "npm run build && node scripts/run-ssr-fixture.mjs && node scripts/invalidate-fixture-caches.mjs && FIXTURE_TARGET=dist node scripts/run-e2es.mjs fixtures/inertia/e2e && FIXTURE_TARGET=dist node scripts/run-e2es.mjs fixtures/vue/e2e && npm run test:nuxt && npm run test:nuxt:prod",
+		"test:fixtures": "npm run build && node scripts/run-ssr-fixture.mjs && node scripts/invalidate-fixture-caches.mjs && FIXTURE_TARGET=dist node scripts/run-e2es.mjs fixtures/inertia/e2e && FIXTURE_TARGET=dist node scripts/run-e2es.mjs fixtures/vue/e2e && npm run test:nuxt && npm run test:nuxt:prod && node scripts/test-add.mjs",
 		"test:fixtures:src": "npm run test:inertia && npm run test:vue && npm run test:nuxt",
 		"test:inertia": "node scripts/invalidate-fixture-caches.mjs && node scripts/run-e2es.mjs fixtures/inertia/e2e",
 		"test:inertia:dist": "npm run build && FIXTURE_TARGET=dist node scripts/run-e2es.mjs fixtures/inertia/e2e",
@@ -106,7 +106,8 @@
 		"test:ci:gates": "node scripts/check-guide-types.mjs && npm run check:test-types && node scripts/check-fixture-types.mjs && node scripts/check-recipes.mjs && node scripts/check-examples.mjs && node scripts/recipes.mjs --check && node scripts/check-doc-drift.mjs && node scripts/check-doc-ts.mjs && node scripts/run-ai-evals.mjs && node scripts/check-pins.mjs && node scripts/check-deprecation-register.mjs && node scripts/check-inertia-link-props.mjs && node --experimental-strip-types scripts/check-default-docs.ts && node scripts/check-doc-links.mjs && node scripts/generate-css-migration.mjs --check",
 		"test:ci": "npm run test:ci:node && npm run test:ci:browser && npm run test:ci:gates",
 		"postpack": "npm pkg set \"scripts.prepare=node scripts/hooks-install.mjs\"",
-		"test:ssr": "npm run build && node scripts/run-ssr-fixture.mjs"
+		"test:ssr": "npm run build && node scripts/run-ssr-fixture.mjs",
+		"helpers:record": "node scripts/helpers-record.mjs"
 	},
 	"dependencies": {
 		"@floating-ui/vue": "^1.1.11",
@@ -234,6 +235,7 @@
 		"!scripts/lib/__fixtures__",
 		"!scripts/lib/fixture-library.mjs",
 		"!scripts/lib/gate.mjs",
+		"!scripts/lib/inertia-helpers.mjs",
 		"!scripts/lib/recipe-files.mjs",
 		"!scripts/lib/vitest-retry.mjs"
 	],

package/scripts/lib/agent-manifest.mjs

@@ -207,7 +207,8 @@ export function renamedFrom(removed) {
 				r.new &&
 				r.surface !== 'event' &&
 				r.surface !== 'method' &&
-				r.surface !== 'option'
+				r.surface !== 'option' &&
+				r.surface !== 'item'
 		)
 		.map((r) => ({
 			from: r.name,

package/scripts/lib/eslint-disable.mjs

@@ -42,19 +42,32 @@ export function ruleForFinding(finding) {
 			return 'text-null-value';
 		case 'unimported-component':
 			return 'no-unimported-component';
+		case 'unknown-portal':
+		case 'portal-family-mismatch':
+			return 'portal-names';
+		case 'unused-portal':
+			return 'unused-portal';
 		case 'form-v-model':
 			return 'form-model';
 		case 'positional-provider':
 			return 'items-provider-context';
 		case 'single-reason':
 			return 'items-provider-reason';
+		case 'redundant-item-accessor':
+			return 'no-redundant-item-accessor';
+		case 'renamed-item-field':
+			return 'no-renamed-item-field';
 		// The check-only kinds below have no ESLint twin, so the partner-prop
-		// rule's name silences them: object items want their `item-text`
-		// partner; a dropdown row needs its key, or keyless rows collide.
+		// rule's name silences them: object items with neither `label` nor
+		// `text` want their `item-text` partner; a dropdown row in a selectable
+		// group needs its `value`, a selectable group its `id`, and rows
+		// without a `value` that share a label collide. (`missing-key` /
+		// `duplicate-row-text` were these kinds' names before 3.0.0-beta.49.)
 		case 'missing-partner-prop':
 		case 'object-items-without-text':
-		case 'missing-key':
-		case 'duplicate-row-text':
+		case 'missing-value':
+		case 'missing-id':
+		case 'duplicate-row-label':
 			return 'require-partner-prop';
 		// check-only: a CSS local the library removed; an import of the
 		// package's build files or of its unexported pt types.

package/scripts/lib/eslint-plugin.d.ts

@@ -38,10 +38,14 @@ export type BitbossUiRuleName =
 	| 'no-retired-entrypoint'
 	| 'no-reactive-v-model'
 	| 'no-unimported-component'
+	| 'portal-names'
+	| 'unused-portal'
 	| 'text-null-value'
 	| 'form-model'
 	| 'items-provider-context'
-	| 'items-provider-reason';
+	| 'items-provider-reason'
+	| 'no-redundant-item-accessor'
+	| 'no-renamed-item-field';
 
 /** Options accepted by `bitboss-ui/no-unknown-token`. */
 export interface NoUnknownTokenOptions {
@@ -125,10 +129,14 @@ export const noStarColor: Rule.RuleModule;
 export const requireAccessibleName: Rule.RuleModule;
 export const noReactiveVModel: Rule.RuleModule;
 export const noUnimportedComponent: Rule.RuleModule;
+export const portalNames: Rule.RuleModule;
+export const unusedPortal: Rule.RuleModule;
 export const textNullValue: Rule.RuleModule;
 export const formModel: Rule.RuleModule;
 export const itemsProviderContext: Rule.RuleModule;
 export const itemsProviderReason: Rule.RuleModule;
+export const noRedundantItemAccessor: Rule.RuleModule;
+export const noRenamedItemField: Rule.RuleModule;
 
 /**
  * Resolves the optional `@typescript-eslint/parser` peer, or `null` when it is

package/scripts/lib/eslint-plugin.mjs

@@ -119,6 +119,8 @@ import {
 	writableComputedNames,
 } from './form-v-model.mjs';
 import { libraryAliases, localBbImports } from './local-components.mjs';
+import { redundantItemAccessorFindings } from './redundant-item-accessor.mjs';
+import { renamedItemFieldFindings } from './renamed-item-field.mjs';
 import {
 	TEXT_NULL_VALUE_MESSAGE,
 	stringControlsFor,
@@ -134,6 +136,11 @@ import {
 	projectRootFor,
 	resolverFor,
 } from './unimported-components.mjs';
+import {
+	MAY_HAVE_PORTALS,
+	portalFindings,
+	projectPortalIndex,
+} from './portal-names.mjs';
 import {
 	ITEMS_PROVIDER_MESSAGES,
 	isPositional,
@@ -146,6 +153,28 @@ import {
 	topLevelBindings,
 } from './items-provider-context.mjs';
 
+/**
+ * `libraryImports`: import-source prefixes that ARE the library, for the
+ * library's own repo, whose showcases import the source
+ * (`@/components/BbSelect/BbSelect.vue`). Without it those `Bb*` imports read
+ * as the app's own components and every rule skips them. Empty by default: a
+ * consumer's `Bb*` imports stay theirs (Q53.18). See `isLibrarySource`.
+ */
+const LIBRARY_IMPORTS_SCHEMA = { type: 'array', items: { type: 'string' } };
+const LIBRARY_ONLY_SCHEMA = [
+	{
+		type: 'object',
+		properties: { libraryImports: LIBRARY_IMPORTS_SCHEMA },
+		additionalProperties: false,
+	},
+];
+/** The `isLibrarySource` input for this file. */
+const libraryOf = (context) => ({
+	libraryImports: context.options[0]?.libraryImports ?? [],
+	filename: context.filename ?? context.getFilename(),
+	cwd: context.cwd ?? context.getCwd?.(),
+});
+
 /**
  * The components a rule skips entirely: the configured `allowComponents`, plus
  * every `Bb*` name this file imports from a non-`bitboss-ui` path — the app's
@@ -155,7 +184,7 @@ const allowedComponentsFor = (context, options) => {
 	const text = (context.sourceCode ?? context.getSourceCode()).text;
 	return new Set([
 		...(options.allowComponents ?? []),
-		...localBbImports(text).keys(),
+		...localBbImports(text, libraryOf(context)).keys(),
 		// A library component under another name (`{ BbButton as BbSave }`):
 		// `check` validates it as the real component; the rules skip it rather
 		// than report the alias as unknown.
@@ -290,6 +319,7 @@ const noUnknownAttributes = {
 					failClosed: { type: 'boolean' },
 					allowAttributes: { type: 'array', items: { type: 'string' } },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -652,6 +682,7 @@ const requireTableSlotProp = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -758,6 +789,7 @@ const requirePartnerProp = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -849,6 +881,7 @@ const noUnknownSlots = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 					allowSlots: { type: 'array', items: { type: 'string' } },
 				},
 				additionalProperties: false,
@@ -987,6 +1020,7 @@ const noActiveClassOnRootLink = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -1096,6 +1130,7 @@ const noNavigationAttrFallthrough = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -1192,6 +1227,7 @@ const noUnknownEvent = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 					allowEvents: { type: 'array', items: { type: 'string' } },
 				},
 				additionalProperties: false,
@@ -1290,6 +1326,7 @@ const noReverseFalse = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 					// Opt-in for a bulk v2→v3 sweep: turn the "control on the right"
 					// rewrite into a real `--fix`. Off by default because the two
 					// readings produce OPPOSITE layouts, and a v3-native codebase
@@ -1462,6 +1499,7 @@ const noStateTextColor = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -1669,6 +1707,7 @@ const noStarColor = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -1828,6 +1867,7 @@ const noBoxBorderColor = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -2165,6 +2205,7 @@ const requireAccessibleName = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -2376,6 +2417,7 @@ const noUnimportedComponent = {
 					manifestPath: { type: 'string' },
 					failClosed: { type: 'boolean' },
 					allowComponents: { type: 'array', items: { type: 'string' } },
+					libraryImports: LIBRARY_IMPORTS_SCHEMA,
 				},
 				additionalProperties: false,
 			},
@@ -2413,6 +2455,62 @@ const noUnimportedComponent = {
 	},
 };
 
+/**
+ * Q63.8 — the twins of `check`'s portal findings, from one shared module
+ * (portal-names.mjs) and one project scan per root. Two rules, because one
+ * rule has one severity: a name nothing declares, or a portal of the other
+ * family, opens nothing (`portal-names`, an error); a portal nothing opens is
+ * dead code at worst (`unused-portal`, a warning). Literal names only:
+ * anything dynamic is never judged.
+ * @param {'portal-names' | 'unused-portal'} which
+ * @returns {import('eslint').Rule.RuleModule}
+ */
+const portalRule = (which) => ({
+	meta: {
+		type: which === 'portal-names' ? 'problem' : 'suggestion',
+		docs: {
+			description:
+				which === 'portal-names'
+					? 'Flag a `v-bb-hover-card` / `v-bb-popover` / `confirm()` portal name that no `<…Portal name>` in the project declares, or that belongs to the other family.'
+					: 'Flag a `<BbHoverCardPortal>` / `<BbPopoverPortal>` / `<BbConfirmPortal>` that nothing in the project opens.',
+			recommended: true,
+		},
+		schema: [],
+		messages: { portal: '{{message}}' },
+	},
+	create(context) {
+		const filename = context.filename ?? context.getFilename();
+		if (!filename || !/\.(?:vue|[cm]?[jt]sx?)$/.test(filename)) return {};
+		const sourceCode = context.sourceCode ?? context.getSourceCode();
+		return {
+			'Program:exit'() {
+				const text = sourceCode.text;
+				if (!MAY_HAVE_PORTALS.test(text)) return;
+				const root = projectRootFor(filename);
+				const index = root ? projectPortalIndex(root) : null;
+				const lines = sourceCode.lines ?? text.split('\n');
+				for (const finding of portalFindings(text, filename, index)) {
+					const isUnused = finding.kind === 'unused-portal';
+					if (isUnused !== (which === 'unused-portal')) continue;
+					const line = Math.max(1, Math.min(finding.line, lines.length));
+					const first = lines[line - 1] ?? '';
+					context.report({
+						loc: {
+							start: { line, column: first.length - first.trimStart().length },
+							end: { line, column: first.length },
+						},
+						messageId: 'portal',
+						data: { message: finding.message },
+					});
+				}
+			},
+		};
+	},
+});
+
+const portalNames = portalRule('portal-names');
+const unusedPortal = portalRule('unused-portal');
+
 /**
  * The twin of `check`'s `text-null-value` (owner 2026-10-05): a `v-model` on
  * BbTextInput / BbTextarea bound to a `<script setup>` ref typed `string`
@@ -2434,7 +2532,7 @@ const textNullValue = {
 			recommended: true,
 		},
 		messages: { stringRef: '{{message}}' },
-		schema: [],
+		schema: LIBRARY_ONLY_SCHEMA,
 	},
 	create(context) {
 		const sourceCode = context.sourceCode ?? context.getSourceCode();
@@ -2459,7 +2557,7 @@ const textNullValue = {
 		});
 		if (refs.size === 0) return {};
 		const aliases = libraryAliases(sourceCode.text);
-		const own = localBbImports(sourceCode.text);
+		const own = localBbImports(sourceCode.text, libraryOf(context));
 		const filename = context.filename ?? context.getFilename();
 		let stringControls;
 		const fixed = new Set();
@@ -2647,7 +2745,7 @@ const itemsProviderVisitor = (context, onProvider) => {
 	const services = sourceCode.parserServices;
 	if (!services?.defineTemplateBodyVisitor) return {};
 	const aliases = libraryAliases(sourceCode.text);
-	const own = localBbImports(sourceCode.text);
+	const own = localBbImports(sourceCode.text, libraryOf(context));
 	const bindings = topLevelBindings(sourceCode.ast.body);
 	const seen = new Set();
 	return services.defineTemplateBodyVisitor({
@@ -2705,7 +2803,7 @@ const itemsProviderContext = {
 			recommended: true,
 		},
 		messages: { positional: '{{message}}' },
-		schema: [],
+		schema: LIBRARY_ONLY_SCHEMA,
 	},
 	create(context) {
 		return itemsProviderVisitor(
@@ -2749,7 +2847,7 @@ const itemsProviderReason = {
 			recommended: true,
 		},
 		messages: { singleReason: '{{message}}' },
-		schema: [],
+		schema: LIBRARY_ONLY_SCHEMA,
 	},
 	create(context) {
 		return itemsProviderVisitor(context, ({ fn }) => {
@@ -2764,6 +2862,140 @@ const itemsProviderReason = {
 	},
 };
 
+/**
+ * Q60.24 — the twin of `check`'s `redundant-item-accessor` (a warning): an
+ * accessor that names the field the option default already reads —
+ * `item-text="label"` / `"text"`, `item-value="value"` (static or bound to a
+ * string literal, kebab or camel) on BbSelect, BbSelectPopover, BbRadioGroup,
+ * BbCheckboxGroup and BbSwitchGroup, and `itemText: 'label'` / `'text'` /
+ * `itemValue: 'value'` in a BbDropdown / BbDropdownButton group. The fix
+ * deletes it. Caveat: `item-text="text"` is NOT redundant when an item also
+ * has `label` (the default would read `label`), so it is reported only when
+ * every item is visible in the file and none has `label`; on items the file
+ * cannot see only `item-text="label"` and `item-value="value"` are. A group
+ * whose only mapper is the redundant one is left alone: without it the group
+ * would turn hand-written.
+ * @type {import('eslint').Rule.RuleModule}
+ */
+const noRedundantItemAccessor = {
+	meta: {
+		type: 'suggestion',
+		fixable: 'code',
+		docs: {
+			description:
+				'Remove an `item-text` / `item-value` (or a dropdown group\'s `itemText` / `itemValue`) that restates the default: options read their own `label`, else `text`, and their own `value`. `item-text="text"` is kept when an item also has `label`.',
+			recommended: true,
+		},
+		messages: { redundant: '{{message}}' },
+		schema: LIBRARY_ONLY_SCHEMA,
+	},
+	create(context) {
+		const sourceCode = context.sourceCode ?? context.getSourceCode();
+		if (!sourceCode.parserServices?.defineTemplateBodyVisitor) return {};
+		return {
+			'Program:exit'() {
+				const text = sourceCode.text;
+				const findings = redundantItemAccessorFindings(text, {
+					arrays: scriptSetupArrayConsts(text),
+					library: libraryOf(context),
+				});
+				// Each finding carries its fix as a text edit. Neighbouring
+				// deletions touch (`item-text="label" item-value="value"`), and
+				// ESLint drops a fix that touches another: the first deletion of a
+				// run carries one fix for the whole run. A rewrite (non-empty
+				// text) is never merged.
+				const ranged = findings
+					.filter((finding) => finding.range)
+					.sort((a, b) => (a.edit?.range[0] ?? 0) - (b.edit?.range[0] ?? 0));
+				const fixFor = new Map();
+				let run = null;
+				for (const finding of ranged) {
+					const edit = finding.edit;
+					if (!edit) continue;
+					if (
+						edit.text === '' &&
+						run?.text === '' &&
+						edit.range[0] <= run.range[1]
+					) {
+						run.range[1] = Math.max(run.range[1], edit.range[1]);
+						continue;
+					}
+					run = { range: [...edit.range], text: edit.text };
+					fixFor.set(finding, run);
+				}
+				for (const finding of ranged) {
+					const own = fixFor.get(finding);
+					context.report({
+						loc: {
+							start: sourceCode.getLocFromIndex(finding.range[0]),
+							end: sourceCode.getLocFromIndex(finding.range[1]),
+						},
+						messageId: 'redundant',
+						data: { message: finding.message },
+						fix: own
+							? (fixer) => fixer.replaceTextRange(own.range, own.text)
+							: undefined,
+					});
+				}
+			},
+		};
+	},
+};
+
+/**
+ * Q64.2–Q64.5 — the twin of `check`'s `renamed-item-field`: an item field
+ * spelled the pre-beta.49 way in an `items` array the file spells (inline or a
+ * `<script setup>` const): BbDropdown / BbDropdownButton / `v-bb-dropdown`
+ * rows `key` → `value`, `text` → `label`, groups `key` → `id`; BbTabs /
+ * BbTabsRoot items `key` → `value`; BbBreadcrumbs items `key` → `value`,
+ * `text` → `label`. The fix renames the property (`{ key }` becomes
+ * `{ value: key }`); an object that already has the new field or spreads
+ * another is reported without one. A mapped group's rows (app data) are never
+ * touched.
+ * @type {import('eslint').Rule.RuleModule}
+ */
+const noRenamedItemField = {
+	meta: {
+		type: 'problem',
+		fixable: 'code',
+		docs: {
+			description:
+				'Rename an item field the library renamed in 3.0.0-beta.49: dropdown rows and breadcrumbs `{ key, text }` → `{ value, label }`, dropdown groups `key` → `id`, tabs `key` → `value`.',
+			recommended: true,
+		},
+		messages: { renamed: '{{message}}' },
+		schema: LIBRARY_ONLY_SCHEMA,
+	},
+	create(context) {
+		const sourceCode = context.sourceCode ?? context.getSourceCode();
+		if (!sourceCode.parserServices?.defineTemplateBodyVisitor) return {};
+		return {
+			'Program:exit'() {
+				const text = sourceCode.text;
+				const findings = renamedItemFieldFindings(text, {
+					arrays: scriptSetupArrayConsts(text),
+					library: libraryOf(context),
+				});
+				for (const finding of findings) {
+					if (!finding.range) continue;
+					const edit = finding.edit;
+					context.report({
+						loc: {
+							start: sourceCode.getLocFromIndex(finding.range[0]),
+							end: sourceCode.getLocFromIndex(finding.range[1]),
+						},
+						messageId: 'renamed',
+						data: { message: finding.message },
+						fix: edit
+							? (fixer) => fixer.replaceTextRange(edit.range, edit.text)
+							: undefined,
+					});
+				}
+			},
+		};
+	},
+};
+
 const plugin = {
 	meta: { name: 'bitboss-ui', version: PACKAGE_VERSION },
 	rules: {
@@ -2783,10 +3015,14 @@ const plugin = {
 		'no-retired-entrypoint': noRetiredEntrypoint,
 		'no-reactive-v-model': noReactiveVModel,
 		'no-unimported-component': noUnimportedComponent,
+		'portal-names': portalNames,
+		'unused-portal': unusedPortal,
 		'text-null-value': textNullValue,
 		'form-model': formModel,
 		'items-provider-context': itemsProviderContext,
 		'items-provider-reason': itemsProviderReason,
+		'no-redundant-item-accessor': noRedundantItemAccessor,
+		'no-renamed-item-field': noRenamedItemField,
 	},
 };
 
@@ -2873,6 +3109,10 @@ plugin.configs = {
 				'bitboss-ui/no-reactive-v-model': 'error',
 				// Q61.19: `error`, the tag renders nothing; the fix is one import.
 				'bitboss-ui/no-unimported-component': 'error',
+				// Q63.8: `error`, a portal name nothing declares (or the other
+				// family's) opens nothing; `warn` for a portal nothing opens.
+				'bitboss-ui/portal-names': 'error',
+				'bitboss-ui/unused-portal': 'warn',
 				// `error`: the ref's type is wrong the moment the field is
 				// emptied, and the fix (widening it) only makes the type true.
 				'bitboss-ui/text-null-value': 'error',
@@ -2885,6 +3125,12 @@ plugin.configs = {
 				// `warn`: a single-cause check can be deliberate, but it usually
 				// loses the selected labels on the causes it does not list.
 				'bitboss-ui/items-provider-reason': 'warn',
+				// Q60.24: `warn`, the markup works either way; the fix deletes
+				// an accessor that restates the default.
+				'bitboss-ui/no-redundant-item-accessor': 'warn',
+				// Q64.2–Q64.5: `error`, an item with the old field silently loses
+				// its value, id or label; the fix is mechanical.
+				'bitboss-ui/no-renamed-item-field': 'error',
 			},
 		},
 	],
@@ -2907,9 +3153,13 @@ export {
 	requireAccessibleName,
 	noReactiveVModel,
 	noUnimportedComponent,
+	portalNames,
+	unusedPortal,
 	textNullValue,
 	formModel,
 	itemsProviderContext,
 	itemsProviderReason,
+	noRedundantItemAccessor,
+	noRenamedItemField,
 	resolveOptionalTsParser,
 };