feat(types): type hints for hmr events (#681) (#1030)

Co-authored-by: Rush Ali <[email protected]>

closes #681 #1030

Author: mstelbrink

docs/guide/api-hmr.md

@@ -8,15 +8,18 @@ Die manuelle HMR API ist hauptsächlich für Framework- und Tool-Autoren gedacht
 
 Vite stellt seine manuelle HMR API über das spezielle `import.meta.hot` Objekt zur Verfügung:
 
-```ts
+```ts twoslash
+import type { ModuleNamespace } from 'vite/types/hot.d.ts'
+import type {
+  CustomEventName,
+  InferCustomEventPayload,
+} from 'vite/types/customEvent.d.ts'
+
+// ---cut---
 interface ImportMeta {
   readonly hot?: ViteHotContext
 }
 
-type ModuleNamespace = Record<string, any> & {
-  [Symbol.toStringTag]: 'Module'
-}
-
 interface ViteHotContext {
   readonly data: any
 
@@ -25,23 +28,25 @@ interface ViteHotContext {
   accept(dep: string, cb: (mod: ModuleNamespace | undefined) => void): void
   accept(
     deps: readonly string[],
-    cb: (mods: Array<ModuleNamespace | undefined>) => void
+    cb: (mods: Array<ModuleNamespace | undefined>) => void,
   ): void
 
   dispose(cb: (data: any) => void): void
   prune(cb: (data: any) => void): void
   invalidate(message?: string): void
 
-  // `InferCustomEventPayload` bietet Typen für integrierte Vite-Ereignisse
-  on<T extends string>(
+  on<T extends CustomEventName>(
+    event: T,
+    cb: (payload: InferCustomEventPayload<T>) => void,
+  ): void
+  off<T extends CustomEventName>(
     event: T,
-    cb: (payload: InferCustomEventPayload<T>) => void
+    cb: (payload: InferCustomEventPayload<T>) => void,
   ): void
-  off<T extends string>(
+  send<T extends CustomEventName>(
     event: T,
-    cb: (payload: InferCustomEventPayload<T>) => void
+    data?: InferCustomEventPayload<T>,
   ): void
-  send<T extends string>(event: T, data?: InferCustomEventPayload<T>): void
 }
 ```