@vuetify/nightly 3.8.1-dev.2025-04-07 → 3.8.1-dev.2025-04-13

package/dist/vuetify.d.ts

@@ -132,11 +132,12 @@ type DeepPartial<T> = T extends object ? {
 } : T;
 type ThemeOptions = false | {
     cspNonce?: string;
-    defaultTheme?: string;
+    defaultTheme?: 'light' | 'dark' | 'system' | string;
     variations?: false | VariationsOptions;
     themes?: Record<string, ThemeDefinition>;
     stylesheetId?: string;
     scope?: string;
+    unimportant?: boolean;
 };
 type ThemeDefinition = DeepPartial<InternalThemeDefinition>;
 interface VariationsOptions {
@@ -173,11 +174,15 @@ interface OnColors {
     'on-info': string;
 }
 interface ThemeInstance {
+    change: (themeName: string) => void;
+    cycle: (themeArray?: string[]) => void;
+    toggle: (themeArray?: [string, string]) => void;
     readonly isDisabled: boolean;
     readonly themes: Ref<Record<string, InternalThemeDefinition>>;
     readonly name: Readonly<Ref<string>>;
     readonly current: DeepReadonly<Ref<InternalThemeDefinition>>;
     readonly computedThemes: DeepReadonly<Ref<Record<string, InternalThemeDefinition>>>;
+    readonly prefix: string;
     readonly themeClasses: Readonly<Ref<string | undefined>>;
     readonly styles: Readonly<Ref<string>>;
     readonly global: {
@@ -82943,40 +82948,40 @@ declare module 'vue' {
     $children?: VNodeChild
   }
   export interface GlobalComponents {
-    VApp: VApp
     VAppBar: VAppBar
     VAppBarNavIcon: VAppBarNavIcon
     VAppBarTitle: VAppBarTitle
-    VAvatar: VAvatar
+    VApp: VApp
+    VAutocomplete: VAutocomplete
     VAlert: VAlert
     VAlertTitle: VAlertTitle
-    VAutocomplete: VAutocomplete
+    VAvatar: VAvatar
     VBadge: VBadge
     VBanner: VBanner
     VBannerActions: VBannerActions
     VBannerText: VBannerText
+    VBtn: VBtn
     VBreadcrumbs: VBreadcrumbs
     VBreadcrumbsItem: VBreadcrumbsItem
     VBreadcrumbsDivider: VBreadcrumbsDivider
-    VBottomSheet: VBottomSheet
     VBottomNavigation: VBottomNavigation
     VBtnGroup: VBtnGroup
-    VBtn: VBtn
-    VCheckbox: VCheckbox
-    VCheckboxBtn: VCheckboxBtn
+    VBtnToggle: VBtnToggle
+    VCarousel: VCarousel
+    VCarouselItem: VCarouselItem
+    VBottomSheet: VBottomSheet
+    VChip: VChip
+    VColorPicker: VColorPicker
     VCard: VCard
     VCardActions: VCardActions
     VCardItem: VCardItem
     VCardSubtitle: VCardSubtitle
     VCardText: VCardText
     VCardTitle: VCardTitle
-    VBtnToggle: VBtnToggle
     VChipGroup: VChipGroup
-    VCarousel: VCarousel
-    VCarouselItem: VCarouselItem
-    VColorPicker: VColorPicker
-    VCode: VCode
     VCombobox: VCombobox
+    VCheckbox: VCheckbox
+    VCheckboxBtn: VCheckboxBtn
     VDataTable: VDataTable
     VDataTableHeaders: VDataTableHeaders
     VDataTableFooter: VDataTableFooter
@@ -82984,38 +82989,39 @@ declare module 'vue' {
     VDataTableRow: VDataTableRow
     VDataTableVirtual: VDataTableVirtual
     VDataTableServer: VDataTableServer
+    VCounter: VCounter
     VDatePicker: VDatePicker
     VDatePickerControls: VDatePickerControls
     VDatePickerHeader: VDatePickerHeader
     VDatePickerMonth: VDatePickerMonth
     VDatePickerMonths: VDatePickerMonths
     VDatePickerYears: VDatePickerYears
-    VCounter: VCounter
-    VChip: VChip
+    VDialog: VDialog
+    VCode: VCode
     VEmptyState: VEmptyState
+    VFab: VFab
     VDivider: VDivider
+    VIcon: VIcon
+    VComponentIcon: VComponentIcon
+    VSvgIcon: VSvgIcon
+    VLigatureIcon: VLigatureIcon
+    VClassIcon: VClassIcon
     VExpansionPanels: VExpansionPanels
     VExpansionPanel: VExpansionPanel
     VExpansionPanelText: VExpansionPanelText
     VExpansionPanelTitle: VExpansionPanelTitle
-    VDialog: VDialog
-    VFab: VFab
     VField: VField
     VFieldLabel: VFieldLabel
+    VInput: VInput
     VFooter: VFooter
+    VImg: VImg
     VFileInput: VFileInput
-    VIcon: VIcon
-    VComponentIcon: VComponentIcon
-    VSvgIcon: VSvgIcon
-    VLigatureIcon: VLigatureIcon
-    VClassIcon: VClassIcon
-    VInput: VInput
-    VLabel: VLabel
-    VInfiniteScroll: VInfiniteScroll
     VItemGroup: VItemGroup
     VItem: VItem
+    VInfiniteScroll: VInfiniteScroll
     VKbd: VKbd
-    VImg: VImg
+    VLabel: VLabel
+    VMenu: VMenu
     VList: VList
     VListGroup: VListGroup
     VListImg: VListImg
@@ -83026,65 +83032,64 @@ declare module 'vue' {
     VListItemTitle: VListItemTitle
     VListSubheader: VListSubheader
     VMain: VMain
+    VMessages: VMessages
     VNavigationDrawer: VNavigationDrawer
-    VMenu: VMenu
     VOtpInput: VOtpInput
     VOverlay: VOverlay
-    VMessages: VMessages
-    VNumberInput: VNumberInput
     VPagination: VPagination
-    VProgressLinear: VProgressLinear
-    VRadioGroup: VRadioGroup
+    VNumberInput: VNumberInput
     VProgressCircular: VProgressCircular
-    VSelect: VSelect
+    VRadioGroup: VRadioGroup
     VRating: VRating
-    VSelectionControl: VSelectionControl
+    VProgressLinear: VProgressLinear
     VSelectionControlGroup: VSelectionControlGroup
+    VSheet: VSheet
+    VSelectionControl: VSelectionControl
     VSlideGroup: VSlideGroup
     VSlideGroupItem: VSlideGroupItem
-    VSnackbar: VSnackbar
-    VSheet: VSheet
-    VSkeletonLoader: VSkeletonLoader
-    VSlider: VSlider
-    VSwitch: VSwitch
-    VTab: VTab
-    VTabs: VTabs
-    VTabsWindow: VTabsWindow
-    VTabsWindowItem: VTabsWindowItem
-    VSystemBar: VSystemBar
+    VSelect: VSelect
     VStepper: VStepper
     VStepperActions: VStepperActions
     VStepperHeader: VStepperHeader
     VStepperItem: VStepperItem
     VStepperWindow: VStepperWindow
     VStepperWindowItem: VStepperWindowItem
-    VTextarea: VTextarea
+    VSkeletonLoader: VSkeletonLoader
+    VSlider: VSlider
+    VSwitch: VSwitch
+    VSnackbar: VSnackbar
+    VSystemBar: VSystemBar
     VTable: VTable
+    VTextField: VTextField
+    VTextarea: VTextarea
+    VTab: VTab
+    VTabs: VTabs
+    VTabsWindow: VTabsWindow
+    VTabsWindowItem: VTabsWindowItem
     VToolbar: VToolbar
     VToolbarTitle: VToolbarTitle
     VToolbarItems: VToolbarItems
-    VTextField: VTextField
-    VTimeline: VTimeline
-    VTimelineItem: VTimelineItem
     VWindow: VWindow
     VWindowItem: VWindowItem
     VTooltip: VTooltip
+    VTimeline: VTimeline
+    VTimelineItem: VTimelineItem
     VConfirmEdit: VConfirmEdit
     VDataIterator: VDataIterator
     VDefaultsProvider: VDefaultsProvider
-    VForm: VForm
-    VHover: VHover
     VContainer: VContainer
     VCol: VCol
     VRow: VRow
     VSpacer: VSpacer
+    VForm: VForm
+    VHover: VHover
     VLayout: VLayout
     VLayoutItem: VLayoutItem
     VLazy: VLazy
-    VLocaleProvider: VLocaleProvider
     VNoSsr: VNoSsr
-    VParallax: VParallax
+    VLocaleProvider: VLocaleProvider
     VRadio: VRadio
+    VParallax: VParallax
     VRangeSlider: VRangeSlider
     VResponsive: VResponsive
     VSnackbarQueue: VSnackbarQueue
@@ -83109,26 +83114,26 @@ declare module 'vue' {
     VExpandTransition: VExpandTransition
     VExpandXTransition: VExpandXTransition
     VDialogTransition: VDialogTransition
-    VFileUpload: VFileUpload
-    VFileUploadItem: VFileUploadItem
     VStepperVertical: VStepperVertical
     VStepperVerticalItem: VStepperVerticalItem
     VStepperVerticalActions: VStepperVerticalActions
+    VPicker: VPicker
+    VPickerTitle: VPickerTitle
     VCalendar: VCalendar
     VCalendarDay: VCalendarDay
     VCalendarHeader: VCalendarHeader
     VCalendarInterval: VCalendarInterval
     VCalendarIntervalEvent: VCalendarIntervalEvent
     VCalendarMonthDay: VCalendarMonthDay
-    VIconBtn: VIconBtn
-    VPicker: VPicker
-    VPickerTitle: VPickerTitle
     VTimePicker: VTimePicker
     VTimePickerClock: VTimePickerClock
     VTimePickerControls: VTimePickerControls
+    VIconBtn: VIconBtn
     VTreeview: VTreeview
     VTreeviewItem: VTreeviewItem
     VTreeviewGroup: VTreeviewGroup
+    VFileUpload: VFileUpload
+    VFileUploadItem: VFileUploadItem
     VDateInput: VDateInput
     VPullToRefresh: VPullToRefresh
   }

package/dist/vuetify.esm.js

@@ -1,15 +1,16 @@
 /*!
-* Vuetify v3.8.1-dev.2025-04-07
+* Vuetify v3.8.1-dev.2025-04-13
 * Forged by John Leider
 * Released under the MIT License.
 */
 
-import { shallowRef, reactive, computed, watchEffect, toRefs, capitalize, unref, Fragment, isVNode, Comment, warn, getCurrentInstance as getCurrentInstance$1, ref, provide, inject as inject$1, defineComponent as defineComponent$1, h, camelize, createVNode, mergeProps, onBeforeUnmount, watch, readonly, onMounted, useId, onDeactivated, onActivated, onScopeDispose, effectScope, toRaw, TransitionGroup, Transition, isRef, toRef, onBeforeMount, nextTick, withDirectives, resolveDirective, vShow, onUpdated, Text, resolveDynamicComponent, toDisplayString, markRaw, Teleport, cloneVNode, createTextVNode, onUnmounted, onBeforeUpdate, withModifiers, vModelText, resolveComponent, render } from 'vue';
+import { shallowRef, reactive, computed, watchEffect, toRefs, capitalize, unref, Fragment, isVNode, Comment, warn, getCurrentInstance as getCurrentInstance$1, ref, provide, inject as inject$1, defineComponent as defineComponent$1, h, camelize, createVNode, mergeProps, onBeforeUnmount, watch, readonly, onMounted, useId, onDeactivated, onActivated, onScopeDispose, effectScope, toRaw, getCurrentScope, TransitionGroup, Transition, isRef, toRef, onBeforeMount, nextTick, withDirectives, resolveDirective, vShow, onUpdated, Text, resolveDynamicComponent, toDisplayString, markRaw, Teleport, cloneVNode, createTextVNode, onUnmounted, onBeforeUpdate, withModifiers, vModelText, resolveComponent, render } from 'vue';
 
 const IN_BROWSER = typeof window !== 'undefined';
 const SUPPORTS_INTERSECTION = IN_BROWSER && 'IntersectionObserver' in window;
 const SUPPORTS_TOUCH = IN_BROWSER && ('ontouchstart' in window || window.navigator.maxTouchPoints > 0);
 const SUPPORTS_EYE_DROPPER = IN_BROWSER && 'EyeDropper' in window;
+const SUPPORTS_MATCH_MEDIA = IN_BROWSER && 'matchMedia' in window && typeof window.matchMedia === 'function';
 
 function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
 function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
@@ -2754,6 +2755,7 @@ const makeThemeProps = propsFactory({
 function genDefaults$1() {
   return {
     defaultTheme: 'light',
+    prefix: 'v-',
     variations: {
       colors: [],
       lighten: 0,
@@ -2835,7 +2837,10 @@ function genDefaults$1() {
         }
       }
     },
-    stylesheetId: 'vuetify-theme-stylesheet'
+    stylesheetId: 'vuetify-theme-stylesheet',
+    scoped: false,
+    unimportant: false,
+    utilities: true
   };
 }
 function parseThemeOptions() {
@@ -2858,21 +2863,21 @@ function parseThemeOptions() {
 function createCssClass(lines, selector, content, scope) {
   lines.push(`${getScopedSelector(selector, scope)} {\n`, ...content.map(line => `  ${line};\n`), '}\n');
 }
-function genCssVariables(theme) {
+function genCssVariables(theme, prefix) {
   const lightOverlay = theme.dark ? 2 : 1;
   const darkOverlay = theme.dark ? 1 : 2;
   const variables = [];
   for (const [key, value] of Object.entries(theme.colors)) {
     const rgb = parseColor(value);
-    variables.push(`--v-theme-${key}: ${rgb.r},${rgb.g},${rgb.b}`);
+    variables.push(`--${prefix}theme-${key}: ${rgb.r},${rgb.g},${rgb.b}`);
     if (!key.startsWith('on-')) {
-      variables.push(`--v-theme-${key}-overlay-multiplier: ${getLuma(value) > 0.18 ? lightOverlay : darkOverlay}`);
+      variables.push(`--${prefix}theme-${key}-overlay-multiplier: ${getLuma(value) > 0.18 ? lightOverlay : darkOverlay}`);
     }
   }
   for (const [key, value] of Object.entries(theme.variables)) {
     const color = typeof value === 'string' && value.startsWith('#') ? parseColor(value) : undefined;
     const rgb = color ? `${color.r}, ${color.g}, ${color.b}` : undefined;
-    variables.push(`--v-${key}: ${rgb ?? value}`);
+    variables.push(`--${prefix}${key}: ${rgb ?? value}`);
   }
   return variables;
 }
@@ -2916,7 +2921,8 @@ function getScopedSelector(selector, scope) {
   const scopeSelector = `:where(${scope})`;
   return selector === ':root' ? scopeSelector : `${scopeSelector} ${selector}`;
 }
-function upsertStyles(styleEl, styles) {
+function upsertStyles(id, cspNonce, styles) {
+  const styleEl = getOrCreateStyleElement(id, cspNonce);
   if (!styleEl) return;
   styleEl.innerHTML = styles;
 }
@@ -2936,8 +2942,17 @@ function getOrCreateStyleElement(id, cspNonce) {
 // Composables
 function createTheme(options) {
   const parsedOptions = parseThemeOptions(options);
-  const name = shallowRef(parsedOptions.defaultTheme);
+  const _name = shallowRef(parsedOptions.defaultTheme);
   const themes = ref(parsedOptions.themes);
+  const systemName = shallowRef('light');
+  const name = computed({
+    get() {
+      return _name.value === 'system' ? systemName.value : _name.value;
+    },
+    set(val) {
+      _name.value = val;
+    }
+  });
   const computedThemes = computed(() => {
     const acc = {};
     for (const [name, original] of Object.entries(themes.value)) {
@@ -2958,28 +2973,49 @@ function createTheme(options) {
   const current = computed(() => computedThemes.value[name.value]);
   const styles = computed(() => {
     const lines = [];
+    const important = parsedOptions.unimportant ? '' : ' !important';
+    const scoped = parsedOptions.scoped ? parsedOptions.prefix : '';
     if (current.value?.dark) {
       createCssClass(lines, ':root', ['color-scheme: dark'], parsedOptions.scope);
     }
-    createCssClass(lines, ':root', genCssVariables(current.value), parsedOptions.scope);
+    createCssClass(lines, ':root', genCssVariables(current.value, parsedOptions.prefix), parsedOptions.scope);
     for (const [themeName, theme] of Object.entries(computedThemes.value)) {
-      createCssClass(lines, `.v-theme--${themeName}`, [`color-scheme: ${theme.dark ? 'dark' : 'normal'}`, ...genCssVariables(theme)], parsedOptions.scope);
-    }
-    const bgLines = [];
-    const fgLines = [];
-    const colors = new Set(Object.values(computedThemes.value).flatMap(theme => Object.keys(theme.colors)));
-    for (const key of colors) {
-      if (key.startsWith('on-')) {
-        createCssClass(fgLines, `.${key}`, [`color: rgb(var(--v-theme-${key})) !important`], parsedOptions.scope);
-      } else {
-        createCssClass(bgLines, `.bg-${key}`, [`--v-theme-overlay-multiplier: var(--v-theme-${key}-overlay-multiplier)`, `background-color: rgb(var(--v-theme-${key})) !important`, `color: rgb(var(--v-theme-on-${key})) !important`], parsedOptions.scope);
-        createCssClass(fgLines, `.text-${key}`, [`color: rgb(var(--v-theme-${key})) !important`], parsedOptions.scope);
-        createCssClass(fgLines, `.border-${key}`, [`--v-border-color: var(--v-theme-${key})`], parsedOptions.scope);
+      createCssClass(lines, `.${parsedOptions.prefix}theme--${themeName}`, [`color-scheme: ${theme.dark ? 'dark' : 'normal'}`, ...genCssVariables(theme, parsedOptions.prefix)], parsedOptions.scope);
+    }
+    if (parsedOptions.utilities) {
+      const bgLines = [];
+      const fgLines = [];
+      const colors = new Set(Object.values(computedThemes.value).flatMap(theme => Object.keys(theme.colors)));
+      for (const key of colors) {
+        if (key.startsWith('on-')) {
+          createCssClass(fgLines, `.${key}`, [`color: rgb(var(--${parsedOptions.prefix}theme-${key}))${important}`], parsedOptions.scope);
+        } else {
+          createCssClass(bgLines, `.${scoped}bg-${key}`, [`--${parsedOptions.prefix}theme-overlay-multiplier: var(--${parsedOptions.prefix}theme-${key}-overlay-multiplier)`, `background-color: rgb(var(--${parsedOptions.prefix}theme-${key}))${important}`, `color: rgb(var(--${parsedOptions.prefix}theme-on-${key}))${important}`], parsedOptions.scope);
+          createCssClass(fgLines, `.${scoped}text-${key}`, [`color: rgb(var(--${parsedOptions.prefix}theme-${key}))${important}`], parsedOptions.scope);
+          createCssClass(fgLines, `.${scoped}border-${key}`, [`--${parsedOptions.prefix}border-color: var(--${parsedOptions.prefix}theme-${key})`], parsedOptions.scope);
+        }
       }
+      lines.push(...bgLines, ...fgLines);
     }
-    lines.push(...bgLines, ...fgLines);
     return lines.map((str, i) => i === 0 ? str : `    ${str}`).join('');
   });
+  const themeClasses = computed(() => parsedOptions.isDisabled ? undefined : `${parsedOptions.prefix}theme--${name.value}`);
+  const themeNames = computed(() => Object.keys(computedThemes.value));
+  if (SUPPORTS_MATCH_MEDIA) {
+    const media = window.matchMedia('(prefers-color-scheme: dark)');
+    function updateSystemName() {
+      systemName.value = media.matches ? 'dark' : 'light';
+    }
+    updateSystemName();
+    media.addEventListener('change', updateSystemName, {
+      passive: true
+    });
+    if (getCurrentScope()) {
+      onScopeDispose(() => {
+        media.removeEventListener('change', updateSystemName);
+      });
+    }
+  }
   function install(app) {
     if (parsedOptions.isDisabled) return;
     const head = app._context.provides.usehead;
@@ -3017,22 +3053,55 @@ function createTheme(options) {
         updateStyles();
       }
       function updateStyles() {
-        upsertStyles(getOrCreateStyleElement(parsedOptions.stylesheetId, parsedOptions.cspNonce), styles.value);
+        upsertStyles(parsedOptions.stylesheetId, parsedOptions.cspNonce, styles.value);
       }
     }
   }
-  const themeClasses = computed(() => parsedOptions.isDisabled ? undefined : `v-theme--${name.value}`);
+  function change(themeName) {
+    if (!themeNames.value.includes(themeName)) {
+      consoleWarn(`Theme "${themeName}" not found on the Vuetify theme instance`);
+      return;
+    }
+    name.value = themeName;
+  }
+  function cycle() {
+    let themeArray = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : themeNames.value;
+    const currentIndex = themeArray.indexOf(name.value);
+    const nextIndex = currentIndex === -1 ? 0 : (currentIndex + 1) % themeArray.length;
+    change(themeArray[nextIndex]);
+  }
+  function toggle() {
+    let themeArray = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['light', 'dark'];
+    cycle(themeArray);
+  }
+  const globalName = new Proxy(name, {
+    get(target, prop) {
+      return target[prop];
+    },
+    set(target, prop, val) {
+      if (prop === 'value') {
+        deprecate(`theme.global.name.value = ${val}`, `theme.change('${val}')`);
+      }
+      // @ts-expect-error
+      target[prop] = val;
+      return true;
+    }
+  });
   return {
     install,
+    change,
+    cycle,
+    toggle,
     isDisabled: parsedOptions.isDisabled,
     name,
     themes,
     current,
     computedThemes,
+    prefix: parsedOptions.prefix,
     themeClasses,
     styles,
     global: {
-      name,
+      name: globalName,
       current
     }
   };
@@ -3043,7 +3112,7 @@ function provideTheme(props) {
   if (!theme) throw new Error('Could not find Vuetify theme injection');
   const name = computed(() => props.theme ?? theme.name.value);
   const current = computed(() => theme.themes.value[name.value]);
-  const themeClasses = computed(() => theme.isDisabled ? undefined : `v-theme--${name.value}`);
+  const themeClasses = computed(() => theme.isDisabled ? undefined : `${theme.prefix}theme--${name.value}`);
   const newTheme = {
     ...theme,
     name,
@@ -29241,7 +29310,7 @@ function createVuetify$1() {
     };
   });
 }
-const version$1 = "3.8.1-dev.2025-04-07";
+const version$1 = "3.8.1-dev.2025-04-13";
 createVuetify$1.version = version$1;
 
 // Vue's inject() can only be used in setup
@@ -29266,7 +29335,7 @@ const createVuetify = function () {
     ...options
   });
 };
-const version = "3.8.1-dev.2025-04-07";
+const version = "3.8.1-dev.2025-04-13";
 createVuetify.version = version;
 
 export { index as blueprints, components, createVuetify, directives, useDate, useDefaults, useDisplay, useGoTo, useLayout, useLocale, useRtl, useTheme, version };