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

package/dist/ai/helpers/inertia/useProp.ts

@@ -0,0 +1,63 @@
+// inertia-helpers/useProp.ts
+import { usePage } from '@inertiajs/vue3';
+import { computed, nextTick, ref, type ComputedRef } from 'vue';
+
+const walk = <T>(
+	source: unknown,
+	path: string[]
+): { found: boolean; value: T | undefined } => {
+	let current: unknown = source;
+	for (const segment of path) {
+		if (
+			current === null ||
+			typeof current !== 'object' ||
+			!(segment in current)
+		) {
+			return { found: false, value: undefined };
+		}
+		current = (current as Record<string, unknown>)[segment];
+	}
+	return { found: true, value: current as T };
+};
+
+const toPath = (propPath: string | string[]): string[] =>
+	typeof propPath === 'string' ? propPath.split('.') : propPath;
+
+/** Reactive page prop by path. Throws when the path is not present. */
+export const useProp = <T>(propPath: string | string[]): ComputedRef<T> => {
+	const page = usePage();
+	const path = toPath(propPath);
+	// The last value read, and the page (component + url) it was read on.
+	let last: { value: T; page: string } | null = null;
+	// Bumped once the navigation's update has flushed: ends the grace read.
+	const graceOver = ref(0);
+
+	return computed(() => {
+		void graceOver.value;
+		const { found, value } = walk<T>(page.props, path);
+		const visit = `${page.component} ${page.url}`;
+		if (found) {
+			last = { value: value as T, page: visit };
+			return value as T;
+		}
+		if (last && last.page !== visit) {
+			// The page just changed under a reader that is unmounting: hand it
+			// the last value for this flush only, then fail loudly again.
+			const stale = last.value;
+			last = null;
+			void nextTick(() => graceOver.value++);
+			return stale;
+		}
+		throw new Error(`Page prop "${path.join('.')}" is missing.`);
+	});
+};
+
+/** Like useProp, but resolves to `undefined` when the path is missing. */
+export const useOptionalProp = <T>(
+	propPath: string | string[]
+): ComputedRef<T | undefined> => {
+	const page = usePage();
+	const path = toPath(propPath);
+
+	return computed(() => walk<T>(page.props, path).value);
+};

package/dist/ai/helpers/inertia/useQuery.ts

@@ -0,0 +1,19 @@
+// inertia-helpers/useQuery.ts
+// requires: npm i query-string
+import { usePage } from '@inertiajs/vue3';
+import qs, { type StringifyOptions } from 'query-string';
+
+export const useQuery = ({
+	arrayFormat = 'comma',
+}: { arrayFormat?: StringifyOptions['arrayFormat'] } = {}): Record<
+	string,
+	unknown
+> => {
+	const { url } = usePage();
+	const [, queryString] = url.split('?');
+	if (!queryString) return {};
+	return qs.parse(decodeURIComponent(queryString), {
+		arrayFormat,
+		decode: true,
+	});
+};

package/dist/ai/helpers/inertia/useQueryObject.ts

