feat(wxt): expose file watcher options

[myjeong19]

Overview

Adds a watchOptions config option to wxt.config.ts so users can configure file watching behavior.

This is intended for environments where native file events may not be delivered reliably, such as Docker, devcontainers, WSL mounts, or network filesystems. In those cases, users can opt into polling with watchOptions: { usePolling: true } instead of relying on CHOKIDAR_USEPOLLING=1.

The options are forwarded to Vite's dev server watcher while preserving WXT's default ignored paths.

Manual Testing

Run the dev server e2e test

bun run --filter wxt test -- --run e2e/tests/dev.test.ts

This verifies that watchOptions is forwarded to Vite's dev server watcher while preserving usePolling, interval, WXT's default ignored paths, existing vite.server.watch, and custom ignored entries.

Docker & Dev Container manual checks

To manually verify the behavior, run a WXT project with:

export default defineConfig({
  watchOptions: {
    usePolling: true,
    interval: 1000,
  },
});

inside a Docker container or devcontainer, edit a mounted source file from inside the same container, and confirm that WXT logs the change and reloads the extension.

I also tested this branch in both a Docker container and a VS Code devcontainer with packages/wxt-demo using a temporary watchOptions: { usePolling: true, interval: 1000 } config. Editing an entrypoint file from inside the same container triggered reload in both cases.

Related Issue

This PR closes #2342

[netlify]

✅ Deploy Preview for creative-fairy-df92c4 ready!

Name	Link
🔨 Latest commit	bb1a577
🔍 Latest deploy log	https://app.netlify.com/projects/creative-fairy-df92c4/deploys/6a1b258e3354d9000801eed5
😎 Deploy Preview	https://deploy-preview-2398--creative-fairy-df92c4.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.