docs: Fix broken links

Co-authored-by: Aaron <aaronklinker1@gmail.com>

.github/CODEOWNERS

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

.github/actions/setup/action.yml

@@ -4,10 +4,12 @@ description: Install PNPM, Node, and dependencies
 inputs:
   install:
     default: 'true'
+    type: boolean
     description: Whether or not to run 'pnpm install'
 
   installArgs:
     default: ''
+    type: string
     description: Additional args to append to "pnpm install"
 
 runs:
@@ -15,12 +17,12 @@ runs:
 
   steps:
     - name: 🛠️ Setup PNPM
-      uses: pnpm/action-setup@f2b2b233b538f500472c7274c7012f57857d8ce0 # v4.1.0
+      uses: pnpm/action-setup@v4
 
     - name: 🛠️ Setup NodeJS
-      uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
+      uses: actions/setup-node@v4
       with:
-        node-version: 20
+        node-version: 18
         cache: pnpm
 
     - name: 📦 Install Dependencies

.github/workflows/auto-label.yml

@@ -1,111 +0,0 @@
-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

@@ -1,36 +0,0 @@
-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,7 +17,7 @@ jobs:
     if: ${{ github.repository == 'wxt-dev/wxt' }}
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup

.github/workflows/pr-closed.yml

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Post Thank You Comment
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
         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@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.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@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Login to Docker Registry
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        uses: docker/login-action@v3
         with:
           registry: https://${{ secrets.DOCKER_REGISTRY_HOSTNAME }}
           username: ${{ secrets.DOCKER_REGISTRY_USERNAME }}

.github/workflows/release.yml

@@ -10,12 +10,10 @@ on:
           - analytics
           - auto-icons
           - i18n
-          - is-background
           - module-react
           - module-solid
           - module-svelte
           - module-vue
-          - runner
           - storage
           - unocss
           - webextension-polyfill
@@ -32,18 +30,16 @@ jobs:
 
   publish:
     name: Publish
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-22.04
     permissions:
-      contents: write # Push version changes
-      id-token: write # OIDC for NPM publishing
+      contents: write
     needs:
       - validate
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          ssh-key: ${{ secrets.DEPLOY_KEY }} # https://github.com/sbellone/release-workflow-example
 
       - name: Setup
         uses: ./.github/actions/setup
@@ -63,9 +59,9 @@ jobs:
       - name: Publish to NPM
         working-directory: packages/${{ inputs.package }}
         run: |
-          pnpm pack
-          sudo npm i -g npm@latest
-          /usr/local/bin/npm publish *.tgz
+          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_AUTH_TOKEN }}" > ~/.npmrc
+          pnpm build
+          pnpm publish
 
       - name: Create GitHub release
         run: pnpm tsx scripts/create-github-release.ts ${{ inputs.package }}

.github/workflows/sync-releases.yml

@@ -10,12 +10,10 @@ on:
           - analytics
           - auto-icons
           - i18n
-          - is-background
           - module-react
           - module-solid
           - module-svelte
           - module-vue
-          - runner
           - storage
           - webextension-polyfill
           - wxt
@@ -31,7 +29,7 @@ jobs:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup

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

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

.github/workflows/validate.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup
@@ -28,7 +28,7 @@ jobs:
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup
@@ -41,7 +41,7 @@ jobs:
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup
@@ -55,41 +55,39 @@ jobs:
         working-directory: packages/wxt-demo
 
   tests:
-    name: Tests (${{ matrix.title }})
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        include:
-          - title: 'Linux'
-            os: ubuntu-22.04
-            coverage: true
-          - title: 'Windows'
-            os: windows-latest
-            coverage: false
+    name: Tests
+    runs-on: ubuntu-22.04
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup
 
       - name: Setup Bun
-        uses: oven-sh/setup-bun@3d267786b128fe76c2f16a390aa2448b815359f3 # v2.1.2
+        uses: oven-sh/setup-bun@v2
 
       - name: Run Tests
-        if: ${{ ! matrix.coverage }}
-        run: pnpm test
-
-      - name: Run Tests (Coverage)
-        if: matrix.coverage
-        run: pnpm test:coverage --reporter=default --reporter=hanging-process
+        run: pnpm test:coverage -- --reporter=default --reporter=hanging-process
 
       - name: Upload Coverage
-        if: matrix.coverage
-        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5.5.2
+        uses: codecov/codecov-action@v5
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
+  windows-tests:
+    name: Windows Tests
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
+      - name: Run Tests
+        run: pnpm test
+
   template:
     name: Template
     runs-on: ubuntu-22.04
@@ -104,7 +102,7 @@ jobs:
           - vue
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup

.github/workflows/vhs.yml

@@ -11,26 +11,19 @@ permissions:
 jobs:
   vhs:
     name: Create VHS
-    runs-on: macos-latest
+    runs-on: ubuntu-22.04
     if: ${{ github.repository == 'wxt-dev/wxt' }}
     permissions:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          ref: ${{ github.ref }}
+        uses: actions/checkout@v4
 
       - name: Setup
         uses: ./.github/actions/setup
         with:
           install: false
 
-      - name: Setup Go
-        uses: actions/setup-go@44694675825211faa026b3c33043df3e48a5fa00
-        with:
-          go-version: '1.25.1'
-
       # This prevents pnpm dlx from downloading WXT in the video
       - name: Pre-install WXT
         run: |
@@ -38,19 +31,15 @@ jobs:
           pnpm dlx wxt@latest --version
 
       - name: Record VHS
-        run: |
-          brew install ttyd ffmpeg
-          go install github.com/charmbracelet/vhs@517bcda0faf416728bcf6b7fe489eb0e2469d9b5 # v0.10.0
-          vhs docs/tapes/init-demo.tape
+        uses: charmbracelet/vhs-action@v2.1.0
+        with:
+          path: 'docs/tapes/init-demo.tape'
 
       - name: Save recorded GIF
-        uses: stefanzweifel/git-auto-commit-action@04702edda442b2e678b25b537cec683a1493fcb9 # v7.1.0
+        uses: stefanzweifel/git-auto-commit-action@v5
         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

@@ -5,10 +5,8 @@
 .output
 .webextrc
 .wxt
-.wxt-runner
 *.log
 /docs/.vitepress/cache
-docs/.vitepress/.temp
 coverage
 dist
 node_modules

.markdownlint.json

@@ -1,6 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint/refs/heads/main/schema/markdownlint-config-schema.json",
-  "line-length": false,
-  "no-inline-html": false,
-  "first-line-heading": false
-}

.markdownlintignore