@@ -0,0 +1,116 @@
+// inertia-helpers/useQueryObject.ts
+// requires: npm i query-string
+import { useQuery } from './useQuery';
+import { isEmpty, isNil } from './utils';
+import { router, usePage } from '@inertiajs/vue3';
+import qs, { type StringifyOptions } from 'query-string';
+import { toValue, watch, type MaybeRefOrGetter } from 'vue';
+
+type Options<T> = {
+	transform?: (value: Partial<T>) => Partial<T>;
+	/** Reset the `page` parameter on change. Default true. */
+	resetPage?: boolean;
+	/** Additional query keys removed whenever the object changes. */
+	resetKeys?: string[];
+	/** Inertia partial reload prop names (supports reactive getter). */
+	only?: MaybeRefOrGetter<string[]>;
+	/**
+	 * When it resolves to `false` the watcher keeps tracking keys but skips
+	 * the navigation — use it when another owner performs the visit during a
+	 * programmatic transition, to avoid competing self-cancelling requests.
+	 */
+	shouldNavigate?: MaybeRefOrGetter<boolean>;
+	arrayFormat?: StringifyOptions['arrayFormat'];
+	preserveState?: boolean;
+	preserveScroll?: boolean;
+	replace?: boolean;
+};
+
+export function useQueryObject<T extends Record<string, unknown>>(
+	object: MaybeRefOrGetter<T>,
+	options: Options<T> = {}
+): void {
+	const {
+		transform,
+		resetPage = true,
+		resetKeys = [],
+		preserveState = true,
+		preserveScroll = true,
+		replace = true,
+		only: onlyOption = [],
+		shouldNavigate = true,
+		arrayFormat = 'comma',
+	} = options;
+
+	const filterValidValues = (obj: T): Partial<T> => {
+		const filtered: Partial<T> = {};
+		Object.entries(obj).forEach(([key, val]) => {
+			if (!isNil(val) && val !== '') {
+				(filtered as Record<string, unknown>)[key] = val;
+			}
+		});
+		return filtered;
+	};
+
+	/** Every key this composable has ever managed, for stable URL cleanup. */
+	const seenKeys = new Set<string>(Object.keys(toValue(object) ?? {}));
+
+	watch(
+		() => toValue(object),
+		(newObject) => {
+			if (!newObject) return;
+
+			Object.keys(newObject).forEach((key) => {
+				if (!seenKeys.has(key)) {
+					console.warn(
+						`[useQueryObject] Key "${key}" appeared after initialization. ` +
+							`Initialize the object with all possible keys for stable URL cleanup.`
+					);
+				}
+				seenKeys.add(key);
+			});
+
+			const validValues = filterValidValues(newObject);
+			const transformedValues = transform
+				? transform(validValues)
+				: validValues;
+
+			// Start from the existing query to preserve keys owned elsewhere.
+			const existingQuery = useQuery({ arrayFormat });
+			seenKeys.forEach((key) => delete existingQuery[key]);
+			if (resetPage) delete existingQuery.page;
+			resetKeys.forEach((key) => delete existingQuery[key]);
+
+			Object.entries(transformedValues).forEach(([key, val]) => {
+				if (!isEmpty(val)) existingQuery[key] = val;
+			});
+
+			const stringified = qs.stringify(existingQuery, { arrayFormat });
+			const newUrl = stringified
+				? [window.location.pathname, stringified].join('?')
+				: window.location.pathname;
+
+			if (newUrl === usePage().url) return;
+			if (!toValue(shouldNavigate)) return;
+
+			router.visit(newUrl, {
+				preserveState,
+				preserveScroll,
+				only: toValue(onlyOption),
+				replace,
+			});
+		},
+		/*
+		 * Default flush, deliberately NOT `sync`. Vue batches a tick's mutations
+		 * into one watcher run, so a `clearFilters()` that blanks three keys
+		 * fires ONE visit instead of three (measured: 3 writes → 3 runs under
+		 * `sync`, 1 under the default). The two it saves used to self-cancel,
+		 * but they were still sent.
+		 *
+		 * This does NOT make typing cheap — one visit per settled keystroke is
+		 * still one visit per keystroke. Debounce the source for that; see the
+		 * note below.
+		 */
+		{ deep: true }
+	);
+}

package/dist/ai/helpers/inertia/useResourceContext.ts

