chore(release): analytics-v0.4.0

Fix build script
fix prepare script
2024-12-29 20:36:35 -06:00 · 2024-12-29 20:35:32 -06:00 · 2024-12-29 20:29:51 -06:00 · 2024-12-29 20:27:33 -06:00 · 2024-12-29 20:25:51 -06:00 · 2024-12-29 20:19:41 -06:00
98 changed files with 3783 additions and 3923 deletions
@@ -1,10 +0,0 @@
-extends:
-  - '@commitlint/config-conventional'
-rules:
-  subject-case:
-    - 0
-    - always
-    - - sentence-case
-      - start-case
-      - pascal-case
-      - upper-case
@@ -1,13 +1,5 @@
-# See https://git-scm.com/docs/gitattributes#_pattern_format for more about `.gitattributes`.
-
-# Normalize EOL for all files that Git considers text files
 * text=auto eol=lf
-
-# Mark lock files as generated to avoid diffing
 pnpm-lock.yaml linguist-generated
 package-lock.json linguist-generated
 bun.lockb linguist-generated
 yarn.lock linguist-generated
-
-# Exclude templates from language statistics
-templates/**/* linguist-vendored
@@ -1,9 +0,0 @@
-# Set default
-* @aklinker1 @Timeraa
-
-# Secure Directories
-/.github/ @aklinker1
-
-# Creator of specific wxt modules
-/packages/auto-icons/ @Timeraa
-/packages/unocss/ @Timeraa
@@ -1,3 +1,15 @@
-# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository#about-funding-files
+# These are supported funding model platforms

-github: wxt-dev
+github: [wxt-dev] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
@@ -1,31 +1,23 @@
 name: Basic Setup
 description: Install PNPM, Node, and dependencies
-
 inputs:
  install:
    default: 'true'
-    type: boolean
    description: Whether or not to run 'pnpm install'
-
  installArgs:
    default: ''
-    type: string
    description: Additional args to append to "pnpm install"
-
 runs:
  using: composite
-
  steps:
-    - name: 🛠️ Setup PNPM
+    - name: Setup PNPM
      uses: pnpm/action-setup@v4
-
-    - name: 🛠️ Setup NodeJS
+    - name: Setup NodeJS
      uses: actions/setup-node@v4
      with:
        node-version: 18
        cache: pnpm
-
-    - name: 📦 Install Dependencies
+    - name: Install Dependencies
      if: ${{ inputs.install == 'true' }}
      shell: bash
      run: pnpm install ${{ inputs.installArgs }}
@@ -6,7 +6,9 @@
 version: 2
 updates:
  - package-ecosystem: npm
-    directory: /
+    directories:
+      - /
+      - packages/*
    schedule:
      interval: 'monthly'
  - package-ecosystem: 'github-actions'
@@ -1,13 +0,0 @@
-### Overview
-
-<!-- Describe your changes and why you made them -->
-
-### Manual Testing
-
-<!-- Describe how to test your changes to make sure the PR works as intended -->
-
-### Related Issue
-
-<!-- If this PR is related to an issue, please link it here -->
-
-This PR closes #<issue_number>
@@ -1,4 +1,4 @@
-name: ✨ pkg.pr.new
+name: Continuous Publish
 on:
  push:
    branches:
@@ -7,22 +7,11 @@ on:
    branches:
      - main

-permissions:
-  contents: read
-
 jobs:
  build:
-    name: Publish Test Packages
    runs-on: ubuntu-22.04
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Build All Packages
-        run: pnpm buildc all
-
-      - name: Publish
-        run: pnpx pkg-pr-new publish --compact --pnpm './packages/*'
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - run: pnpm buildc all
+      - run: pnpx pkg-pr-new publish --compact './packages/*'
@@ -1,29 +0,0 @@
-name: 🎉 PR closed
-
-on:
-  pull_request_target:
-    types:
-      - closed
-
-permissions:
-  contents: read
-  pull-requests: write
-
-jobs:
-  thank-you:
-    runs-on: ubuntu-latest
-    if: github.event.pull_request.merged == true
-
-    steps:
-      - name: Post Thank You Comment
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
-        env:
-          comment: Thanks for helping make WXT better!
-        with:
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: process.env.comment
-            })
@@ -1,26 +0,0 @@
-name: 🛡️ Check PR Title
-
-on:
-  pull_request:
-    types: [opened, edited]
-
-jobs:
-  lint-pr-title:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-        with:
-          # Only fetch the config file from the repository
-          sparse-checkout-cone-mode: false
-          sparse-checkout: .commitlintrc.yml
-
-      - name: Install dependencies
-        run: npm install --global @commitlint/config-conventional commitlint
-
-      - name: Check PR title with commitlint
-        env:
-          PR_TITLE: ${{ github.event.pull_request.title }}
-          HELP_URL: https://github.com/wxt-dev/wxt/blob/main/CONTRIBUTING.md#conventional-pr-titles
-        run: echo "$PR_TITLE" | npx commitlint --help-url $HELP_URL
@@ -1,4 +1,4 @@
-name: 📝 Publish Docs
+name: Publish Docs
 on:
  push:
    branches:
@@ -10,38 +10,20 @@ on:
        required: true
        default: latest

-permissions:
-  contents: read
-
 jobs:
  publish:
    # Only run if it's the upstream repository, not forks
    if: github.repository == 'wxt-dev/wxt'
-    name: Publish Docs
    runs-on: ubuntu-22.04
-    permissions:
-      contents: write
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Login to Docker Registry
-        uses: docker/login-action@v3
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - uses: docker/login-action@v3
        with:
          registry: https://${{ secrets.DOCKER_REGISTRY_HOSTNAME }}
          username: ${{ secrets.DOCKER_REGISTRY_USERNAME }}
          password: ${{ secrets.DOCKER_REGISTRY_PASSWORD }}
-
-      - name: Build docs
-        run: |
-          pnpm docs:build
-          docker build docs/.vitepress -t ${{ secrets.DOCKER_REGISTRY_HOSTNAME }}/wxt/docs:${{ github.event.inputs.tag || 'latest' }}
-
-      - name: Push Image
-        run: docker push ${{ secrets.DOCKER_REGISTRY_HOSTNAME }}/wxt/docs:${{ github.event.inputs.tag || 'latest' }}
-
-      - name: Deploy
-        run: curl -X POST -i ${{ secrets.UPDATE_DOCS_WEBHOOK }}
+      - run: pnpm docs:build
+      - run: docker build docs/.vitepress -t ${{ secrets.DOCKER_REGISTRY_HOSTNAME }}/wxt/docs:${{ github.event.inputs.tag || 'latest' }}
+      - run: docker push ${{ secrets.DOCKER_REGISTRY_HOSTNAME }}/wxt/docs:${{ github.event.inputs.tag || 'latest' }}
+      - run: curl -X POST -i ${{ secrets.UPDATE_DOCS_WEBHOOK }}
@@ -1,4 +1,4 @@
-name: 🚀 Release
+name: Release
 on:
  workflow_dispatch:
    inputs:
@@ -7,6 +7,7 @@ on:
        default: wxt
        type: choice
        options:
+          - analytics
          - auto-icons
          - i18n
          - module-react
@@ -17,51 +18,38 @@ on:
          - unocss
          - wxt

-permissions:
-  contents: read
-
 jobs:
  validate:
-    name: Validate
    uses: './.github/workflows/validate.yml'
    secrets: inherit

  publish:
-    name: Publish
    runs-on: ubuntu-22.04
-    permissions:
-      contents: write
    needs:
      - validate
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
+      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Configure Git
-        run: |
-          git config user.name 'github-actions[bot]'
-          git config user.email 'github-actions[bot]@users.noreply.github.com'
-          git config --global push.followTags true
+      - uses: ./.github/actions/setup

      - name: Bump and Tag
        run: |
+          git config user.email "github-actions@users.noreply.github.com"
+          git config user.name "GitHub Actions"
          pnpm tsx scripts/bump-package-version.ts ${{ inputs.package }}
          git push
          git push --tags

-      - name: Publish to NPM
-        working-directory: packages/${{ inputs.package }}
+      - name: NPM
        run: |
          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_AUTH_TOKEN }}" > ~/.npmrc
          pnpm build
          pnpm publish
+        working-directory: packages/${{ inputs.package }}

-      - name: Create GitHub release
+      - name: GitHub Release
        run: pnpm tsx scripts/create-github-release.ts ${{ inputs.package }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -1,4 +1,4 @@
-name: 🔄 Sync Releases
+name: Sync Releases
 on:
  workflow_dispatch:
    inputs:
@@ -7,6 +7,7 @@ on:
        default: wxt
        type: choice
        options:
+          - analytics
          - auto-icons
          - i18n
          - module-react
@@ -16,25 +17,14 @@ on:
          - storage
          - wxt

-permissions:
-  contents: read
-
 jobs:
  sync:
-    name: Sync Releases
    runs-on: ubuntu-22.04
-    permissions:
-      contents: write
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
        with:
          installArgs: --ignore-scripts
-
-      - name: Sync Releases
-        run: pnpm tsx scripts/sync-releases.ts ${{ inputs.package }}
+      - run: pnpm tsx scripts/sync-releases.ts ${{ inputs.package }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -1,4 +1,4 @@
-name: 🛡️ Validate
+name: Validate
 on:
  workflow_call:
  pull_request:
@@ -6,90 +6,46 @@ on:
    branches:
      - main

-permissions:
-  contents: read
-
 jobs:
  checks:
-    name: Checks
    runs-on: ubuntu-22.04
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Basic Checks
-        run: pnpm check
-
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - run: pnpm check
  builds:
-    name: Builds
    runs-on: ubuntu-22.04
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Build All Packages
-        run: pnpm buildc all
-
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - run: pnpm buildc all
  build-demo:
-    name: Build Demo
    runs-on: ubuntu-22.04
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Build
-        run: pnpm build:all
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - run: pnpm build:all
        working-directory: packages/wxt-demo
-
-      - name: ZIP
-        run: pnpm wxt zip
+      - run: pnpm wxt zip
        working-directory: packages/wxt-demo
-
  tests:
-    name: Tests
    runs-on: ubuntu-22.04
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-
-      - name: Run Tests
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - uses: oven-sh/setup-bun@v2
+      - name: pnpm test:coverage
        run: pnpm test:coverage -- --reporter=default --reporter=hanging-process
-
-      - name: Upload Coverage
-        uses: codecov/codecov-action@v5
+      - uses: codecov/codecov-action@v5
        env:
          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
-
  windows-tests:
-    name: Windows Tests
    runs-on: windows-latest
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Run Tests
-        run: pnpm test
-
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - run: pnpm test
  template:
-    name: Template
    runs-on: ubuntu-22.04
    strategy:
      fail-fast: false
@@ -101,34 +57,19 @@ jobs:
          - vanilla
          - vue
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Pack WXT package
-        run: pnpm pack
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - run: pnpm pack
        working-directory: packages/wxt
-
-      - name: Install Dependencies
-        run: npm i
+      - run: npm i
        working-directory: templates/${{ matrix.template }}
-
-      - name: Install Packed WXT
-        run: npm i -D ../../packages/wxt/wxt-*.tgz
+      - run: npm i -D ../../packages/wxt/wxt-*.tgz
        working-directory: templates/${{ matrix.template }}
-
-      - name: Type Check Template
-        run: pnpm compile
+      - run: pnpm compile
        if: matrix.template != 'svelte'
        working-directory: templates/${{ matrix.template }}
-
-      - name: Type Check Template
-        run: pnpm check
+      - run: pnpm check
        if: matrix.template == 'svelte'
        working-directory: templates/${{ matrix.template }}
-
-      - name: Build Template
-        run: pnpm build
+      - run: pnpm build
        working-directory: templates/${{ matrix.template }}
@@ -1,41 +1,26 @@
-name: 📼 VHS
+name: vhs
 on:
  push:
    paths:
      - 'docs/tapes/*.tape'
  workflow_dispatch:

-permissions:
-  contents: read
-
 jobs:
  vhs:
-    name: Create VHS
    runs-on: ubuntu-22.04
-    permissions:
-      contents: write
    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
        with:
-          install: false
-
-      # This prevents pnpm dlx from downloading WXT in the video
-      - name: Pre-install WXT
+          install: 'false'
+      - name: Preinstall WXT
        run: |
          pnpm store add wxt@latest
          pnpm dlx wxt@latest --version
-
-      - name: Record VHS
-        uses: charmbracelet/vhs-action@v2.1.0
+      - uses: charmbracelet/vhs-action@v2.1.0
        with:
          path: 'docs/tapes/init-demo.tape'
-
-      - name: Save recorded GIF
-        uses: stefanzweifel/git-auto-commit-action@v5
+      - uses: stefanzweifel/git-auto-commit-action@v5
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
@@ -6,6 +6,7 @@
 .webextrc
 .wxt
 *.log
+/.vscode/
 /docs/.vitepress/cache
 coverage
 dist
@@ -1,7 +0,0 @@
-{
-  "recommendations": [
-    "davidanson.vscode-markdownlint",
-    "esbenp.prettier-vscode",
-    "github.vscode-github-actions"
-  ]
-}
@@ -1,14 +0,0 @@
-{
-  // Set default formatter
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-
-  "[json]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-  "[yaml]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-  "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-  "[markdown]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-
-  // Additional guidelines for Copilot
-  "github.copilot.chat.codeGeneration.instructions": [
-    { "file": "CONTRIBUTING.md" }
-  ]
-}
@@ -8,17 +8,9 @@ If you want to add a new feature, please create an issue or discussion first so

 ## Conventional Commits

-This project uses [Conventional Commit format](https://www.conventionalcommits.org/en/v1.0.0/) to automatically generate a changelog and better understand the changes in the project
+This project uses [Conventional Commits](https://www.conventionalcommits.org/en) to automate versioning. If you're a new contributor, don't worry about this. When you open a PR, a maintainer will change the PR's title so it's in the style of conventional commits, but that's all.

-Here are some examples of conventional commit messages:
-
- `feat: add new functionality`
- `fix: correct typos in code`
- `ci: add GitHub Actions for automated testing`
-
-## Conventional PR Titles
-
-The title of your pull request should follow the [conventional commit format](#conventional-commits). When a pull request is merged to the main branch, all changes are going to be squashed into a single commit. The message of this commit will be the title of the pull request. And for every release, the commit messages are used to generate the changelog.
+Maintainers, commits to the `main` branch (either directly or via PRs) must be valid conventional commits.

 ## Setup

@@ -1,15 +0,0 @@
-# Security Policy
-
-While WXT is in prerelease, only the latest version will receive security updates. The latest version is:
-
-<img alt="npm version" src="https://img.shields.io/npm/v/wxt?labelColor=black&color=%234fa048">
-
-<!--
-## Reporting a Vulnerability
-
-Use this section to tell people how to report a vulnerability.
-
-Tell them where to go, how often they can expect to get an update on a
-reported vulnerability, what to expect if the vulnerability is accepted or
-declined, etc.
-->
@@ -62,12 +62,6 @@ const chromeExtensionIds = [
  'hjjkgbibknbahijglkffklflidncplkn', // Show IP – Live View of Website IPs for Developers
  'ilbikcehnpkmldojkcmlldkoelofnbde', // Strong Password Generator
  'ocllfkhcdopiafndigclebelbecaiocp', // ZenGram: Mindful Instagram, Your Way
-  'odffpjnpocjfcaclnenaaaddghkgijdb', // Blync: Preview Links, Selection Search, AI Assistant
-  'kofbbilhmnkcmibjbioafflgmpkbnmme', // HTML to Markdown - Convert webpages to markdown
-  'boecmgggeigllcdocgioijmleimjbfkg', // Walmart WFS Profit Calculator
-  'dlnjcbkmomenmieechnmgglgcljhoepd', // Youtube Live Chat Fullscreen
-  'keiealdacakpnbbljlmhfgcebmaadieg', // Python Code Runner
-  'hafcajcllbjnoolpfngclfmmgpikdhlm', // Monochromate
 ];

 const { data, err, isLoading } = useListExtensionDetails(chromeExtensionIds);
@@ -14,7 +14,6 @@ import { version as i18nVersion } from '../../packages/i18n/package.json';
 import { version as autoIconsVersion } from '../../packages/auto-icons/package.json';
 import { version as unocssVersion } from '../../packages/unocss/package.json';
 import { version as storageVersion } from '../../packages/storage/package.json';
-import knowledge from 'vitepress-knowledge';

 const title = 'Next-gen Web Extension Framework';
 const titleSuffix = ' – WXT';
@@ -26,17 +25,6 @@ const ogImage = 'https://wxt.dev/social-preview.png';

 // https://vitepress.dev/reference/site-config
 export default defineConfig({
-  extends: knowledge({
-    serverUrl: 'https://knowledge.wxt.dev',
-    paths: {
-      '/': 'docs',
-      '/api/': 'api-reference',
-    },
-    pageSelectors: {
-      'examples.md': '#VPContent > .VPPage',
-    },
-  }),
-
  titleTemplate: `:title${titleSuffix}`,
  title: 'WXT',
  description,
@@ -164,7 +152,6 @@ export default defineConfig({
        menuGroup('Resources', '/guide/resources/', [
          menuItem('Compare', 'compare.md'),
          menuItem('FAQ', 'faq.md'),
-          menuItem('Community', 'community.md'),
          menuItem('Upgrading WXT', 'upgrading.md'),
          menuItem('Migrate to WXT', 'migrate.md'),
          menuItem('How WXT Works', 'how-wxt-works.md'),
@@ -28,13 +28,13 @@ export function menuRoot(items: SidebarItem[]) {
 export function menuGroup(
  text: string,
  items: SidebarItem[],
-  collapsible?: boolean,
+  collapsable?: boolean,
 ): SidebarItem;
 export function menuGroup(
  text: string,
  base: string,
  items: SidebarItem[],
-  collapsible?: boolean,
+  collapsable?: boolean,
 ): SidebarItem;
 export function menuGroup(
  text: string,
@@ -16,8 +16,7 @@ img.src = imageUrl;
 ```

 ```html [HTML]
-<!-- In HTML tags, you must use the relative path --->
-<img src="../assets/image.png" />
+<img src="~/assets/image.png" />
 ```

 ```css [CSS]
@@ -26,22 +25,6 @@ img.src = imageUrl;
 }
 ```

-```vue [Vue]
-<script>
-import image from '~/assets/image.png';
-</script>
-
-<template>
-  <img :src="image" />
-</template>
-```
-
-```jsx [JSX]
-import image from '~/assets/image.png';
-
-<img src={image} />;
-```
-
 :::

 ## `/public` Directory
@@ -69,16 +52,6 @@ img.src = imageUrl;
 }
 ```

-```vue [Vue]
-<template>
-  <img src="/image.png" />
-</template>
-```
-
-```jsx [JSX]
-<img src="/image.png" />
-```
-
 :::

 ## Inside Content Scripts
@@ -141,7 +114,7 @@ export default defineConfig({
  manifest: {
    web_accessible_resources: [
      {
-        // We'll use this matches in the content script as well
+        // We'll use this matches in the cotent script as well
        matches: ['*://*.github.com/*'],
        // Use the same path as `relativeDest` from the WXT module
        resources: ['/oxc_parser_wasm_bg.wasm'],
@@ -11,7 +11,7 @@ export default defineConfig({
 });
 ```

-By default, WXT sets up auto-imports for all of it's own APIs:
+By default, WXT automatically setups up auto-imports for all of it's own APIs:

 - [`browser`](/api/reference/wxt/browser/variables/browser) from `wxt/browser`
 - [`defineContentScript`](/api/reference/wxt/sandbox/functions/defineContentScript) from `wxt/sandbox`
@@ -6,7 +6,7 @@ outline: deep

 > See the [API Reference](/api/reference/wxt/interfaces/ExtensionRunnerConfig) for a full list of config.

-During development, WXT uses [`web-ext` by Mozilla](https://www.npmjs.com/package/web-ext) to automatically open a browser window with your extension installed.
+During development WXT uses [`web-ext` by Mozilla](https://www.npmjs.com/package/web-ext) to automatically open a browser window with your extension installed.

 ## Config Files

@@ -41,8 +41,6 @@ export default defineRunnerConfig({
 });
 ```

-By default, WXT will try to automatically discover where Chrome/Firefox are installed. However, if you have chrome installed in a non-standard location, you need to set it manually as shown above.
-
 ### Persist Data

 By default, to keep from modifying your browser's existing profiles, `web-ext` creates a brand new profile every time you run the `dev` script.
@@ -74,7 +72,7 @@ export default defineRunnerConfig({
 Now, next time you run the `dev` script, a persistent profile will be created in `.wxt/chrome-data/{profile-name}`. With a persistent profile, you can install devtools extensions to help with development, allow the browser to remember logins, etc, without worrying about the profile being reset the next time you run the `dev` script.

 :::tip
-You can use any directory you'd like for `--user-data-dir`, the examples above create a persistent profile for each WXT project. To create a profile for all WXT projects, you can put the `chrome-data` directory inside your user's home directory.
+You can use any directory you'd like for `--user-data-dir`, the examples above create a persistent profile for each WXT project. To create a profile for all WXT projects, you can put the `chrome-data` directory inside you're user's home directory.
 :::

 ### Disable Opening Browser
@@ -1,17 +1,10 @@
 # Manifest

-In WXT, there is no `manifest.json` file in your source code. Instead, WXT generates the manifest from multiple sources:
+In WXT, there is no `manifest.json` file in your source code. Instead, WXT generates it during the build process based off files in your project.

- Global options [defined in your `wxt.config.ts` file](#global-options)
- Entrypoint-specific options [defined in your entrypoints](/guide/essentials/entrypoints#defining-manifest-options)
- [WXT Modules](/guide/essentials/wxt-modules) added to your project can modify your manifest
- [Hooks](/guide/essentials/config/hooks) defined in your project can modify your manifest
+## Manifest Config

-Your extension's `manifest.json` will be output to `.output/{target}/manifest.json` when running `wxt build`.
-
-## Global Options
-
-To add a property to your manifest, use the `manifest` config inside your `wxt.config.ts`:
+To manually add a property to the `manifest.json` output during builds, use the `manifest` config inside `wxt.config.ts`:

 ```ts
 export default defineConfig({
@@ -137,7 +130,7 @@ public/
 └─ icon-128.png
 ```

-Specifically, an icon must match one of these regex to be discovered:
+Specifically, if an icon must match one of these regex to be discovered:

 <<< @/../packages/wxt/src/core/utils/manifest.ts#snippet

@@ -223,7 +216,22 @@ By default, whenever an `action` is generated, WXT falls back to `browser_action

 ### Action With Popup

-To generate a manifest where a UI appears after clicking the icon, just create a [Popup entrypoint](/guide/essentials/entrypoints#popup). If you want to use a `page_action` for MV2, add the following meta tag to the HTML document's head:
+To generate a manifest where a UI appears after clicking the icon, just create a [Popup entrypoint](/guide/essentials/entrypoints#popup).
+
+```ts
+export default defineConfig({
+  hooks: {
+    build: {
+      manifestGenerated(manifest) {
+        // Update the manifest variable by reference
+        manifest.name = 'Overriden name';
+      },
+    },
+  },
+});
+```
+
+If you want to use a `page_action` for MV2, add the following meta tag to the HTML document's head:

 ```html
 <meta name="manifest.type" content="page_action" />
@@ -14,7 +14,7 @@ At a minimum, you need to create a TSConfig in your root directory that looks li
 Or if you're in a monorepo, you may not want to extend the config. If you don't extend it, you need to add `.wxt/wxt.d.ts` to the TypeScript project:

 ```ts
-/// <reference path="./.wxt/wxt.d.ts" />
+/// <reference types="./.wxt/wxt.d.ts" />
 ```

 ## Compiler Options
@@ -4,14 +4,12 @@ outline: deep

 # Content Scripts

-> To create a content script, see [Entrypoint Types](/guide/essentials/entrypoints#content-scripts).
-
 ## Context

-The first argument to a content script's `main` function is its "context".
+The first argument to a content script's `main` function is it's "context".

 ```ts
-// entrypoints/example.content.ts
+// entrypoints/content.ts
 export default defineContentScript({
  main(ctx) {},
 });
@@ -64,7 +62,7 @@ In regular web extensions, CSS for content scripts is usually a separate CSS fil
 In WXT, to add CSS to a content script, simply import the CSS file into your JS entrypoint, and WXT will automatically add the bundled CSS output to the `css` array.

 ```ts
-// entrypoints/example.content/index.ts
+// entrypoints/content/index.ts
 import './style.css';

 export default defineContentScript({
@@ -80,16 +78,16 @@ To create a standalone content script that only includes a CSS file:
   // wxt.config.ts
   export default defineConfig({
     hooks: {
-       'build:manifestGenerated': (wxt, manifest) => {
+       "build:manifestGenerated": (wxt, manifest) => {
         manifest.content_scripts ??= [];
         manifest.content_scripts.push({
           // Build extension once to see where your CSS get's written to
-           css: ['content-scripts/example.css'],
-           matches: ['*://*/*'],
-         });
-       },
-     },
-   });
+           css: ["content-scripts/example.css"],
+           matches: ["*://*/*"]
+         )
+       }
+     }
+   })
   ```

 ## UI
@@ -200,7 +198,6 @@ export default defineContentScript({
 ```ts [Svelte]
 // entrypoints/example-ui.content/index.ts
 import App from './App.svelte';
