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

package/dist/vuetify.cjs

@@ -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.
 */
@@ -20680,58 +20680,99 @@
   // 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 = vue.toRef(() => props.initialSortOrder);
     const sortBy = useProxiedModel(props, 'sortBy');
     const mustSort = vue.toRef(() => props.mustSort);
     const multiSort = vue.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;
@@ -20921,6 +20962,7 @@
         transform: item => item.raw
       });
       const {
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort
@@ -20932,6 +20974,7 @@
       const {
         toggleSort
       } = provideSort({
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort,
@@ -21934,7 +21977,7 @@
       }
       function handleEnterKeyPress(event, column) {
         if (event.key === 'Enter' && !props.disableSort) {
-          toggleSort(column);
+          toggleSort(column, event);
         }
       }
       function getSortIcon(column) {
@@ -21996,7 +22039,7 @@
           "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: () => {
@@ -22617,7 +22660,7 @@
     ...makeDataTableItemsProps(),
     ...makeDataTableSelectProps(),
     ...makeDataTableSortProps(),
-    ...makeVDataTableHeadersProps(),
+    ...omit(makeVDataTableHeadersProps(), ['multiSort']),
     ...makeVTableProps()
   }, 'DataTable');
   const makeVDataTableProps = propsFactory({
@@ -22648,6 +22691,7 @@
         groupBy
       } = createGroupBy(props);
       const {
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort
@@ -22683,6 +22727,7 @@
       const {
         toggleSort
       } = provideSort({
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort,
@@ -22787,7 +22832,7 @@
       }));
       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 vue.createVNode(VTable, vue.mergeProps({
@@ -22802,7 +22847,9 @@
           top: () => slots.top?.(slotProps.value),
           default: () => slots.default ? slots.default(slotProps.value) : vue.createElementVNode(vue.Fragment, null, [slots.colgroup?.(slotProps.value), !props.hideDefaultHeader && vue.createElementVNode("thead", {
             "key": "thead"
-          }, [vue.createVNode(VDataTableHeaders, dataTableHeadersProps, slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && vue.createElementVNode("tbody", null, [slots['body.prepend']?.(slotProps.value), slots.body ? slots.body(slotProps.value) : vue.createVNode(VDataTableRows, vue.mergeProps(attrs, dataTableRowsProps, {
+          }, [vue.createVNode(VDataTableHeaders, vue.mergeProps(dataTableHeadersProps, {
+            "multiSort": !!props.multiSort
+          }), slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && vue.createElementVNode("tbody", null, [slots['body.prepend']?.(slotProps.value), slots.body ? slots.body(slotProps.value) : vue.createVNode(VDataTableRows, vue.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 && vue.createElementVNode(vue.Fragment, null, [vue.createVNode(VDivider, null, null), vue.createVNode(VDataTableFooter, dataTableFooterProps, {
@@ -22841,6 +22888,7 @@
         groupBy
       } = createGroupBy(props);
       const {
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort
@@ -22872,6 +22920,7 @@
       const {
         toggleSort
       } = provideSort({
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort
@@ -22964,7 +23013,7 @@
         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 vue.createVNode(VTable, vue.mergeProps({
@@ -22986,7 +23035,9 @@
             }
           }, [vue.createElementVNode("table", null, [slots.colgroup?.(slotProps.value), !props.hideDefaultHeader && vue.createElementVNode("thead", {
             "key": "thead"
-          }, [vue.createVNode(VDataTableHeaders, dataTableHeadersProps, slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && vue.createElementVNode("tbody", {
+          }, [vue.createVNode(VDataTableHeaders, vue.mergeProps(dataTableHeadersProps, {
+            "multiSort": !!props.multiSort
+          }), slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && vue.createElementVNode("tbody", {
             "key": "tbody"
           }, [vue.createElementVNode("tr", {
             "ref": markerRef,
@@ -23077,6 +23128,7 @@
         groupBy
       } = createGroupBy(props);
       const {
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort
@@ -23103,6 +23155,7 @@
       const {
         toggleSort
       } = provideSort({
+        initialSortOrder,
         sortBy,
         multiSort,
         mustSort,
@@ -23189,7 +23242,7 @@
       }));
       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 vue.createVNode(VTable, vue.mergeProps({
@@ -23205,7 +23258,9 @@
             "key": "thead",
             "class": "v-data-table__thead",
             "role": "rowgroup"
-          }, [vue.createVNode(VDataTableHeaders, dataTableHeadersProps, slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && vue.createElementVNode("tbody", {
+          }, [vue.createVNode(VDataTableHeaders, vue.mergeProps(dataTableHeadersProps, {
+            "multiSort": !!props.multiSort
+          }), slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && vue.createElementVNode("tbody", {
             "class": "v-data-table__tbody",
             "role": "rowgroup"
           }, [slots['body.prepend']?.(slotProps.value), slots.body ? slots.body(slotProps.value) : vue.createVNode(VDataTableRows, vue.mergeProps(attrs, dataTableRowsProps, {
@@ -32304,7 +32359,7 @@
       };
     });
   }
-  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
@@ -32329,7 +32384,7 @@
       ...options
     });
   };
-  const version = "3.10.4-dev.2025-10-02";
+  const version = "3.10.4-dev.2025-10-06";
   createVuetify.version = version;
 
   exports.blueprints = index;