@@ -0,0 +1,69 @@
+// inertia-helpers/useResourceContext.ts
+import { useLoading } from './useLoading';
+import { noop } from './utils';
+import { ref, toValue, watch, type MaybeRefOrGetter, type Ref } from 'vue';
+
+type UseResourceContextOptions<T, ID> = {
+	immediate?: boolean;
+	disabled?: MaybeRefOrGetter<boolean>;
+	onReset?: () => void | Promise<void>;
+	onSuccess?: (data: T, resourceId: ID) => void | Promise<void>;
+	onError?: (error: unknown, resourceId: ID) => void | Promise<void>;
+	onFinish?: (resourceId: ID) => void | Promise<void>;
+};
+
+export function useResourceContext<T, ID = string>(
+	id: MaybeRefOrGetter<ID | null | undefined>,
+	fn: (id: ID) => Promise<T>,
+	options: UseResourceContextOptions<T, ID> = {}
+) {
+	const data = ref<T | null>(null) as Ref<T | null>;
+	const {
+		immediate = true,
+		disabled = false,
+		onSuccess = noop,
+		onError = (error: unknown) => {
+			console.error('Failed to fetch resource:', error);
+		},
+		onReset = noop,
+		onFinish = noop,
+	} = options;
+
+	const { loading, fn: fetch } = useLoading((resourceId: ID) => fn(resourceId));
+
+	const load = async (resourceId: ID) => {
+		try {
+			const result = await fetch(resourceId);
+			data.value = result;
+			await onSuccess(result, resourceId);
+		} catch (error) {
+			data.value = null;
+			await onError(error, resourceId);
+		} finally {
+			await onFinish(resourceId);
+		}
+	};
+
+	watch(
+		() => ({ resourceId: toValue(id), isDisabled: toValue(disabled) }),
+		async ({ resourceId, isDisabled }) => {
+			if (!resourceId) {
+				data.value = null;
+				await onReset();
+				return;
+			}
+			// Keep already-loaded data while disabled.
+			if (isDisabled) return;
+			await load(resourceId as ID);
+		},
+		{ immediate }
+	);
+
+	const refresh = async () => {
+		const currentId = toValue(id);
+		if (toValue(disabled) || !currentId) return;
+		await load(currentId as ID);
+	};
+
+	return { data, loading, refresh };
+}

package/dist/ai/helpers/inertia/useRouteQuery.ts

@@ -0,0 +1,54 @@
+// inertia-helpers/useRouteQuery.ts
+// requires: npm i query-string
+import { router, usePage } from '@inertiajs/vue3';
+import qs from 'query-string';
+import { computed, type WritableComputedRef } from 'vue';
+
+type Options<T> = {
+	/** Parse the raw string (e.g. `Number`). Defaults to identity. */
+	transform?: (value: string) => T;
+	preserveScroll?: boolean;
+	preserveState?: boolean;
+};
+
+export function useRouteQuery<T = string>(
+	key: string,
+	defaultValue: string,
+	options: Options<T> = {}
+): WritableComputedRef<T> {
+	const {
+		transform = (value) => value as unknown as T,
+		preserveScroll = true,
+		preserveState = true,
+	} = options;
+	const page = usePage();
+
+	const readRaw = (): string => {
+		const [, queryString = ''] = page.url.split('?');
+		const raw = qs.parse(queryString)[key];
+		const single = Array.isArray(raw) ? raw[0] : raw;
+		return single != null ? String(single) : defaultValue;
+	};
+
+	return computed<T>({
+		get: () => transform(readRaw()),
+		set: (next) => {
+			const nextRaw = String(next);
+			if (nextRaw === readRaw()) return;
+
+			const [path = '', queryString = ''] = page.url.split('?');
+			const query = qs.parse(queryString);
+			if (nextRaw === defaultValue) {
+				delete query[key]; // keep URLs clean at the default
+			} else {
+				query[key] = nextRaw;
+			}
+			const stringified = qs.stringify(query);
+			router.visit(stringified ? `${path}?${stringified}` : path, {
+				preserveScroll,
+				preserveState,
+				replace: true,
+			});
+		},
+	});
+}

package/dist/ai/helpers/inertia/useScreenSizes.ts

@@ -0,0 +1,23 @@
+// inertia-helpers/useScreenSizes.ts
+import { createSharedComposable, useWindowSize } from '@vueuse/core';
+import { computed } from 'vue';
+
+/** Tailwind md breakpoint (px). Mobile when width < 768. */
+export const SCREEN_BREAKPOINT_MD = 768;
+/** Tailwind lg breakpoint (px). Tablet when 768 <= width < 1024. */
+export const SCREEN_BREAKPOINT_LG = 1024;
+
+const useScreenSizesImpl = () => {
+	const { width } = useWindowSize();
+
+	const isMobile = computed(() => width.value < SCREEN_BREAKPOINT_MD);
+	const isTablet = computed(
+		() =>
+			width.value >= SCREEN_BREAKPOINT_MD && width.value < SCREEN_BREAKPOINT_LG
+	);
+	const isDesktop = computed(() => width.value >= SCREEN_BREAKPOINT_LG);
+
+	return { width, isMobile, isTablet, isDesktop };
+};
+
+export const useScreenSizes = createSharedComposable(useScreenSizesImpl);