@@ -1,9 +0,0 @@
-node_modules
-.git
-.output
-dist
-
-# Generated files
-packages/wxt/README.md
-packages/*/CHANGELOG.md
-docs/api

.prettierrc.yml

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

.vscode/settings.json

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

CODE_OF_CONDUCT.md

@@ -60,7 +60,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-<aaronklinker1@gmail.com>.
+aaronklinker1@gmail.com.
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the
@@ -116,7 +116,7 @@ the community.
 
 This Code of Conduct is adapted from the [Contributor Covenant][homepage],
 version 2.0, available at
-<https://www.contributor-covenant.org/version/2/0/code_of_conduct.html>.
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
 
 Community Impact Guidelines were inspired by [Mozilla's code of conduct
 enforcement ladder](https://github.com/mozilla/diversity).
@@ -124,5 +124,5 @@ enforcement ladder](https://github.com/mozilla/diversity).
 [homepage]: https://www.contributor-covenant.org
 
 For answers to common questions about this code of conduct, see the FAQ at
-<https://www.contributor-covenant.org/faq>. Translations are available at
-<https://www.contributor-covenant.org/translations>.
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

CONTRIBUTING.md

@@ -6,19 +6,6 @@ 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 availalbe, 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
@@ -33,19 +20,6 @@ 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.
@@ -163,23 +137,26 @@ cp -r templates/vanilla templates/<new-template-name>
 
 That's it. Once your template is merged, it will be available inside `wxt init` immediately. You don't need to release a new version of WXT to release a new template.
 
+## Releasing 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.
+
 ## Upgrading Dependencies
 
-WXT has custom rules around what dependencies can be upgraded. Use the `scripts/upgrade-deps.ts` script to upgrade dependencies and follow these rules.
+Use [`taze`](https://www.npmjs.com/package/taze) to upgrade dependencies throughout the entire monorepo.
 
 ```sh
-pnpm tsx scripts/upgrade-deps.ts
+pnpm dlx taze -r
 ```
 
-To see all the options, run:
-
-```sh
-pnpm tsx scripts/upgrade-deps.ts --help
-```
+Configuration is in [`taze.config.ts`](./taze.config.ts).
 
 ## Install Unreleased Versions
 
-This repo uses <https://pkg.pr.new> to publish versions of all it's packages for almost every commit. You can install them via:
+This repo uses https://pkg.pr.new to publish versions of all it's packages for almost every commit. You can install them via:
 
 ```sh
 npm i https://pkg.pr.new/[package-name]@[ref]
@@ -200,16 +177,10 @@ npm i https://pkg.pr.new/@wxt-dev/module-react@426f907
 
 ## Blog Posts
 
-Anyone is welcome to submit a blog post on <https://wxt.dev/blog>!
+Anyone is welcome to submit a blog post on https://wxt.dev/blog!
 
 > [!NOTE]
 > Before starting on a blog post, please message Aaron on Discord or start a discussion on GitHub to get permission to write about a topic, but most topics are welcome: Major version updates, tutorials, etc.
 
-- **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 😓
+- **English only**: Blog posts should be written in English. Unfortunately, our maintainers doesn'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 questsions, review PRs, organize and prioritize work - there's lots of ways for you to help out.

MAINTAINERS.md

@@ -1,90 +0,0 @@
-# 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>
-   pnpm 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.

README.md

@@ -1,32 +1,50 @@
-<div align="center">
+<h1 align="center">
+  <img align="top" width="44" src="https://raw.githubusercontent.com/wxt-dev/wxt/HEAD/docs/public/hero-logo.svg" alt="WXT Logo">
+  <span>WXT</span>
+</h1>
 
-# <img align="top" width="44" src="https://raw.githubusercontent.com/wxt-dev/wxt/HEAD/docs/public/hero-logo.svg" alt="WXT Logo"> WXT
+<p align="center">
+  <a href="https://www.npmjs.com/package/wxt" target="_blank"><img alt="npm version" src="https://img.shields.io/npm/v/wxt?labelColor=black&color=%234fa048"></a>
+  <span> </span>
+  <a href="https://www.npmjs.com/package/wxt" target="_blank"><img alt="downloads" src="https://img.shields.io/npm/dm/wxt?labelColor=black&color=%234fa048"></a>
+  <span> </span>
+  <a href="https://github.com/wxt-dev/wxt/blob/main/LICENSE" target="_blank"><img alt="license | MIT" src="https://img.shields.io/npm/l/wxt?labelColor=black&color=%234fa048"></a>
+  <span> </span>
+  <a href="https://codecov.io/github/wxt-dev/wxt" target="_blank"><img alt="coverage" src="https://img.shields.io/codecov/c/github/wxt-dev/wxt?labelColor=black&color=%234fa048"></a>
+</p>
 
-[![npm version](https://img.shields.io/npm/v/wxt?labelColor=black&color=%234fa048)](https://www.npmjs.com/package/wxt)
-[![downloads](https://img.shields.io/npm/dm/wxt?labelColor=black&color=%234fa048)](https://www.npmjs.com/package/wxt)
-[![license | MIT](https://img.shields.io/npm/l/wxt?labelColor=black&color=%234fa048)](https://github.com/wxt-dev/wxt/blob/main/LICENSE)
-[![coverage](https://img.shields.io/codecov/c/github/wxt-dev/wxt?labelColor=black&color=%234fa048)](https://codecov.io/github/wxt-dev/wxt)
+<p align="center">
+  <span>Next-gen framework for developing web extensions.</span>
+  <br/>
+  <span>⚡</span>
+  <br/>
+  <q><i>It's like Nuxt, but for Web Extensions</i></q>
+</p>
 
-Next-gen framework for developing web extensions.<br/>⚡<br/><q><i>It's like Nuxt, but for Web Extensions</i></q>
-
-[Get Started](https://wxt.dev/guide/installation.html) •
-[Configuration](https://wxt.dev/api/config.html) •
-[Examples](https://wxt.dev/examples.html) •
-[Changelog](https://github.com/wxt-dev/wxt/blob/main/packages/wxt/CHANGELOG.md) •
-[Discord](https://discord.gg/ZFsZqGery9)
-
-</div>
+<p align="center">
+  <a href="https://wxt.dev/guide/installation.html" target="_blank">Get Started</a>
+  &bull;
+  <a href="https://wxt.dev/api/config.html" target="_blank">Configuration</a>
+  &bull;
+  <a href="https://wxt.dev/examples.html" target="_blank">Examples</a>
+  &bull;
+  <a href="https://github.com/wxt-dev/wxt/blob/main/packages/wxt/CHANGELOG.md" target="_blank">Changelog</a>
+  &bull;
+  <a href="https://discord.gg/ZFsZqGery9" target="_blank">Discord</a>
+</p>
 
 ![Example CLI Output](https://raw.githubusercontent.com/wxt-dev/wxt/HEAD/docs/assets/cli-output.png)
 
 ## Demo
 
-<https://github.com/wxt-dev/wxt/assets/10101283/4d678939-1bdb-495c-9c36-3aa281d84c94>
+https://github.com/wxt-dev/wxt/assets/10101283/4d678939-1bdb-495c-9c36-3aa281d84c94
 
 ## Quick Start
 
 Bootstrap a new project:
 
+<!-- automd:pm-x version="latest" name="wxt" args="init" -->
+
 ```sh
 # npm
 npx wxt@latest init
@@ -38,6 +56,8 @@ pnpm dlx wxt@latest init
 bunx wxt@latest init
 ```
 
+<!-- /automd -->
+
 Or see the [installation guide](https://wxt.dev/guide/installation.html) to get started with WXT.
 
 ## Features
@@ -59,11 +79,17 @@ Or see the [installation guide](https://wxt.dev/guide/installation.html) to get
 
 WXT is a [MIT-licensed](https://github.com/wxt-dev/wxt/blob/main/LICENSE) open source project with its ongoing development made possible entirely by the support of these awesome backers. If you'd like to join them, please consider [sponsoring WXT's development](https://github.com/sponsors/wxt-dev).
 
-[![WXT Sponsors](https://raw.githubusercontent.com/wxt-dev/static/refs/heads/main/sponsorkit/sponsors.svg)](https://github.com/sponsors/wxt-dev)
+<a href="https://github.com/sponsors/wxt-dev"><img alt="WXT Sponsors" src="https://raw.githubusercontent.com/wxt-dev/static/refs/heads/main/sponsorkit/sponsors.svg"></a>
 
 ## Contributors
 
+<!-- automd:contributors author="aklinker1" license="MIT" github="wxt-dev/wxt" -->
+
 Published under the [MIT](https://github.com/wxt-dev/wxt/blob/main/LICENSE) license.
 Made by [@aklinker1](https://github.com/aklinker1) and [community](https://github.com/wxt-dev/wxt/graphs/contributors) 💛
+<br><br>
+<a href="https://github.com/wxt-dev/wxt/graphs/contributors">
+<img src="https://contrib.rocks/image?repo=wxt-dev/wxt" />
+</a>
 
-[![WXT contributors](https://contrib.rocks/image?repo=wxt-dev/wxt)](https://github.com/wxt-dev/wxt/graphs/contributors)
+<!-- /automd -->

SECURITY.md

@@ -4,8 +4,12 @@ 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
 
-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.
+Use this section to tell people how to report a vulnerability.
 
-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.
+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.
+-->

docs/.vitepress/components/UsingWxtSection.vue

@@ -4,7 +4,7 @@ import useListExtensionDetails, {
   ChromeExtension,
 } from '../composables/useListExtensionDetails';
 
-// Add extension IDs to end of the list. On the website, extensions will be sorted by a combination of weekly active users and rating.
+// Add extension IDs here. Order doesn't matter, 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
@@ -70,57 +70,6 @@ const chromeExtensionIds = [
   '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
-  'hgppdobcpkfkmiegekaglonjajeojmdd', // Browsely - AI-powered browser extension
-  'ehmoihnjgkdimihkhokkmfjdgomohjgm', // Filmbudd Pro - Simple, private – and synced ratings and watch notes across all your devices
-  'alglchohmdikgdjhafiicilegegieafa', // MultiField CopyCat - Copy, Paste & Autofill Web Forms Instantly
-  'aamihahiiogceidpbnfgehacgiecephe', // ChatSight - Add Table of Contents to ChatGPT
-  'cndibmoanboadcifjkjbdpjgfedanolh', // BetterCampus (prev. BetterCanvas)
-  'hinfimgacobnellbncbcpdlpaapcofaa', // Leetcode Fonts - Change fonts in leetcode effortlessly
-  'kbkbfefhhabpkibojinapkkgciiacggg', // TranslateManga - Manga Translator & Manga Tracker
-  'emeakbgdecgmdjgegnejpppcnkcnoaen', // SiteData - Free Website Traffic Checker & Reverse AdSense Tool
-  'gpnckbhgpnjciklpoehkmligeaebigaa', // Livestream Chat Reader - Text-to-Speech for YouTube/Twitch chat
-  'fjlalaedpfcojcfpkgkglbjjbbkofgnl', // ChatGPT Token Counter - Count tokens in real time on chatgpt conversation
-  'fbgblmjbeebanackldpbmpacppflgmlj', // LinuxDo Scripts - 为 linux.do 用户提供了一些增强功能
-  'dfacnjidgbagicaekenjgclfnhdnjjdi', // Zen Virtual Piano - https://zen-piano.web.app/
-  'naeibcegmgpofimedkmfgjgphfhfhlab', // Crypto Pulse price tracker - https://get-crypto-pulse.web.app/
-  'ffglckbhfbfmdkefdmjbhpnffkcmlhdh', // Redirect Web - Automatically redirect pages or open them in another app
-  'eglpfhbhmelampoihamjomgkeobgdofl', // Capture It - Capture & Edit Screenshots
-  'jmghclbfbbapimhbgnpffbimphlpolnm', // Teams Chat Exporter
-  'jdcppdokgfbnhiacbeplahgnciahnhck', // Lofi BGM Player - Free lofi focus music for work & study
-  'cgpmbiiagnehkikhcbnhiagfomajncpa', // Margin - Annotate and highlight any webpage, with your notes saved to the decentralized AT Protocol.
-  'mfjdonmgmgcijagclnkfhmjiblbfjaid', // KeyFloat - Floating multilingual keyboard with native key mappings, drag, dark mode, sounds, and dynamic layouts for macOS & Windows
-  'dhiekgdaipindoapjmcnpompdknjeijf', // Glossy New Tab - Say Goodbye to Boring Tabs with live wallpapers
-  'lapnciffpekdengooeolaienkeoilfeo', // All API Hub – AI Relay & New API Manager - https://github.com/qixing-jk/all-api-hub
-  'bhgobenflkkhfcgkikejaaejenoddcmo', // Scrape Similar - Extract data from websites into spreadsheets - https://github.com/zizzfizzix/scrape-similar
-  'kinlknncggaihnhdcalijdmpbhbflalm', // isTrust - https://github.com/Internet-Society-Belgium/isTrust/
 ];
 
 const { data, err, isLoading } = useListExtensionDetails(chromeExtensionIds);

docs/.vitepress/composables/useListExtensionDetails.ts

@@ -35,9 +35,6 @@ export default function (ids: string[]) {
       query,
       variables: { ids },
     }),
-    headers: {
-      'Content-Type': 'application/json',
-    },
   })
     .then(async (res) => {
       isLoading.value = false;

docs/.vitepress/config.ts

@@ -1,4 +1,4 @@
-import { DefaultTheme, defineConfig } from 'vitepress';
+import { defineConfig } from 'vitepress';
 import typedocSidebar from '../api/reference/typedoc-sidebar.json';
 import {
   menuGroup,
@@ -15,9 +15,7 @@ import { version as autoIconsVersion } from '../../packages/auto-icons/package.j
 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 { version as isBackgroundVersion } from '../../packages/is-background/package.json';
-import addKnowledge from 'vitepress-knowledge';
+import knowledge from 'vitepress-knowledge';
 import {
   groupIconMdPlugin,
   groupIconVitePlugin,
@@ -26,7 +24,6 @@ import {
 import { Feed } from 'feed';
 import { writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import llmstxt from 'vitepress-plugin-llms';
 
 const origin = 'https://wxt.dev';
 
@@ -44,29 +41,20 @@ const otherPackages = {
   i18n: i18nVersion,
   storage: storageVersion,
   unocss: unocssVersion,
-  runner: runnerVersion,
-  'is-background': isBackgroundVersion,
 };
 
-const knowledge = addKnowledge<DefaultTheme.Config>({
-  serverUrl: 'https://knowledge.wxt.dev',
-  paths: {
-    '/': 'docs',
-    '/api/': 'api-reference',
-    '/blog/': 'blog',
-  },
-  layoutSelectors: {
-    blog: '.container-content',
-  },
-  pageSelectors: {
-    'examples.md': '#VPContent > .VPPage',
-    'blog.md': '#VPContent > .VPPage',
-  },
-});
-
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
-  extends: knowledge,
+  extends: knowledge({
+    serverUrl: 'https://knowledge.wxt.dev',
+    paths: {
+      '/': 'docs',
+      '/api/': 'api-reference',
+    },
+    pageSelectors: {
+      'examples.md': '#VPContent > .VPPage',
+    },
+  }),
 
   titleTemplate: `:title${titleSuffix}`,
   title: 'WXT',
@@ -74,7 +62,6 @@ export default defineConfig({
   vite: {
     clearScreen: false,
     plugins: [
-      llmstxt(),
       groupIconVitePlugin({
         customIcon: {
           'wxt.config.ts': localIconLoader(
@@ -91,9 +78,6 @@ export default defineConfig({
   },
 
   async buildEnd(site) {
-    // @ts-expect-error: knowledge.buildEnd is not typed, but it exists.
-    await knowledge.buildEnd(site);
-
     // Only construct the RSS document for production builds
     const { default: blogDataLoader } = await import('./loaders/blog.data');
     const posts = await blogDataLoader.load();
@@ -111,8 +95,8 @@ export default defineConfig({
         description: post.frontmatter.description,
       });
     });
-    // console.log('rss.xml:');
-    // console.log(feed.rss2());
+    console.log('rss.xml:');
+    console.log(feed.rss2());
     await writeFile(join(site.outDir, 'rss.xml'), feed.rss2(), 'utf8');
   },
 
@@ -134,9 +118,6 @@ export default defineConfig({
       md.use(footnote);
       md.use(groupIconMdPlugin);
     },
-    languageAlias: {
-      mjs: 'js',
-    },
   },
 
   themeConfig: {

docs/.vitepress/utils/menus.ts

@@ -77,7 +77,9 @@ 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/blog/2024-12-06-using-imports-module.md

@@ -70,7 +70,3 @@ You don't have to use `#imports` if you don't like - you can continue importing
 Happy Coding 😄
 
 > P.S. Yes, this is exactly how [Nuxt's `#imports`](https://nuxt.com/docs/guide/concepts/auto-imports#explicit-imports) works! We use the exact same library, [`unimport`](https://github.com/unjs/unimport).
-
----
-
-[Discuss this blog post on Github](https://github.com/wxt-dev/wxt/discussions/1543).

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

@@ -14,7 +14,7 @@ You can configure browser startup in 3 places:
 
 1. `<rootDir>/web-ext.config.ts`: Ignored from version control, this file lets you configure your own options for a specific project without affecting other developers
 
-   ```ts [web-ext.config.ts]
+   ```ts
    import { defineWebExtConfig } from 'wxt';
 
    export default defineWebExtConfig({
@@ -22,7 +22,7 @@ You can configure browser startup in 3 places:
    });
    ```
 
-2. `<rootDir>/wxt.config.ts`: Via the [`webExt` config](/api/reference/wxt/interfaces/InlineConfig#webext), included in version control
+2. `<rootDir>/wxt.config.ts`: Via the [`runner` config](/api/reference/wxt/interfaces/InlineConfig#runner), included in version control
 3. `$HOME/web-ext.config.ts`: Provide default values for all WXT projects on your computer
 
 ## Recipes
@@ -31,9 +31,7 @@ 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';
-
+```ts
 export default defineWebExtConfig({
   binaries: {
     chrome: '/path/to/chrome-beta', // Use Chrome Beta instead of regular Chrome
@@ -43,18 +41,6 @@ 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
@@ -63,13 +49,11 @@ 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 in any of the config files mentioned above:
+To persist data, set the `--user-data-dir` flag:
 
 :::code-group
 
 ```ts [Mac/Linux]
-import { defineWebExtConfig } from 'wxt';
-
 export default defineWebExtConfig({
   chromiumArgs: ['--user-data-dir=./.wxt/chrome-data'],
 });
@@ -77,7 +61,6 @@ export default defineWebExtConfig({
 
 ```ts [Windows]
 import { resolve } from 'node:path';
-import { defineWebExtConfig } from 'wxt';
 
 export default defineWebExtConfig({
   // On Windows, the path must be absolute
@@ -98,31 +81,8 @@ 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';
-
+```ts
 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/entrypoint-loaders.md

@@ -10,7 +10,7 @@ WXT does several pre-processing steps to try and prevent errors during this proc
 2. Use `@webext-core/fake-browser` to create a fake version of the `chrome` and `browser` globals expected by extensions.
 3. Pre-process the JS/TS code, stripping out the `main` function then tree-shaking unused code from the file
 
-However, this process is not perfect. It doesn't setup all the globals found in the browser and the APIs may behave differently. As such, **_you should avoid using browser or extension APIs outside the `main` function of your entrypoints!_** See [Entrypoint Limitations](/guide/essentials/extension-apis#entrypoint-limitations) for more details.
+However, this process is not perfect. It doesn't setup all the globals found in the browser and the APIs may behave differently. As such, **_you should avoid using browser or extension APIs outside the `main` function of your entrypoints!_**
 
 :::tip
 If you're running into errors while importing entrypoints, run `wxt prepare --debug` to see more details about this process. When debugging, WXT will print out the pre-processed code to help you identify issues.

docs/guide/essentials/config/environment-variables.md

@@ -4,7 +4,7 @@
 
 WXT supports [dotenv files the same way as Vite](https://vite.dev/guide/env-and-mode.html#env-files). Create any of the following files:
 
-```plaintext
+```
 .env
 .env.local
 .env.[mode]
@@ -42,8 +42,6 @@ WXT provides some custom environment variables based on the current command:
 | `import.meta.env.EDGE`             | `boolean` | Equivalent to `import.meta.env.BROWSER === "edge"`    |
 | `import.meta.env.OPERA`            | `boolean` | Equivalent to `import.meta.env.BROWSER === "opera"`   |
 
-You can set the [`targetBrowsers`](/api/reference/wxt/interfaces/InlineConfig#targetbrowsers) option to make the `BROWSER` variable a more specific type, like `"chrome" | "firefox"`.
-
 You can also access all of [Vite's environment variables](https://vite.dev/guide/env-and-mode.html#env-variables):
 
 | Usage                  | Type      | Description                                                                 |
@@ -65,6 +63,7 @@ To use environment variables in the manifest, you need to use the function synta
 
 ```ts
 export default defineConfig({
+  extensionApi: 'chrome',
   modules: ['@wxt-dev/module-vue'],
   manifest: { // [!code --]
     oauth2: { // [!code --]
@@ -80,16 +79,3 @@ export default defineConfig({
 ```
 
 WXT can't load your `.env` files until after the config file has been loaded. So by using the function syntax for `manifest`, it defers creating the object until after the `.env` files are loaded into the process.
-
-Note that Vite's runtime environment variables, like `import.meta.env.DEV`, will not be defined. Instead, access the `mode` like this:
-
-```ts
-export default defineConfig({
-  manifest: ({ mode }) => {
-    const isDev = mode === 'development';
-    console.log('Is development mode:', isDev);
-
-    // ...
-  },
-});
-```

docs/guide/essentials/config/hooks.md

@@ -11,7 +11,7 @@ export default defineConfig({
   hooks: {
     'build:manifestGenerated': (wxt, manifest) => {
       if (wxt.config.mode === 'development') {
-        manifest.name += ' (DEV)';
+        manifest.title += ' (DEV)';
       }
     },
   },
@@ -20,8 +20,6 @@ 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
@@ -34,7 +32,7 @@ Because hooks can be defined in multiple places, including [WXT Modules](/guide/
 
 To see the order for your project, run `wxt prepare --debug` flag and search for the "Hook execution order":
 
-```plaintext
+```
 ⚙ Hook execution order:
 ⚙   1. wxt:built-in:unimport
 ⚙   2. src/modules/auto-icons.ts
@@ -52,9 +50,7 @@ Changing execution order is simple:
      📄 0.my-module.ts
      📄 1.another-module.ts
   ```
-
 - If you need to run an NPM module after user modules, just make it a user module and prefix the filename with a number!
-
   ```ts
   // modules/2.i18n.ts
   export { default } from '@wxt-dev/i18n/module';

docs/guide/essentials/config/manifest.md

@@ -128,7 +128,7 @@ If a version is not present in your `package.json`, it defaults to `"0.0.0"`.
 
 WXT automatically discovers your extension's icon by looking at files in the `public/` directory:
 
-```plaintext
+```
 public/
 ├─ icon-16.png
 ├─ icon-24.png
@@ -235,7 +235,6 @@ If you want to use the `activeTab` permission or the `browser.action.onClicked`
 
 1. Delete the [Popup entrypoint](/guide/essentials/entrypoints#popup) if it exists
 2. Add the `action` key to your manifest:
-
    ```ts
    export default defineConfig({
      manifest: {

docs/guide/essentials/config/runtime.md

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

docs/guide/essentials/content-scripts.md

@@ -19,7 +19,7 @@ export default defineContentScript({
 
 This object is responsible for tracking whether or not the content script's context is "invalidated". Most browsers, by default, do not stop content scripts if the extension is uninstalled, updated, or disabled. When this happens, content scripts start reporting this error:
 
-```plaintext
+```
 Error: Extension context invalidated.
 ```
 
@@ -76,7 +76,6 @@ To create a standalone content script that only includes a CSS file:
 
 1. Create the CSS file: `entrypoints/example.content.css`
 2. Use the `build:manifestGenerated` hook to add the content script to the manifest:
-
    ```ts [wxt.config.ts]
    export default defineConfig({
      hooks: {
@@ -211,7 +210,9 @@ export default defineContentScript({
       anchor: 'body',
       onMount: (container) => {
         // Create the Svelte app inside the UI container
-        return mount(App, { target: container });
+        mount(App, {
+          target: container,
+        });
       },
       onRemove: (app) => {
         // Destroy the app when the UI is removed
@@ -394,9 +395,11 @@ export default defineContentScript({
       anchor: 'body',
       onMount: (container) => {
         // Create the Svelte app inside the UI container
-        return mount(App, { target: container });
+        mount(App, {
+          target: container,
+        });
       },
-      onRemove: (app) => {
+      onRemove: () => {
         // Destroy the app when the UI is removed
         unmount(app);
       },
@@ -456,7 +459,6 @@ If you don't need to run your UI in the same frame as the content script, you ca
 WXT provides a helper function, [`createIframeUi`](/api/reference/wxt/utils/content-script-ui/iframe/functions/createIframeUi), which simplifies setting up the IFrame.
 
 1. Create an HTML page that will be loaded into your IFrame:
-
    ```html
    <!-- entrypoints/example-iframe.html -->
    <!doctype html>
@@ -471,9 +473,7 @@ WXT provides a helper function, [`createIframeUi`](/api/reference/wxt/utils/cont
      </body>
    </html>
    ```
-
 1. Add the page to the manifest's `web_accessible_resources`:
-
    ```ts [wxt.config.ts]
    export default defineConfig({
      manifest: {
@@ -486,7 +486,6 @@ WXT provides a helper function, [`createIframeUi`](/api/reference/wxt/utils/cont
      },
    });
    ```
-
 1. Create and mount the IFrame:
 
    ```ts
@@ -591,76 +590,6 @@ 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

@@ -4,30 +4,50 @@ outline: deep
 
 # Entrypoints
 
-WXT uses the files inside the `entrypoints/` directory as inputs when bundling your extension. They can be HTML, JS, CSS, or any variant of those file types supported by Vite (TS, JSX, SCSS, etc).
+WXT uses the files inside the `entrypoints/` directory as inputs when bundling your extension. They can be HTML, JS, CSS, or any variant of those file types supported by Vite (Pug, TS, JSX, SCSS, etc).
 
-## Folder Structure
-
-Inside the `entrypoints/` directory, an entrypoint is defined as a single file or directory (with an `index` file) inside it.
-
-:::code-group
+Here's an example set of entrypoints:
 
 <!-- prettier-ignore -->
-```html [Single File]
+```html
 📂 entrypoints/
-   📄 {name}.{ext}
+   📂 popup/
+      📄 index.html
+      📄 main.ts
+      📄 style.css
+   📄 background.ts
+   📄 content.ts
 ```
 
-<!-- prettier-ignore -->
-```html [Directory]
-📂 entrypoints/
-   📂 {name}/
-      📄 index.{ext}
-```
+[[toc]]
 
+## Listed vs Unlisted
+
+For web extensions, there are two types of entrypoints:
+
+- **Listed**: Referenced in the `manifest.json`
+- **Unlisted**: Not referenced in the `manifest.json`
+
+Throughout the rest of WXT's documentation, listed entrypoints are referred to by name. For example:
+
+- Popup
+- Options
+- Background
+- Content Scripts
+- Etc.
+
+Some examples of "unlisted" entrypoints:
+
+- A welcome page shown when the extension is installed
+- JS files injected by content scripts into the page's main world
+
+:::tip
+Regardless of whether an entrypoint is listed or unlisted, it will still be bundled into your extension and be available at runtime.
 :::
 
-The entrypoint's `name` dictates the type of entrypoint. For example, to add a ["Background" entrypoint](#background), either of these files would work:
+## Adding Entrypoints
+
+An entrypoint can be defined as a single file or directory with an `index` file inside it.
 
 :::code-group
 
@@ -46,96 +66,10 @@ The entrypoint's `name` dictates the type of entrypoint. For example, to add a [
 
 :::
 
+The entrypoint's name dictates the type of entrypoint, listed vs unlisted. In this example, "background" is the name of the ["Background" entrypoint](#background).
+
 Refer to the [Entrypoint Types](#entrypoint-types) section for the full list of listed entrypoints and their filename patterns.
 
-### Including Other Files
-
-When using an entrypoint directory, `entrypoints/{name}/index.{ext}`, you can add related files next to the `index` file.
-
-<!-- prettier-ignore -->
-```html
-📂 entrypoints/
-   📂 popup/
-      📄 index.html     ← This file is the entrypoint
-      📄 main.ts
-      📄 style.css
-   📂 background/
-      📄 index.ts       ← This file is the entrypoint
-      📄 alarms.ts
-      📄 messaging.ts
-   📂 youtube.content/
-      📄 index.ts       ← This file is the entrypoint
-      📄 style.css
-```
-
-:::danger
-**DO NOT** put files related to an entrypoint directly inside the `entrypoints/` directory. WXT will treat them as entrypoints and try to build them, usually resulting in an error.
-
-Instead, use a directory for that entrypoint:
-
-<!-- prettier-ignore -->
-```html
-📂 entrypoints/
-   📄 popup.html <!-- [!code --] -->
-   📄 popup.ts <!-- [!code --] -->
-   📄 popup.css <!-- [!code --] -->
-   📂 popup/ <!-- [!code ++] -->
-      📄 index.html <!-- [!code ++] -->
-      📄 main.ts <!-- [!code ++] -->
-      📄 style.css <!-- [!code ++] -->
-```
-
-:::
-
-### Deeply Nested Entrypoints
-
-While the `entrypoints/` directory might resemble the `pages/` directory of other web frameworks, like Nuxt or Next.js, **it does not support deeply nesting entrypoints** in the same way.
-
-Entrypoints must be zero or one levels deep for WXT to discover and build them:
-
-<!-- prettier-ignore -->
-```html
-📂 entrypoints/
-   📂 youtube/ <!-- [!code --] -->
-       📂 content/ <!-- [!code --] -->
-          📄 index.ts <!-- [!code --] -->
-          📄 ... <!-- [!code --] -->
-       📂 injected/ <!-- [!code --] -->
-          📄 index.ts <!-- [!code --] -->
-          📄 ... <!-- [!code --] -->
-   📂 youtube.content/ <!-- [!code ++] -->
-      📄 index.ts <!-- [!code ++] -->
-      📄 ... <!-- [!code ++] -->
-   📂 youtube-injected/ <!-- [!code ++] -->
-      📄 index.ts <!-- [!code ++] -->
-      📄 ... <!-- [!code ++] -->
-```
-
-## Unlisted Entrypoints
-
-In web extensions, there are two types of entrypoints:
-
-1. **Listed**: Referenced in the `manifest.json`
-2. **Unlisted**: Not referenced in the `manifest.json`
-
-Throughout the rest of WXT's documentation, listed entrypoints are referred to by name. For example:
-
-- Popup
-- Options
-- Background
-- Content Script
-
-However, not all entrypoints in web extensions are listed in the manifest. Some are not listed in the manifest, but are still used by extensions. For example:
-
-- A welcome page shown in a new tab when the extension is installed
-- JS files injected by content scripts into the main world
-
-For more details on how to add unlisted entrypoints, see:
-
-- [Unlisted Pages](#unlisted-pages)
-- [Unlisted Scripts](#unlisted-scripts)
-- [Unlisted CSS](#unlisted-css)
-
 ## Defining Manifest Options
 
 Most listed entrypoints have options that need to be added to the `manifest.json`. However with WXT, instead of defining the options in a separate file, _you define these options inside the entrypoint file itself_.
@@ -172,6 +106,8 @@ When building your extension, WXT will look at the options defined in your entry
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/mv3/manifest/background/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/background)
 
+For MV2, the background is added as a script to the background page. For MV3, the background becomes a service worker.
+
 <EntrypointPatterns
   :patterns="[
     ['background.[jt]s', 'background.js'],
@@ -205,25 +141,6 @@ export default defineBackground({
 
 :::
 
-For MV2, the background is added as a script to the background page. For MV3, the background becomes a service worker.
-
-When defining your background entrypoint, keep in mind that WXT will import this file in a NodeJS environment during the build process. That means you cannot place any runtime code outside the `main` function.
-
-<!-- prettier-ignore -->
-```ts
-browser.action.onClicked.addListener(() => { // [!code --]
-  // ... // [!code --]
-}); // [!code --]
-
-export default defineBackground(() => {
-  browser.action.onClicked.addListener(() => { // [!code ++]
-    // ... // [!code ++]
-  }); // [!code ++]
-});
-```
-
-Refer to the [Entrypoint Loaders](/guide/essentials/config/entrypoint-loaders) documentation for more details.
-
 ### Bookmarks
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/mv3/override/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides)
@@ -252,18 +169,18 @@ Refer to the [Entrypoint Loaders](/guide/essentials/config/entrypoint-loaders) d
 </html>
 ```
 
-When you define a Bookmarks entrypoint, WXT will automatically update the manifest to override the browser's bookmarks page with your own HTML page.
-
 ### Content Scripts
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/mv3/content_scripts/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts)
 
+See [Content Script UI](/guide/essentials/content-scripts) for more info on creating UIs and including CSS in content scripts.
+
 <EntrypointPatterns
   :patterns="[
     ['content.[jt]sx?', 'content-scripts/content.js'],
     ['content/index.[jt]sx?', 'content-scripts/content.js'],
-    ['{name}.content.[jt]sx?', 'content-scripts/{name}.js'],
-    ['{name}.content/index.[jt]sx?', 'content-scripts/{name}.js'],
+    ['<name>.content.[jt]sx?', 'content-scripts/<name>.js'],
+    ['<name>.content/index.[jt]sx?', 'content-scripts/<name>.js'],
   ]"
 />
 
@@ -296,29 +213,12 @@ export default defineContentScript({
 });
 ```
 
-When defining content script entrypoints, keep in mind that WXT will import this file in a NodeJS environment during the build process. That means you cannot place any runtime code outside the `main` function.
-
-<!-- prettier-ignore -->
-```ts
-const container = document.createElement('div'); // [!code --]
-document.body.append(container); // [!code --]
-
-export default defineContentScript({
-  main: function () {
-    const container = document.createElement('div'); // [!code ++]
-    document.body.append(container); // [!code ++]
-  },
-});
-```
-
-Refer to the [Entrypoint Loaders](/guide/essentials/config/entrypoint-loaders) documentation for more details.
-
-See [Content Script UI](/guide/essentials/content-scripts) for more info on creating UIs and including CSS in content scripts.
-
 ### Devtools
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/mv3/devtools/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/devtools_page)
 
+Follow the [Devtools Example](https://github.com/wxt-dev/examples/tree/main/examples/devtools-extension#readme) to add different panels and panes.
+
 <EntrypointPatterns
   :patterns="[
     ['devtools.html', 'devtools.html'],
@@ -342,8 +242,6 @@ See [Content Script UI](/guide/essentials/content-scripts) for more info on crea
 </html>
 ```
 
-Follow the [Devtools Example](https://github.com/wxt-dev/examples/tree/main/examples/devtools-extension#readme) to add different panels and panes.
-
 ### History
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/mv3/override/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides)
@@ -372,8 +270,6 @@ Follow the [Devtools Example](https://github.com/wxt-dev/examples/tree/main/exam
 </html>
 ```
 
-When you define a History entrypoint, WXT will automatically update the manifest to override the browser's history page with your own HTML page.
-
 ### Newtab
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/mv3/override/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides)
@@ -402,8 +298,6 @@ When you define a History entrypoint, WXT will automatically update the manifest
 </html>
 ```
 
-When you define a Newtab entrypoint, WXT will automatically update the manifest to override the browser's new tab page with your own HTML page.
-
 ### Options
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/mv3/options/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/options_ui)
@@ -470,19 +364,6 @@ 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', ...]" />
@@ -506,8 +387,8 @@ Firefox does not support sandboxed pages.
   :patterns="[
     ['sandbox.html', 'sandbox.html'],
     ['sandbox/index.html', 'sandbox.html'],
-    ['{name}.sandbox.html', '{name}.html'],
-    ['{name}.sandbox/index.html', '{name}.html'],
+    ['<name>.sandbox.html', '<name>.html'],
+    ['<name>.sandbox/index.html', '<name>.html'],
   ]"
 />
 
@@ -533,12 +414,14 @@ Firefox does not support sandboxed pages.
 
 [Chrome Docs](https://developer.chrome.com/docs/extensions/reference/sidePanel/) &bull; [Firefox Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Sidebars)
 
+In Chrome, side panels use the `side_panel` API, while Firefox uses the `sidebar_action` API.
+
 <EntrypointPatterns
   :patterns="[
     ['sidepanel.html', 'sidepanel.html'],
     ['sidepanel/index.html', 'sidepanel.html'],
-    ['{name}.sidepanel.html', '{name}.html` '],
-    ['{name}.sidepanel/index.html', '{name}.html` '],
+    ['<name>.sidepanel.html', '<name>.html` '],
+    ['<name>.sidepanel/index.html', '<name>.html` '],
   ]"
 />
 
@@ -572,18 +455,20 @@ Firefox does not support sandboxed pages.
 </html>
 ```
 
-In Chrome, side panels use the `side_panel` API, while Firefox uses the `sidebar_action` API.
-
 ### Unlisted CSS
 
+Follow Vite's guide to setup your preprocessor of choice: https://vitejs.dev/guide/features.html#css-pre-processors
+
+CSS entrypoints are always unlisted. To add CSS to a content script, see the [Content Script](/guide/essentials/content-scripts#css) docs.
+
 <EntrypointPatterns
   :patterns="[
-    ['{name}.(css|scss|sass|less|styl|stylus)', '{name}.css'],
-    ['{name}/index.(css|scss|sass|less|styl|stylus)', '{name}.css'],
+    ['<name>.(css|scss|sass|less|styl|stylus)', '<name>.css'],
+    ['<name>/index.(css|scss|sass|less|styl|stylus)', '<name>.css'],
     ['content.(css|scss|sass|less|styl|stylus)', 'content-scripts/content.css'],
     ['content/index.(css|scss|sass|less|styl|stylus)', 'content-scripts/content.css'],
-    ['{name}.content.(css|scss|sass|less|styl|stylus)', 'content-scripts/{name}.css'],
-    ['{name}.content/index.(css|scss|sass|less|styl|stylus)', 'content-scripts/{name}.css'],
+    ['<name>.content.(css|scss|sass|less|styl|stylus)', 'content-scripts/<name>.css'],
+    ['<name>.content/index.(css|scss|sass|less|styl|stylus)', 'content-scripts/<name>.css'],
   ]"
 />
 
@@ -593,16 +478,12 @@ body {
 }
 ```
 
-Follow Vite's guide to setup your preprocessor of choice: <https://vitejs.dev/guide/features.html#css-pre-processors>
-
-CSS entrypoints are always unlisted. To add CSS to a content script, see the [Content Script](/guide/essentials/content-scripts#css) docs.
-
 ### Unlisted Pages
 
 <EntrypointPatterns
   :patterns="[
-    ['{name}.html', '{name}.html'],
-    ['{name}/index.html', '{name}.html'],
+    ['<name>.html', '<name>.html'],
+    ['<name>/index.html', '<name>.html'],
   ]"
 />
 
@@ -624,21 +505,20 @@ CSS entrypoints are always unlisted. To add CSS to a content script, see the [Co
 </html>
 ```
 
-At runtime, unlisted pages are accessible at `/{name}.html`:
+Pages are accessible at `/<name>.html`:
 
 ```ts
-const url = browser.runtime.getURL('/{name}.html');
+const url = browser.runtime.getURL('/<name>.html');
 
-console.log(url); // "chrome-extension://{id}/{name}.html"
-window.open(url); // Open the page in a new tab
+console.log(url); // "chrome-extension://<id>/<name>.html"
 ```
 
 ### Unlisted Scripts
 
 <EntrypointPatterns
   :patterns="[
-    ['{name}.[jt]sx?', '{name}.js'],
-    ['{name}/index.[jt]sx?', '{name}.js'],
+    ['<name>.[jt]sx?', '<name>.js'],
+    ['<name>/index.[jt]sx?', '<name>.js'],
   ]"
 />
 
@@ -664,29 +544,12 @@ export default defineUnlistedScript({
 
 :::
 
-At runtime, unlisted scripts are accessible from `/{name}.js`:
+Scripts are accessible from `/<name>.js`:
 
 ```ts
-const url = browser.runtime.getURL('/{name}.js');
+const url = browser.runtime.getURL('/<name>.js');
 
-console.log(url); // "chrome-extension://{id}/{name}.js"
+console.log(url); // "chrome-extension://<id>/<name>.js"
 ```
 
 You are responsible for loading/running these scripts where needed. If necessary, don't forget to add the script and/or any related assets to [`web_accessible_resources`](https://developer.chrome.com/docs/extensions/reference/manifest/web-accessible-resources).
-
-When defining an unlisted script, keep in mind that WXT will import this file in a NodeJS environment during the build process. That means you cannot place any runtime code outside the `main` function.
-
-<!-- prettier-ignore -->
-```ts
-document.querySelectorAll('a').forEach((anchor) => { // [!code --]
-  // ... // [!code --]
-}); // [!code --]
-
-export default defineUnlistedScript(() => {
-  document.querySelectorAll('a').forEach((anchor) => { // [!code ++]
-    // ... // [!code ++]
-  }); // [!code ++]
-});
-```
-
-Refer to the [Entrypoint Loaders](/guide/essentials/config/entrypoint-loaders) documentation for more details.

docs/guide/essentials/es-modules.md

@@ -1,6 +1,6 @@
 # ES Modules
 
-Your source code should always be written as ESM. However, you have some control whether an entrypoint is bundled as ESM.
+You source code should always be written as ESM. However, you have some control whether an entrypoint is bundled as ESM.
 
 ## HTML Pages <Badge type="warning" text="≥0.0.1" />
 

docs/guide/essentials/extension-apis.md

@@ -29,7 +29,7 @@ This means you can use the promise-style API for both MV2 and MV3, and it will w
 All types can be accessed via WXT's `Browser` namespace:
 
 ```ts
-import { type Browser } from 'wxt/browser';
+import { Browser } from 'wxt/browser';
 
 function handleMessage(message: any, sender: Browser.runtime.MessageSender) {
   // ...
@@ -75,63 +75,3 @@ Alternatively, if you're trying to use similar APIs under different names (to su
   //
 });
 ```
-
-## 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**.
-
-To prevent some basic errors, WXT polyfills these globals with the same in-memory, fake implementation it uses for testing: [`@webext-core/fake-browser`](https://webext-core.aklinker1.io/fake-browser/installation/). However, not all the APIs have been implemented.
-
-So it is extremely important to NEVER use `browser.*` extension APIs outside the main function of any JS/TS entrypoints (background, content scripts, and unlisted scripts). If you do, you'll see an error like this:
-
-```plaintext
-✖ Command failed after 440 ms
-
- ERROR  Browser.action.onClicked.addListener not implemented.
-```
-
-The fix is simple, just move your API usage into the entrypoint's main function:
-
-:::code-group
-
-```ts [background.ts]
-browser.action.onClicked.addListener(() => {
-  /* ... */
-}); // [!code --]
-
-export default defineBackground(() => {
-  browser.action.onClicked.addListener(() => {
-    /* ... */
-  }); // [!code ++]
-});
-```
-
-```ts [content.ts]
-browser.runtime.onMessage.addListener(() => {
-  /* ... */
-}); // [!code --]
-
-export default defineContentScript({
-  main() {
-    browser.runtime.onMessage.addListener(() => {
-      /* ... */
-    }); // [!code ++]
-  },
-});
-```
-
-```ts [unlisted.ts]
-browser.runtime.onMessage.addListener(() => {
-  /* ... */
-}); // [!code --]
-
-export default defineUnlistedScript(() => {
-  browser.runtime.onMessage.addListener(() => {
-    /* ... */
-  }); // [!code ++]
-});
-```
-
-:::
-
-Read [Entrypoint Loaders](/guide/essentials/config/entrypoint-loaders) for more technical details about this limitation.

docs/guide/essentials/i18n.md

@@ -9,7 +9,6 @@ This page discusses how to setup internationalization using the vanilla `browser
 ## Usage
 
 1. Add `default_locale` to your manifest:
