@vuetify/v0 0.0.22 → 0.0.23

package/dist/{index-Dr-ge3ZA.d.mts → index-rcTqb9U3.d.mts}

@@ -1,6 +1,7 @@
 import { a as MaybeArray, i as ID } from "./index-DYSwiS9k.mjs";
 import { B as RegistryTicket, I as RegistryContext, L as RegistryContextOptions, M as SelectionTicket, S as GroupContext, T as GroupTicket, U as ContextTrinity, c as SingleContext, d as SingleTicket, k as SelectionContext, u as SingleOptions, z as RegistryOptions } from "./index-Bby5ljat.mjs";
 import { App, ComputedRef, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, ShallowRef, UnwrapNestedRefs, WatchSource } from "vue";
+import { Temporal } from "@js-temporal/polyfill";
 
 //#region src/composables/createContext/index.d.ts
 
@@ -453,6 +454,340 @@ interface UseClickOutsideReturn {
  */
 declare function useClickOutside(target: MaybeArray<ClickOutsideTarget>, handler: (event: PointerEvent | FocusEvent) => void, options?: UseClickOutsideOptions): UseClickOutsideReturn;
 //#endregion
+//#region src/composables/useDate/adapters/adapter.d.ts
+interface DateAdapter<T = Temporal.PlainDateTime> {
+  /** Current locale for formatting */
+  locale?: string;
+  /** Create a date from various input types */
+  date: (value?: unknown) => T | null;
+  /** Convert to JavaScript Date object */
+  toJsDate: (value: T) => Date;
+  /** Parse ISO 8601 string */
+  parseISO: (date: string) => T;
+  /** Convert to ISO 8601 string */
+  toISO: (date: T) => string;
+  /** Parse date string with custom format */
+  parse: (value: string, format: string) => T | null;
+  /** Check if value is a valid date (type predicate for narrowing) */
+  isValid: (date: unknown) => date is T;
+  /** Check if value is null (type predicate for narrowing) */
+  isNull: (value: T | null) => value is null;
+  /** Get current locale code */
+  getCurrentLocaleCode: () => string;
+  /** Check if current locale uses 12-hour cycle */
+  is12HourCycleInCurrentLocale: () => boolean;
+  /** Format date using preset format key */
+  format: (date: T, formatString: string) => string;
+  /** Format date using custom format string */
+  formatByString: (date: T, formatString: string) => string;
+  /** Get helper text for format string (e.g., "mm/dd/yyyy") */
+  getFormatHelperText: (format: string) => string;
+  /** Format number according to locale */
+  formatNumber: (numberToFormat: string) => string;
+  /** Get meridiem text (AM/PM) for locale */
+  getMeridiemText: (ampm: 'am' | 'pm') => string;
+  startOfDay: (date: T) => T;
+  endOfDay: (date: T) => T;
+  /** @param firstDayOfWeek - 0=Sunday, 1=Monday, etc. */
+  startOfWeek: (date: T, firstDayOfWeek?: number) => T;
+  /** @param firstDayOfWeek - 0=Sunday, 1=Monday, etc. */
+  endOfWeek: (date: T, firstDayOfWeek?: number) => T;
+  startOfMonth: (date: T) => T;
+  endOfMonth: (date: T) => T;
+  startOfYear: (date: T) => T;
+  endOfYear: (date: T) => T;
+  addSeconds: (date: T, amount: number) => T;
+  addMinutes: (date: T, amount: number) => T;
+  addHours: (date: T, amount: number) => T;
+  addDays: (date: T, amount: number) => T;
+  addWeeks: (date: T, amount: number) => T;
+  addMonths: (date: T, amount: number) => T;
+  addYears: (date: T, amount: number) => T;
+  isAfter: (date: T, comparing: T) => boolean;
+  isAfterDay: (date: T, comparing: T) => boolean;
+  isAfterMonth: (date: T, comparing: T) => boolean;
+  isAfterYear: (date: T, comparing: T) => boolean;
+  isBefore: (date: T, comparing: T) => boolean;
+  isBeforeDay: (date: T, comparing: T) => boolean;
+  isBeforeMonth: (date: T, comparing: T) => boolean;
+  isBeforeYear: (date: T, comparing: T) => boolean;
+  isEqual: (date: T, comparing: T) => boolean;
+  isSameDay: (date: T, comparing: T) => boolean;
+  isSameMonth: (date: T, comparing: T) => boolean;
+  isSameYear: (date: T, comparing: T) => boolean;
+  isSameHour: (date: T, comparing: T) => boolean;
+  isWithinRange: (date: T, range: [T, T]) => boolean;
+  getYear: (date: T) => number;
+  getMonth: (date: T) => number;
+  getDate: (date: T) => number;
+  getHours: (date: T) => number;
+  getMinutes: (date: T) => number;
+  getSeconds: (date: T) => number;
+  /** @param comparing - Can be T or ISO string */
+  getDiff: (date: T, comparing: T | string, unit?: string) => number;
+  /** @param minimalDays - Minimum days in first week for it to count as week 1 */
+  getWeek: (date: T, firstDayOfWeek?: number, minimalDays?: number) => number;
+  /** Get number of days in the month */
+  getDaysInMonth: (date: T) => number;
+  setYear: (date: T, year: number) => T;
+  setMonth: (date: T, month: number) => T;
+  setDate: (date: T, day: number) => T;
+  setHours: (date: T, hours: number) => T;
+  setMinutes: (date: T, minutes: number) => T;
+  setSeconds: (date: T, seconds: number) => T;
+  getWeekdays: (firstDayOfWeek?: number, weekdayFormat?: 'long' | 'short' | 'narrow') => string[];
+  getWeekArray: (date: T, firstDayOfWeek?: number) => T[][];
+  /** Get array of months in a year (12 dates, one for each month) */
+  getMonthArray: (date: T) => T[];
+  /** Get array of years between start and end dates */
+  getYearRange: (start: T, end: T) => T[];
+  getNextMonth: (date: T) => T;
+  getPreviousMonth: (date: T) => T;
+  /** Merge date from one value with time from another */
+  mergeDateAndTime: (date: T, time: T) => T;
+}
+//#endregion
+//#region src/composables/useDate/adapters/v0.d.ts
+type PlainDateTime = Temporal.PlainDateTime;
+declare class Vuetify0DateAdapter implements DateAdapter<PlainDateTime> {
+  private _locale;
+  /** Cache for Intl.DateTimeFormat instances, keyed by locale + options */
+  private formatCache;
+  /** Cache for Intl.NumberFormat instances, keyed by locale */
+  private numberFormatCache;
+  constructor(locale?: string);
+  /** Current locale. Setting a new locale clears format caches. */
+  get locale(): string;
+  set locale(value: string);
+  /**
+   * Create a date from various input types.
+   *
+   * @param value - Date value (PlainDateTime, PlainDate, ZonedDateTime, Date, ISO string, timestamp)
+   * @returns PlainDateTime or null if invalid
+   *
+   * @remarks
+   * **SSR Safety:** When called without arguments:
+   * - Browser: Returns current time via `Temporal.Now.plainDateTimeISO()`
+   * - Server: Returns epoch (1970-01-01T00:00:00) for deterministic rendering
+   *
+   * For SSR apps needing current time, pass `Date.now()` explicitly and handle
+   * hydration via `<ClientOnly>` (Nuxt) or `v-if` + `onMounted` pattern.
+   */
+  date(value?: unknown): PlainDateTime | null;
+  toJsDate(value: PlainDateTime): Date;
+  parseISO(dateString: string): PlainDateTime;
+  toISO(date: PlainDateTime): string;
+  /**
+   * Parses a date string into a PlainDateTime.
+   *
+   * **Known limitation**: The `format` parameter is currently ignored.
+   * Temporal API doesn't provide built-in format parsing, and implementing
+   * full format string parsing (e.g., 'MM/DD/YYYY') would require a
+   * substantial custom parser. This method delegates to `date()` which
+   * handles ISO 8601 strings and common formats.
+   *
+   * For custom format parsing, consider using a library like date-fns or
+   * luxon with a custom adapter.
+   *
+   * @param value - The date string to parse
+   * @param _format - Format hint (currently ignored)
+   * @returns Parsed PlainDateTime or null if invalid
+   */
+  parse(value: string, _format: string): PlainDateTime | null;
+  isValid(date: unknown): date is PlainDateTime;
+  isNull(value: PlainDateTime | null): value is null;
+  getCurrentLocaleCode(): string;
+  is12HourCycleInCurrentLocale(): boolean;
+  format(date: PlainDateTime, formatString: string): string;
+  formatByString(date: PlainDateTime, formatString: string): string;
+  getFormatHelperText(format: string): string;
+  formatNumber(numberToFormat: string): string;
+  getMeridiemText(ampm: 'am' | 'pm'): string;
+  startOfDay(date: PlainDateTime): PlainDateTime;
+  endOfDay(date: PlainDateTime): PlainDateTime;
+  startOfWeek(date: PlainDateTime, firstDayOfWeek?: number): PlainDateTime;
+  endOfWeek(date: PlainDateTime, firstDayOfWeek?: number): PlainDateTime;
+  startOfMonth(date: PlainDateTime): PlainDateTime;
+  endOfMonth(date: PlainDateTime): PlainDateTime;
+  startOfYear(date: PlainDateTime): PlainDateTime;
+  endOfYear(date: PlainDateTime): PlainDateTime;
+  addSeconds(date: PlainDateTime, amount: number): PlainDateTime;
+  addMinutes(date: PlainDateTime, amount: number): PlainDateTime;
+  addHours(date: PlainDateTime, amount: number): PlainDateTime;
+  addDays(date: PlainDateTime, amount: number): PlainDateTime;
+  addWeeks(date: PlainDateTime, amount: number): PlainDateTime;
+  addMonths(date: PlainDateTime, amount: number): PlainDateTime;
+  addYears(date: PlainDateTime, amount: number): PlainDateTime;
+  isAfter(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isAfterDay(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isAfterMonth(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isAfterYear(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isBefore(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isBeforeDay(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isBeforeMonth(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isBeforeYear(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isEqual(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isSameDay(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isSameMonth(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isSameYear(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isSameHour(date: PlainDateTime, comparing: PlainDateTime): boolean;
+  isWithinRange(date: PlainDateTime, [start, end]: [PlainDateTime, PlainDateTime]): boolean;
+  getYear(date: PlainDateTime): number;
+  getMonth(date: PlainDateTime): number;
+  getDate(date: PlainDateTime): number;
+  getHours(date: PlainDateTime): number;
+  getMinutes(date: PlainDateTime): number;
+  getSeconds(date: PlainDateTime): number;
+  getDiff(date: PlainDateTime, comparing: PlainDateTime | string, unit?: string): number;
+  getWeek(date: PlainDateTime, firstDayOfWeek?: number, minimalDays?: number): number;
+  getDaysInMonth(date: PlainDateTime): number;
+  setYear(date: PlainDateTime, year: number): PlainDateTime;
+  setMonth(date: PlainDateTime, month: number): PlainDateTime;
+  setDate(date: PlainDateTime, day: number): PlainDateTime;
+  setHours(date: PlainDateTime, hours: number): PlainDateTime;
+  setMinutes(date: PlainDateTime, minutes: number): PlainDateTime;
+  setSeconds(date: PlainDateTime, seconds: number): PlainDateTime;
+  getWeekdays(firstDayOfWeek?: number, format?: 'long' | 'short' | 'narrow'): string[];
+  getWeekArray(date: PlainDateTime, firstDayOfWeek?: number): PlainDateTime[][];
+  getMonthArray(date: PlainDateTime): PlainDateTime[];
+  getYearRange(start: PlainDateTime, end: PlainDateTime): PlainDateTime[];
+  getNextMonth(date: PlainDateTime): PlainDateTime;
+  getPreviousMonth(date: PlainDateTime): PlainDateTime;
+  mergeDateAndTime(date: PlainDateTime, time: PlainDateTime): PlainDateTime;
+  /**
+   * Gets a cached Intl.DateTimeFormat instance or creates one if not cached.
+   * Cache is limited to MAX_CACHE_SIZE entries to prevent memory leaks.
+   */
+  private getFormatter;
+  /**
+   * Gets a cached Intl.NumberFormat instance or creates one if not cached.
+   * Cache is limited to MAX_CACHE_SIZE entries to prevent memory leaks.
+   */
+  private getNumberFormatter;
+}
+//#endregion
+//#region src/composables/useDate/index.d.ts
+/** The default date type when using Vuetify0DateAdapter */
+type DefaultDateType = Temporal.PlainDateTime;
+interface DateContext<Z = DefaultDateType> {
+  /** The date adapter instance */
+  adapter: DateAdapter<Z>;
+  /** Current locale (reactive, synced with useLocale if available) */
+  locale: ComputedRef<string | undefined>;
+}
+/** Options for date composables */
+interface DateOptions<Z = DefaultDateType> {
+  /** Custom date adapter instance (defaults to Vuetify0DateAdapter) */
+  adapter?: DateAdapter<Z>;
+  /** Locale for formatting (defaults to useLocale's selected locale or 'en-US') */
+  locale?: string;
+  /** Short locale codes mapped to full Intl locale strings (e.g., { en: 'en-US' }) */
+  locales?: Record<string, string>;
+}
+/** Context options with namespace */
+interface DateContextOptions<Z = DefaultDateType> extends DateOptions<Z> {
+  namespace?: string;
+}
+/** Plugin options */
+interface DatePluginOptions<Z = DefaultDateType> extends DateContextOptions<Z> {}
+/**
+ * Creates a new date context.
+ *
+ * @param options Optional adapter and locale configuration.
+ * @template E The date context type.
+ * @returns A date context.
+ *
+ * @see https://0.vuetifyjs.com/composables/plugins/use-date
+ *
+ * @example
+ * ```ts
+ * const { adapter } = createDate()
+ * const today = adapter.date() // Temporal.PlainDateTime
+ *
+ * // With locale options
+ * const { adapter: deAdapter } = createDate({ locale: 'de-DE' })
+ *
+ * // With custom adapter
+ * const { adapter } = createDate({ adapter: new DateFnsAdapter() })
+ * ```
+ */
+declare function createDate<Z = DefaultDateType, E extends DateContext<Z> = DateContext<Z>>(options?: DateOptions<Z>): E;
+/**
+ * Creates a fallback date context for when useDate is called outside of a Vue component.
+ *
+ * @returns A fallback date context with Vuetify0DateAdapter.
+ * @internal
+ */
+declare function createDateFallback(): DateContext<DefaultDateType>;
+/**
+ * Creates a new date context trinity.
+ *
+ * @param options Optional adapter, locale, and namespace configuration.
+ * @template E The date context type.
+ * @returns A trinity [useContext, provideContext, defaultContext].
+ *
+ * @see https://0.vuetifyjs.com/composables/plugins/use-date
+ *
+ * @example
+ * ```ts
+ * const [useAppDate, provideAppDate] = createDateContext({
+ *   namespace: 'app:date',
+ * })
+ *
+ * // With custom adapter
+ * const [useAppDate, provideAppDate] = createDateContext({
+ *   adapter: new DateFnsAdapter(),
+ *   namespace: 'app:date',
+ * })
+ * ```
+ */
+declare function createDateContext<Z = DefaultDateType, E extends DateContext<Z> = DateContext<Z>>(options?: DateContextOptions<Z>): ContextTrinity<E>;
+/**
+ * Creates a new date plugin.
+ *
+ * @param options Optional adapter, locale, and namespace configuration.
+ * @template E The date context type.
+ * @returns A Vue plugin.
+ *
+ * @see https://0.vuetifyjs.com/composables/plugins/use-date
+ *
+ * @example
+ * ```ts
+ * const app = createApp(App)
+ * app.use(createDatePlugin())
+ *
+ * // With options
+ * app.use(createDatePlugin({ locale: 'de-DE' }))
+ *
+ * // With custom adapter
+ * app.use(createDatePlugin({ adapter: new DateFnsAdapter() }))
+ * ```
+ */
+declare function createDatePlugin<Z = DefaultDateType, E extends DateContext<Z> = DateContext<Z>>(options?: DatePluginOptions<Z>): Plugin;
+/**
+ * Returns the current date context.
+ *
+ * When called inside a component with a provided date context (via plugin or provider),
+ * returns that context. Otherwise, returns a fallback context with Vuetify0DateAdapter.
+ *
+ * @param namespace The namespace to look up (defaults to 'v0:date').
+ * @template E The date context type.
+ * @returns The current date context.
+ *
+ * @see https://0.vuetifyjs.com/composables/plugins/use-date
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { useDate } from '@vuetify/v0'
+ *
+ * const { adapter, locale } = useDate()
+ * const today = adapter.date()
+ * </script>
+ * ```
+ */
+declare function useDate<Z = DefaultDateType, E extends DateContext<Z> = DateContext<Z>>(namespace?: string): E;
+//#endregion
 //#region src/composables/useEventListener/index.d.ts
 type CleanupFunction = () => void;
 type EventHandler<E = Event> = (event: E) => void;
@@ -533,7 +868,7 @@ declare function useWindowEventListener<E extends keyof WindowEventMap>(event: M
  */
 declare function useDocumentEventListener<E extends keyof DocumentEventMap>(event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Document, event: DocumentEventMap[E]) => void>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
 //#endregion
-//#region src/composables/useTokens/index.d.ts
+//#region src/composables/createTokens/index.d.ts
 interface TokenAlias<T = unknown> {
   [key: string]: unknown;
   $value: T;
@@ -560,11 +895,11 @@ interface TokenContext<Z extends TokenTicket> extends RegistryContext<Z> {
    * @returns True if the token is an alias, false otherwise.
    * @remarks An alias is a string that starts with "{" and ends with "}".
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-tokens#is-alias
+   * @see https://0.vuetifyjs.com/composables/registration/create-tokens#is-alias
    *
    * @example
    * ```ts
-   * const tokens = useTokens({
+   * const tokens = createTokens({
    *   colors: {
    *     primary: '#3b82f6',
    *     secondary: '{colors.primary}', // Alias reference
@@ -583,11 +918,11 @@ interface TokenContext<Z extends TokenTicket> extends RegistryContext<Z> {
    * @returns The resolved value of the token or alias, or undefined if not found.
    * @remarks This function can resolve nested aliases and supports token paths using dot notation.
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-tokens#resolve
+   * @see https://0.vuetifyjs.com/composables/registration/create-tokens#resolve
    *
    * @example
    * ```ts
-   * const tokens = useTokens({
+   * const tokens = createTokens({
    *   colors: {
    *     primary: '#3b82f6',
    *     secondary: '{colors.primary}', // Alias reference
@@ -627,13 +962,13 @@ interface TokenContextOptions extends TokenOptions, RegistryContextOptions {
  * @returns A new token instance.
  *
  * @see https://www.designtokens.org/tr/drafts/format/
- * @see https://0.vuetifyjs.com/composables/registration/use-tokens
+ * @see https://0.vuetifyjs.com/composables/registration/create-tokens
  *
  * @example
  * ```ts
- * import { useTokens } from '@vuetify/v0'
+ * import { createTokens } from '@vuetify/v0'
  *
- * const tokens = useTokens({
+ * const tokens = createTokens({
  *   colors: {
  *     primary: '#3b82f6',
  *     secondary: '{colors.primary}', // Alias reference
@@ -654,7 +989,7 @@ declare function createTokens<Z extends TokenTicket = TokenTicket, E extends Tok
  * @template E The type of the token context.
  * @returns A new token context.
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-tokens
+ * @see https://0.vuetifyjs.com/composables/registration/create-tokens
  *
  * @example
  * ```ts
@@ -678,7 +1013,7 @@ declare function createTokensContext<Z extends TokenTicket = TokenTicket, E exte
  * @param namespace The namespace for the tokens context. Defaults to `'v0:tokens'`.
  * @returns The current tokens instance.
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-tokens
+ * @see https://0.vuetifyjs.com/composables/registration/create-tokens
  *
  * @example
  * ```vue
@@ -947,7 +1282,7 @@ declare function useFilter<Z extends FilterItem>(query: FilterQuery, items: Mayb
  */
 declare function useFilterContext<Z extends FilterItem = FilterItem, E extends FilterContext<Z> = FilterContext<Z>>(namespace?: string): E;
 //#endregion
-//#region src/composables/useForm/index.d.ts
+//#region src/composables/createForm/index.d.ts
 type FormValidationResult = string | true | Promise<string | true>;
 type FormValidationRule = (value: unknown) => FormValidationResult;
 type FormValue = Ref<unknown> | ShallowRef<unknown>;
@@ -984,7 +1319,7 @@ interface FormContextOptions extends RegistryOptions {
  * @template E The type of the form context.
  * @returns A new form instance.
  *
- * @see https://0.vuetifyjs.com/composables/forms/use-form
+ * @see https://0.vuetifyjs.com/composables/forms/create-form
  *
  * @example
  * ```ts
@@ -1014,7 +1349,7 @@ declare function createForm<Z extends FormTicket = FormTicket, E extends FormCon
  * @template E The type of the form context.
  * @returns A new form context.
  *
- * @see https://0.vuetifyjs.com/composables/forms/use-form
+ * @see https://0.vuetifyjs.com/composables/forms/create-form
  *
  * @example
  * ```ts
@@ -1044,7 +1379,7 @@ declare function createFormContext<Z extends FormTicket = FormTicket, E extends
  * @param namespace The namespace for the form context. Defaults to `'v0:form'`.
  * @returns The current form instance.
  *
- * @see https://0.vuetifyjs.com/composables/forms/use-form
+ * @see https://0.vuetifyjs.com/composables/forms/create-form
  *
  * @example
  * ```vue
@@ -1369,6 +1704,78 @@ interface UseElementIntersectionReturn extends UseIntersectionObserverReturn {
  */
 declare function useElementIntersection(target: MaybeRef$1<Element | null | undefined>, options?: IntersectionObserverOptions): UseElementIntersectionReturn;
 //#endregion
+//#region src/composables/useLazy/index.d.ts
+interface LazyOptions {
+  /**
+   * When true, content renders immediately without waiting for activation.
+   * @default false
+   */
+  eager?: MaybeRefOrGetter<boolean>;
+}
+interface LazyContext {
+  /**
+   * Whether the lazy content has been activated at least once.
+   */
+  readonly isBooted: Readonly<ShallowRef<boolean>>;
+  /**
+   * Whether content should be rendered.
+   * True when: isBooted OR eager OR active
+   */
+  readonly hasContent: Readonly<Ref<boolean>>;
+  /**
+   * Reset booted state. Call on leave transition if not eager.
+   */
+  reset: () => void;
+  /**
+   * Transition callback for after-leave. Resets if not eager.
+   */
+  onAfterLeave: () => void;
+}
+/**
+ * Deferred content rendering for performance optimization.
+ *
+ * @param active Reactive boolean controlling activation state
+ * @param options Configuration options
+ * @returns Lazy context with state refs and control functions
+ *
+ * @see https://0.vuetifyjs.com/composables/system/use-lazy
+ *
+ * @example
+ * ```ts
+ * import { ref } from 'vue'
+ * import { useLazy } from '@vuetify/v0'
+ *
+ * const isOpen = ref(false)
+ * const { hasContent, onAfterLeave } = useLazy(isOpen)
+ *
+ * // In template:
+ * // <Transition @after-leave="onAfterLeave">
+ * //   <div v-if="isOpen">
+ * //     <template v-if="hasContent">
+ * //       <!-- Heavy content here -->
+ * //     </template>
+ * //   </div>
+ * // </Transition>
+ * ```
+ *
+ * @example
+ * Eager mode (render immediately):
+ * ```ts
+ * const { hasContent } = useLazy(isOpen, { eager: true })
+ * // hasContent.value is always true
+ * ```
+ *
+ * @example
+ * With reactive eager prop:
+ * ```ts
+ * const props = defineProps<{ eager: boolean }>()
+ * const { hasContent } = useLazy(isOpen, {
+ *   eager: toRef(() => props.eager),
+ * })
+ * ```
+ */
+declare function useLazy(active: MaybeRefOrGetter<boolean>, options?: LazyOptions): LazyContext;
+//#endregion
 //#region src/composables/useLocale/adapters/adapter.d.ts
 interface LocaleAdapter {
   t: (message: string, ...params: unknown[]) => string;
@@ -1841,15 +2248,16 @@ interface UseMutationObserverReturn {
  * resume()
  * ```
  */
-declare function useMutationObserver(target: Ref<Element | undefined>, callback: (entries: MutationObserverRecord[]) => void, options?: UseMutationObserverOptions): UseMutationObserverReturn;
+declare function useMutationObserver(target: Ref<Element | null | undefined>, callback: (entries: MutationObserverRecord[]) => void, options?: UseMutationObserverOptions): UseMutationObserverReturn;
 //#endregion
 //#region src/composables/useOverflow/index.d.ts
 interface OverflowOptions {
   /**
    * Container element to track. Can be a ref, getter, or MaybeRefOrGetter.
    * When provided, useOverflow tracks this element's width automatically.
+   * Accepts null for compatibility with Vue's useTemplateRef.
    */
-  container?: MaybeRefOrGetter<Element | undefined>;
+  container?: MaybeRefOrGetter<Element | null | undefined>;
   /** Gap between items in pixels */
   gap?: MaybeRefOrGetter<number>;
   /** Reserved space in pixels (for nav buttons, ellipsis, etc) */
@@ -1869,7 +2277,7 @@ interface OverflowOptions {
 }
 interface OverflowContext {
   /** Container element ref */
-  container: ShallowRef<Element | undefined>;
+  container: ShallowRef<Element | null | undefined>;
   /** Current container width */
   width: Readonly<ShallowRef<number>>;
   /** How many items fit in available space */
@@ -1935,7 +2343,8 @@ declare function createOverflow<E extends OverflowContext = OverflowContext>(opt
  * Creates an overflow context with dependency injection support.
  *
  * @param options Configuration options including namespace
- * @returns Trinity tuple: [useContext, provideContext, defaultContext]
+ * @template E The type of the overflow context
+ * @returns Trinity tuple: [useOverflow, provideOverflow, defaultOverflow]
  *
  * @example
  * ```ts
@@ -1958,8 +2367,11 @@ declare function createOverflowContext<E extends OverflowContext = OverflowConte
  * Returns the current overflow context from dependency injection.
  *
  * @param namespace The namespace for the overflow context. Defaults to `v0:overflow`.
+ * @template E The type of the overflow context
  * @returns The current overflow context.
  *
+ * @throws An error if the overflow context is not found and no default is provided.
+ *
  * @example
  * ```vue
  * <script lang="ts" setup>
@@ -2169,7 +2581,7 @@ interface ProxyRegistryContext<Z extends RegistryTicket = RegistryTicket> {
  */
 declare function useProxyRegistry<Z extends RegistryTicket = RegistryTicket>(registry: RegistryContext<Z>, options?: ProxyRegistryOptions): ProxyRegistryContext<Z>;
 //#endregion
-//#region src/composables/useQueue/index.d.ts
+//#region src/composables/createQueue/index.d.ts
 interface QueueTicket<V = unknown> extends RegistryTicket<V> {
   /**
    * Timeout in milliseconds
@@ -2209,7 +2621,7 @@ interface QueueContext<Z extends QueueTicket = QueueTicket> extends RegistryCont
    * - Subsequent tickets are paused until they become first in queue
    * - Each ticket receives a `dismiss()` method for convenience
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-queue#register
+   * @see https://0.vuetifyjs.com/composables/registration/create-queue#register
    *
    * @example
    * ```ts
@@ -2237,7 +2649,7 @@ interface QueueContext<Z extends QueueTicket = QueueTicket> extends RegistryCont
    * - If the removed ticket was first in queue, automatically resumes the next ticket
    * - Returns the unregistered ticket or `undefined` if not found
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-queue#unregister
+   * @see https://0.vuetifyjs.com/composables/registration/create-queue#unregister
    *
    * @example
    * ```ts
@@ -2265,7 +2677,7 @@ interface QueueContext<Z extends QueueTicket = QueueTicket> extends RegistryCont
    * - Returns the paused ticket or `undefined` if no pausable ticket exists
    * - The timeout will not progress while paused
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-queue#pause
+   * @see https://0.vuetifyjs.com/composables/registration/create-queue#pause
    *
    * @example
    * ```ts
@@ -2290,7 +2702,7 @@ interface QueueContext<Z extends QueueTicket = QueueTicket> extends RegistryCont
    * - Returns the resumed ticket or `undefined` if no resumable ticket exists
    * - The timeout will continue from its full duration (not from where it was paused)
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-queue#resume
+   * @see https://0.vuetifyjs.com/composables/registration/create-queue#resume
    *
    * @example
    * ```ts
@@ -2316,7 +2728,7 @@ interface QueueContext<Z extends QueueTicket = QueueTicket> extends RegistryCont
    * - Clears all active timeouts
    * - Resets the queue to an empty state
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-queue#clear
+   * @see https://0.vuetifyjs.com/composables/registration/create-queue#clear
    *
    * @example
    * ```ts
@@ -2344,7 +2756,7 @@ interface QueueContext<Z extends QueueTicket = QueueTicket> extends RegistryCont
    * - Should be called when the queue is no longer needed
    * - Automatically called on scope disposal
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-queue#dispose
+   * @see https://0.vuetifyjs.com/composables/registration/create-queue#dispose
    *
    * @example
    * ```ts
@@ -2384,7 +2796,7 @@ interface QueueContextOptions extends QueueOptions {
  * @template E The type of queue context that extends QueueContext<Z>. Use this when extending the queue with additional methods.
  * @returns A new queue instance
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-queue
+ * @see https://0.vuetifyjs.com/composables/registration/create-queue
  *
  * @example
  * ```ts
@@ -2416,7 +2828,7 @@ declare function createQueue<Z extends QueueTicket = QueueTicket, E extends Queu
  * @template E The type of the queue context.
  * @returns A new queue context.
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-queue
+ * @see https://0.vuetifyjs.com/composables/registration/create-queue
  *
  * @example
  * ```ts
@@ -2434,7 +2846,7 @@ declare function createQueueContext<Z extends QueueTicket = QueueTicket, E exten
  * @param namespace The namespace for the queue context. Defaults to `'v0:queue'`.
  * @returns The current queue instance.
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-queue
+ * @see https://0.vuetifyjs.com/composables/registration/create-queue
  *
  * @example
  * ```vue
@@ -2525,7 +2937,7 @@ interface UseResizeObserverReturn {
  * resume()
  * ```
  */
-declare function useResizeObserver(target: Ref<Element | undefined>, callback: (entries: ResizeObserverEntry[]) => void, options?: ResizeObserverOptions): UseResizeObserverReturn;
+declare function useResizeObserver(target: Ref<Element | null | undefined>, callback: (entries: ResizeObserverEntry[]) => void, options?: ResizeObserverOptions): UseResizeObserverReturn;
 interface UseElementSizeReturn extends UseResizeObserverReturn {
   /**
    * The width of the element in pixels
@@ -2559,7 +2971,7 @@ interface UseElementSizeReturn extends UseResizeObserverReturn {
  * })
  * ```
  */
-declare function useElementSize(target: Ref<Element | undefined>): UseElementSizeReturn;
+declare function useElementSize(target: Ref<Element | null | undefined>): UseElementSizeReturn;
 //#endregion
 //#region src/composables/useStorage/adapters/adapter.d.ts
 interface StorageAdapter$1 {
@@ -2982,14 +3394,14 @@ declare function createThemePlugin<Z extends ThemeTicket = ThemeTicket, E extend
  */
 declare function useTheme<Z extends ThemeTicket = ThemeTicket, E extends ThemeContext<Z> = ThemeContext<Z>>(namespace?: string): E;
 //#endregion
-//#region src/composables/useTimeline/index.d.ts
+//#region src/composables/createTimeline/index.d.ts
 interface TimelineContext<Z extends TimelineTicket> extends RegistryContext<Z> {
   /**
    * Removes the last registered ticket and stores it for redo
    *
    * @return The removed ticket, or undefined if there are no tickets to undo.
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-timeline#undo
+   * @see https://0.vuetifyjs.com/composables/registration/create-timeline#undo
    *
    * @example
    * ```ts
@@ -3012,7 +3424,7 @@ interface TimelineContext<Z extends TimelineTicket> extends RegistryContext<Z> {
    *
    * @returns The restored ticket, or undefined if there are no tickets to redo.
    *
-   * @see https://0.vuetifyjs.com/composables/registration/use-timeline#redo
+   * @see https://0.vuetifyjs.com/composables/registration/create-timeline#redo
    *
    * @example
    * ```ts
@@ -3054,7 +3466,7 @@ interface TimelineContextOptions extends TimelineOptions {
  * @template E The type of the timeline context.
  * @returns A new timeline instance.
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-timeline
+ * @see https://0.vuetifyjs.com/composables/registration/create-timeline
  *
  * @example
  * ```ts
@@ -3082,7 +3494,7 @@ declare function createTimeline<Z extends TimelineTicket = TimelineTicket, E ext
  * @template E The type of the timeline context.
  * @returns A new timeline context.
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-timeline
+ * @see https://0.vuetifyjs.com/composables/registration/create-timeline
  *
  * @example
  * ```ts
@@ -3109,7 +3521,7 @@ declare function createTimelineContext<Z extends TimelineTicket = TimelineTicket
  * @param namespace The namespace for the timeline context. Defaults to `'v0:timeline'`.
  * @returns The current timeline instance.
  *
- * @see https://0.vuetifyjs.com/composables/registration/use-timeline
+ * @see https://0.vuetifyjs.com/composables/registration/create-timeline
  *
  * @example
  * ```vue
@@ -3490,4 +3902,4 @@ interface VirtualContext<T = unknown> {
  */
 declare function useVirtual<T = unknown>(items: Ref<readonly T[]>, _options?: VirtualOptions): VirtualContext<T>;
 //#endregion
-export { createQueue as $, createFeatures as $n, createLocaleContext as $t, Vuetify0ThemeAdapter as A, FormValidationRule as An, BreakpointsPluginOptions as Ar, usePrefersContrast as At, StorageAdapter as B, FilterOptions as Bn, ContextKey as Br, useLogger as Bt, ThemePluginOptions as C, UseHotkeyReturn as Cn, UseClickOutsideOptions as Cr, useOverflow as Ct, createThemeContext as D, FormOptions as Dn, BreakpointsContext as Dr, useMutationObserver as Dt, createTheme as E, FormContextOptions as En, BreakpointName as Er, UseMutationObserverReturn as Et, StoragePluginOptions as F, FilterContext as Fn, toReactive as Fr, LoggerOptions as Ft, UseElementSizeReturn as G, createFilterContext as Gn, LoggerAdapter as Gt, MemoryAdapter as H, FilterResult as Hn, createContext as Hr, Vuetify0LoggerAdapter as Ht, createStorage as I, FilterContextOptions as In, toArray as Ir, LoggerPluginOptions as It, useResizeObserver as J, FeatureContext as Jn, LocaleOptions as Jt, UseResizeObserverReturn as K, useFilter as Kn, LocaleContext as Kt, createStorageContext as L, FilterFunction as Ln, Plugin as Lr, createLogger as Lt, StorageContext as M, createForm as Mn, createBreakpointsContext as Mr, usePrefersReducedMotion as Mt, StorageContextOptions as N, createFormContext as Nn, createBreakpointsPlugin as Nr, LoggerContext as Nt, createThemePlugin as O, FormTicket as On, BreakpointsContextOptions as Or, MediaQueryContext as Ot, StorageOptions as P, useForm as Pn, useBreakpoints as Pr, LoggerContextOptions as Pt, QueueTicket as Q, FeatureTicket as Qn, createLocale as Qt, createStoragePlugin as R, FilterItem as Rn, PluginOptions as Rr, createLoggerContext as Rt, ThemeOptions as S, UseHotkeyOptions as Sn, ClickOutsideTarget as Sr, createOverflowContext as St, ThemeTicket as T, FormContext as Tn, useClickOutside as Tr, UseMutationObserverOptions as Tt, ResizeObserverEntry as U, Primitive as Un, provideContext as Ur, PinoLoggerAdapter as Ut, StorageType as V, FilterQuery as Vn, CreateContextOptions as Vr, LogLevel as Vt, ResizeObserverOptions as W, createFilter as Wn, useContext as Wr, ConsolaLoggerAdapter as Wt, QueueContextOptions as X, FeatureOptions as Xn, LocaleRecord as Xt, QueueContext as Y, FeatureContextOptions as Yn, LocalePluginOptions as Yt, QueueOptions as Z, FeaturePluginOptions as Zn, LocaleTicket as Zt, useTimeline as _, createHydration as _n, useDocumentEventListener as _r, PermissionAdapterInterface as _t, VirtualItem as a, IntersectionObserverEntry as an, TokenCollection as ar, ProxyModelOptions as at, ThemeContext as b, useHydration as bn, ClickOutsideElement as br, OverflowOptions as bt, useVirtual as c, UseElementIntersectionReturn as cn, TokenOptions as cr, PermissionContextOptions as ct, TimelineContext as d, useIntersectionObserver as dn, TokenValue as dr, PermissionTicket as dt, createLocaleFallback as en, createFeaturesContext as er, createQueueContext as et, TimelineContextOptions as f, HydrationContext as fn, createTokens as fr, createPermissions as ft, createTimelineContext as g, createFallbackHydration as gn, EventHandler as gr, PermissionAdapter as gt, createTimeline as h, HydrationPluginOptions as hn, CleanupFunction as hr, usePermissions as ht, VirtualDirection as i, LocaleAdapter as in, TokenAlias as ir, useProxyRegistry as it, ThemeAdapter as j, FormValue as jn, createBreakpoints as jr, usePrefersDark as jt, useTheme as k, FormValidationResult as kn, BreakpointsOptions as kr, useMediaQuery as kt, ToggleScopeControls as l, UseIntersectionObserverReturn as ln, TokenPrimitive as lr, PermissionOptions as lt, TimelineTicket as m, HydrationOptions as mn, useTokens as mr, createPermissionsPlugin as mt, VirtualAnchor as n, useLocale as nn, useFeatures as nr, ProxyRegistryContext as nt, VirtualOptions as o, IntersectionObserverOptions as on, TokenContext as or, useProxyModel as ot, TimelineOptions as p, HydrationContextOptions as pn, createTokensContext as pr, createPermissionsContext as pt, useElementSize as q, useFilterContext as qn, LocaleContextOptions as qt, VirtualContext as r, Vuetify0LocaleAdapter as rn, FlatTokenCollection as rr, ProxyRegistryOptions as rt, VirtualState as s, MaybeRef$1 as sn, TokenContextOptions as sr, PermissionContext as st, ScrollToOptions as t, createLocalePlugin as tn, createFeaturesPlugin as tr, useQueue as tt, useToggleScope as u, useElementIntersection as un, TokenTicket as ur, PermissionPluginOptions as ut, Colors as v, createHydrationContext as vn, useEventListener as vr, OverflowContext as vt, ThemeRecord as w, useHotkey as wn, UseClickOutsideReturn as wr, MutationObserverRecord as wt, ThemeContextOptions as x, PlatformContext as xn, ClickOutsideIgnoreTarget as xr, createOverflow as xt, ThemeColors as y, createHydrationPlugin as yn, useWindowEventListener as yr, OverflowContextOptions as yt, useStorage as z, FilterMode as zn, createPlugin as zr, createLoggerPlugin as zt };
+export { createQueue as $, FeatureOptions as $n, createPlugin as $r, createLocaleContext as $t, Vuetify0ThemeAdapter as A, FormOptions as An, createDatePlugin as Ar, usePrefersContrast as At, StorageAdapter as B, FilterFunction as Bn, BreakpointName as Br, useLogger as Bt, ThemePluginOptions as C, useHydration as Cn, DateContext as Cr, useOverflow as Ct, createThemeContext as D, useHotkey as Dn, createDate as Dr, useMutationObserver as Dt, createTheme as E, UseHotkeyReturn as En, DatePluginOptions as Er, UseMutationObserverReturn as Et, StoragePluginOptions as F, createForm as Fn, ClickOutsideIgnoreTarget as Fr, LoggerOptions as Ft, UseElementSizeReturn as G, FilterResult as Gn, createBreakpoints as Gr, LoggerAdapter as Gt, MemoryAdapter as H, FilterMode as Hn, BreakpointsContextOptions as Hr, Vuetify0LoggerAdapter as Ht, createStorage as I, createFormContext as In, ClickOutsideTarget as Ir, LoggerPluginOptions as It, useResizeObserver as J, createFilterContext as Jn, useBreakpoints as Jr, LocaleOptions as Jt, UseResizeObserverReturn as K, Primitive as Kn, createBreakpointsContext as Kr, LocaleContext as Kt, createStorageContext as L, useForm as Ln, UseClickOutsideOptions as Lr, createLogger as Lt, StorageContext as M, FormValidationResult as Mn, Vuetify0DateAdapter as Mr, usePrefersReducedMotion as Mt, StorageContextOptions as N, FormValidationRule as Nn, DateAdapter as Nr, LoggerContext as Nt, createThemePlugin as O, FormContext as On, createDateContext as Or, MediaQueryContext as Ot, StorageOptions as P, FormValue as Pn, ClickOutsideElement as Pr, LoggerContextOptions as Pt, QueueTicket as Q, FeatureContextOptions as Qn, PluginOptions as Qr, createLocale as Qt, createStoragePlugin as R, FilterContext as Rn, UseClickOutsideReturn as Rr, createLoggerContext as Rt, ThemeOptions as S, createHydrationPlugin as Sn, useWindowEventListener as Sr, createOverflowContext as St, ThemeTicket as T, UseHotkeyOptions as Tn, DateOptions as Tr, UseMutationObserverOptions as Tt, ResizeObserverEntry as U, FilterOptions as Un, BreakpointsOptions as Ur, PinoLoggerAdapter as Ut, StorageType as V, FilterItem as Vn, BreakpointsContext as Vr, LogLevel as Vt, ResizeObserverOptions as W, FilterQuery as Wn, BreakpointsPluginOptions as Wr, ConsolaLoggerAdapter as Wt, QueueContextOptions as X, useFilterContext as Xn, toArray as Xr, LocaleRecord as Xt, QueueContext as Y, useFilter as Yn, toReactive as Yr, LocalePluginOptions as Yt, QueueOptions as Z, FeatureContext as Zn, Plugin as Zr, LocaleTicket as Zt, useTimeline as _, HydrationOptions as _n, useTokens as _r, PermissionAdapterInterface as _t, VirtualItem as a, LazyContext as an, useFeatures as ar, ProxyModelOptions as at, ThemeContext as b, createHydration as bn, useDocumentEventListener as br, OverflowOptions as bt, useVirtual as c, IntersectionObserverEntry as cn, TokenCollection as cr, PermissionContextOptions as ct, TimelineContext as d, UseElementIntersectionReturn as dn, TokenOptions as dr, PermissionTicket as dt, ContextKey as ei, createLocaleFallback as en, FeaturePluginOptions as er, createQueueContext as et, TimelineContextOptions as f, UseIntersectionObserverReturn as fn, TokenPrimitive as fr, createPermissions as ft, createTimelineContext as g, HydrationContextOptions as gn, createTokensContext as gr, PermissionAdapter as gt, createTimeline as h, HydrationContext as hn, createTokens as hr, usePermissions as ht, VirtualDirection as i, useContext as ii, LocaleAdapter as in, createFeaturesPlugin as ir, useProxyRegistry as it, ThemeAdapter as j, FormTicket as jn, useDate as jr, usePrefersDark as jt, useTheme as k, FormContextOptions as kn, createDateFallback as kr, useMediaQuery as kt, ToggleScopeControls as l, IntersectionObserverOptions as ln, TokenContext as lr, PermissionOptions as lt, TimelineTicket as m, useIntersectionObserver as mn, TokenValue as mr, createPermissionsPlugin as mt, VirtualAnchor as n, createContext as ni, useLocale as nn, createFeatures as nr, ProxyRegistryContext as nt, VirtualOptions as o, LazyOptions as on, FlatTokenCollection as or, useProxyModel as ot, TimelineOptions as p, useElementIntersection as pn, TokenTicket as pr, createPermissionsContext as pt, useElementSize as q, createFilter as qn, createBreakpointsPlugin as qr, LocaleContextOptions as qt, VirtualContext as r, provideContext as ri, Vuetify0LocaleAdapter as rn, createFeaturesContext as rr, ProxyRegistryOptions as rt, VirtualState as s, useLazy as sn, TokenAlias as sr, PermissionContext as st, ScrollToOptions as t, CreateContextOptions as ti, createLocalePlugin as tn, FeatureTicket as tr, useQueue as tt, useToggleScope as u, MaybeRef$1 as un, TokenContextOptions as ur, PermissionPluginOptions as ut, Colors as v, HydrationPluginOptions as vn, CleanupFunction as vr, OverflowContext as vt, ThemeRecord as w, PlatformContext as wn, DateContextOptions as wr, MutationObserverRecord as wt, ThemeContextOptions as x, createHydrationContext as xn, useEventListener as xr, createOverflow as xt, ThemeColors as y, createFallbackHydration as yn, EventHandler as yr, OverflowContextOptions as yt, useStorage as z, FilterContextOptions as zn, useClickOutside as zr, createLoggerPlugin as zt };