From 2cdfdba8a2076ea5204c0f8d5a172afae46e43ab Mon Sep 17 00:00:00 2001
From: bluwy <bjornlu.dev@gmail.com>
Date: Mon, 16 May 2022 00:23:59 +0800
Subject: [PATCH 1/2] docs(plugin-vue): clarify asset url handling

---
 packages/plugin-vue/README.md | 47 +++++++++++++++++++++++++++++------
 1 file changed, 39 insertions(+), 8 deletions(-)

diff --git a/packages/plugin-vue/README.md b/packages/plugin-vue/README.md
index a232982e8aed59..a7662e4171125d 100644
--- a/packages/plugin-vue/README.md
+++ b/packages/plugin-vue/README.md
@@ -51,6 +51,40 @@ export interface Options {
 }
 ```
 
+## Asset URL handling
+
+When `@vitejs/plugin-vue` compiles the `<template>` blocks in SFCs, it also converts any encountered asset URLs into ESM imports.
+
+For example, the following template snippet:
+
+```vue
+<img src="../image.png" />
+```
+
+Is the same as:
+
+```vue
+<script setup>
+import _imports_0 from '../image.png'
+</script>
+
+<img src="_imports_0" />
+```
+
+By default the following tag/attribute combinations are transformed, and can be configured using the `template.transformAssetUrls` option.
+
+```js
+{
+  video: ['src', 'poster'],
+  source: ['src'],
+  img: ['src'],
+  image: ['xlink:href', 'href'],
+  use: ['xlink:href', 'href']
+}
+```
+
+Note that only attribute values that are static strings are transformed. Otherwise, you'd need to import the asset manually, e.g. `import imgUrl from '../image.png'`.
+
 ## Example for passing options to `vue/compiler-sfc`:
 
 ```ts
@@ -64,14 +98,7 @@ export default {
           // ...
         },
         transformAssetUrls: {
-          // default tags
-          tags: {
-            video: ['src', 'poster'],
-            source: ['src'],
-            img: ['src'],
-            image: ['xlink:href', 'href'],
-            use: ['xlink:href', 'href']
-          }
+          // ...
         }
       }
     })
@@ -132,3 +159,7 @@ The `customElement` plugin option can be used to configure the behavior:
 ## License
 
 MIT
+
+```
+
+```

From 5d9c7cae4492f810f94b4b50022d8d4ffc1d1702 Mon Sep 17 00:00:00 2001
From: bluwy <bjornlu.dev@gmail.com>
Date: Mon, 16 May 2022 00:47:05 +0800
Subject: [PATCH 2/2] chore: fix typo

---
 packages/plugin-vue/README.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/plugin-vue/README.md b/packages/plugin-vue/README.md
index a7662e4171125d..ae848051cecd10 100644
--- a/packages/plugin-vue/README.md
+++ b/packages/plugin-vue/README.md
@@ -159,7 +159,3 @@ The `customElement` plugin option can be used to configure the behavior:
 ## License
 
 MIT
-
-```
-
-```