-import { mount, unmount } from 'svelte';

 export default defineContentScript({
  matches: ['<all_urls>'],
@@ -211,13 +208,14 @@ export default defineContentScript({
      anchor: 'body',
      onMount: (container) => {
        // Create the Svelte app inside the UI container
-        mount(App, {
+        const app = new App({
          target: container,
        });
+        return app;
      },
      onRemove: (app) => {
        // Destroy the app when the UI is removed
-        unmount(app);
+        app.$destroy();
      },
    });

@@ -381,7 +379,6 @@ export default defineContentScript({
 // 1. Import the style
 import './style.css';
 import App from './App.svelte';
-import { mount, unmount } from 'svelte';

 export default defineContentScript({
  matches: ['<all_urls>'],
@@ -396,13 +393,14 @@ export default defineContentScript({
      anchor: 'body',
      onMount: (container) => {
        // Create the Svelte app inside the UI container
-        mount(App, {
+        const app = new App({
          target: container,
        });
+        return app;
      },
-      onRemove: () => {
+      onRemove: (app) => {
        // Destroy the app when the UI is removed
-        unmount(app);
+        app?.$destroy();
      },
    });

@@ -568,20 +566,6 @@ export default defineContentScript({
 });
 ```

-```json
-export default defineConfig({
-  manifest: {
-    // ...
-    web_accessible_resources: [
-      {
-        resources: ["example-main-world.js"],
-        matches: ["*://*/*"],
-      }
-    ]
-  }
-});
-```
-
 `injectScript` works by creating a `script` element on the page pointing to your script. This loads the script into the page's context so it runs in the main world.

 `injectScript` returns a promise, that when resolved, means the script has been evaluated by the browser and you can start communicating with it.
@@ -28,7 +28,7 @@ For web extensions, there are two types of entrypoints:
 - **Listed**: Referenced in the `manifest.json`
 - **Unlisted**: Not referenced in the `manifest.json`

-Throughout the rest of WXT's documentation, listed entrypoints are referred to by name. For example:
+Throughout the rest of WXT's documentation, listed files are referred to by name. For example:

 - Popup
 - Options
@@ -42,7 +42,7 @@ Some examples of "unlisted" entrypoints:
 - JS files injected by content scripts into the page's main world

 :::tip
-Regardless of whether an entrypoint is listed or unlisted, it will still be bundled into your extension and be available at runtime.
+Regardless of whether a entrypoint is listed or unlisted, it will still be bundled into your extension and be available at runtime.
 :::

 ## Adding Entrypoints
@@ -72,7 +72,7 @@ Refer to the [Entrypoint Types](#entrypoint-types) section for the full list of

 ## Defining Manifest Options

-Most listed entrypoints have options that need to be added to the `manifest.json`. However with WXT, instead of defining the options in a separate file, _you define these options inside the entrypoint file itself_.
+Most listed entrypoints have options that need to be added to the `manifest.json`. With WXT however, instead of defining the options in a separate file, _you define these options inside the entrypoint file itself_.

 For example, here's how to define `matches` for content scripts:

@@ -86,17 +86,6 @@ export default defineContentScript({
 });
 ```

-For HTML entrypoints, options are configured as `<meta>` tags. For example, to use a `page_action` for your MV2 popup:
-
-```html
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta name="manifest.type" content="page_action" />
-  </head>
-</html>
-```
-
 > Refer to the [Entrypoint Types](#entrypoint-types) sections for a list of options configurable inside each entrypoint, and how to define them.

 When building your extension, WXT will look at the options defined in your entrypoints, and generate the manifest accordingly.
@@ -553,4 +542,4 @@ const url = browser.runtime.getURL('/<name>.js');
 console.log(url); // "chrome-extension://<id>/<name>.js"
 ```

-You are responsible for loading/running these scripts where needed. If necessary, don't forget to add the script and/or any related assets to [`web_accessible_resources`](https://developer.chrome.com/docs/extensions/reference/manifest/web-accessible-resources).
+You are responsible for loading/running these scripts where needed. If necessary, don't forget to add the script and/or any related stylesheets to [`web_accessible_resources`](https://developer.chrome.com/docs/extensions/reference/manifest/web-accessible-resources).
@@ -1,10 +1,12 @@
 # ES Modules

-You source code should always be written as ESM. However, you have some control whether an entrypoint is bundled as ESM.
+Currently, ESM entrypoints are opt-in, so you must configure each entrypoint with that in mind.

 ## HTML Pages <Badge type="warning" text="≥0.0.1" />

-Vite only supports bundling JS from HTML pages as ESM. Ensure you have added `type="module"` to your `<script>` tags:
+In general, you should always make HTML pages import ESM scripts, unless you need to support old browsers.
+
+To make a script ESM, add `type="module"`:

 <!-- prettier-ignore -->
 ```html
@@ -14,7 +16,7 @@ Vite only supports bundling JS from HTML pages as ESM. Ensure you have added `ty

 ## Background <Badge type="warning" text="≥0.16.0" />

-By default, your background will be bundled into a single file as IIFE. You can change this by setting `type: "module"` in your background entrypoint:
+In your background script, set `type: "module"`:

 ```ts
 export default defineBackground({
@@ -25,14 +27,12 @@ export default defineBackground({
 });
 ```

-This will change the output format to ESM, enable code-spliting between your background script and HTML pages, and set `"type": "module"` in your manifest.
-
 :::warning
 Only MV3 supports ESM background scripts/service workers. When targeting MV2, the `type` option is ignored and the background is always bundled into a single file as IIFE.
 :::

 ## Content Scripts

-WXT does not yet include built-in support for bundling content scripts as ESM. The plan is to add support for chunking to reduce bundle size, but not support HMR for now. There are several technical issues that make implementing a generic solution for HMR impossible. See [Content Script ESM Support #357](https://github.com/wxt-dev/wxt/issues/357) for details.
+WXT does not yet include built-in support for ESM content scripts. The plan is to add support for chunking to reduce bundle size, but not support HMR for now. There are several technical issues that make implementing a generic solution for HMR impossible. See [Content Script ESM Support #357](https://github.com/wxt-dev/wxt/issues/357) for details.

-If you can't wait, and need ESM support right now, you can implement ESM support manually. See the [ESM Content Script UI](https://github.com/wxt-dev/examples/tree/main/examples/esm-content-script-ui) example to learn how.
+If you can't wait, and need ESM support right now, you can implement ESM support manually. See the [ESM Content Script UI](https://github.com/wxt-dev/examples/tree/main/examples/esm-content-script-ui) example to get started.
@@ -81,10 +81,6 @@ However, it is recommended you stick with the vanilla API (or a package based on
 - Translations are not bundled multiple times, keeping your extension small
 - Zero configuration

-However, there is one major downside to the vanilla API and any packages built on top of it:
-
- Language cannot be changed without changing your browser/system language
-
 Here are some examples of how to setup a third party i18n library:

 - [vue-i18n](https://github.com/wxt-dev/wxt-examples/tree/main/examples/vue-i18n)
@@ -14,4 +14,3 @@ Here are some popular messaging libraries that support all browsers and work wit
 - [`webext-bridge`](https://www.npmjs.com/package/webext-bridge) - Messaging in WebExtensions made super easy. Out of the box.
 - [`@webext-core/messaging`](https://www.npmjs.com/package/@webext-core/messaging) - Light weight, type-safe wrapper around the web extension messaging APIs
 - [`@webext-core/proxy-service`](https://www.npmjs.com/package/@webext-core/proxy-service) - A type-safe wrapper around the web extension messaging APIs that lets you call a function from anywhere, but execute it in the background.
- [`Comctx`](https://github.com/molvqingtai/comctx) - Cross-context RPC solution with type safety and flexible adapters.
@@ -59,24 +59,24 @@ After enabling it, your project structure should look like this:
 <!-- prettier-ignore -->
 ```html
 📂 {rootDir}/
-   📁 .output/
-   📁 .wxt/
-   📂 src/
-      📁 assets/
-      📁 components/
-      📁 composables/
-      📁 entrypoints/
-      📁 hooks/
-      📁 modules/
-      📁 public/
-      📁 utils/
-      📄 app.config.ts
-   📄 .env
-   📄 .env.publish
-   📄 package.json
-   📄 tsconfig.json
-   📄 web-ext.config.ts
-   📄 wxt.config.ts
+📁 .output/
+📁 .wxt/
+📂 src/
+   📁 assets/
+   📁 components/
+   📁 composables/
+   📁 entrypoints/
+   📁 hooks/
+   📁 modules/
+   📁 public/
+   📁 utils/
+   📄 app.config.ts
+📄 .env
+📄 .env.publish
+📄 package.json
+📄 tsconfig.json
+📄 web-ext.config.ts
+📄 wxt.config.ts
 ```

 ## Customizing Other Directories
@@ -121,4 +121,3 @@ Once you've run the `dev` command, continue to [Next Steps](#next-steps)!
 - Keep reading on about WXT's [Project Structure](/guide/essentials/project-structure) and other essential concepts to learn
 - Configure [automatic browser startup](/guide/essentials/config/browser-startup) during dev mode
 - Explore [WXT's example library](/examples) to see how to use specific APIs or perform common tasks
- Checkout the [community page](/guide/resources/community) for a list of resources made by the community!
@@ -1,14 +0,0 @@
-# Community
-
-This page is dedicated to all the awesome people how have made something for WXT or that works with WXT. Blog posts, YouTube videos, NPM packages, etc. If a section doesn't exist for the thing you made, add one!
-
-[[toc]]
-
-## Blog Posts
-
- [Building Modern Cross Browser Web Extensions](https://aabidk.dev/tags/wxt/) by Aabid ([@aabidk20](https://github.com/aabidk20))
-
-## NPM Packages
-
- [`@webext-core/*`](https://webext-core.aklinker1.io/): Easy-to-use utilities for writing and testing web extensions that work on all browsers.
- [`Comctx`](https://github.com/molvqingtai/comctx): Cross-context RPC solution with type safety and flexible adapters.
@@ -10,7 +10,6 @@ Lets compare the features of WXT vs [Plasmo](https://docs.plasmo.com/framework)

 | Features                                                |   WXT   | Plasmo  |  CRXJS  |
 | ------------------------------------------------------- | :-----: | :-----: | :-----: |
-| Maintained                                              |   ✅    | 🟡 [^n] | 🟡 [^m] |
 | Supports all browsers                                   |   ✅    |   ✅    | 🟡 [^j] |
 | MV2 Support                                             |   ✅    |   ✅    | 🟡 [^a] |
 | MV3 Support                                             |   ✅    |   ✅    | 🟡 [^a] |
@@ -65,7 +64,3 @@ Lets compare the features of WXT vs [Plasmo](https://docs.plasmo.com/framework)
 [^k]: There is no built-in wrapper around this API. However, you can still access the standard APIs via `chrome`/`browser` globals or use any 3rd party NPM package.

 [^l]: WIP, moving very slowly. Follow [wxt-dev/wxt#357](https://github.com/wxt-dev/wxt/issues/357) for updates.
-
-[^m]: See [crxjs/chrome-extension-tools#974](https://github.com/crxjs/chrome-extension-tools/discussions/974)
-
-[^n]: Appears to be in maintenance mode with little to no maintainers nor feature development happening and _(see [wxt-dev/wxt#1404 (comment)](https://github.com/wxt-dev/wxt/pull/1404#issuecomment-2643089518))_
@@ -28,147 +28,47 @@ See https://wxt.dev/guide/essentials/config/browser-startup.html#persist-data

 ## My component library doesn't work in content scripts!

-This is usually caused by one of two things (or both) when using `createShadowRootUi`:
+Component libraries place their CSS in the document's `<head>` by default. When using `createShadowRootUi`, your UI is isolated from the document's styles because it's inside a ShadowRoot.

-1. Styles are added outside the `ShadowRoot`
+To fix this, you need to tell your component library to insert it's CSS inside the shadow root. Here's the docs for a couple of popular libraries:

-   :::details
-   Some component libraries manually add CSS to the page by adding a `<style>` or `<link>` element. They place this element in the document's `<head>` by default. This causes your styles to be placed outside the `ShadowRoot` and it's isolation blocks the styles from being applied to your UI.
+- React
+  - Ant Design: [`StyleProvider`](https://ant.design/docs/react/compatible-style#shadow-dom-usage)
+  - Mantine: [`MantineProvider#getRootElement` and `MantineProvider#cssVariablesSelector`](https://mantine.dev/theming/mantine-provider/)

-   When a library does this, **you need to tell the library where to put its styles**. Here's the documentation for a few popular component libraries:
+> If your library isn't listed above, try searching it's docs/issues for "shadow root", "shadow dom", or "css container".

-   - Ant Design: [`StyleProvider`](https://ant.design/docs/react/compatible-style#shadow-dom-usage)
-   - Mantine: [`MantineProvider#getRootElement` and `MantineProvider#cssVariablesSelector`](https://mantine.dev/theming/mantine-provider/)
+`createShadowRootUi` provides it's own `<head>` element inside the shadow root, so that were you should tell the library to add the CSS. Here's an example with Ant Design:

-   > If your library isn't listed above, try searching it's docs/issues for "shadow root", "shadow dom", or "css container". Not all libraries support shadow DOMs, you may have to open an issue to request this feature.
+```tsx
+import { StyleProvider } from '@ant-design/cssinjs'; // [!code ++]
+import ReactDOM from 'react-dom/client';
+import App from './App.tsx';

-   Here's an example of configuring Antd's styles:
+const ui = await createShadowRootUi(ctx, {
+  name: 'example-ui',
+  position: 'inline',
+  anchor: 'body',
+  onMount: (container) => { // [!code --]
+  onMount: (container, shadow) => { // [!code ++]
+    const cssContainer = shadow.querySelector("head")!; // [!code ++]
+    const root = ReactDOM.createRoot(container);
+    root.render(
+      <StyleProvider container={cssContainer}> // [!code ++]
+        <App />
+      </StyleProvider> // [!code ++]
+    );
+    return root;
+  },
+  onRemove: (root) => {
+    root?.unmount();
+  },
+});
+```

-   ```tsx
-   import { StyleProvider } from '@ant-design/cssinjs';
-   import ReactDOM from 'react-dom/client';
-   import App from './App.tsx';
+Note that this doesn't effect all component libraries, just ones that inject CSS themselves rather than having you import their CSS. This approach is more prevailent in the React community, but not limited to it. That's why only React libraries are listed above. Vuetify, for example, works just fine because you import its CSS - WXT picks up on this and the CSS is added inside the shadow root automatically:

-   const ui = await create`ShadowRoot`Ui(ctx, {
-     // ...
-     onMount: (container, shadow) => {
-       const cssContainer = shadow.querySelector('head')!;
-       const root = ReactDOM.createRoot(container);
-       root.render(
-         <StyleProvider container={cssContainer}>
-           <App />
-         </StyleProvider>,
-       );
-       return root;
-     },
-   });
-   ```
-
-   :::
-
-2. UI elements are added outside the `ShadowRoot`
-
-   ::::::details
-   This is mostly caused by `Teleport` or `Portal` components that render an element somewhere else in the DOM, usually in the document's `<body>`. This is usually done for dialogs or popover components. This renders the element is outside the `ShadowRoot`, so styles are not applied to it.
-
-   To fix this, **you need to both provide a target to your app AND pass the target to the `Teleport`/`Portal`**.
-
-   First, store the reference to the `ShadowRoot`'s `<body>` element (not the document's `<body>`):
-
-   :::code-group
-
-   ```ts [Vue]
-   import { createApp } from 'vue';
-   import App from './App.vue';
-
-   const ui = await create`ShadowRoot`Ui(ctx, {
-     // ...
-     onMount: (container, shadow) => {
-       const teleportTarget = shadow.querySelector('body')!;
-       const app = createApp(App)
-         .provide('TeleportTarget', teleportTarget)
-         .mount(container);
-       return app;
-     },
-   });
-   ui.mount();
-   ```
-
-   ```tsx [React]
-   // hooks/PortalTargetContext.ts
-   import { createContext } from 'react';
-
-   export const PortalTargetContext = createContext<HTMLElement>();
-
-   // entrypoints/example.content.ts
-   import ReactDOM from 'react-dom/client';
-   import App from './App.tsx';
-   import PortalTargetContext from '~/hooks/PortalTargetContext';
-
-   const ui = await create`ShadowRoot`Ui(ctx, {
-     // ...
-     onMount: (container, shadow) => {
-       const portalTarget = shadow.querySelector('body')!;
-       const root = ReactDOM.createRoot(container);
-       root.render(
-         <PortalTargetContext.Provider value={portalTarget}>
-           <App />
-         </PortalTargetContext.Provider>,
-       );
-       return root;
-     },
-   });
-   ui.mount();
-   ```
-
-   :::
-
-   Then use the reference when teleporting/portaling part of your UI to a different place in the DOM:
-
-   :::code-group
-
-   ```vue [Vue]
-   <script lang="ts" setup>
-   import { Teleport } from 'vue';
-
-   const teleportTarget = inject('TeleportTarget');
-   </script>
-
-   <template>
-     <div>
-       <Teleport :to="teleportTarget">
-         <dialog>My dialog</dialog>
-       </Teleport>
-     </div>
-   </template>
-   ```
-
-   ```tsx [React]
-   import { useContext } from 'react';
-   import { createPortal } from 'react-dom';
-   import PortalTargetContext from '~/hooks/PortalTargetContext';
-
-   const MyComponent = () => {
-     const portalTarget = useContext(PortalTargetContext);
-
-     return <div>{createPortal(<dialog>My dialog</dialog>, portalTarget)}</div>;
-   };
-   ```
-
-   :::
-
-   If you use ShadCN, [see this blog post](https://aabidk.dev/blog/building-modern-cross-browser-web-extensions-content-scripts-and-ui/#using-radixui-portals-to-move-the-dialog-to-shadow-dom).
-
-   ::::::
-
-Both issues have the same cause: the library puts something outside the `ShadowRoot`, and the `ShadowRoot`'s isolation prevents CSS from being applied to your UI.
-
-Both issues have the same fix: tell the library to put elements inside the `ShadowRoot`, not outside it. See the details above for more information and example fixes for each problem.
-
-## Is there an LLM trained on WXT's docs that I chat with?
-
-Not yet, but we're working on it. For now, https://wxt.dev hosts pre-aggregated and pre-formatted knowledge files containing all the docs from this website:
-
- Index listing available knowledge files: https://wxt.dev/knowledge/index.json
-
-You don't need to crawl the entire website, these files already contain all the relevant docs for training a LLM on WXT. But feel free to crawl it and generate your own files if you want!
+```ts
+import 'vuetify/styles'; // <-- This line imports the CSS, just like importing a .css file
+import { createVuetify } from 'vuetify';
+```
@@ -4,7 +4,7 @@
  "engines": {
    "node": ">=18.20.3"
  },
-  "packageManager": "pnpm@10.5.2",
+  "packageManager": "pnpm@9.13.0",
  "scripts": {
    "check": "check && pnpm -r --sequential run check",
    "test": "pnpm -r --sequential run test run",
@@ -17,31 +17,28 @@
    "docs:preview": "pnpm -s docs:gen && vitepress preview docs"
  },
  "devDependencies": {
-    "@aklinker1/buildc": "catalog:",
-    "@aklinker1/check": "catalog:",
-    "@commitlint/config-conventional": "catalog:",
-    "@commitlint/types": "catalog:",
-    "@types/fs-extra": "catalog:",
-    "@vitest/coverage-v8": "catalog:",
-    "changelogen": "catalog:",
-    "consola": "catalog:",
-    "fast-glob": "catalog:",
-    "fs-extra": "catalog:",
-    "lint-staged": "catalog:",
-    "markdown-it-footnote": "catalog:",
-    "nano-spawn": "catalog:",
-    "prettier": "catalog:",
-    "simple-git-hooks": "catalog:",
-    "tsx": "catalog:",
-    "typedoc": "catalog:",
-    "typedoc-plugin-frontmatter": "catalog:",
-    "typedoc-plugin-markdown": "catalog:",
-    "typedoc-vitepress-theme": "catalog:",
-    "typescript": "catalog:",
-    "vitepress": "catalog:",
-    "vitepress-knowledge": "catalog:",
-    "vitest-mock-extended": "catalog:",
-    "vue": "catalog:",
+    "@aklinker1/buildc": "^1.1.4",
+    "@aklinker1/check": "^1.4.5",
+    "@types/fs-extra": "^11.0.4",
+    "@vitest/coverage-v8": "^2.1.4",
+    "changelogen": "^0.5.7",
+    "consola": "^3.2.3",
+    "fast-glob": "^3.3.2",
+    "fs-extra": "^11.2.0",
+    "lint-staged": "^15.2.10",
+    "markdown-it-footnote": "^4.0.0",
+    "nano-spawn": "^0.2.0",
+    "prettier": "^3.3.3",
+    "simple-git-hooks": "^2.11.1",
+    "tsx": "4.15.7",
+    "typedoc": "^0.25.4",
+    "typedoc-plugin-frontmatter": "^1.1.0",
+    "typedoc-plugin-markdown": "4.0.0-next.23",
+    "typedoc-vitepress-theme": "1.0.0-next.3",
+    "typescript": "^5.6.3",
+    "vitepress": "^1.5.0",
+    "vitest-mock-extended": "^2.0.2",
+    "vue": "^3.5.12",
    "wxt": "workspace:*"
  },
  "simple-git-hooks": {
@@ -0,0 +1,174 @@
+# WXT Analytics
+
+Report analytics events from your web extension extension.
+
+## Supported Analytics Providers
+
+- [Google Analytics 4 (Measurement Protocol)](#google-analytics-4-measurement-protocol)
+- [Umami](#umami)
+
+## Install With WXT
+
+1. Install the NPM package:
+   ```bash
+   pnpm i @wxt-dev/analytics
+   ```
+2. In your `wxt.config.ts`, add the WXT module:
+   ```ts
+   export default defineConfig({
+     modules: ['@wxt-dev/analytics/module'],
+   });
+   ```
+3. In your `<srcDir>/app.config.ts`, add a provider:
+
+   ```ts
+   // <srcDir>/app.config.ts
+   import { umami } from '@wxt-dev/analytics/providers/umami';
+
+   export default defineAppConfig({
+     analytics: {
+       debug: true,
+       providers: [
+         // ...
+       ],
+     },
+   });
+   ```
+
+4. Then use the `#analytics` module to report events:
+
+   ```ts
+   import { analytics } from '#analytics';
+
+   await analytics.track('some-event');
+   await analytics.page();
+   await analytics.identify('some-user-id');
+   analytics.autoTrack(document.body);
+   ```
+
+## Install Without WXT
+
+1. Install the NPM package:
+   ```bash
+   pnpm i @wxt-dev/analytics
+   ```
+2. Create an `analytics` instance:
+
+   ```ts
+   // utils/analytics.ts
+   import { createAnalytics } from '@wxt-dev/analytics';
+
+   export const analytics = createAnalytics({
+     providers: [
+       // ...
+     ],
+   });
+   ```
+
+3. Import your analytics module in the background to initialize the message listener:
+   ```ts
+   // background.ts
+   import './utils/analytics';
+   ```
+4. Then use your `analytics` instance to report events:
+
+   ```ts
+   import { analytics } from './utils/analytics';
+
+   await analytics.track('some-event');
+   await analytics.page();
+   await analytics.identify('some-user-id');
+   analytics.autoTrack(document.body);
+   ```
+
+## Providers
+
+### Google Analytics 4 (Measurement Protocol)
+
+The [Measurement Protocol](https://developers.google.com/analytics/devguides/collection/protocol/ga4) is an alternative to GTag for reporting events to Google Analytics for MV3 extensions.
+
+> [Why use the Measurement Protocol instead of GTag?](https://developer.chrome.com/docs/extensions/how-to/integrate/google-analytics-4#measurement-protocol)
+
+Follow [Google's documentation](https://developer.chrome.com/docs/extensions/how-to/integrate/google-analytics-4#setup-credentials) to obtain your credentials and put them in your `.env` file:
+
+```dotenv
+WXT_GA_API_SECRET='...'
+```
+
+Then add the `googleAnalytics4` provider to your `<srcDir>/app.config.ts` file:
+
+```ts
+import { googleAnalytics4 } from '@wxt-dev/analytics/providers/google-analytics-4';
+
+export default defineAppConfig({
+  analytics: {
+    providers: [
+      googleAnalytics4({
+        apiSecret: import.meta.env.WXT_GA_API_SECRET,
+        measurementId: '...',
+      }),
+    ],
+  },
+});
+```
+
+### Umami
+
+[Umami](https://umami.is/) is a privacy-first, open source analytics platform.
+
+In Umami's dashboard, create a new website. The website's name and domain can be anything. Obviously, an extension doesn't have a domain, so make one up if you don't have one.
+
+After the website has been created, save the website ID and domain to your `.env` file:
+
+```dotenv
+WXT_UMAMI_WEBSITE_ID='...'
+WXT_UMAMI_DOMAIN='...'
+```
+
+Then add the `umami` provider to your `<srcDir>/app.config.ts` file:
+
+```ts
+import { umami } from '@wxt-dev/analytics/providers/umami';
+
+export default defineAppConfig({
+  analytics: {
+    providers: [
+      umami({
+        apiUrl: 'https://<your-umami-instance>/api',
+        websiteId: import.meta.env.WXT_UMAMI_WEBSITE_ID,
+        domain: import.meta.env.WXT_UMAMI_DOMAIN,
+      }),
+    ],
+  },
+});
+```
+
+### Custom Provider
+
+If your analytics platform is not supported, you can provide an implementation of the `AnalyticsProvider` type in your `app.config.ts` instead:
+
+```ts
+import { defineAnalyticsProvider } from '@wxt-dev/analytics/client';
+
+interface CustomAnalyticsOptions {
+  // ...
+}
+
+const customAnalytics = defineAnalyticsProvider<CustomAnalyticsOptions>(
+  (analytics, analyticsConfig, providerOptions) => {
+    // ...
+  },
+);
+
+export default defineAppConfig({
+  analytics: {
+    providers: [
+      customAnalytics({
+        // ...
+      }),
+    ],
+  },
+});
+```
+
+Example `AnalyticsProvider` implementations can be found at [`./modules/analytics/providers`](https://github.com/wxt-dev/wxt/tree/main/packages/analytics/modules/analytics/providers).
@@ -0,0 +1,20 @@
+import { defineAppConfig } from 'wxt/sandbox';
+import { googleAnalytics4 } from './modules/analytics/providers/google-analytics-4';
+import { umami } from './modules/analytics/providers/umami';
+
+export default defineAppConfig({
+  analytics: {
+    debug: true,
+    providers: [
+      googleAnalytics4({
+        apiSecret: '...',
+        measurementId: '...',
+      }),
+      umami({
+        apiUrl: 'https://umami.aklinker1.io/api',
+        domain: 'analytics.wxt.dev',
+        websiteId: '8f1c2aa4-fad3-406e-a5b2-33e8d4501716',
+      }),
+    ],
+  },
+});
@@ -0,0 +1,21 @@
+import { defineBuildConfig } from 'unbuild';
+import { resolve } from 'node:path';
+
+// Build module and plugins
+export default defineBuildConfig({
+  rootDir: 'modules/analytics',
+  outDir: resolve(__dirname, 'dist'),
+  entries: [
+    { input: 'index.ts', name: 'module' },
+    { input: 'client.ts', name: 'index' },
+    'background-plugin.ts',
+    'types.ts',
+    'providers/google-analytics-4.ts',
+    'providers/umami.ts',
+  ],
+  externals: ['#analytics'],
+  replace: {
+    'import.meta.env.NPM': 'true',
+  },
+  declaration: true,
+});
@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Popup</title>
+  </head>
+  <body>
+    <label>
+      <input id="enabledCheckbox" type="checkbox" />
+      &emsp;Analytics enabled
+    </label>
+    <button id="button1">Button 1</button>
+    <button class="cool-button">Button 2</button>
+    <script type="module" src="./main.ts"></script>
+  </body>
+</html>
@@ -0,0 +1,9 @@
+import { analytics } from '#analytics';
+
+declare const enabledCheckbox: HTMLInputElement;
+
+analytics.autoTrack(document);
+
+enabledCheckbox.oninput = () => {
+  void analytics.setEnabled(enabledCheckbox.checked);
+};
@@ -0,0 +1,3 @@
+import '#analytics';
+
+export default () => {};
@@ -0,0 +1,288 @@
+import { UAParser } from 'ua-parser-js';
+import type {
+  Analytics,
+  AnalyticsConfig,
+  AnalyticsPageViewEvent,
+  AnalyticsStorageItem,
+  AnalyticsTrackEvent,
+  BaseAnalyticsEvent,
+  AnalyticsEventMetadata,
+  AnalyticsProvider,
+} from './types';
+
+const ANALYTICS_PORT = '@wxt-dev/analytics';
+
+export function createAnalytics(config?: AnalyticsConfig): Analytics {
+  if (typeof chrome === 'undefined' || !chrome?.runtime?.id)
+    throw Error(
+      'Cannot use WXT analytics in contexts without access to the browser.runtime APIs',
+    );
+  if (config == null) {
+    console.warn(
+      "[@wxt-dev/analytics] Config not provided to createAnalytics. If you're using WXT, add the 'analytics' property to '<srcDir>/app.config.ts'.",
+    );
+  }
+
+  // TODO: This only works for standard WXT extensions, add a more generic
+  // background script detector that works with non-WXT projects.
+  if (location.pathname === '/background.js')
+    return createBackgroundAnalytics(config);
+
+  return createFrontendAnalytics();
+}
+
+/**
+ * Creates an analytics client in the background responsible for uploading events to the server to avoid CORS errors.
+ */
+function createBackgroundAnalytics(
+  config: AnalyticsConfig | undefined,
+): Analytics {
+  // User properties storage
+  const userIdStorage =
+    config?.userId ?? defineStorageItem<string>('wxt-analytics:user-id');
+  const userPropertiesStorage =
+    config?.userProperties ??
+    defineStorageItem<Record<string, string>>(
+      'wxt-analytics:user-properties',
+      {},
+    );
+  const enabled =
+    config?.enabled ??
+    defineStorageItem<boolean>('local:wxt-analytics:enabled', false);
+
+  // Cached values
+  const platformInfo = chrome.runtime.getPlatformInfo();
+  const userAgent = UAParser();
+  let userId = Promise.resolve(userIdStorage.getValue()).then(
+    (id) => id ?? globalThis.crypto.randomUUID(),
+  );
+  let userProperties = userPropertiesStorage.getValue();
+  const manifest = chrome.runtime.getManifest();
+
+  const getBackgroundMeta = () => ({
+    timestamp: Date.now(),
+    // Don't track sessions for the background, it can be running
+    // indefinitely, and will inflate session duration stats.
+    sessionId: undefined,
+    language: navigator.language,
+    referrer: undefined,
+    screen: undefined,
+    url: location.href,
+    title: undefined,
+  });
+
+  const getBaseEvent = async (
+    meta: AnalyticsEventMetadata,
+  ): Promise<BaseAnalyticsEvent> => {
+    const platform = await platformInfo;
+    return {
+      meta,
+      user: {
+        id: await userId,
+        properties: {
+          version: config?.version ?? manifest.version_name ?? manifest.version,
+          wxtMode: import.meta.env.MODE,
+          wxtBrowser: import.meta.env.BROWSER,
+          arch: platform.arch,
+          os: platform.os,
+          browser: userAgent.browser.name,
+          browserVersion: userAgent.browser.version,
+          ...(await userProperties),
+        },
+      },
+    };
+  };
+
+  const analytics = {
+    identify: async (
+      newUserId: string,
+      newUserProperties: Record<string, string> = {},
+      meta: AnalyticsEventMetadata = getBackgroundMeta(),
+    ) => {
+      // Update in-memory cache for all providers
+      userId = Promise.resolve(newUserId);
+      userProperties = Promise.resolve(newUserProperties);
+      // Persist user info to storage
+      await Promise.all([
+        userIdStorage.setValue?.(newUserId),
+        userPropertiesStorage.setValue?.(newUserProperties),
+      ]);
+      // Notify providers
+      const event = await getBaseEvent(meta);
+      if (config?.debug) console.debug('[@wxt-dev/analytics] identify', event);
+      if (await enabled.getValue()) {
+        await Promise.allSettled(
+          providers.map((provider) => provider.identify(event)),
+        );
+      } else if (config?.debug) {
+        console.debug(
+          '[@wxt-dev/analytics] Analytics disabled, identify() not uploaded',
+        );
+      }
+    },
+    page: async (
+      location: string,
+      meta: AnalyticsEventMetadata = getBackgroundMeta(),
+    ) => {
+      const baseEvent = await getBaseEvent(meta);
+      const event: AnalyticsPageViewEvent = {
+        ...baseEvent,
+        page: {
+          url: meta?.url ?? globalThis.location?.href,
+          location,
+          title: meta?.title ?? globalThis.document?.title,
+        },
+      };
+      if (config?.debug) console.debug('[@wxt-dev/analytics] page', event);
+      if (await enabled.getValue()) {
+        await Promise.allSettled(
+          providers.map((provider) => provider.page(event)),
+        );
+      } else if (config?.debug) {
+        console.debug(
+          '[@wxt-dev/analytics] Analytics disabled, page() not uploaded',
+        );
+      }
+    },
+    track: async (
+      eventName: string,
+      eventProperties?: Record<string, string>,
+      meta: AnalyticsEventMetadata = getBackgroundMeta(),
+    ) => {
+      const baseEvent = await getBaseEvent(meta);
+      const event: AnalyticsTrackEvent = {
+        ...baseEvent,
+        event: { name: eventName, properties: eventProperties },
+      };
+      if (config?.debug) console.debug('[@wxt-dev/analytics] track', event);
+      if (await enabled.getValue()) {
+        await Promise.allSettled(
+          providers.map((provider) => provider.track(event)),
+        );
+      } else if (config?.debug) {
+        console.debug(
+          '[@wxt-dev/analytics] Analytics disabled, track() not uploaded',
+        );
+      }
+    },
+    setEnabled: async (newEnabled) => {
+      await enabled.setValue?.(newEnabled);
+    },
+    autoTrack: () => {
+      // Noop, background doesn't have a UI
+      return () => {};
+    },
+  } satisfies Analytics;
+
+  const providers =
+    config?.providers?.map((provider) => provider(analytics, config)) ?? [];
+
+  // Listen for messages from the rest of the extension
+  chrome.runtime.onConnect.addListener((port) => {
+    if (port.name === ANALYTICS_PORT) {
+      port.onMessage.addListener(({ fn, args }) => {
+        // @ts-expect-error: Untyped fn key
+        void analytics[fn]?.(...args);
+      });
+    }
+  });
+
+  return analytics;
+}
+
+/**
+ * Creates an analytics client for non-background contexts.
+ */
+function createFrontendAnalytics(): Analytics {
+  const port = chrome.runtime.connect({ name: ANALYTICS_PORT });
+  const sessionId = Date.now();
+  const getFrontendMetadata = (): AnalyticsEventMetadata => ({
+    sessionId,
+    timestamp: Date.now(),
+    language: navigator.language,
+    referrer: globalThis.document?.referrer || undefined,
+    screen: globalThis.window
+      ? `${globalThis.window.screen.width}x${globalThis.window.screen.height}`
+      : undefined,
+    url: location.href,
+    title: document.title || undefined,
+  });
+
+  const methodForwarder =
+    (fn: string) =>
+    (...args: any[]) => {
+      port.postMessage({ fn, args: [...args, getFrontendMetadata()] });
+    };
+
+  const analytics: Analytics = {
+    identify: methodForwarder('identify'),
+    page: methodForwarder('page'),
+    track: methodForwarder('track'),
+    setEnabled: methodForwarder('setEnabled'),
+    autoTrack: (root) => {
+      const onClick = (event: Event) => {
+        const element = event.target as any;
+        if (
+          !element ||
+          (!INTERACTIVE_TAGS.has(element.tagName) &&
+            !INTERACTIVE_ROLES.has(element.getAttribute('role')))
+        )
+          return;
+
+        void analytics.track('click', {
+          tagName: element.tagName?.toLowerCase(),
+          id: element.id || undefined,
+          className: element.className || undefined,
+          textContent: element.textContent?.substring(0, 50) || undefined, // Limit text content length
+          href: element.href,
+        });
+      };
+      root.addEventListener('click', onClick, { capture: true, passive: true });
+      return () => {
+        root.removeEventListener('click', onClick);
+      };
+    },
+  };
+  return analytics;
+}
+
+function defineStorageItem<T>(
+  key: string,
+  defaultValue?: NonNullable<T>,
+): AnalyticsStorageItem<T> {
+  return {
+    getValue: async () =>
+      (await chrome.storage.local.get(key))[key] ?? defaultValue,
+    setValue: (newValue) => chrome.storage.local.set({ [key]: newValue }),
+  };
+}
+
+const INTERACTIVE_TAGS = new Set([
+  'A',
+  'BUTTON',
+  'INPUT',
+  'SELECT',
+  'TEXTAREA',
+]);
+const INTERACTIVE_ROLES = new Set([
+  'button',
+  'link',
+  'checkbox',
+  'menuitem',
+  'tab',
+  'radio',
+]);
+
+export function defineAnalyticsProvider<T = never>(
+  definition: (
+    /** The analytics object. */
+    analytics: Analytics,
+    /** Config passed into the analytics module from `app.config.ts`. */
+    config: AnalyticsConfig,
+    /** Provider options */
+    options: T,
+  ) => ReturnType<AnalyticsProvider>,
+): (options: T) => AnalyticsProvider {
+  return (options) => (analytics, config) =>
+    definition(analytics, config, options);
+}
@@ -0,0 +1,76 @@
+import 'wxt';
+import 'wxt/sandbox';
+import { addAlias, addWxtPlugin, defineWxtModule } from 'wxt/modules';
+import { relative, resolve } from 'node:path';
+import type { AnalyticsConfig } from './types';
+
+declare module 'wxt/sandbox' {
+  export interface WxtAppConfig {
+    analytics: AnalyticsConfig;
+  }
+}
+
+export default defineWxtModule({
+  name: 'analytics',
+  imports: [{ name: 'analytics', from: '#analytics' }],
+  setup(wxt) {
+    // Paths
+    const wxtAnalyticsFolder = resolve(wxt.config.wxtDir, 'analytics');
+    const wxtAnalyticsIndex = resolve(wxtAnalyticsFolder, 'index.ts');
+    const clientModuleId = import.meta.env.NPM
+      ? '@wxt-dev/analytics'
+      : resolve(wxt.config.modulesDir, 'analytics/client');
+    const pluginModuleId = import.meta.env.NPM
+      ? '@wxt-dev/analytics/background-plugin'
+      : resolve(wxt.config.modulesDir, 'analytics/background-plugin');
+
+    // Add required permissions
+    wxt.hook('build:manifestGenerated', (_, manifest) => {
+      manifest.permissions ??= [];
+      if (!manifest.permissions.includes('storage')) {
+        manifest.permissions.push('storage');
+      }
+    });
+
+    // Generate #analytics module
+    const wxtAnalyticsCode = [
+      `import { createAnalytics } from '${
+        import.meta.env.NPM
+          ? clientModuleId
+          : relative(wxtAnalyticsFolder, clientModuleId)
+      }';`,
+      `import { useAppConfig } from 'wxt/client';`,
+      ``,
+      `export const analytics = createAnalytics(useAppConfig().analytics);`,
+      ``,
+    ].join('\n');
+    addAlias(wxt, '#analytics', wxtAnalyticsIndex);
+    wxt.hook('prepare:types', async (_, entries) => {
+      entries.push({
+        path: wxtAnalyticsIndex,
+        text: wxtAnalyticsCode,
+      });
+    });
+
+    // Ensure there is a background entrypoint
+    wxt.hook('entrypoints:resolved', (_, entrypoints) => {
+      const hasBackground = entrypoints.find(
+        (entry) => entry.type === 'background',
+      );
+      if (!hasBackground) {
+        entrypoints.push({
+          type: 'background',
+          inputPath: 'virtual:user-background',
+          name: 'background',
+          options: {},
+          outputDir: wxt.config.outDir,
+          skipped: false,
+        });
+      }
+    });
+
+    // Ensure analytics is initialized in every context, mainly the background.
+    // TODO: Once there's a way to filter which entrypoints a plugin is applied to, only apply this to the background
+    addWxtPlugin(wxt, pluginModuleId);
+  },
+});
@@ -0,0 +1,73 @@
+import { defineAnalyticsProvider } from '../client';
+import type { BaseAnalyticsEvent } from '../types';
+
+const DEFAULT_ENGAGEMENT_TIME_IN_MSEC = 100;
+
+export interface GoogleAnalytics4ProviderOptions {
+  apiSecret: string;
+  measurementId: string;
+}
+
+export const googleAnalytics4 =
+  defineAnalyticsProvider<GoogleAnalytics4ProviderOptions>(
+    (_, config, options) => {
+      const send = async (
+        data: BaseAnalyticsEvent,
+        eventName: string,
+        eventProperties: Record<string, string | undefined> | undefined,
+      ): Promise<void> => {
+        const url = new URL(
+          config?.debug ? '/debug/mp/collect' : '/mp/collect',
+          'https://www.google-analytics.com',
+        );
+        if (options.apiSecret)
+          url.searchParams.set('api_secret', options.apiSecret);
+        if (options.measurementId)
+          url.searchParams.set('measurement_id', options.measurementId);
+
+        const userProperties = {
+          language: data.meta.language,
+          screen: data.meta.screen,
+          ...data.user.properties,
+        };
+        const mappedUserProperties = Object.fromEntries(
+          Object.entries(userProperties).map(([name, value]) => [
+            name,
+            value == null ? undefined : { value },
+          ]),
+        );
+
+        await fetch(url.href, {
+          method: 'POST',
+          body: JSON.stringify({
+            client_id: data.user.id,
+            consent: {
+              ad_user_data: 'DENIED',
+              ad_personalization: 'DENIED',
+            },
+            user_properties: mappedUserProperties,
+            events: [
+              {
+                name: eventName,
+                params: {
+                  session_id: data.meta.sessionId,
+                  engagement_time_msec: DEFAULT_ENGAGEMENT_TIME_IN_MSEC,
+                  ...eventProperties,
+                },
+              },
+            ],
+          }),
+        });
+      };
+
+      return {
+        identify: () => Promise.resolve(), // No-op, user data uploaded in page/track
+        page: (event) =>
+          send(event, 'page_view', {
+            page_title: event.page.title,
+            page_location: event.page.location,
+          }),
+        track: (event) => send(event, event.event.name, event.event.properties),
+      };
+    },
+  );
@@ -0,0 +1,70 @@
+import { defineAnalyticsProvider } from '../client';
+
+export interface UmamiProviderOptions {
+  apiUrl: string;
+  websiteId: string;
+  domain: string;
+}
+
+export const umami = defineAnalyticsProvider<UmamiProviderOptions>(
+  (_, config, options) => {
+    const send = (payload: UmamiPayload) => {
+      if (config.debug) {
+        console.debug('[@wxt-dev/analytics] Sending event to Umami:', payload);
+      }
+      return fetch(`${options.apiUrl}/send`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ type: 'event', payload }),
+      });
+    };
+
+    return {
+      identify: () => Promise.resolve(), // No-op, user data uploaded in page/track
+      page: async (event) => {
+        await send({
+          name: 'page_view',
+          website: options.websiteId,
+          url: event.page.url,
+          hostname: options.domain,
+          language: event.meta.language ?? '',
+          referrer: event.meta.referrer ?? '',
+          screen: event.meta.screen ?? '',
+          title: event.page.title ?? '<blank>',
+          data: event.user.properties,
+        });
+      },
+      track: async (event) => {
+        await send({
+          name: event.event.name,
+          website: options.websiteId,
+          url: event.meta.url ?? '/',
+          title: '<blank>',
+          hostname: options.domain,
+          language: event.meta.language ?? '',
+          referrer: event.meta.referrer ?? '',
+          screen: event.meta.screen ?? '',
+          data: {
+            ...event.event.properties,
+            ...event.user.properties,
+          },
+        });
+      },
+    };
+  },
+);
+
+/** @see https://umami.is/docs/api/sending-stats#post-/api/send */
+interface UmamiPayload {
+  hostname?: string;
+  language?: string;
+  referrer?: string;
+  screen?: string;
+  title?: string;
+  url?: string;
+  website: string;
+  name: string;
+  data?: Record<string, string | undefined>;
+}
@@ -0,0 +1,98 @@
+export interface Analytics {
+  /** Report a page change */
+  page: (url: string) => void;
+  /** Report a custom event */
+  track: (eventName: string, eventProperties?: Record<string, string>) => void;
+  /** Save information about the user */
+  identify: (userId: string, userProperties?: Record<string, string>) => void;
+  /** Automatically setup and track user interactions, returning a function to remove any listeners that were setup. */
+  autoTrack: (root: Document | ShadowRoot | Element) => () => void;
+  /** Calls `config.enabled.setValue` */
+  setEnabled: (enabled: boolean) => void;
+}
+
+export interface AnalyticsConfig {
+  /**
+   * Array of providers to send analytics to.
+   */
+  providers: AnalyticsProvider[];
+  /**
+   * Enable debug logs and other provider-specific debugging features.
+   */
+  debug?: boolean;
+  /**
+   * Extension version, defaults to `browser.runtime.getManifest().version`.
+   */
+  version?: string;
+  /**
+   * Configure how the enabled flag is persisted. Defaults to using `""` in local extension storage.
+   */
+  enabled?: AnalyticsStorageItem<boolean>;
+  /**
+   * Configure how the user Id is persisted
+   */
+  userId?: AnalyticsStorageItem<string>;
+  /**
+   * Configure how user properties are persisted
+   */
+  userProperties?: AnalyticsStorageItem<Record<string, string>>;
+}
+
+export interface AnalyticsStorageItem<T> {
+  getValue: () => T | Promise<T>;
+  setValue?: (newValue: T) => void | Promise<void>;
+}
+
+export type AnalyticsProvider = (
+  analytics: Analytics,
+  config: AnalyticsConfig,
+) => {
+  /** Upload a page view event */
+  page: (event: AnalyticsPageViewEvent) => Promise<void>;
+  /** Upload a custom event */
+  track: (event: AnalyticsTrackEvent) => Promise<void>;
+  /** Upload information about the user */
+  identify: (event: BaseAnalyticsEvent) => Promise<void>;
+};
+
+export interface BaseAnalyticsEvent {
+  meta: AnalyticsEventMetadata;
+  user: {
+    id: string;
+    properties: Record<string, string | undefined>;
+  };
+}
+
+export interface AnalyticsEventMetadata {
+  /** Identifier of the session the event was fired from */
+  sessionId: number | undefined;
+  /** `Date.now()` of when the event was reported */
+  timestamp: number;
+  /** `"1920x1080"` */
+  screen: string | undefined;
+  /** `document.referrer` */
+  referrer: string | undefined;
+  /** `navigator.language` */
+  language: string | undefined;
+  /** `location.href` */
+  url: string | undefined;
+  /** `document.title` */
+  title: string | undefined;
+}
+
+export interface AnalyticsPageInfo {
+  url: string;
+  title: string | undefined;
+  location: string | undefined;
+}
+
+export interface AnalyticsPageViewEvent extends BaseAnalyticsEvent {
+  page: AnalyticsPageInfo;
+}
+
+export interface AnalyticsTrackEvent extends BaseAnalyticsEvent {
+  event: {
+    name: string;
+    properties?: Record<string, string>;
+  };
+}
@@ -0,0 +1,66 @@
+{
+  "name": "@wxt-dev/analytics",
+  "version": "0.4.0",
+  "description": "Add analytics to your web extension",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wxt-dev/wxt.git",
+    "directory": "packages/analytics"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./module": {
+      "types": "./dist/module.d.mts",
+      "default": "./dist/module.mjs"
+    },
+    "./background-plugin": {
+      "types": "./dist/background-plugin.d.mts",
+      "default": "./dist/background-plugin.mjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.mts"
+    },
+    "./providers/google-analytics-4": {
+      "types": "./dist/providers/google-analytics-4.d.mts",
+      "default": "./dist/providers/google-analytics-4.mjs"
+    },
+    "./providers/umami": {
+      "types": "./dist/providers/umami.d.mts",
+      "default": "./dist/providers/umami.mjs"
+    }
+  },
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "buildc --deps-only -- wxt",
+    "dev:build": "buildc --deps-only -- wxt build",
+    "check": "pnpm build && check",
+    "build": "buildc -- unbuild",
+    "prepack": "pnpm -s build",
+    "prepare": "buildc --deps-only -- wxt prepare"
+  },
+  "peerDependencies": {
+    "wxt": ">=0.19.23"
+  },
+  "devDependencies": {
+    "@aklinker1/check": "^1.3.1",
+    "@types/chrome": "^0.0.268",
+    "@types/ua-parser-js": "^0.7.39",
+    "prettier": "^3.3.2",
+    "publint": "^0.2.8",
+    "typescript": "^5.5.2",
+    "unbuild": "^2.0.0",
+    "wxt": "workspace:*"
+  },
+  "dependencies": {
+    "ua-parser-js": "^1.0.38"
+  }
+}
@@ -0,0 +1,10 @@
+{
+  "extends": ["../../tsconfig.base.json", "./.wxt/tsconfig.json"],
+  "compilerOptions": {
+    "paths": {
+      "#analytics": ["./.wxt/analytics/index.ts"]
+    },
+    "types": ["chrome"]
+  },
+  "exclude": ["node_modules", "dist"]
+}
@@ -0,0 +1,11 @@
+import { defineConfig } from 'wxt';
+
+export default defineConfig({
+  // Unimport doesn't look for imports in node_modules, so when developing a
+  // WXT module, we need to disable this to simplify the build process
+  imports: false,
+
+  manifest: {
+    name: 'Analytics Demo',
+  },
+});
@@ -44,17 +44,17 @@
  "peerDependencies": {
    "wxt": ">=0.19.0"
  },
-  "dependencies": {
-    "defu": "catalog:",
-    "fs-extra": "catalog:",
-    "sharp": "catalog:"
-  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "oxlint": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
+    "@aklinker1/check": "^1.4.5",
+    "oxlint": "^0.11.1",
+    "publint": "^0.2.12",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
    "wxt": "workspace:*"
+  },
+  "dependencies": {
+    "defu": "^6.1.4",
+    "fs-extra": "^11.2.0",
+    "sharp": "^0.33.5"
  }
 }
@@ -354,7 +354,6 @@ You'll need to configure it the extension so it knows where your localization fi
 # You can check available language ids here: https://code.visualstudio.com/docs/languages/identifiers
 languageIds:
  - typescript
-  - typescriptreact

 # Look for t("...")
 usageMatchRegex:
@@ -19,16 +19,15 @@
    "email": "aaronklinker1+wxt@gmail.com"
  },
  "license": "MIT",
-  "funding": "https://github.com/sponsors/wxt-dev",
  "scripts": {
    "build": "buildc -- unbuild",
    "check": "buildc --deps-only -- check",
    "test": "buildc --deps-only -- vitest"
  },
  "dependencies": {
-    "chokidar": "catalog:",
-    "confbox": "catalog:",
-    "fast-glob": "catalog:"
+    "chokidar": "^3.6.0",
+    "confbox": "^0.1.8",
+    "fast-glob": "^3.3.2"
  },
  "peerDependencies": {
    "wxt": ">=0.19.7"
@@ -39,15 +38,15 @@
    }
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "@types/chrome": "catalog:",
-    "@types/node": "catalog:",
-    "oxlint": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
-    "vitest": "catalog:",
-    "vitest-plugin-random-seed": "catalog:",
+    "@aklinker1/check": "^1.4.5",
+    "@types/chrome": "^0.0.280",
+    "@types/node": "^20.17.6",
+    "oxlint": "^0.11.1",
+    "publint": "^0.2.12",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
+    "vitest": "^2.1.4",
+    "vitest-plugin-random-seed": "^1.1.0",
    "wxt": "workspace:*"
  },
  "main": "./dist/index.cjs",
@@ -2,7 +2,7 @@ import { defineBuildConfig } from 'unbuild';
 import { resolve } from 'node:path';

 export default defineBuildConfig({
-  rootDir: resolve(__dirname, 'modules'),
+  rootDir: 'modules',
  outDir: resolve(__dirname, 'dist'),
  entries: [{ input: 'react.ts', name: 'index' }],
  rollup: {
@@ -17,7 +17,6 @@
    "email": "aaronklinker1+wxt@gmail.com"
  },
  "license": "MIT",
-  "funding": "https://github.com/sponsors/wxt-dev",
  "version": "1.1.3",
  "type": "module",
  "main": "./dist/index.cjs",
@@ -48,17 +47,17 @@
    "wxt": ">=0.19.16"
  },
  "dependencies": {
-    "@vitejs/plugin-react": "catalog:"
+    "@vitejs/plugin-react": "^4.3.4"
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "@types/react": "catalog:",
-    "@types/react-dom": "catalog:",
-    "publint": "catalog:",
-    "react": "catalog:",
-    "react-dom": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
+    "@aklinker1/check": "^1.4.5",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.2",
+    "publint": "^0.2.12",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
    "wxt": "workspace:*"
  }
 }
@@ -2,7 +2,7 @@ import { defineBuildConfig } from 'unbuild';
 import { resolve } from 'node:path';

 export default defineBuildConfig({
-  rootDir: resolve(__dirname, 'modules'),
+  rootDir: 'modules',
  outDir: resolve(__dirname, 'dist'),
  entries: [{ input: 'solid.ts', name: 'index' }],
  rollup: {
@@ -17,7 +17,6 @@
    "email": "aaronklinker1+wxt@gmail.com"
  },
  "license": "MIT",
-  "funding": "https://github.com/sponsors/wxt-dev",
  "version": "1.1.3",
  "type": "module",
  "main": "./dist/index.cjs",
@@ -48,14 +47,14 @@
    "wxt": ">=0.19.16"
  },
  "dependencies": {
-    "vite-plugin-solid": "catalog:"
+    "vite-plugin-solid": "^2.10.2"
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "publint": "catalog:",
-    "solid-js": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
+    "@aklinker1/check": "^1.4.5",
+    "publint": "^0.2.12",
+    "solid-js": "^1.9.3",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
    "wxt": "workspace:*"
  }
 }
@@ -1,17 +1,5 @@
 # Changelog

-## v2.0.3
-
-[compare changes](https://github.com/wxt-dev/wxt/compare/module-svelte-v2.0.2...module-svelte-v2.0.3)
-
-### 🩹 Fixes
-
- Upgrade `vite-plugin-svelte` to support Vite 6 ([#1375](https://github.com/wxt-dev/wxt/pull/1375))
-
-### ❤️ Contributors
-
- Eli ([@lishaduck](http://github.com/lishaduck))
-
 ## v2.0.2

 [compare changes](https://github.com/wxt-dev/wxt/compare/module-svelte-v2.0.1...module-svelte-v2.0.2)
@@ -17,8 +17,7 @@
    "email": "aaronklinker1+wxt@gmail.com"
  },
  "license": "MIT",
-  "funding": "https://github.com/sponsors/wxt-dev",
-  "version": "2.0.3",
+  "version": "2.0.2",
  "type": "module",
  "main": "./dist/index.cjs",
  "module": "./dist/index.mjs",
@@ -47,13 +46,13 @@
    "svelte": ">=5"
  },
  "dependencies": {
-    "@sveltejs/vite-plugin-svelte": "catalog:"
+    "@sveltejs/vite-plugin-svelte": "^4.0.0"
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
+    "@aklinker1/check": "^1.4.5",
+    "publint": "^0.2.12",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
    "wxt": "workspace:*"
  }
 }
@@ -17,7 +17,6 @@
    "email": "aaronklinker1+wxt@gmail.com"
  },
  "license": "MIT",
-  "funding": "https://github.com/sponsors/wxt-dev",
  "version": "1.0.2",
  "type": "module",
  "main": "./dist/index.cjs",
@@ -46,13 +45,13 @@
    "wxt": ">=0.19.16"
  },
  "dependencies": {
-    "@vitejs/plugin-vue": "catalog:"
+    "@vitejs/plugin-vue": "^5.2.0"
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
+    "@aklinker1/check": "^1.4.5",
+    "publint": "^0.2.12",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
    "wxt": "workspace:*"
  }
 }
@@ -1,22 +1,5 @@
 # Changelog

-## v1.1.0
-
-[compare changes](https://github.com/wxt-dev/wxt/compare/storage-v1.0.1...storage-v1.1.0)
-
-### 🚀 Enhancements
-
- Add `storage.clear` ([#1368](https://github.com/wxt-dev/wxt/pull/1368))
-
-### 📖 Documentation
-
- Update link ([654a54a](https://github.com/wxt-dev/wxt/commit/654a54a))
-
-### ❤️ Contributors
-
- Chengxi ([@chengxilo](http://github.com/chengxilo))
- Aaron ([@aklinker1](http://github.com/aklinker1))
-
 ## v1.0.1

 [compare changes](https://github.com/wxt-dev/wxt/compare/storage-v1.0.0...storage-v1.0.1)
@@ -1,7 +1,7 @@
 {
  "name": "@wxt-dev/storage",
  "description": "Web extension storage API provided by WXT, supports all browsers.",
-  "version": "1.1.0",
+  "version": "1.0.1",
  "type": "module",
  "repository": {
    "type": "git",
@@ -23,25 +23,24 @@
    "email": "aaronklinker1+wxt@gmail.com"
  },
  "license": "MIT",
-  "funding": "https://github.com/sponsors/wxt-dev",
  "scripts": {
    "build": "buildc -- unbuild",
    "check": "buildc --deps-only -- check",
    "test": "buildc --deps-only -- vitest"
  },
  "dependencies": {
-    "async-mutex": "catalog:",
-    "dequal": "catalog:"
+    "async-mutex": "^0.5.0",
+    "dequal": "^2.0.3"
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "@types/chrome": "catalog:",
-    "@webext-core/fake-browser": "catalog:",
-    "oxlint": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
-    "vitest": "catalog:"
+    "@aklinker1/check": "^1.4.5",
+    "@types/chrome": "^0.0.268",
+    "@webext-core/fake-browser": "^1.3.1",
+    "oxlint": "^0.9.9",
+    "publint": "^0.2.11",
+    "typescript": "^5.6.2",
+    "unbuild": "^2.0.0",
+    "vitest": "^2.0.0"
  },
  "module": "./dist/index.mjs",
  "types": "./dist/index.d.ts",
@@ -489,18 +489,6 @@ describe('Storage Utils', () => {
        });
      });

-      describe('clear', () => {
-        it('should remove all items', async () => {
-          await fakeBrowser.storage[storageArea].set({
-            one: 1,
-            two: 2,
-          });
-
-          await storage.clear(storageArea);
-          expect(await fakeBrowser.storage[storageArea].get()).toEqual({});
-        });
-      });
-
      describe('removeMeta', () => {
        it('should remove all metadata', async () => {
          await fakeBrowser.storage[storageArea].set({ count$: { v: 4 } });
@@ -326,10 +326,6 @@ function createStorage(): WxtStorage {
        }),
      );
    },
-    clear: async (base) => {
-      const driver = getDriver(base);
-      await driver.clear();
-    },
    removeMeta: async (key, properties) => {
      const { driver, driverKey } = resolveKey(key);
      await removeMeta(driver, driverKey, properties);
@@ -394,7 +390,7 @@ function createStorage(): WxtStorage {
              (await migrations?.[migrateToVersion]?.(migratedValue)) ??
              migratedValue;
          } catch (err) {
-            throw new MigrationError(key, migrateToVersion, {
+            throw Error(`v${migrateToVersion} migration failed for "${key}"`, {
              cause: err,
            });
          }
@@ -538,9 +534,6 @@ function createDriver(storageArea: StorageArea): WxtStorageDriver {
    removeItems: async (keys) => {
      await getStorageArea().remove(keys);
    },
-    clear: async () => {
-      await getStorageArea().clear();
-    },
    snapshot: async () => {
      return await getStorageArea().get();
    },
@@ -681,12 +674,6 @@ export interface WxtStorage {
      | { item: WxtStorageItem<any, any>; options?: RemoveItemOptions }
    >,
  ): Promise<void>;
-
-  /**
-   * Removes all items from the provided storage area.
-   */
-  clear(base: StorageArea): Promise<void>;
-
  /**
   * Remove the entire metadata for a key, or specific properties by name.
   *
@@ -725,7 +712,7 @@ export interface WxtStorage {
  /**
   * Define a storage item with a default value, type, or versioning.
   *
-   * Read full docs: https://wxt.dev/storage.html#defining-storage-items
+   * Read full docs: https://wxt.dev/guide/extension-apis/storage.html#defining-storage-items
   */
  defineItem<TValue, TMetadata extends Record<string, unknown> = {}>(
    key: StorageItemKey,
@@ -743,7 +730,6 @@ interface WxtStorageDriver {
  setItems(values: Array<{ key: string; value: any }>): Promise<void>;
  removeItem(key: string): Promise<void>;
  removeItems(keys: string[]): Promise<void>;
-  clear(): Promise<void>;
  snapshot(): Promise<Record<string, unknown>>;
  restoreSnapshot(data: Record<string, unknown>): Promise<void>;
  watch<T>(key: string, cb: WatchCallback<T | null>): Unwatch;
@@ -38,10 +38,10 @@ The module can be configured via the `unocss` config:
 export default defineConfig({
  modules: ['@wxt-dev/unocss'],
  unocss: {
-    // Exclude unocss from running for the background
-    excludeEntrypoints: ['background'],
+    // Will only apply unocss for popup/main.ts
+    entrypoints: ['popup/main.ts'],
  },
 });
 ```

-Options have JSDocs available in your editor, or you can read them in the source code: [`UnoCSSOptions`](https://github.com/wxt-dev/wxt/blob/main/packages/unocss/src/index.ts).
+Options have JSDocs available in your editor, or you can read them in the source code: [`UnoCSSOptions`](https://github.com/wxt-dev/wxt/blob/main/packages/auto-icons/src/index.ts).
@@ -40,16 +40,16 @@
    "wxt": ">=0.19.0"
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "oxlint": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
-    "unocss": "catalog:",
+    "@aklinker1/check": "^1.4.5",
+    "oxlint": "^0.11.1",
+    "publint": "^0.2.12",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
+    "unocss": "^0.64.0",
    "wxt": "workspace:*"
  },
  "dependencies": {
-    "defu": "catalog:",
-    "fast-glob": "catalog:"
+    "defu": "^6.1.4",
+    "fast-glob": "^3.3.2"
  }
 }
@@ -18,20 +18,20 @@
  },
  "dependencies": {
    "@wxt-dev/i18n": "workspace:*",
-    "react": "catalog:",
-    "react-dom": "catalog:"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
  },
  "devDependencies": {
-    "@types/chrome": "catalog:",
-    "@types/react": "catalog:",
-    "@types/react-dom": "catalog:",
+    "@types/chrome": "^0.0.280",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.2",
    "@wxt-dev/auto-icons": "workspace:*",
    "@wxt-dev/unocss": "workspace:*",
-    "sass": "catalog:",
-    "typescript": "catalog:",
-    "unocss": "catalog:",
-    "vitest": "catalog:",
-    "vitest-plugin-random-seed": "catalog:",
+    "sass": "^1.80.7",
+    "typescript": "^5.6.3",
+    "unocss": "^0.64.0",
+    "vitest": "^2.1.4",
+    "vitest-plugin-random-seed": "^1.1.0",
    "wxt": "workspace:*"
  },
  "buildc": {
@@ -1,16 +1,11 @@
 import 'uno.css';
 import './style.css';
-import manualStyle from './manual-style.css?inline';

 export default defineContentScript({
  matches: ['https://*.duckduckgo.com/*'],
  cssInjectionMode: 'ui',

  async main(ctx) {
-    const style = document.createElement('style');
-    style.textContent = manualStyle;
-    document.head.append(style);
-
    const ui = await createShadowRootUi(ctx, {
      name: 'demo-ui',
      position: 'inline',
@@ -1,4 +0,0 @@
-body {
-  padding: 2rem;
-  background-color: blanchedalmond;
-}
@@ -1,100 +1,5 @@
 # Changelog

-## v0.19.28
-
-[compare changes](https://github.com/wxt-dev/wxt/compare/wxt-v0.19.27...wxt-v0.19.28)
-
-### 🩹 Fixes
-
- Ignore `manifest.manifest_version` option and warn about incorrect usage ([#1419](https://github.com/wxt-dev/wxt/pull/1419))
- Resolve wxt modules from the root ([#1417](https://github.com/wxt-dev/wxt/pull/1417))
- Properly detect and reload changed files when using Vite's `?suffix` imports ([#1432](https://github.com/wxt-dev/wxt/pull/1432))
- Regression on variable expansion in dotenv files ([#1449](https://github.com/wxt-dev/wxt/pull/1449))
- Allow vite 6.0.9+ ([#1497](https://github.com/wxt-dev/wxt/pull/1497))
-
-### 📖 Documentation
-
- Host pre-aggregated LLM knowledge files ([#1355](https://github.com/wxt-dev/wxt/pull/1355))
-
-### 🏡 Chore
-
- Add funding links to `package.json` files ([#1446](https://github.com/wxt-dev/wxt/pull/1446))
- Use PNPM 10's new catelog feature ([#1493](https://github.com/wxt-dev/wxt/pull/1493))
- Move production dependencies to PNPM 10 catelog ([#1494](https://github.com/wxt-dev/wxt/pull/1494))
- **deps:** Upgrade to Vite 6 and related dependencies ([#1496](https://github.com/wxt-dev/wxt/pull/1496))
-
-### ❤️ Contributors
-
- Aaron ([@aklinker1](http://github.com/aklinker1))
- Stefan Maric <me@stefanmaric.com>
- Okinea Dev ([@okineadev](http://github.com/okineadev))
- 1natsu ([@1natsu172](http://github.com/1natsu172))
- Alec Larson ([@aleclarson](http://github.com/aleclarson))
-
-## v0.19.27
-
-[compare changes](https://github.com/wxt-dev/wxt/compare/wxt-v0.19.26...wxt-v0.19.27)
-
-### 🩹 Fixes
-
- Allow `vite-node@^3.0.0` ([#1378](https://github.com/wxt-dev/wxt/pull/1378))
- Use path triple slash directive for types that are referenced via path ([#1407](https://github.com/wxt-dev/wxt/pull/1407))
- Support `publish-browser-extension` v3.0.0 ([ac92d40](https://github.com/wxt-dev/wxt/commit/ac92d40))
- Respect `inlineConfig.mode` when setting NODE_ENV ([#1416](https://github.com/wxt-dev/wxt/pull/1416))
- Auto-import does not work when using `@vitejs/plugin-vue` alone ([#1412](https://github.com/wxt-dev/wxt/pull/1412))
-
-### ❤️ Contributors
-
- Jaguar Zhou ([@aiktb](http://github.com/aiktb))
- Alec Larson ([@aleclarson](http://github.com/aleclarson))
- Aaron ([@aklinker1](http://github.com/aklinker1))
- St3h3n <st3h3n@gmail.com>
- Eli ([@lishaduck](http://github.com/lishaduck))
-
-## v0.19.26
-
-[compare changes](https://github.com/wxt-dev/wxt/compare/wxt-v0.19.25...wxt-v0.19.26)
-
-### 🩹 Fixes
-
- **context:** Deduplicate `wxt:content-script-started` ([#1364](https://github.com/wxt-dev/wxt/pull/1364))
-
-### ❤️ Contributors
-
- Deniz Uğur ([@DenizUgur](http://github.com/DenizUgur))
-
-## v0.19.25
-
-[compare changes](https://github.com/wxt-dev/wxt/compare/wxt-v0.19.24...wxt-v0.19.25)
-
-### 🩹 Fixes
-
- Drop support for vite 6.0.9+ until websocket fix is finished ([8e2badc](https://github.com/wxt-dev/wxt/commit/8e2badc))
-
-### ❤️ Contributors
-
- Aaron ([@aklinker1](http://github.com/aklinker1))
-
-## v0.19.24
-
-[compare changes](https://github.com/wxt-dev/wxt/compare/wxt-v0.19.23...wxt-v0.19.24)
-
-### 🩹 Fixes
-
- **init:** Remove "experimental" from bun package manager ([b150a52](https://github.com/wxt-dev/wxt/commit/b150a52))
- **web-ext:** Correctly pass `browserConsole` option to open devtools in Firefox ([#1308](https://github.com/wxt-dev/wxt/pull/1308))
- `autoMount` not working if anchor is already present ([#1350](https://github.com/wxt-dev/wxt/pull/1350))
-
-### 🏡 Chore
-
- Fix typo in CLI docs ([028c601](https://github.com/wxt-dev/wxt/commit/028c601))
-
-### ❤️ Contributors
-
- 1natsu ([@1natsu172](http://github.com/1natsu172))
- Paulo Pinto ([@psrpinto](https://github.com/psrpinto))
- Aaron ([@aklinker1](http://github.com/aklinker1))
-
 ## v0.19.23

 [compare changes](https://github.com/wxt-dev/wxt/compare/wxt-v0.19.22...wxt-v0.19.23)
@@ -2870,4 +2775,4 @@ Initial release of WXT. Full support for production builds and initial toolkit f
 ### 🤖 CI

 - Create validation workflow ([#12](https://github.com/wxt-dev/wxt/pull/12))
- Create release workflow ([#13](https://github.com/wxt-dev/wxt/pull/13))
+- Create release workflow ([#13](https://github.com/wxt-dev/wxt/pull/13))
@@ -52,10 +52,10 @@ describe('Auto Imports', () => {
          ----------------------------------------
          // Generated by wxt
          /// <reference types="wxt/vite-builder-env" />
-          /// <reference path="./types/paths.d.ts" />
-          /// <reference path="./types/i18n.d.ts" />
-          /// <reference path="./types/globals.d.ts" />
-          /// <reference path="./types/imports.d.ts" />
+          /// <reference types="./types/paths.d.ts" />
+          /// <reference types="./types/i18n.d.ts" />
+          /// <reference types="./types/globals.d.ts" />
+          /// <reference types="./types/imports.d.ts" />
          "
        `);
    });
@@ -91,9 +91,9 @@ describe('Auto Imports', () => {
        ----------------------------------------
        // Generated by wxt
        /// <reference types="wxt/vite-builder-env" />
-        /// <reference path="./types/paths.d.ts" />
-        /// <reference path="./types/i18n.d.ts" />
-        /// <reference path="./types/globals.d.ts" />
+        /// <reference types="./types/paths.d.ts" />
+        /// <reference types="./types/i18n.d.ts" />
+        /// <reference types="./types/globals.d.ts" />
        "
      `,
      );
@@ -236,10 +236,10 @@ describe('TypeScript Project', () => {
      ----------------------------------------
      // Generated by wxt
      /// <reference types="wxt/vite-builder-env" />
-      /// <reference path="./types/paths.d.ts" />
-      /// <reference path="./types/i18n.d.ts" />
-      /// <reference path="./types/globals.d.ts" />
-      /// <reference path="./types/imports.d.ts" />
+      /// <reference types="./types/paths.d.ts" />
+      /// <reference types="./types/i18n.d.ts" />
+      /// <reference types="./types/globals.d.ts" />
+      /// <reference types="./types/imports.d.ts" />
      "
    `);
  });
@@ -1,8 +1,8 @@
 {
  "name": "wxt",
  "type": "module",
-  "version": "0.19.28",
-  "description": "⚡ Next-gen Web Extension Framework",
+  "version": "0.19.23",
+  "description": "Next gen framework for developing web extensions",
  "repository": {
    "type": "git",
    "url": "git+https://github.com/wxt-dev/wxt.git"
@@ -22,7 +22,6 @@
    "email": "aaronklinker1+wxt@gmail.com"
  },
  "license": "MIT",
-  "funding": "https://github.com/sponsors/wxt-dev",
  "files": [
    "bin",
    "dist"
@@ -82,72 +81,71 @@
    "prepack": "pnpm build"
  },
  "dependencies": {
-    "@1natsu/wait-element": "catalog:",
-    "@aklinker1/rollup-plugin-visualizer": "catalog:",
-    "@types/chrome": "catalog:",
-    "@types/webextension-polyfill": "catalog:",
-    "@webext-core/fake-browser": "catalog:",
-    "@webext-core/isolated-element": "catalog:",
-    "@webext-core/match-patterns": "catalog:",
+    "@1natsu/wait-element": "^4.1.2",
+    "@aklinker1/rollup-plugin-visualizer": "5.12.0",
+    "@types/chrome": "^0.0.280",
+    "@types/webextension-polyfill": "^0.12.1",
+    "@webext-core/fake-browser": "^1.3.1",
+    "@webext-core/isolated-element": "^1.1.2",
+    "@webext-core/match-patterns": "^1.0.3",
    "@wxt-dev/storage": "workspace:^1.0.0",
-    "async-mutex": "catalog:",
-    "c12": "catalog:",
-    "cac": "catalog:",
-    "chokidar": "catalog:",
-    "ci-info": "catalog:",
-    "consola": "catalog:",
-    "defu": "catalog:",
-    "dotenv": "catalog:",
-    "dotenv-expand": "catalog:",
-    "esbuild": "catalog:",
-    "fast-glob": "catalog:",
-    "filesize": "catalog:",
-    "fs-extra": "catalog:",
-    "get-port-please": "catalog:",
-    "giget": "catalog:",
-    "hookable": "catalog:",
-    "import-meta-resolve": "catalog:",
-    "is-wsl": "catalog:",
-    "jiti": "catalog:",
-    "json5": "catalog:",
-    "jszip": "catalog:",
-    "linkedom": "catalog:",
-    "magicast": "catalog:",
-    "minimatch": "catalog:",
-    "nano-spawn": "catalog:",
-    "normalize-path": "catalog:",
-    "nypm": "catalog:",
-    "ohash": "catalog:",
-    "open": "catalog:",
-    "ora": "catalog:",
-    "perfect-debounce": "catalog:",
-    "picocolors": "catalog:",
-    "prompts": "catalog:",
-    "publish-browser-extension": "catalog:",
-    "scule": "catalog:",
-    "unimport": "catalog:",
-    "vite": "catalog:",
-    "vite-node": "catalog:",
-    "web-ext-run": "catalog:",
-    "webextension-polyfill": "catalog:"
+    "async-mutex": "^0.5.0",
+    "c12": "^1.11.2",
+    "cac": "^6.7.14",
+    "chokidar": "^3.6.0",
+    "ci-info": "^4.1.0",
+    "consola": "^3.2.3",
+    "defu": "^6.1.4",
+    "dotenv": "^16.4.5",
+    "esbuild": "^0.21.5",
+    "fast-glob": "^3.3.2",
+    "filesize": "^10.1.6",
+    "fs-extra": "^11.2.0",
+    "get-port-please": "^3.1.2",
+    "giget": "^1.2.3",
+    "hookable": "^5.5.3",
+    "is-wsl": "^3.1.0",
+    "jiti": "^1.21.6",
+    "json5": "^2.2.3",
+    "jszip": "^3.10.1",
+    "linkedom": "^0.18.5",
+    "magicast": "^0.3.5",
+    "minimatch": "^10.0.1",
+    "nano-spawn": "^0.2.0",
+    "normalize-path": "^3.0.0",
+    "nypm": "^0.3.12",
+    "ohash": "^1.1.4",
+    "open": "^10.1.0",
+    "ora": "^8.1.1",
+    "perfect-debounce": "^1.0.0",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2",
+    "publish-browser-extension": "^2.2.2",
+    "scule": "^1.3.0",
+    "unimport": "^3.13.1",
+    "vite": "^5.0.0 || ^6.0.0",
+    "vite-node": "^2.1.4",
+    "web-ext-run": "^0.2.1",
+    "webextension-polyfill": "^0.12.0"
  },
  "devDependencies": {
-    "@aklinker1/check": "catalog:",
-    "@faker-js/faker": "catalog:",
-    "@types/fs-extra": "catalog:",
-    "@types/lodash.merge": "catalog:",
-    "@types/node": "catalog:",
-    "@types/normalize-path": "catalog:",
-    "@types/prompts": "catalog:",
-    "extract-zip": "catalog:",
-    "happy-dom": "catalog:",
-    "lodash.merge": "catalog:",
-    "oxlint": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "unbuild": "catalog:",
-    "vitest": "catalog:",
-    "vitest-plugin-random-seed": "catalog:"
+    "@aklinker1/check": "^1.4.5",
+    "@faker-js/faker": "^9.2.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/lodash.merge": "^4.6.9",
+    "@types/node": "^20.17.6",
+    "@types/normalize-path": "^3.0.2",
+    "@types/prompts": "^2.4.9",
+    "extract-zip": "^2.0.1",
+    "happy-dom": "^15.11.4",
+    "lodash.merge": "^4.6.2",
+    "oxlint": "^0.11.1",
+    "publint": "^0.2.12",
+    "tsx": "4.15.7",
+    "typescript": "^5.6.3",
+    "unbuild": "^2.0.0",
+    "vitest": "^2.1.4",
+    "vitest-plugin-random-seed": "^1.1.0"
  },
  "peerDependenciesMeta": {
    "@types/chrome": {
@@ -6,7 +6,8 @@ import type {
  WxtResolvedUnimportOptions,
 } from '../types';
 import { type Unimport, createUnimport } from 'unimport';
-import UnimportPlugin from 'unimport/unplugin';
+import { Plugin } from 'vite';
+import { extname } from 'node:path';

 export default defineWxtModule({
  name: 'wxt:built-in:unimport',
@@ -52,11 +53,38 @@ export default defineWxtModule({

    // Add vite plugin
    addViteConfig(wxt, () => ({
-      plugins: [UnimportPlugin.vite(options)],
+      plugins: [vitePlugin(unimport)],
    }));
  },
 });

+export function vitePlugin(unimport: Unimport): Plugin {
+  const ENABLED_EXTENSIONS = new Set([
+    '.js',
+    '.jsx',
+    '.ts',
+    '.tsx',
+    '.vue',
+    '.svelte',
+  ]);
+  return {
+    name: 'wxt:unimport',
+    async transform(code, id) {
+      // Don't transform dependencies
+      if (id.includes('node_modules')) return;
+
+      // Don't transform non-js files
+      if (!ENABLED_EXTENSIONS.has(extname(id))) return;
+
+      const injected = await unimport.injectImports(code, id);
+      return {
+        code: injected.code,
+        map: injected.s.generateMap({ hires: 'boundary', source: id }),
+      };
+    },
+  };
+}
+
 async function getImportsDeclarationEntry(
  unimport: Unimport,
 ): Promise<WxtDirFileEntry> {
@@ -42,7 +42,6 @@ export class ContentScriptContext implements AbortController {
  private isTopFrame = window.self === window.top;
  private abortController: AbortController;
  private locationWatcher = createLocationWatcher(this);
-  private receivedMessageIds = new Set<string>();

  constructor(
    private readonly contentScriptName: string,
@@ -234,28 +233,19 @@ export class ContentScriptContext implements AbortController {
      {
        type: ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE,
        contentScriptName: this.contentScriptName,
-        messageId: Math.random().toString(36).slice(2),
      },
      '*',
    );
  }

-  verifyScriptStartedEvent(event: MessageEvent) {
-    const isScriptStartedEvent =
-      event.data?.type === ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE;
-    const isSameContentScript =
-      event.data?.contentScriptName === this.contentScriptName;
-    const isNotDuplicate = !this.receivedMessageIds.has(event.data?.messageId);
-    return isScriptStartedEvent && isSameContentScript && isNotDuplicate;
-  }
-
  listenForNewerScripts(options?: { ignoreFirstEvent?: boolean }) {
    let isFirst = true;

    const cb = (event: MessageEvent) => {
-      if (this.verifyScriptStartedEvent(event)) {
-        this.receivedMessageIds.add(event.data.messageId);
-
+      if (
+        event.data?.type === ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE &&
+        event.data?.contentScriptName === this.contentScriptName
+      ) {
        const wasFirst = isFirst;
        isFirst = false;
        if (wasFirst && options?.ignoreFirstEvent) return;
@@ -546,25 +546,6 @@ describe('Content Script UIs', () => {
    ] as const)(
      'built-in UI type: $name',
      ({ name, createUiFunction, uiSelector }) => {
-        it('should mount if an anchor already exists at the initialization', async () => {
-          const onMount = vi.fn(appendTestApp);
-          ui = await createUiFunction(ctx, {
-            position: 'inline',
-            onMount,
-            anchor: `#parent > #${DYNAMIC_CHILD_ID}`,
-            page: name === 'iframe' ? '/page.html' : undefined,
-            name: 'test-component',
-          });
-
-          appendTestElement({ id: DYNAMIC_CHILD_ID });
-          ui.autoMount();
-          await runMicrotasks();
-
-          await expect
-            .poll(() => document.querySelector(uiSelector))
-            .not.toBeNull();
-        });
-
        it('should mount when an anchor is dynamically added and unmount when an anchor is removed', async () => {
          const onMount = vi.fn(appendTestApp);
          const onRemove = vi.fn();
@@ -355,11 +355,6 @@ function autoMountUi(
  async function observeElement(selector: string | null | undefined) {
    let isAnchorExist = !!getAnchor(options);

-    // Mount if anchor exists at initialization.
-    if (isAnchorExist) {
-      uiCallbacks.mount();
-    }
-
    while (!abortController.signal.aborted) {
      try {
        const changedAnchor = await waitElement(selector ?? 'body', {
@@ -67,11 +67,6 @@ export async function createViteBuilder(
      ignored: [`${wxtConfig.outBaseDir}/**`, `${wxtConfig.wxtDir}/**`],
    };

-    // TODO: Remove once https://github.com/wxt-dev/wxt/pull/1411 is merged
-    config.legacy ??= {};
-    // @ts-ignore: Untyped option:
-    config.legacy.skipWebSocketTokenCheck = true;
-
    const server = getWxtDevServer?.();

    config.plugins ??= [];
@@ -217,7 +217,7 @@ function getMainDeclarationEntry(references: WxtDirEntry[]): WxtDirFileEntry {
    } else if (ref.tsReference) {
      const absolutePath = resolve(wxt.config.wxtDir, ref.path);
      const relativePath = relative(wxt.config.wxtDir, absolutePath);
-      lines.push(`/// <reference path="./${normalizePath(relativePath)}" />`);
+      lines.push(`/// <reference types="./${normalizePath(relativePath)}" />`);
    }
  });
  return {
@@ -1,5 +1,4 @@
 import { loadConfig } from 'c12';
-import { resolve as esmResolve } from 'import-meta-resolve';
 import {
  InlineConfig,
  ResolvedConfig,
@@ -29,7 +28,6 @@ import { getEslintVersion } from './utils/eslint';
 import { safeStringToNumber } from './utils/number';
 import { loadEnv } from './utils/env';
 import { getPort } from 'get-port-please';
-import { fileURLToPath, pathToFileURL } from 'node:url';

 /**
 * Given an inline config, discover the config file if necessary, merge the results, resolve any
@@ -52,6 +50,9 @@ export async function resolveConfig(
      name: 'wxt',
      cwd: inlineConfig.root ?? process.cwd(),
      rcFile: false,
+      jitiOptions: {
+        esmResolve: true,
+      },
    });
    if (inlineConfig.configFile && metadata.layers?.length === 0) {
      throw Error(`Config file "${inlineConfig.configFile}" not found`);
@@ -83,7 +84,7 @@ export async function resolveConfig(
    inlineConfig.root ?? userConfig.root ?? process.cwd(),
  );
  const wxtDir = path.resolve(root, '.wxt');
-  const wxtModuleDir = resolveWxtModuleDir();
+  const wxtModuleDir = await resolveWxtModuleDir();
  const srcDir = path.resolve(root, mergedConfig.srcDir ?? root);
  const entrypointsDir = path.resolve(
    srcDir,
@@ -155,7 +156,6 @@ export async function resolveConfig(
  }

  const userModules = await resolveWxtUserModules(
-    root,
    modulesDir,
    mergedConfig.modules,
  );
@@ -420,22 +420,21 @@ async function getUnimportEslintOptions(
 /**
 * Returns the path to `node_modules/wxt`.
 */
-function resolveWxtModuleDir() {
-  // TODO: Drop the __filename expression once we're fully running in ESM
-  // (see https://github.com/wxt-dev/wxt/issues/277)
-  const importer =
-    typeof __filename === 'string'
-      ? pathToFileURL(__filename).href
-      : import.meta.url;
-
-  // TODO: Switch to import.meta.resolve() once the parent argument is unflagged
-  // (e.g. --experimental-import-meta-resolve) and all Node.js versions we support
-  // have it.
-  const url = esmResolve('wxt', importer);
-
-  // esmResolve() returns the "wxt/dist/index.mjs" file, not the package's root
+async function resolveWxtModuleDir() {
+  // TODO: Use this once we're fully running in ESM, see https://github.com/wxt-dev/wxt/issues/277
+  // const url = import.meta.resolve('wxt', import.meta.url);
+  // resolve() returns the "wxt/dist/index.mjs" file, not the package's root
  // directory, which we want to return from this function.
-  return path.resolve(fileURLToPath(url), '../..');
+  // return path.resolve(fileURLToPath(url), '../..');
+
+  const requireResolve =
+    globalThis.require?.resolve ??
+    (await import('node:module')).default.createRequire(import.meta.url)
+      .resolve;
+
+  // resolve() returns the "wxt/dist/index.mjs" file, not the package's root
+  // directory, which we want to return from this function.
+  return path.resolve(requireResolve('wxt'), '../..');
 }

 async function isDirMissing(dir: string) {
@@ -480,20 +479,14 @@ export async function mergeBuilderConfig(
 }

 export async function resolveWxtUserModules(
-  root: string,
  modulesDir: string,
  modules: string[] = [],
 ): Promise<WxtModuleWithMetadata<any>[]> {
-  const importer = pathToFileURL(path.join(root, 'index.js')).href;
-
  // Resolve node_modules modules
  const npmModules = await Promise.all<WxtModuleWithMetadata<any>>(
    modules.map(async (moduleId) => {
-      // Resolve before importing to allow for a local WXT clone to be
-      // symlinked into a project.
-      const resolvedModulePath = esmResolve(moduleId, importer);
      const mod: { default: WxtModule<any> } = await import(
-        /* @vite-ignore */ resolvedModulePath
+        /* @vite-ignore */ moduleId
      );
      if (mod.default == null) {
        throw Error('Module missing default export: ' + moduleId);
@@ -11,8 +11,8 @@ describe('Content Script Utils', () => {
    it('should return a string containing all the options with defaults applied', () => {
      const hash = hashContentScriptOptions({ matches: [] });

-      expect(hash).toEqual(
-        '[["all_frames",false],["exclude_globs",[]],["exclude_matches",[]],["include_globs",[]],["match_about_blank",false],["match_origin_as_fallback",false],["matches",[]],["run_at","document_idle"],["world","ISOLATED"]]',
+      expect(hash).toMatchInlineSnapshot(
+        `"[["all_frames",false],["exclude_globs",[]],["exclude_matches",[]],["include_globs",[]],["match_about_blank",false],["match_origin_as_fallback",false],["matches",[]],["run_at","document_idle"],["world","ISOLATED"]]"`,
      );
    });

@@ -21,7 +21,6 @@ import {
  OutputAsset,
 } from '../../../types';
 import { wxt } from '../../wxt';
-import { mock } from 'vitest-mock-extended';

 const outDir = '/output';
 const contentScriptOutDir = '/output/content-scripts';
@@ -1647,33 +1646,6 @@ describe('Manifest Utils', () => {
      expect(manifest.sidebar_action).toBeUndefined();
      expect(manifest.content_scripts).toBeUndefined();
    });
-
-    describe('manifest_version', () => {
-      it('should ignore and log a warning when someone sets `manifest_version` inside the manifest', async () => {
-        const buildOutput = fakeBuildOutput();
-        const expectedVersion = 2;
-        setFakeWxt({
-          logger: mock(),
-          config: {
-            command: 'build',
-            manifestVersion: expectedVersion,
-            manifest: {
-              manifest_version: 3,
-            },
-          },
-        });
-
-        const { manifest } = await generateManifest([], buildOutput);
-
-        expect(manifest.manifest_version).toBe(expectedVersion);
-        expect(wxt.logger.warn).toBeCalledTimes(1);
-        expect(wxt.logger.warn).toBeCalledWith(
-          expect.stringContaining(
-            '`manifest.manifest_version` config was set, but ignored',
-          ),
-        );
-      });
-    });
  });

  describe('stripPathFromMatchPattern', () => {
@@ -359,63 +359,5 @@ describe('Detect Dev Changes', () => {

      expect(actual).toEqual(expected);
    });
-
-    it('should detect changes to import files with `?suffix`', () => {
-      const importedPath = '/root/utils/shared.css?inline';
-      const changedPath = '/root/utils/shared.css';
-      const script1 = fakeContentScriptEntrypoint({
-        inputPath: '/root/overlay1.content/index.ts',
-      });
-      const script2 = fakeContentScriptEntrypoint({
-        inputPath: '/root/overlay2.ts',
-      });
-      const script3 = fakeContentScriptEntrypoint({
-        inputPath: '/root/overlay3.content/index.ts',
-      });
-
-      const step1: BuildStepOutput = {
-        entrypoints: script1,
-        chunks: [
-          fakeOutputChunk({
-            moduleIds: [fakeFile(), importedPath],
-          }),
-        ],
-      };
-      const step2: BuildStepOutput = {
-        entrypoints: script2,
-        chunks: [
-          fakeOutputChunk({
-            moduleIds: [fakeFile(), fakeFile(), fakeFile()],
-          }),
-        ],
-      };
-      const step3: BuildStepOutput = {
-        entrypoints: script3,
-        chunks: [
-          fakeOutputChunk({
-            moduleIds: [importedPath, fakeFile(), fakeFile()],
-          }),
-        ],
-      };
-
-      const currentOutput: BuildOutput = {
-        manifest: fakeManifest(),
-        publicAssets: [],
-        steps: [step1, step2, step3],
-      };
-      const expected: DevModeChange = {
-        type: 'content-script-reload',
-        cachedOutput: {
-          ...currentOutput,
-          steps: [step2],
-        },
-        changedSteps: [step1, step3],
-        rebuildGroups: [script1, script3],
-      };
-
-      const actual = detectDevChanges([changedPath], currentOutput);
-
-      expect(actual).toEqual(expected);
-    });
  });
 });
@@ -135,26 +135,14 @@ function findEffectedSteps(
  const changes: BuildStepOutput[] = [];
  const changedPath = normalizePath(changedFile);

-  const isChunkEffected = (chunk: OutputFile): boolean => {
-    switch (chunk.type) {
-      // If it's an HTML file with the same path, is is effected because HTML files need to be re-rendered
-      // - fileName is normalized, relative bundle path, "<entrypoint-name>.html"
-      case 'asset': {
-        return changedPath
-          .replace('/index.html', '.html')
-          .endsWith(chunk.fileName);
-      }
-      // If it's a chunk that depends on the changed file, it is effected
-      // - moduleIds are absolute, normalized paths
-      case 'chunk': {
-        const modulePaths = chunk.moduleIds.map((path) => path.split('?')[0]);
-        return modulePaths.includes(changedPath);
-      }
-      default: {
-        return false;
-      }
-    }
-  };
+  const isChunkEffected = (chunk: OutputFile): boolean =>
+    // If it's an HTML file with the same path, is is effected because HTML files need to be re-rendered
+    // - fileName is normalized, relative bundle path, "<entrypoint-name>.html"
+    (chunk.type === 'asset' &&
+      changedPath.replace('/index.html', '.html').endsWith(chunk.fileName)) ||
+    // If it's a chunk that depends on the changed file, it is effected
+    // - moduleIds are absolute, normalized paths
+    (chunk.type === 'chunk' && chunk.moduleIds.includes(changedPath));

  for (const step of currentOutput.steps) {
    const effectedChunk = step.chunks.find((chunk) => isChunkEffected(chunk));
@@ -49,6 +49,7 @@ export async function importEntrypointFile<T>(path: string): Promise<T> {
    {
      cache: false,
      debug: wxt.config.debug,
+      esmResolve: true,
      alias: {
        'webextension-polyfill': resolve(
          wxt.config.wxtModuleDir,
@@ -64,7 +65,7 @@ export async function importEntrypointFile<T>(path: string): Promise<T> {
      },
      // Continue using node to load TS files even if `bun run --bun` is detected. Jiti does not
      // respect the custom transform function when using it's native bun option.
-      tryNative: false,
+      experimentalBun: false,
      // List of extensions to transform with esbuild
      extensions: [
        '.ts',
@@ -1,24 +1,21 @@
 import { config } from 'dotenv';
-import { expand } from 'dotenv-expand';
 import type { TargetBrowser } from '../../types';

 /**
 * Load environment files based on the current mode and browser.
 */
 export function loadEnv(mode: string, browser: TargetBrowser) {
-  return expand(
-    config({
-      // Files on top override files below
-      path: [
-        `.env.${mode}.${browser}.local`,
-        `.env.${mode}.${browser}`,
-        `.env.${browser}.local`,
-        `.env.${browser}`,
-        `.env.${mode}.local`,
-        `.env.${mode}`,
-        `.env.local`,
-        `.env`,
-      ],
-    }),
-  );
+  return config({
+    // Files on top override files below
+    path: [
+      `.env.${mode}.${browser}.local`,
+      `.env.${mode}.${browser}`,
+      `.env.${browser}.local`,
+      `.env.${browser}`,
+      `.env.${mode}.local`,
+      `.env.${mode}`,
+      `.env.local`,
+      `.env`,
+    ],
+  });
 }
@@ -76,12 +76,6 @@ export async function generateManifest(
    icons: discoverIcons(buildOutput),
  };
  const userManifest = wxt.config.manifest;
-  if (userManifest.manifest_version) {
-    delete userManifest.manifest_version;
-    wxt.logger.warn(
-      '`manifest.manifest_version` config was set, but ignored. To change the target manifest version, use the `manifestVersion` option or the `--mv2`/`--mv3` CLI flags.\nSee https://wxt.dev/guide/essentials/target-different-browsers.html#target-a-manifest-version',
-    );
-  }

  let manifest = defu(
    userManifest,
@@ -21,8 +21,7 @@ export async function registerWxt(
 ): Promise<void> {
  // Default NODE_ENV environment variable before other packages, like vite, do it
  // See https://github.com/wxt-dev/wxt/issues/873#issuecomment-2254555523
-  process.env.NODE_ENV ??=
-    inlineConfig.mode ?? (command === 'serve' ? 'development' : 'production');
+  process.env.NODE_ENV ??= command === 'serve' ? 'development' : 'production';

  const hooks = createHooks<WxtHooks>();
  const config = await resolveConfig(inlineConfig, command);
@@ -7,7 +7,8 @@ import {
  resolveAppConfig,
 } from '../core/builders/vite/plugins';
 import { InlineConfig } from '../types';
-import UnimportPlugin from 'unimport/unplugin';
+import { vitePlugin as unimportPlugin } from '../builtin-modules/unimport';
+import { createUnimport } from 'unimport';
 import { registerWxt, wxt } from '../core/wxt';

 /**
@@ -38,7 +39,9 @@ export async function WxtVitest(
    extensionApiMock(wxt.config),
  ];
  if (wxt.config.imports !== false) {
-    plugins.push(UnimportPlugin.vite(wxt.config.imports));
+    const unimport = createUnimport(wxt.config.imports);
+    await unimport.init();
+    plugins.push(unimportPlugin(unimport));
  }

  return plugins;
@@ -4,6 +4,7 @@ import { UnimportOptions, Import } from 'unimport';
 import { LogLevel } from 'consola';
 import type { ContentScriptContext } from './client/content-scripts/content-script-context';
 import type { PluginVisualizerOptions } from '@aklinker1/rollup-plugin-visualizer';
+import type { FSWatcher } from 'chokidar';
 import { ResolvedConfig as C12ResolvedConfig } from 'c12';
 import { Hookable, NestedHooks } from 'hookable';
 import type * as Nypm from 'nypm';
@@ -1096,7 +1097,7 @@ export interface WxtBuilderServer {
  /**
   * Chokidar file watcher instance.
   */
-  watcher: vite.ViteDevServer['watcher'];
+  watcher: FSWatcher;
  on?(event: string, callback: () => void): void;
 }

@@ -1,101 +1,3 @@
 packages:
  - docs
  - packages/*
-onlyBuiltDependencies:
-  - esbuild
-catalog:
-  '@1natsu/wait-element': ^4.1.2
-  '@aklinker1/buildc': ^1.1.4
-  '@aklinker1/check': ^1.4.5
-  '@aklinker1/rollup-plugin-visualizer': 5.12.0
-  '@commitlint/config-conventional': ^19.7.1
-  '@commitlint/types': ^19.5.0
-  '@faker-js/faker': ^9.2.0
-  '@sveltejs/vite-plugin-svelte': ^4.0.0 || ^5.0.0
-  '@types/chrome': ^0.0.280
-  '@types/fs-extra': ^11.0.4
-  '@types/lodash.merge': ^4.6.9
-  '@types/node': ^20.17.6
-  '@types/normalize-path': ^3.0.2
-  '@types/prompts': ^2.4.9
-  '@types/react': ^19.0.1
-  '@types/react-dom': ^19.0.2
-  '@types/webextension-polyfill': ^0.12.1
-  '@vitejs/plugin-react': ^4.3.4
-  '@vitejs/plugin-vue': ^5.2.1
-  '@vitest/coverage-v8': ^3.0.7
-  '@webext-core/fake-browser': ^1.3.1
-  '@webext-core/isolated-element': ^1.1.2
-  '@webext-core/match-patterns': ^1.0.3
-  async-mutex: ^0.5.0
-  c12: ^3.0.2
-  cac: ^6.7.14
-  changelogen: ^0.5.7
-  chokidar: ^4.0.3
-  ci-info: ^4.1.0
-  confbox: ^0.1.8
-  consola: ^3.2.3
-  defu: ^6.1.4
-  dequal: ^2.0.3
-  dotenv: ^16.4.5
-  dotenv-expand: ^12.0.1
-  esbuild: ^0.25.0
-  extract-zip: ^2.0.1
-  fast-glob: ^3.3.2
-  filesize: ^10.1.6
-  fs-extra: ^11.2.0
-  get-port-please: ^3.1.2
-  giget: ^1.2.3
-  happy-dom: ^17.1.8
-  hookable: ^5.5.3
-  import-meta-resolve: ^4.1.0
-  is-wsl: ^3.1.0
-  jiti: ^2.4.2
-  json5: ^2.2.3
-  jszip: ^3.10.1
-  linkedom: ^0.18.5
-  lint-staged: ^15.2.10
-  lodash.merge: ^4.6.2
-  magicast: ^0.3.5
-  markdown-it-footnote: ^4.0.0
-  minimatch: ^10.0.1
-  nano-spawn: ^0.2.0
-  normalize-path: ^3.0.0
-  nypm: ^0.3.12
-  ohash: ^1.1.4
-  open: ^10.1.0
-  ora: ^8.1.1
-  oxlint: ^0.11.1
-  perfect-debounce: ^1.0.0
-  picocolors: ^1.1.1
-  prettier: ^3.3.3
-  prompts: ^2.4.2
-  publint: ^0.2.12
-  publish-browser-extension: ^2.3.0 || ^3.0.0
-  react: ^19.0.0
-  react-dom: ^19.0.0
-  sass: ^1.80.7
-  scule: ^1.3.0
-  sharp: ^0.33.5
-  simple-git-hooks: ^2.11.1
-  solid-js: ^1.9.4
-  tsx: 4.19.3
-  typedoc: ^0.25.4
-  typedoc-plugin-frontmatter: ^1.1.0
-  typedoc-plugin-markdown: 4.0.0-next.23
-  typedoc-vitepress-theme: 1.0.0-next.3
-  typescript: ^5.6.3
-  unbuild: ^3.5.0
-  unimport: ^3.13.1
-  unocss: ^0.64.0 || ^0.65.0 || ^65.0.0 ||^66.0.0
-  vite: ^5.0.0 || ^6.0.0
-  vite-node: ^2.1.4 || ^3.0.0
-  vite-plugin-solid: ^2.11.6
-  vitepress: ^1.6.3
-  vitepress-knowledge: ^0.4.0
-  vitest: ^3.0.7
-  vitest-mock-extended: ^3.0.1
-  vitest-plugin-random-seed: ^1.1.1
-  vue: ^3.5.12
-  web-ext-run: ^0.2.1
-  webextension-polyfill: ^0.12.0
@@ -23,6 +23,15 @@ a:hover {
  color: #535bf2;
 }

+a {
+  font-weight: 500;
+  color: #646cff;
+  text-decoration: inherit;
+}
+a:hover {
+  color: #535bf2;
+}
+
 body {
  margin: 0;
  display: flex;
Author	SHA1	Message	Date
Aaron	2faba91ddb	chore(release): analytics-v0.4.0 vhs / vhs (push) Cancelled after 0s Details	2024-12-29 20:36:35 -06:00
Aaron	fe8e2ed23b	Fix build script	2024-12-29 20:35:32 -06:00
Aaron	95369ff2c9	fix prepare script	2024-12-29 20:29:51 -06:00
Aaron	829525f824	Update workflows	2024-12-29 20:27:33 -06:00
Aaron	9ad04d325b	Add missing docs	2024-12-29 20:25:51 -06:00
Aaron	f218c30825	Add background if missing	2024-12-29 20:19:41 -06:00
Aaron	fdee7c615c	Cleanup	2024-12-29 20:16:13 -06:00
Aaron	b34754b363	Cleanup	2024-12-29 19:58:08 -06:00
Aaron	be74af40f9	Add plugin	2024-12-29 19:49:02 -06:00
Aaron	baebe28a3e	cleanup	2024-12-29 19:42:42 -06:00
Aaron	3b9f395a7d	Update README	2024-12-29 19:22:30 -06:00
Aaron	95367203bf	cleanup	2024-12-29 19:15:21 -06:00
Aaron	6fb1463a32	defineAnalyticsProvider and updated umami config	2024-12-29 19:10:31 -06:00
aklinker1	b727453509	docs: Update `wxt init` GIF	2024-12-29 22:12:30 +00:00
Aaron	446fd90bea	Merge remote-tracking branch 'origin/main' into analytics-module	2024-12-29 16:10:55 -06:00
Aaron	90c2b7f9bf	Bump version	2024-10-31 08:47:36 -05:00
Aaron	c431dafe08	Fix readme and required minimum version	2024-10-31 08:47:09 -05:00
Aaron	3786c7b6d1	Fix types	2024-10-22 15:32:34 -05:00
Aaron	0416ff7ec2	Cleanup metadata handling	2024-10-22 15:29:44 -05:00
Aaron	26cbef5a42	Properly track title	2024-10-22 15:14:05 -05:00
Aaron	e98f29fddb	Fix page upload params	2024-10-22 15:07:57 -05:00
Aaron	93e6dd6db7	Improve debug logs	2024-10-22 15:03:02 -05:00
Aaron	7879fabbad	Cleanup	2024-10-22 14:56:25 -05:00
Aaron	a861dc1736	fix code-generation	2024-10-22 14:05:32 -05:00
Aaron	f75c5ca1aa	fix api check	2024-10-22 11:01:27 -05:00
Aaron	e8e00e4e04	Fix build	2024-10-22 10:53:50 -05:00
Aaron	15adc77d23	Refactor to generated module instead of plugin	2024-10-22 10:47:41 -05:00
Aaron	c73a4b6a96	Merge remote-tracking branch 'origin/main' into analytics-module	2024-10-22 10:18:55 -05:00
Aaron	d96840b2f5	WIP	2024-10-22 10:10:14 -05:00
aklinker1	e4886af90a	docs: Update `wxt init` GIF	2024-09-18 15:00:46 +00:00
Aaron	c69e99db3f	Remove wxt/storage	2024-09-18 09:59:09 -05:00
Aaron	55113d654d	Remove wxt/storage	2024-09-18 09:59:09 -05:00
Aaron	50d2170844	Fix storage	2024-09-18 09:59:09 -05:00
Aaron	ee53bb0a5e	disable auto-imports	2024-09-18 09:59:09 -05:00
Aaron	5216d75209	Fix useAppConfig fr?	2024-09-18 09:59:09 -05:00
Aaron	d0623fe173	Fix missing useAppConfig	2024-09-18 09:59:09 -05:00
Aaron	e0d0618325	Fix missing useAppConfig	2024-09-18 09:59:09 -05:00
Aaron	563bd4e108	Fix __dirname reference	2024-09-18 09:59:09 -05:00
Aaron	107803bd8f	Update package.json	2024-09-18 09:59:09 -05:00
Aaron	06fd7e4eac	Update package.json	2024-09-18 09:59:09 -05:00
Aaron	eba8788a76	Umami provider and cleanup	2024-09-18 09:59:07 -05:00
Aaron	8ace11f3cb	Add missing file	2024-09-18 09:58:45 -05:00
Aaron	328acbbfe7	Cleanup	2024-09-18 09:58:45 -05:00
Aaron	f99c1aa7b5	Implement client and google analytics	2024-09-18 09:58:43 -05:00
Aaron	5217279070	feat: Analytics module	2024-09-18 09:58:04 -05:00