feat: support custom component id generator

Author: Jinjiang

packages/plugin-vue/src/index.ts

@@ -138,6 +138,23 @@ export interface Options {
      * - **default:** `false`
      */
     prodHydrationMismatchDetails?: boolean
+    /**
+     * Customize the component ID generation strategy.
+     * - `'filepath'`: hash the file path (relative to the project root)
+     * - `'filepath-source'`: hash the file path and the source code
+     * - `function`: custom function that takes the file path, source code,
+     *   whether in production mode, and the default hash function as arguments
+     * - **default:** `'filepath'` in development, `'filepath-source'` in production
+     */
+    componentIdGenerator?:
+      | 'filepath'
+      | 'filepath-source'
+      | ((
+          filepath: string,
+          source: string,
+          isProduction: boolean | undefined,
+          getHash: (text: string) => string,
+        ) => string)
   }
 
   /**

packages/plugin-vue/src/utils/descriptorCache.ts

@@ -22,7 +22,14 @@ const prevCache = new Map<string, SFCDescriptor | undefined>()
 export function createDescriptor(
   filename: string,
   source: string,
-  { root, isProduction, sourceMap, compiler, template }: ResolvedOptions,
+  {
+    root,
+    isProduction,
+    sourceMap,
+    compiler,
+    template,
+    features,
+  }: ResolvedOptions,
   hmr = false,
 ): SFCParseResult {
   const { descriptor, errors } = compiler.parse(source, {
@@ -34,7 +41,23 @@ export function createDescriptor(
   // ensure the path is normalized in a way that is consistent inside
   // project (relative to root) and on different systems.
   const normalizedPath = normalizePath(path.relative(root, filename))
-  descriptor.id = getHash(normalizedPath + (isProduction ? source : ''))
+
+  const componentIdGenerator = features?.componentIdGenerator
+  if (componentIdGenerator === 'filepath') {
+    descriptor.id = getHash(normalizedPath)
+  } else if (componentIdGenerator === 'filepath-source') {
+    descriptor.id = getHash(normalizedPath + source)
+  } else if (typeof componentIdGenerator === 'function') {
+    descriptor.id = componentIdGenerator(
+      normalizedPath,
+      source,
+      isProduction,
+      getHash,
+    )
+  } else {
+    descriptor.id = getHash(normalizedPath + (isProduction ? source : ''))
+  }
+
   ;(hmr ? hmrCache : cache).set(filename, descriptor)
   return { descriptor, errors }
 }