@vuetify/nightly 3.9.0-beta.1-dev.2025-06-26 → 3.9.0-beta.1-dev.2025-07-02

package/dist/vuetify-labs.esm.js

@@ -1,5 +1,5 @@
 /*!
-* Vuetify v3.9.0-beta.1-dev.2025-06-26
+* Vuetify v3.9.0-beta.1-dev.2025-07-02
 * Forged by John Leider
 * Released under the MIT License.
 */
@@ -2141,6 +2141,24 @@ var en = {
     exclude: 'The {0} character is not allowed',
     notEmpty: 'Please choose at least one value',
     pattern: 'Invalid format'
+  },
+  hotkey: {
+    then: 'then',
+    ctrl: 'Ctrl',
+    command: 'Command',
+    space: 'Space',
+    shift: 'Shift',
+    alt: 'Alt',
+    enter: 'Enter',
+    escape: 'Escape',
+    upArrow: 'Up Arrow',
+    downArrow: 'Down Arrow',
+    leftArrow: 'Left Arrow',
+    rightArrow: 'Right Arrow',
+    backspace: 'Backspace',
+    option: 'Option',
+    plus: 'plus',
+    shortcut: 'Keyboard shortcut: {0}'
   }
 };
 
@@ -4651,7 +4669,18 @@ const aliases = {
   treeviewExpand: 'mdi-menu-right',
   eyeDropper: 'mdi-eyedropper',
   upload: 'mdi-cloud-upload',
-  color: 'mdi-palette'
+  color: 'mdi-palette',
+  command: 'mdi-apple-keyboard-command',
+  ctrl: 'mdi-apple-keyboard-control',
+  space: 'mdi-keyboard-space',
+  shift: 'mdi-apple-keyboard-shift',
+  alt: 'mdi-apple-keyboard-option',
+  enter: 'mdi-keyboard-return',
+  arrowup: 'mdi-arrow-up',
+  arrowdown: 'mdi-arrow-down',
+  arrowleft: 'mdi-arrow-left',
+  arrowright: 'mdi-arrow-right',
+  backspace: 'mdi-backspace'
 };
 const mdi = {
   // Not using mergeProps here, functional components merge props by default (?)
@@ -10423,7 +10452,7 @@ function connectedLocationStrategy(data, props, contentStyles) {
     });
     if (flipped.isFull) {
       const values = flipped.values();
-      if (deepEqual(values.at(-1), values.at(-3))) {
+      if (deepEqual(values.at(-1), values.at(-3)) && !deepEqual(values.at(-1), values.at(-2))) {
         // Flipping is causing a container resize loop
         return;
       }
@@ -12273,7 +12302,7 @@ const VTextField = genericComponent()({
       if (!isFocused.value) focus();
       nextTick(() => {
         if (inputRef.value !== document.activeElement) {
-          inputRef.value?.focus();
+          nextTick(() => inputRef.value?.focus());
         }
       });
     }
@@ -12612,7 +12641,7 @@ function useVirtual(props, items) {
     raf = requestAnimationFrame(_calculateVisibleItems);
   }
   function _calculateVisibleItems() {
-    if (!containerRef.value || !viewportHeight.value) return;
+    if (!containerRef.value || !viewportHeight.value || !itemHeight.value) return;
     const scrollTop = lastScrollTop - markerOffset;
     const direction = Math.sign(scrollVelocity);
     const startPx = Math.max(0, scrollTop - BUFFER_PX);
@@ -17495,7 +17524,7 @@ function format(value, formatString, locale, formats) {
     case 'fullDate':
       options = {
         year: 'numeric',
-        month: 'long',
+        month: 'short',
         day: 'numeric'
       };
       break;
@@ -18073,6 +18102,317 @@ function useDate() {
   return createInstance(options, locale);
 }
 
+/**
+ * Centralized key alias mapping for consistent key normalization across the hotkey system.
+ *
+ * This maps various user-friendly aliases to canonical key names that match
+ * KeyboardEvent.key values (in lowercase) where possible.
+ */
+const keyAliasMap = {
+  // Modifier aliases (from vue-use, other libraries, and current implementation)
+  control: 'ctrl',
+  command: 'cmd',
+  option: 'alt',
+  // Arrow key aliases (common abbreviations)
+  up: 'arrowup',
+  down: 'arrowdown',
+  left: 'arrowleft',
+  right: 'arrowright',
+  // Other common key aliases
+  esc: 'escape',
+  spacebar: ' ',
+  space: ' ',
+  return: 'enter',
+  del: 'delete',
+  // Symbol aliases (existing from hotkey-parsing.ts)
+  minus: '-',
+  hyphen: '-'
+};
+
+/**
+ * Normalizes a key string to its canonical form using the alias map.
+ *
+ * @param key - The key string to normalize
+ * @returns The canonical key name in lowercase
+ */
+function normalizeKey(key) {
+  const lowerKey = key.toLowerCase();
+  return keyAliasMap[lowerKey] || lowerKey;
+}
+
+// Utilities
+
+/**
+ * Splits a single combination string into individual key parts.
+ *
+ * A combination is a set of keys that must be pressed simultaneously.
+ * e.g. `ctrl+k`, `shift--`
+ */
+function splitKeyCombination(combination) {
+  let isInternal = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+  if (!combination) {
+    if (!isInternal) consoleWarn('Invalid hotkey combination: empty string provided');
+    return [];
+  }
+
+  // --- VALIDATION ---
+  const startsWithPlusOrUnderscore = combination.startsWith('+') || combination.startsWith('_');
+  const hasInvalidLeadingSeparator =
+  // Starts with a single '+' or '_' followed by a non-separator character (e.g. '+a', '_a')
+  startsWithPlusOrUnderscore && !(combination.startsWith('++') || combination.startsWith('__'));
+  const hasInvalidStructure =
+  // Invalid leading separator patterns
+  combination.length > 1 && hasInvalidLeadingSeparator ||
+  // Disallow literal + or _ keys (they require shift)
+  combination.includes('++') || combination.includes('__') || combination === '+' || combination === '_' ||
+  // Ends with a separator that is not part of a doubled literal
+  combination.length > 1 && (combination.endsWith('+') || combination.endsWith('_')) && combination.at(-2) !== combination.at(-1) ||
+  // Stand-alone doubled separators (dangling)
+  combination === '++' || combination === '--' || combination === '__';
+  if (hasInvalidStructure) {
+    if (!isInternal) consoleWarn(`Invalid hotkey combination: "${combination}" has invalid structure`);
+    return [];
+  }
+  const keys = [];
+  let buffer = '';
+  const flushBuffer = () => {
+    if (buffer) {
+      keys.push(normalizeKey(buffer));
+      buffer = '';
+    }
+  };
+  for (let i = 0; i < combination.length; i++) {
+    const char = combination[i];
+    const nextChar = combination[i + 1];
+    if (char === '+' || char === '_' || char === '-') {
+      if (char === nextChar) {
+        flushBuffer();
+        keys.push(char);
+        i++;
+      } else if (char === '+' || char === '_') {
+        flushBuffer();
+      } else {
+        buffer += char;
+      }
+    } else {
+      buffer += char;
+    }
+  }
+  flushBuffer();
+
+  // Within a combination, `-` is only valid as a literal key (e.g., `ctrl+-`).
+  // `-` cannot be part of a longer key name within a combination.
+  const hasInvalidMinus = keys.some(key => key.length > 1 && key.includes('-') && key !== '--');
+  if (hasInvalidMinus) {
+    if (!isInternal) consoleWarn(`Invalid hotkey combination: "${combination}" has invalid structure`);
+    return [];
+  }
+  if (keys.length === 0 && combination) {
+    return [normalizeKey(combination)];
+  }
+  return keys;
+}
+
+/**
+ * Splits a hotkey string into its constituent combination groups.
+ *
+ * A sequence is a series of combinations that must be pressed in order.
+ * e.g. `a-b`, `ctrl+k-p`
+ */
+function splitKeySequence(str) {
+  if (!str) {
+    consoleWarn('Invalid hotkey sequence: empty string provided');
+    return [];
+  }
+
+  // A sequence is invalid if it starts or ends with a separator,
+  // unless it is part of a combination (e.g., `shift+-`).
+  const hasInvalidStart = str.startsWith('-') && !['---', '--+'].includes(str);
+  const hasInvalidEnd = str.endsWith('-') && !str.endsWith('+-') && !str.endsWith('_-') && str !== '-' && str !== '---';
+  if (hasInvalidStart || hasInvalidEnd) {
+    consoleWarn(`Invalid hotkey sequence: "${str}" contains invalid combinations`);
+    return [];
+  }
+  const result = [];
+  let buffer = '';
+  let i = 0;
+  while (i < str.length) {
+    const char = str[i];
+    if (char === '-') {
+      // Determine if this hyphen is part of the current combination
+      const prevChar = str[i - 1];
+      const prevPrevChar = i > 1 ? str[i - 2] : undefined;
+      const precededBySinglePlusOrUnderscore = (prevChar === '+' || prevChar === '_') && prevPrevChar !== '+';
+      if (precededBySinglePlusOrUnderscore) {
+        // Treat as part of the combination (e.g., 'ctrl+-')
+        buffer += char;
+        i++;
+      } else {
+        // Treat as sequence separator
+        if (buffer) {
+          result.push(buffer);
+          buffer = '';
+        } else {
+          // Empty buffer means we have a literal '-' key
+          result.push('-');
+        }
+        i++;
+      }
+    } else {
+      buffer += char;
+      i++;
+    }
+  }
+
+  // Add final buffer if it exists
+  if (buffer) {
+    result.push(buffer);
+  }
+
+  // Collapse runs of '-' so that every second '-' is removed
+  const collapsed = [];
+  let minusCount = 0;
+  for (const part of result) {
+    if (part === '-') {
+      if (minusCount % 2 === 0) collapsed.push('-');
+      minusCount++;
+    } else {
+      minusCount = 0;
+      collapsed.push(part);
+    }
+  }
+
+  // Validate that each part of the sequence is a valid combination
+  const areAllValid = collapsed.every(s => splitKeyCombination(s, true).length > 0);
+  if (!areAllValid) {
+    consoleWarn(`Invalid hotkey sequence: "${str}" contains invalid combinations`);
+    return [];
+  }
+  return collapsed;
+}
+
+// Composables
+
+// Types
+
+function useHotkey(keys, callback) {
+  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  if (!IN_BROWSER) return function () {};
+  const {
+    event = 'keydown',
+    inputs = false,
+    preventDefault = true,
+    sequenceTimeout = 1000
+  } = options;
+  const isMac = navigator?.userAgent?.includes('Macintosh') ?? false;
+  let timeout = 0;
+  let keyGroups;
+  let isSequence = false;
+  let groupIndex = 0;
+  function clearTimer() {
+    if (!timeout) return;
+    clearTimeout(timeout);
+    timeout = 0;
+  }
+  function isInputFocused() {
+    if (toValue(inputs)) return false;
+    const activeElement = document.activeElement;
+    return activeElement && (activeElement.tagName === 'INPUT' || activeElement.tagName === 'TEXTAREA' || activeElement.isContentEditable || activeElement.contentEditable === 'true');
+  }
+  function resetSequence() {
+    groupIndex = 0;
+    clearTimer();
+  }
+  function handler(e) {
+    const group = keyGroups[groupIndex];
+    if (!group || isInputFocused()) return;
+    if (!matchesKeyGroup(e, group)) {
+      if (isSequence) resetSequence();
+      return;
+    }
+    if (toValue(preventDefault)) e.preventDefault();
+    if (!isSequence) {
+      callback(e);
+      return;
+    }
+    clearTimer();
+    groupIndex++;
+    if (groupIndex === keyGroups.length) {
+      callback(e);
+      resetSequence();
+      return;
+    }
+    timeout = window.setTimeout(resetSequence, toValue(sequenceTimeout));
+  }
+  function cleanup() {
+    window.removeEventListener(toValue(event), handler);
+    clearTimer();
+  }
+  watch(() => toValue(keys), function (unrefKeys) {
+    cleanup();
+    if (unrefKeys) {
+      const groups = splitKeySequence(unrefKeys.toLowerCase());
+      isSequence = groups.length > 1;
+      keyGroups = groups;
+      resetSequence();
+      window.addEventListener(toValue(event), handler);
+    }
+  }, {
+    immediate: true
+  });
+
+  // Watch for changes in the event type to re-register the listener
+  watch(() => toValue(event), function (newEvent, oldEvent) {
+    if (oldEvent && keyGroups && keyGroups.length > 0) {
+      window.removeEventListener(oldEvent, handler);
+      window.addEventListener(newEvent, handler);
+    }
+  });
+  try {
+    getCurrentInstance('useHotkey');
+    onBeforeUnmount(cleanup);
+  } catch {
+    // Not in Vue setup context
+  }
+  function parseKeyGroup(group) {
+    const MODIFIERS = ['ctrl', 'shift', 'alt', 'meta', 'cmd'];
+
+    // Use the shared combination splitting logic
+    const parts = splitKeyCombination(group.toLowerCase());
+
+    // If the combination is invalid, return empty result
+    if (parts.length === 0) {
+      return {
+        modifiers: Object.fromEntries(MODIFIERS.map(m => [m, false])),
+        actualKey: undefined
+      };
+    }
+    const modifiers = Object.fromEntries(MODIFIERS.map(m => [m, false]));
+    let actualKey;
+    for (const part of parts) {
+      if (MODIFIERS.includes(part)) {
+        modifiers[part] = true;
+      } else {
+        actualKey = part;
+      }
+    }
+    return {
+      modifiers,
+      actualKey
+    };
+  }
+  function matchesKeyGroup(e, group) {
+    const {
+      modifiers,
+      actualKey
+    } = parseKeyGroup(group);
+    const expectCtrl = modifiers.ctrl || !isMac && (modifiers.cmd || modifiers.meta);
+    const expectMeta = isMac && (modifiers.cmd || modifiers.meta);
+    return e.ctrlKey === expectCtrl && e.metaKey === expectMeta && e.shiftKey === modifiers.shift && e.altKey === modifiers.alt && e.key.toLowerCase() === actualKey?.toLowerCase();
+  }
+  return cleanup;
+}
+
 // Types
 
 const makeVColorPickerProps = propsFactory({
@@ -19501,7 +19841,8 @@ function sortItems(items, sortByItems, locale, options) {
 
       // Dates should be compared numerically
       if (sortA instanceof Date && sortB instanceof Date) {
-        return sortA.getTime() - sortB.getTime();
+        sortA = sortA.getTime();
+        sortB = sortB.getTime();
       }
       [sortA, sortB] = [sortA, sortB].map(s => s != null ? s.toString().toLocaleLowerCase() : s);
       if (sortA !== sortB) {
@@ -20225,7 +20566,6 @@ const VDataTableColumn = defineFunctionalComponent({
   } = _ref;
   const Tag = props.tag ?? 'td';
   return createVNode(Tag, {
-    "tabindex": "0",
     "class": normalizeClass(['v-data-table__td', {
       'v-data-table-column--fixed': props.fixed,
       'v-data-table-column--last-fixed': props.lastFixed,
@@ -20628,14 +20968,14 @@ const VDataTableHeaders = genericComponent()({
         },
         "colspan": column.colspan,
         "rowspan": column.rowspan,
-        "onClick": column.sortable ? () => toggleSort(column) : undefined,
         "fixed": column.fixed,
         "nowrap": column.nowrap,
         "lastFixed": column.lastFixed,
-        "noPadding": noPadding
-      }, headerProps, {
-        "onKeydown": event => column.sortable && handleEnterKeyPress(event, column)
-      }), {
+        "noPadding": noPadding,
+        "tabindex": column.sortable ? 0 : undefined,
+        "onClick": column.sortable ? () => toggleSort(column) : undefined,
+        "onKeydown": column.sortable ? event => handleEnterKeyPress(event, column) : undefined
+      }, headerProps), {
         default: () => {
           const columnSlotName = `header.${column.key}`;
           const columnSlotProps = {
@@ -22321,13 +22661,9 @@ function useCalendar(props) {
     const date = adapter.setYear(adapter.startOfMonth(adapter.date()), adapter.getYear(year.value));
     return adapter.setMonth(date, value);
   }, v => adapter.getMonth(v));
-  const weekDays = computed(() => {
-    const firstDayOfWeek = adapter.toJsDate(adapter.startOfWeek(adapter.date(), props.firstDayOfWeek)).getDay();
-    return props.weekdays.map(day => (day + firstDayOfWeek) % 7);
-  });
   const weekdayLabels = computed(() => {
-    const labels = adapter.getWeekdays(props.firstDayOfWeek, props.weekdayFormat);
-    return weekDays.value.map(day => labels[day]);
+    const firstDayOfWeek = adapter.toJsDate(adapter.startOfWeek(adapter.date(), props.firstDayOfWeek)).getDay();
+    return adapter.getWeekdays(props.firstDayOfWeek, props.weekdayFormat).filter((_, i) => props.weekdays.includes((i + firstDayOfWeek) % 7));
   });
   const weeksInMonth = computed(() => {
     const weeks = adapter.getWeekArray(month.value, props.firstDayOfWeek);
@@ -22351,13 +22687,14 @@ function useCalendar(props) {
   });
   function genDays(days, today) {
     return days.filter(date => {
-      return weekDays.value.includes(adapter.toJsDate(date).getDay());
+      return props.weekdays.includes(adapter.toJsDate(date).getDay());
     }).map((date, index) => {
       const isoDate = adapter.toISO(date);
       const isAdjacent = !adapter.isSameMonth(date, month.value);
       const isStart = adapter.isSameDay(date, adapter.startOfMonth(month.value));
       const isEnd = adapter.isSameDay(date, adapter.endOfMonth(month.value));
       const isSame = adapter.isSameDay(date, month.value);
+      const weekdaysCount = props.weekdays.length;
       return {
         date,
         formatted: adapter.format(date, 'keyboardDate'),
@@ -22369,8 +22706,8 @@ function useCalendar(props) {
         isSelected: model.value.some(value => adapter.isSameDay(date, value)),
         isStart,
         isToday: adapter.isSameDay(date, today),
-        isWeekEnd: index % 7 === 6,
-        isWeekStart: index % 7 === 0,
+        isWeekEnd: index % weekdaysCount === weekdaysCount - 1,
+        isWeekStart: index % weekdaysCount === 0,
         isoDate,
         localized: adapter.format(date, 'dayOfMonth'),
         month: adapter.getMonth(date),
@@ -22417,7 +22754,6 @@ function useCalendar(props) {
     genDays,
     model,
     weeksInMonth,
-    weekDays,
     weekdayLabels,
     weekNumbers
   };
@@ -22458,7 +22794,6 @@ const VDatePickerMonth = genericComponent()({
       daysInMonth,
       model,
       weekNumbers,
-      weekDays,
       weekdayLabels
     } = useCalendar(props);
     const adapter = useDate();
@@ -22533,7 +22868,7 @@ const VDatePickerMonth = genericComponent()({
     useRender(() => createElementVNode("div", {
       "class": "v-date-picker-month",
       "style": {
-        '--v-date-picker-days-in-week': weekDays.value.length
+        '--v-date-picker-days-in-week': props.weekdays.length
       }
     }, [props.showWeek && createElementVNode("div", {
       "key": "weeks",
@@ -25704,19 +26039,21 @@ const VOtpInput = genericComponent()({
     const contentRef = ref();
     const inputRef = ref([]);
     const current = computed(() => inputRef.value[focusIndex.value]);
-    const intersectScope = effectScope();
-    intersectScope.run(() => {
-      const {
-        intersectionRef,
-        isIntersecting
-      } = useIntersectionObserver();
-      watch(isIntersecting, v => {
-        if (!v) return;
-        intersectionRef.value?.focus();
-        intersectScope.stop();
-      });
-      watchEffect(() => {
-        intersectionRef.value = inputRef.value[0];
+    useToggleScope(() => props.autofocus, () => {
+      const intersectScope = effectScope();
+      intersectScope.run(() => {
+        const {
+          intersectionRef,
+          isIntersecting
+        } = useIntersectionObserver();
+        watchEffect(() => {
+          intersectionRef.value = inputRef.value[0];
+        });
+        watch(isIntersecting, v => {
+          if (!v) return;
+          intersectionRef.value?.focus();
+          intersectScope.stop();
+        });
       });
     });
     function onInput() {
@@ -30184,7 +30521,7 @@ const VCalendarIntervalEvent = genericComponent()({
       }
     };
     useRender(() => {
-      return createElementVNode("div", null, [slots.intervalEvent?.({
+      return createElementVNode("div", null, [slots['interval-event']?.({
         height: calcHeight().height,
         margin: calcHeight().margin,
         eventClass: 'v-calendar-internal-event',
@@ -30281,13 +30618,13 @@ const VCalendarInterval = genericComponent()({
         "style": normalizeStyle(`height: ${convertToUnit(props.intervalHeight)}`)
       }, [createElementVNode("div", mergeProps({
         "class": "v-calendar-day__row-label"
-      }, getPrefixedEventHandlers(attrs, ':time', () => props)), [slots.intervalTitle?.({
+      }, getPrefixedEventHandlers(attrs, ':time', () => props)), [slots['interval-title']?.({
         interval: interval.value
       }) ?? (props.index ? props.intervalFormat ? typeof props.intervalFormat === 'string' ? adapter.format(interval.value.start, 'hours12h') : props.intervalFormat(interval.value) : interval.value.label : '12 AM')]), createElementVNode("div", {
         "class": "v-calendar-day__row-hairline"
       }, null), createElementVNode("div", mergeProps({
         "class": ['v-calendar-day__row-content', interval.value.events.some(e => !e.last) ? 'v-calendar-day__row-content-through' : '']
-      }, getPrefixedEventHandlers(attrs, ':interval', () => interval.value)), [slots.intervalBody?.({
+      }, getPrefixedEventHandlers(attrs, ':interval', () => interval.value)), [slots['interval-body']?.({
         interval: interval.value
       }) ?? createElementVNode("div", null, [interval.value.events?.map(event => createVNode(VCalendarIntervalEvent, mergeProps({
         "event": event,
@@ -30296,8 +30633,8 @@ const VCalendarInterval = genericComponent()({
         "intervalDuration": props.intervalDuration,
         "intervalHeight": props.intervalHeight
       }, attrs), {
-        ...(slots.intervalEvent ? {
-          intervalEvent: _ref2 => {
+        ...(slots['interval-event'] ? {
+          'interval-event': _ref2 => {
             let {
               height,
               margin,
@@ -30305,7 +30642,7 @@ const VCalendarInterval = genericComponent()({
               event,
               interval
             } = _ref2;
-            return slots.intervalEvent?.({
+            return slots['interval-event']?.({
               height,
               margin,
               eventClass,
@@ -30319,7 +30656,7 @@ const VCalendarInterval = genericComponent()({
         "style": normalizeStyle(`height: ${convertToUnit(props.intervalHeight)}`)
       }, [createElementVNode("div", mergeProps({
         "class": ['v-calendar-day__row-content', interval.value.events.some(e => !e.last) ? 'v-calendar-day__row-content-through' : '']
-      }, getPrefixedEventHandlers(attrs, ':interval', () => interval.value)), [slots.intervalBody?.({
+      }, getPrefixedEventHandlers(attrs, ':interval', () => interval.value)), [slots['interval-body']?.({
         interval: interval.value
       }) ?? interval.value.events?.map(event => createVNode(VCalendarIntervalEvent, mergeProps({
         "event": event,
@@ -30328,8 +30665,8 @@ const VCalendarInterval = genericComponent()({
         "intervalDuration": props.intervalDuration,
         "intervalHeight": props.intervalHeight
       }, attrs), {
-        ...(slots.intervalEvent ? {
-          intervalEvent: _ref3 => {
+        ...(slots['interval-event'] ? {
+          'interval-event': _ref3 => {
             let {
               height,
               margin,
@@ -30337,7 +30674,7 @@ const VCalendarInterval = genericComponent()({
               event,
               interval
             } = _ref3;
-            return slots.intervalEvent?.({
+            return slots['interval-event']?.({
               height,
               margin,
               eventClass,
@@ -30392,7 +30729,7 @@ const VCalendarDay = genericComponent()({
       }), null)])]), intervals.value.map((_, index) => slots.interval?.(calendarIntervalProps) ?? createVNode(VCalendarInterval, mergeProps({
         "index": index
       }, calendarIntervalProps, attrs, getPrefixedEventHandlers(attrs, ':interval', () => calendarIntervalProps)), {
-        ...pick(slots, ['intervalBody', 'intervalEvent', 'intervalTitle'])
+        ...pick(slots, ['interval-body', 'interval-event', 'interval-title'])
       }))]);
     });
     return {
@@ -30536,7 +30873,7 @@ const VCalendarMonthDay = genericComponent()({
       }, getPrefixedEventHandlers(attrs, ':day', () => props)), [!props.day?.isHidden ? createElementVNode("div", {
         "key": "title",
         "class": "v-calendar-weekly__day-label"
-      }, [slots.dayTitle?.({
+      }, [slots['day-title']?.({
         title: props.title
       }) ?? createVNode(VBtn, mergeProps({
         "class": props.day?.isToday ? 'v-calendar-weekly__day-label__today' : undefined,
@@ -30549,12 +30886,12 @@ const VCalendarMonthDay = genericComponent()({
       }, getPrefixedEventHandlers(attrs, ':date', () => props)), null)]) : undefined, !props.day?.isHidden ? createElementVNode("div", {
         "key": "content",
         "class": "v-calendar-weekly__day-content"
-      }, [slots.dayBody?.({
+      }, [slots['day-body']?.({
         day: props.day,
         events: props.events
       }) ?? createElementVNode("div", null, [createElementVNode("div", {
         "class": "v-calendar-weekly__day-alldayevents-container"
-      }, [props.events?.filter(event => event.allDay).map(event => slots.dayEvent ? slots.dayEvent({
+      }, [props.events?.filter(event => event.allDay).map(event => slots['day-event'] ? slots['day-event']({
         day: props.day,
         allDay: true,
         event
@@ -30564,7 +30901,7 @@ const VCalendarMonthDay = genericComponent()({
         "allDay": true
       }, attrs), null))]), createElementVNode("div", {
         "class": "v-calendar-weekly__day-events-container"
-      }, [props.events?.filter(event => !event.allDay).map(event => slots.dayEvent ? slots.dayEvent({
+      }, [props.events?.filter(event => !event.allDay).map(event => slots['day-event'] ? slots['day-event']({
         day: props.day,
         event,
         allDay: false
@@ -30609,9 +30946,8 @@ const VCalendar = genericComponent()({
       model,
       displayValue,
       weekNumbers,
-      weekDays
+      weekdayLabels
     } = useCalendar(props);
-    const dayNames = adapter.getWeekdays();
     function onClickNext() {
       if (props.viewMode === 'month') {
         model.value = [adapter.addMonths(displayValue.value, 1)];
@@ -30649,6 +30985,7 @@ const VCalendar = genericComponent()({
     useRender(() => {
       const calendarDayProps = VCalendarDay.filterProps(props);
       const calendarHeaderProps = VCalendarHeader.filterProps(props);
+      const weekdaysCount = daysInWeek.value.length;
       return createElementVNode("div", {
         "class": normalizeClass(['v-calendar', {
           'v-calendar-monthly': props.viewMode === 'month',
@@ -30670,19 +31007,19 @@ const VCalendar = genericComponent()({
       }), {
         title: slots.title
       }))]), createElementVNode("div", {
-        "class": normalizeClass(['v-calendar__container', `days__${weekDays.value.length}`])
+        "class": normalizeClass(['v-calendar__container', `days__${weekdaysCount}`])
       }, [props.viewMode === 'month' && !props.hideDayHeader && createElementVNode("div", {
-        "class": normalizeClass(['v-calendar-weekly__head', `days__${weekDays.value.length}`, ...(!props.hideWeekNumber ? ['v-calendar-weekly__head-weeknumbers'] : [])]),
+        "class": normalizeClass(['v-calendar-weekly__head', `days__${weekdaysCount}`, ...(!props.hideWeekNumber ? ['v-calendar-weekly__head-weeknumbers'] : [])]),
         "key": "calendarWeeklyHead"
       }, [!props.hideWeekNumber ? createElementVNode("div", {
         "key": "weekNumber0",
         "class": "v-calendar-weekly__head-weeknumber"
-      }, null) : '', weekDays.value.map(weekday => createElementVNode("div", {
+      }, null) : '', weekdayLabels.value.map(weekday => createElementVNode("div", {
         "class": normalizeClass(`v-calendar-weekly__head-weekday${!props.hideWeekNumber ? '-with-weeknumber' : ''}`)
-      }, [dayNames[weekday]]))]), props.viewMode === 'month' && createElementVNode("div", {
+      }, [weekday]))]), props.viewMode === 'month' && createElementVNode("div", {
         "key": "VCalendarMonth",
-        "class": normalizeClass(['v-calendar-month__days', `days${!props.hideWeekNumber ? '-with-weeknumbers' : ''}__${weekDays.value.length}`, ...(!props.hideWeekNumber ? ['v-calendar-month__weeknumbers'] : [])])
-      }, [chunkArray(daysInMonth.value, weekDays.value.length).map((week, wi) => [!props.hideWeekNumber ? createElementVNode("div", mergeProps({
+        "class": normalizeClass(['v-calendar-month__days', `days${!props.hideWeekNumber ? '-with-weeknumbers' : ''}__${weekdaysCount}`, ...(!props.hideWeekNumber ? ['v-calendar-month__weeknumbers'] : [])])
+      }, [chunkArray(daysInMonth.value, weekdaysCount).map((week, wi) => [!props.hideWeekNumber ? createElementVNode("div", mergeProps({
         "class": "v-calendar-month__weeknumber"
       }, getPrefixedEventHandlers(attrs, ':weekNumber', () => ({
         weekNumber: weekNumbers.value[wi],
@@ -30705,7 +31042,7 @@ const VCalendar = genericComponent()({
         "dayIndex": i,
         "events": props.events?.filter(e => adapter.isSameDay(e.start, day.date) || adapter.isSameDay(e.end, day.date))
       }, attrs), {
-        ...pick(slots, ['interval', 'intervalBody', 'intervalEvent', 'intervalTitle'])
+        ...pick(slots, ['interval', 'interval-body', 'interval-event', 'interval-title'])
       })), props.viewMode === 'day' && (slots['day-interval'] ? slots['day-interval']({
         day: genDays([displayValue.value], adapter.date())[0],
         dayIndex: 0,
@@ -31620,6 +31957,7 @@ const VIconBtn = genericComponent()({
         opacity: props.opacity
       };
       return createVNode(props.tag, {
+        "type": props.tag === 'button' ? 'button' : undefined,
         "class": normalizeClass([{
           'v-icon-btn': true,
           'v-icon-btn--active': isActive.value,
@@ -32278,6 +32616,398 @@ const VPullToRefresh = genericComponent()({
   }
 });
 
+// Types
+
+// Display mode types for different visual representations
+
+// Extended variant type that includes our custom 'contained' variant
+
+// Key display tuple: [mode, content] where content is string or IconValue
+
+// Key tuple: [mode, content] where content is string or IconValue
+
+function processKey(config, requestedMode, isMac) {
+  const keyCfg = isMac && config.mac ? config.mac : config.default;
+
+  // 1. Resolve the safest display mode for the current platform
+  const mode = (() => {
+    // Non-Mac platforms rarely use icons – prefer text
+    if (requestedMode === 'icon' && !isMac) return 'text';
+
+    // If the requested mode lacks an asset, fall back to text
+    if (requestedMode === 'icon' && !keyCfg.icon) return 'text';
+    if (requestedMode === 'symbol' && !keyCfg.symbol) return 'text';
+    return requestedMode;
+  })();
+
+  // 2. Pick value for the chosen mode, defaulting to text representation
+  let value = keyCfg[mode] ?? keyCfg.text;
+
+  // 3. Guard against icon tokens leaking into text mode (e.g. "$ctrl")
+  if (mode === 'text' && typeof value === 'string' && value.startsWith('$') && !value.startsWith('$vuetify.')) {
+    value = value.slice(1).toUpperCase(); // "$ctrl" → "CTRL"
+  }
+  return mode === 'icon' ? ['icon', value] : [mode, value];
+}
+const hotkeyMap = {
+  ctrl: {
+    mac: {
+      symbol: '⌃',
+      icon: '$ctrl',
+      text: '$vuetify.hotkey.ctrl'
+    },
+    default: {
+      text: 'Ctrl'
+    }
+  },
+  meta: {
+    mac: {
+      symbol: '⌘',
+      icon: '$command',
+      text: '$vuetify.hotkey.command'
+    },
+    default: {
+      text: 'Ctrl'
+    }
+  },
+  cmd: {
+    mac: {
+      symbol: '⌘',
+      icon: '$command',
+      text: '$vuetify.hotkey.command'
+    },
+    default: {
+      text: 'Ctrl'
+    }
+  },
+  shift: {
+    mac: {
+      symbol: '⇧',
+      icon: '$shift',
+      text: '$vuetify.hotkey.shift'
+    },
+    default: {
+      text: 'Shift'
+    }
+  },
+  alt: {
+    mac: {
+      symbol: '⌥',
+      icon: '$alt',
+      text: '$vuetify.hotkey.option'
+    },
+    default: {
+      text: 'Alt'
+    }
+  },
+  enter: {
+    default: {
+      symbol: '↵',
+      icon: '$enter',
+      text: '$vuetify.hotkey.enter'
+    }
+  },
+  arrowup: {
+    default: {
+      symbol: '↑',
+      icon: '$arrowup',
+      text: '$vuetify.hotkey.upArrow'
+    }
+  },
+  arrowdown: {
+    default: {
+      symbol: '↓',
+      icon: '$arrowdown',
+      text: '$vuetify.hotkey.downArrow'
+    }
+  },
+  arrowleft: {
+    default: {
+      symbol: '←',
+      icon: '$arrowleft',
+      text: '$vuetify.hotkey.leftArrow'
+    }
+  },
+  arrowright: {
+    default: {
+      symbol: '→',
+      icon: '$arrowright',
+      text: '$vuetify.hotkey.rightArrow'
+    }
+  },
+  backspace: {
+    default: {
+      symbol: '⌫',
+      icon: '$backspace',
+      text: '$vuetify.hotkey.backspace'
+    }
+  },
+  escape: {
+    default: {
+      text: '$vuetify.hotkey.escape'
+    }
+  },
+  ' ': {
+    mac: {
+      symbol: '␣',
+      icon: '$space',
+      text: '$vuetify.hotkey.space'
+    },
+    default: {
+      text: '$vuetify.hotkey.space'
+    }
+  },
+  '-': {
+    default: {
+      text: '-'
+    }
+  }
+};
+
+// Create custom variant props that extend the base variant props with our 'contained' option
+const makeVHotkeyVariantProps = propsFactory({
+  variant: {
+    type: String,
+    default: 'elevated',
+    validator: v => ['elevated', 'flat', 'tonal', 'outlined', 'text', 'plain', 'contained'].includes(v)
+  }
+}, 'VHotkeyVariant');
+const makeVHotkeyProps = propsFactory({
+  // String representing keyboard shortcuts (e.g., "ctrl+k", "meta+shift+p")
+  keys: String,
+  // How to display keys: 'symbol' uses special characters (⌘, ⌃), 'icon' uses SVG icons, 'text' uses words
+  displayMode: {
+    type: String,
+    default: 'icon'
+  },
+  // Custom key mapping configuration. Users can import and modify the exported hotkeyMap as needed
+  keyMap: {
+    type: Object,
+    default: () => hotkeyMap
+  },
+  platform: {
+    type: String,
+    default: 'auto'
+  },
+  inline: Boolean,
+  disabled: Boolean,
+  prefix: String,
+  suffix: String,
+  ...makeComponentProps(),
+  ...makeThemeProps(),
+  ...makeBorderProps(),
+  ...makeRoundedProps(),
+  ...makeElevationProps(),
+  ...makeVHotkeyVariantProps(),
+  color: String
+}, 'VHotkey');
+class Delineator {
+  constructor(delineator) {
+    if (['and', 'then'].includes(delineator)) this.val = delineator;else {
+      throw new Error('Not a valid delineator');
+    }
+  }
+  isEqual(d) {
+    return this.val === d.val;
+  }
+}
+function isDelineator(value) {
+  return value instanceof Delineator;
+}
+function isString(value) {
+  return typeof value === 'string';
+}
+function getKeyText(keyMap, key, isMac) {
+  const lowerKey = key.toLowerCase();
+  if (lowerKey in keyMap) {
+    const result = processKey(keyMap[lowerKey], 'text', isMac);
+    return typeof result[1] === 'string' ? result[1] : String(result[1]);
+  }
+  return key.toUpperCase();
+}
+function applyDisplayModeToKey(keyMap, mode, key, isMac) {
+  const lowerKey = key.toLowerCase();
+  if (lowerKey in keyMap) {
+    const result = processKey(keyMap[lowerKey], mode, isMac);
+    if (result[0] === 'text' && typeof result[1] === 'string' && result[1].startsWith('$') && !result[1].startsWith('$vuetify.')) {
+      return ['text', result[1].replace('$', '').toUpperCase(), key];
+    }
+    return [...result, key];
+  }
+  return ['text', key.toUpperCase(), key];
+}
+const VHotkey = genericComponent()({
+  name: 'VHotkey',
+  props: makeVHotkeyProps(),
+  setup(props) {
+    const {
+      t
+    } = useLocale();
+    const {
+      themeClasses
+    } = provideTheme(props);
+    const {
+      rtlClasses
+    } = useRtl();
+    const {
+      borderClasses
+    } = useBorder(props);
+    const {
+      roundedClasses
+    } = useRounded(props);
+    const {
+      elevationClasses
+    } = useElevation(props);
+    const isContainedVariant = computed(() => props.variant === 'contained');
+    const effectiveVariantProps = computed(() => ({
+      ...props,
+      variant: isContainedVariant.value ? 'elevated' : props.variant
+    }));
+    const {
+      colorClasses,
+      colorStyles,
+      variantClasses
+    } = useVariant(effectiveVariantProps);
+    const isMac = computed(() => props.platform === 'auto' ? typeof navigator !== 'undefined' && /macintosh/i.test(navigator.userAgent) : props.platform === 'mac');
+    const effectiveDisplayMode = computed(() => props.displayMode);
+    const AND_DELINEATOR = new Delineator('and'); // For + separators
+    const THEN_DELINEATOR = new Delineator('then'); // For - separators
+
+    const effectiveKeyMap = computed(() => props.keyMap);
+    const keyCombinations = computed(() => {
+      if (!props.keys) return [];
+
+      // Split by spaces to handle multiple key combinations
+      // Example: "ctrl+k meta+p" -> ["ctrl+k", "meta+p"]
+      return props.keys.split(' ').map(combination => {
+        // Use the shared sequence splitting logic
+        const sequenceGroups = splitKeySequence(combination);
+
+        // Process each sequence group
+        return sequenceGroups.flatMap((group, groupIndex) => {
+          // Use the shared key combination splitting logic
+          const keyParts = splitKeyCombination(group);
+          const parts = keyParts.reduce((acc, part, index) => {
+            if (index !== 0) {
+              // Add AND delineator between keys
+              return [...acc, AND_DELINEATOR, part];
+            }
+            return [...acc, part];
+          }, []);
+
+          // Add THEN delineator between sequence groups
+          const result = parts.map(key => {
+            if (isString(key)) {
+              return applyDisplayModeToKey(effectiveKeyMap.value, effectiveDisplayMode.value, key, isMac.value);
+            }
+            return key;
+          });
+
+          // Add sequence separator if not the last group
+          if (groupIndex < sequenceGroups.length - 1) {
+            result.push(THEN_DELINEATOR);
+          }
+          return result;
+        });
+      });
+    });
+    const accessibleLabel = computed(() => {
+      if (!props.keys) return '';
+
+      // Convert the parsed key combinations into readable text
+      const readableShortcuts = keyCombinations.value.map(combination => {
+        const readableParts = [];
+        for (const key of combination) {
+          if (isDelineator(key)) {
+            if (AND_DELINEATOR.isEqual(key)) {
+              readableParts.push(t('$vuetify.hotkey.plus'));
+            } else if (THEN_DELINEATOR.isEqual(key)) {
+              readableParts.push(t('$vuetify.hotkey.then'));
+            }
+          } else {
+            // Always use text representation for screen readers
+            const textKey = key[0] === 'icon' || key[0] === 'symbol' ? applyDisplayModeToKey(mergeDeep(hotkeyMap, props.keyMap), 'text', String(key[1]), isMac.value)[1] : key[1];
+            readableParts.push(translateKey(textKey));
+          }
+        }
+        return readableParts.join(' ');
+      });
+      const shortcutText = readableShortcuts.join(', ');
+      return t('$vuetify.hotkey.shortcut', shortcutText);
+    });
+    function translateKey(key) {
+      return key.startsWith('$vuetify.') ? t(key) : key;
+    }
+    function getKeyTooltip(key) {
+      if (effectiveDisplayMode.value === 'text') return undefined;
+      const textKey = getKeyText(effectiveKeyMap.value, String(key[2]), isMac.value);
+      return translateKey(textKey);
+    }
+    function renderKey(key, keyIndex, isContained) {
+      const KeyComponent = isContained ? 'kbd' : VKbd;
+      const keyClasses = ['v-hotkey__key', `v-hotkey__key-${key[0]}`, ...(isContained ? ['v-hotkey__key--nested'] : [borderClasses.value, roundedClasses.value, elevationClasses.value, colorClasses.value])];
+      return createVNode(KeyComponent, {
+        "key": keyIndex,
+        "class": normalizeClass(keyClasses),
+        "style": normalizeStyle(isContained ? undefined : colorStyles.value),
+        "aria-hidden": "true",
+        "title": getKeyTooltip(key)
+      }, {
+        default: () => [key[0] === 'icon' ? createVNode(VIcon, {
+          "icon": key[1],
+          "aria-hidden": "true"
+        }, null) : translateKey(key[1])]
+      });
+    }
+    function renderDivider(key, keyIndex) {
+      return createElementVNode("span", {
+        "key": keyIndex,
+        "class": "v-hotkey__divider",
+        "aria-hidden": "true"
+      }, [AND_DELINEATOR.isEqual(key) ? '+' : t('$vuetify.hotkey.then')]);
+    }
+    useRender(() => createElementVNode("div", {
+      "class": normalizeClass(['v-hotkey', {
+        'v-hotkey--disabled': props.disabled,
+        'v-hotkey--inline': props.inline,
+        'v-hotkey--contained': isContainedVariant.value
+      }, themeClasses.value, rtlClasses.value, variantClasses.value, props.class]),
+      "style": normalizeStyle(props.style),
+      "role": "img",
+      "aria-label": accessibleLabel.value
+    }, [isContainedVariant.value ? createVNode(VKbd, {
+      "key": "contained",
+      "class": normalizeClass(['v-hotkey__contained-wrapper', borderClasses.value, roundedClasses.value, elevationClasses.value, colorClasses.value]),
+      "style": normalizeStyle(colorStyles.value),
+      "aria-hidden": "true"
+    }, {
+      default: () => [props.prefix && createElementVNode("span", {
+        "key": "contained-prefix",
+        "class": "v-hotkey__prefix"
+      }, [props.prefix]), keyCombinations.value.map((combination, comboIndex) => createElementVNode("span", {
+        "class": "v-hotkey__combination",
+        "key": comboIndex
+      }, [combination.map((key, keyIndex) => isDelineator(key) ? renderDivider(key, keyIndex) : renderKey(key, keyIndex, true)), comboIndex < keyCombinations.value.length - 1 && createElementVNode("span", {
+        "aria-hidden": "true"
+      }, [createTextVNode("\xA0")])])), props.suffix && createElementVNode("span", {
+        "key": "contained-suffix",
+        "class": "v-hotkey__suffix"
+      }, [props.suffix])]
+    }) : createElementVNode(Fragment, null, [props.prefix && createElementVNode("span", {
+      "key": "prefix",
+      "class": "v-hotkey__prefix"
+    }, [props.prefix]), keyCombinations.value.map((combination, comboIndex) => createElementVNode("span", {
+      "class": "v-hotkey__combination",
+      "key": comboIndex
+    }, [combination.map((key, keyIndex) => isDelineator(key) ? renderDivider(key, keyIndex) : renderKey(key, keyIndex, false)), comboIndex < keyCombinations.value.length - 1 && createElementVNode("span", {
+      "aria-hidden": "true"
+    }, [createTextVNode("\xA0")])])), props.suffix && createElementVNode("span", {
+      "key": "suffix",
+      "class": "v-hotkey__suffix"
+    }, [props.suffix])])]));
+  }
+});
+
 var components = /*#__PURE__*/Object.freeze({
   __proto__: null,
   VAlert: VAlert,
@@ -32366,6 +33096,7 @@ var components = /*#__PURE__*/Object.freeze({
   VFileUploadItem: VFileUploadItem,
   VFooter: VFooter,
   VForm: VForm,
+  VHotkey: VHotkey,
   VHover: VHover,
   VIcon: VIcon,
   VIconBtn: VIconBtn,
@@ -32789,7 +33520,7 @@ function createVuetify$1() {
     };
   });
 }
-const version$1 = "3.9.0-beta.1-dev.2025-06-26";
+const version$1 = "3.9.0-beta.1-dev.2025-07-02";
 createVuetify$1.version = version$1;
 
 // Vue's inject() can only be used in setup
@@ -33087,7 +33818,7 @@ var index = /*#__PURE__*/Object.freeze({
 
 /* eslint-disable local-rules/sort-imports */
 
-const version = "3.9.0-beta.1-dev.2025-06-26";
+const version = "3.9.0-beta.1-dev.2025-07-02";
 
 /* eslint-disable local-rules/sort-imports */
 
@@ -33100,5 +33831,5 @@ const createVuetify = function () {
   });
 };
 
-export { index as blueprints, components, createVuetify, directives, useDate, useDefaults, useDisplay, useGoTo, useLayout, useLocale, useRtl, useTheme, version };
+export { index as blueprints, components, createVuetify, directives, useDate, useDefaults, useDisplay, useGoTo, useHotkey, useLayout, useLocale, useRtl, useTheme, version };
 //# sourceMappingURL=vuetify-labs.esm.js.map