@vuetify/nightly 3.10.4-dev.2025-10-02 → 3.10.4-dev.2025-10-06

package/dist/vuetify.esm.js

@@ -1,5 +1,5 @@
 /*!
-* Vuetify v3.10.4-dev.2025-10-02
+* Vuetify v3.10.4-dev.2025-10-06
 * Forged by John Leider
 * Released under the MIT License.
 */
@@ -20676,58 +20676,99 @@ function useSelection() {
 // Types
 
 const makeDataTableSortProps = propsFactory({
+  initialSortOrder: {
+    type: String,
+    default: 'asc',
+    validator: v => !v || ['asc', 'desc'].includes(v)
+  },
   sortBy: {
     type: Array,
     default: () => []
   },
   customKeySort: Object,
-  multiSort: Boolean,
+  multiSort: {
+    type: [Boolean, Object],
+    default: false
+  },
   mustSort: Boolean
 }, 'DataTable-sort');
 const VDataTableSortSymbol = Symbol.for('vuetify:data-table-sort');
 function createSort(props) {
+  const initialSortOrder = toRef(() => props.initialSortOrder);
   const sortBy = useProxiedModel(props, 'sortBy');
   const mustSort = toRef(() => props.mustSort);
   const multiSort = toRef(() => props.multiSort);
   return {
+    initialSortOrder,
     sortBy,
-    mustSort,
-    multiSort
+    multiSort,
+    mustSort
+  };
+}
+function resolveMultiSort(multiSort, event) {
+  if (!isObject(multiSort)) {
+    return {
+      active: !!multiSort
+    };
+  }
+  const {
+    key,
+    mode,
+    modifier
+  } = multiSort;
+  const reverseMode = modifier === 'alt' && event?.altKey || modifier === 'shift' && event?.shiftKey;
+  return {
+    active: !key || event?.ctrlKey || event?.metaKey || false,
+    mode: reverseMode ? mode === 'append' ? 'prepend' : 'append' : mode
   };
 }
 function provideSort(options) {
   const {
+    initialSortOrder,
     sortBy,
     mustSort,
     multiSort,
     page
   } = options;
-  const toggleSort = column => {
+  const toggleSort = (column, event) => {
     if (column.key == null) return;
     let newSortBy = sortBy.value.map(x => ({
       ...x
     })) ?? [];
     const item = newSortBy.find(x => x.key === column.key);
+    const initialOrder = initialSortOrder.value;
+    const secondaryOrder = initialSortOrder.value === 'desc' ? 'asc' : 'desc';
     if (!item) {
-      if (multiSort.value) {
-        newSortBy.push({
-          key: column.key,
-          order: 'asc'
-        });
+      const {
+        active,
+        mode
+      } = resolveMultiSort(multiSort.value, event);
+      if (active) {
+        if (mode === 'prepend') {
+          newSortBy.unshift({
+            key: column.key,
+            order: initialOrder
+          });
+        } else {
+          newSortBy.push({
+            key: column.key,
+            order: initialOrder
+          });
+        }
       } else {
         newSortBy = [{
           key: column.key,
-          order: 'asc'
+          order: initialOrder
         }];
       }
-    } else if (item.order === 'desc') {
+    } else if (item.order === secondaryOrder) {
       if (mustSort.value && newSortBy.length === 1) {
-        item.order = 'asc';
+        item.order = initialSortOrder.value;
       } else {
         newSortBy = newSortBy.filter(x => x.key !== column.key);
       }
     } else {
-      item.order = 'desc';
+      item.order = secondaryOrder;
     }
     sortBy.value = newSortBy;
     if (page) page.value = 1;
@@ -20917,6 +20958,7 @@ const VDataIterator = genericComponent()({
       transform: item => item.raw
     });
     const {
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort
@@ -20928,6 +20970,7 @@ const VDataIterator = genericComponent()({
     const {
       toggleSort
     } = provideSort({
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort,
@@ -21930,7 +21973,7 @@ const VDataTableHeaders = genericComponent()({
     }
     function handleEnterKeyPress(event, column) {
       if (event.key === 'Enter' && !props.disableSort) {
-        toggleSort(column);
+        toggleSort(column, event);
       }
     }
     function getSortIcon(column) {
@@ -21992,7 +22035,7 @@ const VDataTableHeaders = genericComponent()({
         "noPadding": noPadding,
         "empty": isEmpty,
         "tabindex": column.sortable ? 0 : undefined,
-        "onClick": column.sortable ? () => toggleSort(column) : undefined,
+        "onClick": column.sortable ? event => toggleSort(column, event) : undefined,
         "onKeydown": column.sortable ? event => handleEnterKeyPress(event, column) : undefined
       }, headerProps), {
         default: () => {
@@ -22613,7 +22656,7 @@ const makeDataTableProps = propsFactory({
   ...makeDataTableItemsProps(),
   ...makeDataTableSelectProps(),
   ...makeDataTableSortProps(),
-  ...makeVDataTableHeadersProps(),
+  ...omit(makeVDataTableHeadersProps(), ['multiSort']),
   ...makeVTableProps()
 }, 'DataTable');
 const makeVDataTableProps = propsFactory({
@@ -22644,6 +22687,7 @@ const VDataTable = genericComponent()({
       groupBy
     } = createGroupBy(props);
     const {
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort
@@ -22679,6 +22723,7 @@ const VDataTable = genericComponent()({
     const {
       toggleSort
     } = provideSort({
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort,
@@ -22783,7 +22828,7 @@ const VDataTable = genericComponent()({
     }));
     useRender(() => {
       const dataTableFooterProps = VDataTableFooter.filterProps(props);
-      const dataTableHeadersProps = VDataTableHeaders.filterProps(props);
+      const dataTableHeadersProps = VDataTableHeaders.filterProps(omit(props, ['multiSort']));
       const dataTableRowsProps = VDataTableRows.filterProps(props);
       const tableProps = VTable.filterProps(props);
       return createVNode(VTable, mergeProps({
@@ -22798,7 +22843,9 @@ const VDataTable = genericComponent()({
         top: () => slots.top?.(slotProps.value),
         default: () => slots.default ? slots.default(slotProps.value) : createElementVNode(Fragment, null, [slots.colgroup?.(slotProps.value), !props.hideDefaultHeader && createElementVNode("thead", {
           "key": "thead"
-        }, [createVNode(VDataTableHeaders, dataTableHeadersProps, slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && createElementVNode("tbody", null, [slots['body.prepend']?.(slotProps.value), slots.body ? slots.body(slotProps.value) : createVNode(VDataTableRows, mergeProps(attrs, dataTableRowsProps, {
+        }, [createVNode(VDataTableHeaders, mergeProps(dataTableHeadersProps, {
+          "multiSort": !!props.multiSort
+        }), slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && createElementVNode("tbody", null, [slots['body.prepend']?.(slotProps.value), slots.body ? slots.body(slotProps.value) : createVNode(VDataTableRows, mergeProps(attrs, dataTableRowsProps, {
           "items": paginatedItems.value
         }), slots), slots['body.append']?.(slotProps.value)]), slots.tbody?.(slotProps.value), slots.tfoot?.(slotProps.value)]),
         bottom: () => slots.bottom ? slots.bottom(slotProps.value) : !props.hideDefaultFooter && createElementVNode(Fragment, null, [createVNode(VDivider, null, null), createVNode(VDataTableFooter, dataTableFooterProps, {
@@ -22837,6 +22884,7 @@ const VDataTableVirtual = genericComponent()({
       groupBy
     } = createGroupBy(props);
     const {
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort
@@ -22868,6 +22916,7 @@ const VDataTableVirtual = genericComponent()({
     const {
       toggleSort
     } = provideSort({
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort
@@ -22960,7 +23009,7 @@ const VDataTableVirtual = genericComponent()({
       headers: headers.value
     }));
     useRender(() => {
-      const dataTableHeadersProps = VDataTableHeaders.filterProps(props);
+      const dataTableHeadersProps = VDataTableHeaders.filterProps(omit(props, ['multiSort']));
       const dataTableRowsProps = VDataTableRows.filterProps(props);
       const tableProps = VTable.filterProps(props);
       return createVNode(VTable, mergeProps({
@@ -22982,7 +23031,9 @@ const VDataTableVirtual = genericComponent()({
           }
         }, [createElementVNode("table", null, [slots.colgroup?.(slotProps.value), !props.hideDefaultHeader && createElementVNode("thead", {
           "key": "thead"
-        }, [createVNode(VDataTableHeaders, dataTableHeadersProps, slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && createElementVNode("tbody", {
+        }, [createVNode(VDataTableHeaders, mergeProps(dataTableHeadersProps, {
+          "multiSort": !!props.multiSort
+        }), slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && createElementVNode("tbody", {
           "key": "tbody"
         }, [createElementVNode("tr", {
           "ref": markerRef,
@@ -23073,6 +23124,7 @@ const VDataTableServer = genericComponent()({
       groupBy
     } = createGroupBy(props);
     const {
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort
@@ -23099,6 +23151,7 @@ const VDataTableServer = genericComponent()({
     const {
       toggleSort
     } = provideSort({
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort,
@@ -23185,7 +23238,7 @@ const VDataTableServer = genericComponent()({
     }));
     useRender(() => {
       const dataTableFooterProps = VDataTableFooter.filterProps(props);
-      const dataTableHeadersProps = VDataTableHeaders.filterProps(props);
+      const dataTableHeadersProps = VDataTableHeaders.filterProps(omit(props, ['multiSort']));
       const dataTableRowsProps = VDataTableRows.filterProps(props);
       const tableProps = VTable.filterProps(props);
       return createVNode(VTable, mergeProps({
@@ -23201,7 +23254,9 @@ const VDataTableServer = genericComponent()({
           "key": "thead",
           "class": "v-data-table__thead",
           "role": "rowgroup"
-        }, [createVNode(VDataTableHeaders, dataTableHeadersProps, slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && createElementVNode("tbody", {
+        }, [createVNode(VDataTableHeaders, mergeProps(dataTableHeadersProps, {
+          "multiSort": !!props.multiSort
+        }), slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && createElementVNode("tbody", {
           "class": "v-data-table__tbody",
           "role": "rowgroup"
         }, [slots['body.prepend']?.(slotProps.value), slots.body ? slots.body(slotProps.value) : createVNode(VDataTableRows, mergeProps(attrs, dataTableRowsProps, {
@@ -32300,7 +32355,7 @@ function createVuetify$1() {
     };
   });
 }
-const version$1 = "3.10.4-dev.2025-10-02";
+const version$1 = "3.10.4-dev.2025-10-06";
 createVuetify$1.version = version$1;
 
 // Vue's inject() can only be used in setup
@@ -32325,7 +32380,7 @@ const createVuetify = function () {
     ...options
   });
 };
-const version = "3.10.4-dev.2025-10-02";
+const version = "3.10.4-dev.2025-10-06";
 createVuetify.version = version;
 
 export { index as blueprints, components, createVuetify, directives, useDate, useDefaults, useDisplay, useGoTo, useHotkey, useLayout, useLocale, useMask, useRtl, useTheme, version };