package/dist/ai/helpers/inertia/useTableContext.ts

@@ -0,0 +1,34 @@
+// inertia-helpers/useTableContext.ts
+import {
+	usePaginatedResponseContext,
+	type PaginatedResponseContext,
+} from './usePaginatedResponseContext';
+import {
+	useTableSelectionContext,
+	type TableSelectionContext,
+} from './useTableSelectionContext';
+import { isNotNil } from './utils';
+import { injectLocal, provideLocal } from '@vueuse/core';
+
+export type TableContext<T, U> = TableSelectionContext<U> &
+	PaginatedResponseContext<T>;
+
+const toTableKey = (key: string): string => `${key}:table`;
+
+export const useTableContext = <T = object, U = T>(
+	dataKey: string
+): TableContext<T, U> => {
+	const existing = injectLocal<TableContext<T, U> | null>(
+		toTableKey(dataKey),
+		null
+	);
+	if (isNotNil(existing)) return existing;
+
+	const context: TableContext<T, U> = {
+		...useTableSelectionContext<U>(dataKey),
+		...usePaginatedResponseContext<T>(dataKey),
+	};
+
+	provideLocal(toTableKey(dataKey), context);
+	return context;
+};

package/dist/ai/helpers/inertia/useTableSelectionContext.ts

@@ -0,0 +1,48 @@
+// inertia-helpers/useTableSelectionContext.ts
+import { isNotNil } from './utils';
+import { injectLocal, provideLocal } from '@vueuse/core';
+import { ref, type Ref } from 'vue';
+
+export type TableSelectionContext<U> = {
+	/** The select-all checkbox state. Does not enumerate items. */
+	all: Ref<boolean>;
+	/** Items manually selected. NOT the full list when `all` is true. */
+	selected: Ref<U[]>;
+	/** Items manually unselected while `all` is true. */
+	unselected: Ref<U[]>;
+	resetSelection: () => void;
+};
+
+const toSelectionKey = (key: string): string => `${key}:selection`;
+
+/** Bare selection state, no provide/inject — for callers that own sharing. */
+export const createSelectionContext = <
+	U = unknown,
+>(): TableSelectionContext<U> => {
+	const all = ref(false);
+	const selected = ref<U[]>([]) as Ref<U[]>;
+	const unselected = ref<U[]>([]) as Ref<U[]>;
+
+	const resetSelection = (): void => {
+		all.value = false;
+		selected.value = [];
+		unselected.value = [];
+	};
+
+	return { all, selected, unselected, resetSelection };
+};
+
+export const useTableSelectionContext = <U = unknown>(
+	key: string
+): TableSelectionContext<U> => {
+	const selectionKey = toSelectionKey(key);
+	const existing = injectLocal<TableSelectionContext<U> | null>(
+		selectionKey,
+		null
+	);
+	if (isNotNil(existing)) return existing;
+
+	const context = createSelectionContext<U>();
+	provideLocal(selectionKey, context);
+	return context;
+};

package/dist/ai/helpers/inertia/useUntil.ts

@@ -0,0 +1,33 @@
+// inertia-helpers/useUntil.ts
+import { noop } from './utils';
+import { ref, toValue, watch, type MaybeRefOrGetter } from 'vue';
+
+type Options<T, U> = {
+	initialValue?: T;
+	nextValue?: U;
+	onChange?: VoidFunction;
+};
+
+export const useUntil = <T = boolean, U = boolean>(
+	condition: MaybeRefOrGetter<boolean>,
+	{
+		initialValue = false as T,
+		nextValue = true as U,
+		onChange = noop,
+	}: Options<T, U> = {}
+) => {
+	const value = ref<T | U>(initialValue);
+
+	const stopWatching = watch(
+		() => toValue(condition),
+		(met) => {
+			if (met) {
+				onChange();
+				value.value = nextValue;
+				stopWatching();
+			}
+		}
+	);
+
+	return value;
+};

package/dist/ai/helpers/inertia/utils.ts