-
    ```ts
    export default defineConfig({
      manifest: {
@@ -17,12 +16,11 @@ This page discusses how to setup internationalization using the vanilla `browser
      },
    });
    ```
-
 2. Create `messages.json` files in the `public/` directory:
 
    <!-- prettier-ignore -->
    ```html
-   📂 {rootDir}/
+   📂 {srcDir}/
       📂 public/
          📂 _locales/
             📂 en/
@@ -43,11 +41,9 @@ This page discusses how to setup internationalization using the vanilla `browser
    ```
 
 3. Get the translation:
-
    ```ts
    browser.i18n.getMessage('helloWorld');
    ```
-
 4. _Optional_: Add translations for extension name and description:
 
 ```json

docs/guide/essentials/project-structure.md

@@ -30,10 +30,9 @@ Here's a brief summary of each of these files and directories:
 - `.wxt/`: Generated by WXT, it contains TS config
 - `assets/`: Contains all CSS, images, and other assets that should be processed by WXT
 - `components/`: Auto-imported by default, contains UI components
-- `composables/`: Auto-imported by default, contains source code for your project's composable functions for Vue
+- `composables/`: Auto-imported by default, contains composable functions for Vue
 - `entrypoints/`: Contains all the entrypoints that get bundled into your extension
-- `hooks/`: Auto-imported by default, contains source code for your project's hooks for React and Solid
-- `modules/`: Contains [local WXT Modules](/guide/essentials/wxt-modules) for your project
+- `hooks/`: Auto-imported by default, contains hooks for React and Solid
 - `public/`: Contains any files you want to copy into the output folder as-is, without being processed by WXT
 - `utils/`: Auto-imported by default, contains generic utilities used throughout your project
 - `.env`: Contains [Environment Variables](/guide/essentials/config/environment-variables)

docs/guide/essentials/publishing.md

@@ -23,7 +23,7 @@ WXT provides two commands to help automate submitting a new version for review a
 - `wxt submit init`: Setup all the required secrets and options for the `wxt submit` command
 - `wxt submit`: Submit new versions of your extension for review (and publish them automatically once approved)
 
-To get started, run `wxt submit init` and follow the prompts, or run `wxt submit --help` to view all available options. Once finished, you should have a `.env.submit` file! WXT will use this file to submit your updates.
+To get started, run `wxt submit init` and follow the prompts. Once finished, you should have a `.env.submit` file! WXT will use this file to submit your updates.
 
 > In CI, make sure you add all the environment variables to the submit step.
 
@@ -72,13 +72,13 @@ jobs:
   submit:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 20
           cache: 'pnpm'
 
       - name: Install dependencies

docs/guide/essentials/target-different-browsers.md

@@ -62,7 +62,6 @@ Here are some examples:
   ```
 
 - HTML file only built for all targets other than `chrome`:
