@vuetify/v0 0.0.20 → 0.0.21

package/dist/{useStep-Dw7XloDM.mjs → useStep-CfgBbrJB.mjs}

@@ -1,9 +1,25 @@
-import { _ as range, d as isObject, h as isUndefined, l as isNullOrUndefined, m as isSymbol, o as isFunction, p as isString, r as genId, s as isNaN } from "./utilities-BrFKLHFS.mjs";
-import { a as SUPPORTS_OBSERVER, s as __LOGGER_ENABLED__, t as IN_BROWSER } from "./globals-exvZ8fiO.mjs";
+import { _ as range, c as isNull, d as isObject, h as isUndefined, i as isArray, l as isNullOrUndefined, m as isSymbol, o as isFunction, p as isString, r as genId, s as isNaN, t as clamp } from "./utilities-CjDz-Xvn.mjs";
+import { a as SUPPORTS_OBSERVER, s as __LOGGER_ENABLED__, t as IN_BROWSER } from "./globals-C3JrEDXZ.mjs";
 import { computed, getCurrentInstance, inject, isRef, onScopeDispose, provide, reactive, shallowReactive, shallowReadonly, shallowRef, toRef, toValue, watch, watchEffect } from "vue";
 
 //#region src/composables/createContext/index.ts
 /**
+* @module createContext
+*
+* @see https://0.vuetifyjs.com/composables/foundation/create-context
+*
+* @remarks
+* Factory for creating type-safe Vue dependency injection contexts.
+*
+* Provides a wrapper around Vue's provide/inject that throws errors when context is not found,
+* eliminating silent failures and improving developer experience. Supports both app-level and
+* component-level provision.
+*
+* Supports two modes:
+* - **Static key**: `createContext('my-key')` - key is fixed at creation time
+* - **Dynamic key**: `createContext()` or `createContext({ suffix: 'item' })` - key provided at runtime
+*/
+/**
 * Injects a context provided by an ancestor component.
 *
 * @param key The key of the context to inject.
@@ -286,10 +302,12 @@ var Vuetify0LoggerAdapter = class {
 	}
 	timestamp() {
 		if (!IN_BROWSER) return (/* @__PURE__ */ new Date()).toISOString();