@@ -0,0 +1,24 @@
+// inertia-helpers/utils.ts
+// micro-utilities the helpers share
+import { hash } from 'object-code';
+
+export const isNil = (value: unknown): value is null | undefined =>
+	value === null || value === undefined;
+
+export const isNotNil = <T>(value: T | null | undefined): value is T =>
+	!isNil(value);
+
+export const isEmpty = (value: unknown): boolean =>
+	isNil(value) || value === '' || (Array.isArray(value) && value.length === 0);
+
+export const noop = (): void => undefined;
+
+/** Deep equality by structural hash — cheap and dependency-light. */
+export const isEqual = (a: unknown, b: unknown): boolean => hash(a) === hash(b);
+
+export const isPlainObject = (
+	value: unknown
+): value is Record<string, unknown> =>
+	typeof value === 'object' &&
+	value !== null &&
+	Object.getPrototypeOf(value) === Object.prototype;

package/dist/ai/index.md

@@ -214,18 +214,18 @@ Do not use these components directly in consumer code unless the user explicitly
 - [Migration v2→v3: BbAlert](./guides/migration/components/bb-alert.md) - showClose inverted to hideClose, theme replaced by typed variant.
 - [Migration v2→v3: BbAvatar](./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)](./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](./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](./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](./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](./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](./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](./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)](./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](./guides/migration/components/bb-collapsible.md) - `tag` narrows to `'span' | 'div'` and defaults to `span`; the inner element mirrors it.
 - [Migration v2→v3: BbColorInput](./guides/migration/components/bb-color-input.md) - picker renamed to eyeDropper.
 - [Migration v2→v3: BbColorPalette](./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](./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](./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](./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](./guides/migration/components/bb-dropdown-button.md) - autoLoading renamed to disableAutoLoading, disabledWhileLoading and theme removed.
+- [Migration v2→v3: BbDropdown](./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](./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](./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](./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](./guides/migration/components/bb-intersection.md) - Removed with no replacement — it wrapped IntersectionObserver and carried no styling; use @vueuse/core's useIntersectionObserver.
@@ -234,14 +234,14 @@ Do not use these components directly in consumer code unless the user explicitly
 - [Migration v2→v3: BbPopover](./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](./guides/migration/components/bb-radio-group.md) - Shares its migration with BbCheckboxGroup — see bb-checkbox-group.md.
 - [Migration v2→v3: BbRating](./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](./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](./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](./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](./guides/migration/components/bb-slider.md) - thumbTranslate inverted to disableThumbTranslate; string model values and color removed.
 - [Migration v2→v3: BbSmoothHeight](./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](./guides/migration/components/bb-spinner.md) - The color prop is removed; spinners follow currentColor.
 - [Migration v2→v3: BbSwitchGroup](./guides/migration/components/bb-switch-group.md) - Shares its migration with BbCheckboxGroup — see bb-checkbox-group.md.
 - [Migration v2→v3: BbTable](./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)](./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)](./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](./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](./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()](./guides/migration/components/bb-toast.md) - Host placement becomes position with a corner-based value set; toast() options rewritten (variant, duration, actions, portal).

package/dist/ai/manifest/components/BbBreadcrumbs.json

@@ -21,12 +21,12 @@
 		{"name":"append","type":"BbBreadcrumbsEdgeSlotProps","fields":["disabled?: boolean"],"description":"Content rendered after the breadcrumb list, in a dedicated append region."},
 		{"name":"divider","type":"Record<string, never>","description":"Replaces the default separator rendered between breadcrumb items."},
 		{"name":"ellipsis","type":"BbBreadcrumbsEllipsisSlotProps","fields":["props: { ref: (reference: unknown) => void; }","disabled?: boolean","overflowCount: number","ellipsisWidth: number"],"description":"Replaces the default `…` overflow button shown when items overflow."},
