chore(release): wxt v0.20.25

Addresses
https://github.com/wxt-dev/wxt/issues/2180#issuecomment-4259430737

.gitattributes

@@ -7,6 +7,7 @@
 pnpm-lock.yaml linguist-generated
 package-lock.json linguist-generated
 bun.lockb linguist-generated
+bun.lock linguist-generated
 yarn.lock linguist-generated
 
 # Exclude templates from language statistics

.github/CODEOWNERS

@@ -1,5 +1,5 @@
 # Set default
-* @aklinker1 @Timeraa
+* @aklinker1
 
 # Secure Directories
 /.github/ @aklinker1

.github/actions/setup/action.yml

@@ -1,31 +1,21 @@
 name: Basic Setup
-description: Install PNPM, Node, and dependencies
+description: Install Bun 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"
+    description: Whether or not to run 'bun install'
 
 runs:
   using: composite
 
   steps:
-    - name: 🛠️ Setup PNPM
-      uses: pnpm/action-setup@v4
-
-    - name: 🛠️ Setup NodeJS
-      uses: actions/setup-node@v4
+    - name: 🛠️ Setup Bun
+      uses: oven-sh/setup-bun@735343b667d3e6f658f44d0eca948eb6282f2b76 # v2.0.2
       with:
-        node-version: 18
-        cache: pnpm
+        bun-version-file: '.tool-versions'
 
     - name: 📦 Install Dependencies
       if: ${{ inputs.install == 'true' }}
       shell: bash
-      run: pnpm install ${{ inputs.installArgs }}
+      run: bun ci ${{ inputs.installArgs }}

.github/workflows/auto-label.yml

@@ -0,0 +1,111 @@
+name: ✨ Auto-label PR
+
+on:
+  pull_request_target:
+    types: [opened, synchronized, reopened]
+
+jobs:
+  update-pr:
+    name: Update PR
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - name: Gather Info
+        id: check
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
+        with:
+          script: |
+            const { data: pr } = await github.rest.pulls.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.payload.pull_request.number
+            });
+
+            // Check if PR has assignees
+            const hasAssignees = pr.assignees && pr.assignees.length > 0;
+            core.setOutput('has_assignees', hasAssignees);
+            core.setOutput('author', pr.user.login);
+
+            // Get list of changed files
+            const { data: files } = await github.rest.pulls.listFiles({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.payload.pull_request.number
+            });
+
+            // Find all packages that were modified
+            const packagesRegex = /^packages\/([^\/]+)\//;
+            const affectedPackages = new Set();
+
+            for (const file of files) {
+              const match = file.filename.match(packagesRegex);
+              if (match) {
+                affectedPackages.add(match[1]);
+              }
+            }
+
+            const labels = Array.from(affectedPackages).map(pkg => `pkg/${pkg}`);
+            core.setOutput('labels', JSON.stringify(labels));
+            console.log('Detected package labels:', labels);
+
+            // Get current labels on the PR that match pkg/* pattern
+            const currentPkgLabels = pr.labels
+              .map(label => label.name)
+              .filter(name => name.startsWith('pkg/'));
+
+            core.setOutput('current_pkg_labels', JSON.stringify(currentPkgLabels));
+            console.log('Current pkg labels:', currentPkgLabels);
+
+      - name: Sync Author
+        if: steps.check.outputs.has_assignees == 'false'
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
+        with:
+          script: |
+            await github.rest.issues.addAssignees({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number,
+              assignees: ['${{ steps.check.outputs.author }}']
+            });
+
+            console.log('Assigned PR author: ${{ steps.check.outputs.author }}');
+
+      - name: Sync Labels
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
+        with:
+          script: |
+            const newLabels = ${{ steps.check.outputs.labels }};
+            const currentLabels = ${{ steps.check.outputs.current_pkg_labels }};
+
+            // Find labels to add (in newLabels but not in currentLabels)
+            const labelsToAdd = newLabels.filter(label => !currentLabels.includes(label));
+
+            // Find labels to remove (in currentLabels but not in newLabels)
+            const labelsToRemove = currentLabels.filter(label => !newLabels.includes(label));
+
+            // Add new labels
+            if (labelsToAdd.length > 0) {
+              await github.rest.issues.addLabels({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.payload.pull_request.number,
+                labels: labelsToAdd
+              });
+              console.log('Added labels:', labelsToAdd);
+            }
+
+            // Remove obsolete labels
+            for (const label of labelsToRemove) {
+              await github.rest.issues.removeLabel({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.payload.pull_request.number,
+                name: label
+              });
+              console.log('Removed label:', label);
+            }
+
+            if (labelsToAdd.length === 0 && labelsToRemove.length === 0) {
+              console.log('No label changes needed');
+            }

.github/workflows/notify-unreleased-commits.yml

@@ -0,0 +1,36 @@
+name: 🔔 Notify Unreleased Commits
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 20 * * 1' # Weekly at 8 PM UTC (3 PM CT)
+
+jobs:
+  notify:
+    runs-on: ubuntu-22.04
+    if: github.repository_owner == 'wxt-dev'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+
+      - name: List Commits
+        id: list-commits
+        run: |
+          ./scripts/list-unreleased-commits.sh > summary.txt
+
+      - name: Discord notification
+        run: |
+          PAYLOAD=$(jq -n --arg content "${{ env.MESSAGE }}" '{"content": $content}')
+          curl -X POST \
+            -F "payload_json=${PAYLOAD}" \
+            -F "file1=@summary.txt" \
+            $DISCORD_WEBHOOK
+        env:
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK_UNRELEASED_COMMITS }}
+          MESSAGE: |
+            If a package needs released, please [run the workflow](<https://github.com/wxt-dev/wxt/actions/workflows/release.yml>).
+
+            Before running, consider:
+            - Are there any breaking changes? If so, prepare a list of breaking changes and update the changelog and release notes after the release.
+            - Are there any PRs open that we wait to release after they're merged?

.github/workflows/pkg.pr.new.yml

@@ -17,13 +17,18 @@ jobs:
     if: ${{ github.repository == 'wxt-dev/wxt' }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Build All Packages
-        run: pnpm buildc all
+        run: bun run buildc all
 
       - name: Publish
-        run: pnpx pkg-pr-new publish --compact --pnpm './packages/*'
+        run: bun pkg-pr-new publish --compact --bun './packages/*'
+
+      - name: DEBUG
+        if: always()
+        run: ls -lhA
+        working-directory: packages/analytics

.github/workflows/pr-closed.yml

@@ -15,8 +15,21 @@ jobs:
     if: github.event.pull_request.merged == true
 
     steps:
+      - name: Log PR Author Info
+        run: |
+          echo "PR Author Login: ${{ github.event.pull_request.user.login }}"
+          echo "PR Author ID: ${{ github.event.pull_request.user.id }}"
+          echo "PR Author Type: ${{ github.event.pull_request.user.type }}"
+          echo "PR Author Node ID: ${{ github.event.pull_request.user.node_id }}"
+
       - name: Post Thank You Comment
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        if: >-
+          github.event.pull_request.user.login != 'aklinker1' &&
+          github.event.pull_request.user.login != 'Timeraa' &&
+          github.event.pull_request.user.login != 'PatrykKuniczak' &&
+          github.event.pull_request.user.login != 'dependabot[bot]' &&
+          github.event.pull_request.user.login != 'copilot-swe-agent[bot]'
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         env:
           comment: Thanks for helping make WXT better!
         with:

.github/workflows/pr-title.yml

@@ -10,7 +10,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           # Only fetch the config file from the repository
           sparse-checkout-cone-mode: false

.github/workflows/publish-docs.yml

@@ -23,13 +23,13 @@ jobs:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Login to Docker Registry
-        uses: docker/login-action@v3
+        uses: docker/login-action@b45d80f862d83dbcd57f89517bcf500b2ab88fb2 # v4.0.0
         with:
           registry: https://${{ secrets.DOCKER_REGISTRY_HOSTNAME }}
           username: ${{ secrets.DOCKER_REGISTRY_USERNAME }}
@@ -37,7 +37,7 @@ jobs:
 
       - name: Build docs
         run: |
-          pnpm docs:build
+          bun run docs:build
           docker build docs/.vitepress -t ${{ secrets.DOCKER_REGISTRY_HOSTNAME }}/wxt/docs:${{ github.event.inputs.tag || 'latest' }}
 
       - name: Push Image

.github/workflows/release.yml

@@ -10,6 +10,7 @@ on:
           - analytics
           - auto-icons
           - i18n
+          - is-background
           - module-react
           - module-solid
           - module-svelte
@@ -31,16 +32,18 @@ jobs:
 
   publish:
     name: Publish
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     permissions:
-      contents: write
+      contents: write # Push version changes
+      id-token: write # OIDC for NPM publishing
     needs:
       - validate
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 0
+          ssh-key: ${{ secrets.DEPLOY_KEY }} # https://github.com/sbellone/release-workflow-example
 
       - name: Setup
         uses: ./.github/actions/setup
@@ -53,18 +56,18 @@ jobs:
 
       - name: Bump and Tag
         run: |
-          pnpm tsx scripts/bump-package-version.ts ${{ inputs.package }}
+          bun run scripts/bump-package-version.ts ${{ inputs.package }}
           git push
           git push --tags
 
       - name: Publish to NPM
         working-directory: packages/${{ inputs.package }}
         run: |
-          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_AUTH_TOKEN }}" > ~/.npmrc
-          pnpm build
-          pnpm publish
+          bun pm pack
+          sudo npm i -g npm@latest
+          npm publish *.tgz
 
       - name: Create GitHub release
-        run: pnpm tsx scripts/create-github-release.ts ${{ inputs.package }}
+        run: bun run scripts/create-github-release.ts ${{ inputs.package }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/sync-releases.yml

@@ -10,6 +10,7 @@ on:
           - analytics
           - auto-icons
           - i18n
+          - is-background
           - module-react
           - module-solid
           - module-svelte
@@ -30,7 +31,7 @@ jobs:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
@@ -38,6 +39,6 @@ jobs:
           installArgs: --ignore-scripts
 
       - name: Sync Releases
-        run: pnpm tsx scripts/sync-releases.ts ${{ inputs.package }}
+        run: bun run scripts/sync-releases.ts ${{ inputs.package }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/update-browser-package.yml

@@ -11,11 +11,15 @@ jobs:
   sync:
     name: 'Sync with @types/chrome'
     runs-on: ubuntu-latest
+    if: github.repository_owner == 'wxt-dev'
     permissions:
-      contents: write
+      contents: write # Push version changes
+      id-token: write # OIDC for NPM publishing
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          ssh-key: ${{ secrets.DEPLOY_KEY }}
 
       - name: Setup
         uses: ./.github/actions/setup
@@ -24,23 +28,24 @@ jobs:
 
       - name: Generate Latest Code
         working-directory: packages/browser
-        run: pnpm gen
+        run: bun run gen
 
       - name: Run Checks
         working-directory: packages/browser
-        run: pnpm check
+        run: bun run check
 
       - name: Commit Changes
         id: commit
-        uses: stefanzweifel/git-auto-commit-action@v6
+        uses: stefanzweifel/git-auto-commit-action@04702edda442b2e678b25b537cec683a1493fcb9 # v7.1.0
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           commit_message: 'fix: Upgrade `@wxt-dev/browser` to latest `@types/chrome` version'
 
-      - name: Publish Package
+      - name: Publish to NPM
         if: steps.commit.outputs.changes_detected == 'true'
         working-directory: packages/browser
         run: |
-          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_AUTH_TOKEN }}" > ~/.npmrc
-          pnpm publish
+          bun pm pack
+          sudo npm i -g npm@latest
+          npm publish *.tgz

.github/workflows/validate.yml

@@ -15,43 +15,43 @@ jobs:
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Basic Checks
-        run: pnpm check
+        run: bun run check
 
   builds:
     name: Builds
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Build All Packages
-        run: pnpm buildc all
+        run: bun run buildc all
 
   build-demo:
     name: Build Demo
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Build
-        run: pnpm build:all
+        run: bun run build:all
         working-directory: packages/wxt-demo
 
       - name: ZIP
-        run: pnpm wxt zip
+        run: bun run wxt zip
         working-directory: packages/wxt-demo
 
   tests:
@@ -68,25 +68,27 @@ jobs:
             coverage: false
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
+      - name: Setup PNPM
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v5.0.0
+        with:
+          version: latest
 
       - name: Run Tests
         if: ${{ ! matrix.coverage }}
-        run: pnpm test
+        run: bun run test
 
       - name: Run Tests (Coverage)
         if: matrix.coverage
-        run: pnpm test:coverage --reporter=default --reporter=hanging-process
+        run: bun run test:coverage --reporter=default --reporter=hanging-process
 
       - name: Upload Coverage
         if: matrix.coverage
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@57e3a136b779b570ffcdbf80b3bdc90e7fab3de2 # v6.0.0
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
@@ -104,13 +106,13 @@ jobs:
           - vue
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Pack WXT package
-        run: pnpm pack
+        run: bun pm pack
         working-directory: packages/wxt
 
       - name: Install Dependencies
@@ -122,15 +124,15 @@ jobs:
         working-directory: templates/${{ matrix.template }}
 
       - name: Type Check Template
-        run: pnpm compile
+        run: bun run compile
         if: matrix.template != 'svelte'
         working-directory: templates/${{ matrix.template }}
 
       - name: Type Check Template
-        run: pnpm check
+        run: bun run check
         if: matrix.template == 'svelte'
         working-directory: templates/${{ matrix.template }}
 
       - name: Build Template
-        run: pnpm build
+        run: bun run build
         working-directory: templates/${{ matrix.template }}

.github/workflows/vhs.yml

@@ -11,18 +11,27 @@ permissions:
 jobs:
   vhs:
     name: Create VHS
-    runs-on: ubuntu-22.04
+    runs-on: macos-latest
     if: ${{ github.repository == 'wxt-dev/wxt' }}
     permissions:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup
-        uses: ./.github/actions/setup
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
-          install: false
+          ref: ${{ github.ref_name }}
+      - name: Setup PNPM
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v5.0.0
+
+      - name: Setup NodeJS
+        uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
+        with:
+          cache: pnpm
+
+      - name: Setup Go
+        uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c
+        with:
+          go-version: '1.25.1'
 
       # This prevents pnpm dlx from downloading WXT in the video
       - name: Pre-install WXT
@@ -31,15 +40,19 @@ jobs:
           pnpm dlx wxt@latest --version
 
       - name: Record VHS
-        uses: charmbracelet/vhs-action@v2.1.0
-        with:
-          path: 'docs/tapes/init-demo.tape'
+        run: |
+          brew install ttyd ffmpeg
+          go install github.com/charmbracelet/vhs@517bcda0faf416728bcf6b7fe489eb0e2469d9b5 # v0.10.0
+          vhs docs/tapes/init-demo.tape
 
       - name: Save recorded GIF
-        uses: stefanzweifel/git-auto-commit-action@v6
+        uses: stefanzweifel/git-auto-commit-action@04702edda442b2e678b25b537cec683a1493fcb9 # v7.1.0
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           commit_message: 'docs: Update `wxt init` GIF'
+          commit_user_name: github-actions[bot]
+          commit_user_email: github-actions[bot]@users.noreply.github.com
+          commit_author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
           # https://github.com/charmbracelet/vhs#output
           file_pattern: 'docs/assets/*.gif'

.gitignore

@@ -1,12 +1,14 @@
 .DS_Store
 .env
 .env.*
+!packages/wxt/src/core/utils/__tests__/fixtures/.env
 .idea
 .output
 .webextrc
 .wxt
 .wxt-runner
 *.log
+*.tgz
 /docs/.vitepress/cache
 docs/.vitepress/.temp
 coverage
@@ -20,6 +22,5 @@ templates/*/yarn.lock
 templates/*/package-lock.json
 docs/api/reference
 stats.html
-.tool-versions
 .cache
 *-stats.txt

.prettierrc.yml

@@ -1,2 +1,4 @@
 singleQuote: true
 endOfLine: lf
+plugins:
+  - prettier-plugin-jsdoc

.tool-versions

@@ -0,0 +1,2 @@
+bun 1.3.12
+nodejs 24.14.1

.vscode/settings.json

@@ -10,5 +10,6 @@
   // Additional guidelines for Copilot
   "github.copilot.chat.codeGeneration.instructions": [
     { "file": "CONTRIBUTING.md" }
-  ]
+  ],
+  "oxc.enable": true
 }

CONTRIBUTING.md

@@ -6,6 +6,19 @@ If you are changing the docs or fixing a bug, feel free to fork and open a PR.
 
 If you want to add a new feature, please create an issue or discussion first so we can decide if the feature is inline with the vision for WXT.
 
+## WXT's Vision
+
+WXT is two things:
+
+1. A build tool
+2. A set of runtime utilities
+
+The long term goal of WXT is provide an opinionated build tool that keeps WXT projects standard, while providing light-weight runtime utils that simplify a lot of the boilerplate/overhead when setting up a new extension.
+
+I also want to provide a way for developers to use either one of those two things independently, and not require them to use both. This is why all of WXT's runtime utils are shipped as their own NPM packages, most of them not bundled inside the core `wxt` package. If you just want to use the packages, they're available, and if you just want to use WXT's built tool, you don't have to import any of WXT's utilities, you can use your own.
+
+> The few runtime utils shipped inside WXT are things that should be used by 90% of extensions. That said, they're also legacy utils left in from before I started creating separate NPM packages, and in the future, they may be removed from the core package.
+
 ## 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
@@ -20,18 +33,27 @@ Here are some examples of conventional commit messages:
 
 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.
 
