feat(date): export VuetifyDateAdapter (#21252)

resolves #19904

Co-authored-by: Jens Müller <[email protected]>
Co-authored-by: J-Sek <[email protected]>
Co-authored-by: John Leider <[email protected]>

Author: 4 people

packages/docs/src/pages/en/features/dates.md

@@ -338,3 +338,35 @@ export interface DateAdapter<TDate> {
   getNextMonth (date: TDate): TDate
 }
 ```
+
+## Inheritance
+
+You can also extend and override build-in DateAdapter using class inheritance:
+
+```ts
+import { VuetifyDateAdapter } from 'vuetify/date/adapters/vuetify'
+
+export class MyAdapter extends VuetifyDateAdapter {
+  sayHello () {
+    return `Hello, current week starts at ${this.startOfWeek(this.date())}`
+  }
+  override startOfWeek (date: Date, firstDayOfWeek?: string | number): Date {
+    return super.startOfWeek(date, 2) // forcing Tuesday
+  }
+}
+```
+
+```ts { resource="src/plugins/vuetify.js" }
+export default createVuetify({
+  date: {
+    adapter: MyAdapter,
+  },
+  ...
+})
+
+declare module 'vuetify' {
+  namespace DateModule {
+    interface Adapter extends MyAdapter {}
+  }
+}
+```

packages/vuetify/package.json

@@ -76,6 +76,7 @@
     "./labs/components": "./lib/labs/components.js",
     "./labs/*": "./lib/labs/*/index.js",
     "./util/colors": "./lib/util/colors.js",
+    "./date/adapters/*": "./lib/composables/date/adapters/*.js",
     "./util/transitions": "./lib/components/transitions/createTransition.js",
     "./dist/vuetify.js": {
       "types": "./dist/vuetify.d.ts",

packages/vuetify/src/composables/date/index.ts

@@ -1,3 +1,4 @@
 export { createDate, useDate, DateAdapterSymbol } from './date'
 export type { DateAdapter } from './DateAdapter'
 export type { DateOptions, DateInstance, DateModule } from './date'
+export { VuetifyDateAdapter } from './adapters/vuetify'