-		{"name":"item:append","type":"BbBreadcrumbsItemSlotProps","fields":["disabled: boolean","index: number","item: Item","text?: string"],"description":"Content rendered after **every** breadcrumb item's link/button. Generic\nfallback below a per-item `<key>:append` slot and above the item's\n`append:icon`."},
-		{"name":"item:prepend","type":"BbBreadcrumbsItemSlotProps","fields":["disabled: boolean","index: number","item: Item","text?: string"],"description":"Content rendered before **every** breadcrumb item's link/button, in the\nleading edge region. Generic fallback: a per-item `<key>:prepend` slot\ntakes precedence, and the item's `prepend:icon` is used when neither slot\nis present."},
+		{"name":"item:append","type":"BbBreadcrumbsItemSlotProps","fields":["disabled: boolean","index: number","item: Item","label?: string"],"description":"Content rendered after **every** breadcrumb item's link/button. Generic\nfallback below a per-item `<value>:append` slot and above the item's\n`append:icon`."},
+		{"name":"item:prepend","type":"BbBreadcrumbsItemSlotProps","fields":["disabled: boolean","index: number","item: Item","label?: string"],"description":"Content rendered before **every** breadcrumb item's link/button, in the\nleading edge region. Generic fallback: a per-item `<value>:prepend` slot\ntakes precedence, and the item's `prepend:icon` is used when neither slot\nis present."},
 		{"name":"prepend","type":"BbBreadcrumbsEdgeSlotProps","fields":["disabled?: boolean"],"description":"Content rendered before the breadcrumb list, in a dedicated prepend region."},
-		{"name":"<key>","type":"BbBreadcrumbsItemSlotProps","description":"One crumb's label, by its `key` through `slotKey`; falls back to `item.text`. A crumb folded into the overflow menu follows BbDropdown's slot rules instead.","dynamic":true},
-		{"name":"<key>:prepend","type":"BbBreadcrumbsItemSlotProps","description":"The glyph before one crumb's label; beats `item:prepend`, which beats its `prepend:icon`.","dynamic":true},
-		{"name":"<key>:append","type":"BbBreadcrumbsItemSlotProps","description":"The glyph after one crumb's label; beats `item:append`, which beats its `append:icon`.","dynamic":true}
+		{"name":"<value>","type":"BbBreadcrumbsItemSlotProps","description":"One crumb's label, by its `value` through `slotKey`; falls back to `item.label`. A crumb folded into the overflow menu follows BbDropdown's slot rules instead (the same `#<value>` names).","dynamic":true},
+		{"name":"<value>:prepend","type":"BbBreadcrumbsItemSlotProps","description":"The glyph before one crumb's label; beats `item:prepend`, which beats its `prepend:icon`.","dynamic":true},
+		{"name":"<value>:append","type":"BbBreadcrumbsItemSlotProps","description":"The glyph after one crumb's label; beats `item:append`, which beats its `append:icon`.","dynamic":true}
 	],
 	"exposed": [],
 	"models": [],
@@ -46,7 +46,11 @@
 	"attrTargets": [
 		"nav"
 	],
+	"removed": [
+		{"name":"items[].key","new":"items[].value","surface":"item","hint":"a crumb's identity, naming its `#<value>` slots; `check --fix` renames it","since":"3.0.0-beta.49","migration":"ai/guides/migration/components/bb-breadcrumbs.md","silent":true,"fix":{"kind":"rename"}},
+		{"name":"items[].text","new":"items[].label","surface":"item","hint":"a crumb's text; `check --fix` renames it","since":"3.0.0-beta.49","migration":"ai/guides/migration/components/bb-breadcrumbs.md","silent":true,"fix":{"kind":"rename"}}
+	],
 	"types": [
-		{"name":"BbBreadcrumbsItem","usedAs":["prop items"],"definition":"type BbBreadcrumbsItem = Omit<BbBaseButtonProps, 'block' | 'tag' | 'type'> & { onClick?: (event: MouseEvent) => void | Promise<void>; key?: string; 'prepend:icon'?: IconType; 'append:icon'?: IconType; };"}
+		{"name":"BbBreadcrumbsItem","usedAs":["prop items"],"definition":"type BbBreadcrumbsItem = Omit<BbBaseButtonProps, 'block' | 'tag' | 'type' | 'text'> & { onClick?: (event: MouseEvent) => void | Promise<void>; label?: string; value?: string; key?: never; text?: never; 'prepend:icon'?: IconType; 'append:icon'?: IconType; };"}
 	]
 }