+		/* v8 ignore next -- defensive fallback, toTimeString always returns valid format */
 		return (/* @__PURE__ */ new Date()).toTimeString().split(" ")[0] ?? "";
 	}
 	style(level) {
 		if (!this.colors || !IN_BROWSER) return "";
+		/* v8 ignore next -- LogLevel union is exhaustive */
 		return {
 			trace: "color: #64748b",
 			debug: "color: #3b82f6",
@@ -542,6 +560,23 @@ function useLogger(namespace = "v0:logger") {
 //#endregion
 //#region src/composables/useRegistry/index.ts
 /**
+* @module useRegistry
+*
+* @see https://0.vuetifyjs.com/composables/registration/use-registry
+*
+* @remarks
+* A foundational composable for managing collections of items (tickets) with:
+* - Unique ID-based access
+* - Index-based ordering
+* - Value-based reverse lookup
+* - Automatic reindexing
+* - Optional event emission
+* - Performance-optimized caching
+*
+* The registry serves as the base for many other composables in the system,
+* including useSelection, useForm, useTimeline, and more.
+*/
+/**
 * Creates a new registry instance.
 *
 * @param options The options for the registry instance.
@@ -814,7 +849,7 @@ function useRegistry(options) {
 			return direction === "first" ? tickets$1[0] : tickets$1.at(-1);
 		}
 		const tickets = values();
-		const index = /* @__PURE__ */ isUndefined(from) ? void 0 : Math.max(0, Math.min(from, tickets.length - 1));
+		const index = /* @__PURE__ */ isUndefined(from) ? void 0 : /* @__PURE__ */ clamp(from, 0, tickets.length - 1);
 		if (direction === "last") {
 			const start = /* @__PURE__ */ isUndefined(index) ? tickets.length - 1 : index;
 			for (let i = start; i >= 0; i--) {
@@ -899,6 +934,21 @@ function createRegistryContext(_options = {}) {
 //#endregion
 //#region src/composables/useSelection/index.ts
 /**
+* @module useSelection
+*
+* @remarks
+* Base composable for managing selected items in a collection with Set-based tracking.
+*
+* Key features:
+* - Set-based selectedIds for O(1) selection checks
+* - Mandatory selection mode (prevents deselecting last item)
+* - Auto-enrollment option (selects non-disabled items on register)
+* - Disabled item filtering
+* - Computed selectedItems and selectedValues Sets
+*
+* Extends useRegistry and serves as the base for useSingle, useGroup, useStep, and useFeatures.
+*/
+/**
 * Creates a new selection instance for managing multiple selected items.
 *
 * Extends `useRegistry` with selection tracking via a reactive `Set` of selected IDs.
@@ -1132,12 +1182,26 @@ function useSelection(namespace = "v0:selection") {
 * ```
 */
 function toArray(value) {
-	return /* @__PURE__ */ isNullOrUndefined(value) ? [] : Array.isArray(value) ? value : [value];
+	return /* @__PURE__ */ isNullOrUndefined(value) ? [] : /* @__PURE__ */ isArray(value) ? value : [value];
 }
 
 //#endregion
 //#region src/composables/useProxyModel/index.ts
 /**
+* @module useProxyModel
+*
+* @remarks
+* Proxy composable for bidirectional sync between selection registry and v-model.
+*
+* Key features:
+* - Bidirectional synchronization
+* - Array and single-value modes
+* - Automatic cleanup on scope disposal
+* - Perfect for form controls with selection backing
+*
+* Bridges the gap between selection composables and Vue's v-model.
+*/
+/**
 * Syncs a ref with a selection registry bidirectionally.
 *
 * @param registry The selection registry to bind to.
@@ -1233,6 +1297,21 @@ function useProxyModel(registry, model, options) {
 //#endregion
 //#region src/composables/useProxyRegistry/index.ts
 /**
+* @module useProxyRegistry
+*
+* @remarks
+* Proxy composable for reactive registry keys, values, entries, and size.
+*
+* Key features:
+* - Reactive proxy for registry data
+* - Deep or shallow reactivity options
+* - Event-based updates
+* - Automatic cleanup on scope disposal
+* - Transforms Map-based registry into reactive refs
+*
+* Perfect for exposing registry data as reactive computed properties.
+*/
+/**
 * Creates a proxy registry that provides reactive objects for registry data.
 *
 * @param registry The registry instance to proxy.
@@ -1282,6 +1361,26 @@ function useProxyRegistry(registry, options) {
 //#endregion
 //#region src/composables/useGroup/index.ts
 /**
+* @module useGroup
+*
+* @remarks
+* Multi-selection composable that extends useSelection with batch operations and tri-state support.
+*
+* Key features:
+* - Batch operations (select/unselect/toggle accept ID | ID[])
+* - Tri-state support via mixed/indeterminate state (mix/unmix)
+* - selectedIndexes computed Set for position-based tracking
+* - Perfect for checkbox trees, multi-select dropdowns, filter panels
+*
+* Tri-state behavior:
+* - Items can be selected, mixed (indeterminate), or unselected
+* - select() clears mixed state, mix() clears selected state (mutually exclusive)
+* - toggle() on a mixed item selects it (resolves positively)
+*
+* Inheritance chain: useRegistry → useSelection → useGroup
+* Extended by: useFeatures
+*/
+/**
 * Creates a new group instance with batch selection and tri-state support.
 *
 * Extends `createSelection` to support selecting, unselecting, and toggling multiple items
@@ -1546,40 +1645,20 @@ function useGroup(namespace = "v0:group") {
 }
 
 //#endregion
-//#region src/composables/useLocale/adapters/v0.ts
+//#region src/composables/useSingle/index.ts
 /**
-* Vuetify0.x locale adapter implementation
+* @module useSingle
 *
-* This adapter provides translation and number formatting
-* capabilities using the Intl API and supports both
-* numbered ({0}, {1}) and named ({name}) variables in translation strings.
+* @remarks
+* Single-selection composable that extends useSelection to enforce only one selected item.
+*
+* Key features:
+* - Auto-clears previous selection when selecting new item
+* - Singular computed properties (selectedId, selectedItem, selectedIndex, selectedValue)
+* - Perfect for tabs, radio buttons, theme selectors
+*
+* Inheritance chain: useRegistry → useSelection → useSingle
 */
-var Vuetify0LocaleAdapter = class {
-	t(message, ...params) {
-		let resolvedMessage = message;
-		if (params.length > 0 && /* @__PURE__ */ isObject(params[0])) {
-			const variables = params[0];
-			resolvedMessage = resolvedMessage.replace(/{([a-zA-Z][a-zA-Z0-9_]*)}/g, (match, name) => {
-				return /* @__PURE__ */ isUndefined(variables[name]) ? match : String(variables[name]);
-			});
-			params = params.slice(1);
-		}
-		resolvedMessage = resolvedMessage.replace(/\{(\d+)\}/g, (match, index) => {
-			const idx = Number.parseInt(index, 10);
-			if (!/* @__PURE__ */ isUndefined(params[idx])) return String(params[idx]);
-			return match;
-		});
-		return resolvedMessage;
-	}
-	n(value, locale, ...params) {
-		if (!IN_BROWSER || !locale) return value.toString();
-		const options = params[0];
-		return new Intl.NumberFormat(String(locale), options).format(value);
-	}
-};
-
-//#endregion
-//#region src/composables/useSingle/index.ts
 /**
 * Creates a new single selection instance that enforces only one selected item at a time.
 *
@@ -1726,6 +1805,23 @@ function useSingle(namespace = "v0:single") {
 //#endregion
 //#region src/composables/useTokens/index.ts
 /**
+* @module useTokens
+*
+* @see https://0.vuetifyjs.com/composables/registration/use-tokens
+*
+* @remarks
+* Design token registry with alias resolution and W3C Design Tokens format support.
+*
+* Key features:
+* - Alias resolution with circular reference detection
+* - Nested token flattening with dot notation
+* - W3C Design Tokens format ($value, $type, $description, $extensions)
+* - Path-based resolution (e.g., {colors}.blue.500)
+* - Resolution caching for performance (~28,590 ops/sec)
+*
+* Used by useTheme, useLocale, and useFeatures for token-based configuration.
+*/
+/**
 * Creates a new token instance.
 *
 * @param tokens The tokens to use.
@@ -1963,9 +2059,57 @@ function flatten(tokens, prefix = "", flat = false) {
 	return flattened;
 }
 
+//#endregion
+//#region src/composables/useLocale/adapters/v0.ts
+/**
+* Vuetify0.x locale adapter implementation
+*
+* This adapter provides translation and number formatting
+* capabilities using the Intl API and supports both
+* numbered ({0}, {1}) and named ({name}) variables in translation strings.
+*/
+var Vuetify0LocaleAdapter = class {
+	t(message, ...params) {
+		let resolvedMessage = message;
+		if (params.length > 0 && /* @__PURE__ */ isObject(params[0])) {
+			const variables = params[0];
+			resolvedMessage = resolvedMessage.replace(/{([a-zA-Z][a-zA-Z0-9_]*)}/g, (match, name) => {
+				return /* @__PURE__ */ isUndefined(variables[name]) ? match : String(variables[name]);
+			});
+			params = params.slice(1);
+		}
+		resolvedMessage = resolvedMessage.replace(/\{(\d+)\}/g, (match, index) => {
+			const idx = Number.parseInt(index, 10);
+			if (!/* @__PURE__ */ isUndefined(params[idx])) return String(params[idx]);
+			return match;
+		});
+		return resolvedMessage;
+	}
+	n(value, locale, ...params) {
+		if (!IN_BROWSER || !locale) return value.toString();
+		const options = params[0];
+		return new Intl.NumberFormat(String(locale), options).format(value);
+	}
+};
+
 //#endregion
 //#region src/composables/useLocale/index.ts
 /**
+* @module useLocale
+*
+* @remarks
+* Internationalization (i18n) composable with adapter pattern for message translation.
+*
+* Key features:
+* - Locale selection with createSingle
+* - Token-based message storage with useTokens
+* - Numbered and named placeholder support ({0}, {name})
+* - Number formatting with Intl.NumberFormat
+* - Adapter pattern for integration with i18n providers
+*
+* Integrates with createSingle for locale selection and useTokens for message resolution.
+*/
+/**
 * Creates a new locale instance.
 *
 * @param options The options for the locale instance.
@@ -2107,6 +2251,23 @@ function useLocale(namespace = "v0:locale") {
 //#endregion
 //#region src/composables/useHydration/index.ts
 /**
+* @module useHydration
+*
+* @see https://0.vuetifyjs.com/composables/plugins/use-hydration
+*
+* @remarks
+* SSR hydration state management composable.
+*
+* Key features:
+* - Hydration state detection (browser vs SSR)
+* - Root component detection
+* - Readonly hydration state refs
+* - Plugin installation support
+* - Perfect for hydration-safe rendering
+*
+* Essential for composables that need to behave differently during SSR vs client-side.
+*/
+/**
 * Creates a new hydration instance.
 *
 * @returns A new hydration instance.
@@ -2201,7 +2362,7 @@ function createHydrationPlugin(_options = {}) {
 		},
 		setup: (app) => {
 			app.mixin({ mounted() {
-				if (this.$parent !== null) return;
+				if (!/* @__PURE__ */ isNull(this.$parent)) return;
 				context.hydrate();
 			} });
 		}
@@ -2243,6 +2404,22 @@ function useHydration(namespace = "v0:hydration") {
 //#endregion
 //#region src/composables/useResizeObserver/index.ts
 /**
+* @module useResizeObserver
+*
+* @remarks
+* ResizeObserver composable with lifecycle management.
+*
+* Key features:
+* - ResizeObserver API wrapper
+* - Pause/resume/stop functionality
+* - Automatic cleanup on unmount
+* - SSR-safe (checks SUPPORTS_OBSERVER)
+* - Hydration-aware
+* - Box model options (content-box/border-box)
+*
+* Perfect for responsive components and size-based rendering.
+*/
+/**
 * A composable that uses the Resize Observer API to detect when an element's
 * size changes.
 *
@@ -2289,7 +2466,7 @@ function useResizeObserver(target, callback, options = {}) {
 	const isPaused = shallowRef(false);
 	const isActive = toRef(() => !!observer.value);
 	function setup() {
-		if (observer.value === null) return;
+		if (/* @__PURE__ */ isNull(observer.value)) return;
 		if (!isHydrated.value || !SUPPORTS_OBSERVER || !target.value || isPaused.value) return;
 		observer.value = new ResizeObserver((entries) => {
 			callback(entries.map((entry) => ({
@@ -2402,6 +2579,23 @@ function useElementSize(target) {
 //#endregion
 //#region src/composables/useOverflow/index.ts
 /**
+* @module useOverflow
+*
+* @remarks
+* Composable for computing how many items fit in a container based on available width.
+* Enables responsive truncation logic for Pagination, Breadcrumbs, and similar components.
+*
+* Key features:
+* - Container width tracking via ResizeObserver
+* - Two modes: variable-width (per-item) or uniform-width (sample-based)
+* - Computes capacity (how many items fit)
+* - SSR-safe with Infinity fallback
+* - Supports reserved space for nav buttons, ellipsis, etc.
+*
+* Use variable mode (default) for items with different widths like Breadcrumbs.
+* Use uniform mode (itemWidth option) for same-width items like Pagination buttons.
+*/
+/**
 * Creates a new overflow context for computing how many items fit in a container.
 *
 * @param options Configuration options
@@ -2571,6 +2765,22 @@ function useOverflow(namespace = "v0:overflow") {
 //#endregion
 //#region src/composables/usePagination/index.ts
 /**
+* @module usePagination
+*
+* @remarks
+* Lightweight pagination composable for navigating through pages.
+*
+* Key features:
+* - No registry overhead - just a bounded integer
+* - Direct ref support for v-model compatibility
+* - Navigation methods: next, prev, first, last
+* - Computed visible items with ellipsis
+* - Trinity pattern for dependency injection
+*
+* Unlike registry-based composables, pagination tracks a single number
+* within a range, making it efficient for large page counts.
+*/
+/**
 * Creates a pagination instance.
 *
 * @param options The options for the pagination instance.
@@ -2784,6 +2994,20 @@ function usePagination(namespace = "v0:pagination") {
 //#endregion
 //#region src/composables/useStep/index.ts
 /**
+* @module useStep
+*
+* @remarks
+* Navigation composable that extends useSingle with first/last/next/prev/step methods.
+*
+* Key features:
+* - Configurable circular or bounded navigation
+* - Automatic disabled item skipping
+* - Arbitrary step counts (positive/negative)
+* - Perfect for wizards, carousels, pagination, onboarding flows
+*
+* Inheritance chain: useRegistry → useSelection → useSingle → useStep
+*/
+/**
 * Creates a new step instance with navigation through items.
 *
 * Extends `createSingle` with `first()`, `last()`, `next()`, `prev()`, and `step(count)` methods
@@ -2965,4 +3189,4 @@ function useStep(namespace = "v0:step") {
 }
 
 //#endregion
-export { createGroupContext as A, createLogger as B, createTokensContext as C, useSingle as D, createSingleContext as E, createSelection as F, PinoLoggerAdapter as G, createLoggerPlugin as H, createSelectionContext as I, createTrinity as J, ConsolaLoggerAdapter as K, useSelection as L, useProxyRegistry as M, useProxyModel as N, Vuetify0LocaleAdapter as O, toArray as P, createRegistryContext as R, createTokens as S, createSingle as T, useLogger as U, createLoggerContext as V, Vuetify0LoggerAdapter as W, provideContext as X, createContext as Y, useContext as Z, createLocale as _, createPaginationContext as a, createLocalePlugin as b, createOverflowContext as c, useResizeObserver as d, createFallbackHydration as f, useHydration as g, createHydrationPlugin as h, createPagination as i, useGroup as j, createGroup as k, useOverflow as l, createHydrationContext as m, createStepContext as n, usePagination as o, createHydration as p, createPlugin as q, useStep as r, createOverflow as s, createStep as t, useElementSize as u, createLocaleContext as v, useTokens as w, useLocale as x, createLocaleFallback as y, useRegistry as z };
+export { createGroupContext as A, createLogger as B, createTokens as C, createSingleContext as D, createSingle as E, createSelection as F, PinoLoggerAdapter as G, createLoggerPlugin as H, createSelectionContext as I, createTrinity as J, ConsolaLoggerAdapter as K, useSelection as L, useProxyRegistry as M, useProxyModel as N, useSingle as O, toArray as P, createRegistryContext as R, Vuetify0LocaleAdapter as S, useTokens as T, useLogger as U, createLoggerContext as V, Vuetify0LoggerAdapter as W, provideContext as X, createContext as Y, useContext as Z, createLocale as _, createPaginationContext as a, createLocalePlugin as b, createOverflowContext as c, useResizeObserver as d, createFallbackHydration as f, useHydration as g, createHydrationPlugin as h, createPagination as i, useGroup as j, createGroup as k, useOverflow as l, createHydrationContext as m, createStepContext as n, usePagination as o, createHydration as p, createPlugin as q, useStep as r, createOverflow as s, createStep as t, useElementSize as u, createLocaleContext as v, createTokensContext as w, useLocale as x, createLocaleFallback as y, useRegistry as z };

package/dist/utilities/index.d.mts

@@ -1,3 +1,3 @@
 import "../index-4jSy8KIt.mjs";
-import { _ as range, a as isBoolean, c as isNull, d as isObject, f as isPrimitive, g as mergeDeep, h as isUndefined, i as isArray, l as isNullOrUndefined, m as isSymbol, n as debounce, o as isFunction, p as isString, r as genId, s as isNaN, t as clamp, u as isNumber } from "../index-CjzlIAtF.mjs";
+import { _ as range, a as isBoolean, c as isNull, d as isObject, f as isPrimitive, g as mergeDeep, h as isUndefined, i as isArray, l as isNullOrUndefined, m as isSymbol, n as debounce, o as isFunction, p as isString, r as genId, s as isNaN, t as clamp, u as isNumber } from "../index-CxeZr8jO.mjs";
 export { clamp, debounce, genId, isArray, isBoolean, isFunction, isNaN, isNull, isNullOrUndefined, isNumber, isObject, isPrimitive, isString, isSymbol, isUndefined, mergeDeep, range };

package/dist/utilities/index.mjs

@@ -1,3 +1,3 @@
-import { _ as range, a as isBoolean, c as isNull, d as isObject, f as isPrimitive, g as mergeDeep, h as isUndefined, i as isArray, l as isNullOrUndefined, m as isSymbol, n as debounce, o as isFunction, p as isString, r as genId, s as isNaN, t as clamp, u as isNumber } from "../utilities-BrFKLHFS.mjs";
+import { _ as range, a as isBoolean, c as isNull, d as isObject, f as isPrimitive, g as mergeDeep, h as isUndefined, i as isArray, l as isNullOrUndefined, m as isSymbol, n as debounce, o as isFunction, p as isString, r as genId, s as isNaN, t as clamp, u as isNumber } from "../utilities-CjDz-Xvn.mjs";
 
 export { clamp, debounce, genId, isArray, isBoolean, isFunction, isNaN, isNull, isNullOrUndefined, isNumber, isObject, isPrimitive, isString, isSymbol, isUndefined, mergeDeep, range };

package/dist/{utilities-BrFKLHFS.mjs → utilities-CjDz-Xvn.mjs}

@@ -256,18 +256,24 @@ function isNaN(item) {
 * mergeDeep({ arr: [1, 2] }, { arr: [3] }) // { arr: [3] }
 * ```
 */
+const UNSAFE_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
 /* @__NO_SIDE_EFFECTS__ */
 function mergeDeep(target, ...sources) {
 	if (sources.length === 0) return target;
 	const source = sources.shift();
-	if (/* @__PURE__ */ isObject(target) && /* @__PURE__ */ isObject(source)) {
-		for (const key in source) if (Object.prototype.hasOwnProperty.call(source, key)) {
-			const sourceValue = source[key];
-			const targetValue = target[key];
-			if (/* @__PURE__ */ isObject(sourceValue)) {
-				if (!/* @__PURE__ */ isObject(targetValue)) Object.assign(target, { [key]: {} });
-			} else Object.assign(target, { [key]: sourceValue });
-		}
+	if (/* @__PURE__ */ isObject(target) && /* @__PURE__ */ isObject(source)) for (const key in source) {
+		if (UNSAFE_KEYS.has(key)) continue;
+		if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
+		const sourceValue = source[key];
+		const targetValue = target[key];
+		if (/* @__PURE__ */ isObject(sourceValue)) {
+			if (!/* @__PURE__ */ isObject(targetValue)) Object.assign(target, { [key]: {} });
+			target[key];
+		} else Object.assign(target, { [key]: sourceValue });
 	}
 	return /* @__PURE__ */ mergeDeep(target, ...sources);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vuetify/v0",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "Vuetify0",
   "license": "MIT",
   "main": "./dist/index.mjs",
@@ -16,26 +16,8 @@
     "directory": "packages/0"
   },
   "peerDependencies": {
-    "markdown": "^0.5.0",
-    "markdown-it": "^14.1.0",
-    "marked": "^16.1.1",
-    "micromark": "^4.0.2",
     "vue": ">=3.3.0"
   },
-  "peerDependenciesMeta": {
-    "markdown": {
-      "optional": true
-    },
-    "markdown-it": {
-      "optional": true
-    },
-    "marked": {
-      "optional": true
-    },
-    "micromark": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@vue/test-utils": "^2.4.6",
     "tsdown": "^0.16.1",