+## Breaking Changes Policy
+
+A quick word on WXT's breaking changes policy. I am willing to make breaking changes, but they have to be for a good enough reason - they have to make WXT better as a whole, they can't be based on one opinion.
+
+Breaking changes also require a major release. Major releases have happened once or twice a year, so after you merge your PR, you'll have to wait a little bit before it is released.
+
+To make a breaking change:
+
+1. Make sure you're PR is targeting the `major` branch
+2. Add `!` after the conventional commit type (`fix!: ...`, `feat!: ...`, `chore!: ...`, etc) to indicate that it is a breaking change
+3. At the top of the PR, provide documentation that will inform developers about the breaking change, why it was done, and how to migrate their extension so nothing breaks.
+   - This documentation will be put ["Upgrading WXT"](https://wxt.dev/guide/resources/upgrading.html) page in the docs, read through previous breaking change docs for an idea of what is required.
+
 ## Setup
 
-WXT uses `pnpm`, so make sure you have it installed.
+WXT uses Bun for package management and development. Install it from: <https://bun.com/>
+
+Then install dependencies:
 
 ```sh
-corepack enable
-```
-
-Then, simply run the install command:
-
-```sh
-pnpm i
+bun install
 ```
 
 ## Development
@@ -39,48 +61,68 @@ pnpm i
 Here are some helpful commands:
 
 ```sh
-# Build WXT package
-cd packages/wxt
-pnpm build
+# Build WXT package and workspace dependencies
+bun run --filter wxt build
 ```
 
 ```sh
-# Build WXT package, then build demo extension
-cd packages/wxt-demo
-pnpm build
-```
-
-```sh
-# Build WXT package, then start the demo extension in dev mode
-cd packages/wxt-demo
-pnpm dev
+# Build workspace dependencies, then start the demo extension in dev mode
+bun run --filter wxt-demo dev
 ```
 
 ```sh
 # Run unit and E2E tests
-pnpm test
+bun run test
 ```
 
 ```sh
 # Start the docs website locally
-pnpm docs:dev
+bun run docs:dev
 ```
 
+> Above, we used bun's `--filter` flag to choose which package to run a command in, but there are other ways:
+>
+> ```sh
+> bun run -F @wxt-dev/i18n build
+> # or
+> bun run --cwd packages/i18n build
+> # or
+> cd packages/i18n
+> bun run build
+> ```
+>
+> Pick your poison!
+
 ## Profiling
 
 ```sh
 # Build the latest version
-pnpm --filter wxt build
+bun run --filter wxt build
 
 # CD to the demo directory
 cd packages/wxt-demo
-
-# 1. Generate a flamechart with 0x
-pnpm dlx 0x node_modules/wxt/bin/wxt.mjs build
-# 2. Inspect the process with chrome @ chrome://inspect
-pnpm node --inspect node_modules/wxt/bin/wxt.mjs build
 ```
 
+Then there are a few different ways to profile WXT commands:
+
+- Generate a flamechart with 0x:
+
+  ```sh
+  bunx 0x node_modules/wxt/bin/wxt.mjs build
+  ```
+
+- Create a CPU profile:
+
+  ```sh
+  bun run --cpu-prof node_modules/wxt/bin/wxt.mjs build
+  ```
+
+- Debug the process:
+
+  ```sh
+  bun run --inspect node_modules/wxt/bin/wxt.mjs build
+  ```
+
 ## Updating Docs
 
 Documentation is written with VitePress, and is located in the `docs/` directory.
@@ -96,7 +138,7 @@ WXT has unit and E2E tests. When making a change or adding a feature, make sure
 To run tests for a specific file, add the filename at the end of the test command:
 
 ```sh
-pnpm test manifest-contents
+bun run --filter wxt test manifest-contents
 ```
 
 All test (unit and E2E) for all packages are ran together via [Vitest workspaces](https://vitest.dev/guide/#workspaces-support).
@@ -105,7 +147,7 @@ If you want to manually test a change, you can modify the demo project for your
 
 ## Templates
 
-Each directory inside `templates/` is it's own standalone project. Simply `cd` into the directory you're updating, install dependencies with `npm` (NOT `pnpm`), and run the relevant commands
+Each directory inside `templates/` is it's own standalone project. Simply `cd` into the directory you're updating, install dependencies with `npm` (NOT `bun`), and run the relevant commands
 
 ```sh
 cd templates/vue
@@ -121,7 +163,7 @@ Note that templates are hardcoded to a specific version of `wxt` from NPM, they
     "typescript": "^5.3.2",
     "vite-plugin-solid": "^2.7.0",
 -   "wxt": "^0.8.0"
-+   "wxt": "../.."
++   "wxt": "../../packages/wxt"
   }
 ```
 
@@ -146,13 +188,17 @@ Releases are done with GitHub actions:
 
 ## Upgrading Dependencies
 
-Use [`taze`](https://www.npmjs.com/package/taze) to upgrade dependencies throughout the entire monorepo.
+WXT has custom rules around what dependencies can be upgraded. Use the `scripts/upgrade-deps.ts` script to upgrade dependencies and follow these rules.
 
 ```sh
-pnpm dlx taze -r
+bun run scripts/upgrade-deps.ts
 ```
 
-Configuration is in [`taze.config.ts`](./taze.config.ts).
+To see all the options, run:
+
+```sh
+bun run scripts/upgrade-deps.ts --help
+```
 
 ## Install Unreleased Versions
 
@@ -184,3 +230,9 @@ Anyone is welcome to submit a blog post on <https://wxt.dev/blog>!
 
 - **English only**: Blog posts should be written in English. Unfortunately, our maintainers don't have the bandwidth right now to translate our docs, let alone blog posts. Sorry 😓
 - **AI**: Please only use AI to translate or proof-read your blog post. Don't generate the whole thing... We don't want to publish that.
+
+## Become a Maintainer
+
+If you're interested in becoming a maintainer, send an email to Aaron at <aaronklinker1@gmail.com> with your github username saying you're interested. The process is very informal, I will add you quickly if you've contributed code or answered questions and helped out the community!
+
+Maintainers don't have to just write code - they can manage issues, answer questions, review PRs, organize and prioritize work - there's lots of ways for you to help out.

MAINTAINERS.md

@@ -0,0 +1,90 @@
+# Maintainers
+
+A couple of things for you to consider before merging a PR or giving the go-ahead on a feature proposal.
+
+## Be picky about new features and packages
+
+We are responsible for maintaining them and fixing related bugs after the PR is merged. The community can always release their own WXT modules or packages, not everything needs to be built into WXT.
+
+## Prefer standards over customization
+
+Don't merge PRs that just add another way to do something, like [this one](https://github.com/wxt-dev/wxt/pull/2053#issuecomment-3857010196).
+
+WXT is opinionated, if you have questions about what is WXT's opinion or we need to create a new one, create an issue and @ me to discuss.
+
+## PRs should be small and targeted
+
+A PR should make one change. They should not make any unrelated changes outside of accomplishing the one thing. This makes PRs easier to review and they get merged more quickly - a win-win for everyone.
+
+## `@wxt-dev/*` packages are separate
+
+We can't make changes to these packages assuming people are using them only with WXT. For example, I almost missed [this PR](https://github.com/wxt-dev/wxt/pull/2049#issuecomment-3861251599).
+
+I want these packages to be usable on their own so if people don't like WXT's build tool, they can still use our other awesome packages.
+
+## Minimize dependencies
+
+I don't like how heavy lots of frameworks are. It's unavoidable to a certain extent, but if you can do something without another dependency, try to.
+
+If you need a dependency, look for one with zero dependencies and that's respectable.
+
+## Look at milestones
+
+I've organized WXT's long term plans into [milestones](https://github.com/wxt-dev/wxt/milestones), check those out to get an idea of my priorities for some of the larger features.
+
+## Require tests
+
+If someone opens a PR to fix a bug but doesn't include tests, don't merge the PR. Tests are required to prevent regressions and maintain a codebase long term.
+
+## Ask for reproductions for bugs
+
+You don't need to triage bugs if someone doesn't give you enough information. You can always ask for a repo with a reproduction or wait for more details.
+
+If there's not an easy way to reproduce a bug, you're wasting your time triaging it. Just be mindful of your own time!
+
+Here's an example of how to ask for a reproduction: <https://github.com/wxt-dev/wxt/issues/2064#issuecomment-3862579110>. You could be more blunt than this.
+
+## Add yourself as a code owner
+
+If you want to be responsible for a specific package or directory, add yourself to the [`.github/CODEOWNERS`](https://github.com/wxt-dev/wxt/blob/main/.github/CODEOWNERS) file to get added as a reviewer to PRs automatically. You can also add yourself to the default list to be added as a reviewer on all PRs.
+
+## Releasing Package Updates
+
+Releases are done with GitHub actions:
+
+- Use the [Release workflow](https://github.com/wxt-dev/wxt/actions/workflows/release.yml) to release a single package in the monorepo. This automatically detects the version change with conventional commits, builds and uploads the package to NPM, and creates a GitHub release.
+- Use the [Sync Releases workflow](https://github.com/wxt-dev/wxt/actions/workflows/sync-releases.yml) to sync the GitHub releases with changes to the changelog. To change a release, update the `CHANGELOG.md` file and run the workflow. It will sync the releases of a single package in the monorepo.
+
+## Creating New Packages
+
+Example PR: <https://github.com/wxt-dev/wxt/pull/2152>
+
+1. Create the package.
+
+2. Update CI workflow inputs.
+
+3. Add docs page and version for "Other Packages" dropdown.
+
+4. Merge the PR.
+
+5. Tag the commit (look at other tags for pattern):
+
+   ```sh
+   git tag <dir-name>-v<version>
+   git push --tags
+   ```
+
+6. Publish the package to NPM:
+
+   ```sh
+   cd packages/<dir-name>
+   bun publish --access public
+   ```
+
+7. Create a basic release on GitHub mentioning the new package is available.
+
+A couple of things to note:
+
+- pkg.pr.new will fail on the original PR. It's fine to ignore and merge your PR as long as it fails due to your new package not being published to NPM yet.
+- The regular release workflow DOES NOT WORK for new packages. You have to have at least one `<dir-name>-v<version>` tag created before you can run that workflow for your new package.
+- You don't need to create a CHANGELOG.md file for the package, it will be created automatically after future changes are released via the normal release workflow.

SECURITY.md

@@ -4,12 +4,8 @@ While WXT is in prerelease, only the latest version will receive security update
 
 <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.
+If you discover a security vulnerability, please email me at <aaronklinker1@gmail.com>. I will respond within a few days to acknowledge receipt of your report.
 
-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.
--->
+If the vulnerability is accepted, I will open a public issue to track the fix. If the vulnerability is not accepted, no further action will be taken.

cspell.yml

@@ -0,0 +1,118 @@
+version: '0.2'
+ignorePaths:
+  - pnpm-lock.yaml
+  - '**/node_modules/**'
+  - '**/dist/**'
+  - '**/coverage/**'
+  - docs/api/**
+  - '**/CHANGELOG.md'
+  - docs/public/_redirects
+  - packages/browser/src/gen/**
+  - patches/**
+  - '**/*.snap'
+  - docs/assets/extension-showcase.yml
+words:
+  - Aabid
+  - aabidk
+  - aklinker
+  - automount
+  - avenir
+  - bidi
+  - buildc
+  - bunx
+  - cachable
+  - charmbracelet
+  - chromedriver
+  - Cira
+  - comctx
+  - confbox
+  - configfile
+  - consolas
+  - Cpath
+  - crbug
+  - crunchyroll
+  - cssinjs
+  - CSUI
+  - Csvg
+  - defu
+  - deinit
+  - dequal
+  - dtrace
+  - duckduckgo
+  - esbuild
+  - esque
+  - extglob
+  - favicons
+  - fieldtrials
+  - firefoxdeveloperedition
+  - flamechart
+  - Florian
+  - focusring
+  - frontmatter
+  - giget
+  - grayscale
+  - greyscale
+  - gtag
+  - hckhakegfgenefhikdcfkaaonnclljmf
+  - hookable
+  - iconify
+  - jsons
+  - Kenobi
+  - keystyle
+  - klinker
+  - linkedom
+  - llms
+  - locationchange
+  - magicast
+  - Menlo
+  - menupanel
+  - metas
+  - mktemp
+  - mycompany
+  - nacl
+  - nanospinner
+  - natsu
+  - newtab
+  - njsproj
+  - nodebuffer
+  - Noto
+  - ntvs
+  - nypm
+  - ohash
+  - oklab
+  - oxlint
+  - pbbf
+  - personaltoolbar
+  - portaling
+  - prebundled
+  - prefs
+  - proxified
+  - pWXLO
+  - repost
+  - rxliuli
+  - sandboxed
+  - scule
+  - Segoe
+  - sidepanel
+  - sidepanels
+  - solidjs
+  - styl
+  - subdependency
+  - tabstrip
+  - teleporting
+  - treemap
+  - triaging
+  - umami
+  - ungh
+  - unimport
+  - unocss
+  - unrun
+  - unstub
+  - unwatch
+  - USSS
+  - vitepress
+  - webext
+  - webextension
+  - webextrc
+  - xcrun
+  - xlink

docs/.vitepress/components/UsingWxtSection.vue

@@ -1,149 +1,120 @@
 <script lang="ts" setup>
 import { computed } from 'vue';
-import useListExtensionDetails, {
-  ChromeExtension,
-} from '../composables/useListExtensionDetails';
+import useListExtensionDetails from '../composables/useListExtensionDetails';
+import _extensionEntries from '../../assets/extension-showcase.yml';
 
-// Add extension IDs to end of the list. On the website, extensions will be sorted by a combination of weekly active users and rating.
-// Change the commit message or PR title to: "docs: Added "[extension name]" to the homepage"
-const chromeExtensionIds = [
-  'ocfdgncpifmegplaglcnglhioflaimkd', // GitHub: Better Line Counts
-  'mgmdkjcljneegjfajchedjpdhbadklcf', // Anime Skip Player
-  'bfbnagnphiehemkdgmmficmjfddgfhpl', // UltraWideo
-  'elfaihghhjjoknimpccccmkioofjjfkf', // StayFree - Website Blocker & Web Analytics
-  'okifoaikfmpfcamplcfjkpdnhfodpkil', // Doozy: Ai Made Easy
-  'lknmjhcajhfbbglglccadlfdjbaiifig', // tl;dv - Record, Transcribe & ChatGPT for Google Meet
-  'oglffgiaiekgeicdgkdlnlkhliajdlja', // Youtube中文配音
-  'agjnjboanicjcpenljmaaigopkgdnihi', // PreMiD
-  'aiakblgmlabokilgljkglggnpflljdgp', // Markdown Sticky Notes
-  'nomnkbngkijpffepcgbbofhcnafpkiep', // DocVersionRedirector
-  'ceicccfeikoipigeghddpocceifjelph', // Plex Skipper
-  'aelkipgppclpfimeamgmlonimflbhlgf', // GitHub Custom Notifier
-  'djnlaiohfaaifbibleebjggkghlmcpcj', // Fluent Read
-  'nhclljcpfmmaiojbhhnkpjcfmacfcian', // Facebook Video Controls
-  'mblkhbaakhbhiimkbcnmeciblfhmafna', // ElemSnap - Quick capture of webpage elements and conversion to images,
-  'oajalfneblkfiejoadecnmodfpnaeblh', // MS Edge TTS (Text to Speech)
-  'nedcanggplmbbgmlpcjiafgjcpdimpea', // YTBlock - Block any content from YouTube™
-  'oadbjpccljkplmhnjekgjamejnbadlne', // demo.fun - Interactive product demos that convert
-  'iopdafdcollfgaoffingmahpffckmjni', // SmartEReply: Elevate Your LinkedIn™ Engagement with AI 🚀📈
-  'khjdmjcmpolknpccmaaipmidphjokhdf', // WorkFlowy MultiFlow
-  'fencadnndhdeggodopebjgdfdlhcimfk', // 香草布丁🌿🍮- https://github.com/Xdy1579883916/vanilla-pudding
-  'bnacincmbaknlbegecpioobkfgejlojp', // MaxFocus: Link Preview
-  'bcpgdpedphodjcjlminjbdeejccjbimp', // 汇率转换-中文版本
-  'loeilaonggnalkaiiaepbegccilkmjjp', // Currency Converter Plus
-  'npcnninnjghigjfiecefheeibomjpkak', // Respond Easy
-  'cfkdcideecefncbglkhneoflfnmhoicc', // mindful - stay focused on your goals
-  'lnhejcpclabmbgpiiomjbhalblnnbffg', // 1Proompt
-  'fonflmjnjbkigocpoommgmhljdpljain', // NiceTab - https://github.com/web-dahuyou/NiceTab
-  'fcffekbnfcfdemeekijbbmgmkognnmkd', // Draftly for LinkedIn
-  'nkndldfehcidpejfkokbeghpnlbppdmo', // YouTube Summarized - Summarize any YouTube video
-  'dbichmdlbjdeplpkhcejgkakobjbjalc', // 社媒助手 - https://github.com/iszhouhua/social-media-copilot
-  'opepfpjeogkbgeigkbepobceinnfmjdd', // Dofollow Links for SEO
-  'pdnenlnelpdomajfejgapbdpmjkfpjkp', // ChatGPT Writer: Use AI on Any Site (GPT-4o, Claude, Gemini, and More)
-  'jobnhifpphkgoelnhnopgkdhbdkiadmj', // discord message translator
-  'ncokhechhpjgjonhjnlaneglmdkfkcbj', // Habit Tracker app widget for daily habit tracking
-  'lnjaiaapbakfhlbjenjkhffcdpoompki', // Catppuccin for GitHub File Explorer Icons
-  'cpaedhbidlpnbdfegakhiamfpndhjpgf', // WebChat: Chat with anyone on any website
-  'fcphghnknhkimeagdglkljinmpbagone', // YouTube Auto HD + FPS
-  'lpomjgbicdemjkgmbnkjncgdebogkhlb', // MultiViewer Companion
-  'ggiafipgeeaaahnjamgpjcgkdpanhddg', // Sync Watch - Watch videos together on any site
-  'nmldnjcblcihmegipecakhmnieiofmgl', // Keyword Rank Checker
-  'gppllamhaciichleihemgilcpledblpn', // YouTube Simple View - Hide distractions & more
-  'pccbghdfdnnkkbcdcibchpbffdgednkf', // Propbar - Property Data Enhancer
-  'lfknakglefggmdkjdfhhofkjnnolffkh', // Text Search Pro - Search by case and whole-word match!
-  'mbenhbocjckkbaojacmaepiameldglij', // Invoice Generator
-  'phlfhkmdofajnbhgmbmjkbkdgppgoppb', // Monthly Bill Tracker
-  'macmkmchfoclhpbncclinhjflmdkaoom', // Wandpen - Instantly improve your writing with AI
-  'lhmgechokhmdekdpgkkemoeecelcaonm', // YouTube Hider - Remove Comments By Keywords, Usernames & Tools
-  'imgheieooppmahcgniieddodaliodeeg', // QA Compass - Record standardized bug reports easily
-  'npgghjedpchajflknnbngajkjkdhncdo', // aesthetic Notion, styled
-  'hmdcmlfkchdmnmnmheododdhjedfccka', // Eye Dropper
-  'eihpmapodnppeemkhkbhikmggfojdkjd', // Cursorful - Screen Recorder with Auto Zoom
-  '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
-  'bmoggiinmnodjphdjnmpcnlleamkfedj', // AliasVault - Open-Source Password & (Email) Alias Manager
-  'hlnhhamckimoaiekbglafiebkfimhapb', // SnapThePrice: AI-Powered Real-time Lowest Price Finder
-  'gdjampjdgjmbifnhldgcnccdjkcoicmg', // radiofrance - news & broadcasts (French), music (international)
-  'jlnhphlghikichhgbnkepenehbmloenb', // Blens - Time Tracker and AI Insight
-  'njnammmpdodmfkodnfpammnpdcbhnlcm', // Always Light Mode - Setting website always in light mode
-  'lblmfclcfniabobmamfkdogcgdagbhhb', // DesignPicker - Color Picker & Font Detector
-  'pamnlaoeobcmhkliljfaofekeddpmfoh', // Web to PDF
-  'jmbcbeepjfenihlocplnbmbhimcoooka', // Online CSV Viewer
-  'nkjcoophmpcmmgadnljnlpbpfdfacgbo', // YouTube Video Transcript
-  'lcaieahkjgeggeiihblhcjbbjlppgieh', // NetSuite Record Scripts
-  'gmocfknjllodfiomnljmaehcplnekhlo', // VueTracker
-  'ggcfemmoabhhelfkhknhbnkmeahloiod', // CanCopy - A web extension that allow you to copy any content from website
-  'modkelfkcfjpgbfmnbnllalkiogfofhb', // Language Learning with AI
-  'npfopljnjbamegincfjelhjhnonnjloo', // Bilibili Feed History Helper
-  'edkhpdceeinkcacjdgebjehipmnbomce', // NZBDonkey - The ultimate NZB file download tool
-  'cckggnbnimdbbpmdinkkgbbncopbloob', // WeChat Markdown Editor(微信 Markdown 编辑器)
-  'jcblcjolcojmfopefcighfmkkefbaofg', // Tab Grab
-  'eehmoikadcijkapfjocnhjclpbaindlb', // BrowserLens - https://browserlens.com/
-  'hfhellofkjebbchcdffmicekjdomkcmc', // Epic Games Library Extension
-  'gknigcbhlammoakmmdddkblknanpjiac', // Zen Analytics Pixel Tracker - zapt.web.app
-  'cnklededohhcbmjjdlbjdkkihkgoggol', // Crypto Pulse - Compose your newtab with nature images, widgets & realtime Crypto Price & Bitcoin RSS.
-  'miponnamafdenpgjemkknimgjfibicdc', // Youtube Video Scheduler
-  'nhmbcmalgpkjbomhlhgdicanmkkaajmg', // Chatslator: Livestream Chat Translator
-  'mbamjfdjbcdgpopfnkkmlohadbbnplhm', // 公众号阅读增强器 - https://wxreader.honwhy.wang
-  'hannhecbnjnnbbafffmogdlnajpcomek', // 토탐정
-  'ehboaofjncodknjkngdggmpdinhdoijp', // 2FAS Pass - https://2fas.com/
-  'hnjamiaoicaepbkhdoknhhcedjdocpkd', // Quick Prompt - https://github.com/wenyuanw/quick-prompt
-  'kacblhilkacgfnkjfodalohcnllcgmjd', // Add QR Code Generator Icon Back To Address Bar
-  'fkbdlogfdjmpfepbbbjcgcfbgbcfcnne', // Piwik PRO Tracking Helper
-  'nkbikckldmljjiiajklecmgmajgapbfl', // PIPX - Take Control of Picture-in-Picture, Automatically
+interface StoreLink {
+  label: string;
+  url: string;
+}
+
+interface ListedExtension {
+  id: string;
+  name: string;
+  iconUrl: string;
+  shortDescription: string;
+  users: number;
+  rating: number | undefined;
+  stores: StoreLink[];
+}
+
+const extensionEntries = _extensionEntries as Array<{
+  chromeId?: string;
+  firefoxSlug?: string;
+}>;
+
+const chromeIds = extensionEntries.flatMap((e) =>
+  e.chromeId ? [e.chromeId] : [],
+);
+const firefoxSlugs = [
+  ...new Set(
+    extensionEntries.flatMap((e) => (e.firefoxSlug ? [e.firefoxSlug] : [])),
+  ),
 ];
 
-const { data, err, isLoading } = useListExtensionDetails(chromeExtensionIds);
-const sortedExtensions = computed(() => {
-  if (!data.value?.length) return [];
+const { data, isLoading } = useListExtensionDetails(chromeIds, firefoxSlugs);
 
-  return [...data.value]
-    .filter((item) => item != null)
-    .map((item) => ({
-      ...item,
-      // Sort based on the user count weighted by the rating
-      sortKey: ((item.rating ?? 5) / 5) * item.weeklyActiveUsers,
-    }))
-    .filter((item) => !!item)
-    .sort((l, r) => r.sortKey - l.sortKey);
-});
-
-function getStoreUrl(extension: ChromeExtension) {
-  const url = new URL(extension.storeUrl);
+function addUtmSource(storeUrl: string): string {
+  const url = new URL(storeUrl);
   url.searchParams.set('utm_source', 'wxt.dev');
   return url.href;
 }
+
+const sortedExtensions = computed((): ListedExtension[] => {
+  if (!data.value) return [];
+
+  const chromeById = new Map(
+    (data.value.chrome ?? []).filter(Boolean).map((e) => [e.id, e]),
+  );
+  const firefoxBySlug = new Map(
+    (data.value.firefox ?? []).filter(Boolean).map((e) => [e.id, e]),
+  );
+
+  const results: ListedExtension[] = [];
+
+  for (const entry of extensionEntries) {
+    const chrome = entry.chromeId ? chromeById.get(entry.chromeId) : undefined;
+    const firefox = entry.firefoxSlug
+      ? firefoxBySlug.get(entry.firefoxSlug)
+      : undefined;
+
+    if (!chrome && !firefox) continue;
+
+    const primary = chrome ?? firefox!;
+    const users = (chrome?.users ?? 0) + (firefox?.users ?? 0);
+    const rating = chrome?.rating ?? firefox?.rating;
+
+    const stores: StoreLink[] = [];
+    if (chrome) {
+      stores.push({ label: 'Chrome', url: addUtmSource(chrome.storeUrl) });
+    }
+    if (firefox) {
+      stores.push({ label: 'Firefox', url: addUtmSource(firefox.storeUrl) });
+    }
+
+    results.push({
+      id: entry.chromeId ?? `firefox:${entry.firefoxSlug}`,
+      name: primary.name,
+      iconUrl: primary.iconUrl,
+      shortDescription: primary.shortDescription,
+      users,
+      rating,
+      stores,
+    });
+  }
+
+  const score = (e: ListedExtension) => ((e.rating ?? 5) / 5) * e.users;
+  return results.sort((a, b) => score(b) - score(a));
+});
+
+function formatUsers(n: number): string {
+  return `${n.toLocaleString()} users`;
+}
+
+function formatStars(r: number): string {
+  const rounded = Math.round(r * 10) / 10;
+  return `${rounded % 1 === 0 ? rounded.toFixed(0) : rounded.toFixed(1)} stars`;
+}
 </script>
 
 <template>
   <p v-if="isLoading" style="text-align: center; opacity: 50%">Loading...</p>
   <p
-    v-else-if="err || sortedExtensions.length === 0"
+    v-else-if="sortedExtensions.length === 0"
     style="text-align: center; opacity: 50%"
   >
     Failed to load extension details.
   </p>
-  <ul v-else>
-    <li
-      v-for="extension of sortedExtensions"
-      :key="extension.id"
-      class="relative"
-    >
+  <ul v-else class="extension-grid">
+    <li v-for="extension of sortedExtensions" :key="extension.id">
       <img
         :src="extension.iconUrl"
         :alt="`${extension.name} icon`"
         referrerpolicy="no-referrer"
       />
-      <div class="relative">
+      <div class="card-content">
         <a
-          :href="getStoreUrl(extension)"
+          :href="extension.stores[0]?.url ?? '#'"
           target="_blank"
           :title="extension.name"
           class="extension-name"
@@ -152,19 +123,40 @@ function getStoreUrl(extension: ChromeExtension) {
         <p class="description" :title="extension.shortDescription">
           {{ extension.shortDescription }}
         </p>
+        <div v-if="extension.stores.length > 0" class="store-stats">
+          <span class="store-stats-info">
+            <span>{{ formatUsers(extension.users) }}</span>
+            <template v-if="extension.rating">
+              <span class="store-stats-sep" aria-hidden="true">,</span>
+              <span>{{ formatStars(extension.rating) }}</span>
+            </template>
+          </span>
+          <span class="store-stats-sep" aria-hidden="true">&middot;</span>
+          <span class="store-links">
+            <a
+              v-for="(store, i) of extension.stores"
+              :key="store.label"
+              :href="store.url"
+              target="_blank"
+              class="store-link"
+              :title="store.label"
+            >
+              {{ store.label
+              }}<span
+                v-if="i < extension.stores.length - 1"
+                class="store-stats-sep"
+                aria-hidden="true"
+                >,&nbsp;</span
+              >
+            </a>
+          </span>
+        </div>
       </div>
-      <p class="user-count">
-        <span>{{ extension.weeklyActiveUsers.toLocaleString() }} users</span
-        ><template v-if="extension.rating != null"
-          >,
-          <span>{{ extension.rating }} stars</span>
-        </template>
-      </p>
     </li>
   </ul>
   <p class="centered pr">
     <a
-      href="https://github.com/wxt-dev/wxt/edit/main/docs/.vitepress/components/UsingWxtSection.vue"
+      href="https://github.com/wxt-dev/wxt/edit/main/docs/assets/extension-showcase.yml"
       target="_blank"
       >Open a PR</a
     >
@@ -173,7 +165,7 @@ function getStoreUrl(extension: ChromeExtension) {
 </template>
 
 <style scoped>
-li img {
+.extension-grid > li > img {
   width: 116px;
   height: 116px;
   padding: 16px;
@@ -181,7 +173,7 @@ li img {
   background-color: var(--vp-c-default-soft);
 }
 
-ul {
+.extension-grid {
   display: grid;
   grid-template-columns: repeat(1, 1fr);
   align-items: stretch;
@@ -191,12 +183,12 @@ ul {
   padding: 0;
 }
 @media (min-width: 960px) {
-  ul {
+  .extension-grid {
     grid-template-columns: repeat(2, 1fr);
   }
 }
 
-li {
+.extension-grid > li {
   margin: 0 !important;
   padding: 16px;
   display: flex;
@@ -204,28 +196,68 @@ li {
   border-radius: 12px;
   flex: 1;
   gap: 24px;
-  align-items: center;
+  align-items: stretch;
 }
 
 .centered {
   text-align: center;
 }
 
-li a,
-li .user-count,
-li .description {
+.extension-grid > li .description {
   padding: 0;
   margin: 0;
 }
-li .user-count {
-  opacity: 70%;
-  font-size: small;
-  position: absolute;
-  bottom: 12px;
-  right: 16px;
+
+.extension-grid > li .card-content {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding-right: 0;
 }
 
-li a {
+.store-stats {
+  margin-top: auto;
+  padding-top: 6px;
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  align-items: baseline;
+  column-gap: 6px;
+  row-gap: 4px;
+  text-align: right;
+  font-size: 12px;
+  line-height: 1.45;
+  opacity: 0.72;
+  color: var(--vp-c-text-2);
+}
+
+.store-stats-info {
+  display: inline;
+}
+
+.store-stats-sep {
+  opacity: 0.45;
+  user-select: none;
+}
+
+.store-links {
+  display: inline;
+}
+
+.store-link {
+  text-decoration: none;
+  color: inherit;
+  cursor: pointer;
+}
+
+.store-link:hover {
+  color: var(--vp-c-text-1);
+  text-decoration: underline;
+}
+
+.extension-grid > li .extension-name {
   display: -webkit-box;
   -webkit-line-clamp: 1;
   -webkit-box-orient: vertical;
@@ -234,33 +266,23 @@ li a {
   padding: 0;
   margin: 0;
   text-decoration: none;
+  font-size: large;
 }
-li a:hover {
+
+.extension-grid > li .extension-name:hover {
   text-decoration: underline;
 }
 
-li div {
-  flex: 1;
-}
-
-li .description {
+.extension-grid > li .description {
   opacity: 90%;
   display: -webkit-box;
   -webkit-line-clamp: 2;
   -webkit-box-orient: vertical;
   overflow: hidden;
-  margin-bottom: 16px;
-}
-
-li .extension-name {
-  font-size: large;
+  margin-bottom: 0 !important;
 }
 
 .pr {
   opacity: 70%;
 }
-
-.relative {
-  position: relative;
-}
 </style>

docs/.vitepress/composables/useListExtensionDetails.ts

@@ -1,39 +1,58 @@
 import { ref } from 'vue';
 
-export interface ChromeExtension {
+export interface Extension {
   id: string;
   name: string;
   iconUrl: string;
-  weeklyActiveUsers: number;
   shortDescription: string;
   storeUrl: string;
   rating: number | undefined;
+  users: number;
+}
+
+export interface ExtensionResults {
+  chrome: Extension[];
+  firefox: Extension[];
 }
 
 const operationName = 'WxtDocsUsedBy';
-const query = `query ${operationName}($ids:[String!]!) {
-  chromeExtensions(ids: $ids) {
+const query = `query ${operationName}($chromeIds: [String!]!, $firefoxIds: [String!]!) {
+  chromeExtensions(ids: $chromeIds) {
     id
-    name
-    iconUrl
-    weeklyActiveUsers
-    shortDescription
-    storeUrl
-    rating
+    ...ExtensionData
   }
+  firefoxAddons(ids: $firefoxIds) {
+    id: slug
+    ...ExtensionData
+  }
+}
+
+fragment ExtensionData on Extension {
+  name
+  iconUrl
+  shortDescription
+  storeUrl
+  rating
+  users
 }`;
 
-export default function (ids: string[]) {
-  const data = ref<ChromeExtension[]>();
+export default function (chromeIds: string[], firefoxSlugs: string[]) {
+  const data = ref<ExtensionResults>();
   const err = ref<unknown>();
   const isLoading = ref(true);
 
+  if (chromeIds.length === 0 && firefoxSlugs.length === 0) {
+    data.value = { chrome: [], firefox: [] };
+    isLoading.value = false;
+    return { data, err, isLoading };
+  }
+
   fetch('https://queue.wxt.dev/api', {
     method: 'POST',
     body: JSON.stringify({
       operationName,
       query,
-      variables: { ids },
+      variables: { chromeIds, firefoxIds: firefoxSlugs },
     }),
     headers: {
       'Content-Type': 'application/json',
@@ -41,10 +60,11 @@ export default function (ids: string[]) {
   })
     .then(async (res) => {
       isLoading.value = false;
-      const {
-        data: { chromeExtensions },
-      } = await res.json();
-      data.value = chromeExtensions;
+      const { data: responseData } = await res.json();
+      data.value = {
+        chrome: responseData.chromeExtensions ?? [],
+        firefox: responseData.firefoxAddons ?? [],
+      };
       err.value = undefined;
     })
     .catch((error) => {
@@ -54,9 +74,5 @@ export default function (ids: string[]) {
       err.value = error;
     });
 
-  return {
-    data,
-    err,
-    isLoading,
-  };
+  return { data, err, isLoading };
 }

docs/.vitepress/config.ts

@@ -1,5 +1,25 @@
+import { Feed } from 'feed';
+import footnote from 'markdown-it-footnote';
+import fs, { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
 import { DefaultTheme, defineConfig } from 'vitepress';
+import addKnowledge from 'vitepress-knowledge';
+import {
+  groupIconMdPlugin,
+  groupIconVitePlugin,
+  localIconLoader,
+} from 'vitepress-plugin-group-icons';
+import llmstxt from 'vitepress-plugin-llms';
+import { version as analyticsVersion } from '../../packages/analytics/package.json';
+import { version as autoIconsVersion } from '../../packages/auto-icons/package.json';
+import { version as i18nVersion } from '../../packages/i18n/package.json';
+import { version as runnerVersion } from '../../packages/runner/package.json';
+import { version as storageVersion } from '../../packages/storage/package.json';
+import { version as unocssVersion } from '../../packages/unocss/package.json';
+import { version as wxtVersion } from '../../packages/wxt/package.json';
+import { version as isBackgroundVersion } from '../../packages/is-background/package.json';
 import typedocSidebar from '../api/reference/typedoc-sidebar.json';
+import { meta, script } from './utils/head';
 import {
   menuGroup,
   menuItem,
@@ -7,24 +27,6 @@ import {
   navItem,
   prepareTypedocSidebar,
 } from './utils/menus';
-import { meta, script } from './utils/head';
-import footnote from 'markdown-it-footnote';
-import { version as wxtVersion } from '../../packages/wxt/package.json';
-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 { version as analyticsVersion } from '../../packages/analytics/package.json';
-import { version as runnerVersion } from '../../packages/runner/package.json';
-import addKnowledge from 'vitepress-knowledge';
-import {
-  groupIconMdPlugin,
-  groupIconVitePlugin,
-  localIconLoader,
-} from 'vitepress-plugin-group-icons';
-import { Feed } from 'feed';
-import { writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
 
 const origin = 'https://wxt.dev';
 
@@ -43,6 +45,7 @@ const otherPackages = {
   storage: storageVersion,
   unocss: unocssVersion,
   runner: runnerVersion,
+  'is-background': isBackgroundVersion,
 };
 
 const knowledge = addKnowledge<DefaultTheme.Config>({
@@ -71,6 +74,7 @@ export default defineConfig({
   vite: {
     clearScreen: false,
     plugins: [
+      llmstxt(),
       groupIconVitePlugin({
         customIcon: {
           'wxt.config.ts': localIconLoader(
@@ -79,6 +83,17 @@ export default defineConfig({
           ),
         },
       }),
+      {
+        name: 'yaml-loader',
+        load: {
+          handler: async (id) => {
+            if (id.endsWith('.yml') || id.endsWith('.yaml')) {
+              const obj = Bun.YAML.parse(await readFile(id, 'utf8'));
+              return `export default ${JSON.stringify(obj)}`;
+            }
+          },
+        },
+      },
     ],
   },
   lastUpdated: true,
@@ -109,7 +124,7 @@ export default defineConfig({
     });
     // console.log('rss.xml:');
     // console.log(feed.rss2());
-    await writeFile(join(site.outDir, 'rss.xml'), feed.rss2(), 'utf8');
+    await fs.writeFile(join(site.outDir, 'rss.xml'), feed.rss2());
   },
 
   head: [
@@ -220,6 +235,7 @@ export default defineConfig({
           menuItem('Storage', 'storage.md'),
           menuItem('Messaging', 'messaging.md'),
           menuItem('I18n', 'i18n.md'),
+          menuItem('Favicons', 'favicons.md'),
           menuItem('Scripting', 'scripting.md'),
           menuItem('WXT Modules', 'wxt-modules.md'),
           menuItem('Frontend Frameworks', 'frontend-frameworks.md'),

docs/.vitepress/loaders/cli.data.ts

@@ -1,6 +1,7 @@
-import { resolve } from 'node:path';
 import consola from 'consola';
 import spawn from 'nano-spawn';
+import { resolve } from 'node:path';
+import { version } from '../../../packages/wxt/package.json';
 
 const cliDir = resolve('packages/wxt/src/cli/commands');
 const cliDirGlob = resolve(cliDir, '**');
@@ -38,19 +39,20 @@ export default {
 
 async function getHelp(command: string): Promise<string> {
   const args = command.split(' ');
-  const res = await spawn(args[0], [...args.slice(1), '--help'], {
+  const result = await spawn(args[0], [...args.slice(1), '--help'], {
     cwd: 'packages/wxt',
   });
-  return res.stdout;
+  return result.stdout;
 }
 
-function getWxtHelp(command: string): Promise<string> {
-  return getHelp(`pnpm -s wxt ${command}`.trim());
+async function getWxtHelp(command: string): Promise<string> {
+  const res = await getHelp(`bun run --silent wxt ${command}`.trim());
+  return res.replaceAll('{{version}}', version);
 }
 
 async function getPublishExtensionHelp(command: string): Promise<string> {
   const res = await getHelp(
-    `./node_modules/.bin/publish-extension ${command}`.trim(),
+    `bun run --silent publish-extension ${command}`.trim(),
   );
   return res.replace(/\$ publish-extension/g, '$ wxt submit');
 }

docs/.vitepress/theme/custom.css

@@ -66,3 +66,29 @@ body {
 .dark .dark-netlify {
   display: inline;
 }
+
+/* Add Aaron's favorite pic from Artemis II to the hero section because it's cool. */
+.dark .VPHome::before {
+  content: '';
+  background-image: url('/assets/art002e009298.jpg');
+  opacity: 50%;
+  position: absolute;
+  width: 100vw;
+  height: 110vh;
+  background-size: cover;
+  background-position: 90%;
+  pointer-events: none;
+}
+.dark .VPHome::after {
+  content: '';
+  position: absolute;
+  width: 100vw;
+  height: 10vh;
+  top: 100vh;
+  background: linear-gradient(to bottom, transparent, var(--vp-c-bg));
+  pointer-events: none;
+  z-index: 0;
+}
+.item {
+  z-index: 1;
+}

docs/.vitepress/utils/menus.ts

@@ -77,9 +77,7 @@ export function menuItem(
   return { text, link };
 }
 
-/**
- * Clean up and add badges to typedoc leaf sections
- */
+/** Clean up and add badges to typedoc leaf sections */
 export function prepareTypedocSidebar(items: SidebarItem[]) {
   // skip contents file
   const filtered = items.slice(1);

docs/assets/extension-showcase.yml

@@ -0,0 +1,438 @@
+# Add extension entries to end of the list. On the website, extensions will be sorted by a combination of users and rating.
+#
+# Change the commit message or PR title to:
+#
+# > "docs: Added "[extension name]" to showcase"
+#
+# Use:
+#
+# - `chromeId` for the Chrome Web Store listing,
+# - `firefoxSlug` for Firefox Add-ons (slug from https://addons.mozilla.org/firefox/addon/{slug}/)
+#
+# You may include one or more of these fields for your extension.
+
+- # GitHub: Better Line Counts
+  chromeId: ocfdgncpifmegplaglcnglhioflaimkd
+  firefoxSlug: github-better-line-counts
+
+- # Anime Skip Player
+  chromeId: mgmdkjcljneegjfajchedjpdhbadklcf
+  firefoxSlug: anime-skip
+
+- # UltraWideo
+  chromeId: bfbnagnphiehemkdgmmficmjfddgfhpl
+  firefoxSlug: ultrawideo
+
+- # StayFree - Website Blocker & Web Analytics
+  chromeId: elfaihghhjjoknimpccccmkioofjjfkf
+  firefoxSlug: stayfree
+
+- # Doozy: Ai Made Easy
+  chromeId: okifoaikfmpfcamplcfjkpdnhfodpkil
+
+- # tl;dv - Record, Transcribe & ChatGPT for Google Meet
+  chromeId: lknmjhcajhfbbglglccadlfdjbaiifig
+
+- # Youtube中文配音
+  chromeId: oglffgiaiekgeicdgkdlnlkhliajdlja
+
+- # PreMiD
+  chromeId: agjnjboanicjcpenljmaaigopkgdnihi
+
+- # Markdown Sticky Notes
+  chromeId: aiakblgmlabokilgljkglggnpflljdgp
+  firefoxSlug: markdown-sticky-notes
+
+- # DocVersionRedirector
+  chromeId: nomnkbngkijpffepcgbbofhcnafpkiep
+
+- # Plex Skipper
+  chromeId: ceicccfeikoipigeghddpocceifjelph
+  firefoxSlug: plex-skipper
+
+- # GitHub Custom Notifier
+  chromeId: aelkipgppclpfimeamgmlonimflbhlgf
+  firefoxSlug: github-custom-notifier
+
+- # Fluent Read
+  chromeId: djnlaiohfaaifbibleebjggkghlmcpcj
+
+- # Facebook Video Controls
+  chromeId: nhclljcpfmmaiojbhhnkpjcfmacfcian
+  firefoxSlug: facebook-video-controls
+
+- # ElemSnap - Quick capture of webpage elements and conversion to images,
+  chromeId: mblkhbaakhbhiimkbcnmeciblfhmafna
+
+- # MS Edge TTS (Text to Speech)
+  chromeId: oajalfneblkfiejoadecnmodfpnaeblh
+  firefoxSlug: ms-edge-tts-text-to-speech
+
+- # YTBlock - Block any content from YouTube™
+  chromeId: nedcanggplmbbgmlpcjiafgjcpdimpea
+
+- # demo.fun - Interactive product demos that convert
+  chromeId: oadbjpccljkplmhnjekgjamejnbadlne
+
+- # SmartEReply: Elevate Your LinkedIn™ Engagement with AI 🚀📈
+  chromeId: iopdafdcollfgaoffingmahpffckmjni
+
+- # WorkFlowy MultiFlow
+  chromeId: khjdmjcmpolknpccmaaipmidphjokhdf
+
+- # 香草布丁🌿🍮- https://github.com/Xdy1579883916/vanilla-pudding
+  chromeId: fencadnndhdeggodopebjgdfdlhcimfk
+
+- # MaxFocus: Link Preview
+  chromeId: bnacincmbaknlbegecpioobkfgejlojp
+  firefoxSlug: maxfocus-link-preview
+
+- # 汇率转换-中文版本
+  chromeId: bcpgdpedphodjcjlminjbdeejccjbimp
+
+- # Currency Converter Plus
+  chromeId: loeilaonggnalkaiiaepbegccilkmjjp
+  firefoxSlug: currency-converter-plus
+
+- # Respond Easy
+  chromeId: npcnninnjghigjfiecefheeibomjpkak
+
+- # mindful - stay focused on your goals
+  chromeId: cfkdcideecefncbglkhneoflfnmhoicc
+
+- # 1Proompt
+  chromeId: lnhejcpclabmbgpiiomjbhalblnnbffg
+
+- # NiceTab - https://github.com/web-dahuyou/NiceTab
+  chromeId: fonflmjnjbkigocpoommgmhljdpljain
+
+- # Draftly for LinkedIn
+  chromeId: fcffekbnfcfdemeekijbbmgmkognnmkd
+
+- # YouTube Summarized - Summarize any YouTube video
+  chromeId: nkndldfehcidpejfkokbeghpnlbppdmo
+
+- # 社媒助手 - https://github.com/iszhouhua/social-media-copilot
+  chromeId: dbichmdlbjdeplpkhcejgkakobjbjalc
+
+- # Dofollow Links for SEO
+  chromeId: opepfpjeogkbgeigkbepobceinnfmjdd
+
+- # ChatGPT Writer: Use AI on Any Site (GPT-4o, Claude, Gemini, and More)
+  chromeId: pdnenlnelpdomajfejgapbdpmjkfpjkp
+
+- # discord message translator
+  chromeId: jobnhifpphkgoelnhnopgkdhbdkiadmj
+
+- # Habit Tracker app widget for daily habit tracking
+  chromeId: ncokhechhpjgjonhjnlaneglmdkfkcbj
+
+- # Catppuccin for GitHub File Explorer Icons
+  chromeId: lnjaiaapbakfhlbjenjkhffcdpoompki
+  firefoxSlug: catppuccin-web-file-icons
+
+- # WebChat: Chat with anyone on any website
+  chromeId: cpaedhbidlpnbdfegakhiamfpndhjpgf
+
+- # YouTube Auto HD + FPS
+  chromeId: fcphghnknhkimeagdglkljinmpbagone
+  firefoxSlug: youtube-auto-hd-fps
+
+- # MultiViewer Companion
+  chromeId: lpomjgbicdemjkgmbnkjncgdebogkhlb
+  firefoxSlug: multiviewer-companion
+
+- # Sync Watch - Watch videos together on any site
+  chromeId: ggiafipgeeaaahnjamgpjcgkdpanhddg
+  firefoxSlug: syncwatch
+
+- # Keyword Rank Checker
+  chromeId: nmldnjcblcihmegipecakhmnieiofmgl
+  firefoxSlug: keyword-rank-checker-sa
+
+- # YouTube Simple View - Hide distractions & more
+  chromeId: gppllamhaciichleihemgilcpledblpn
+  firefoxSlug: youtube-simple-view
+
+- # Propbar - Property Data Enhancer
+  chromeId: pccbghdfdnnkkbcdcibchpbffdgednkf
+
+- # Text Search Pro - Search by case and whole-word match!
+  chromeId: lfknakglefggmdkjdfhhofkjnnolffkh
+  firefoxSlug: text-search-pro-ext
+
+- # Invoice Generator
+  chromeId: mbenhbocjckkbaojacmaepiameldglij
+  firefoxSlug: quick-invoice-generator
+
+- # Monthly Bill Tracker
+  chromeId: phlfhkmdofajnbhgmbmjkbkdgppgoppb
+
+- # Wandpen - Instantly improve your writing with AI
+  chromeId: macmkmchfoclhpbncclinhjflmdkaoom
+
+- # YouTube Hider - Remove Comments By Keywords, Usernames & Tools
+  chromeId: lhmgechokhmdekdpgkkemoeecelcaonm
+
+- # QA Compass - Record standardized bug reports easily
+  chromeId: imgheieooppmahcgniieddodaliodeeg
+
+- # aesthetic Notion, styled
+  chromeId: npgghjedpchajflknnbngajkjkdhncdo
+
+- # Eye Dropper
+  chromeId: hmdcmlfkchdmnmnmheododdhjedfccka
+  firefoxSlug: eye_dropper
+
+- # Cursorful - Screen Recorder with Auto Zoom
+  chromeId: eihpmapodnppeemkhkbhikmggfojdkjd
+
+- # Show IP – Live View of Website IPs for Developers
+  chromeId: hjjkgbibknbahijglkffklflidncplkn
+
+- # Strong Password Generator
+  chromeId: ilbikcehnpkmldojkcmlldkoelofnbde
+  firefoxSlug: strongpasswordgenerator
+
+- # ZenGram: Mindful Instagram, Your Way
+  chromeId: ocllfkhcdopiafndigclebelbecaiocp
+
+- # Blync: Preview Links, Selection Search, AI Assistant
+  chromeId: odffpjnpocjfcaclnenaaaddghkgijdb
+
+- # HTML to Markdown - Convert webpages to markdown
+  chromeId: kofbbilhmnkcmibjbioafflgmpkbnmme
+
+- # Walmart WFS Profit Calculator
+  chromeId: boecmgggeigllcdocgioijmleimjbfkg
+  firefoxSlug: walmart-wfs-profit-calculator
+
+- # Youtube Live Chat Fullscreen
+  chromeId: dlnjcbkmomenmieechnmgglgcljhoepd
+  firefoxSlug: youtube-live-chat-fullscreen
+
+- # Python Code Runner
+  chromeId: keiealdacakpnbbljlmhfgcebmaadieg
+  firefoxSlug: code-runner-manager
+
+- # Monochromate
+  chromeId: hafcajcllbjnoolpfngclfmmgpikdhlm
+
+- # AliasVault - Open-Source Password & (Email) Alias Manager
+  chromeId: bmoggiinmnodjphdjnmpcnlleamkfedj
+
+- # SnapThePrice: AI-Powered Real-time Lowest Price Finder
+  chromeId: hlnhhamckimoaiekbglafiebkfimhapb
+
+- # radiofrance - news & broadcasts (French), music (international)
+  chromeId: gdjampjdgjmbifnhldgcnccdjkcoicmg
+
+- # Blens - Time Tracker and AI Insight
+  chromeId: jlnhphlghikichhgbnkepenehbmloenb
+  firefoxSlug: blens-timetracker-ai-insight
+
+- # Always Light Mode - Setting website always in light mode
+  chromeId: njnammmpdodmfkodnfpammnpdcbhnlcm
+
+- # DesignPicker - Color Picker & Font Detector
+  chromeId: lblmfclcfniabobmamfkdogcgdagbhhb
+  firefoxSlug: design-colorpicker-fontdetect
+
+- # Web to PDF
+  chromeId: pamnlaoeobcmhkliljfaofekeddpmfoh
+  firefoxSlug: export-web-to-pdf
+
+- # Online CSV Viewer
+  chromeId: jmbcbeepjfenihlocplnbmbhimcoooka
+  firefoxSlug: csv-viewer
+
+- # YouTube Video Transcript
+  chromeId: nkjcoophmpcmmgadnljnlpbpfdfacgbo
+  firefoxSlug: youtube-transcript-copy
+
+- # NetSuite Record Scripts
+  chromeId: lcaieahkjgeggeiihblhcjbbjlppgieh
+  firefoxSlug: netsuite-scripts-manager
+
+- # VueTracker
+  chromeId: gmocfknjllodfiomnljmaehcplnekhlo
+
+- # CanCopy - A web extension that allow you to copy any content from website
+  chromeId: ggcfemmoabhhelfkhknhbnkmeahloiod
+
+- # Read Frog
+  chromeId: modkelfkcfjpgbfmnbnllalkiogfofhb
+  firefoxSlug: read-frog-open-ai-translator
+
+- # Bilibili Feed History Helper
+  chromeId: npfopljnjbamegincfjelhjhnonnjloo
+
+- # NZBDonkey - The ultimate NZB file download tool
+  chromeId: edkhpdceeinkcacjdgebjehipmnbomce
+
+- # WeChat Markdown Editor(微信 Markdown 编辑器)
+  chromeId: cckggnbnimdbbpmdinkkgbbncopbloob
+
+- # Tab Grab
+  chromeId: jcblcjolcojmfopefcighfmkkefbaofg
+  firefoxSlug: tab-grab
+
+- # BrowserLens - https://browserlens.com/
+  chromeId: eehmoikadcijkapfjocnhjclpbaindlb
+  firefoxSlug: browserlens
+
+- # Epic Games Library Extension
+  chromeId: hfhellofkjebbchcdffmicekjdomkcmc
+  firefoxSlug: epic-games-library-extension
+
+- # Zen Analytics Pixel Tracker - zapt.web.app
+  chromeId: gknigcbhlammoakmmdddkblknanpjiac
+
+- # Crypto Pulse - Compose your newtab with nature images, widgets & realtime Crypto Price & Bitcoin RSS.
+  chromeId: cnklededohhcbmjjdlbjdkkihkgoggol
+
+- # Youtube Video Scheduler
+  chromeId: miponnamafdenpgjemkknimgjfibicdc
+  firefoxSlug: youtube-video-scheduler
+
+- # Chatslator: Livestream Chat Translator
+  chromeId: nhmbcmalgpkjbomhlhgdicanmkkaajmg
+  firefoxSlug: chatslator
+
+- # 公众号阅读增强器 - https://wxreader.honwhy.wang
+  chromeId: mbamjfdjbcdgpopfnkkmlohadbbnplhm
+
+- # 토탐정
+  chromeId: hannhecbnjnnbbafffmogdlnajpcomek
+  firefoxSlug: 토탐정
+
+- # 2FAS Pass - https://2fas.com/
+  chromeId: ehboaofjncodknjkngdggmpdinhdoijp
+  firefoxSlug: 2fas-pass-browser-extension
+
+- # Quick Prompt - https://github.com/wenyuanw/quick-prompt
+  chromeId: hnjamiaoicaepbkhdoknhhcedjdocpkd
+  firefoxSlug: quick-prompt
+
+- # Add QR Code Generator Icon Back To Address Bar
+  chromeId: kacblhilkacgfnkjfodalohcnllcgmjd
+
+- # Piwik PRO Tracking Helper
+  chromeId: fkbdlogfdjmpfepbbbjcgcfbgbcfcnne
+  firefoxSlug: piwik-pro-tracking-helper
+
+- # PIPX - Take Control of Picture-in-Picture, Automatically
+  chromeId: nkbikckldmljjiiajklecmgmajgapbfl
+
+- # Browsely - AI-powered browser extension
+  chromeId: hgppdobcpkfkmiegekaglonjajeojmdd
+
+- # Filmbudd Pro - Simple, private – and synced ratings and watch notes across all your devices
+  chromeId: ehmoihnjgkdimihkhokkmfjdgomohjgm
+
+- # MultiField CopyCat - Copy, Paste & Autofill Web Forms Instantly
+  chromeId: alglchohmdikgdjhafiicilegegieafa
+
+- # ChatSight - Add Table of Contents to ChatGPT
+  chromeId: aamihahiiogceidpbnfgehacgiecephe
+
+- # BetterCampus (prev. BetterCanvas)
+  chromeId: cndibmoanboadcifjkjbdpjgfedanolh
+  firefoxSlug: better-canvas
+
+- # Leetcode Fonts - Change fonts in leetcode effortlessly
+  chromeId: hinfimgacobnellbncbcpdlpaapcofaa
+
+- # TranslateManga - Manga Translator & Manga Tracker
+  chromeId: kbkbfefhhabpkibojinapkkgciiacggg
+
+- # SiteData - Free Website Traffic Checker & Reverse AdSense Tool
+  chromeId: emeakbgdecgmdjgegnejpppcnkcnoaen
+  firefoxSlug: sitedata
+
+- # Livestream Chat Reader - Text-to-Speech for YouTube/Twitch chat
+  chromeId: gpnckbhgpnjciklpoehkmligeaebigaa
+
+- # ChatGPT Token Counter - Count tokens in real time on chatgpt conversation
+  chromeId: fjlalaedpfcojcfpkgkglbjjbbkofgnl
+  firefoxSlug: chatgpt-token-counter
+
+- # LinuxDo Scripts - 为 linux.do 用户提供了一些增强功能
+  chromeId: fbgblmjbeebanackldpbmpacppflgmlj
+  firefoxSlug: linux_do-scripts
+
+- # Zen Virtual Piano - https://zen-piano.web.app/
+  chromeId: dfacnjidgbagicaekenjgclfnhdnjjdi
+
+- # Crypto Pulse price tracker - https://get-crypto-pulse.web.app/
+  chromeId: naeibcegmgpofimedkmfgjgphfhfhlab
+
+- # Redirect Web - Automatically redirect pages or open them in another app
+  chromeId: ffglckbhfbfmdkefdmjbhpnffkcmlhdh
+
+- # Capture It - Capture & Edit Screenshots
+  chromeId: eglpfhbhmelampoihamjomgkeobgdofl
+
+- # Teams Chat Exporter
+  chromeId: jmghclbfbbapimhbgnpffbimphlpolnm
+  firefoxSlug: teams-chat-exporter
+
+- # Lofi BGM Player - Free lofi focus music for work & study
+  chromeId: jdcppdokgfbnhiacbeplahgnciahnhck
+  firefoxSlug: lofi-bgm-player
+
+- # Margin - Annotate and highlight any webpage, with your notes saved to the decentralized AT Protocol.
+  chromeId: cgpmbiiagnehkikhcbnhiagfomajncpa
+
+- # KeyFloat - Floating multilingual keyboard with native key mappings, drag, dark mode, sounds, and dynamic layouts for macOS & Windows
+  chromeId: mfjdonmgmgcijagclnkfhmjiblbfjaid
+
+- # Glossy New Tab - Say Goodbye to Boring Tabs with live wallpapers
+  chromeId: dhiekgdaipindoapjmcnpompdknjeijf
+  firefoxSlug: glossy-new-tab
+
+- # All API Hub – AI Relay & New API Manager - https://github.com/qixing-jk/all-api-hub
+  chromeId: lapnciffpekdengooeolaienkeoilfeo
+  firefoxSlug: all-api-hub
+
+- # Scrape Similar - Extract data from websites into spreadsheets - https://github.com/zizzfizzix/scrape-similar
+  chromeId: bhgobenflkkhfcgkikejaaejenoddcmo
+
+- # isTrust - https://github.com/Internet-Society-Belgium/isTrust/
+  chromeId: kinlknncggaihnhdcalijdmpbhbflalm
+
+- # Dymo
+  chromeId: ojpakgiekphppgkcdihbjpafobhnhlkp
+
+- # Extension Rank Checker - Extension Ranker
+  chromeId: pmgehhllikbjmadpenhabejhpemplhmd
+  firefoxSlug: rank-checker
+
+- # PlayFaster - Enhanced playback speed control for online videos and audio
+  chromeId: fppcbkhpahkbgijkdcpjgjmhpfbmfiih
+  firefoxSlug: playfaster
+
+- # LatTab - Learn Latin With Every New Tab
+  chromeId: eiocjaocpmackhbaffoejkcmnfbdpgpj
+  firefoxSlug: lattab-learn-latin-new-tabs
+
+- # Vim What? - Interactive Vim command reference
+  chromeId: ngbehgnlcdjkbnihgpkgdangbhemidge
+  firefoxSlug: vim-what
+
+- # FRED - Fraud Recognition Easy Detection
+  chromeId: bjdbcabacnlmbpcmiapcdfancfgcakfn
+  firefoxSlug: fred
+
+- # Clear Wisdom - Gems of wisdom from James Clear's 3-2-1 newsletter
+  chromeId: jijfmgoijddfmlcdghopbkdpelbpmjdm
+  firefoxSlug: clear-wisdom
+
+- # Soundcloud Enhanced Pro
+  chromeId: ggplcohodggmdfpopelnpplhgfjclomi
+
+- # AlarmBot: ULTIMATE Web Monitoring & Smart Price Alerts
+  chromeId: mpckalcodookackleecihhnngdibelif
+
+- # TF2 Trader - TF2 & Steam Trading Extension - https://github.com/offish/tf2-trader
+  chromeId: gmicpekfpbikhibodgokfpghadkclhoe

docs/guide/essentials/config/browser-startup.md

@@ -32,6 +32,8 @@ You can configure browser startup in 3 places:
 To set or customize the browser opened during development:
 
 ```ts [web-ext.config.ts]
+import { defineWebExtConfig } from 'wxt';
+
 export default defineWebExtConfig({
   binaries: {
     chrome: '/path/to/chrome-beta', // Use Chrome Beta instead of regular Chrome
@@ -41,6 +43,18 @@ export default defineWebExtConfig({
 });
 ```
 
+```ts [wxt.config.ts]
+export default defineConfig({
+  webExt: {
+    binaries: {
+      chrome: '/path/to/chrome-beta', // Use Chrome Beta instead of regular Chrome
+      firefox: 'firefoxdeveloperedition', // Use Firefox Developer Edition instead of regular Firefox
+      edge: '/path/to/edge', // Open MS Edge when running "wxt -b edge"
+    },
+  },
+});
+```
+
 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
@@ -49,11 +63,13 @@ By default, to keep from modifying your browser's existing profiles, `web-ext` c
 
 Right now, Chromium based browsers are the only browsers that support overriding this behavior and persisting data when running the `dev` script multiple times.
 
-To persist data, set the `--user-data-dir` flag:
+To persist data, set the `--user-data-dir` flag in any of the config files mentioned above:
 
 :::code-group
 
 ```ts [Mac/Linux]
+import { defineWebExtConfig } from 'wxt';
+
 export default defineWebExtConfig({
   chromiumArgs: ['--user-data-dir=./.wxt/chrome-data'],
 });
@@ -61,6 +77,7 @@ export default defineWebExtConfig({
 
 ```ts [Windows]
 import { resolve } from 'node:path';
+import { defineWebExtConfig } from 'wxt';
 
 export default defineWebExtConfig({
   // On Windows, the path must be absolute
@@ -82,7 +99,30 @@ You can use any directory you'd like for `--user-data-dir`, the examples above c
 If you prefer to load the extension into your browser manually, you can disable the auto-open behavior:
 
 ```ts [web-ext.config.ts]
+import { defineWebExtConfig } from 'wxt';
+
 export default defineWebExtConfig({
   disabled: true,
 });
 ```
+
+### Enabling Chrome Features
+
+Some APIs are disabled in Chrome during development because of the default flags `web-ext` uses to launch Chrome, like the [Prompt API](https://developer.chrome.com/docs/ai/prompt-api).
+
+If your extension depends on new features or services, you can enable them via `chromiumArgs`:
+
+```ts
+import { defineWebExtConfig } from 'wxt';
+
+export default defineWebExtConfig({
+  chromiumArgs: [
+    // For example, this flag enables the Prompt API
+    '--disable-features=DisableLoadExtensionCommandLineSwitch',
+  ],
+});
+```
+
+There is no comprehensive list of what feature flags enable what APIs and services.
+
+Alternatively, if you can't find a flag that enables a feature you're looking for, [disable the opening the browser during development](#disable-opening-browser) and use your regular chrome profile for development.

docs/guide/essentials/config/hooks.md

@@ -11,7 +11,7 @@ export default defineConfig({
   hooks: {
     'build:manifestGenerated': (wxt, manifest) => {
       if (wxt.config.mode === 'development') {
-        manifest.title += ' (DEV)';
+        manifest.name += ' (DEV)';
       }
     },
   },
@@ -20,6 +20,8 @@ export default defineConfig({
 
 Most hooks provide the `wxt` object as the first argument. It contains the resolved config and other info about the current build. The other arguments can be modified by reference to change different parts of the build system.
 
+You can find the [list of all available hooks](/api/reference/wxt/interfaces/WxtHooks) in the API reference.
+
 Putting one-off hooks like this in your config file is simple, but if you find yourself writing lots of hooks, you should extract them into [WXT Modules](/guide/essentials/wxt-modules) instead.
 
 ## Execution Order

docs/guide/essentials/config/manifest.md

@@ -159,6 +159,30 @@ export default defineConfig({
 
 Alternatively, you can use [`@wxt-dev/auto-icons`](https://www.npmjs.com/package/@wxt-dev/auto-icons) to let WXT generate your icon at the required sizes.
 
+### Firefox `theme_icons`
+
+Firefox supports a [`theme_icons`](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action#theme_icons) field on the toolbar action that swaps between a light and dark variant based on the current browser theme.
+
+When [targeting Firefox](/guide/essentials/target-different-browsers.md), WXT auto-discovers paired light/dark icons in the `public/` directory and attaches them to `action` (MV3) or `browser_action` (MV2). You only need to drop both variants next to your regular icons:
+
+```plaintext
+public/
+├─ icon-16.png         # regular (default_icon)
+├─ icon-light-16.png   # Firefox light theme
+├─ icon-dark-16.png    # Firefox dark theme
+├─ icon-32.png
+├─ icon-light-32.png
+└─ icon-dark-32.png
+```
+
+A size is only included in `theme_icons` if **both** a light and a dark file are present. The following filename patterns are discovered:
+
+<<< @/../packages/wxt/src/core/utils/theme-icons.ts#snippet
+
+Only `.png` files are discovered today, even though Firefox supports `.svg` - follow [#1120](https://github.com/wxt-dev/wxt/issues/1120) for updates.
+
+If you set `manifest.action.theme_icons` (or `manifest.browser_action.theme_icons`) explicitly in `wxt.config.ts`, WXT will not overwrite it.
+
 ## Permissions
 
 > [Chrome docs](https://developer.chrome.com/docs/extensions/reference/permissions/)
@@ -176,6 +200,23 @@ export default defineConfig({
 });
 ```
 
+:::warning
+
+Different browsers support different permissions. You are responsible for passing only the permissions required for each browser:
+
+```ts
+export default defineConfig({
+  manifest: ({ browser }) => ({
+    permissions:
+      browser === 'chrome'
+        ? ['storage', 'favicon', 'declarativeNetRequest']
+        : ['storage', 'webRequest'],
+  }),
+});
+```
+
+:::
+
 ## Host Permissions
 
 > [Chrome docs](https://developer.chrome.com/docs/extensions/develop/concepts/declare-permissions#host-permissions)

docs/guide/essentials/config/runtime.md

@@ -23,12 +23,12 @@ export default defineAppConfig({
 This file is committed to the repo, so don't put any secrets here. Instead, use [Environment Variables](/guide/essentials/config/environment-variables)
 :::
 
-To access runtime config, WXT provides the `useAppConfig` function:
+To access runtime config, WXT provides the `getAppConfig` function:
 
 ```ts
-import { useAppConfig } from '#imports';
+import { getAppConfig } from '#imports';
 
-console.log(useAppConfig()); // { theme: "dark" }
+console.log(getAppConfig()); // { theme: "dark" }
 ```
 
 ## Environment Variables in App Config

docs/guide/essentials/content-scripts.md

@@ -591,6 +591,76 @@ For MV3, `injectScript` is synchronous and the injected script will be evaluated
 However for MV2, `injectScript` has to `fetch` the script's text content and create an inline `<script>` block. This means for MV2, your script is injected asynchronously and it will not be evaluated at the same time as your content script's `run_at`.
 :::
 
+The `script` element can be modified just before it is added to the DOM by using the `modifyScript` option. This can be used to e.g. modify `script.async`/`script.defer`, add event listeners to the element, or pass data to the script via `script.dataset`. An example:
+
+```ts
+// entrypoints/example.content.ts
+export default defineContentScript({
+  matches: ['*://*/*'],
+  async main() {
+    await injectScript('/example-main-world.js', {
+      modifyScript(script) {
+        script.dataset['greeting'] = 'Hello there';
+      },
+    });
+  },
+});
+```
+
+```ts
+// entrypoints/example-main-world.ts
+export default defineUnlistedScript(() => {
+  console.log(document.currentScript?.dataset['greeting']);
+});
+```
+
+`injectScript` returns the created script element. It can be used to e.g. send messages to the script in the form of custom events. The script can add an event listener for them via `document.currentScript`. An example of bidirectional communication:
+
+```ts
+// entrypoints/example.content.ts
+export default defineContentScript({
+  matches: ['*://*/*'],
+  async main() {
+    const { script } = await injectScript('/example-main-world.js', {
+      modifyScript(script) {
+        // Add a listener before the injected script is loaded.
+        script.addEventListener('from-injected-script', (event) => {
+          if (event instanceof CustomEvent) {
+            console.log(`${event.type}:`, event.detail);
+          }
+        });
+      },
+    });
+
+    // Send an event after the injected script is loaded.
+    script.dispatchEvent(
+      new CustomEvent('from-content-script', {
+        detail: 'General Kenobi',
+      }),
+    );
+  },
+});
+```
+
+```ts
+// entrypoints/example-main-world.ts
+export default defineUnlistedScript(() => {
+  const script = document.currentScript;
+
+  script?.addEventListener('from-content-script', (event) => {
+    if (event instanceof CustomEvent) {
+      console.log(`${event.type}:`, event.detail);
+    }
+  });
+
+  script?.dispatchEvent(
+    new CustomEvent('from-injected-script', {
+      detail: 'Hello there',
+    }),
+  );
+});
+```
+
 ## Mounting UI to dynamic element
 
 In many cases, you may need to mount a UI to a DOM element that does not exist at the time the web page is initially loaded. To handle this, use the `autoMount` API to automatically mount the UI when the target element appears dynamically and unmount it when the element disappears. In WXT, the `anchor` option is used to target the element, enabling automatic mounting and unmounting based on its appearance and removal.

docs/guide/essentials/entrypoints.md

@@ -470,6 +470,19 @@ When you define a Newtab entrypoint, WXT will automatically update the manifest
     />
     <meta name="manifest.type" content="page_action|browser_action" />
     <meta name="manifest.browser_style" content="true|false" />
+    <!-- Firefox only: where to place the action button -->
+    <meta
+      name="manifest.default_area"
+      content="navbar|menupanel|tabstrip|personaltoolbar"
+    />
+    <!-- Firefox only: icons for light/dark themes -->
+    <meta
+      name="manifest.theme_icons"
+      content="[
+        { light: '/icon-light-16.png', dark: '/icon-dark-16.png', size: 16 },
+        { light: '/icon-light-32.png', dark: '/icon-dark-32.png', size: 32 }
+      ]"
+    />
 
     <!-- Set include/exclude if the page should be removed from some builds -->
     <meta name="manifest.include" content="['chrome', ...]" />

docs/guide/essentials/es-modules.md

@@ -25,7 +25,7 @@ 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.
+This will change the output format to ESM, enable code-splitting 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.

docs/guide/essentials/extension-apis.md

@@ -76,6 +76,28 @@ Alternatively, if you're trying to use similar APIs under different names (to su
 });
 ```
 
+### Augmenting the Browser Type
+
+WXT's `browser` types are based on the `@types/chrome` package. That means some Firefox-specific APIs may not be typed, like `browser.sidebarAction`. If you want to add types for these APIs, you can augment the browser type to add them yourself:
+
+```ts
+// <srcDir>/browser-types.d.ts
+import '@wxt-dev/browser';
+import type { SidebarAction } from 'webextension-polyfill';
+
+declare module '@wxt-dev/browser' {
+  namespace Browser {
+    export const sidebarAction: SidebarAction.Static;
+  }
+}
+```
+
+> For this to work, you may need to install `@wxt-dev/browser` as a direct dependency.
+>
+> ```sh
+> pnpm add @wxt-dev/browser
+> ```
+
 ## Entrypoint Limitations
 
 Because WXT imports your entrypoint files into a NodeJS, non-extension environment, the `chrome`/`browser` variables provided to extensions by the browser **will not be available**.

docs/guide/essentials/favicons.md

@@ -0,0 +1,51 @@
+# Favicons
+
+[Chrome Docs](https://developer.chrome.com/docs/extensions/how-to/ui/favicons)
+
+Chromium-based browsers expose cached favicons through the `_favicon/` URL served from your extension. To use it, declare the `favicon` permission in your manifest and call `browser.runtime.getURL` with a `_favicon/` path:
+
+```ts
+// wxt.config.ts
+import { defineConfig } from 'wxt';
+
+export default defineConfig({
+  manifest: {
+    permissions: ['favicon'],
+  },
+});
+```
+
+```ts
+// Any entrypoint
+function getFaviconUrl(pageUrl: string, size = 16) {
+  const url = new URL(browser.runtime.getURL('/_favicon/'));
+  url.searchParams.set('pageUrl', pageUrl);
+  url.searchParams.set('size', String(size));
+  return url.toString();
+}
+```
+
+::: warning Chromium only
+The favicon API is only available on Chromium-based browsers. Firefox has no equivalent, so `/_favicon/` URLs will not resolve at runtime there. If your extension supports both browsers, gate favicon usage behind `import.meta.env.CHROME` (or similar) and declare the permission per-browser.
+:::
+
+## Usage from a content script
+
+WXT does **not** add a `web_accessible_resources` entry for `_favicon/*` — not every extension needs one, and adding it unconditionally would expose internals to sites that don't need them. If you want to load a favicon inside a content script (for example, as an `<img src>`), add your own entry in `wxt.config.ts`:
+
+```ts
+// wxt.config.ts
+import { defineConfig } from 'wxt';
+
+export default defineConfig({
+  manifest: {
+    permissions: ['favicon'],
+    web_accessible_resources: [
+      {
+        resources: ['_favicon/*'],
+        matches: ['<all_urls>'],
+      },
+    ],
+  },
+});
+```

docs/guide/essentials/publishing.md

@@ -72,13 +72,13 @@ jobs:
   submit:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: pnpm/action-setup@v4
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -163,8 +163,8 @@ yarn zip:firefox
 ```
 
 ```sh [bun]
-bun i
-bun zip:firefox
+bun install
+bun run zip:firefox
 ```
 
 :::

docs/guide/essentials/unit-testing.md

@@ -9,7 +9,7 @@ WXT provides first class support for Vitest for unit testing:
 ```ts
 // vitest.config.ts
 import { defineConfig } from 'vitest/config';
-import { WxtVitest } from 'wxt/testing';
+import { WxtVitest } from 'wxt/testing/vitest-plugin';
 
 export default defineConfig({
   plugins: [WxtVitest()],
@@ -36,7 +36,7 @@ This example demonstrates that you don't have to mock `browser.storage` (used by
 
 ```ts
 import { describe, it, expect } from 'vitest';
-import { fakeBrowser } from 'wxt/testing';
+import { fakeBrowser } from 'wxt/testing/fake-browser';
 
 const accountStorage = storage.defineItem<Account>('local:account');
 

docs/guide/essentials/wxt-modules.md

@@ -1,32 +1,24 @@
+---
+outline: deep
+---
+
 # WXT Modules
 
-WXT provides a "module system" that let's you run code at different steps in the build process to modify it.
+WXT provides a "module system" that lets you run code at different steps in the build process to modify it.
 
 [[toc]]
 
-## Adding a Module
+## Installing a Module
 
-There are two ways to add a module to your project:
+To use a published module from NPM, install the package and add it to your config:
 
-1. **NPM**: install an NPM package, like [`@wxt-dev/auto-icons`](https://www.npmjs.com/package/@wxt-dev/auto-icons) and add it to your config:
+```ts [wxt.config.ts]
+export default defineConfig({
+  modules: ['@wxt-dev/auto-icons'],
+});
+```
 
-   ```ts [wxt.config.ts]
-   export default defineConfig({
-     modules: ['@wxt-dev/auto-icons'],
-   });
-   ```
-
-   > Searching for ["wxt module"](https://www.npmjs.com/search?q=wxt%20module) on NPM is a good way to find published WXT modules.
-
-2. **Local**: add a file to your project's `modules/` directory:
-
-   ```plaintext
-   <rootDir>/
-     modules/
-       my-module.ts
-   ```
-
-   > To learn more about writing your own modules, read the [Writing Modules](/guide/essentials/wxt-modules) docs.
+> Searching for ["wxt module"](https://www.npmjs.com/search?q=wxt%20module) on NPM is a good way to find published WXT modules.
 
 ## Module Options
 
@@ -45,7 +37,7 @@ Modules are loaded in the same order as hooks are executed. Refer to the [Hooks
 
 ## Writing Modules
 
-Here's what a basic WXT module looks like:
+If you need custom build logic for your project, you can write your own local module. Here's what a basic WXT module looks like:
 
 ```ts
 import { defineWxtModule } from 'wxt/modules';
@@ -57,6 +49,14 @@ export default defineWxtModule({
 });
 ```
 
+To add it to your project, place the file in the `modules/` directory at the root of your project. Any module file in this directory is **automatically discovered and loaded** — no additional configuration is needed:
+
+```plaintext
+<rootDir>/
+  modules/
+    my-module.ts    ← loaded automatically
+```
+
 Each module's setup function is executed after the `wxt.config.ts` file is loaded. The `wxt` object provides everything you need to write a module:
 
 - Use `wxt.hook(...)` to hook into the build's lifecycle and make changes
@@ -66,7 +66,7 @@ Each module's setup function is executed after the `wxt.config.ts` file is loade
 
 Refer to the [API reference](/api/reference/wxt/interfaces/Wxt) for a complete list of properties and functions available.
 
-Also to make sure and read about all the [hooks that are available](https://wxt.dev/api/reference/wxt/interfaces/WxtHooks) - they are essential to writing modules.
+Also make sure to read about [all the hooks that are available](/api/reference/wxt/interfaces/WxtHooks) - they are essential to writing modules.
 
 ### Recipes
 
@@ -131,12 +131,64 @@ declare module 'wxt/utils/define-app-config' {
 Runtime options are returned when calling
 
 ```ts
-const config = useAppConfig();
+const config = getAppConfig();
 console.log(config.myModule);
 ```
 
 This is very useful when [generating runtime code](#generate-runtime-module).
 
+#### Add custom entrypoint options
+
+Modules can add custom options to entrypoints by augmenting the entrypoint options types. This allows you to add custom configuration that can be accessed during the build process.
+
+```ts
+import { defineWxtModule } from 'wxt/modules';
+import 'wxt';
+
+declare module 'wxt' {
+  export interface BackgroundEntrypointOptions {
+    // Add custom options to the background entrypoint
+    myCustomOption?: string;
+  }
+}
+
+export default defineWxtModule({
+  setup(wxt) {
+    wxt.hook('entrypoints:resolved', (_, entrypoints) => {
+      const background = entrypoints.find((e) => e.type === 'background');
+      if (background) {
+        console.log('Custom option:', background.options.myCustomOption);
+      }
+    });
+  },
+});
+```
+
+Now users can set the custom option in their entrypoint:
+
+```ts [entrypoints/background.ts]
+export default defineBackground({
+  myCustomOption: 'custom value',
+  main() {
+    // ...
+  },
+});
+```
+
+This works for all other JS and HTML entrypoints, here's an example of how to pass a custom option from an HTML file.
+
+```html [entrypoints/popup.html]
+<html>
+  <head>
+    <meta name="wxt.myHtmlOption" content="custom value" />
+    <title>Popup</title>
+  </head>
+  <body>
+    <!-- ... -->
+  </body>
+</html>
+```
+
 #### Generate output file
 
 ```ts
@@ -220,7 +272,7 @@ export default defineWxtModule({
     const analyticsModuleCode = `
       import { createAnalytics } from 'some-module';
 
-      export const analytics = createAnalytics(useAppConfig().analytics);
+      export const analytics = createAnalytics(getAppConfig().analytics);
       export const { reportEvent, reportPageView } = analytics;
     `;
 

docs/guide/installation.md

@@ -76,7 +76,7 @@ Once you've run the `dev` command, continue to [Next Steps](#next-steps)!
    ```
 
    ```sh [Bun]
-   bun i -D wxt
+   bun add -D wxt
    ```
 
    ```sh [NPM]

docs/guide/resources/community.md

@@ -7,8 +7,10 @@ This page is dedicated to all the awesome people how have made something for WXT
 ## Blog Posts
 
 - [Building Modern Cross Browser Web Extensions](https://aabidk.dev/tags/wxt/) by Aabid ([@aabidk20](https://github.com/aabidk20))
+- [Building Browser Extensions with WXT](https://rxliuli.com/blog/browser-extension-dev-01-introduction-to-basic-concepts/) by rxliuli ([@rxliuli](https://github.com/rxliuli))
 
 ## 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.
+- [`wxt-local-analytics`](https://github.com/HaNdTriX/wxt-local-analytics): Local analytics provider for [`@wxt-dev/analytics`](https://wxt.dev/analytics)

docs/guide/resources/faq.md

@@ -36,7 +36,6 @@ This is usually caused by one of two things (or both) when using `createShadowRo
    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.
 
    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:
-
    - 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/)
 
@@ -165,6 +164,10 @@ Both issues have the same cause: the library puts something outside the `ShadowR
 
 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.
 
+## Does WXT provide docs for LLMs?
+
+Yes, WXT's documentation provides markdown files based on the [the /llms.txt proposal](https://llmstxt.org/).
+
 ## Is there an LLM trained on WXT's docs that I chat with?
 
 Yes! There's a "Ask AI" button in the bottom right of the page, try it out! Or visit <https://knowledge.wxt.dev/> for a fullscreen experience.
@@ -187,3 +190,33 @@ To run the WXT dev server in a devcontainer, but load the dev build of your exte
 
 3. **Tell WXT to listen on all network interfaces**
    To enable hot-reloading, your extension has to connect to the WXT dev server running inside your container. WXT will only listen on `localhost` by default, which prevents connections from outside the devcontainer. To fix this you can instruct WXT to listen on all interfaces with `wxt --host 0.0.0.0`.
+
+## How do I use the new Prompt API in Chrome?
+
+The service responsible for the [Prompt API](https://developer.chrome.com/docs/ai/prompt-api) is not enabled by default if you let WXT open the browser during dev mode. When checking `LanguageModel.availability`, you will always receive "unavailable".
+
+You have two options:
+
+1. Pass the `--disable-features=DisableLoadExtensionCommandLineSwitch` feature flag to enable the service in the browser WXT opens:
+
+   ```ts
+   // wxt.config.ts
+   export default defineConfig({
+     webExt: {
+       chromiumArgs: [
+         '--disable-features=DisableLoadExtensionCommandLineSwitch',
+       ],
+     },
+   });
+   ```
+
+2. Disable the runner and install your extension in your regular chrome profile manually:
+
+   ```ts
+   // wxt.config.ts
+   export default defineConfig({
+     webExt: {
+       disabled: true,
+     },
+   });
+   ```

docs/guide/resources/migrate.md

@@ -15,6 +15,11 @@ cd path/to/your/project
 pnpm dlx wxt@latest init example-wxt --template vanilla
 ```
 
+:::tip
+We recommend reviewing [project structure](/guide/essentials/project-structure.md) before you get started.
+You can customize directory names in `wxt.config.ts` to match your project's needs.
+:::
+
 In general, you'll need to:
 
 &ensp;<input type="checkbox" /> Install `wxt`<br />

docs/guide/resources/upgrading.md

@@ -54,7 +54,6 @@ See <https://github.com/wxt-dev/wxt/issues/784>
 To upgrade, you have two options:
 
 1. **Stop using the polyfill**
-
    - If you're already using `extensionApi: "chrome"`, then you're not using the polyfill and there is nothing to change!
    - Otherwise there is only one change: `browser.runtime.onMessage` no longer supports using promises to return a response:
 
@@ -71,7 +70,6 @@ To upgrade, you have two options:
      ```
 
 2. **Continue using the polyfill** - If you want to keep using the polyfill, you can! One less thing to worry about during this upgrade.
-
    - Install `webextension-polyfill` and WXT's [new polyfill module](https://www.npmjs.com/package/@wxt-dev/webextension-polyfill):
 
      ```sh
@@ -129,7 +127,6 @@ The default location for the `public/` and `modules/` directories have changed t
 
 - If you follow the default folder structure, you don't need to make any changes.
 - If you set a custom `srcDir`, you have two options:
-
   1. Move the your `public/` and `modules/` directories to the project root:
      <!-- prettier-ignore -->
      ```html
@@ -180,7 +177,7 @@ import { defineContentScript } from 'wxt/sandbox'; // [!code --]
 import { ContentScriptContext, useAppConfig } from 'wxt/client'; // [!code --]
 import { storage } from '#imports'; // [!code ++]
 import { defineContentScript } from '#imports'; // [!code ++]
-import { ContentScriptContext, useAppConfig } from '#imports'; // [!code ++]
+import { ContentScriptContext, getAppConfig } from '#imports'; // [!code ++]
 ```
 
 You can combine the imports into a single import statement, but it's easier to just find/replace each statement.
@@ -194,7 +191,7 @@ import {
   storage, // [!code ++]
   defineContentScript, // [!code ++]
   ContentScriptContext, // [!code ++]
-  useAppConfig, // [!code ++]
+  getAppConfig, // [!code ++]
 } from '#imports'; // [!code ++]
 ```
 
@@ -479,7 +476,7 @@ export default defineConfig({
 
 ### Renamed Undocumented Constants
 
-Renamed undocumented constants for detecting the build config at runtime in [#380](https://github.com/wxt-dev/wxt/pull/380). Now documented here: <https://wxt.dev/guide/multiple-browsers.html#runtime>
+Renamed undocumented constants for detecting the build config at runtime in [#380](https://github.com/wxt-dev/wxt/pull/380). Now documented here: <https://wxt.dev/guide/essentials/config/environment-variables.html#built-in-environment-variables>
 
 - `__BROWSER__` → `import.meta.env.BROWSER`
 - `__COMMAND__` → `import.meta.env.COMMAND`
@@ -560,6 +557,8 @@ Unlisted scripts must now `export default defineUnlistedScript(...)`.
 
 ### `BackgroundDefinition` Type
 
+<!-- cspell:disable -->
+
 Rename `BackgroundScriptDefintition` to `BackgroundDefinition`.
 
 ## v0.6.0 &rarr; v0.7.0

docs/is-background.md

@@ -0,0 +1 @@
+<!--@include: ../packages/is-background/README.md-->

docs/storage.md

@@ -4,7 +4,7 @@ outline: deep
 
 # WXT Storage
 
-[Changelog](https://github.com/wxt-dev/wxt/blob/main/packages/wxt/CHANGELOG.md)
+[Changelog](https://github.com/wxt-dev/wxt/blob/main/packages/wxt/CHANGELOG.md) • [API Reference](/api/reference/wxt/utils/storage/interfaces/WxtStorage)
 
 A simplified wrapper around the extension storage APIs.
 
@@ -74,7 +74,7 @@ await storage.watch<number>(
 await storage.getMeta<{ v: number }>('local:installDate');
 ```
 
-For a full list of methods available, see the [API reference](/api/reference/wxt/utils/storage/interfaces/WxtStorage).
+> This approach is fine for one-off storage fields or generic helpers, but [defining storage items](#defining-storage-items) is the recommended way to add type-safety.
 
 ## Watchers
 
@@ -146,7 +146,7 @@ const showChangelogOnUpdate = storage.defineItem<boolean>(
 );
 ```
 
-Now, instead of using the `storage` variable, you can use the helper functions on the storage item you created:
+Now, instead of using the `storage` variable, you can use the storage item instead:
 
 ```ts
 await showChangelogOnUpdate.getValue();
@@ -157,8 +157,6 @@ const unwatch = showChangelogOnUpdate.watch((newValue) => {
 });
 ```
 
-For a full list of properties and methods available, see the [API reference](/api/reference/wxt/utils/storage/interfaces/WxtStorageItem).
-
 ### Versioning
 
 You can add versioning to storage items if you expect them to grow or change over time. When defining the first version of an item, start with version 1.

docs/tapes/init-demo.tape

@@ -26,7 +26,7 @@ Set FontSize 32
 # Terminal settings
 Set Shell "bash"
 
-# Terminal prompt. It looks like "● mycommand ..."
+# Terminal prompt. It looks like "● command ..."
 Env PS1 "\e[0;32m●\e[0m "
 
 

netlify.toml

@@ -0,0 +1,6 @@
+[build]
+command = "bun run docs:build"
+publish = "docs/.vitepress/dist"
+
+[build.environment]
+BUN_VERSION = "1.3.5"

package.json

@@ -2,66 +2,68 @@
   "private": true,
   "type": "module",
   "engines": {
-    "node": ">=18.20.3"
+    "bun": ">=1.3.5"
   },
-  "packageManager": "pnpm@10.10.0",
+  "workspaces": [
+    "packages/*"
+  ],
   "scripts": {
-    "check": "check && pnpm -r --sequential run check",
-    "test": "pnpm -r --sequential run test run",
-    "test:coverage": "pnpm -r --sequential run test:coverage",
+    "check": "check && bun run --workspaces check",
+    "test": "bun run --workspaces test run",
+    "test:coverage": "bun run --workspaces test:coverage",
     "prepare": "simple-git-hooks",
-    "prepublish": "pnpm -s build",
     "docs:gen": "typedoc --options docs/typedoc.json",
-    "docs:dev": "pnpm -s docs:gen && vitepress dev docs",
-    "docs:build": "pnpm -s docs:gen && vitepress build docs",
-    "docs:preview": "pnpm -s docs:gen && vitepress preview docs"
+    "docs:dev": "bun run --silent docs:gen && bun run --bun vitepress dev docs",
+    "docs:build": "bun run --silent docs:gen && bun run --bun vitepress build docs",
+    "docs:preview": "bun run --silent docs:gen && bun run --bun vitepress preview docs"
   },
   "devDependencies": {
-    "@aklinker1/buildc": "^1.1.4",
-    "@aklinker1/check": "^2.1.0",
-    "@commitlint/config-conventional": "^19.8.0",
-    "@commitlint/types": "^19.8.0",
-    "@types/fs-extra": "^11.0.4",
-    "@vitest/coverage-v8": "^3.1.2",
-    "changelogen": "^0.6.1",
+    "@aklinker1/buildc": "^1.1.7",
+    "@aklinker1/check": "^2.4.0",
+    "@commitlint/config-conventional": "^20.4.3",
+    "@commitlint/types": "^20.4.3",
+    "@types/bun": "^1.3.5",
+    "@types/semver": "^7.7.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "changelogen": "^0.6.2",
     "consola": "^3.4.2",
-    "fast-glob": "^3.3.3",
-    "feed": "^4.2.2",
-    "fs-extra": "^11.3.0",
-    "lint-staged": "^15.5.1",
+    "cspell": "^9.7.0",
+    "feed": "^5.2.0",
     "markdown-it-footnote": "^4.0.0",
-    "markdownlint-cli": "^0.45.0",
-    "nano-spawn": "^0.2.0",
-    "prettier": "^3.5.3",
-    "simple-git-hooks": "^2.13.0",
-    "tsx": "4.19.4",
+    "markdownlint-cli": "^0.48.0",
+    "nano-spawn": "^2.0.0",
+    "nano-staged": "^0.8.0",
+    "p-map": "^7.0.4",
+    "pkg-pr-new": "^0.0.66",
+    "prettier": "^3.8.1",
+    "prettier-plugin-jsdoc": "^1.8.0",
+    "semver": "^7.7.4",
+    "simple-git-hooks": "^2.13.1",
+    "tinyglobby": "^0.2.15",
+    "tsdown": "^0.21.0",
+    "tsx": "4.21.0",
     "typedoc": "^0.25.4",
-    "typedoc-plugin-frontmatter": "^1.3.0",
+    "typedoc-plugin-frontmatter": "^1.3.1",
     "typedoc-plugin-markdown": "4.0.0-next.23",
     "typedoc-vitepress-theme": "1.0.0-next.3",
-    "typescript": "^5.8.3",
-    "vitepress": "^1.6.3",
+    "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
     "vitepress-knowledge": "^0.4.1",
-    "vitepress-plugin-group-icons": "^1.5.2",
+    "vitepress-plugin-group-icons": "^1.7.3",
+    "vitepress-plugin-llms": "^1.12.0",
     "vitest-mock-extended": "^3.1.0",
-    "vue": "^3.5.13",
+    "vue": "^3.5.29",
     "wxt": "workspace:*"
   },
+  "patchedDependencies": {
+    "markdown-it-footnote@4.0.0": "patches/markdown-it-footnote.patch",
+    "simple-git-hooks@2.13.1": "patches/simple-git-hooks@2.13.1.patch",
+    "pkg-pr-new@0.0.66": "patches/pkg-pr-new@0.0.66.patch"
+  },
   "simple-git-hooks": {
-    "pre-commit": "pnpm lint-staged"
+    "pre-commit": "./node_modules/.bin/nano-staged"
   },
-  "lint-staged": {
+  "nano-staged": {
     "*": "prettier --ignore-unknown --write"
-  },
-  "pnpm": {
-    "peerDependencyRules": {
-      "ignoreMissing": [
-        "@algolia/client-search",
-        "search-insights"
-      ]
-    },
-    "patchedDependencies": {
-      "markdown-it-footnote": "patches/markdown-it-footnote.patch"
-    }
   }
 }

packages/analytics/CHANGELOG.md

@@ -1,6 +1,94 @@
 # Changelog
 
+## v0.5.4
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/analytics-v0.5.3...analytics-v0.5.4)
+
+### 🩹 Fixes
+
+- Continue using `useAppConfig` to support older versions of WXT ([bfd94556](https://github.com/wxt-dev/wxt/commit/bfd94556))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+
+## v0.5.3
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/analytics-v0.5.2...analytics-v0.5.3)
+
+### 🩹 Fixes
+
+- Add `getAppConfig` as an alias to `useAppConfig` ([#2144](https://github.com/wxt-dev/wxt/pull/2144))
+- Allow `userId` option to return `undefined` ([636cf1f8](https://github.com/wxt-dev/wxt/commit/636cf1f8))
+- Improve background script detection logic for analytics package ([#1808](https://github.com/wxt-dev/wxt/pull/1808))
+
+### 🏡 Chore
+
+- Created new types, instead of `any` for `analytics` ([#2119](https://github.com/wxt-dev/wxt/pull/2119))
+
+### ❤️ Contributors
+
+- Smit ([@sm17p](https://github.com/sm17p))
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Patryk Kuniczak ([@PatrykKuniczak](https://github.com/PatrykKuniczak))
+- Sheng Zhang ([@Arktomson](https://github.com/Arktomson))
+
+## v0.5.2
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/analytics-v0.5.1...analytics-v0.5.2)
+
+### 🩹 Fixes
+
+- Normalize path for createAnalytics of analytics/index.ts ([#2013](https://github.com/wxt-dev/wxt/pull/2013))
+- Allow custom API URL in Google Analytics 4 provider options ([#1653](https://github.com/wxt-dev/wxt/pull/1653))
+
+### 💅 Refactors
+
+- Code cleanup in analytics package ([#2084](https://github.com/wxt-dev/wxt/pull/2084))
+
+### 🏡 Chore
+
+- Fix other type error after `chrome` types update ([31ebf966](https://github.com/wxt-dev/wxt/commit/31ebf966))
+- Upgrade dev and non-major prod dependencies ([#2000](https://github.com/wxt-dev/wxt/pull/2000))
+- Use `tsdown` to build packages ([#2006](https://github.com/wxt-dev/wxt/pull/2006))
+- Move script-only dev dependencies to top-level `package.json` ([#2007](https://github.com/wxt-dev/wxt/pull/2007))
+- Update dependencies ([#2069](https://github.com/wxt-dev/wxt/pull/2069))
+
+### ❤️ Contributors
+
+- Honwhy Wang <honwhy.wang@gmail.com>
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Patryk Kuniczak ([@PatrykKuniczak](https://github.com/PatrykKuniczak))
+
+## v0.5.1
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/analytics-v0.5.0...analytics-v0.5.1)
+
+### 🚀 Enhancements
+
+- Integrate latest measurement protocol changes ([#1767](https://github.com/wxt-dev/wxt/pull/1767))
+
+### 🩹 Fixes
+
+- Use `@wxt-dev/browser` instead of `@types/chrome` ([#1645](https://github.com/wxt-dev/wxt/pull/1645))
+
+### 🏡 Chore
+
+- Stop using PNPM catalog ([#1644](https://github.com/wxt-dev/wxt/pull/1644))
+- Upgrade `@aklinker1/check` to v2 ([#1647](https://github.com/wxt-dev/wxt/pull/1647))
+- Change browser workspace dependency to `^` ([c7335add](https://github.com/wxt-dev/wxt/commit/c7335add))
+- Fix auto-fixable `markdownlint` errors ([#1710](https://github.com/wxt-dev/wxt/pull/1710))
+- **deps:** Upgrade typescript from 5.8.3 to 5.9.2 ([a6eef643](https://github.com/wxt-dev/wxt/commit/a6eef643))
+- Create script for managing dependency upgrades ([#1875](https://github.com/wxt-dev/wxt/pull/1875))
+- **deps:** Upgrade all dev dependencies ([#1876](https://github.com/wxt-dev/wxt/pull/1876))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Tanishq-aggarwal ([@tanishq-aggarwal](https://github.com/tanishq-aggarwal))
+
 ## v0.5.0
+
 [⚠️ breaking changes](https://wxt.dev/guide/resources/upgrading.html) &bull; [compare changes](https://github.com/wxt-dev/wxt/compare/analytics-v0.4.1...analytics-v0.5.0)
 
 ### 🩹 Fixes
@@ -9,4 +97,4 @@
 
 ### ❤️ Contributors
 
-- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Aaron ([@aklinker1](https://github.com/aklinker1))

packages/analytics/build.config.ts

@@ -1,21 +0,0 @@
-import { defineBuildConfig } from 'unbuild';
-import { resolve } from 'node:path';
-
-// Build module and plugins
-export default defineBuildConfig({
-  rootDir: resolve(__dirname, '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,
-});

packages/analytics/modules/analytics/client.ts

@@ -2,17 +2,49 @@ import { UAParser } from 'ua-parser-js';
 import type {
   Analytics,
   AnalyticsConfig,
+  AnalyticsEventMetadata,
   AnalyticsPageViewEvent,
+  AnalyticsProvider,
   AnalyticsStorageItem,
   AnalyticsTrackEvent,
   BaseAnalyticsEvent,
-  AnalyticsEventMetadata,
-  AnalyticsProvider,
 } from './types';
 import { browser } from '@wxt-dev/browser';
+import { isBackground } from '@wxt-dev/is-background';
+
+type AnalyticsMessage = {
+  [K in keyof Analytics]: {
+    fn: K;
+    args: Parameters<Analytics[K]>;
+  };
+}[keyof Analytics];
+
+type AnalyticsMethod =
+  | ((...args: Parameters<Analytics[keyof Analytics]>) => void)
+  | undefined;
+
+type MethodForwarder = <K extends keyof Analytics>(
+  fn: K,
+) => (...args: Parameters<Analytics[K]>) => void;
 
 const ANALYTICS_PORT = '@wxt-dev/analytics';
 
+const INTERACTIVE_TAGS = new Set([
+  'A',
+  'BUTTON',
+  'INPUT',
+  'SELECT',
+  'TEXTAREA',
+]);
+const INTERACTIVE_ROLES = new Set([
+  'button',
+  'link',
+  'checkbox',
+  'menuitem',
+  'tab',
+  'radio',
+]);
+
 export function createAnalytics(config?: AnalyticsConfig): Analytics {
   if (!browser?.runtime?.id)
     throw Error(
@@ -24,16 +56,14 @@ export function createAnalytics(config?: AnalyticsConfig): Analytics {
     );
   }
 
-  // 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);
+  if (isBackground()) return createBackgroundAnalytics(config);
 
   return createFrontendAnalytics();
 }
 
 /**
- * Creates an analytics client in the background responsible for uploading events to the server to avoid CORS errors.
+ * Creates an analytics client in the background responsible for uploading
+ * events to the server to avoid CORS errors.
  */
 function createBackgroundAnalytics(
   config: AnalyticsConfig | undefined,
@@ -62,8 +92,8 @@ function createBackgroundAnalytics(
 
   const getBackgroundMeta = () => ({
     timestamp: Date.now(),
-    // Don't track sessions for the background, it can be running
-    // indefinitely, and will inflate session duration stats.
+    // 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,
@@ -75,7 +105,7 @@ function createBackgroundAnalytics(
   const getBaseEvent = async (
     meta: AnalyticsEventMetadata,
   ): Promise<BaseAnalyticsEvent> => {
-    const platform = await platformInfo;
+    const { arch, os } = await platformInfo;
     return {
       meta,
       user: {
@@ -84,8 +114,8 @@ function createBackgroundAnalytics(
           version: config?.version ?? manifest.version_name ?? manifest.version,
           wxtMode: import.meta.env.MODE,
           wxtBrowser: import.meta.env.BROWSER,
-          arch: platform.arch,
-          os: platform.os,
+          arch,
+          os,
           browser: userAgent.browser.name,
           browserVersion: userAgent.browser.version,
           ...(await userProperties),
@@ -147,7 +177,7 @@ function createBackgroundAnalytics(
     },
     track: async (
       eventName: string,
-      eventProperties?: Record<string, string>,
+      eventProperties?: Record<string, string | undefined>,
       meta: AnalyticsEventMetadata = getBackgroundMeta(),
     ) => {
       const baseEvent = await getBaseEvent(meta);
@@ -181,9 +211,8 @@ function createBackgroundAnalytics(
   // Listen for messages from the rest of the extension
   browser.runtime.onConnect.addListener((port) => {
     if (port.name === ANALYTICS_PORT) {
-      port.onMessage.addListener(({ fn, args }) => {
-        // @ts-expect-error: Untyped fn key
-        void analytics[fn]?.(...args);
+      port.onMessage.addListener(({ fn, args }: AnalyticsMessage) => {
+        void (analytics[fn] as AnalyticsMethod)?.(...args);
       });
     }
   });
@@ -191,9 +220,7 @@ function createBackgroundAnalytics(
   return analytics;
 }
 
-/**
- * Creates an analytics client for non-background contexts.
- */
+/** Creates an analytics client for non-background contexts. */
 function createFrontendAnalytics(): Analytics {
   const port = browser.runtime.connect({ name: ANALYTICS_PORT });
   const sessionId = Date.now();
@@ -201,17 +228,15 @@ function createFrontendAnalytics(): Analytics {
     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,
+    referrer: document.referrer || undefined,
+    screen: `${window.screen.width}x${window.screen.height}`,
     url: location.href,
     title: document.title || undefined,
   });
 
-  const methodForwarder =
-    (fn: string) =>
-    (...args: any[]) => {
+  const methodForwarder: MethodForwarder =
+    (fn) =>
+    (...args) => {
       port.postMessage({ fn, args: [...args, getFrontendMetadata()] });
     };
 
@@ -222,11 +247,11 @@ function createFrontendAnalytics(): Analytics {
     setEnabled: methodForwarder('setEnabled'),
     autoTrack: (root) => {
       const onClick = (event: Event) => {
-        const element = event.target as any;
+        const element = event.target as HTMLElement | null;
         if (
           !element ||
           (!INTERACTIVE_TAGS.has(element.tagName) &&
-            !INTERACTIVE_ROLES.has(element.getAttribute('role')))
+            !INTERACTIVE_ROLES.has(element.getAttribute('role') ?? ''))
         )
           return;
 
@@ -235,7 +260,7 @@ function createFrontendAnalytics(): Analytics {
           id: element.id || undefined,
           className: element.className || undefined,
           textContent: element.textContent?.substring(0, 50) || undefined, // Limit text content length
-          href: element.href,
+          href: (element as HTMLAnchorElement).href,
         });
       };
       root.addEventListener('click', onClick, { capture: true, passive: true });
@@ -247,33 +272,23 @@ function createFrontendAnalytics(): Analytics {
   return analytics;
 }
 
+function defineStorageItem<T>(key: string): AnalyticsStorageItem<T | undefined>;
 function defineStorageItem<T>(
   key: string,
-  defaultValue?: NonNullable<T>,
-): AnalyticsStorageItem<T> {
+  defaultValue: T,
+): AnalyticsStorageItem<T>;
+function defineStorageItem(
+  key: string,
+  defaultValue?: unknown,
+): AnalyticsStorageItem<unknown> {
   return {
     getValue: async () =>
-      (await browser.storage.local.get(key))[key] ?? defaultValue,
+      (await browser.storage.local.get<Record<string, unknown>>(key))[key] ??
+      defaultValue,
     setValue: (newValue) => browser.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. */

packages/analytics/modules/analytics/index.ts

@@ -8,6 +8,7 @@ import {
 } from 'wxt/modules';
 import { relative, resolve } from 'node:path';
 import type { AnalyticsConfig } from './types';
+import { normalizePath } from 'wxt';
 
 declare module 'wxt/utils/define-app-config' {
   export interface WxtAppConfig {
@@ -22,10 +23,10 @@ export default defineWxtModule({
     // Paths
     const wxtAnalyticsFolder = resolve(wxt.config.wxtDir, 'analytics');
     const wxtAnalyticsIndex = resolve(wxtAnalyticsFolder, 'index.ts');
-    const clientModuleId = import.meta.env.NPM
+    const clientModuleId = process.env.NPM
       ? '@wxt-dev/analytics'
       : resolve(wxt.config.modulesDir, 'analytics/client');
-    const pluginModuleId = import.meta.env.NPM
+    const pluginModuleId = process.env.NPM
       ? '@wxt-dev/analytics/background-plugin'
       : resolve(wxt.config.modulesDir, 'analytics/background-plugin');
 
@@ -38,17 +39,15 @@ export default defineWxtModule({
     });
 
     // Generate #analytics module
-    const wxtAnalyticsCode = [
-      `import { createAnalytics } from '${
-        import.meta.env.NPM
-          ? clientModuleId
-          : relative(wxtAnalyticsFolder, clientModuleId)
-      }';`,
-      `import { useAppConfig } from '#imports';`,
-      ``,
-      `export const analytics = createAnalytics(useAppConfig().analytics);`,
-      ``,
-    ].join('\n');
+    const wxtAnalyticsCode = `import { createAnalytics } from '${
+      process.env.NPM
+        ? clientModuleId
+        : normalizePath(relative(wxtAnalyticsFolder, clientModuleId))
+    }';
+import { useAppConfig } from '#imports';
+
+export const analytics = createAnalytics(useAppConfig().analytics);
+`;
     addAlias(wxt, '#analytics', wxtAnalyticsIndex);
     wxt.hook('prepare:types', async (_, entries) => {
       entries.push({

packages/analytics/modules/analytics/providers/google-analytics-4.ts

@@ -4,6 +4,7 @@ import type { BaseAnalyticsEvent } from '../types';
 const DEFAULT_ENGAGEMENT_TIME_IN_MSEC = 100;
 
 export interface GoogleAnalytics4ProviderOptions {
+  apiUrl?: string;
   apiSecret: string;
   measurementId: string;
 }
@@ -18,7 +19,7 @@ export const googleAnalytics4 =
       ): Promise<void> => {
         const url = new URL(
           config?.debug ? '/debug/mp/collect' : '/mp/collect',
-          'https://www.google-analytics.com',
+          options.apiUrl ?? 'https://www.google-analytics.com',
         );
         if (options.apiSecret)
           url.searchParams.set('api_secret', options.apiSecret);
@@ -46,6 +47,7 @@ export const googleAnalytics4 =
               ad_personalization: 'DENIED',
             },
             user_properties: mappedUserProperties,
+            user_agent: navigator.userAgent,
             events: [
               {
                 name: eventName,

packages/analytics/modules/analytics/types.ts

@@ -2,39 +2,45 @@ export interface Analytics {
   /** Report a page change. */
   page: (url: string) => void;
   /** Report a custom event. */
-  track: (eventName: string, eventProperties?: Record<string, string>) => void;
+  track: (
+    eventName: string,
+    eventProperties?: Record<string, string | undefined>,
+  ) => 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. */
+  /**
+   * 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.
-   */
+  /** Array of providers to send analytics to. */
   providers: AnalyticsProvider[];
-  /**
-   * Enable debug logs and other provider-specific debugging features.
-   */
+  /** Enable debug logs and other provider-specific debugging features. */
   debug?: boolean;
   /**
    * Your extension's version, reported alongside events.
+   *
    * @default browser.runtime.getManifest().version`.
    */
   version?: string;
   /**
-   * Configure how the enabled flag is persisted. Defaults to using `browser.storage.local`.
+   * Configure how the enabled flag is persisted. Defaults to using
+   * `browser.storage.local`.
    */
   enabled?: AnalyticsStorageItem<boolean>;
   /**
-   * Configure how the user Id is persisted. Defaults to using `browser.storage.local`.
+   * Configure how the user Id is persisted. Defaults to using
+   * `browser.storage.local`.
    */
-  userId?: AnalyticsStorageItem<string>;
+  userId?: AnalyticsStorageItem<string | undefined>;
   /**
-   * Configure how user properties are persisted. Defaults to using `browser.storage.local`.
+   * Configure how user properties are persisted. Defaults to using
+   * `browser.storage.local`.
    */
   userProperties?: AnalyticsStorageItem<Record<string, string>>;
 }
@@ -94,6 +100,6 @@ export interface AnalyticsPageViewEvent extends BaseAnalyticsEvent {
 export interface AnalyticsTrackEvent extends BaseAnalyticsEvent {
   event: {
     name: string;
-    properties?: Record<string, string>;
+    properties?: Record<string, string | undefined>;
   };
 }

packages/analytics/package.json

@@ -1,14 +1,40 @@
 {
   "name": "@wxt-dev/analytics",
-  "version": "0.5.0",
+  "version": "0.5.4",
   "description": "Add analytics to your web extension",
+  "type": "module",
+  "scripts": {
+    "dev": "buildc --deps-only -- wxt",
+    "dev:build": "buildc --deps-only -- wxt build",
+    "check": "bun run build && check",
+    "build": "buildc -- tsdown",
+    "prepack": "bun run build",
+    "postinstall": "buildc --deps-only -- wxt prepare",
+    "test": "echo 'noop'",
+    "test:coverage": "echo 'noop'"
+  },
+  "dependencies": {
+    "@wxt-dev/browser": "workspace:^",
+    "@wxt-dev/is-background": "workspace:^",
+    "ua-parser-js": "^1.0.40"
+  },
+  "peerDependencies": {
+    "wxt": ">=0.20.0"
+  },
+  "devDependencies": {
+    "@aklinker1/buildc": "^1.1.7",
+    "@types/ua-parser-js": "^0.7.39",
+    "publint": "^0.3.18",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3",
+    "wxt": "workspace:*"
+  },
   "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",
@@ -35,31 +61,8 @@
     }
   },
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "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.20.0"
-  },
-  "devDependencies": {
-    "@aklinker1/check": "2.0.0",
-    "@types/ua-parser-js": "^0.7.39",
-    "publint": "^0.3.12",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0",
-    "wxt": "workspace:*"
-  },
-  "dependencies": {
-    "@wxt-dev/browser": "workspace:^",
-    "ua-parser-js": "^1.0.40"
-  }
+  ]
 }

packages/analytics/tsdown.config.ts

@@ -0,0 +1,19 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  entry: {
+    index: './modules/analytics/client.ts',
+    module: './modules/analytics/index.ts',
+    'background-plugin': './modules/analytics/background-plugin.ts',
+    types: './modules/analytics/types.ts',
+    'providers/google-analytics-4':
+      './modules/analytics/providers/google-analytics-4.ts',
+    'providers/umami': './modules/analytics/providers/umami.ts',
+  },
+  deps: {
+    neverBundle: ['#analytics'],
+  },
+  define: {
+    'process.env.NPM': 'true',
+  },
+});

packages/auto-icons/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## v1.1.1
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/auto-icons-v1.1.0...auto-icons-v1.1.1)
+
+### 🩹 Fixes
+
+- Auto icons override default icons ([#1616](https://github.com/wxt-dev/wxt/pull/1616))
+
+### 💅 Refactors
+
+- Standardize file existence checks to `pathExists` ([#2083](https://github.com/wxt-dev/wxt/pull/2083))
+
+### 🏡 Chore
+
+- **deps:** Upgrade oxlint from 0.16.8 to 1.14.0 ([a01928e0](https://github.com/wxt-dev/wxt/commit/a01928e0))
+- **deps:** Upgrade typescript from 5.8.3 to 5.9.2 ([a6eef643](https://github.com/wxt-dev/wxt/commit/a6eef643))
+- Create script for managing dependency upgrades ([#1875](https://github.com/wxt-dev/wxt/pull/1875))
+- **deps:** Upgrade all dev dependencies ([#1876](https://github.com/wxt-dev/wxt/pull/1876))
+- **deps:** Upgrade non-breaking production dependencies ([#1877](https://github.com/wxt-dev/wxt/pull/1877))
+- Upgrade dev and non-major prod dependencies ([#2000](https://github.com/wxt-dev/wxt/pull/2000))
+- Use `tsdown` to build packages ([#2006](https://github.com/wxt-dev/wxt/pull/2006))
+- Move script-only dev dependencies to top-level `package.json` ([#2007](https://github.com/wxt-dev/wxt/pull/2007))
+- Update dependencies ([#2069](https://github.com/wxt-dev/wxt/pull/2069))
+
+### ❤️ Contributors
+
+- Omerfardemir <od080624@gmail.com>
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+
 ## v1.1.0
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/auto-icons-v1.0.2...auto-icons-v1.1.0)

packages/auto-icons/README.md

@@ -16,7 +16,7 @@ Install the package:
 npm i --save-dev @wxt-dev/auto-icons
 pnpm i -D @wxt-dev/auto-icons
 yarn add --dev @wxt-dev/auto-icons
-bun i -D @wxt-dev/auto-icons
+bun add -D @wxt-dev/auto-icons
 ```
 
 Add the module to `wxt.config.ts`:

packages/auto-icons/package.json

@@ -24,10 +24,10 @@
     }
   ],
   "license": "MIT",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "type": "module",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -38,23 +38,27 @@
     "dist"
   ],
   "scripts": {
-    "build": "buildc -- unbuild",
-    "check": "pnpm build && check"
+    "build": "buildc -- tsdown",
+    "check": "bun run build && check",
+    "test": "buildc --deps-only -- vitest",
+    "test:coverage": "bun run test run --coverage",
+    "prepack": "bun run build"
   },
   "peerDependencies": {
     "wxt": ">=0.19.0"
   },
   "dependencies": {
     "defu": "^6.1.4",
-    "fs-extra": "^11.3.0",
-    "sharp": "^0.34.1"
+    "sharp": "^0.34.5"
   },
   "devDependencies": {
-    "@aklinker1/check": "2.0.0",
-    "oxlint": "^0.16.8",
-    "publint": "^0.3.12",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0",
+    "@aklinker1/buildc": "^1.1.7",
+    "@types/fs-extra": "^11.0.4",
+    "oxlint": "^1.51.0",
+    "publint": "^0.3.18",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
     "wxt": "workspace:*"
   }
 }

packages/auto-icons/src/__test__/index.test.ts

@@ -0,0 +1,630 @@
+import { describe, it, expect, vi, beforeEach, Mock } from 'vitest';
+import { resolve } from 'node:path';
+import * as fsPromises from 'node:fs/promises';
+import sharp from 'sharp';
+import type { Wxt, UserManifest } from 'wxt';
+
+// Import the actual module
+import autoIconsModule from '../index';
+import type { AutoIconsOptions } from '../index';
+
+// Mock dependencies
+vi.mock('node:fs/promises', () => ({
+  mkdir: vi.fn(),
+  access: vi.fn(),
+}));
+
+vi.mock('sharp', () => ({
+  default: vi.fn(),
+}));
+
+// Type definitions for better type safety
+interface MockWxt {
+  config: {
+    srcDir: string;
+    outDir: string;
+    mode: 'development' | 'production';
+  };
+  logger: {
+    warn: Mock;
+  };
+  hooks: {
+    hook: Mock;
+  };
+}
+
+interface PublicAsset {
+  type: string;
+  fileName: string;
+}
+
+interface BuildOutput {
+  publicAssets: PublicAsset[];
+}
+
+describe('auto-icons module', () => {
+  const mockWxt: MockWxt = {
+    config: {
+      srcDir: '/mock/src',
+      outDir: '/mock/dist',
+      mode: 'development',
+    },
+    logger: {
+      warn: vi.fn(),
+    },
+    hooks: {
+      hook: vi.fn(),
+    },
+  };
+
+  const createMockSharpInstance = () => {
+    const instance = {
+      png: vi.fn(),
+      grayscale: vi.fn(),
+      resize: vi.fn(),
+      toFile: vi.fn().mockResolvedValue(undefined),
+    };
+
+    // Make methods chainable
+    instance.png.mockReturnValue(instance);
+    instance.grayscale.mockReturnValue(instance);
+    instance.resize.mockImplementation(() => {
+      // Create a new instance for each resize to simulate real sharp behavior
+      const resizedInstance = { ...instance };
+      resizedInstance.toFile = vi.fn().mockResolvedValue(undefined);
+      return resizedInstance;
+    });
+
+    return instance;
+  };
+
+  let mockSharpInstance: ReturnType<typeof createMockSharpInstance>;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockSharpInstance = createMockSharpInstance();
+    vi.mocked(sharp).mockReturnValue(
+      mockSharpInstance as unknown as sharp.Sharp,
+    );
+    vi.mocked(fsPromises.access).mockResolvedValue(undefined);
+    vi.mocked(fsPromises.mkdir).mockResolvedValue(undefined as any);
+  });
+
+  describe('module setup', () => {
+    it('should have correct module metadata', () => {
+      expect(autoIconsModule.name).toBe('@wxt-dev/auto-icons');
+      expect(autoIconsModule.configKey).toBe('autoIcons');
+      expect(typeof autoIconsModule.setup).toBe('function');
+    });
+  });
+
+  describe('options handling', () => {
+    it('should use default options when not provided', async () => {
+      const options: AutoIconsOptions = {};
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      // Verify that the module was set up (hooks were registered)
+      expect(mockWxt.hooks.hook).toHaveBeenCalledWith(
+        'build:manifestGenerated',
+        expect.any(Function),
+      );
+      expect(mockWxt.hooks.hook).toHaveBeenCalledWith(
+        'build:done',
+        expect.any(Function),
+      );
+      expect(mockWxt.hooks.hook).toHaveBeenCalledWith(
+        'prepare:publicPaths',
+        expect.any(Function),
+      );
+    });
+
+    it('should merge custom options with defaults', async () => {
+      const options: AutoIconsOptions = {
+        sizes: [64, 32],
+        grayscaleOnDevelopment: false,
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      // Verify that the module was set up with custom options
+      expect(mockWxt.hooks.hook).toHaveBeenCalledWith(
+        'build:manifestGenerated',
+        expect.any(Function),
+      );
+      expect(mockWxt.hooks.hook).toHaveBeenCalledWith(
+        'build:done',
+        expect.any(Function),
+      );
+      expect(mockWxt.hooks.hook).toHaveBeenCalledWith(
+        'prepare:publicPaths',
+        expect.any(Function),
+      );
+    });
+  });
+
+  describe('error handling', () => {
+    it('should warn when disabled', async () => {
+      const options: AutoIconsOptions = {
+        enabled: false,
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      expect(mockWxt.logger.warn).toHaveBeenCalledWith(
+        '`[auto-icons]` @wxt-dev/auto-icons disabled',
+      );
+      expect(mockWxt.hooks.hook).not.toHaveBeenCalled();
+    });
+
+    it('should warn when base icon not found', async () => {
+      vi.mocked(fsPromises.access).mockRejectedValue(new Error('ENOENT'));
+
+      const options: AutoIconsOptions = {
+        enabled: true,
+        baseIconPath: 'assets/missing-icon.png',
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      expect(mockWxt.logger.warn).toHaveBeenCalledWith(
+        expect.stringContaining(
+          'Skipping icon generation, no base icon found at',
+        ),
+      );
+      expect(mockWxt.hooks.hook).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('manifest generation hook', () => {
+    it('should update manifest with default icons when no custom sizes provided', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const manifestHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:manifestGenerated')?.[1];
+
+      expect(manifestHook).toBeDefined();
+
+      const manifest: UserManifest = {};
+      if (manifestHook) {
+        await manifestHook(mockWxt as unknown as Wxt, manifest);
+      }
+
+      // Should use default sizes: [128, 48, 32, 16]
+      expect(manifest.icons).toEqual({
+        128: 'icons/128.png',
+        48: 'icons/48.png',
+        32: 'icons/32.png',
+        16: 'icons/16.png',
+      });
+    });
+
+    it('should merge custom sizes with defaults', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+        sizes: [96, 64], // These will be merged with defaults
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const manifestHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:manifestGenerated')?.[1];
+
+      expect(manifestHook).toBeDefined();
+
+      const manifest: UserManifest = {};
+      if (manifestHook) {
+        await manifestHook(mockWxt as unknown as Wxt, manifest);
+      }
+
+      // defu merges arrays, so we get both custom and default sizes
+      expect(manifest.icons).toEqual({
+        96: 'icons/96.png',
+        64: 'icons/64.png',
+        128: 'icons/128.png',
+        48: 'icons/48.png',
+        32: 'icons/32.png',
+        16: 'icons/16.png',
+      });
+    });
+
+    it('should warn when overwriting existing icons in manifest', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const manifestHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:manifestGenerated')?.[1];
+
+      const manifest: UserManifest = {
+        icons: {
+          128: 'existing-icon.png',
+        },
+      };
+
+      if (manifestHook) {
+        await manifestHook(mockWxt as unknown as Wxt, manifest);
+      }
+
+      expect(mockWxt.logger.warn).toHaveBeenCalledWith(
+        '`[auto-icons]` icons property found in manifest, overwriting with auto-generated icons',
+      );
+    });
+  });
+
+  describe('icon generation hook', () => {
+    it('should generate icons with default sizes', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+      };
+
+      const output: BuildOutput = {
+        publicAssets: [],
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      expect(buildHook).toBeDefined();
+      if (buildHook) {
+        await buildHook(mockWxt as unknown as Wxt, output);
+      }
+
+      expect(sharp).toHaveBeenCalledWith(
+        resolve('/mock/src', 'assets/icon.png'),
+      );
+      expect(mockSharpInstance.png).toHaveBeenCalled();
+
+      // Should resize to default sizes
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(128);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(48);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(32);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(16);
+
+      expect(fsPromises.mkdir).toHaveBeenCalledWith(
+        resolve('/mock/dist', 'icons'),
+        { recursive: true },
+      );
+
+      expect(output.publicAssets).toEqual([
+        { type: 'asset', fileName: 'icons/128.png' },
+        { type: 'asset', fileName: 'icons/48.png' },
+        { type: 'asset', fileName: 'icons/32.png' },
+        { type: 'asset', fileName: 'icons/16.png' },
+      ]);
+    });
+
+    it('should generate icons with custom sizes merged with defaults', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+        sizes: [96, 64],
+      };
+
+      const output: BuildOutput = {
+        publicAssets: [],
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      expect(buildHook).toBeDefined();
+      if (buildHook) {
+        await buildHook(mockWxt as unknown as Wxt, output);
+      }
+
+      // Should include both custom and default sizes
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(96);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(64);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(128);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(48);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(32);
+      expect(mockSharpInstance.resize).toHaveBeenCalledWith(16);
+
+      expect(output.publicAssets).toEqual([
+        { type: 'asset', fileName: 'icons/96.png' },
+        { type: 'asset', fileName: 'icons/64.png' },
+        { type: 'asset', fileName: 'icons/128.png' },
+        { type: 'asset', fileName: 'icons/48.png' },
+        { type: 'asset', fileName: 'icons/32.png' },
+        { type: 'asset', fileName: 'icons/16.png' },
+      ]);
+    });
+
+    it('should apply grayscale in development mode', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+        grayscaleOnDevelopment: true,
+        sizes: [128],
+      };
+
+      const output: BuildOutput = { publicAssets: [] };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      if (buildHook) {
+        await buildHook(mockWxt as unknown as Wxt, output);
+      }
+
+      expect(mockSharpInstance.grayscale).toHaveBeenCalled();
+    });
+
+    it('should not apply grayscale in production mode', async () => {
+      const prodMockWxt = {
+        ...mockWxt,
+        config: {
+          ...mockWxt.config,
+          mode: 'production' as const,
+        },
+      };
+
+      const options: AutoIconsOptions = {
+        enabled: true,
+        grayscaleOnDevelopment: true,
+        sizes: [128],
+      };
+
+      const output: BuildOutput = { publicAssets: [] };
+
+      await autoIconsModule.setup!(prodMockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(prodMockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      if (buildHook) {
+        await buildHook(prodMockWxt as unknown as Wxt, output);
+      }
+
+      expect(mockSharpInstance.grayscale).not.toHaveBeenCalled();
+    });
+
+    it('should not apply grayscale when disabled', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+        grayscaleOnDevelopment: false,
+        sizes: [128],
+      };
+
+      const output: BuildOutput = { publicAssets: [] };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      if (buildHook) {
+        await buildHook(mockWxt as unknown as Wxt, output);
+      }
+
+      expect(mockSharpInstance.grayscale).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('public paths hook', () => {
+    it('should add default icon paths to public paths', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const pathsHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'prepare:publicPaths')?.[1];
+
+      expect(pathsHook).toBeDefined();
+
+      const paths: string[] = [];
+      if (pathsHook) {
+        pathsHook(mockWxt as unknown as Wxt, paths);
+      }
+
+      expect(paths).toEqual([
+        'icons/128.png',
+        'icons/48.png',
+        'icons/32.png',
+        'icons/16.png',
+      ]);
+    });
+  });
+
+  describe('edge cases and error handling', () => {
+    it('should handle empty sizes array', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+        sizes: [], // Empty array should still merge with defaults
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const manifestHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:manifestGenerated')?.[1];
+
+      const manifest: UserManifest = {};
+      if (manifestHook) {
+        await manifestHook(mockWxt as unknown as Wxt, manifest);
+      }
+
+      // Should still have default sizes due to defu merge
+      expect(manifest.icons).toEqual({
+        128: 'icons/128.png',
+        48: 'icons/48.png',
+        32: 'icons/32.png',
+        16: 'icons/16.png',
+      });
+    });
+
+    it('should handle sharp processing errors gracefully', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+      };
+
+      // Make toFile throw an error - need to properly chain resize -> png -> toFile
+      const errorInstance = {
+        toFile: vi.fn().mockRejectedValue(new Error('Sharp processing failed')),
+        grayscale: vi.fn(),
+        composite: vi.fn(),
+      };
+      errorInstance.grayscale.mockReturnValue(errorInstance);
+      errorInstance.composite.mockReturnValue(errorInstance);
+
+      mockSharpInstance.resize = vi.fn().mockImplementation(() => ({
+        png: vi.fn().mockReturnValue(errorInstance),
+      }));
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      const output: BuildOutput = { publicAssets: [] };
+
+      // Should throw the sharp error
+      if (buildHook) {
+        await expect(
+          buildHook(mockWxt as unknown as Wxt, output),
+        ).rejects.toThrow('Sharp processing failed');
+      }
+    });
+
+    it('should handle file system errors during directory creation', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+      };
+
+      // Make ensureDir throw an error
+      vi.mocked(fsPromises.mkdir).mockRejectedValue(
+        new Error('Directory creation failed'),
+      );
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      const output: BuildOutput = { publicAssets: [] };
+
+      // The module doesn't await ensureDir, so it won't throw
+      if (buildHook) {
+        await buildHook(mockWxt as unknown as Wxt, output);
+        // But ensureDir should have been called
+        expect(fsPromises.mkdir).toHaveBeenCalled();
+      }
+    });
+
+    it('should handle custom base icon path correctly', async () => {
+      const customPath = 'custom/icon.png';
+      const options: AutoIconsOptions = {
+        enabled: true,
+        baseIconPath: customPath,
+      };
+
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+
+      const output: BuildOutput = { publicAssets: [] };
+
+      if (buildHook) {
+        await buildHook(mockWxt as unknown as Wxt, output);
+      }
+
+      // Should resolve the path relative to srcDir
+      expect(sharp).toHaveBeenCalledWith(resolve('/mock/src', customPath));
+    });
+  });
+
+  describe('integration test', () => {
+    it('should handle full workflow correctly', async () => {
+      const options: AutoIconsOptions = {
+        enabled: true,
+        baseIconPath: 'assets/custom-icon.png',
+        sizes: [96], // Will be merged with defaults
+        grayscaleOnDevelopment: false,
+      };
+
+      const manifest: UserManifest = {};
+      const output: BuildOutput = { publicAssets: [] };
+      const paths: string[] = [];
+
+      // Setup the module
+      await autoIconsModule.setup!(mockWxt as unknown as Wxt, options);
+
+      // Execute all hooks
+      const manifestHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:manifestGenerated')?.[1];
+      const buildHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'build:done')?.[1];
+      const pathsHook = vi
+        .mocked(mockWxt.hooks.hook)
+        .mock.calls.find((call) => call[0] === 'prepare:publicPaths')?.[1];
+
+      if (manifestHook) {
+        await manifestHook(mockWxt as unknown as Wxt, manifest);
+      }
+      if (buildHook) {
+        await buildHook(mockWxt as unknown as Wxt, output);
+      }
+      if (pathsHook) {
+        pathsHook(mockWxt as unknown as Wxt, paths);
+      }
+
+      // Verify results - defu merges arrays
+      expect(manifest.icons).toEqual({
+        96: 'icons/96.png',
+        128: 'icons/128.png',
+        48: 'icons/48.png',
+        32: 'icons/32.png',
+        16: 'icons/16.png',
+      });
+
+      expect(output.publicAssets).toEqual([
+        { type: 'asset', fileName: 'icons/96.png' },
+        { type: 'asset', fileName: 'icons/128.png' },
+        { type: 'asset', fileName: 'icons/48.png' },
+        { type: 'asset', fileName: 'icons/32.png' },
+        { type: 'asset', fileName: 'icons/16.png' },
+      ]);
+
+      expect(paths).toEqual([
+        'icons/96.png',
+        'icons/128.png',
+        'icons/48.png',
+        'icons/32.png',
+        'icons/16.png',
+      ]);
+
+      expect(sharp).toHaveBeenCalledWith(
+        resolve('/mock/src', 'assets/custom-icon.png'),
+      );
+      expect(mockSharpInstance.grayscale).not.toHaveBeenCalled();
+    });
+  });
+});

packages/auto-icons/src/index.ts

@@ -3,7 +3,7 @@ import { defineWxtModule } from 'wxt/modules';
 import { resolve, relative } from 'node:path';
 import defu from 'defu';
 import sharp from 'sharp';
-import { ensureDir, exists } from 'fs-extra';
+import { access, mkdir } from 'node:fs/promises';
 
 export default defineWxtModule<AutoIconsOptions>({
   name: '@wxt-dev/auto-icons',
@@ -37,7 +37,11 @@ export default defineWxtModule<AutoIconsOptions>({
     if (!parsedOptions.enabled)
       return wxt.logger.warn(`\`[auto-icons]\` ${this.name} disabled`);
 
-    if (!(await exists(resolvedPath))) {
+    const iconExists = await access(resolvedPath).then(
+      () => true,
+      () => false,
+    );
+    if (!iconExists) {
       return wxt.logger.warn(
         `\`[auto-icons]\` Skipping icon generation, no base icon found at ${relative(process.cwd(), resolvedPath)}`,
       );
@@ -45,7 +49,7 @@ export default defineWxtModule<AutoIconsOptions>({
 
     wxt.hooks.hook('build:manifestGenerated', async (wxt, manifest) => {
       if (manifest.icons)
-        return wxt.logger.warn(
+        wxt.logger.warn(
           '`[auto-icons]` icons property found in manifest, overwriting with auto-generated icons',
         );
 
@@ -91,7 +95,7 @@ export default defineWxtModule<AutoIconsOptions>({
           }
         }
 
-        ensureDir(resolve(outputFolder, 'icons'));
+        mkdir(resolve(outputFolder, 'icons'), { recursive: true });
         await resizedImage.toFile(resolve(outputFolder, `icons/${size}.png`));
 
         output.publicAssets.push({
@@ -109,12 +113,11 @@ export default defineWxtModule<AutoIconsOptions>({
   },
 });
 
-/**
- * Options for the auto-icons module
- */
+/** Options for the auto-icons module */
 export interface AutoIconsOptions {
   /**
    * Enable auto-icons generation
+   *
    * @default true
    */
   enabled?: boolean;
@@ -122,27 +125,30 @@ export interface AutoIconsOptions {
    * Path to the image to use.
    *
    * Path is relative to the project's src directory.
-   * @default "<srcDir>/assets/icon.png"
+   *
+   * @default '<srcDir>/assets/icon.png'
    */
   baseIconPath?: string;
   /**
    * Apply a visual indicator to the icon when running in development mode.
    *
-   * "grayscale" converts the icon to grayscale.
-   * "overlay" covers the bottom half with a yellow rectangle and writes "DEV" in black text.
-   * Set to `false` to disable any indicator.
+   * "grayscale" converts the icon to grayscale. "overlay" covers the bottom
+   * half with a yellow rectangle and writes "DEV" in black text. Set to `false`
+   * to disable any indicator.
    *
-   * @default "grayscale"
+   * @default 'grayscale'
    */
   developmentIndicator?: 'grayscale' | 'overlay' | false;
   /**
    * Grayscale the image when in development mode to indicate development
-   * @default true
+   *
    * @deprecated Use `developmentIndicator` instead
+   * @default true
    */
   grayscaleOnDevelopment?: boolean;
   /**
    * Sizes to generate icons for
+   *
    * @default [128, 48, 32, 16]
    */
   sizes?: number[];

packages/auto-icons/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    mockReset: true,
+    restoreMocks: true,
+  },
+});

packages/browser/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wxt-dev/browser",
   "description": "Provides a cross-browser API for using extension APIs and types based on @types/chrome",
-  "version": "0.1.1",
+  "version": "0.1.40",
   "type": "module",
   "main": "src/index.mjs",
   "types": "src/index.d.ts",
@@ -12,7 +12,9 @@
   },
   "scripts": {
     "check": "check",
-    "gen": "tsx scripts/generate.ts"
+    "gen": "bun run scripts/generate.ts",
+    "test": "echo 'noop'",
+    "test:coverage": "echo 'noop'"
   },
   "author": {
     "name": "Aaron Klinker",
@@ -23,12 +25,11 @@
     "src"
   ],
   "devDependencies": {
-    "@types/chrome": "0.1.1",
-    "fs-extra": "^11.3.0",
-    "nano-spawn": "^0.2.0",
-    "tsx": "4.19.4",
-    "typescript": "^5.8.3",
-    "vitest": "^3.1.2"
+    "@types/chrome": "0.1.40",
+    "@types/node": "^20.0.0",
+    "nano-spawn": "^2.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "@types/filesystem": "*",

packages/browser/scripts/generate.ts

@@ -1,24 +1,24 @@
-import spawn from 'nano-spawn';
-import fs from 'fs-extra';
 import { fileURLToPath } from 'node:url';
 import { dirname, join, resolve, sep } from 'node:path';
 import { sep as posixSep } from 'node:path/posix';
+import { readdir, mkdir } from 'node:fs/promises';
+import { styleText } from 'node:util';
 
 // Fetch latest version
 
-console.log('Getting latest version of \x1b[36m@types/chrome\x1b[0m');
-await spawn('pnpm', ['i', '--ignore-scripts', '-D', '@types/chrome@latest']);
+console.log(`Getting latest version of ${styleText('cyan', '@types/chrome')}`);
+await Bun.$`bun install --ignore-scripts -D @types/chrome@latest`;
 
 // Generate new package.json
 
-console.log('Generating new \x1b[36mpackage.json\x1b[0m');
+console.log(`Generating new ${styleText('cyan', 'package.json')}`);
 
 const pkgJsonPath = fileURLToPath(
   import.meta.resolve('@types/chrome/package.json'),
 );
 const pkgDir = dirname(pkgJsonPath);
-const pkgJson = await fs.readJson(pkgJsonPath);
-const pkgJsonTemplate = await fs.readFile('templates/package.json', 'utf8');
+const pkgJson = await Bun.file(pkgJsonPath).json();
+const pkgJsonTemplate = await Bun.file('templates/package.json').text();
 const newPkgJson = JSON.parse(
   pkgJsonTemplate.replaceAll('{{chromeTypesVersion}}', pkgJson.version),
 );
@@ -27,15 +27,15 @@ newPkgJson.peerDependencies = pkgJson.peerDependencies;
 newPkgJson.peerDependenciesMeta = pkgJson.peerDependenciesMeta;
 
 const outPkgJsonPath = resolve('package.json');
-await fs.writeJson(outPkgJsonPath, newPkgJson);
-await spawn('pnpm', ['-w', 'prettier', '--write', outPkgJsonPath]);
+await Bun.write(outPkgJsonPath, JSON.stringify(newPkgJson));
+await Bun.$`bun run --cwd ../.. prettier --write "${outPkgJsonPath}"`;
 
 // Generate declaration files
 
 console.log('Generating declaration files');
 const outDir = resolve('src/gen');
 const declarationFileMapping = (
-  await fs.readdir(pkgDir, {
+  await readdir(pkgDir, {
     recursive: true,
     encoding: 'utf8',
   })
@@ -50,18 +50,18 @@ const declarationFileMapping = (
   }));
 
 for (const { file, srcPath, destPath } of declarationFileMapping) {
-  const content = await fs.readFile(srcPath, 'utf8');
+  const content = await Bun.file(srcPath).text();
   const transformedContent = transformFile(file, content);
   const destDir = dirname(destPath);
-  await fs.mkdir(destDir, { recursive: true });
-  await fs.writeFile(destPath, transformedContent);
-  console.log(`  \x1b[2m-\x1b[0m \x1b[36m${file}\x1b[0m`);
+  await mkdir(destDir, { recursive: true });
+  await Bun.write(destPath, transformedContent);
+  console.log(`  ${styleText('dim', '-')} ${styleText('cyan', file)}`);
 }
 
 // Done!
 
 console.log(
-  '\x1b[32m✔\x1b[0m Done in ' + performance.now().toFixed(0) + ' ms',
+  `${styleText('green', '✔')} Done in ${performance.now().toFixed(0)} ms`,
 );
 
 // Transformations

packages/browser/src/__tests__/index.test.ts

@@ -5,19 +5,19 @@ import { browser, type Browser } from '../index';
 describe('browser', () => {
   describe('types', () => {
     it('should provide types via the Browser import', () => {
-      expectTypeOf<Browser.runtime.MessageSender>().toMatchTypeOf<chrome.runtime.MessageSender>();
-      expectTypeOf<Browser.storage.AreaName>().toMatchTypeOf<chrome.storage.AreaName>();
-      expectTypeOf<Browser.i18n.LanguageDetectionResult>().toMatchTypeOf<chrome.i18n.LanguageDetectionResult>();
+      expectTypeOf<Browser.runtime.MessageSender>().toEqualTypeOf<chrome.runtime.MessageSender>();
+      expectTypeOf<Browser.storage.AreaName>().toEqualTypeOf<chrome.storage.AreaName>();
+      expectTypeOf<Browser.i18n.LanguageDetectionResult>().toEqualTypeOf<chrome.i18n.LanguageDetectionResult>();
     });
 
     it('should provide values via the browser import', () => {
-      expectTypeOf(browser.runtime.id).toMatchTypeOf<string>();
+      expectTypeOf(browser.runtime.id).toEqualTypeOf<string>();
       expectTypeOf(
         browser.storage.local,
-      ).toMatchTypeOf<Browser.storage.StorageArea>();
+      ).toEqualTypeOf<Browser.storage.LocalStorageArea>();
       expectTypeOf(
-        browser.i18n.detectLanguage('Hello, world!'),
-      ).resolves.toMatchTypeOf<chrome.i18n.LanguageDetectionResult>();
+        browser.i18n.detectLanguage,
+      ).returns.resolves.toEqualTypeOf<chrome.i18n.LanguageDetectionResult>();
     });
   });
 });

packages/browser/templates/package.json

@@ -12,7 +12,9 @@
   },
   "scripts": {
     "check": "check",
-    "gen": "tsx scripts/generate.ts"
+    "gen": "bun run scripts/generate.ts",
+    "test": "echo 'noop'",
+    "test:coverage": "echo 'noop'"
   },
   "author": {
     "name": "Aaron Klinker",
@@ -24,10 +26,9 @@
   ],
   "devDependencies": {
     "@types/chrome": "{{chromeTypesVersion}}",
-    "fs-extra": "^11.3.0",
-    "nano-spawn": "^0.2.0",
-    "tsx": "4.19.4",
-    "typescript": "^5.8.3",
-    "vitest": "^3.1.2"
+    "@types/node": "^20.0.0",
+    "nano-spawn": "^2.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }

packages/i18n/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## v0.2.5
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/i18n-v0.2.4...i18n-v0.2.5)
+
+### 🩹 Fixes
+
+- Add `.jsonc` support for locale files to match docs ([#2066](https://github.com/wxt-dev/wxt/pull/2066))
+
+### 🏡 Chore
+
+- Manually fix markdownlint errors ([#1711](https://github.com/wxt-dev/wxt/pull/1711))
+- **deps:** Upgrade oxlint from 0.16.8 to 1.14.0 ([a01928e0](https://github.com/wxt-dev/wxt/commit/a01928e0))
+- **deps:** Upgrade typescript from 5.8.3 to 5.9.2 ([a6eef643](https://github.com/wxt-dev/wxt/commit/a6eef643))
+- Create script for managing dependency upgrades ([#1875](https://github.com/wxt-dev/wxt/pull/1875))
+- **deps:** Upgrade all dev dependencies ([#1876](https://github.com/wxt-dev/wxt/pull/1876))
+- Upgrade dev and non-major prod dependencies ([#2000](https://github.com/wxt-dev/wxt/pull/2000))
+- Use `tsdown` to build packages ([#2006](https://github.com/wxt-dev/wxt/pull/2006))
+- Move script-only dev dependencies to top-level `package.json` ([#2007](https://github.com/wxt-dev/wxt/pull/2007))
+- Update dependencies ([#2069](https://github.com/wxt-dev/wxt/pull/2069))
+- Upgrade major deps ([#2070](https://github.com/wxt-dev/wxt/pull/2070))
+
+### ❤️ Contributors
+
+- Ilya Kubariev ([@gymnasy55](https://github.com/gymnasy55))
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+
 ## v0.2.4
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/i18n-v0.2.3...i18n-v0.2.4)

packages/i18n/README.md

@@ -161,7 +161,7 @@ hello: Hello $1!
 order: Thanks for ordering your $1
 ```
 
-#### Escapting `$`
+#### Escaping `$`
 
 To escape the dollar sign, put another `$` in front of it:
 

packages/i18n/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wxt-dev/i18n",
   "description": "Type-safe wrapper around browser.i18n.getMessage with additional features",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "type": "module",
   "repository": {
     "type": "git",
@@ -21,15 +21,17 @@
   "license": "MIT",
   "funding": "https://github.com/sponsors/wxt-dev",
   "scripts": {
-    "build": "buildc -- unbuild",
+    "build": "buildc -- tsdown",
     "check": "buildc --deps-only -- check",
-    "test": "buildc --deps-only -- vitest"
+    "test": "buildc --deps-only -- vitest",
+    "test:coverage": "bun run test run --coverage",
+    "prepack": "bun run build"
   },
   "dependencies": {
     "@wxt-dev/browser": "workspace:^",
-    "chokidar": "^4.0.3",
-    "confbox": "^0.1.8 || ^0.2.2",
-    "fast-glob": "^3.3.3"
+    "chokidar": "^5.0.0",
+    "confbox": "^0.2.4",
+    "tinyglobby": "^0.2.15"
   },
   "peerDependencies": {
     "wxt": ">=0.19.7"
@@ -40,19 +42,19 @@
     }
   },
   "devDependencies": {
-    "@aklinker1/check": "2.0.0",
+    "@aklinker1/buildc": "^1.1.7",
     "@types/node": "^20.17.6",
-    "oxlint": "^0.16.8",
-    "publint": "^0.3.12",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0",
-    "vitest": "^3.1.2",
-    "vitest-plugin-random-seed": "^1.1.1",
+    "oxlint": "^1.51.0",
+    "publint": "^0.3.18",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "vitest-plugin-random-seed": "^1.1.2",
     "wxt": "workspace:*"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "import": {

packages/i18n/src/__tests__/types.test.ts

@@ -35,14 +35,16 @@ describe('I18n Types', () => {
   });
 
   describe('With type-safety', () => {
-    const i18n = createI18n<{
+    type MyStructure = {
       simple: { plural: false; substitutions: 0 };
       simpleSub1: { plural: false; substitutions: 1 };
       simpleSub2: { plural: false; substitutions: 2 };
       plural: { plural: true; substitutions: 0 };
       pluralSub1: { plural: true; substitutions: 1 };
       pluralSub2: { plural: true; substitutions: 2 };
-    }>();
+    };
+
+    const i18n = createI18n<MyStructure>();
 
     describe('t', () => {
       it('should only allow passing valid combinations of arguments', () => {

packages/i18n/src/__tests__/utils.test.ts

@@ -43,7 +43,7 @@ describe('Utils', () => {
   });
 
   describe('getSubstitutionCount', () => {
-    it('should return the last substution present in the message', () => {
+    it('should return the last substitution present in the message', () => {
       expect(getSubstitutionCount('I like $1, but I like $2 better')).toBe(2);
     });
 

packages/i18n/src/build.ts

@@ -16,12 +16,25 @@ export { SUPPORTED_LOCALES } from './supported-locales';
 // TYPES
 //
 
+export type SimpleMessage = string;
+
+export type PluralMessage = Record<'n' | number, string>;
+
 export interface ChromeMessage {
   message: string;
   description?: string;
   placeholders?: Record<string, { content: string; example?: string }>;
 }
 
+export type Message =
+  | SimpleMessage
+  | PluralMessage
+  | ChromeMessage
+  | Message[]
+  | { [key: string]: Message };
+
+export type MessagesObject = Record<string, Message>;
+
 export interface ParsedBaseMessage {
   key: string[];
   substitutions: number;
@@ -51,13 +64,14 @@ export type MessageFormat = 'JSON5' | 'YAML' | 'TOML';
 //
 
 /**
- * See https://developer.chrome.com/docs/extensions/reference/api/i18n#overview-predefined
+ * See
+ * https://developer.chrome.com/docs/extensions/reference/api/i18n#overview-predefined
  */
 const PREDEFINED_MESSAGES: Record<string, ChromeMessage> = {
   '@@extension_id': {
     message: '<browser.runtime.id>',
     description:
-      "The extension or app ID; you might use this string to construct URLs for resources inside the extension. Even unlocalized extensions can use this message.\nNote: You can't use this message in a manifest file.",
+      "The extension or app ID; you might use this string to construct URLs for resources inside the extension. Even non-localized extensions can use this message.\nNote: You can't use this message in a manifest file.",
   },
   '@@ui_locale': {
     message: '<browser.i18n.getUiLocale()>',
@@ -94,7 +108,7 @@ const EXT_FORMATS_MAP: Record<string, MessageFormat> = {
   '.toml': 'TOML',
 };
 
-const PARSERS: Record<MessageFormat, (text: string) => any> = {
+const PARSERS: Record<MessageFormat, (text: string) => MessagesObject> = {
   YAML: parseYAML,
   JSON5: parseJSON5,
   TOML: parseTOML,
@@ -110,20 +124,17 @@ const ALLOWED_CHROME_MESSAGE_KEYS: Set<string> = new Set<keyof ChromeMessage>([
 // PARSING
 //
 
-/**
- * Parse a messages file, extract the messages. Supports JSON, JSON5, and YAML.
- */
+/** Parse a messages file, extract the messages. Supports JSON, JSON5, and YAML. */
 export async function parseMessagesFile(
   file: string,
 ): Promise<ParsedMessage[]> {
   const text = await readFile(file, 'utf8');
   const ext = extname(file).toLowerCase();
+
   return parseMessagesText(text, EXT_FORMATS_MAP[ext] ?? 'JSON5');
 }
 
-/**
- * Parse a string, extracting the messages. Supports JSON, JSON5, and YAML.
- */
+/** Parse a string, extracting the messages. Supports JSON, JSON5, and YAML. */
 export function parseMessagesText(
   text: string,
   format: 'JSON5' | 'YAML' | 'TOML',
@@ -131,10 +142,8 @@ export function parseMessagesText(
   return parseMessagesObject(PARSERS[format](text));
 }
 
-/**
- * Given the JS object form of a raw messages file, extract the messages.
- */
-export function parseMessagesObject(object: any): ParsedMessage[] {
+/** Given the JS object form of a raw messages file, extract the messages. */
+export function parseMessagesObject(object: MessagesObject): ParsedMessage[] {
   return _parseMessagesObject(
     [],
     {
@@ -147,7 +156,7 @@ export function parseMessagesObject(object: any): ParsedMessage[] {
 
 function _parseMessagesObject(
   path: string[],
-  object: any,
+  object: Message,
   depth: number,
 ): ParsedMessage[] {
   switch (typeof object) {
@@ -168,15 +177,17 @@ function _parseMessagesObject(
       ];
     }
     case 'object':
-      if ([null, undefined].includes(object)) {
+      if (object == null) {
         throw new Error(
           `Messages file should not contain \`${object}\` (found at "${path.join('.')}")`,
         );
       }
+
       if (Array.isArray(object))
         return object.flatMap((item, i) =>
           _parseMessagesObject(path.concat(String(i)), item, depth + 1),
         );
+
       if (isPluralMessage(object)) {
         const message = Object.values(object).join('|');
         const substitutions = getSubstitutionCount(message);
@@ -189,6 +200,7 @@ function _parseMessagesObject(
           },
         ];
       }
+
       if (depth === 1 && isChromeMessage(object)) {
         const message = applyChromeMessagePlaceholders(object);
         const substitutions = getSubstitutionCount(message);
@@ -201,6 +213,7 @@ function _parseMessagesObject(
           },
         ];
       }
+
       return Object.entries(object).flatMap(([key, value]) =>
         _parseMessagesObject(path.concat(key), value, depth + 1),
       );
@@ -209,13 +222,13 @@ function _parseMessagesObject(
   }
 }
 
-function isPluralMessage(object: any): object is Record<number | 'n', string> {
+function isPluralMessage(object: Message): object is PluralMessage {
   return Object.keys(object).every(
     (key) => key === 'n' || isFinite(Number(key)),
   );
 }
 
-function isChromeMessage(object: any): object is ChromeMessage {
+function isChromeMessage(object: Message): object is ChromeMessage {
   return Object.keys(object).every((key) =>
     ALLOWED_CHROME_MESSAGE_KEYS.has(key),
   );
@@ -227,7 +240,7 @@ function isChromeMessage(object: any): object is ChromeMessage {
 
 export function generateTypeText(messages: ParsedMessage[]): string {
   const renderMessageEntry = (message: ParsedMessage): string => {
-    // Use . for deep keys at runtime and types
+    // Use '.' for deep keys at runtime and types
     const key = message.key.join('.');
 
     const features = [

packages/i18n/src/index.ts

@@ -1,18 +1,11 @@
-/**
- * @module @wxt-dev/i18n
- */
-import {
-  I18nStructure,
-  DefaultI18nStructure,
-  I18n,
-  Substitution,
-} from './types';
+/** @module @wxt-dev/i18n */
+import { I18nStructure, I18n, Substitution, UntypedI18n } from './types';
 import { browser } from '@wxt-dev/browser';
 
-export function createI18n<
-  T extends I18nStructure = DefaultI18nStructure,
->(): I18n<T> {
-  const t = (key: string, ...args: any[]) => {
+export function createI18n(): UntypedI18n;
+export function createI18n<T extends I18nStructure>(): I18n<T>;
+export function createI18n(): UntypedI18n {
+  const t: UntypedI18n['t'] = (key: string, ...args: unknown[]) => {
     // Resolve args
     let sub: Substitution[] | undefined;
     let count: number | undefined;
@@ -66,5 +59,5 @@ export function createI18n<
     }
   };
 
-  return { t } as I18n<T>;
+  return { t };
 }

packages/i18n/src/module.ts

@@ -3,7 +3,7 @@
  *
  * ```ts
  * export default defineConfig({
- *   modules: ["@wxt-dev/i18n/module"],
+ *   modules: ['@wxt-dev/i18n/module'],
  * });
  * ```
  *
@@ -18,7 +18,7 @@ import {
   generateTypeText,
   SUPPORTED_LOCALES,
 } from './build';
-import glob from 'fast-glob';
+import { glob } from 'tinyglobby';
 import { basename, extname, join, resolve } from 'node:path';
 import { watch } from 'chokidar';
 import { GeneratedPublicFile, WxtDirFileEntry } from 'wxt';
@@ -44,9 +44,10 @@ export default defineWxtModule<I18nOptions>({
       options ?? {};
 
     const getLocalizationFiles = async () => {
-      const files = await glob('*.{json,json5,yml,yaml,toml}', {
+      const files = await glob('*.{json,json5,jsonc,yml,yaml,toml}', {
         cwd: localesDir,
         absolute: true,
+        expandDirectories: false,
       });
 
       const unsupportedLocales: string[] = [];
@@ -88,7 +89,7 @@ export default defineWxtModule<I18nOptions>({
       )!;
       if (defaultLocaleFile == null) {
         throw Error(
-          `\`[i18n]\` Required localization file does not exist: \`<localesDir>/${wxt.config.manifest.default_locale}.{json|json5|yml|yaml|toml}\``,
+          `\`[i18n]\` Required localization file does not exist: \`<localesDir>/${wxt.config.manifest.default_locale}.{json|json5|jsonc|yml|yaml|toml}\``,
         );
       }
 
@@ -180,13 +181,12 @@ export { type GeneratedI18nStructure }
   },
 });
 
-/**
- * Options for the i18n module
- */
+/** Options for the i18n module */
 export interface I18nOptions {
   /**
    * Directory containing files that define the translations.
-   * @default "${config.srcDir}/locales"
+   *
+   * @default '${config.srcDir}/locales'
    */
   localesDir?: string;
 }

packages/i18n/src/types.ts

@@ -3,13 +3,22 @@ export interface I18nFeatures {
   substitutions: SubstitutionCount;
 }
 
-export type I18nStructure = {
-  [K: string]: I18nFeatures;
+export interface UntypedI18n {
+  t: UntypedTFunction;
+}
+
+export type UntypedTFunction = {
+  (key: string): string;
+  (key: string, substitutions: Substitution[]): string;
+  (key: string, n: number): string;
+  (key: string, n: number, substitutions: Substitution[]): string;
 };
 
-export type DefaultI18nStructure = {
-  [K: string]: any;
-};
+export type I18nStructure = Record<string, I18nFeatures>;
+
+export interface I18n<T extends I18nStructure> {
+  t: TFunction<T>;
+}
 
 // prettier-ignore
 export type SubstitutionTuple<T extends SubstitutionCount> =
@@ -66,10 +75,6 @@ export type TFunction<T extends I18nStructure> = {
   ): string;
 };
 
-export interface I18n<T extends DefaultI18nStructure> {
-  t: TFunction<T>;
-}
-
 export type Substitution = string | number;
 
 type SubstitutionCount = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;

packages/i18n/tsdown.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'tsdown';
+
+const entry = ['src/index.ts', 'src/build.ts', 'src/module.ts'];
+
+export default defineConfig([
+  {
+    entry,
+  },
+  {
+    entry,
+    format: 'cjs',
+  },
+]);

packages/is-background/README.md

@@ -0,0 +1,17 @@
+# `@wxt-dev/is-background`
+
+Exports a getter to determine if the current JS context is the background or not.
+
+## Installation
+
+```sh
+pnpm add @wxt-dev/is-background
+```
+
+## Usage
+
+```ts
+import { isBackground } from '@wxt-dev/is-background';
+
+isBackground(); // true | false
+```

packages/is-background/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@wxt-dev/is-background",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Check if the current context is the background or not.",
+  "license": "MIT",
+  "scripts": {
+    "build": "buildc -- tsdown",
+    "check": "bun run build && check",
+    "test": "buildc --deps-only -- vitest",
+    "test:coverage": "bun run test run --coverage",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "@wxt-dev/browser": "workspace:^"
+  },
+  "devDependencies": {
+    "oxlint": "^1.51.0",
+    "publint": "^0.3.18",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wxt-dev/wxt.git",
+    "directory": "packages/is-background"
+  },
+  "keywords": [
+    "wxt",
+    "chrome",
+    "web",
+    "extension",
+    "is",
+    "background",
+    "script",
+    "page",
+    "service",
+    "worker"
+  ],
+  "author": {
+    "name": "Aaron Klinker",
+    "email": "aaronklinker1+wxt@gmail.com"
+  },
+  "funding": "https://github.com/sponsors/wxt-dev",
+  "files": [
+    "dist"
+  ],
+  "types": "./dist/index.d.mts",
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  }
+}

packages/is-background/src/__tests__/getter.test.ts

@@ -0,0 +1,145 @@
+import { describe, it, vi, expect } from 'vitest';
+import { getIsBackground } from '../getter';
+
+let mockBrowser: any;
+vi.mock('@wxt-dev/browser', () => ({
+  get browser() {
+    return mockBrowser;
+  },
+}));
+
+const backgroundWindow = Symbol('Background');
+const otherWindow = Symbol('Other');
+
+function setupEnv(options: {
+  window: symbol | undefined;
+  hasExtensionApis: boolean;
+  hasGetBackgroundPage: boolean;
+  hasServiceWorkerGlobalScope: boolean;
+}): void {
+  vi.unstubAllGlobals();
+  mockBrowser = undefined;
+
+  if (options.window) {
+    vi.stubGlobal('window', options.window);
+  }
+
+  if (options.hasExtensionApis) {
+    mockBrowser = {
+      runtime: {
+        id: 'test',
+      },
+      ...(options.hasGetBackgroundPage && {
+        extension: {
+          getBackgroundPage: () => backgroundWindow,
+        },
+      }),
+    };
+  }
+
+  if (options.hasServiceWorkerGlobalScope) {
+    class ServiceWorkerGlobalScope {}
+    vi.stubGlobal('ServiceWorkerGlobalScope', ServiceWorkerGlobalScope);
+    vi.stubGlobal('self', new ServiceWorkerGlobalScope());
+  }
+}
+
+describe('isBackground Getter', () => {
+  describe('Non-extension contexts', () => {
+    it('should return false', () => {
+      setupEnv({
+        hasServiceWorkerGlobalScope: false,
+        hasExtensionApis: false,
+        hasGetBackgroundPage: false,
+        window: otherWindow,
+      });
+
+      expect(getIsBackground()).toBe(false);
+    });
+  });
+
+  describe('Chromium & Safari', () => {
+    const hasExtensionApis = true;
+
+    describe('MV2', () => {
+      const hasServiceWorkerGlobalScope = false;
+      const hasGetBackgroundPage = true;
+
+      it('should return true inside the background page', () => {
+        setupEnv({
+          hasServiceWorkerGlobalScope,
+          hasExtensionApis,
+          hasGetBackgroundPage,
+          window: backgroundWindow,
+        });
+
+        expect(getIsBackground()).toBe(true);
+      });
+
+      it('should return false outside the background page', () => {
+        setupEnv({
+          hasServiceWorkerGlobalScope,
+          hasExtensionApis,
+          hasGetBackgroundPage,
+          window: otherWindow,
+        });
+
+        expect(getIsBackground()).toBe(false);
+      });
+    });
+
+    describe('MV3', () => {
+      const hasGetBackgroundPage = false;
+
+      it('should return true inside the service worker', () => {
+        setupEnv({
+          hasServiceWorkerGlobalScope: true,
+          hasExtensionApis,
+          hasGetBackgroundPage,
+          window: undefined,
+        });
+
+        expect(getIsBackground()).toBe(true);
+      });
+
+      it('should return false outside the service worker', () => {
+        setupEnv({
+          hasServiceWorkerGlobalScope: false,
+          hasExtensionApis,
+          hasGetBackgroundPage,
+          window: otherWindow,
+        });
+
+        expect(getIsBackground()).toBe(false);
+      });
+    });
+  });
+
+  describe('Firefox, MV2 & MV3', () => {
+    const hasServiceWorkerGlobalScope = false;
+    const hasExtensionApis = true;
+    const hasGetBackgroundPage = true;
+
+    it('should return true inside the background page', () => {
+      setupEnv({
+        hasServiceWorkerGlobalScope,
+        hasExtensionApis,
+        hasGetBackgroundPage,
+        window: backgroundWindow,
+      });
+
+      expect(getIsBackground()).toBe(true);
+    });
+
+    it('should return false outside the background page', () => {
+      setupEnv({
+        hasServiceWorkerGlobalScope,
+        hasExtensionApis,
+        hasGetBackgroundPage,
+        window: otherWindow,
+      });
+
+      expect(getIsBackground()).toBe(false);
+    });
+  });
+});

packages/is-background/src/getter.ts

@@ -0,0 +1,32 @@
+import { browser } from '@wxt-dev/browser';
+
+declare class ServiceWorkerGlobalScope {}
+
+export function getIsBackground(): boolean {
+  // Are we in an extension context?
+  if (!browser?.runtime?.id) return false;
+
+  // Is this a true MV3 service worker?
+  //
+  // - ✅ Chromium MV3
+  // - ❌ Firefox MV3 - Uses a non-persistent HTML page instead of a service worker.
+  // - ✅ Safari MV3
+  if (
+    typeof ServiceWorkerGlobalScope !== 'undefined' &&
+    self instanceof ServiceWorkerGlobalScope
+  ) {
+    return true;
+  }
+
+  // Is this the background page?
+  //
+  // - ✅ Chromium MV2
+  // - ✅ Firefox MV2
+  // - ✅ Firefox MV3 - Works with the non-persistent HTML page
+  // - ✅ Safari MV2
+  return (
+    typeof window !== 'undefined' &&
+    typeof browser.extension?.getBackgroundPage === 'function' &&
+    browser.extension.getBackgroundPage() === window
+  );
+}

packages/is-background/src/index.ts

@@ -0,0 +1,31 @@
+/**
+ * This module uses a lazy getter function so the logic isn't ran until it's
+ * needed.
+ *
+ * This has a few benefits:
+ *
+ * 1. Easier to mock in tests
+ * 2. Safe to import in NodeJS environments (but it should be safe to run just
+ *    in-case)
+ * 3. Keeps startup fast by waiting to run the slow functions (`instanceof` or
+ *    `browser.extension.getBackgroundPage`) until needed
+ *
+ * @module @wxt-dev/is-background
+ */
+import { getIsBackground } from './getter';
+
+let cached: boolean | undefined;
+
+/**
+ * Getter that returns if the current context is apart of an extension's
+ * background or not.
+ *
+ * > This function caches the result when called for the first time so it doesn't
+ * > have to recalculate.
+ *
+ * @returns True when in a background page or service worker.
+ */
+export function isBackground(): boolean {
+  if (cached == null) cached = getIsBackground();
+  return cached;
+}

packages/is-background/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "exclude": ["node_modules/**", "dist/**"]
+}

packages/module-react/CHANGELOG.md

@@ -1,5 +1,89 @@
 # Changelog
 
+## v1.2.2
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-react-v1.2.1...module-react-v1.2.2)
+
+### 🩹 Fixes
+
+- Add `@vitejs/plugin-react` v6 support ([c61fa8f8](https://github.com/wxt-dev/wxt/commit/c61fa8f8))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+
+## v1.2.1
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-react-v1.2.0...module-react-v1.2.1)
+
+### 🏡 Chore
+
+- Add prepack script to all packages ([032f7931](https://github.com/wxt-dev/wxt/commit/032f7931))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+
+## v1.2.0
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-react-v1.1.5...module-react-v1.2.0)
+
+### 🚀 Enhancements
+
+- Add `vitePluginsBefore` option ([#2170](https://github.com/wxt-dev/wxt/pull/2170))
+- Vite 8 support ([bfd4af5d](https://github.com/wxt-dev/wxt/commit/bfd4af5d))
+
+### 🏡 Chore
+
+- Upgrade dev and non-major prod dependencies ([#2000](https://github.com/wxt-dev/wxt/pull/2000))
+- Use `tsdown` to build packages ([#2006](https://github.com/wxt-dev/wxt/pull/2006))
+- Move script-only dev dependencies to top-level `package.json` ([#2007](https://github.com/wxt-dev/wxt/pull/2007))
+- Update dependencies ([#2069](https://github.com/wxt-dev/wxt/pull/2069))
+- **deps:** Upgrade deps ([#2175](https://github.com/wxt-dev/wxt/pull/2175))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Martin Broder <hello@martinbroder.com>
+
+## v1.1.5
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-react-v1.1.4...module-react-v1.1.5)
+
+### 🏡 Chore
+
+- **deps:** Support @vitejs/plugin-react@5 ([9170159b](https://github.com/wxt-dev/wxt/commit/9170159b))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+
+## v1.1.4
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-react-v1.1.3...module-react-v1.1.4)
+
+### 🩹 Fixes
+
+- Add support for WXT v0.20.0 ([c9dca022](https://github.com/wxt-dev/wxt/commit/c9dca022))
+
+### 🏡 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))
+- Stop using PNPM catalog ([#1644](https://github.com/wxt-dev/wxt/pull/1644))
+- Upgrade `@aklinker1/check` to v2 ([#1647](https://github.com/wxt-dev/wxt/pull/1647))
+- **deps:** Update all dependencies ([#1648](https://github.com/wxt-dev/wxt/pull/1648))
+- **deps:** Upgrade typescript from 5.8.3 to 5.9.2 ([a6eef643](https://github.com/wxt-dev/wxt/commit/a6eef643))
+- Create script for managing dependency upgrades ([#1875](https://github.com/wxt-dev/wxt/pull/1875))
+- **deps:** Upgrade all dev dependencies ([#1876](https://github.com/wxt-dev/wxt/pull/1876))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Okinea Dev <hi@okinea.dev>
+
 ## v1.1.3
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/module-react-v1.1.2...module-react-v1.1.3)

packages/module-react/build.config.ts

@@ -1,12 +0,0 @@
-import { defineBuildConfig } from 'unbuild';
-import { resolve } from 'node:path';
-
-export default defineBuildConfig({
-  rootDir: resolve(__dirname, 'modules'),
-  outDir: resolve(__dirname, 'dist'),
-  entries: [{ input: 'react.ts', name: 'index' }],
-  rollup: {
-    emitCJS: true,
-  },
-  declaration: true,
-});

packages/module-react/modules/react.ts

@@ -1,15 +1,16 @@
 import 'wxt';
 import { addImportPreset, addViteConfig, defineWxtModule } from 'wxt/modules';
 import react, { Options as PluginOptions } from '@vitejs/plugin-react';
+import type { PluginOption } from 'vite';
 
 export default defineWxtModule<ReactModuleOptions>({
   name: '@wxt-dev/module-react',
   configKey: 'react',
   setup(wxt, options) {
-    const { vite } = options ?? {};
+    const { vite, vitePluginsBefore } = options ?? {};
 
     addViteConfig(wxt, () => ({
-      plugins: [react(vite)],
+      plugins: [...(vitePluginsBefore ?? []), react(vite)],
     }));
 
     addImportPreset(wxt, 'react');
@@ -30,6 +31,12 @@ export default defineWxtModule<ReactModuleOptions>({
 
 export interface ReactModuleOptions {
   vite?: PluginOptions;
+  /**
+   * Vite plugins to add before the `react()` plugin. Some plugins like the
+   * `@tanstack/router-plugin` need to be added before `react()` to work
+   * correctly.
+   */
+  vitePluginsBefore?: PluginOption[];
 }
 
 declare module 'wxt' {

packages/module-react/package.json

@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "funding": "https://github.com/sponsors/wxt-dev",
-  "version": "1.1.3",
+  "version": "1.2.2",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "import": {
@@ -40,25 +40,29 @@
   ],
   "scripts": {
     "dev": "wxt",
-    "check": "pnpm build && check",
-    "build": "buildc -- unbuild",
-    "prepare": "buildc --deps-only -- wxt prepare"
+    "check": "bun run build && check",
+    "build": "buildc -- tsdown",
+    "postinstall": "buildc --deps-only -- wxt prepare",
+    "test": "echo 'noop'",
+    "test:coverage": "echo 'noop'",
+    "prepack": "bun run build"
   },
   "peerDependencies": {
+    "vite": "^5.4.19 || ^6.3.4 || ^7.0.0 || ^8.0.0-0",
     "wxt": ">=0.19.16"
   },
   "dependencies": {
-    "@vitejs/plugin-react": "^4.4.1"
+    "@vitejs/plugin-react": "^4.4.1 || ^5.0.0 || ^6.0.0"
   },
   "devDependencies": {
-    "@aklinker1/check": "2.0.0",
-    "@types/react": "^19.1.2",
-    "@types/react-dom": "^19.1.3",
-    "publint": "^0.3.12",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0",
+    "@aklinker1/buildc": "^1.1.7",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "publint": "^0.3.18",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^5.9.3",
+    "vite": "^7.0.0",
     "wxt": "workspace:*"
   }
 }

packages/module-react/tsdown.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'tsdown';
+
+const entry = {
+  index: './modules/react.ts',
+};
+
+export default defineConfig([
+  {
+    entry,
+  },
+  {
+    entry,
+    format: 'cjs',
+  },
+]);

packages/module-solid/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## v1.1.4
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-solid-v1.1.3...module-solid-v1.1.4)
+
+### 🩹 Fixes
+
+- Add support for WXT v0.20.0 ([c9dca022](https://github.com/wxt-dev/wxt/commit/c9dca022))
+
+### 🏡 Chore
+
+- **deps-dev:** Bump solid-js from 1.9.3 to 1.9.4 ([#1391](https://github.com/wxt-dev/wxt/pull/1391))
+- Add funding links to `package.json` files ([#1446](https://github.com/wxt-dev/wxt/pull/1446))
+- **deps:** Bump vite-plugin-solid from 2.10.2 to 2.11.6 ([#1491](https://github.com/wxt-dev/wxt/pull/1491))
+- 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))
+- Stop using PNPM catalog ([#1644](https://github.com/wxt-dev/wxt/pull/1644))
+- Upgrade `@aklinker1/check` to v2 ([#1647](https://github.com/wxt-dev/wxt/pull/1647))
+- **deps:** Update all dependencies ([#1648](https://github.com/wxt-dev/wxt/pull/1648))
+- **deps:** Upgrade typescript from 5.8.3 to 5.9.2 ([a6eef643](https://github.com/wxt-dev/wxt/commit/a6eef643))
+- Create script for managing dependency upgrades ([#1875](https://github.com/wxt-dev/wxt/pull/1875))
+- **deps:** Upgrade all dev dependencies ([#1876](https://github.com/wxt-dev/wxt/pull/1876))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Okinea Dev <hi@okinea.dev>
+
 ## v1.1.3
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/module-solid-v1.1.2...module-solid-v1.1.3)

packages/module-solid/build.config.ts

@@ -1,12 +0,0 @@
-import { defineBuildConfig } from 'unbuild';
-import { resolve } from 'node:path';
-
-export default defineBuildConfig({
-  rootDir: resolve(__dirname, 'modules'),
-  outDir: resolve(__dirname, 'dist'),
-  entries: [{ input: 'solid.ts', name: 'index' }],
-  rollup: {
-    emitCJS: true,
-  },
-  declaration: true,
-});

packages/module-solid/package.json

@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "funding": "https://github.com/sponsors/wxt-dev",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "import": {
@@ -40,22 +40,25 @@
   ],
   "scripts": {
     "dev": "wxt",
-    "check": "pnpm build && check",
-    "build": "buildc -- unbuild",
-    "prepare": "buildc --deps-only -- wxt prepare"
+    "check": "bun run build && check",
+    "build": "buildc -- tsdown",
+    "postinstall": "buildc --deps-only -- wxt prepare",
+    "test": "echo 'noop'",
+    "test:coverage": "echo 'noop'",
+    "prepack": "bun run build"
   },
   "peerDependencies": {
     "wxt": ">=0.19.16"
   },
   "dependencies": {
-    "vite-plugin-solid": "^2.11.6"
+    "vite-plugin-solid": "^2.11.10"
   },
   "devDependencies": {
-    "@aklinker1/check": "2.0.0",
-    "publint": "^0.3.12",
-    "solid-js": "^1.9.6",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0",
+    "@aklinker1/buildc": "^1.1.7",
+    "publint": "^0.3.18",
+    "solid-js": "^1.9.11",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3",
     "wxt": "workspace:*"
   }
 }

packages/module-solid/tsdown.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'tsdown';
+
+const entry = {
+  index: './modules/solid.ts',
+};
+
+export default defineConfig([
+  {
+    entry,
+  },
+  {
+    entry,
+    format: 'cjs',
+  },
+]);

packages/module-svelte/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## v2.0.5
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-svelte-v2.0.4...module-svelte-v2.0.5)
+
+### 🩹 Fixes
+
+- Update `@sveltejs/vite-plugin-svelte` version range to support Vite 8 ([48571f50](https://github.com/wxt-dev/wxt/commit/48571f50))
+
+### 🏡 Chore
+
+- Upgrade dev and non-major prod dependencies ([#2000](https://github.com/wxt-dev/wxt/pull/2000))
+- Use `tsdown` to build packages ([#2006](https://github.com/wxt-dev/wxt/pull/2006))
+- Move script-only dev dependencies to top-level `package.json` ([#2007](https://github.com/wxt-dev/wxt/pull/2007))
+- Update dependencies ([#2069](https://github.com/wxt-dev/wxt/pull/2069))
+- **deps:** Upgrade deps ([#2175](https://github.com/wxt-dev/wxt/pull/2175))
+- Add prepack script to all packages ([032f7931](https://github.com/wxt-dev/wxt/commit/032f7931))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+
+## v2.0.4
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/module-svelte-v2.0.3...module-svelte-v2.0.4)
+
+### 🩹 Fixes
+
+- Add support for @sveltejs/vite-plugin-svelte@6 ([459f73fd](https://github.com/wxt-dev/wxt/commit/459f73fd))
+
+### 🏡 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))
+- Stop using PNPM catalog ([#1644](https://github.com/wxt-dev/wxt/pull/1644))
+- Upgrade `@aklinker1/check` to v2 ([#1647](https://github.com/wxt-dev/wxt/pull/1647))
+- **deps:** Upgrade typescript from 5.8.3 to 5.9.2 ([a6eef643](https://github.com/wxt-dev/wxt/commit/a6eef643))
+- Create script for managing dependency upgrades ([#1875](https://github.com/wxt-dev/wxt/pull/1875))
+- **deps:** Upgrade all dev dependencies ([#1876](https://github.com/wxt-dev/wxt/pull/1876))
+
+### ❤️ Contributors
+
+- Aaron ([@aklinker1](https://github.com/aklinker1))
+- Okinea Dev <hi@okinea.dev>
+
 ## v2.0.3
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/module-svelte-v2.0.2...module-svelte-v2.0.3)

packages/module-svelte/package.json

@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "funding": "https://github.com/sponsors/wxt-dev",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "import": {
@@ -39,21 +39,24 @@
     "dist"
   ],
   "scripts": {
-    "build": "buildc -- unbuild",
-    "check": "pnpm build && check"
+    "build": "buildc -- tsdown",
+    "check": "bun run build && check",
+    "test": "echo 'noop'",
+    "test:coverage": "echo 'noop'",
+    "prepack": "bun run build"
   },
   "peerDependencies": {
     "wxt": ">=0.18.6",
     "svelte": ">=5"
   },
   "dependencies": {
-    "@sveltejs/vite-plugin-svelte": "^4.0.0 || ^5.0.0"
+    "@sveltejs/vite-plugin-svelte": ">=4"
   },
   "devDependencies": {
-    "@aklinker1/check": "2.0.0",
-    "publint": "^0.3.12",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0",
+    "@aklinker1/buildc": "^1.1.7",
+    "publint": "^0.3.18",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3",
     "wxt": "workspace:*"
   }
 }