Bundler path transform in HTML is not being applied

[citriqa]

Describe the bug

In the documentation, it is said that assets can be imported using a path relative to the source root.
In practice, this is not possible.

Reproduction

repro.zip

Steps to reproduce

to recreate attached repro:

1. pnpm dlx wxt@latest init
2. choose vanilla and pnpm
3. pnpm install
4. alter entrypoints/popup/index.html to set the following as the body content:

    <img src="~/assets/typescript.svg" alt="root alias path"/>
    <img src="../../assets/typescript.svg" alt="relative path"/>

to observe the issue:

1. pnpm install
2. pnpm run dev
3. open popup by clicking on action button
4. observe the image only displaying once

System Info

System:
    OS: Linux 6.6 cpe:/o:nixos:nixos:24.11 24.11 (Vicuna)
    CPU: (16) x64 12th Gen Intel(R) Core(TM) i7-1260P
    Memory: 2.53 GB / 15.35 GB
    Container: Yes
    Shell: 5.2.37 - /nix/store/x9d49vaqlrkw97p9ichdwrnbh013kq7z-bash-interactive-5.2p37/bin/bash
  Binaries:
    Node: 23.6.0 - /nix/store/k5zdfljc7gahmdpjjq1y9x8hqs9hxn4g-nodejs-23.6.0/bin/node
    npm: 10.9.2 - /nix/store/k5zdfljc7gahmdpjjq1y9x8hqs9hxn4g-nodejs-23.6.0/bin/npm
    pnpm: 9.15.3 - /nix/store/aik0qrmx9wxy1q480lfwqv1wqsrhcsl8-pnpm-9.15.3/bin/pnpm
  Browsers:
    Chromium: 132.0.6834.110
  npmPackages:
    wxt: ^0.19.13 => 0.19.27

Used Package Manager

pnpm

Validations

• Read the Contributing Guidelines.
• Read the docs.
• Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.
• Check that this is a concrete bug. For Q&A open a GitHub Discussion or join our Discord Chat Server.
• The provided reproduction is a minimal reproducible example of the bug.

[aiktb]

https://vite.dev/guide/assets
This seems to be a WXT documentation error, as as far as I know Vite does not support automatic bundling of assets in <img src="...">.

You always need to use import:

<script setup>
import imageUrl from '@/assets/images/logo.svg' // => or relative path
</script>

<template>
  <img :src="imageUrl" alt="img" />
</template>

[aklinker1]

Can confirm that Vite doesn't support this. I'll update the docs accordingly.

vite-alias-test.zip

Not sure why I thought that was OK when I wrote those docs originally lol.