-
   ```html
   <!doctype html>
   <html lang="en">

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/vitest-plugin';
+import { WxtVitest } from 'wxt/testing';
 
 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/fake-browser';
+import { fakeBrowser } from 'wxt/testing';
 
 const accountStorage = storage.defineItem<Account>('local:account');
 
@@ -85,7 +85,7 @@ import { injectScript, createShadowRootUi } from '#imports';
 But Vitest sees this:
 
 ```ts
-import { injectScript } from 'wxt/utils/inject-script';
+import { injectScript } from 'wxt/browser';
 import { createShadowRootUi } from 'wxt/utils/content-script-ui/shadow-root';
 ```
 
@@ -105,4 +105,4 @@ To use a different framework, you will likely have to disable auto-imports, setu
 
 It is possible to do, but will require a bit more setup. Refer to Vitest's setup for an example of how to setup a test environment:
 
-<https://github.com/wxt-dev/wxt/blob/main/packages/wxt/src/testing/wxt-vitest-plugin.ts>
+https://github.com/wxt-dev/wxt/blob/main/packages/wxt/src/testing/wxt-vitest-plugin.ts

docs/guide/essentials/wxt-modules.md

@@ -1,7 +1,3 @@
----
-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.
@@ -13,23 +9,18 @@ WXT provides a "module system" that let's you run code at different steps in the
 There are two ways to add a module to your project:
 
 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'],
    });
    ```
-
    > 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.
 
 ## Module Options
@@ -70,7 +61,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 make sure to read about [all the hooks that are available](/api/reference/wxt/interfaces/WxtHooks) - they are essential to writing modules.
+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.
 
 ### Recipes
 
