@vuetify/v0 1.0.0-alpha.0 → 1.0.0-alpha.2

package/dist/{useClickOutside-CnCQkh7M.mjs → useClickOutside-CmCUD_Pf.mjs}

@@ -1,22 +1,24 @@
-import { a as SUPPORTS_OBSERVER, i as SUPPORTS_MUTATION_OBSERVER, n as SUPPORTS_INTERSECTION_OBSERVER, r as SUPPORTS_MATCH_MEDIA, t as IN_BROWSER } from "./globals-CAv9vqkP.mjs";
+import { a as SUPPORTS_OBSERVER, i as SUPPORTS_MUTATION_OBSERVER, n as SUPPORTS_INTERSECTION_OBSERVER, r as SUPPORTS_MATCH_MEDIA, t as IN_BROWSER } from "./globals-CKdzjeLe.mjs";
 import { clamp, instanceExists, isArray, isElement, isFunction, isNull, isNullOrUndefined, isNumber, isObject, isString, isUndefined, mergeDeep, range, resolveIds, resolveIndexes, useId as useId$1 } from "./utilities/index.mjs";
-import { i as useContext, n as createContext, t as createTrinity } from "./createTrinity-vvXk0ARD.mjs";
-import { a as createPlugin, i as useLogger, o as createPluginContext } from "./useLogger-BfaFH-Bi.mjs";
-import { a as createRegistry } from "./createTokens-qv02qq4_.mjs";
-import { i as createModel, t as createSelection } from "./createSelection-AmMX6sjc.mjs";
-import { t as createSingle } from "./createSingle-CffpxK__.mjs";
-import { t as toArray } from "./toArray-doLQVI56.mjs";
-import { n as createFilter } from "./adapter-CCIeOzqr.mjs";
-import { t as createGroup } from "./createGroup-C2WCfYPB.mjs";
-import { a as useLocale } from "./useLocale-BYmoHpo6.mjs";
-import "./createPagination-Tp4C4He8.mjs";
-import "./createDataTable-BbUL9Vva.mjs";
-import { a as useRules, o as isStandardSchema } from "./useRules-eqSXpP9V.mjs";
-import "./useFeatures-CMpkbU8Q.mjs";
-import "./usePermissions-y3Uum3nO.mjs";
-import { t as MemoryAdapter } from "./memory-XCMtkld1.mjs";
-import "./useTheme-CFH6I91x.mjs";
-import { computed, effectScope, isRef, nextTick, onMounted, onScopeDispose, reactive, readonly, ref, shallowReactive, shallowReadonly, shallowRef, toRef, toValue, unref, watch, watchEffect } from "vue";
+import { i as useContext, t as createTrinity } from "./createTrinity-BTCs1pYx.mjs";
+import { a as createPlugin, i as useLogger, o as createPluginContext } from "./useLogger-BBTcMN61.mjs";
+import { t as createRegistry } from "./createRegistry-Dl-bSSTr.mjs";
+import { i as createModel, t as createSelection } from "./createSelection-Csaa-C8p.mjs";
+import { t as createSingle } from "./createSingle-8xbHAIpY.mjs";
+import "./createTokens-lNg2M_P_.mjs";
+import { a as useLocale } from "./useLocale-DTJx3aKR.mjs";
+import { c as useTimer } from "./useNotifications-H4knpvNw.mjs";
+import { t as toArray } from "./toArray-as9BWxBK.mjs";
+import { n as createFilter } from "./adapter-gQ2SNKZq.mjs";
+import { t as createGroup } from "./createGroup-BU4olYtB.mjs";
+import "./createPagination-CHF7SmmK.mjs";
+import "./createDataTable-rXBqGglI.mjs";
+import { a as useRules, o as isStandardSchema } from "./useRules--7Qoo60I.mjs";
+import "./useFeatures-ZIvzzuEV.mjs";
+import "./usePermissions-B_G12Dwd.mjs";
+import { t as MemoryAdapter } from "./memory-oYBvtkgx.mjs";
+import "./useTheme-Co05TEeD.mjs";
+import { computed, effectScope, hasInjectionContext, isRef, nextTick, onMounted, onScopeDispose, reactive, readonly, ref, shallowReactive, shallowReadonly, shallowRef, toRef, toValue, unref, watch, watchEffect } from "vue";
 //#region src/composables/createBreadcrumbs/index.ts
 /**
 * @module createBreadcrumbs
@@ -33,6 +35,16 @@ import { computed, effectScope, isRef, nextTick, onMounted, onScopeDispose, reac
 * - Trinity pattern for dependency injection
 *
 * Inheritance chain: createRegistry → createSelection → createSingle → createBreadcrumbs
+*
+* @example
+* ```ts
+* import { createBreadcrumbs } from '@vuetify/v0'
+*
+* const crumbs = createBreadcrumbs()
+* crumbs.register({ text: 'Home' })
+* crumbs.register({ text: 'Docs' })
+* console.log(crumbs.depth.value) // 2
+* ```
 */
 /**
 * Creates a breadcrumbs navigation model.
@@ -63,6 +75,7 @@ function createBreadcrumbs(options = {}) {
 	const single = createSingle({
 		...options,
 		reactive: true,
+		events: true,
 		enroll: true
 	});
 	const depth = toRef(() => single.size);
@@ -129,12 +142,7 @@ function createBreadcrumbs(options = {}) {
 */
 function createBreadcrumbsContext(_options = {}) {
 	const { namespace = "v0:breadcrumbs", ...options } = _options;
-	const [useBreadcrumbsContext, _provideBreadcrumbsContext] = createContext(namespace);
-	const context = createBreadcrumbs(options);
-	function provideBreadcrumbsContext(_context = context, app) {
-		return _provideBreadcrumbsContext(_context, app);
-	}
-	return createTrinity(useBreadcrumbsContext, provideBreadcrumbsContext, context);
+	return createTrinity(namespace, createBreadcrumbs(options));
 }
 /**
 * Returns the current breadcrumbs instance from context.
@@ -163,134 +171,6 @@ function useBreadcrumbs(namespace = "v0:breadcrumbs") {
 	return useContext(namespace);
 }
 //#endregion
-//#region src/composables/useTimer/index.ts
-/**
-* @module useTimer
-*
-* @see https://0.vuetifyjs.com/composables/system/use-timer
-*
-* @remarks
-* A reactive timer composable with pause/resume support.
-*
-* Key features:
-* - Start/stop/pause/resume controls
-* - Reactive remaining time tracking
-* - One-shot (default) or repeating mode
-* - Automatic cleanup on scope disposal
-* - SSR-safe
-*/
-/**
-* Creates a reactive timer with pause/resume support.
-*
-* @param handler Callback invoked when the timer fires.
-* @param options Timer configuration.
-* @returns Timer controls and reactive state.
-*
-* @see https://0.vuetifyjs.com/composables/system/use-timer
-*
-* @example
-* ```ts
-* const timer = useTimer(() => console.log('fired'), { duration: 5000 })
-*
-* timer.start()
-* timer.pause()
-* timer.resume()
-* timer.stop()
-* ```
-*/
-function useTimer(handler, options = {}) {
-	const { duration = 1e3, repeat = false } = options;
-	const remaining = shallowRef(duration);
-	const isActive = shallowRef(false);
-	const isPaused = shallowRef(false);
-	let timeoutId;
-	let trackingId;
-	let startedAt = 0;
-	let budget = duration;
-	function clearTimer() {
-		if (!/* @__PURE__ */ isUndefined(timeoutId)) {
-			globalThis.clearTimeout(timeoutId);
-			timeoutId = void 0;
-		}
-	}
-	function startTracking() {
-		stopTracking();
-		if (!IN_BROWSER) return;
-		trackingId = globalThis.setInterval(() => {
-			if (!isActive.value || isPaused.value) return;
-			const elapsed = Date.now() - startedAt;
-			remaining.value = Math.max(0, budget - elapsed);
-		}, 100);
-	}
-	function stopTracking() {
-		if (!/* @__PURE__ */ isUndefined(trackingId)) {
-			globalThis.clearInterval(trackingId);
-			trackingId = void 0;
-		}
-	}
-	function fire() {
-		clearTimer();
-		stopTracking();
-		handler();
-		if (repeat) begin(duration);
-		else {
-			isActive.value = false;
-			remaining.value = 0;
-		}
-	}
-	function begin(ms) {
-		clearTimer();
-		stopTracking();
-		budget = ms;
-		startedAt = Date.now();
-		remaining.value = ms;
-		isActive.value = true;
-		isPaused.value = false;
-		timeoutId = globalThis.setTimeout(fire, ms);
-		startTracking();
-	}
-	function start() {
-		if (duration < 0) return;
-		begin(duration);
-	}
-	function stop() {
-		clearTimer();
-		stopTracking();
-		isActive.value = false;
-		isPaused.value = false;
-		remaining.value = duration;
-	}
-	function pause() {
-		if (!isActive.value || isPaused.value) return;
-		const elapsed = Date.now() - startedAt;
-		budget = Math.max(0, budget - elapsed);
-		remaining.value = budget;
-		clearTimer();
-		stopTracking();
-		isPaused.value = true;
-	}
-	function resume() {
-		if (!isPaused.value) return;
-		isPaused.value = false;
-		startedAt = Date.now();
-		timeoutId = globalThis.setTimeout(fire, budget);
-		startTracking();
-	}
-	onScopeDispose(() => {
-		clearTimer();
-		stopTracking();
-	}, true);
-	return {
-		start,
-		stop,
-		pause,
-		resume,
-		remaining,
-		isActive,
-		isPaused
-	};
-}
-//#endregion
 //#region src/composables/usePopover/index.ts
 /**
 * @module usePopover
@@ -311,6 +191,15 @@ function useTimer(handler, options = {}) {
 *
 * Perfect for building select, combobox, tooltip, and menu components
 * without wrapping the Popover compound component.
+*
+* @example
+* ```ts
+* import { usePopover } from '@vuetify/v0'
+*
+* const popover = usePopover()
+* popover.open()
+* popover.toggle()
+* ```
 */
 function usePopover(options = {}) {
 	const { id: _id, positionArea = "bottom", positionTry = "most-width bottom", showDelay = 0, hideDelay = 0 } = options;
@@ -392,6 +281,15 @@ function usePopover(options = {}) {
 * useRovingFocus and useVirtualFocus.
 *
 * Not exported from the package barrel — consumed only by sibling composables.
+*
+* @example
+* ```ts
+* import { createFocusTraversal } from '#v0/composables/createFocusTraversal'
+*
+* const items = () => [{ id: 'a' }, { id: 'b' }, { id: 'c' }]
+* const traversal = createFocusTraversal(items, id => console.log(id))
+* traversal.next()
+* ```
 */
 function mod(length, index) {
 	return (index % length + length) % length;
@@ -574,6 +472,15 @@ function createFocusTraversal(items, activate, options = {}) {
 *
 * Perfect for comboboxes, autocompletes, listboxes, and other widgets
 * where DOM focus must remain on the control element.
+*
+* @example
+* ```ts
+* import { useVirtualFocus } from '@vuetify/v0'
+*
+* const items = () => [{ id: 'a' }, { id: 'b' }, { id: 'c' }]
+* const cursor = useVirtualFocus(items)
+* cursor.next()
+* ```
 */
 function useVirtualFocus(items, options) {
 	const { control, target, orientation, circular, columns, onHighlight } = options;
@@ -616,6 +523,9 @@ function useVirtualFocus(items, options) {
 	}
 	const listener = target ?? control;
 	if (listener) useEventListener(listener, "keydown", traversal.onKeydown);
+	onScopeDispose(() => {
+		clear();
+	});
 	return {
 		highlightedId: traversal.activeId,
 		highlight,
@@ -709,6 +619,16 @@ var ServerAdapter = class {
 * - Strict mode: reverts query to selected value on close if no match
 * - Popover-based dropdown positioning
 * - Context DI via createComboboxContext / useCombobox
+*
+* @example
+* ```ts
+* import { createCombobox } from '@vuetify/v0'
+*
+* const combobox = createCombobox({ strict: true })
+* combobox.selection.register({ value: 'Apple' })
+* combobox.selection.register({ value: 'Banana' })
+* combobox.open()
+* ```
 */
 /**
 * Creates a combobox context that orchestrates selection, popover, virtual
@@ -743,7 +663,7 @@ function createCombobox(options = {}) {
 	const hasError = shallowRef(false);
 	const errors = computed(() => {
 		const messages = toValue(errorMessages);
-		return messages ? toArray(messages) : [];
+		return messages ? /* @__PURE__ */ toArray(messages) : [];
 	});
 	const isValid = toRef(() => {
 		if (toValue(error)) return false;
@@ -778,7 +698,7 @@ function createCombobox(options = {}) {
 	const isOpen = popover.isOpen;
 	const cursor = useVirtualFocus(() => selection.values().filter((ticket) => filtered.value.has(ticket.id) && !toValue(ticket.disabled)).map((ticket) => ({
 		id: ticket.id,
-		el: () => document.querySelector(`#${CSS.escape(`${id}-option-${ticket.id}`)}`),
+		el: () => IN_BROWSER ? document.querySelector(`#${CSS.escape(`${id}-option-${ticket.id}`)}`) : null,
 		disabled: ticket.disabled
 	})), {
 		control: inputEl,
@@ -879,12 +799,7 @@ function createCombobox(options = {}) {
 */
 function createComboboxContext(options = {}) {
 	const { namespace = "v0:combobox", ...rest } = options;
-	const [useCombobox, _provideCombobox] = createContext(namespace);
-	const context = createCombobox(rest);
-	function provideCombobox(_context = context, app) {
-		return _provideCombobox(_context, app);
-	}
-	return createTrinity(useCombobox, provideCombobox, context);
+	return createTrinity(namespace, createCombobox(rest));
 }
 /**
 * Injects the current combobox context from a parent provider.
@@ -924,6 +839,15 @@ function useCombobox(namespace = "v0:combobox") {
 *
 * Per-field validation logic lives in createValidation.
 * createForm is the mothership — it coordinates, not creates.
+*
+* @example
+* ```ts
+* import { createForm } from '@vuetify/v0'
+*
+* const form = createForm()
+* const isValid = await form.validate()
+* if (isValid) form.submit()
+* ```
 */
 /**
 * Creates a new form instance.
@@ -985,7 +909,7 @@ function createForm(options = {}) {
 		for (const ticket of registry.values()) ticket.value.reset();
 	}
 	async function submit(id) {
-		const ids = id ? toArray(id) : [...registry.keys()];
+		const ids = id ? /* @__PURE__ */ toArray(id) : [...registry.keys()];
 		return (await Promise.all(ids.map(async (key) => {
 			const ticket = registry.get(key);
 			if (!ticket) return true;
@@ -1023,12 +947,7 @@ function createForm(options = {}) {
 */
 function createFormContext(_options = {}) {
 	const { namespace = "v0:form", ...options } = _options;
-	const [useFormContext, _provideFormContext] = createContext(namespace);
-	const context = createForm(options);
-	function provideFormContext(_context = context, app) {
-		return _provideFormContext(_context, app);
-	}
-	return createTrinity(useFormContext, provideFormContext, context);
+	return createTrinity(namespace, createForm(options));
 }
 /**
 * Returns the current form instance.
@@ -1048,6 +967,7 @@ function createFormContext(_options = {}) {
 * ```
 */
 function useForm(namespace = "v0:form") {
+	if (!hasInjectionContext()) return void 0;
 	try {
 		return useContext(namespace);
 	} catch {
@@ -1073,8 +993,18 @@ function useForm(namespace = "v0:form") {
 * - Tri-state isValid (null/true/false)
 *
 * Uses useRules() to resolve alias strings via shared context.
+*
+* @example
+* ```ts
+* import { createValidation } from '@vuetify/v0'
+*
+* const validation = createValidation({
+*   rules: [v => !!v || 'Required'],
+* })
+* await validation.validate('hello')
+* ```
 */
-const UNSET = Symbol("unset");
+const UNSET = /* @__PURE__ */ Symbol("unset");
 /**
 * Creates a per-input validation instance.
 *
@@ -1118,7 +1048,7 @@ function createValidation(_options = {}) {
 	const isValidating = shallowRef(false);
 	let generation = 0;
 	function register(input) {
-		if (/* @__PURE__ */ isFunction(input) || /* @__PURE__ */ isString(input) || isStandardSchema(input)) {
+		if (/* @__PURE__ */ isFunction(input) || /* @__PURE__ */ isString(input) || /* @__PURE__ */ isStandardSchema(input)) {
 			const resolved = rulesContext.resolve([input]);
 			return group.register({ value: resolved[0] ?? (() => true) });
 		}
@@ -1146,6 +1076,13 @@ function createValidation(_options = {}) {
 				isValid.value = errorMessages.length === 0;
 			}
 			return errorMessages.length === 0;
+		} catch (error) {
+			if (gen !== generation) return isValid.value ?? false;
+			if (!silent) {
+				errors.value = [error instanceof Error ? error.message : "Validation error"];
+				isValid.value = false;
+			}
+			return false;
 		} finally {
 			if (gen === generation && !silent) isValidating.value = false;
 		}
@@ -1191,6 +1128,16 @@ function createValidation(_options = {}) {
 *
 * No event handling — composables never bind DOM events. Components call
 * validate() and write isFocused/isTouched when they choose.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { createInput } from '@vuetify/v0'
+*
+* const value = shallowRef('')
+* const input = createInput({ value, label: 'Name', rules: ['required'] })
+* await input.validate()
+* ```
 */
 function createInput(options) {
 	const { value, id = /* @__PURE__ */ useId$1(), label, name, form, required, disabled = false, readonly: _readonly = false, rules = [], error = false, errorMessages, dirty: dirtyFn, equals = (a, b) => a === b } = options;
@@ -1219,7 +1166,7 @@ function createInput(options) {
 	}, { flush: "sync" });
 	const errors = computed(() => {
 		const manual = toValue(errorMessages);
-		return [...manual ? toArray(manual) : [], ...validation.errors.value];
+		return [...manual ? /* @__PURE__ */ toArray(manual) : [], ...validation.errors.value];
 	});
 	const isValid = toRef(() => {
 		if (toValue(error)) return false;
@@ -1268,48 +1215,6 @@ function createInput(options) {
 	};
 }
 //#endregion
-//#region src/composables/createNested/strategies.ts
-/**
-* Multiple open strategy: allows multiple nodes to be open simultaneously.
-*
-* @remarks
-* Perfect for tree views, file explorers, and nested menus where users expect
-* to keep multiple sections expanded at once.
-*
-* @example
-* ```ts
-* const tree = createNested({ openStrategy: multipleOpenStrategy })
-* tree.open('node-1')
-* tree.open('node-2')
-* // Both nodes are now open
-* ```
-*/
-const multipleOpenStrategy = {
-	onOpen: void 0,
-	onClose: void 0
-};
-/**
-* Single open strategy: only one node can be open at a time (accordion behavior).
-*
-* @remarks
-* Perfect for accordions, single-select navigation, and contexts where only
-* one section should be visible at a time.
-*
-* @example
-* ```ts
-* const tree = createNested({ openStrategy: singleOpenStrategy })
-* tree.open('node-1') // node-1 opens
-* tree.open('node-2') // node-1 closes, node-2 opens
-* ```
-*/
-const singleOpenStrategy = {
-	onOpen: (id, context) => {
-		const toClose = [...context.openedIds].filter((openedId) => openedId !== id);
-		for (const openedId of toClose) context.openedIds.delete(openedId);
-	},
-	onClose: void 0
-};
-//#endregion
 //#region src/composables/createNested/index.ts
 /**
 * @module createNested
@@ -1323,17 +1228,20 @@ const singleOpenStrategy = {
 * - Tree traversal utilities (getPath, getDescendants, etc.)
 * - Cascade selection propagation through nested registers
 * - `rootIds` tracking for top-level item detection
-* - Pluggable open strategies
 *
 * Inheritance chain: createSelection → createGroup → createNested
+*
+* @example
+* ```ts
+* import { createNested } from '@vuetify/v0'
+*
+* const tree = createNested()
+* const root = tree.register({ value: 'root' })
+* tree.register({ value: 'child', parentId: root.id })
+* tree.open(root.id)
+* ```
 */
 /**
-* Resolves open mode to an OpenStrategy.
-*/
-function resolveOpenStrategy(open = "multiple") {
-	return open === "single" ? singleOpenStrategy : multipleOpenStrategy;
-}
-/**
 * Creates a new nested tree instance with hierarchical management.
 *
 * Extends `createGroup` to support parent-child relationships, tree traversal,
@@ -1372,10 +1280,9 @@ function resolveOpenStrategy(open = "multiple") {
 * ```
 */
 function createNested(_options = {}) {
-	const { open: openMode = "multiple", openAll = false, reveal: revealOnOpen = false, selection: selectionMode = "cascade", active: activeMode = "single", openStrategy, ...options } = _options;
+	const { open: openMode = "multiple", openAll = false, reveal: revealOnOpen = false, selection: selectionMode = "cascade", active: activeMode = "single", ...options } = _options;
 	const mandatoryOption = _options.mandatory ?? false;
 	const multipleOption = _options.multiple ?? true;
-	const resolvedOpenStrategy = openStrategy ?? resolveOpenStrategy(openMode);
 	const group = createGroup(options);
 	const logger = useLogger();
 	const children = shallowReactive(/* @__PURE__ */ new Map());
@@ -1402,12 +1309,14 @@ function createNested(_options = {}) {
 	}
 	function open(ids) {
 		if (toValue(group.disabled)) return;
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			const item = group.get(id);
 			if (!item || toValue(item.disabled)) continue;
 			openedIds.add(id);
-			resolvedOpenStrategy.onOpen?.(id, context);
+			if (openMode === "single") {
+				for (const openedId of openedIds) if (openedId !== id) openedIds.delete(openedId);
+			}
 			if (revealOnOpen) {
 				let parentId = parents.get(id);
 				while (!/* @__PURE__ */ isUndefined(parentId)) {
@@ -1419,17 +1328,16 @@ function createNested(_options = {}) {
 	}
 	function close(ids) {
 		if (toValue(group.disabled)) return;
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			const item = group.get(id);
 			if (!item || toValue(item.disabled)) continue;
 			openedIds.delete(id);
-			resolvedOpenStrategy.onClose?.(id, context);
 		}
 	}
 	function flip(ids) {
 		if (toValue(group.disabled)) return;
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			const item = group.get(id);
 			if (!item || toValue(item.disabled)) continue;
@@ -1442,7 +1350,7 @@ function createNested(_options = {}) {
 	* Useful for expanding a section with its immediate subcategories.
 	*/
 	function unfold(ids) {
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			open(id);
 			const childIds = children.get(id) ?? [];
@@ -1454,7 +1362,7 @@ function createNested(_options = {}) {
 	* Makes the node visible in a collapsed tree without opening the node itself.
 	*/
 	function reveal(ids) {
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			const ancestorIds = getAncestors(id);
 			if (ancestorIds.length > 0) open(ancestorIds);
@@ -1465,7 +1373,7 @@ function createNested(_options = {}) {
 	* Opens the entire subtree rooted at the given node.
 	*/
 	function expand(ids) {
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			if (!isLeaf(id)) open(id);
 			for (const descendantId of getDescendants(id)) if (!isLeaf(descendantId)) open(descendantId);
@@ -1491,7 +1399,7 @@ function createNested(_options = {}) {
 		return activeIds.has(id);
 	}
 	function activate(ids) {
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			if (activeMode === "single") {
 				for (const activeId of activeIds) if (activeId !== id) activeIds.delete(activeId);
@@ -1500,7 +1408,7 @@ function createNested(_options = {}) {
 		}
 	}
 	function deactivate(ids) {
-		for (const id of toArray(ids)) activeIds.delete(id);
+		for (const id of /* @__PURE__ */ toArray(ids)) activeIds.delete(id);
 	}
 	function deactivateAll() {
 		activeIds.clear();
@@ -1508,7 +1416,13 @@ function createNested(_options = {}) {
 	function getPath(id) {
 		const path = [];
 		let currentId = id;
+		const visited = /* @__PURE__ */ new Set();
 		while (!/* @__PURE__ */ isUndefined(currentId)) {
+			if (visited.has(currentId)) {
+				logger.warn(`Circular parent reference detected at "${currentId}".`);
+				break;
+			}
+			visited.add(currentId);
 			path.unshift(currentId);
 			currentId = parents.get(currentId);
 		}
@@ -1626,7 +1540,7 @@ function createNested(_options = {}) {
 	}
 	function select(ids) {
 		if (toValue(group.disabled)) return;
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			const item = group.get(id);
 			if (!item || toValue(item.disabled)) continue;
@@ -1653,7 +1567,7 @@ function createNested(_options = {}) {
 	}
 	function unselect(ids) {
 		if (toValue(group.disabled)) return;
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			if (!group.has(id)) continue;
 			const item = group.get(id);
 			if (!item || toValue(item.disabled)) continue;
@@ -1680,7 +1594,7 @@ function createNested(_options = {}) {
 	}
 	function toggle(ids) {
 		if (toValue(group.disabled)) return;
-		for (const id of toArray(ids)) {
+		for (const id of /* @__PURE__ */ toArray(ids)) {
 			const item = group.get(id);
 			if (!item || toValue(item.disabled)) continue;
 			if (selectionMode === "independent") group.toggle(id);
@@ -1867,7 +1781,7 @@ function createNested(_options = {}) {
 		rootIds.clear();
 		group.reset();
 	}
-	const context = {
+	return {
 		...group,
 		children,
 		parents,
@@ -1903,7 +1817,6 @@ function createNested(_options = {}) {
 		deactivateAll,
 		toFlat,
 		multiple: toValue(multipleOption),
-		openStrategy: resolvedOpenStrategy,
 		select,
 		unselect,
 		toggle,
@@ -1920,7 +1833,6 @@ function createNested(_options = {}) {
 			return group.size;
 		}
 	};
-	return context;
 }
 /**
 * Creates a new nested context with provide/inject pattern.
@@ -1942,12 +1854,7 @@ function createNested(_options = {}) {
 */
 function createNestedContext(_options = {}) {
 	const { namespace = "v0:nested", ...options } = _options;
-	const [useNestedContext, _provideNestedContext] = createContext(namespace);
-	const context = createNested(options);
-	function provideNestedContext(_context = context, app) {
-		return _provideNestedContext(_context, app);
-	}
-	return createTrinity(useNestedContext, provideNestedContext, context);
+	return createTrinity(namespace, createNested(options));
 }
 /**
 * Returns the current nested instance from context.
@@ -1973,6 +1880,15 @@ function useNested(namespace = "v0:nested") {
 *
 * Used by createSlider, createNumberField, and other numeric composables.
 * Handles floating-point precision correction internally.
+*
+* @example
+* ```ts
+* import { createNumeric } from '@vuetify/v0'
+*
+* const numeric = createNumeric({ min: 0, max: 10, step: 1 })
+* console.log(numeric.snap(3.7)) // 4
+* console.log(numeric.toPercent(5)) // 0.5
+* ```
 */
 function decimalPlaces(n) {
 	const s = String(n);
@@ -1984,6 +1900,7 @@ function createNumeric(options = {}) {
 	const extent = max - min;
 	const decimals = Math.max(decimalPlaces(step), Number.isFinite(min) ? decimalPlaces(min) : 0);
 	function snap(value) {
+		if (!Number.isFinite(value)) return min;
 		if (step <= 0 || !Number.isFinite(min)) return /* @__PURE__ */ clamp(value, min, max);
 		const result = min + Math.round((/* @__PURE__ */ clamp(value, min, max) - min) / step) * step;
 		return /* @__PURE__ */ clamp(decimals > 0 ? +result.toFixed(decimals) : result, min, max);
@@ -2046,6 +1963,15 @@ function createNumeric(options = {}) {
 * @remarks
 * Orchestrator composable that composes createInput + createNumeric + Intl.NumberFormat.
 * Manages a numeric value with formatting, parsing, stepping, and field state.
+*
+* @example
+* ```ts
+* import { createNumberField } from '@vuetify/v0'
+*
+* const field = createNumberField({ min: 0, max: 100, step: 5 })
+* field.increment()
+* console.log(field.value.value) // 5
+* ```
 */
 function createNumberField(options = {}) {
 	const { value = ref(null), locale = "en-US", format: formatOptions, clamp: shouldClamp = true, disabled = false, readonly: _readonly = false, min, max, step, leap, wrap, id, label, name, rules, error, errorMessages } = options;
@@ -2170,6 +2096,16 @@ function createNumberField(options = {}) {
 * - Perfect for hydration-safe rendering
 *
 * Essential for composables that need to behave differently during SSR vs client-side.
+*
+* @example
+* ```ts
+* import { useHydration } from '@vuetify/v0'
+*
+* const { isHydrated } = useHydration()
+* if (isHydrated.value) {
+*   // safe for client-only logic
+* }
+* ```
 */
 /**
 * Creates a new hydration instance.
@@ -2258,6 +2194,15 @@ const [createHydrationContext, createHydrationPlugin, useHydration] = createPlug
 * Accepts refs, getters, raw DOM elements, or Vue component instances
 * and normalizes them to a plain Element. Uses structural typing to
 * avoid cross-version Vue Ref incompatibilities.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { toElement } from '@vuetify/v0'
+*
+* const el = shallowRef<HTMLElement | null>(null)
+* const resolved = toElement(el) // HTMLElement | undefined
+* ```
 */
 /**
 * Resolves a {@link MaybeElementRef} to a DOM Element or undefined.
@@ -2305,6 +2250,19 @@ function toElement(target) {
 * - `undefined` — not yet created
 * - `null` — permanently stopped (`stop()` was called; `setup()` is a no-op)
 * - instance — active observer
+*
+* @example
+* ```ts
+* import { createObserver } from '#v0/composables/createObserver'
+*
+* const observer = createObserver(target, entries => {
+*   console.log(entries)
+* }, {
+*   supports: true,
+*   create: cb => new ResizeObserver(cb),
+*   observe: (o, el) => o.observe(el),
+* })
+* ```
 */
 function createObserver(target, userCallback, config) {
 	const { isHydrated } = useHydration();
@@ -2397,6 +2355,17 @@ function createObserver(target, userCallback, config) {
 * - Box model options (content-box/border-box)
 *
 * Perfect for responsive components and size-based rendering.
+*
+* @example
+* ```ts
+* import { useTemplateRef } from 'vue'
+* import { useResizeObserver } from '@vuetify/v0'
+*
+* const target = useTemplateRef('target')
+* useResizeObserver(target, entries => {
+*   console.log(entries[0].contentRect.width)
+* })
+* ```
 */
 /**
 * A composable that uses the Resize Observer API to detect when an element's
@@ -2508,8 +2477,8 @@ function useElementSize(target) {
 		_pause();
 	}
 	return {
-		width,
-		height,
+		width: shallowReadonly(width),
+		height: shallowReadonly(height),
 		isActive,
 		isPaused: shallowReadonly(isPaused),
 		pause,
@@ -2537,6 +2506,16 @@ function useElementSize(target) {
 *
 * Use variable mode (default) for items with different widths like Breadcrumbs.
 * Use uniform mode (itemWidth option) for same-width items like Pagination buttons.
+*
+* @example
+* ```ts
+* import { useTemplateRef } from 'vue'
+* import { createOverflow } from '@vuetify/v0'
+*
+* const el = useTemplateRef('container')
+* const overflow = createOverflow({ container: el })
+* console.log(overflow.capacity.value) // number of items that fit
+* ```
 */
 /**
 * Creates a new overflow context for computing how many items fit in a container.
@@ -2625,7 +2604,7 @@ function createOverflow(options = {}) {
 			if (available <= 0) return 0;
 			const g = toValue(gap);
 			const uniformWidth = toValue(itemWidth) ?? 0;
-			if (itemWidth !== void 0 && uniformWidth <= 0) return Infinity;
+			if (!/* @__PURE__ */ isUndefined(itemWidth) && uniformWidth <= 0) return Infinity;
 			if (uniformWidth > 0) {
 				const subsequent = uniformWidth + g;
 				if (available < uniformWidth) return 0;
@@ -2676,12 +2655,7 @@ function createOverflow(options = {}) {
 */
 function createOverflowContext(_options = {}) {
 	const { namespace = "v0:overflow", ...options } = _options;
-	const [useOverflowContext, _provideOverflowContext] = createContext(namespace);
-	const context = createOverflow(options);
-	function provideOverflowContext(_context = context, app) {
-		return _provideOverflowContext(_context, app);
-	}
-	return createTrinity(useOverflowContext, provideOverflowContext, context);
+	return createTrinity(namespace, createOverflow(options));
 }
 /**
 * Returns the current overflow context from dependency injection.
@@ -2725,6 +2699,15 @@ function useOverflow(namespace = "v0:overflow") {
 * All segments stay selected (multiple: true, enroll: true) so
 * selectedValues always reflects the full set of segment values.
 * Compatible with useProxyModel for v-model bridging.
+*
+* @example
+* ```ts
+* import { createProgress } from '@vuetify/v0'
+*
+* const progress = createProgress({ min: 0, max: 100, value: 25 })
+* progress.register({ value: 50 })
+* console.log(progress.percent.value)
+* ```
 */
 /**
 * Creates a progress instance with model-based segment tracking.
@@ -2818,12 +2801,7 @@ function createProgress(options = {}) {
 */
 function createProgressContext(_options = {}) {
 	const { namespace = "v0:progress", ...options } = _options;
-	const [use, _provide] = createContext(namespace);
-	const context = createProgress(options);
-	function provide(_context = context, app) {
-		return _provide(_context, app);
-	}
-	return createTrinity(use, provide, context);
+	return createTrinity(namespace, createProgress(options));
 }
 /**
 * Returns the current progress instance from context.
@@ -2835,201 +2813,6 @@ function useProgress(namespace = "v0:progress") {
 	return useContext(namespace);
 }
 //#endregion
-//#region src/composables/createQueue/index.ts
-/**
-* @module createQueue
-*
-* @see https://0.vuetifyjs.com/composables/registration/create-queue
-*
-* @remarks
-* A queue composable for managing time-based collections with:
-* - Automatic timeout-based removal
-* - Pause/resume functionality
-* - FIFO (First In, First Out) ordering
-* - Manual dismissal support
-* - Queue progression management
-*
-* Built on top of createRegistry, the queue automatically manages timeouts for tickets,
-* ensuring only the first ticket in the queue is active at any time. When a ticket
-* expires or is removed, the next ticket in the queue automatically becomes active.
-*/
-/**
-* Creates a new queue instance
-*
-* @param options The options for the queue instance
-* @returns A new queue instance
-*
-* @see https://0.vuetifyjs.com/composables/registration/create-queue
-*
-* @example
-* ```ts
-* import { useQueue } from '@vuetify/v0'
-*
-* const queue = useQueue()
-*
-* // Register an ticket with default timeout (3000ms)
-* const ticket1 = queue.register({ value: 'Ticket 1' })
-*
-* // Register an ticket with custom timeout
-* const ticket2 = queue.register({ value: 'Ticket 2', timeout: 5000 })
-*
-* // Register a persistent ticket that must be manually dismissed
-* const ticket3 = queue.register({ value: 'Ticket 3', timeout: -1 })
-*
-* // Dismiss an ticket using the convenience method
-* ticket3.dismiss()
-*
-* console.log(queue.size) // 2
-* ```
-*/
-function createQueue(_options = {}) {
-	const { timeout: _timeout = 3e3, ...options } = _options;
-	const registry = createRegistry({
-		...options,
-		events: true
-	});
-	const timers = /* @__PURE__ */ new Map();
-	function createTicketTimer(ticket) {
-		if (/* @__PURE__ */ isUndefined(ticket.timeout) || ticket.timeout < 0 || ticket.isPaused) return;
-		const timer = useTimer(() => {
-			timers.delete(ticket.id);
-			registry.unregister(ticket.id);
-			resume();
-		}, { duration: ticket.timeout });
-		timers.set(ticket.id, timer);
-		timer.start();
-	}
-	function stopTimer(id) {
-		const timer = timers.get(id);
-		if (timer) {
-			timer.stop();
-			timers.delete(id);
-		}
-	}
-	function register(registration = {}) {
-		const id = registration.id ?? /* @__PURE__ */ useId$1();
-		const timeout = Object.prototype.hasOwnProperty.call(registration, "timeout") ? registration.timeout : _timeout;
-		const ticket = {
-			...registration,
-			id,
-			timeout,
-			isPaused: registry.size > 0,
-			dismiss: () => unregister(id)
-		};
-		const registered = registry.register(ticket);
-		createTicketTimer(registered);
-		return registered;
-	}
-	function unregister(id) {
-		const ticket = /* @__PURE__ */ isUndefined(id) ? registry.seek("first") : registry.get(id);
-		if (!ticket) return void 0;
-		const wasFirst = ticket.index === 0;
-		stopTimer(ticket.id);
-		registry.unregister(ticket.id);
-		if (wasFirst) resume();
-		return ticket;
-	}
-	function offboard(ids) {
-		let hadFirst = false;
-		for (const id of ids) {
-			const ticket = registry.get(id);
-			if (!ticket) continue;
-			if (ticket.index === 0) hadFirst = true;
-			stopTimer(ticket.id);
-		}
-		registry.offboard(ids);
-		if (hadFirst) resume();
-	}
-	function pause() {
-		const ticket = registry.seek("first");
-		if (!ticket || ticket.isPaused) return void 0;
-		timers.get(ticket.id)?.pause();
-		return registry.upsert(ticket.id, { isPaused: true });
-	}
-	function resume() {
-		const ticket = registry.seek("first");
-		if (!ticket || ticket.index !== 0 || !ticket.isPaused) return void 0;
-		const updated = registry.upsert(ticket.id, { isPaused: false });
-		const timer = timers.get(updated.id);
-		if (timer) timer.start();
-		else createTicketTimer(updated);
-		return updated;
-	}
-	function clear() {
-		for (const timer of timers.values()) timer.stop();
-		timers.clear();
-		registry.clear();
-	}
-	function dispose() {
-		clear();
-		registry.dispose();
-	}
-	onScopeDispose(dispose, true);
-	function onboard(registrations) {
-		return registry.batch(() => registrations.map((registration) => register(registration)));
-	}
-	return {
-		...registry,
-		register,
-		unregister,
-		onboard,
-		offboard,
-		pause,
-		resume,
-		clear,
-		dispose,
-		get size() {
-			return registry.size;
-		}
-	};
-}
-/**
-* Creates a new queue context.
-*
-* @param options The options for the queue context.
-* @returns A new queue context.
-*
-* @see https://0.vuetifyjs.com/composables/registration/create-queue
-*
-* @example
-* ```ts
-* import { createQueueContext } from '@vuetify/v0'
-*
-* export const [useQueue, provideQueue, context] = createQueueContext({
-*   timeout: 5000,
-* })
-* ```
-*/
-function createQueueContext(_options = {}) {
-	const { namespace = "v0:queue", ...options } = _options;
-	const [useQueueContext, _provideQueueContext] = createContext(namespace);
-	const context = createQueue(options);
-	function provideQueueContext(_context = context, app) {
-		return _provideQueueContext(_context, app);
-	}
-	return createTrinity(useQueueContext, provideQueueContext, context);
-}
-/**
-* Returns the current queue instance.
-*
-* @param namespace The namespace for the queue context. Defaults to `'v0:queue'`.
-* @returns The current queue instance.
-*
-* @see https://0.vuetifyjs.com/composables/registration/create-queue
-*
-* @example
-* ```vue
-* <script setup lang="ts">
-*   import { useQueue } from '@vuetify/v0'
-*
-*   const queue = useQueue()
-* <\/script>
-* ```
-*/
-function useQueue(namespace = "v0:queue") {
-	return useContext(namespace);
-}
-//#endregion
 //#region src/composables/createRating/index.ts
 /**
 * @module createRating
@@ -3050,6 +2833,15 @@ function useQueue(namespace = "v0:queue") {
 * Unlike registry-based composables, rating tracks a single number
 * within a range with computed item states, making it efficient
 * for any star/icon rating use case.
+*
+* @example
+* ```ts
+* import { createRating } from '@vuetify/v0'
+*
+* const rating = createRating({ size: 5, value: 3 })
+* rating.select(4)
+* console.log(rating.value.value) // 4
+* ```
 */
 /**
 * Creates a rating instance.
@@ -3147,12 +2939,7 @@ function createRating(_options = {}) {
 */
 function createRatingContext(_options = {}) {
 	const { namespace = "v0:rating", ...options } = _options;
-	const [useRatingContext, _provideRatingContext] = createContext(namespace);
-	const context = createRating(options);
-	function provideRatingContext(_context = context, app) {
-		return _provideRatingContext(_context, app);
-	}
-	return createTrinity(useRatingContext, provideRatingContext, context);
+	return createTrinity(namespace, createRating(options));
 }
 /**
 * Returns the current rating instance from context.
@@ -3198,6 +2985,16 @@ function useRating(namespace = "v0:rating") {
 * Designed for single-thumb, range, and multi-thumb sliders.
 * Also reusable for color picker tracks, media scrubbers,
 * gradient editors, and other 1D value-on-track controls.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { createSlider } from '@vuetify/v0'
+*
+* const slider = createSlider({ min: 0, max: 100, step: 5 })
+* slider.register({ value: shallowRef(25) })
+* slider.set(0, 60)
+* ```
 */
 /**
 * Creates slider state with value math, step snapping, and multi-thumb support.
@@ -3385,6 +3182,16 @@ function createSlider(options = {}) {
 * - Perfect for wizards, carousels, pagination, onboarding flows
 *
 * Inheritance chain: createRegistry → createSelection → createSingle → createStep
+*
+* @example
+* ```ts
+* import { createStep } from '@vuetify/v0'
+*
+* const wizard = createStep({ circular: false })
+* wizard.register({ value: 'step-1' })
+* wizard.register({ value: 'step-2' })
+* wizard.next()
+* ```
 */
 /**
 * Creates a new step instance with navigation through items.
@@ -3533,12 +3340,7 @@ function createStep(_options = {}) {
 */
 function createStepContext(_options = {}) {
 	const { namespace = "v0:step", ...options } = _options;
-	const [useStepContext, _provideStepContext] = createContext(namespace);
-	const context = createStep(options);
-	function provideStepContext(_context = context, app) {
-		return _provideStepContext(_context, app);
-	}
-	return createTrinity(useStepContext, provideStepContext, context);
+	return createTrinity(namespace, createStep(options));
 }
 /**
 * Returns the current step instance.
@@ -3587,7 +3389,17 @@ function useStep(namespace = "v0:step") {
 * - Automatic reindexing after operations
 * - Perfect for command pattern, history tracking
 *
-* Extends createRegistry with temporal navigation capabilities.
+* Extends createRegistry with temporal navigation capabilities.
+*
+* @example
+* ```ts
+* import { createTimeline } from '@vuetify/v0'
+*
+* const timeline = createTimeline({ size: 5 })
+* timeline.register({ value: 'action-1' })
+* timeline.register({ value: 'action-2' })
+* timeline.undo()
+* ```
 */
 /**
 * Creates a new timeline instance.
@@ -3699,12 +3511,7 @@ function createTimeline(_options = {}) {
 */
 function createTimelineContext(_options = {}) {
 	const { namespace = "v0:timeline", ...options } = _options;
-	const [useTimelineContext, _provideTimelineContext] = createContext(namespace);
-	const context = createTimeline(options);
-	function provideTimelineContext(_context = context, app) {
-		return _provideTimelineContext(_context, app);
-	}
-	return createTrinity(useTimelineContext, provideTimelineContext, context);
+	return createTrinity(namespace, createTimeline(options));
 }
 /**
 * Returns the current timeline instance.
@@ -3748,6 +3555,16 @@ function useTimeline(namespace = "v0:timeline") {
 * - Configurable overscan (extra items rendered for smooth scrolling)
 *
 * Perfect for large data sets, chat apps, and infinite scroll implementations.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { createVirtual } from '@vuetify/v0'
+*
+* const items = shallowRef(Array.from({ length: 10000 }, (_, i) => ({ id: i })))
+* const virtual = createVirtual(items, { itemHeight: 40 })
+* console.log(virtual.items.value)
+* ```
 */
 /**
 * Virtual scrolling composable for efficiently rendering large lists
@@ -4040,12 +3857,7 @@ function createVirtual(items, _options = {}) {
 */
 function createVirtualContext(items, _options = {}) {
 	const { namespace = "v0:virtual", ...options } = _options;
-	const [useVirtualContext, _provideVirtualContext] = createContext(namespace);
-	const context = createVirtual(items, options);
-	function provideVirtualContext(_context = context, app) {
-		return _provideVirtualContext(_context, app);
-	}
-	return createTrinity(useVirtualContext, provideVirtualContext, context);
+	return createTrinity(namespace, createVirtual(items, options));
 }
 /**
 * Returns the current virtual context from dependency injection.
@@ -4095,6 +3907,16 @@ function useVirtual(namespace = "v0:virtual") {
 * - Type preservation
 *
 * Perfect for creating reactive versions of plain objects while automatically unwrapping refs.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { toReactive } from '@vuetify/v0'
+*
+* const source = { name: shallowRef('Alice'), age: 30 }
+* const reactive = toReactive(source)
+* console.log(reactive.name) // 'Alice' (auto-unwrapped)
+* ```
 */
 function createMapProxy(refObject) {
 	let mapProxy;
@@ -4252,6 +4074,14 @@ function toReactive(objectRef) {
 * - Custom breakpoint configuration
 *
 * Perfect for responsive layouts and conditional rendering based on screen size.
+*
+* @example
+* ```ts
+* import { useBreakpoints } from '@vuetify/v0'
+*
+* const { current, isMobile, smAndUp } = useBreakpoints()
+* console.log(current.value) // 'md'
+* ```
 */
 /**
 * Creates default breakpoint configuration.
@@ -4534,7 +4364,7 @@ function createDate(options) {
 	const { locales = defaultLocales, adapter, locale: initialLocale, firstDayOfWeek: explicitFirstDay } = options;
 	let selectedId;
 	try {
-		if (instanceExists()) selectedId = useLocale().selectedId;
+		if (/* @__PURE__ */ instanceExists()) selectedId = useLocale().selectedId;
 	} catch {}
 	const locale = computed(() => {
 		const selected = selectedId?.value;
@@ -4550,7 +4380,7 @@ function createDate(options) {
 		const loc = locale.value;
 		return loc ? deriveFirstDayOfWeek(loc) : 0;
 	});
-	if (instanceExists()) onScopeDispose(watchEffect(() => {
+	if (/* @__PURE__ */ instanceExists()) onScopeDispose(watchEffect(() => {
 		const loc = locale.value;
 		if (loc && adapter.locale !== loc) adapter.locale = loc;
 		const fdow = firstDayOfWeek.value;
@@ -4590,12 +4420,7 @@ function createDate(options) {
 */
 function createDateContext(options) {
 	const { namespace = "v0:date", ...dateOptions } = options;
-	const [useDateContext, _provideDateContext] = createContext(namespace);
-	const context = createDate(dateOptions);
-	function provideDateContext(_context = context, app) {
-		return _provideDateContext(_context, app);
-	}
-	return createTrinity(useDateContext, provideDateContext, context);
+	return createTrinity(namespace, createDate(dateOptions));
 }
 /**
 * Creates a new date plugin.
@@ -4667,7 +4492,7 @@ function createDatePlugin(options) {
 * ```
 */
 function useDate(namespace = "v0:date") {
-	if (!instanceExists()) throw new Error("[v0] useDate() must be called inside a Vue component with createDatePlugin installed.\n\nExample:\n  import { Vuetify0DateAdapter } from '@vuetify/v0/date'\n  import { createDatePlugin } from '@vuetify/v0'\n\n  app.use(createDatePlugin({ adapter: new Vuetify0DateAdapter() }))");
+	if (!/* @__PURE__ */ instanceExists()) throw new Error("[v0] useDate() must be called inside a Vue component with createDatePlugin installed.\n\nExample:\n  import { Vuetify0DateAdapter } from '@vuetify/v0/date'\n  import { createDatePlugin } from '@vuetify/v0'\n\n  app.use(createDatePlugin({ adapter: new Vuetify0DateAdapter() }))");
 	return useContext(namespace);
 }
 //#endregion
@@ -4697,13 +4522,14 @@ const keyAliasMap = {
 	minus: "-",
 	hyphen: "-"
 };
+/* @__NO_SIDE_EFFECTS__ */
 function normalizeKey(key) {
 	const lowerKey = key.toLowerCase();
 	return keyAliasMap[lowerKey] ?? lowerKey;
 }
 //#endregion
 //#region src/composables/useHotkey/parsing.ts
-const logger = useLogger();
+const logger = /* @__PURE__ */ useLogger();
 const MODIFIERS = [
 	"ctrl",
 	"shift",
@@ -4748,7 +4574,7 @@ function splitKeyCombination(combination, isInternal = false) {
 	function flushBuffer(separator) {
 		if (buffer) {
 			if (separator) separators.push(separator);
-			keys.push(normalizeKey(buffer));
+			keys.push(/* @__PURE__ */ normalizeKey(buffer));
 			buffer = "";
 		}
 	}
@@ -4781,7 +4607,7 @@ function splitKeyCombination(combination, isInternal = false) {
 		return emptyResult;
 	}
 	if (keys.length === 0 && combination) return {
-		keys: [normalizeKey(combination)],
+		keys: [/* @__PURE__ */ normalizeKey(combination)],
 		separators
 	};
 	/* v8 ignore stop */
@@ -4879,6 +4705,14 @@ function splitKeySequence(str) {
 * - SSR-safe (no-op when not in browser)
 *
 * Builds on useEventListener for lifecycle-managed keyboard events.
+*
+* @example
+* ```ts
+* import { useHotkey } from '@vuetify/v0'
+*
+* useHotkey('ctrl+k', () => console.log('opened palette'))
+* useHotkey('g-h', () => console.log('go home'))
+* ```
 */
 const isMac = IN_BROWSER && /mac|iphone|ipad|ipod/i.test(navigator?.userAgent ?? "");
 /**
@@ -4922,6 +4756,7 @@ function useHotkey(keys, callback, options = {}, _platform) {
 	let isSequence = false;
 	let groupIndex = 0;
 	function isInputFocused() {
+		if (!IN_BROWSER) return false;
 		if (toValue(inputs)) return false;
 		const activeElement = document.activeElement;
 		if (!activeElement) return false;
@@ -5050,6 +4885,115 @@ function matchesKeyGroup(e, group, platformIsMac) {
 	return modifiersMatch && e.key.toLowerCase() === actualKey.toLowerCase();
 }
 //#endregion
+//#region src/composables/useImage/index.ts
+/**
+* @module useImage
+*
+* @see https://0.vuetifyjs.com/composables/system/use-image
+*
+* @remarks
+* Image loading state machine with deferred loading support.
+*
+* Key features:
+* - State machine: idle → loading → loaded | error
+* - Reactive `eager` gate withholds the source until ready
+* - Automatic reset when `src` changes
+* - Manual `retry()` to re-attempt after error
+* - Bind-ready handlers and gated source
+* - SSR-safe
+*
+* Perfect for image components, lightboxes, lazy-loaded galleries,
+* and any UI that needs to react to image load state.
+*
+* @example
+* ```ts
+* import { useImage } from '@vuetify/v0'
+*
+* const { status, source, onLoad, onError } = useImage({
+*   src: 'https://example.com/img.png',
+* })
+* ```
+*/
+/**
+* Tracks image loading state as a reactive state machine.
+*
+* @param options Configuration options
+* @returns Image context with state refs and event handlers
+*
+* @see https://0.vuetifyjs.com/composables/system/use-image
+*
+* @example
+* ```ts
+* import { toRef } from 'vue'
+* import { useImage } from '@vuetify/v0'
+*
+* const props = defineProps<{ src: string }>()
+*
+* const { source, isLoaded, onLoad, onError, retry } = useImage({
+*   src: toRef(() => props.src),
+* })
+* ```
+*
+* @example
+* Composed with `useIntersectionObserver` for lazy loading:
+* ```ts
+* const target = shallowRef<HTMLElement>()
+* const { isIntersecting } = useIntersectionObserver(target, () => {}, {
+*   once: true,
+*   rootMargin: '200px',
+* })
+*
+* const { source, onLoad, onError } = useImage({
+*   src: toRef(() => props.src),
+*   eager: isIntersecting,
+* })
+* ```
+*/
+function useImage(options) {
+	const { src, eager = true } = options;
+	const status = shallowRef(toValue(eager) ? "loading" : "idle");
+	const isIdle = toRef(() => status.value === "idle");
+	const isLoading = toRef(() => status.value === "loading");
+	const isLoaded = toRef(() => status.value === "loaded");
+	const isError = toRef(() => status.value === "error");
+	const source = toRef(() => status.value === "idle" ? void 0 : toValue(src));
+	function onLoad() {
+		status.value = "loaded";
+	}
+	function onError() {
+		status.value = "error";
+	}
+	function retry() {
+		const resumeAs = toValue(eager) ? "loading" : "idle";
+		status.value = "idle";
+		nextTick(() => {
+			status.value = resumeAs;
+		});
+	}
+	const stopEager = watch(() => toValue(eager), (value) => {
+		if (value && status.value === "idle") status.value = "loading";
+		else if (!value && status.value !== "loaded" && status.value !== "error") status.value = "idle";
+	});
+	const stopSrc = watch(() => toValue(src), () => {
+		status.value = toValue(eager) ? "loading" : "idle";
+	});
+	onScopeDispose(() => {
+		stopEager();
+		stopSrc();
+	}, true);
+	return {
+		status: shallowReadonly(status),
+		isIdle,
+		isLoading,
+		isLoaded,
+		isError,
+		source,
+		onLoad,
+		onError,
+		retry
+	};
+}
+//#endregion
 //#region src/composables/useIntersectionObserver/index.ts
 /**
 * @module useIntersectionObserver
@@ -5070,6 +5014,17 @@ function matchesKeyGroup(e, group, platformIsMac) {
 * - Immediate callback option
 *
 * Perfect for lazy loading, infinite scroll, and visibility detection.
+*
+* @example
+* ```ts
+* import { useTemplateRef } from 'vue'
+* import { useIntersectionObserver } from '@vuetify/v0'
+*
+* const target = useTemplateRef('target')
+* useIntersectionObserver(target, entries => {
+*   console.log(entries[0].isIntersecting)
+* })
+* ```
 */
 /**
 * A composable that uses the Intersection Observer API to detect when an element
@@ -5230,6 +5185,15 @@ function useElementIntersection(target, options = {}) {
 *
 * Perfect for dialogs, menus, tooltips, and any component with
 * conditionally rendered content.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { useLazy } from '@vuetify/v0'
+*
+* const isOpen = shallowRef(false)
+* const { hasContent, onAfterLeave } = useLazy(isOpen)
+* ```
 */
 /**
 * Deferred content rendering for performance optimization.
@@ -5320,6 +5284,14 @@ function useLazy(active, options = {}) {
 * - Supports both static and dynamic queries
 *
 * Perfect for responsive conditionals beyond breakpoint detection.
+*
+* @example
+* ```ts
+* import { useMediaQuery } from '@vuetify/v0'
+*
+* const { matches } = useMediaQuery('(prefers-color-scheme: dark)')
+* console.log(matches.value) // true/false
+* ```
 */
 /**
 * Reactive media query matching.
@@ -5440,6 +5412,17 @@ function usePrefersContrast() {
 * - Configurable observation options (childList, attributes, characterData, etc.)
 *
 * Perfect for detecting DOM changes and responding to mutations.
+*
+* @example
+* ```ts
+* import { useTemplateRef } from 'vue'
+* import { useMutationObserver } from '@vuetify/v0'
+*
+* const target = useTemplateRef('target')
+* useMutationObserver(target, records => {
+*   console.log(records)
+* }, { childList: true })
+* ```
 */
 /**
 * A composable that uses the Mutation Observer API to detect changes in the DOM.
@@ -5534,525 +5517,6 @@ function useMutationObserver(target, callback, options = {}) {
 	});
 }
 //#endregion
-//#region src/composables/useNotifications/index.ts
-/**
-* @module useNotifications
-* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-*
-* @remarks
-* Notification management composable built on createRegistry and createQueue.
-* Registry stores the full notification lifecycle (permanent record).
-* Queue manages the display surface (toasts) with FIFO ordering and auto-dismiss.
-*
-* Supports:
-* - Push notifications with severity levels and configurable timeouts
-* - State mutations: read, seen, archived, snoozed
-* - Bulk operations: readAll, archiveAll, clear
-* - Toast queue with pause/resume and auto-dismiss
-* - Adapter integration via event system
-* - Plugin installation via createNotificationsPlugin
-*/
-function createNotifications(options = {}) {
-	const { timeout = 3e3, ...registryOptions } = options;
-	const registry = createRegistry({
-		...registryOptions,
-		events: true,
-		reactive: true
-	});
-	const queue = createQueue({
-		timeout,
-		events: true,
-		reactive: true
-	});
-	registry.on("unregister:ticket", (ticket) => {
-		if (queue.has(ticket.id)) queue.unregister(ticket.id);
-	});
-	/**
-	* Build a full {@link NotificationTicket} from raw input
-	*
-	* @param input The notification input to hydrate.
-	* @returns A partial ticket with timestamps, lifecycle methods, and an ID.
-	* @internal Used by {@link send}, {@link register}, and {@link onboard}.
-	*/
-	function hydrate(input) {
-		const id = input.id ?? /* @__PURE__ */ useId$1();
-		const now = /* @__PURE__ */ new Date();
-		return {
-			...input,
-			id,
-			createdAt: now,
-			readAt: null,
-			seenAt: null,
-			archivedAt: null,
-			snoozedUntil: null,
-			read: () => read(id),
-			unread: () => unread(id),
-			seen: () => seen(id),
-			archive: () => archive(id),
-			unarchive: () => unarchive(id),
-			snooze: (until) => snooze(id, until),
-			wake: () => wake(id),
-			dismiss: () => queue.unregister(id)
-		};
-	}
-	/**
-	* Create a notification and enqueue it for toast display
-	*
-	* @param input The notification input to create.
-	* @returns The hydrated notification ticket.
-	* @remarks Hydrates the input with timestamps and lifecycle methods, registers
-	* it in the registry, adds it to the display queue, and emits
-	* `notification:received`. The ticket auto-dismisses after the configured
-	* timeout unless paused.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* // Basic toast
-	* notifications.send({ subject: 'Changes saved', severity: 'success' })
-	*
-	* // With custom timeout
-	* const ticket = notifications.send({ subject: 'Connection lost', severity: 'error', timeout: 10000 })
-	*
-	* console.log(ticket.id)        // 'generated-id'
-	* console.log(ticket.createdAt) // Date
-	* console.log(ticket.readAt)    // null
-	*
-	* // Ticket convenience methods
-	* ticket.read()    // marks as read
-	* ticket.dismiss() // removes from toast queue, keeps in registry
-	* ```
-	*/
-	function send(input) {
-		const ticket = registry.register(hydrate(input));
-		queue.register(/* @__PURE__ */ isUndefined(input.timeout) ? { id: ticket.id } : {
-			id: ticket.id,
-			timeout: input.timeout
-		});
-		registry.emit("notification:received", ticket);
-		return ticket;
-	}
-	/**
-	* Register a notification in the registry without adding it to the toast queue
-	*
-	* @param input The notification input to register.
-	* @returns The hydrated notification ticket.
-	* @remarks Overrides the base registry `register` to hydrate the input with
-	* timestamps and lifecycle methods. Use for historical or pre-existing items
-	* that should appear in an inbox but not pop up as toasts.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* // Register a historical item (appears in inbox, not as toast)
-	* const ticket = notifications.register({ id: 'old-1', subject: 'Deployed v2.1' })
-	*
-	* console.log(ticket.createdAt) // Date
-	* console.log(ticket.readAt)    // null
-	*
-	* // Lifecycle methods work the same as send()
-	* ticket.read()
-	* ticket.archive()
-	* ```
-	*/
-	function register(input) {
-		return registry.register(hydrate(input));
-	}
-	/**
-	* Bulk version of {@link register}
-	*
-	* @param inputs Array of notification inputs to register.
-	* @returns Array of hydrated notification tickets.
-	* @remarks Registers multiple notifications into the registry without toast
-	* display. Wraps all registrations in a single `registry.batch()` call so
-	* reactive updates are deferred until the entire batch completes.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* // Load historical items on mount
-	* const tickets = notifications.onboard([
-	*   { id: 'n1', subject: 'Welcome to the team' },
-	*   { id: 'n2', subject: 'Setup complete', severity: 'success' },
-	* ])
-	*
-	* console.log(tickets.length)              // 2
-	* console.log(notifications.queue.values()) // [] (no toasts)
-	* console.log(notifications.values().length) // 2 (in registry)
-	* ```
-	*/
-	function onboard(inputs) {
-		return registry.batch(() => inputs.map((input) => register(input)));
-	}
-	/**
-	* Mark a notification as read
-	*
-	* @param id The ID of the notification to mark as read.
-	* @remarks Sets `readAt` to the current time and emits `notification:read`.
-	* Adapters listen to this event for outbound sync.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* const ticket = notifications.send({ subject: 'New message' })
-	*
-	* notifications.read(ticket.id)
-	* console.log(ticket.readAt) // Date
-	*
-	* // Or via ticket convenience method
-	* ticket.read()
-	* ```
-	*/
-	function read(id) {
-		registry.upsert(id, { readAt: /* @__PURE__ */ new Date() }, "notification:read");
-	}
-	/**
-	* Mark a notification as unread
-	*
-	* @param id The ID of the notification to mark as unread.
-	* @remarks Clears `readAt` and emits `notification:unread`.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* notifications.unread('notif-1')
-	* ```
-	*/
-	function unread(id) {
-		registry.upsert(id, { readAt: null }, "notification:unread");
-	}
-	/**
-	* Mark a notification as seen
-	*
-	* @param id The ID of the notification to mark as seen.
-	* @remarks Sets `seenAt` to the current time and emits `notification:seen`.
-	* Distinct from read — seen tracks whether the notification appeared in the
-	* user's viewport, while read indicates the user actively engaged with it.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* // Mark as seen when visible in inbox viewport
-	* notifications.seen('notif-1')
-	* ```
-	*/
-	function seen(id) {
-		registry.upsert(id, { seenAt: /* @__PURE__ */ new Date() }, "notification:seen");
-	}
-	/**
-	* Archive a notification
-	*
-	* @param id The ID of the notification to archive.
-	* @remarks Sets `archivedAt` to the current time and emits `notification:archived`.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* notifications.archive('notif-1')
-	* ```
-	*/
-	function archive(id) {
-		registry.upsert(id, { archivedAt: /* @__PURE__ */ new Date() }, "notification:archived");
-	}
-	/**
-	* Restore an archived notification
-	*
-	* @param id The ID of the notification to unarchive.
-	* @remarks Clears `archivedAt` and emits `notification:unarchived`.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* notifications.unarchive('notif-1')
-	* ```
-	*/
-	function unarchive(id) {
-		registry.upsert(id, { archivedAt: null }, "notification:unarchived");
-	}
-	/**
-	* Snooze a notification until a given time
-	*
-	* @param id The ID of the notification to snooze.
-	* @param until The time at which the snooze expires.
-	* @remarks Sets `snoozedUntil` and emits `notification:snoozed`. The composable
-	* does not auto-wake — consumers are responsible for calling {@link wake} when
-	* the snooze expires (e.g., via a timer or server push).
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* const tomorrow = new Date(Date.now() + 86_400_000)
-	* notifications.snooze('notif-1', tomorrow)
-	* ```
-	*/
-	function snooze(id, until) {
-		registry.upsert(id, { snoozedUntil: until }, "notification:snoozed");
-	}
-	/**
-	* Cancel a snooze
-	*
-	* @param id The ID of the notification to wake.
-	* @remarks Clears `snoozedUntil` and emits `notification:unsnoozed`.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* notifications.wake('notif-1')
-	* ```
-	*/
-	function wake(id) {
-		registry.upsert(id, { snoozedUntil: null }, "notification:unsnoozed");
-	}
-	/**
-	* Mark all unread notifications as read
-	*
-	* @remarks Iterates all notifications and marks unread ones as read in a single
-	* batch. Skips already-read notifications to preserve their original `readAt`
-	* timestamp. Emits `notification:read` for each affected notification.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* notifications.send({ subject: 'Message 1' })
-	* notifications.send({ subject: 'Message 2' })
-	*
-	* notifications.readAll()
-	*
-	* console.log(notifications.values().every(t => t.readAt !== null)) // true
-	* ```
-	*/
-	function readAll() {
-		const now = /* @__PURE__ */ new Date();
-		registry.batch(() => {
-			for (const ticket of registry.values()) if (/* @__PURE__ */ isNull(ticket.readAt)) registry.upsert(ticket.id, { readAt: now }, "notification:read");
-		});
-	}
-	/**
-	* Archive all unarchived notifications
-	*
-	* @remarks Iterates all notifications and archives unarchived ones in a single
-	* batch. Skips already-archived notifications to preserve their original
-	* `archivedAt` timestamp. Emits `notification:archived` for each affected notification.
-	*
-	* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-	*
-	* @example
-	* ```ts
-	* import { useNotifications } from '@vuetify/v0'
-	*
-	* const notifications = useNotifications()
-	*
-	* notifications.send({ subject: 'Alert 1' })
-	* notifications.send({ subject: 'Alert 2' })
-	*
-	* notifications.archiveAll()
-	*
-	* console.log(notifications.values().every(t => t.archivedAt !== null)) // true
-	* ```
-	*/
-	function archiveAll() {
-		const now = /* @__PURE__ */ new Date();
-		registry.batch(() => {
-			for (const ticket of registry.values()) if (/* @__PURE__ */ isNull(ticket.archivedAt)) registry.upsert(ticket.id, { archivedAt: now }, "notification:archived");
-		});
-	}
-	return {
-		...registry,
-		send,
-		register,
-		onboard,
-		queue,
-		read,
-		unread,
-		seen,
-		archive,
-		unarchive,
-		snooze,
-		wake,
-		readAll,
-		archiveAll,
-		get size() {
-			return registry.size;
-		}
-	};
-}
-function noop() {}
-const EMPTY = [];
-function createNotificationsFallback() {
-	const stub = {
-		id: "",
-		index: 0,
-		value: 0,
-		valueIsIndex: true,
-		createdAt: /* @__PURE__ */ new Date(0),
-		readAt: null,
-		seenAt: null,
-		archivedAt: null,
-		snoozedUntil: null,
-		read: noop,
-		unread: noop,
-		seen: noop,
-		archive: noop,
-		unarchive: noop,
-		snooze: noop,
-		wake: noop,
-		dismiss: noop,
-		unregister: noop
-	};
-	return {
-		collection: /* @__PURE__ */ new Map(),
-		size: 0,
-		send: () => stub,
-		queue: {
-			collection: /* @__PURE__ */ new Map(),
-			size: 0,
-			register: () => ({}),
-			unregister: () => void 0,
-			has: () => false,
-			get: () => void 0,
-			keys: () => EMPTY,
-			values: () => EMPTY,
-			entries: () => EMPTY,
-			browse: () => void 0,
-			lookup: () => void 0,
-			upsert: () => ({}),
-			seek: () => void 0,
-			move: () => void 0,
-			on: noop,
-			off: noop,
-			emit: noop,
-			dispose: noop,
-			clear: noop,
-			reindex: noop,
-			batch: (fn) => fn(),
-			onboard: () => EMPTY,
-			offboard: noop,
-			pause: () => void 0,
-			resume: () => void 0
-		},
-		read: noop,
-		unread: noop,
-		seen: noop,
-		archive: noop,
-		unarchive: noop,
-		snooze: noop,
-		wake: noop,
-		readAll: noop,
-		archiveAll: noop,
-		clear: noop,
-		has: () => false,
-		get: () => void 0,
-		keys: () => EMPTY,
-		values: () => EMPTY,
-		entries: () => EMPTY,
-		browse: () => void 0,
-		lookup: () => void 0,
-		upsert: () => stub,
-		register: () => stub,
-		unregister: noop,
-		reindex: noop,
-		move: () => void 0,
-		seek: () => void 0,
-		on: noop,
-		off: noop,
-		emit: noop,
-		dispose: noop,
-		batch: (fn) => fn(),
-		onboard: () => EMPTY,
-		offboard: noop
-	};
-}
-/**
-* Notification management with registry, event system, and optional adapters.
-*
-* @see https://0.vuetifyjs.com/composables/plugins/use-notifications
-*
-* @example
-* ```ts
-* import { createNotificationsPlugin, useNotifications } from '@vuetify/v0'
-*
-* // Install as plugin
-* app.use(createNotificationsPlugin())
-*
-* // Use in components
-* const notifications = useNotifications()
-* notifications.send({ subject: 'Saved', severity: 'success' })
-* ```
-*/
-const [createNotificationsContext, createNotificationsPlugin, useNotifications] = createPluginContext("v0:notifications", (options) => createNotifications(options), {
-	fallback: () => createNotificationsFallback(),
-	setup: (context, app, options) => {
-		app.onUnmount(() => {
-			context.dispose();
-			context.queue.dispose();
-		});
-		const { adapter } = options;
-		if (!adapter) return;
-		adapter.setup({
-			send: context.send,
-			register: context.register,
-			on: context.on,
-			off: context.off
-		});
-		if (/* @__PURE__ */ isFunction(adapter.dispose)) app.onUnmount(() => adapter.dispose());
-	}
-});
-//#endregion
 //#region src/composables/usePresence/index.ts
 /**
 * @module usePresence
@@ -6072,6 +5536,15 @@ const [createNotificationsContext, createNotificationsPlugin, useNotifications]
 * - Re-entry during leave: cancels exit, stays mounted
 * - Immediate mode: auto-unmounts if done() not called (fast path)
 * - SSR-safe: starts unmounted
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { usePresence } from '@vuetify/v0'
+*
+* const isOpen = shallowRef(false)
+* const { isMounted, state, done } = usePresence({ present: isOpen })
+* ```
 */
 /**
 * Animation-agnostic mount lifecycle management.
@@ -6183,6 +5656,16 @@ function usePresence(options) {
 * - Works with any ModelContext (Selection, Slider, etc.)
 *
 * Bridges the gap between model composables and Vue's v-model.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { createSelection, useProxyModel } from '@vuetify/v0'
+*
+* const selection = createSelection({ events: true })
+* const model = shallowRef<string[]>([])
+* useProxyModel(selection, model, { multiple: true })
+* ```
 */
 /**
 * Syncs a ref with a model context bidirectionally.
@@ -6214,7 +5697,7 @@ function useProxyModel(context, model, options) {
 	const _transformOut = options?.transformOut;
 	function transformIn(val) {
 		const value = toValue(val);
-		return toArray(/* @__PURE__ */ isFunction(_transformIn) ? _transformIn(value) : value);
+		return /* @__PURE__ */ toArray(/* @__PURE__ */ isFunction(_transformIn) ? _transformIn(value) : value);
 	}
 	function transformOut(val) {
 		if (/* @__PURE__ */ isFunction(_transformOut)) return _transformOut(val);
@@ -6287,6 +5770,16 @@ function useProxyModel(context, model, options) {
 * - Callable function with cancel method
 *
 * Perfect for throttling updates to the next animation frame.
+*
+* @example
+* ```ts
+* import { useRaf } from '@vuetify/v0'
+*
+* const update = useRaf(timestamp => {
+*   // runs on next animation frame
+* })
+* update()
+* ```
 */
 /**
 * Scope-disposed safe requestAnimationFrame.
@@ -6355,6 +5848,15 @@ function useRaf(callback) {
 * - Auto-attaches keydown listener when target is provided
 *
 * Perfect for toolbars, menus, tree items, grids, and other composite widgets.
+*
+* @example
+* ```ts
+* import { useRovingFocus } from '@vuetify/v0'
+*
+* const items = () => [{ id: 'a' }, { id: 'b' }, { id: 'c' }]
+* const focus = useRovingFocus(items, { orientation: 'horizontal' })
+* focus.next()
+* ```
 */
 function useRovingFocus(items, options = {}) {
 	const { orientation, circular, columns, onFocus, target } = options;
@@ -6432,6 +5934,14 @@ var Vuetify0RtlAdapter = class {
 * - Subtree overrides via context provision
 *
 * Independent from useLocale — Vuetify connects them via adapter.
+*
+* @example
+* ```ts
+* import { useRtl } from '@vuetify/v0'
+*
+* const { isRtl, toggle } = useRtl()
+* toggle() // flip direction
+* ```
 */
 /**
 * Creates a new RTL direction instance.
@@ -6483,6 +5993,15 @@ const [createRtlContext, createRtlPlugin, useRtl] = createPluginContext("v0:rtl"
 * - Auto-cleanup when registered within component setup
 *
 * Built on createSelection for consistent ticket-based management.
+*
+* @example
+* ```ts
+* import { useStack } from '@vuetify/v0'
+*
+* const stack = useStack()
+* const ticket = stack.register({ onDismiss: () => console.log('dismissed') })
+* ticket.select()
+* ```
 */
 /**
 * Creates a new stack instance for managing overlay z-indexes.
@@ -6557,7 +6076,7 @@ function createStack(_options = {}) {
 			...input,
 			id
 		});
-		if (instanceExists()) onScopeDispose(() => {
+		if (/* @__PURE__ */ instanceExists()) onScopeDispose(() => {
 			selection.unregister(id);
 		}, true);
 		return ticket;
@@ -6600,12 +6119,7 @@ function createStack(_options = {}) {
 */
 function createStackContext(_options = {}) {
 	const { namespace = "v0:stack", ...options } = _options;
-	const [useStackContext, _provideStackContext] = createContext(namespace);
-	const context = createStack(options);
-	function provideStackContext(_context = context, app) {
-		return _provideStackContext(_context, app);
-	}
-	return createTrinity(useStackContext, provideStackContext, context);
+	return createTrinity(namespace, createStack(options));
 }
 /**
 * Creates a Vue plugin to provide stack context at app level.
@@ -6686,7 +6200,7 @@ function getStackFallback() {
 */
 function useStack(namespace = "v0:stack") {
 	const fallback = getStackFallback();
-	if (!instanceExists()) return fallback;
+	if (!/* @__PURE__ */ instanceExists()) return fallback;
 	try {
 		return useContext(namespace);
 	} catch {
@@ -6712,6 +6226,15 @@ function useStack(namespace = "v0:stack") {
 * - Automatic cleanup on remove/clear
 *
 * Uses adapter pattern to abstract storage implementation details.
+*
+* @example
+* ```ts
+* import { useStorage } from '@vuetify/v0'
+*
+* const storage = useStorage()
+* const theme = storage.get('theme', 'light')
+* theme.value = 'dark' // persists automatically
+* ```
 */
 /**
 * Creates a new storage instance.
@@ -6753,7 +6276,7 @@ function createStorage(options = {}) {
 		if (/* @__PURE__ */ isNullOrUndefined(raw)) return void 0;
 		try {
 			const parsed = serializer.read(raw);
-			if (ttl && /* @__PURE__ */ isObject(parsed) && "__ttl" in parsed && "__v" in parsed) {
+			if (ttl && /* @__PURE__ */ isObject(parsed) && "__v0" in parsed && "__v" in parsed) {
 				const envelope = parsed;
 				if (Date.now() - envelope.__t > ttl) {
 					adapter?.removeItem(prefixedKey);
@@ -6769,7 +6292,7 @@ function createStorage(options = {}) {
 	}
 	function writeStored(prefixedKey, value) {
 		const wrapped = ttl ? {
-			__ttl: 1,
+			__v0: 1,
 			__v: value,
 			__t: Date.now()
 		} : value;
@@ -6859,6 +6382,17 @@ const [createStorageContext, createStoragePlugin, useStorage] = createPluginCont
 *
 * Perfect for conditional side effects, feature flags, and performance optimization
 * by only running reactive effects when needed.
+*
+* @example
+* ```ts
+* import { shallowRef } from 'vue'
+* import { useToggleScope } from '@vuetify/v0'
+*
+* const isEnabled = shallowRef(false)
+* const { isActive } = useToggleScope(isEnabled, () => {
+*   // effects run while isEnabled is true
+* })
+* ```
 */
 /**
 * Conditionally manages an effect scope based on a reactive boolean source.
@@ -6954,6 +6488,15 @@ function useToggleScope(source, fn) {
 * - Multiple overloads for type safety
 *
 * Perfect for safely managing event listeners in Vue components.
+*
+* @example
+* ```ts
+* import { useEventListener } from '@vuetify/v0'
+*
+* useEventListener(window, 'resize', () => {
+*   console.log('window resized')
+* })
+* ```
 */
 /**
 * Attaches an event listener to a target.
@@ -6984,8 +6527,8 @@ function useEventListener(target, event, listener, options) {
 	], ([el, events, listeners, opts]) => {
 		cleanup();
 		if (!el) return;
-		const eventList = toArray(events);
-		const listenerList = toArray(listeners);
+		const eventList = /* @__PURE__ */ toArray(events);
+		const listenerList = /* @__PURE__ */ toArray(listeners);
 		for (const event of eventList) for (const listenerFn of listenerList) cleanups.push(register(el, event, listenerFn, opts));
 	}, {
 		immediate: true,
@@ -7050,6 +6593,15 @@ function useDocumentEventListener(event, listener, options) {
 * Accessibility: This composable handles pointer interactions only. For accessible
 * components (dialogs, popovers, menus), pair with `useHotkey` for Escape key
 * dismissal per WCAG/APG requirements.
+*
+* @example
+* ```ts
+* import { useTemplateRef } from 'vue'
+* import { useClickOutside } from '@vuetify/v0'
+*
+* const target = useTemplateRef('popover')
+* useClickOutside(target, () => console.log('clicked outside'))
+* ```
 */
 /**
 * Detects clicks outside of the specified element(s).
@@ -7130,7 +6682,7 @@ function useClickOutside(target, handler, options = {}) {
 	* Resolve target(s) to an array of HTMLElements.
 	*/
 	function getTargets() {
-		return toArray(target).map((source) => toValue(source)).filter((el) => !!el && /* @__PURE__ */ isFunction(el.contains));
+		return (/* @__PURE__ */ toArray(target)).map((source) => toValue(source)).filter((el) => !!el && /* @__PURE__ */ isFunction(el.contains));
 	}
 	/**
 	* Resolve ignore targets to a tuple of [selectors, elements].
@@ -7237,6 +6789,7 @@ function useClickOutside(target, handler, options = {}) {
 	* Handle window blur - detect focus moving to iframe.
 	*/
 	function onBlur(event) {
+		if (!IN_BROWSER) return;
 		if (isPaused.value) return;
 		if (event.defaultPrevented) return;
 		if (document.activeElement instanceof HTMLIFrameElement) {
@@ -7287,4 +6840,4 @@ function useClickOutside(target, handler, options = {}) {
 	};
 }
 //#endregion
-export { createStepContext as $, usePrefersContrast as A, createValidation as At, useDate as B, usePopover as Bt, usePresence as C, createNumeric as Ct, useNotifications as D, multipleOpenStrategy as Dt, createNotificationsPlugin as E, useNested as Et, useIntersectionObserver as F, createComboboxContext as Ft, toReactive as G, createBreakpointsContext as H, createBreadcrumbs as Ht, useHotkey as I, useCombobox as It, useVirtual as J, createVirtual as K, createDate as L, ServerAdapter as Lt, usePrefersReducedMotion as M, createFormContext as Mt, useLazy as N, useForm as Nt, useMutationObserver as O, singleOpenStrategy as Ot, useElementIntersection as P, createCombobox as Pt, createStep as Q, createDateContext as R, ClientAdapter as Rt, useProxyModel as S, createNumberField as St, createNotificationsContext as T, createNestedContext as Tt, createBreakpointsPlugin as U, createBreadcrumbsContext as Ut, createBreakpoints as V, useTimer as Vt, useBreakpoints as W, useBreadcrumbs as Wt, createTimelineContext as X, createTimeline as Y, useTimeline as Z, createRtlPlugin as _, createFallbackHydration as _t, useToggleScope as a, createQueue as at, useRovingFocus as b, createHydrationPlugin as bt, createStoragePlugin as c, createProgress as ct, createStackContext as d, createOverflow as dt, useStep as et, createStackPlugin as f, createOverflowContext as ft, createRtlFallback as g, toElement as gt, createRtlContext as h, useResizeObserver as ht, useWindowEventListener as i, useRating as it, usePrefersDark as j, createForm as jt, useMediaQuery as k, createInput as kt, useStorage as l, createProgressContext as lt, createRtl as m, useElementSize as mt, useDocumentEventListener as n, createRating as nt, createStorage as o, createQueueContext as ot, useStack as p, useOverflow as pt, createVirtualContext as q, useEventListener as r, createRatingContext as rt, createStorageContext as s, useQueue as st, useClickOutside as t, createSlider as tt, createStack as u, useProgress as ut, useRtl as v, createHydration as vt, createNotifications as w, createNested as wt, useRaf as x, useHydration as xt, Vuetify0RtlAdapter as y, createHydrationContext as yt, createDatePlugin as z, useVirtualFocus as zt };
+export { createRating as $, useElementIntersection as A, ClientAdapter as At, createBreakpointsPlugin as B, usePresence as C, createForm as Ct, usePrefersDark as D, createComboboxContext as Dt, usePrefersContrast as E, createCombobox as Et, createDateContext as F, useBreadcrumbs as Ft, useVirtual as G, toReactive as H, createDatePlugin as I, useTimeline as J, createTimeline as K, useDate as L, useImage as M, usePopover as Mt, useHotkey as N, createBreadcrumbs as Nt, usePrefersReducedMotion as O, useCombobox as Ot, createDate as P, createBreadcrumbsContext as Pt, createSlider as Q, createBreakpoints as R, useProxyModel as S, createValidation as St, useMediaQuery as T, useForm as Tt, createVirtual as U, useBreakpoints as V, createVirtualContext as W, createStepContext as X, createStep as Y, useStep as Z, createRtlPlugin as _, createNumeric as _t, useToggleScope as a, createOverflow as at, useRovingFocus as b, useNested as bt, createStoragePlugin as c, useElementSize as ct, createStackContext as d, createFallbackHydration as dt, createRatingContext as et, createStackPlugin as f, createHydration as ft, createRtlFallback as g, createNumberField as gt, createRtlContext as h, useHydration as ht, useWindowEventListener as i, useProgress as it, useIntersectionObserver as j, useVirtualFocus as jt, useLazy as k, ServerAdapter as kt, useStorage as l, useResizeObserver as lt, createRtl as m, createHydrationPlugin as mt, useDocumentEventListener as n, createProgress as nt, createStorage as o, createOverflowContext as ot, useStack as p, createHydrationContext as pt, createTimelineContext as q, useEventListener as r, createProgressContext as rt, createStorageContext as s, useOverflow as st, useClickOutside as t, useRating as tt, createStack as u, toElement as ut, useRtl as v, createNested as vt, useMutationObserver as w, createFormContext as wt, useRaf as x, createInput as xt, Vuetify0RtlAdapter as y, createNestedContext as yt, createBreakpointsContext as z };