feat(types): support custom VitePreloadErrorEvent (#17615)

Author: btea

packages/vite/client.d.ts

@@ -246,3 +246,20 @@ declare module '*?inline' {
   const src: string
   export default src
 }
+
+declare interface VitePreloadErrorEvent extends Event {
+  payload: Error
+}
+
+declare interface Window {
+  addEventListener(
+    type: 'vite:preloadError',
+    listener: (this: Window, ev: VitePreloadErrorEvent) => unknown,
+    options?: boolean | AddEventListenerOptions,
+  ): void
+  removeEventListener(
+    type: 'vite:preloadError',
+    listener: (this: Window, ev: VitePreloadErrorEvent) => unknown,
+    options?: boolean | EventListenerOptions,
+  ): void
+}

packages/vite/src/node/plugins/importAnalysisBuild.ts

@@ -26,6 +26,8 @@ type FileDep = {
   runtime: boolean
 }
 
+type VitePreloadErrorEvent = Event & { payload: Error }
+
 /**
  * A flag for injected helpers. This flag will be set to `false` if the output
  * target is not native es - so that injected helper logic can be conditionally
@@ -145,8 +147,9 @@ function preload(
   return promise
     .then(() => baseModule())
     .catch((err) => {
-      const e = new Event('vite:preloadError', { cancelable: true })
-      // @ts-expect-error custom payload
+      const e = new Event('vite:preloadError', {
+        cancelable: true,
+      }) as VitePreloadErrorEvent
       e.payload = err
       window.dispatchEvent(e)
       if (!e.defaultPrevented) {