@@ -135,64 +126,12 @@ declare module 'wxt/utils/define-app-config' {
 Runtime options are returned when calling
 
 ```ts
-const config = getAppConfig();
+const config = useAppConfig();
 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
@@ -276,7 +215,7 @@ export default defineWxtModule({
     const analyticsModuleCode = `
       import { createAnalytics } from 'some-module';
 
-      export const analytics = createAnalytics(getAppConfig().analytics);
+      export const analytics = createAnalytics(useAppConfig().analytics);
       export const { reportEvent, reportPageView } = analytics;
     `;
 

docs/guide/installation.md

@@ -45,63 +45,47 @@ Once you've run the `dev` command, continue to [Next Steps](#next-steps)!
 
 1. Create a new project
    :::code-group
-
    ```sh [PNPM]
    cd my-project
    pnpm init
    ```
-
    ```sh [Bun]
    cd my-project
    bun init
    ```
-
    ```sh [NPM]
    cd my-project
    npm init
    ```
-
    ```sh [Yarn]
    cd my-project
    yarn init
    ```
-
    :::
-
 2. Install WXT:
    :::code-group
-
    ```sh [PNPM]
    pnpm i -D wxt
    ```
-
    ```sh [Bun]
    bun i -D wxt
    ```
-
    ```sh [NPM]
    npm i -D wxt
    ```
-
    ```sh [Yarn]
    yarn add --dev wxt
    ```
-
    :::
-
 3. Add an entrypoint, `my-project/entrypoints/background.ts`:
    :::code-group
-
    ```ts
    export default defineBackground(() => {
      console.log('Hello world!');
    });
    ```
-
    :::
-
 4. Add scripts to your `package.json`:
-
    ```json [package.json]
    {
      "scripts": {
@@ -115,26 +99,20 @@ Once you've run the `dev` command, continue to [Next Steps](#next-steps)!
      }
    }
    ```
-
 5. Run your extension in dev mode
    :::code-group
-
    ```sh [PNPM]
    pnpm dev
    ```
-
    ```sh [Bun]
    bun run dev
    ```
-
    ```sh [NPM]
    npm run dev
    ```
-
    ```sh [Yarn]
    yarn dev
    ```
-
    :::
    WXT will automatically open a browser window with your extension installed.
 

docs/guide/introduction.md

@@ -1,4 +1,4 @@
-# Welcome to WXT
+# Welcome to WXT!
 
 WXT is a modern, open-source framework for building web extensions. Inspired by Nuxt, its goals are to:
 

docs/guide/resources/community.md

@@ -7,10 +7,8 @@ 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

@@ -20,13 +20,13 @@ await chrome.scripting.getRegisteredContentScripts();
 
 ## How do I disable opening the browser automatically during development?
 
-See <https://wxt.dev/guide/essentials/config/browser-startup.html#disable-opening-browser>
+See https://wxt.dev/guide/essentials/config/browser-startup.html#disable-opening-browser
 
 ## How do I stay logged into a website during development?
 
-See <https://wxt.dev/guide/essentials/config/browser-startup.html#persist-data>
+See https://wxt.dev/guide/essentials/config/browser-startup.html#persist-data
 
-## My component library doesn't work in content scripts
+## My component library doesn't work in content scripts!
 
 This is usually caused by one of two things (or both) when using `createShadowRootUi`:
 
@@ -36,6 +36,7 @@ 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/)
 
@@ -164,59 +165,12 @@ 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.
+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.
 
 Additionally, if you want to train your own model or provide context to your editor, you can use the LLM knowledge files hosted by the site:
 
-<https://wxt.dev/knowledge/index.json>
+https://wxt.dev/knowledge/index.json
 
 You don't need to crawl the entire website, these files already contain all the relevant docs for training a LLM on WXT. But feel free to crawl it and generate your own files if you want!
-
-## How do I run my WXT project with docker / [devcontainers](https://containers.dev)?
-
-To run the WXT dev server in a devcontainer, but load the dev build of your extension in your browser:
-
-1. **Bind-mount your project directory to your host**
-   If you're using VS Code, you can open your project folder with the `Dev Containers: Open Folder in Container...` command. This keeps the folder synchronized between your host and the devcontainer, ensuring that the extension `dist` directory remains accessible from the host.
-
-2. **Disable auto-opening the browser**
-   WXT automatically opens your browser during development, but since you're running inside a container, it won't be able to access it. Follow [the guide here](https://wxt.dev/guide/essentials/config/browser-startup.html#disable-opening-browser) to disable browser auto-opening in your `wxt.config.ts`.
-
-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,11 +15,6 @@ 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

@@ -6,31 +6,12 @@ outline: deep
 
 ## Overview
 
-To upgrade WXT to the latest major version:
-
-1. Install it, skipping scripts so `wxt prepare` doesn't run - it will probably throw an error after a major version change (we'll run it later).
-
-   ```sh
-   pnpm i wxt@latest --ignore-scripts
-   ```
-
-2. Follow the upgrade steps below to fix any breaking changes.
-3. Run `wxt prepare`. It should succeed and type errors will go away afterwords.
-
-   ```sh
-   pnpm wxt prepare
-   ```
-
-4. Manually test to make sure both dev mode and production builds work.
-
-For minor or patch version updates, there are no special steps. Just update it with your package manager:
+To upgrade WXT to the latest version... just install it!
 
 ```sh
 pnpm i wxt@latest
 ```
 
----
-
 Listed below are all the breaking changes you should address when upgrading to a new version of WXT.
 
 Currently, WXT is in pre-release. This means changes to the second digit, `v0.X`, are considered major and have breaking changes. Once v1 is released, only major version bumps will have breaking changes.
@@ -40,136 +21,88 @@ Currently, WXT is in pre-release. This means changes to the second digit, `v0.X`
 v0.20 is a big release! There are lots of breaking changes because this version is intended to be a release candidate for v1.0. If all goes well, v1.0 will be released with no additional breaking changes.
 
 :::tip
-Read through all the changes once before updating your code.
+Read through all the changes once before making any code changes.
 :::
 
 ### `webextension-polyfill` Removed
 
-WXT's `browser` no longer uses the `webextension-polyfill`!
-
-:::details Why?
-See <https://github.com/wxt-dev/wxt/issues/784>
-:::
+WXT no longer uses the `webextension-polyfill` internally and `wxt/browser` uses the `chrome`/`browser` globals provided by the browser.
 
 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:
-
-     ```ts
-     browser.runtime.onMessage.addListener(async () => { // [!code --]
-       const res = await someAsyncWork(); // [!code --]
-       return res; // [!code --]
-     browser.runtime.onMessage.addListener(async (_message, _sender, sendResponse) => { // [!code ++]
-       someAsyncWork().then((res) => { // [!code ++]
-         sendResponse(res); // [!code ++]
-       }); // [!code ++]
-       return true; // [!code ++]
-     });
-     ```
-
-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):
-
+   - Replace any manual imports from `wxt/browser/chrome` with `wxt/browser`
+2. **Continue using the polyfill**
+   - Install the polyfill and WXT's [new polyfill module](https://www.npmjs.com/package/@wxt-dev/webextension-polyfill):
      ```sh
      pnpm i webextension-polyfill @wxt-dev/webextension-polyfill
      ```
-
    - Add the WXT module to your config:
-
-     ```ts [wxt.config.ts]
+     ```ts
+     // wxt.config.ts
      export default defineConfig({
        modules: ['@wxt-dev/webextension-polyfill'],
      });
      ```
 
-The new `browser` object (and types) is backed by WXT's new package: [`@wxt-dev/browser`](https://www.npmjs.com/package/@wxt-dev/browser). This package continues WXT's mission of providing useful packages for the whole community. Just like [`@wxt-dev/storage`](https://www.npmjs.com/package/@wxt-dev/storage), [`@wxt-dev/i18n`](https://www.npmjs.com/package/@wxt-dev/i18n), [`@wxt-dev/analytics`](https://www.npmjs.com/package/@wxt-dev/analytics), it is designed to be easy to use in any web extension project, not just those using WXT, and provides a consistent API across all browsers and manifest versions.
+Regardless of your choice, the `extensionApi` config has been removed. Remove it from your `wxt.config.ts` file if present:
 
-### `extensionApi` Config Removed
-
-The `extensionApi` config has been removed. Before, this config provided a way to opt into using the new `browser` object prior to v0.20.0.
-
-Remove it from your `wxt.config.ts` file if present:
-
-```ts [wxt.config.ts]
+```ts
+// wxt.config.ts
 export default defineConfig({
   extensionApi: 'chrome', // [!code --]
 });
 ```
 
-### Extension API Type Changes
-
-With the new `browser` introduced in v0.20, how you access types has changed. WXT now provides types based on `@types/chrome` instead of `@types/webextension-polyfill`.
-
-These types are more up-to-date with MV3 APIs, contain less bugs, are better organized, and don't have any auto-generated names.
-
-To access types, use the new `Browser` namespace from `wxt/browser`:
+Additionally, extension API types have changed. `wxt/browser` now uses types from `@types/chrome` instead of `@types/webextension-polyfill`. You will have to migrate any type imports to use `@types/chrome`'s namespace approach:
 
 <!-- prettier-ignore -->
 ```ts
 import type { Runtime } from 'wxt/browser'; // [!code --]
-import type { Browser } from 'wxt/browser'; // [!code ++]
+import { browser } from 'wxt/browser'; // [!code ++]
 
 function getMessageSenderUrl(sender: Runtime.MessageSender): string { // [!code --]
-function getMessageSenderUrl(sender: Browser.runtime.MessageSender): string { // [!code ++]
+function getMessageSenderUrl(sender: browser.runtime.MessageSender): string { // [!code ++]
   // ...
 }
 ```
 
-> If you use auto-imports, `Browser` will be available without manually importing it.
-
-Not all type names will be the same as what `@types/webextension-polyfill` provides. You'll have to find the new type names by looking at the types of the `browser.*` API's you use.
+`@types/chrome` are more up-to-date, contain less bugs, and don't have any auto-generated names. So even if you continue to use the polyfill, you will need to update your types to use these types.
 
 ### `public/` and `modules/` Directories Moved
 
-The default location for the `public/` and `modules/` directories have changed to better align with standards set by other frameworks (Nuxt, Next, Astro, etc). Now, each path is relative to the project's **root directory**, not the src directory.
+The default location for the `public/` and `modules/` directories have changed to better align with standards set by other frameworks (Nuxt, Next, Astro, etc). Now, each path is relative to the project's root directory.
 
 - 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
-      📂 {rootDir}/
-         📁 modules/ <!-- [!code ++] -->
-         📁 public/ <!-- [!code ++] -->
-         📂 src/
-            📁 components/
-            📁 entrypoints/
-            📁 modules/ <!-- [!code --] -->
-            📁 public/ <!-- [!code --] -->
-            📁 utils/
-            📄 app.config.ts
-         📄 wxt.config.ts
+  1.  Keep the folders in the same place and update your project config:
+      ```ts
+      // wxt.config.ts
+      export default defineConfig({
+        srcDir: 'src',
+        publicDir: 'src/public', // [!code ++]
+        modulesDir: 'src/modules', // [!code ++]
+      });
+      ```
+  2.  Move the your `public/` and `modules/` directories to the project root:
+      ```diff
+      <root>/
+      +   modules/
+      +   public/
+          src/
+              components/
+              entrypoints/
+      -       modules/
+      -       public/
+              utils/
+          wxt.config.ts
       ```
 
-  2. Keep the folders in the same place and update your project config:
+### Import Path Changes
 
-     ```ts [wxt.config.ts]
-     export default defineConfig({
-       srcDir: 'src',
-       publicDir: 'src/public', // [!code ++]
-       modulesDir: 'src/modules', // [!code ++]
-     });
-     ```
+The APIs exported by `wxt/sandbox`, `wxt/client`, or `wxt/storage` have moved to `wxt/utils/*`.
 
-### Import Path Changes and `#imports`
-
-The APIs exported by `wxt/sandbox`, `wxt/client`, or `wxt/storage` have moved to individual exports under the `wxt/utils/*` path.
-
-:::details Why?
-As WXT grows and more utilities are added, any helper with side-effects will not be tree-shaken out of your final bundle.
-
-This can cause problems because not every API used by these side-effects is available in every type of entrypoint. Some APIs can only be used in the background, sandboxed pages can't use any extension API, etc. This was leading to JS throwing errors in the top-level scope, preventing your code from running.
-
-Splitting each util into it's own module solves this problem, making sure you're only importing APIs and side-effects into entrypoints they can run in.
-:::
-
-Refer to the updated [API Reference](/api/reference/) to see the list of new import paths.
-
-However, you don't need to memorize or learn the new import paths! v0.20 introduces a new virtual module, `#imports`, that abstracts all this away from developers. See the [blog post](/blog/2024-12-06-using-imports-module) for more details about how this module works.
-
-So to upgrade, just replace any imports from `wxt/storage`, `wxt/client`, and `wxt/sandbox` with an import to the new `#imports` module:
+To upgrade, replace these imports with the new `#imports` module:
 
 ```ts
 import { storage } from 'wxt/storage'; // [!code --]
@@ -177,49 +110,38 @@ 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, getAppConfig } from '#imports'; // [!code ++]
+import { ContentScriptContext, useAppConfig } from '#imports'; // [!code ++]
 ```
 
 You can combine the imports into a single import statement, but it's easier to just find/replace each statement.
 
-```ts
-import { storage } from 'wxt/storage'; // [!code --]
-import { defineContentScript } from 'wxt/sandbox'; // [!code --]
-import { ContentScriptContext, useAppConfig } from 'wxt/client'; // [!code --]
-import {
-  // [!code ++]
-  storage, // [!code ++]
-  defineContentScript, // [!code ++]
-  ContentScriptContext, // [!code ++]
-  getAppConfig, // [!code ++]
-} from '#imports'; // [!code ++]
-```
-
 :::tip
 Before types will work, you'll need to run `wxt prepare` after installing v0.20 to generate the new TypeScript declarations.
 :::
 
+Read more about the new `#imports` module in the [blog post](/blog/2024-12-06-using-imports-module).
+
 ### `createShadowRootUi` CSS Changes
 
 WXT now resets styles inherited from the webpage (`visibility`, `color`, `font-size`, etc.) by setting `all: initial` inside the shadow root.
 
-:::warning
-This doesn't effect `rem` units. You should continue using `postcss-rem-to-px` or an equivalent library if the webpage sets the HTML element's `font-size`.
-:::
-
 If you use `createShadowRootUi`:
 
-1. Remove any manual CSS overrides that reset the style of specific websites. For example:
+1. Double check that your UI looks the same as before.
+2. If you have any manual CSS resets to override a page style, you can remove them:
 
    <!-- prettier-ignore -->
-   ```css [entrypoints/reddit.content/style.css]
+   ```css
+   /* entrypoints/reddit.content/style.css */
    body { /* [!code --] */
      /* Override Reddit's default "hidden" visibility on elements */ /* [!code --] */
      visibility: visible !important; /* [!code --] */
    } /* [!code --] */
    ```
 
-2. Double check that your UI looks the same as before.
+:::warning
+This doesn't effect `rem` units. You should continue using `postcss-rem-to-px` or an equivalent library if the webpage sets the HTML element's `font-size`.
+:::
 
 If you run into problems with the new behavior, you can disable it and continue using your current CSS:
 
@@ -232,32 +154,79 @@ const ui = await createShadowRootUi({
 
 ### Default Output Directories Changed
 
-The default value for the [`outDirTemplate`](/api/reference/wxt/interfaces/InlineConfig#outdirtemplate) config has changed. Now, different build modes are output to different directories:
+The default value for [`outDirTemplate`](/api/reference/wxt/interfaces/InlineConfig#outdirtemplate) has changed. Now, different build modes are output to different directories:
 
-- `--mode production` &rarr; `.output/chrome-mv3`: Production builds are unchanged
-- `--mode development` &rarr; `.output/chrome-mv3-dev`: Dev mode now has a `-dev` suffix so it doesn't overwrite production builds
-- `--mode custom` &rarr; `.output/chrome-mv3-custom`: Other custom modes end with a `-[mode]` suffix
+- `--mode production`: `.output/chrome-mv3` (unchanged)
+- `--mode development`: `.output/chrome-mv3-dev` (`-dev` suffix)
+- `--mode custom`: `.output/chrome-mv3-custom` (`-[mode]` suffix)
 
-To use the old behavior, writing all output to the same directory, set the `outDirTemplate` option:
+To revert and use the old behavior, writing all output to the same directory, set `outDirTemplate` option:
 
-```ts [wxt.config.ts]
+```ts
+// wxt.config.ts
 export default defineConfig({
   outDirTemplate: '{{browser}}-mv{{manifestVersion}}', // [!code ++]
 });
 ```
 
-:::warning
-If you've previously loaded the extension into your browser manually for development, you'll need to uninstall and re-install it from the new dev output directory.
-:::
+If you've loaded the extension into your browser manually for development, uninstall and re-install it from the new dev output directory.
+
+### Internal Auto-import Options Changed
+
+Only relevant if you refer to WXT's built-in `preset`s in the `imports` config in a module or hooks.
+
+Instead of using `package` to auto-detect APIs to auto-import, WXT now uses `from` and `imports` to manually list APIs that are imported.
+
+```ts
+presets: [
+  { package: "wxt/browser" }, // [!code --]
+  { from: "wxt/browser": imports: ["browser"] }, // [!code --]
+  // ...
+]
+```
+
+See [PR #1315 `packages/wxt/src/core/resolve-config.ts` changes](https://github.com/wxt-dev/wxt/pull/1315/files#diff-ff0465c3a486d3ba187204149a25fc8f632c44d65da356dc04c0f2b268a71506) for exact changes made.
+
+### `runner` APIs Renamed
+
+To improve consistency with the `web-ext.config.ts` file, the "runner" APIs have been renamed. You can continue using the old names, but they have been deprecated and will be removed in a future version:
+
+1. The `runner` option has been renamed to `webExt`:
+   ```ts
+   // wxt.config.ts
+   export default defineConfig({
+     runner: { // [!code --]
+     webExt: { // [!code ++]
+       startUrls: ["https://wxt.dev"],
+     },
+   });
+   ```
+2. `defineRunnerConfig` has been renamed to `defineWebExtConfig`:
+   ```ts
+   // web-ext.config.ts
+   import { defineRunnerConfig } from 'wxt'; // [!code --]
+   import { defineWebExtConfig } from 'wxt'; // [!code ++]
+   ```
+3. The `ExtensionRunnerConfig` type has been renamed to `WebExtConfig`
+   ```ts
+   import type { ExtensionRunnerConfig } from 'wxt'; // [!code --]
+   import type { WebExtConfig } from 'wxt'; // [!code ++]
+   ```
+
+### Load Config as ESM
+
+`wxt.config.ts` and `web-ext.config.ts` are now loaded as ESM modules. Previously, they were loaded as CJS.
+
+If you're using any CJS APIs, like `__filename` or `__dirname`, replace them with their ESM counterparts, like `import.meta.filename` or `import.meta.dirname`.
 
 ### Deprecated APIs Removed
 
 - `entrypointLoader` option: WXT now uses `vite-node` for importing entrypoints during the build process.
-  <!-- markdownlint-disable-next-line MD051 -->
   > This was deprecated in v0.19.0, see the [v0.19 section](#v0-18-5-rarr-v0-19-0) for migration steps.
 - `transformManifest` option: Use the `build:manifestGenerated` hook to transform the manifest instead:
   <!-- prettier-ignore -->
-  ```ts [wxt.config.ts]
+  ```ts
+  // wxt.config.ts
   export default defineConfig({
     transformManifest(manifest) { // [!code --]
     hooks: { // [!code ++]
@@ -268,37 +237,6 @@ If you've previously loaded the extension into your browser manually for develop
   });
   ```
 
-### New Deprecations
-
-#### `runner` APIs Renamed
-
-To improve consistency with the `web-ext.config.ts` filename, the "runner" API and config options have been renamed. You can continue using the old names, but they have been deprecated and will be removed in a future version:
-
-1. The `runner` option has been renamed to `webExt`:
-
-   ```ts [wxt.config.ts]
-   export default defineConfig({
-     runner: { // [!code --]
-     webExt: { // [!code ++]
-       startUrls: ["https://wxt.dev"],
-     },
-   });
-   ```
-
-2. `defineRunnerConfig` has been renamed to `defineWebExtConfig`:
-
-   ```ts [web-ext.config.ts]
-   import { defineRunnerConfig } from 'wxt'; // [!code --]
-   import { defineWebExtConfig } from 'wxt'; // [!code ++]
-   ```
-
-3. The `ExtensionRunnerConfig` type has been renamed to `WebExtConfig`
-
-   ```ts
-   import type { ExtensionRunnerConfig } from 'wxt'; // [!code --]
-   import type { WebExtConfig } from 'wxt'; // [!code ++]
-   ```
-
 ## v0.18.5 &rarr; v0.19.0
 
 ### `vite-node` Entrypoint Loader
@@ -306,7 +244,7 @@ To improve consistency with the `web-ext.config.ts` filename, the "runner" API a
 The default entrypoint loader has changed to `vite-node`. If you use any NPM packages that depend on the `webextension-polyfill`, you need to add them to Vite's `ssr.noExternal` option:
 
 <!-- prettier-ignore -->
-```ts [wxt.config.ts]
+```ts
 export default defineConfig({
   vite: () => ({ // [!code ++]
     ssr: { // [!code ++]
@@ -354,7 +292,7 @@ Basically, you can now import and do things outside the `main` function of the e
 
 To continue using the old approach, add the following to your `wxt.config.ts` file:
 
-```ts [wxt.config.ts]
+```ts
 export default defineConfig({
   entrypointLoader: 'jiti', // [!code ++]
 });
@@ -371,7 +309,7 @@ WXT no longer ships with Common JS support. If you're using CJS, here's your mig
 1. Add [`"type": "module"`](https://nodejs.org/api/packages.html#type) to your `package.json`.
 2. Change the file extension of any `.js` files that use CJS syntax to `.cjs`, or update them to use EMS syntax.
 
-Vite also provides steps for migrating to ESM. Check them out for more details: <https://vitejs.dev/guide/migration#deprecate-cjs-node-api>
+Vite also provides steps for migrating to ESM. Check them out for more details: https://vitejs.dev/guide/migration#deprecate-cjs-node-api
 
 ## v0.18.0 &rarr; v0.18.5
 
@@ -386,13 +324,11 @@ If you already have `<srcDir>/modules` or `<srcDir>/Modules` directory, `wxt pre
 You have two options:
 
 1. [Recommended] Keep your files where they are and tell WXT to look in a different folder:
-
    ```ts [wxt.config.ts]
    export default defineConfig({
      modulesDir: 'wxt-modules', // defaults to "modules"
    });
    ```
-
 2. Rename your `modules` directory to something else.
 
 ## v0.17.0 &rarr; v0.18.0
@@ -446,7 +382,7 @@ item.watch((newValue: number, oldValue: number) => { // [!code ++]
 
 JS entrypoints in the output directory have been moved. Unless you're doing some kind of post-build work referencing files, you don't have to make any changes.
 
-```plaintext
+```
 .output/
   <target>/
     chunks/
@@ -476,7 +412,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/multiple-browsers.html#runtime
 
 - `__BROWSER__` → `import.meta.env.BROWSER`
 - `__COMMAND__` → `import.meta.env.COMMAND`
@@ -503,7 +439,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### New `wxt/storage` APIs
 
-`wxt/storage` no longer relies on [`unstorage`](https://www.npmjs.com/package/unstorage). Some `unstorage` APIs, like `prefixStorage`, have been removed, while others, like `snapshot`, are methods on the new `storage` object. Most of the standard usage remains the same. See <https://wxt.dev/guide/storage> and <https://wxt.dev/api/reference/wxt/storage/> for more details ([#300](https://github.com/wxt-dev/wxt/pull/300))
+`wxt/storage` no longer relies on [`unstorage`](https://www.npmjs.com/package/unstorage). Some `unstorage` APIs, like `prefixStorage`, have been removed, while others, like `snapshot`, are methods on the new `storage` object. Most of the standard usage remains the same. See https://wxt.dev/guide/storage and https://wxt.dev/api/reference/wxt/storage/ for more details ([#300](https://github.com/wxt-dev/wxt/pull/300))
 
 ## v0.11.0 &rarr; v0.12.0
 
@@ -513,7 +449,6 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 - If you use auto-imports, no changes are required.
 - If you have disabled auto-imports, you'll need to manually update your import statements:
-
   ```ts
   import { defineBackground, defineContentScript } from 'wxt/client'; // [!code --]
   import { defineBackground, defineContentScript } from 'wxt/sandbox'; // [!code ++]

docs/is-background.md

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

docs/public/_redirects

@@ -32,8 +32,6 @@
 /guide/build-targets.html       /guide/multiple-browsers.html
 /guide/installation.html        /get-started/installation.html
 /guide/introduction.html        /get-started/introduction.html
-/guide/upgrade-guide/wxt        /guide/resources/upgrading.html
-/guide/upgrade-guide/wxt.html   /guide/resources/upgrading.html
 
 # 0.19.0
 /guide/go-further/entrypoint-side-effects.html /guide/go-further/entrypoint-loaders.html

docs/runner.md

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

package.json

@@ -4,52 +4,46 @@
   "engines": {
     "node": ">=18.20.3"
   },
-  "packageManager": "pnpm@10.29.2+sha512.bef43fa759d91fd2da4b319a5a0d13ef7a45bb985a3d7342058470f9d2051a3ba8674e629672654686ef9443ad13a82da2beb9eeb3e0221c87b8154fff9d74b8",
+  "packageManager": "pnpm@10.5.2",
   "scripts": {
     "check": "check && pnpm -r --sequential run check",
     "test": "pnpm -r --sequential run test run",
     "test:coverage": "pnpm -r --sequential run 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"
   },
   "devDependencies": {
-    "@aklinker1/buildc": "^1.1.7",
-    "@aklinker1/check": "^2.2.0",
-    "@commitlint/config-conventional": "^20.4.3",
-    "@commitlint/types": "^20.4.3",
-    "@types/fs-extra": "^11.0.4",
-    "@types/semver": "^7.7.1",
-    "@vitest/coverage-v8": "^4.0.18",
-    "changelogen": "^0.6.2",
-    "consola": "^3.4.2",
-    "feed": "^5.2.0",
-    "fs-extra": "^11.3.4",
-    "lint-staged": "^16.3.2",
-    "markdown-it-footnote": "^4.0.0",
-    "markdownlint-cli": "^0.48.0",
-    "nano-spawn": "^2.0.0",
-    "p-map": "^7.0.4",
-    "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.1",
-    "typedoc-plugin-markdown": "4.0.0-next.23",
-    "typedoc-vitepress-theme": "1.0.0-next.3",
-    "typescript": "^5.9.3",
-    "vitepress": "^1.6.4",
-    "vitepress-knowledge": "^0.4.1",
-    "vitepress-plugin-group-icons": "^1.7.1",
-    "vitepress-plugin-llms": "^1.11.0",
-    "vitest-mock-extended": "^3.1.0",
-    "vue": "^3.5.29",
+    "@aklinker1/buildc": "catalog:",
+    "@aklinker1/check": "catalog:",
+    "@commitlint/config-conventional": "catalog:",
+    "@commitlint/types": "catalog:",
+    "@types/fs-extra": "catalog:",
+    "@vitest/coverage-v8": "catalog:",
+    "changelogen": "catalog:",
+    "consola": "catalog:",
+    "fast-glob": "catalog:",
+    "feed": "catalog:",
+    "fs-extra": "catalog:",
+    "lint-staged": "catalog:",
+    "markdown-it-footnote": "catalog:",
+    "nano-spawn": "catalog:",
+    "prettier": "catalog:",
+    "simple-git-hooks": "catalog:",
+    "tsx": "catalog:",
+    "typedoc": "catalog:",
+    "typedoc-plugin-frontmatter": "catalog:",
+    "typedoc-plugin-markdown": "catalog:",
+    "typedoc-vitepress-theme": "catalog:",
+    "typescript": "catalog:",
+    "vitepress": "catalog:",
+    "vitepress-knowledge": "catalog:",
+    "vitepress-plugin-group-icons": "catalog:",
+    "vitest-mock-extended": "catalog:",
+    "vue": "catalog:",
     "wxt": "workspace:*"
   },
   "simple-git-hooks": {
@@ -57,5 +51,16 @@
   },
   "lint-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,100 +0,0 @@
-# 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
-
-- ⚠️  Update min WXT version to 0.20 ([2e8baf0](https://github.com/wxt-dev/wxt/commit/2e8baf0))
-
-### ❤️ Contributors
-
-- Aaron ([@aklinker1](https://github.com/aklinker1))

packages/analytics/README.md

@@ -10,19 +10,15 @@ Report analytics events from your web extension extension.
 ## Install With WXT
 
 1. Install the NPM package:
-
    ```bash
    pnpm i @wxt-dev/analytics
    ```
-
 2. In your `wxt.config.ts`, add the WXT module:
-
    ```ts
    export default defineConfig({
      modules: ['@wxt-dev/analytics/module'],
    });
    ```
-
 3. In your `<srcDir>/app.config.ts`, add a provider:
 
    ```ts
@@ -53,11 +49,9 @@ Report analytics events from your web extension extension.
 ## Install Without WXT
 
 1. Install the NPM package:
-
    ```bash
    pnpm i @wxt-dev/analytics
    ```
-
 2. Create an `analytics` instance:
 
    ```ts
@@ -72,12 +66,10 @@ Report analytics events from your web extension extension.
    ```
 
 3. Import your analytics module in the background to initialize the message listener:
-
    ```ts
    // background.ts
    import './utils/analytics';
    ```
-
 4. Then use your `analytics` instance to report events:
 
    ```ts

packages/analytics/build.config.ts

@@ -0,0 +1,21 @@
+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,51 +2,18 @@ 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)
+  if (typeof chrome === 'undefined' || !chrome?.runtime?.id)
     throw Error(
       'Cannot use WXT analytics in contexts without access to the browser.runtime APIs',
     );
@@ -56,14 +23,16 @@ export function createAnalytics(config?: AnalyticsConfig): Analytics {
     );
   }
 
-  if (isBackground()) return createBackgroundAnalytics(config);
+  // TODO: This only works for standard WXT extensions, add a more generic
+  // background script detector that works with non-WXT projects.
+  if (location.pathname === '/background.js')
+    return createBackgroundAnalytics(config);
 
   return createFrontendAnalytics();
 }
 
 /**
- * Creates an analytics client in the background responsible for uploading
- * events to the server to avoid CORS errors.
+ * Creates an analytics client in the background responsible for uploading events to the server to avoid CORS errors.
  */
 function createBackgroundAnalytics(
   config: AnalyticsConfig | undefined,
@@ -82,18 +51,18 @@ function createBackgroundAnalytics(
     defineStorageItem<boolean>('local:wxt-analytics:enabled', false);
 
   // Cached values
-  const platformInfo = browser.runtime.getPlatformInfo();
+  const platformInfo = chrome.runtime.getPlatformInfo();
   const userAgent = UAParser();
   let userId = Promise.resolve(userIdStorage.getValue()).then(
     (id) => id ?? globalThis.crypto.randomUUID(),
   );
   let userProperties = userPropertiesStorage.getValue();
-  const manifest = browser.runtime.getManifest();
+  const manifest = chrome.runtime.getManifest();
 
   const getBackgroundMeta = () => ({
     timestamp: Date.now(),
-    // Don't track sessions for the background, it can be running indefinitely
-    // and will inflate session duration stats.
+    // 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,
@@ -105,7 +74,7 @@ function createBackgroundAnalytics(
   const getBaseEvent = async (
     meta: AnalyticsEventMetadata,
   ): Promise<BaseAnalyticsEvent> => {
-    const { arch, os } = await platformInfo;
+    const platform = await platformInfo;
     return {
       meta,
       user: {
@@ -114,8 +83,8 @@ function createBackgroundAnalytics(
           version: config?.version ?? manifest.version_name ?? manifest.version,
           wxtMode: import.meta.env.MODE,
           wxtBrowser: import.meta.env.BROWSER,
-          arch,
-          os,
+          arch: platform.arch,
+          os: platform.os,
           browser: userAgent.browser.name,
           browserVersion: userAgent.browser.version,
           ...(await userProperties),
@@ -177,7 +146,7 @@ function createBackgroundAnalytics(
     },
     track: async (
       eventName: string,
-      eventProperties?: Record<string, string | undefined>,
+      eventProperties?: Record<string, string>,
       meta: AnalyticsEventMetadata = getBackgroundMeta(),
     ) => {
       const baseEvent = await getBaseEvent(meta);
@@ -209,10 +178,11 @@ function createBackgroundAnalytics(
     config?.providers?.map((provider) => provider(analytics, config)) ?? [];
 
   // Listen for messages from the rest of the extension
-  browser.runtime.onConnect.addListener((port) => {
+  chrome.runtime.onConnect.addListener((port) => {
     if (port.name === ANALYTICS_PORT) {
-      port.onMessage.addListener(({ fn, args }: AnalyticsMessage) => {
-        void (analytics[fn] as AnalyticsMethod)?.(...args);
+      port.onMessage.addListener(({ fn, args }) => {
+        // @ts-expect-error: Untyped fn key
+        void analytics[fn]?.(...args);
       });
     }
   });
@@ -220,23 +190,27 @@ 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 port = chrome.runtime.connect({ name: ANALYTICS_PORT });
   const sessionId = Date.now();
   const getFrontendMetadata = (): AnalyticsEventMetadata => ({
     sessionId,
     timestamp: Date.now(),
     language: navigator.language,
-    referrer: document.referrer || undefined,
-    screen: `${window.screen.width}x${window.screen.height}`,
+    referrer: globalThis.document?.referrer || undefined,
+    screen: globalThis.window
+      ? `${globalThis.window.screen.width}x${globalThis.window.screen.height}`
+      : undefined,
     url: location.href,
     title: document.title || undefined,
   });
 
-  const methodForwarder: MethodForwarder =
-    (fn) =>
-    (...args) => {
+  const methodForwarder =
+    (fn: string) =>
+    (...args: any[]) => {
       port.postMessage({ fn, args: [...args, getFrontendMetadata()] });
     };
 
@@ -247,11 +221,11 @@ function createFrontendAnalytics(): Analytics {
     setEnabled: methodForwarder('setEnabled'),
     autoTrack: (root) => {
       const onClick = (event: Event) => {
-        const element = event.target as HTMLElement | null;
+        const element = event.target as any;
         if (
           !element ||
           (!INTERACTIVE_TAGS.has(element.tagName) &&
-            !INTERACTIVE_ROLES.has(element.getAttribute('role') ?? ''))
+            !INTERACTIVE_ROLES.has(element.getAttribute('role')))
         )
           return;
 
@@ -260,7 +234,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 as HTMLAnchorElement).href,
+          href: element.href,
         });
       };
       root.addEventListener('click', onClick, { capture: true, passive: true });
@@ -272,23 +246,33 @@ function createFrontendAnalytics(): Analytics {
   return analytics;
 }
 
-function defineStorageItem<T>(key: string): AnalyticsStorageItem<T | undefined>;
 function defineStorageItem<T>(
   key: string,
-  defaultValue: T,
-): AnalyticsStorageItem<T>;
-function defineStorageItem(
-  key: string,
-  defaultValue?: unknown,
-): AnalyticsStorageItem<unknown> {
+  defaultValue?: NonNullable<T>,
+): AnalyticsStorageItem<T> {
   return {
     getValue: async () =>
-      (await browser.storage.local.get<Record<string, unknown>>(key))[key] ??
-      defaultValue,
-    setValue: (newValue) => browser.storage.local.set({ [key]: newValue }),
+      (await chrome.storage.local.get(key))[key] ?? defaultValue,
+    setValue: (newValue) => chrome.storage.local.set({ [key]: newValue }),
   };
 }
 
+const INTERACTIVE_TAGS = new Set([
+  'A',
+  'BUTTON',
+  'INPUT',
+  'SELECT',
+  'TEXTAREA',
+]);
+const INTERACTIVE_ROLES = new Set([
+  'button',
+  'link',
+  'checkbox',
+  'menuitem',
+  'tab',
+  'radio',
+]);
+
 export function defineAnalyticsProvider<T = never>(
   definition: (
     /** The analytics object. */

packages/analytics/modules/analytics/index.ts

@@ -8,7 +8,6 @@ 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 {
@@ -23,10 +22,10 @@ export default defineWxtModule({
     // Paths
     const wxtAnalyticsFolder = resolve(wxt.config.wxtDir, 'analytics');
     const wxtAnalyticsIndex = resolve(wxtAnalyticsFolder, 'index.ts');
-    const clientModuleId = process.env.NPM
+    const clientModuleId = import.meta.env.NPM
       ? '@wxt-dev/analytics'
       : resolve(wxt.config.modulesDir, 'analytics/client');
-    const pluginModuleId = process.env.NPM
+    const pluginModuleId = import.meta.env.NPM
       ? '@wxt-dev/analytics/background-plugin'
       : resolve(wxt.config.modulesDir, 'analytics/background-plugin');
 
@@ -39,15 +38,17 @@ export default defineWxtModule({
     });
 
     // Generate #analytics module
-    const wxtAnalyticsCode = `import { createAnalytics } from '${
-      process.env.NPM
-        ? clientModuleId
-        : normalizePath(relative(wxtAnalyticsFolder, clientModuleId))
-    }';
-import { useAppConfig } from '#imports';
-
-export const analytics = createAnalytics(useAppConfig().analytics);
-`;
+    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');
     addAlias(wxt, '#analytics', wxtAnalyticsIndex);
     wxt.hook('prepare:types', async (_, entries) => {
       entries.push({

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

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

packages/analytics/modules/analytics/types.ts

@@ -2,45 +2,39 @@ export interface Analytics {
   /** Report a page change. */
   page: (url: string) => void;
   /** Report a custom event. */
-  track: (
-    eventName: string,
-    eventProperties?: Record<string, string | undefined>,
-  ) => void;
+  track: (eventName: string, eventProperties?: Record<string, string>) => void;
   /** Save information about the user. */
   identify: (userId: string, userProperties?: Record<string, string>) => void;
-  /**
-   * Automatically setup and track user interactions, returning a function to
-   * remove any listeners that were setup.
-   */
+  /** 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 | undefined>;
+  userId?: AnalyticsStorageItem<string>;
   /**
-   * 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>>;
 }
@@ -100,6 +94,6 @@ export interface AnalyticsPageViewEvent extends BaseAnalyticsEvent {
 export interface AnalyticsTrackEvent extends BaseAnalyticsEvent {
   event: {
     name: string;
-    properties?: Record<string, string | undefined>;
+    properties?: Record<string, string>;
   };
 }

packages/analytics/package.json

@@ -1,36 +1,14 @@
 {
   "name": "@wxt-dev/analytics",
-  "version": "0.5.4",
+  "version": "0.4.1",
   "description": "Add analytics to your web extension",
-  "type": "module",
-  "scripts": {
-    "dev": "buildc --deps-only -- wxt",
-    "dev:build": "buildc --deps-only -- wxt build",
-    "check": "pnpm build && check",
-    "build": "buildc -- tsdown",
-    "prepack": "pnpm -s build",
-    "prepare": "buildc --deps-only -- wxt prepare"
-  },
-  "dependencies": {
-    "@wxt-dev/browser": "workspace:^",
-    "@wxt-dev/is-background": "workspace:^",
-    "ua-parser-js": "^1.0.40"
-  },
-  "peerDependencies": {
-    "wxt": ">=0.20.0"
-  },
-  "devDependencies": {
-    "@types/ua-parser-js": "^0.7.39",
-    "publint": "^0.3.18",
-    "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",
@@ -57,8 +35,31 @@
     }
   },
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist"
-  ]
+  ],
+  "scripts": {
+    "dev": "buildc --deps-only -- wxt",
+    "dev:build": "buildc --deps-only -- wxt build",
+    "check": "pnpm build && check",
+    "build": "buildc -- unbuild",
+    "prepack": "pnpm -s build",
+    "prepare": "buildc --deps-only -- wxt prepare"
+  },
+  "peerDependencies": {
+    "wxt": ">=0.20.0"
+  },
+  "devDependencies": {
+    "@aklinker1/check": "catalog:",
+    "@types/chrome": "catalog:",
+    "@types/ua-parser-js": "catalog:",
+    "publint": "catalog:",
+    "typescript": "catalog:",
+    "unbuild": "catalog:",
+    "wxt": "workspace:*"
+  },
+  "dependencies": {
+    "ua-parser-js": "catalog:"
+  }
 }

packages/analytics/tsconfig.json

@@ -3,7 +3,8 @@
   "compilerOptions": {
     "paths": {
       "#analytics": ["./.wxt/analytics/index.ts"]
-    }
+    },
+    "types": ["chrome"]
   },
   "exclude": ["node_modules", "dist"]
 }

packages/analytics/tsdown.config.ts

@@ -1,17 +0,0 @@
-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',
-  },
-  external: ['#analytics'],
-  define: {
-    'process.env.NPM': 'true',
-  },
-});

packages/auto-icons/CHANGELOG.md

@@ -1,66 +1,5 @@
 # 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)
-
-### 🚀 Enhancements
-
-- Add overlay option for dev icons ([#1825](https://github.com/wxt-dev/wxt/pull/1825))
-
-### 📖 Documentation
-
-- Rewrite and restructure the documentation website ([#933](https://github.com/wxt-dev/wxt/pull/933))
-- Use full URLs in README so they work on the docs site ([d20793d5](https://github.com/wxt-dev/wxt/commit/d20793d5))
-- Add SVG compatibility note ([#1830](https://github.com/wxt-dev/wxt/pull/1830))
-
-### 🏡 Chore
-
-- Add  `oxlint` for linting ([#947](https://github.com/wxt-dev/wxt/pull/947))
-- **deps:** Bump sharp from 0.33.4 to 0.33.5 ([#959](https://github.com/wxt-dev/wxt/pull/959))
-- Upgrade all non-major dependencies ([#1040](https://github.com/wxt-dev/wxt/pull/1040))
-- **deps:** Upgrade all non-major dependencies ([#1164](https://github.com/wxt-dev/wxt/pull/1164))
-- **deps:** Bump dev and non-breaking major dependencies ([#1167](https://github.com/wxt-dev/wxt/pull/1167))
-- 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))
-
-### ❤️ Contributors
-
-- Typed SIGTERM ([@typed-sigterm](https://github.com/typed-sigterm))
-- Kuba ([@zizzfizzix](https://github.com/zizzfizzix))
-- Aaron ([@aklinker1](https://github.com/aklinker1))
-
 ## v1.0.2
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/auto-icons-v1.0.1...auto-icons-v1.0.2)

packages/auto-icons/README.md

@@ -5,8 +5,7 @@
 ## Features
 
 - Generate extension icons with the correct sizes
-- Make the icon greyscale or include a visible overlay during development
-- SVG is supported
+- Make the icon greyscale during development
 
 ## Usage
 

packages/auto-icons/package.json

@@ -24,10 +24,10 @@
     }
   ],
   "license": "MIT",
-  "version": "1.1.1",
+  "version": "1.0.2",
   "type": "module",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -38,23 +38,23 @@
     "dist"
   ],
   "scripts": {
-    "build": "buildc -- tsdown",
-    "check": "pnpm build && check",
-    "test": "buildc --deps-only -- vitest"
+    "build": "buildc -- unbuild",
+    "check": "pnpm build && check"
   },
   "peerDependencies": {
     "wxt": ">=0.19.0"
   },
   "dependencies": {
-    "defu": "^6.1.4",
-    "fs-extra": "^11.3.4",
-    "sharp": "^0.34.5"
+    "defu": "catalog:",
+    "fs-extra": "catalog:",
+    "sharp": "catalog:"
   },
   "devDependencies": {
-    "oxlint": "^1.51.0",
-    "publint": "^0.3.18",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
+    "@aklinker1/check": "catalog:",
+    "oxlint": "catalog:",
+    "publint": "catalog:",
+    "typescript": "catalog:",
+    "unbuild": "catalog:",
     "wxt": "workspace:*"
   }
 }

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

@@ -1,629 +0,0 @@
-import { describe, it, expect, vi, beforeEach, Mock } from 'vitest';
-import { resolve } from 'node:path';
-import * as fsExtra from 'fs-extra';
-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('fs-extra', () => ({
-  ensureDir: vi.fn(),
-  pathExists: 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(fsExtra.pathExists).mockResolvedValue(true as any);
-    vi.mocked(fsExtra.ensureDir).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(fsExtra.pathExists).mockResolvedValue(false as any);
-
-      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(fsExtra.ensureDir).toHaveBeenCalledWith(
-        resolve('/mock/dist', 'icons'),
-      );
-
-      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(fsExtra.ensureDir).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(fsExtra.ensureDir).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, pathExists } from 'fs-extra';
+import { ensureDir, exists } from 'fs-extra';
 
 export default defineWxtModule<AutoIconsOptions>({
   name: '@wxt-dev/auto-icons',
@@ -14,30 +14,17 @@ export default defineWxtModule<AutoIconsOptions>({
       {
         enabled: true,
         baseIconPath: resolve(wxt.config.srcDir, 'assets/icon.png'),
-        developmentIndicator: 'grayscale',
+        grayscaleOnDevelopment: true,
         sizes: [128, 48, 32, 16],
       },
     );
 
-    // Backward compatibility for the deprecated option
-    if (options?.grayscaleOnDevelopment !== undefined) {
-      wxt.logger.warn(
-        '`[auto-icons]` "grayscaleOnDevelopment" is deprecated. Use "developmentIndicator" instead.',
-      );
-
-      if (options?.developmentIndicator === undefined) {
-        parsedOptions.developmentIndicator = options!.grayscaleOnDevelopment
-          ? 'grayscale'
-          : false;
-      }
-    }
-
     const resolvedPath = resolve(wxt.config.srcDir, parsedOptions.baseIconPath);
 
     if (!parsedOptions.enabled)
       return wxt.logger.warn(`\`[auto-icons]\` ${this.name} disabled`);
 
-    if (!(await pathExists(resolvedPath))) {
+    if (!(await exists(resolvedPath))) {
       return wxt.logger.warn(
         `\`[auto-icons]\` Skipping icon generation, no base icon found at ${relative(process.cwd(), resolvedPath)}`,
       );
@@ -45,7 +32,7 @@ export default defineWxtModule<AutoIconsOptions>({
 
     wxt.hooks.hook('build:manifestGenerated', async (wxt, manifest) => {
       if (manifest.icons)
-        wxt.logger.warn(
+        return wxt.logger.warn(
           '`[auto-icons]` icons property found in manifest, overwriting with auto-generated icons',
         );
 
@@ -55,44 +42,21 @@ export default defineWxtModule<AutoIconsOptions>({
     });
 
     wxt.hooks.hook('build:done', async (wxt, output) => {
+      const image = sharp(resolvedPath).png();
+
+      if (
+        wxt.config.mode === 'development' &&
+        parsedOptions.grayscaleOnDevelopment
+      ) {
+        image.grayscale();
+      }
+
       const outputFolder = wxt.config.outDir;
 
       for (const size of parsedOptions.sizes) {
-        const resizedImage = sharp(resolvedPath).resize(size).png();
-
-        if (wxt.config.mode === 'development') {
-          if (parsedOptions.developmentIndicator === 'grayscale') {
-            resizedImage.grayscale();
-          } else if (parsedOptions.developmentIndicator === 'overlay') {
-            // Helper to build an overlay that places a yellow rectangle at the bottom
-            // of the icon with the text "DEV" in black. The overlay has the same
-            // dimensions as the icon so we can composite it with default gravity.
-            const buildDevOverlay = (size: number) => {
-              const rectHeight = Math.round(size * 0.5);
-              const fontSize = Math.round(size * 0.35);
-
-              return Buffer.from(`<?xml version="1.0" encoding="UTF-8"?>
-                <svg width="${size}" height="${size}" viewBox="0 0 ${size} ${size}" xmlns="http://www.w3.org/2000/svg">
-                  <rect x="0" y="${size - rectHeight}" width="${size}" height="${rectHeight}" fill="#ffff00" />
-                  <text x="${size / 2}" y="${size - rectHeight / 2}" font-family="Arial, Helvetica, sans-serif" font-size="${fontSize}" font-weight="bold" fill="black" text-anchor="middle" dominant-baseline="middle">DEV</text>
-                </svg>`);
-            };
-            const overlayBuffer = await sharp(buildDevOverlay(size))
-              .png()
-              .toBuffer();
-
-            resizedImage.composite([
-              {
-                input: overlayBuffer,
-                left: 0,
-                top: 0,
-              },
-            ]);
-          }
-        }
-
+        const resized = image.resize(size);
         ensureDir(resolve(outputFolder, 'icons'));
-        await resizedImage.toFile(resolve(outputFolder, `icons/${size}.png`));
+        await resized.toFile(resolve(outputFolder, `icons/${size}.png`));
 
         output.publicAssets.push({
           type: 'asset',
@@ -109,11 +73,12 @@ 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;
@@ -121,30 +86,16 @@ 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.
-   *
-   * @default 'grayscale'
-   */
-  developmentIndicator?: 'grayscale' | 'overlay' | false;
   /**
    * Grayscale the image when in development mode to indicate development
-   *
-   * @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

@@ -1,8 +0,0 @@
-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.37",
+  "version": "0.0.310",
   "type": "module",
   "main": "src/index.mjs",
   "types": "src/index.d.ts",
@@ -11,7 +11,6 @@
     "directory": "packages/browser"
   },
   "scripts": {
-    "check": "check",
     "gen": "tsx scripts/generate.ts"
   },
   "author": {
@@ -23,11 +22,11 @@
     "src"
   ],
   "devDependencies": {
-    "@types/chrome": "0.1.37",
-    "fs-extra": "^11.3.4",
-    "nano-spawn": "^2.0.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "@types/chrome": "0.0.310",
+    "fs-extra": "catalog:",
+    "nano-spawn": "catalog:",
+    "tsx": "catalog:",
+    "vitest": "catalog:"
   },
   "dependencies": {
     "@types/filesystem": "*",

packages/browser/scripts/generate.ts

@@ -7,7 +7,7 @@ import { sep as posixSep } from 'node:path/posix';
 // 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']);
+await spawn('pnpm', ['i', '--ignore-scripts', '-D', '@types/chrome']);
 
 // Generate new package.json
 
@@ -60,7 +60,9 @@ for (const { file, srcPath, destPath } of declarationFileMapping) {
 
 // Done!
 
-console.log('\x1b[32m✔\x1b[0m Done in ' + performance.now().toFixed(0) + ' ms');
+console.log(
+  '\x1b[32m✔\x1b[0m Done in ' + performance.now().toFixed(0) + ' ms',
+);
 
 // Transformations
 
@@ -74,7 +76,5 @@ function transformFile(file: string, content: string): string {
       .replaceAll('declare namespace chrome', 'export namespace Browser')
       // Update references to `chrome` namespace to `Browser`
       .replaceAll('chrome.', 'Browser.')
-      // Fix links to developer.chrome.com
-      .replaceAll('developer.Browser.com', 'developer.chrome.com')
   );
 }

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>().toEqualTypeOf<chrome.runtime.MessageSender>();
-      expectTypeOf<Browser.storage.AreaName>().toEqualTypeOf<chrome.storage.AreaName>();
-      expectTypeOf<Browser.i18n.LanguageDetectionResult>().toEqualTypeOf<chrome.i18n.LanguageDetectionResult>();
+      expectTypeOf<Browser.runtime.MessageSender>().toMatchTypeOf<chrome.runtime.MessageSender>();
+      expectTypeOf<Browser.storage.AreaName>().toMatchTypeOf<chrome.storage.AreaName>();
+      expectTypeOf<Browser.i18n.LanguageDetectionResult>().toMatchTypeOf<chrome.i18n.LanguageDetectionResult>();
     });
 
     it('should provide values via the browser import', () => {
-      expectTypeOf(browser.runtime.id).toEqualTypeOf<string>();
+      expectTypeOf(browser.runtime.id).toMatchTypeOf<string>();
       expectTypeOf(
         browser.storage.local,
-      ).toEqualTypeOf<Browser.storage.LocalStorageArea>();
+      ).toMatchTypeOf<Browser.storage.StorageArea>();
       expectTypeOf(
-        browser.i18n.detectLanguage,
-      ).returns.resolves.toEqualTypeOf<chrome.i18n.LanguageDetectionResult>();
+        browser.i18n.detectLanguage('Hello, world!'),
+      ).resolves.toMatchTypeOf<chrome.i18n.LanguageDetectionResult>();
     });
   });
 });

packages/browser/src/gen/chrome-cast/index.d.ts

@@ -1,6 +1,5 @@
 /* DO NOT EDIT - generated by scripts/generate.ts */
 
-/* eslint-disable @typescript-eslint/no-wrapper-object-types */
 export namespace Browser {
     ////////////////////
     // Cast
@@ -113,7 +112,7 @@ export namespace Browser {
          */
         export function initialize(
             apiConfig: Browser.cast.ApiConfig,
-            successCallback: () => void,
+            successCallback: Function,
             errorCallback: (error: Browser.cast.Error) => void,
         ): void;
 
@@ -161,7 +160,7 @@ export namespace Browser {
          */
         export function setCustomReceivers(
             receivers: Browser.cast.Receiver[],
-            successCallback: () => void,
+            successCallback: Function,
             errorCallback: (error: Browser.cast.Error) => void,
         ): void;
 
@@ -172,7 +171,7 @@ export namespace Browser {
          */
         export function setReceiverDisplayStatus(
             receiver: Browser.cast.Receiver,
-            successCallback: () => void,
+            successCallback: Function,
             errorCallback: (error: Browser.cast.Error) => void,
         ): void;
 
@@ -295,7 +294,7 @@ export namespace Browser {
              */
             setReceiverVolumeLevel(
                 newLevel: number,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -306,7 +305,7 @@ export namespace Browser {
              */
             setReceiverMuted(
                 muted: boolean,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -314,13 +313,13 @@ export namespace Browser {
              * @param successCallback
              * @param errorCallback
              */
-            leave(successCallback: () => void, errorCallback: (error: Browser.cast.Error) => void): void;
+            leave(successCallback: Function, errorCallback: (error: Browser.cast.Error) => void): void;
 
             /**
              * @param successCallback
              * @param errorCallback
              */
-            stop(successCallback: () => void, errorCallback: (error: Browser.cast.Error) => void): void;
+            stop(successCallback: Function, errorCallback: (error: Browser.cast.Error) => void): void;
 
             /**
              * @param namespace
@@ -331,7 +330,7 @@ export namespace Browser {
             sendMessage(
                 namespace: string,
                 message: string | object,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -888,7 +887,7 @@ export namespace Browser {
              */
             getStatus(
                 getStatusRequest: Browser.cast.media.GetStatusRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -899,7 +898,7 @@ export namespace Browser {
              */
             play(
                 playRequest: Browser.cast.media.PlayRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -910,7 +909,7 @@ export namespace Browser {
              */
             pause(
                 pauseRequest: Browser.cast.media.PauseRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -921,7 +920,7 @@ export namespace Browser {
              */
             seek(
                 seekRequest: Browser.cast.media.SeekRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -932,7 +931,7 @@ export namespace Browser {
              */
             stop(
                 stopRequest: Browser.cast.media.StopRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -943,7 +942,7 @@ export namespace Browser {
              */
             setVolume(
                 volumeRequest: Browser.cast.media.VolumeRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -954,7 +953,7 @@ export namespace Browser {
              */
             editTracksInfo(
                 editTracksInfoRequest: Browser.cast.media.EditTracksInfoRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -987,7 +986,7 @@ export namespace Browser {
              */
             queueAppendItem(
                 item: Browser.cast.media.QueueItem,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -998,7 +997,7 @@ export namespace Browser {
              */
             queueInsertItems(
                 queueInsertItemsRequest: Browser.cast.media.QueueInsertItemsRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -1009,7 +1008,7 @@ export namespace Browser {
              */
             queueJumpToItem(
                 itemId: number,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -1022,7 +1021,7 @@ export namespace Browser {
             queueMoveItemToNewIndex(
                 itemId: number,
                 newIndex: number,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -1030,13 +1029,13 @@ export namespace Browser {
              * @param successCallback
              * @param errorCallback
              */
-            queueNext(successCallback: () => void, errorCallback: (error: Browser.cast.Error) => void): void;
+            queueNext(successCallback: Function, errorCallback: (error: Browser.cast.Error) => void): void;
 
             /**
              * @param successCallback
              * @param errorCallback
              */
-            queuePrev(successCallback: () => void, errorCallback: (error: Browser.cast.Error) => void): void;
+            queuePrev(successCallback: Function, errorCallback: (error: Browser.cast.Error) => void): void;
 
             /**
              * @param itemId
@@ -1045,7 +1044,7 @@ export namespace Browser {
              */
             queueRemoveItem(
                 itemId: number,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -1056,7 +1055,7 @@ export namespace Browser {
              */
             queueReorderItems(
                 queueReorderItemsRequest: Browser.cast.media.QueueReorderItemsRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -1067,7 +1066,7 @@ export namespace Browser {
              */
             queueSetRepeatMode(
                 repeatMode: Browser.cast.media.RepeatMode,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
 
@@ -1078,7 +1077,7 @@ export namespace Browser {
              */
             queueUpdateItems(
                 queueUpdateItemsRequest: Browser.cast.media.QueueUpdateItemsRequest,
-                successCallback: () => void,
+                successCallback: Function,
                 errorCallback: (error: Browser.cast.Error) => void,
             ): void;
         }

packages/browser/templates/package.json

@@ -11,7 +11,6 @@
     "directory": "packages/browser"
   },
   "scripts": {
-    "check": "check",
     "gen": "tsx scripts/generate.ts"
   },
   "author": {
@@ -24,9 +23,9 @@
   ],
   "devDependencies": {
     "@types/chrome": "{{chromeTypesVersion}}",
-    "fs-extra": "^11.3.4",
-    "nano-spawn": "^2.0.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "fs-extra": "catalog:",
+    "nano-spawn": "catalog:",
+    "tsx": "catalog:",
+    "vitest": "catalog:"
   }
 }

packages/browser/tsconfig.json

@@ -1,4 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {}
-}

packages/i18n/CHANGELOG.md

@@ -1,62 +1,5 @@
 # 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)
-
-### 🩹 Fixes
-
-- Standardize locale codes and warn about unsupported ones ([#1617](https://github.com/wxt-dev/wxt/pull/1617))
-- Use `@wxt-dev/browser` instead of `@types/chrome` ([#1645](https://github.com/wxt-dev/wxt/pull/1645))
-
-### 📖 Documentation
-
-- Add react language ID to README ([#1347](https://github.com/wxt-dev/wxt/pull/1347))
-- Fix public path reference ([bcb20874](https://github.com/wxt-dev/wxt/commit/bcb20874))
-
-### 🏡 Chore
-
-- **deps:** Upgrade all non-major dependencies ([#1164](https://github.com/wxt-dev/wxt/pull/1164))
-- **deps:** Bump dev and non-breaking major dependencies ([#1167](https://github.com/wxt-dev/wxt/pull/1167))
-- 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))
-- Change browser workspace dependency to `^` ([c7335add](https://github.com/wxt-dev/wxt/commit/c7335add))
-
-### ❤️ Contributors
-
-- Aaron ([@aklinker1](https://github.com/aklinker1))
-- Okinea Dev ([@okineadev](https://github.com/okineadev))
-- Redwoodlid ([@redwoodlid](https://github.com/redwoodlid))
-
 ## v0.2.3
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/i18n-v0.2.2...i18n-v0.2.3)

packages/i18n/README.md

@@ -6,7 +6,7 @@
 
 1. Simple messages file format
 2. Plural form support
-3. Integrates with the [I18n Ally VS Code extension](#vs-code)
+3. Integrates with the [I18n Ally VS Code extension](#vscode)
 
 It also provides several benefits over other non-web extension specific i18n packages:
 
@@ -81,7 +81,7 @@ And you're done! Using WXT, you get type-safety out of the box.
 
    > [!NOTE]
    > For the best DX, you should to integrate `@wxt-dev/i18n` into your build process. This enables:
-   >
+
    > 1. Plural forms
    > 2. Simple messages file format
    > 3. Type safety

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.5",
+  "version": "0.2.3",
   "type": "module",
   "repository": {
     "type": "git",
@@ -21,15 +21,14 @@
   "license": "MIT",
   "funding": "https://github.com/sponsors/wxt-dev",
   "scripts": {
-    "build": "buildc -- tsdown",
+    "build": "buildc -- unbuild",
     "check": "buildc --deps-only -- check",
     "test": "buildc --deps-only -- vitest"
   },
   "dependencies": {
-    "@wxt-dev/browser": "workspace:^",
-    "chokidar": "^5.0.0",
-    "confbox": "^0.2.4",
-    "tinyglobby": "^0.2.15"
+    "chokidar": "catalog:",
+    "confbox": "catalog:",
+    "fast-glob": "catalog:"
   },
   "peerDependencies": {
     "wxt": ">=0.19.7"
@@ -40,17 +39,20 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^20.17.6",
-    "oxlint": "^1.51.0",
-    "publint": "^0.3.18",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
-    "vitest-plugin-random-seed": "^1.1.2",
+    "@aklinker1/check": "catalog:",
+    "@types/chrome": "catalog:",
+    "@types/node": "catalog:",
+    "oxlint": "catalog:",
+    "publint": "catalog:",
+    "typescript": "catalog:",
+    "unbuild": "catalog:",
+    "vitest": "catalog:",
+    "vitest-plugin-random-seed": "catalog:",
     "wxt": "workspace:*"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "import": {

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

@@ -1,18 +1,13 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { createI18n } from '../index';
-import { browser } from '@wxt-dev/browser';
 
-vi.mock('@wxt-dev/browser', async () => {
-  const { vi } = await import('vitest');
-  return {
-    browser: {
-      i18n: {
-        getMessage: vi.fn(),
-      },
-    },
-  };
+const getMessageMock = vi.fn();
+
+vi.stubGlobal('chrome', {
+  i18n: {
+    getMessage: getMessageMock,
+  },
 });
-const getMessageMock = vi.mocked(browser.i18n.getMessage);
 
 describe('createI18n', () => {
   beforeEach(() => {

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

@@ -1,18 +1,13 @@
 import { beforeEach, describe, it, vi } from 'vitest';
 import { createI18n } from '..';
-import { browser } from '@wxt-dev/browser';
 
-vi.mock('@wxt-dev/browser', async () => {
-  const { vi } = await import('vitest');
-  return {
-    browser: {
-      i18n: {
-        getMessage: vi.fn(),
-      },
-    },
-  };
+const getMessageMock = vi.fn();
+
+vi.stubGlobal('chrome', {
+  i18n: {
+    getMessage: getMessageMock,
+  },
 });
-const getMessageMock = vi.mocked(browser.i18n.getMessage);
 
 const n: number = 1;
 

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

@@ -1,14 +1,10 @@
 import { describe, it, expect } from 'vitest';
 import { ChromeMessage } from '../build';
-import {
-  applyChromeMessagePlaceholders,
-  getSubstitutionCount,
-  standardizeLocale,
-} from '../utils';
+import { applyChromeMessagePlaceholders, getSubstitutionCount } from '../utils';
 
 describe('Utils', () => {
   describe('applyChromeMessagePlaceholders', () => {
-    it('should return the combined string', () => {
+    it('should return the combined stirng', () => {
       const input = {
         message: 'Hello $username$, welcome to $appName$',
         placeholders: {
@@ -64,30 +60,4 @@ describe('Utils', () => {
       expect(getSubstitutionCount('Hello $10')).toBe(1);
     });
   });
-
-  describe('standardizeLocale', () => {
-    it('should convert two-letter locale codes to lowercase', () => {
-      expect(standardizeLocale('en')).toEqual('en');
-      expect(standardizeLocale('EN')).toEqual('en');
-    });
-
-    it('should convert locale code extensions to uppercase', () => {
-      expect(standardizeLocale('en_US')).toEqual('en_US');
-      expect(standardizeLocale('en_us')).toEqual('en_US');
-      expect(standardizeLocale('es_419')).toEqual('es_419');
-    });
-
-    it('should convert dashes to underscores', () => {
-      expect(standardizeLocale('en_US')).toEqual('en_US');
-      expect(standardizeLocale('en-US')).toEqual('en_US');
-    });
-
-    it('should return the input string as-is for unknown formats', () => {
-      expect(standardizeLocale('en_USSS')).toEqual('en_USSS');
-      expect(standardizeLocale('en-')).toEqual('en-');
-      expect(standardizeLocale('------')).toEqual('------');
-      expect(standardizeLocale('test')).toEqual('test');
-      expect(standardizeLocale('hello-world')).toEqual('hello-world');
-    });
-  });
 });

packages/i18n/src/build.ts

@@ -10,8 +10,6 @@ import { parseYAML, parseJSON5, parseTOML } from 'confbox';
 import { dirname, extname } from 'node:path';
 import { applyChromeMessagePlaceholders, getSubstitutionCount } from './utils';
 
-export { SUPPORTED_LOCALES } from './supported-locales';
-
 //
 // TYPES
 //
@@ -51,8 +49,7 @@ 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': {
@@ -111,7 +108,9 @@ 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[]> {
@@ -120,7 +119,9 @@ export async function parseMessagesFile(
   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',
@@ -128,7 +129,9 @@ export function parseMessagesText(
   return parseMessagesObject(PARSERS[format](text));
 }
 
-/** Given the JS object form of a raw messages file, extract the messages. */
+/**
+ * Given the JS object form of a raw messages file, extract the messages.
+ */
 export function parseMessagesObject(object: any): ParsedMessage[] {
   return _parseMessagesObject(
     [],

packages/i18n/src/index.ts

@@ -1,11 +1,12 @@
-/** @module @wxt-dev/i18n */
+/**
+ * @module @wxt-dev/i18n
+ */
 import {
   I18nStructure,
   DefaultI18nStructure,
   I18n,
   Substitution,
 } from './types';
-import { browser } from '@wxt-dev/browser';
 
 export function createI18n<
   T extends I18nStructure = DefaultI18nStructure,
@@ -38,9 +39,9 @@ export function createI18n<
     if (sub?.length) {
       // Convert all substitutions to strings
       const stringSubs = sub?.map((sub) => String(sub));
-      message = browser.i18n.getMessage(key.replaceAll('.', '_'), stringSubs);
+      message = chrome.i18n.getMessage(key.replaceAll('.', '_'), stringSubs);
     } else {
-      message = browser.i18n.getMessage(key.replaceAll('.', '_'));
+      message = chrome.i18n.getMessage(key.replaceAll('.', '_'));
     }
     if (!message) {
       console.warn(`[i18n] Message not found: "${key}"`);

packages/i18n/src/module.ts

@@ -3,7 +3,7 @@
  *
  * ```ts
  * export default defineConfig({
- *   modules: ['@wxt-dev/i18n/module'],
+ *   modules: ["@wxt-dev/i18n/module"],
  * });
  * ```
  *
@@ -16,14 +16,12 @@ import {
   generateChromeMessagesText,
   parseMessagesFile,
   generateTypeText,
-  SUPPORTED_LOCALES,
 } from './build';
-import { glob } from 'tinyglobby';
+import glob from 'fast-glob';
 import { basename, extname, join, resolve } from 'node:path';
 import { watch } from 'chokidar';
 import { GeneratedPublicFile, WxtDirFileEntry } from 'wxt';
 import { writeFile } from 'node:fs/promises';
-import { standardizeLocale } from './utils';
 
 export default defineWxtModule<I18nOptions>({
   name: '@wxt-dev/i18n',
@@ -44,27 +42,14 @@ export default defineWxtModule<I18nOptions>({
       options ?? {};
 
     const getLocalizationFiles = async () => {
-      const files = await glob('*.{json,json5,jsonc,yml,yaml,toml}', {
+      const files = await glob('*.{json,json5,yml,yaml,toml}', {
         cwd: localesDir,
         absolute: true,
-        expandDirectories: false,
       });
-
-      const unsupportedLocales: string[] = [];
-
-      const res = files.map((file) => {
-        const rawLocale = basename(file).replace(extname(file), '');
-        const locale = standardizeLocale(rawLocale);
-        if (!SUPPORTED_LOCALES.has(locale)) unsupportedLocales.push(locale);
-        return { file, locale };
-      });
-
-      if (unsupportedLocales.length > 0)
-        wxt.logger.warn(
-          `Unsupported locales: [${unsupportedLocales.join(', ')}].\n\nWeb extensions only support a limited set of locales as described here: https://developer.chrome.com/docs/extensions/reference/api/i18n#locales`,
-        );
-
-      return res;
+      return files.map((file) => ({
+        file,
+        locale: basename(file).replace(extname(file), ''),
+      }));
     };
 
     const generateOutputJsonFiles = async (): Promise<
@@ -89,7 +74,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|jsonc|yml|yaml|toml}\``,
+          `\`[i18n]\` Required localization file does not exist: \`<localesDir>/${wxt.config.manifest.default_locale}.{json|json5|yml|yaml|toml}\``,
         );
       }
 
@@ -181,12 +166,13 @@ 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/supported-locales.ts

@@ -1,58 +0,0 @@
-/** From https://developer.chrome.com/docs/extensions/reference/api/i18n#locales */
-export const SUPPORTED_LOCALES = new Set([
-  'ar',
-  'am',
-  'bg',
-  'bn',
-  'ca',
-  'cs',
-  'da',
-  'de',
-  'el',
-  'en',
-  'en_AU',
-  'en_GB',
-  'en_US',
-  'es',
-  'es_419',
-  'et',
-  'fa',
-  'fi',
-  'fil',
-  'fr',
-  'gu',
-  'he',
-  'hi',
-  'hr',
-  'hu',
-  'id',
-  'it',
-  'ja',
-  'kn',
-  'ko',
-  'lt',
-  'lv',
-  'ml',
-  'mr',
-  'ms',
-  'nl',
-  'no',
-  'pl',
-  'pt_BR',
-  'pt_PT',
-  'ro',
-  'ru',
-  'sk',
-  'sl',
-  'sr',
-  'sv',
-  'sw',
-  'ta',
-  'te',
-  'th',
-  'tr',
-  'uk',
-  'vi',
-  'zh_CN',
-  'zh_TW',
-]);

packages/i18n/src/utils.ts

@@ -21,16 +21,3 @@ export function getSubstitutionCount(message: string): number {
 }
 
 const MAX_SUBSTITUTIONS = 9;
-
-/** Given a string, standardize it to the format `xx_YY`. */
-export function standardizeLocale(locale: string): string {
-  if (locale.length === 2) return locale.toLowerCase();
-
-  const [is_match, prefix, suffix] =
-    locale.match(/^([a-z]{2})[-_]([a-z]{2,3})$/i) ?? [];
-  if (is_match) {
-    return `${prefix.toLowerCase()}_${suffix.toUpperCase()}`;
-  }
-
-  return locale;
-}

packages/i18n/tsconfig.json

@@ -1,7 +1,7 @@
 {
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "types": ["node"]
+    "types": ["chrome", "node"]
   },
   "exclude": ["node_modules/**", "dist/**"]
 }

packages/i18n/tsdown.config.ts

@@ -1,13 +0,0 @@
-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

@@ -1,17 +0,0 @@
-# `@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

@@ -1,56 +0,0 @@
-{
-  "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": "pnpm build && check",
-    "test": "buildc --deps-only -- vitest",
-    "test:coverage": "pnpm test run --coverage",
-    "prepack": "pnpm 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

@@ -1,145 +0,0 @@
-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

@@ -1,32 +0,0 @@
-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

@@ -1,31 +0,0 @@
-/**
- * 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

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

packages/module-react/CHANGELOG.md

@@ -1,65 +1,5 @@
 # Changelog
 
-## 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

@@ -0,0 +1,12 @@
+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,16 +1,15 @@
 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, vitePluginsBefore } = options ?? {};
+    const { vite } = options ?? {};
 
     addViteConfig(wxt, () => ({
-      plugins: [...(vitePluginsBefore ?? []), react(vite)],
+      plugins: [react(vite)],
     }));
 
     addImportPreset(wxt, 'react');
@@ -31,12 +30,6 @@ 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' {