chore(release): v0.18.2

Signed-off-by: Emmanuel Ferdman <emmanuelferdman@gmail.com>

.github/workflows/sync-releases.yml

@@ -20,3 +20,4 @@ jobs:
           node-version: 18
           cache: pnpm
       - run: pnpm sync-releases all --token ${{ secrets.GITHUB_TOKEN }}
+        working-directory: packages/wxt

README.md

@@ -0,0 +1,70 @@
+<h1 align="center">
+  <img style="vertical-align:middle" width="44" src="./docs/public/hero-logo.svg" alt="WXT Logo">
+  <span>WXT</span>
+</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/wxt" target="_blank"><img alt="npm" 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="npm" 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="NPM" 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="Codecov" src="https://img.shields.io/codecov/c/github/wxt-dev/wxt?labelColor=black&color=%234fa048"></a>
+</p>
+
+<p align="center">
+  <span>Next-gen framework for developing web extensions.</span>
+  <br/>
+  <span>⚡</span>
+  <br/>
+  <q><i>It's like Nuxt, but for Chrome Extensions</i></q>
+</p>
+
+<p align="center">
+  <a href="https://wxt.dev" target="_blank">Get Started</a>
+  &bull;
+  <a href="https://wxt.dev/guide/installation.html" target="_blank">Installation</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://discord.gg/ZFsZqGery9" target="_blank">Discord</a>
+</p>
+
+![Example CLI Output](./docs/assets/cli-output.png)
+
+## Demo
+
+https://github.com/wxt-dev/wxt/assets/10101283/4d678939-1bdb-495c-9c36-3aa281d84c94
+
+## Quick Start
+
+Bootstrap a new project:
+
+```sh
+pnpm dlx wxt@latest init <project-name>
+```
+
+Or see the [installation guide](https://wxt.dev/guide/installation.html) to get started with WXT.
+
+## Features
+
+- 🌐 Supports all browsers
+- ✅ Supports both MV2 and MV3
+- ⚡ Dev mode with HMR & fast reload
+- 📂 File based entrypoints
+- 🚔 TypeScript
+- 🦾 Auto-imports
+- 🤖 Automated publishing
+- 🎨 Frontend framework agnostic: works with Vue, React, Svelte, etc
+- 🖍️ Quickly bootstrap a new project
+- 📏 Bundle analysis
+- ⬇️ Download and bundle remote URL imports
+
+## Contributors
+
+<a href="https://github.com/wxt-dev/wxt/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=wxt-dev/wxt" />
+</a>

docs/guide/content-script-ui.md

@@ -388,14 +388,14 @@ WXT provides a helper function, [`createIframeUi`](/api/wxt/client/functions/cre
    export default defineContentScript({
      matches: ['<all_urls>'],
 
-     async main(ctx) {
+     main(ctx) {
        // Define the UI
-       const ui = await createIframeUi(ctx, {
+       const ui = createIframeUi(ctx, {
          page: '/example-iframe.html',
          position: 'inline',
          onMount: (wrapper, iframe) => {
            // Add styles to the iframe like width
-           iframe.width = 123;
+           iframe.width = '123';
          },
        });
 

docs/guide/handling-updates.md

@@ -84,7 +84,7 @@ To validate this, you can create a third ZIP file with a rare permission like `g
 You can setup a callback that runs after your extension updates like so:
 
 ```ts
-browser.runtime.onInstalled.addEventListener(({ reason }) => {
+browser.runtime.onInstalled.addListener(({ reason }) => {
   if (reason === 'update') {
     // Do something
   }

docs/guide/remote-code.md

@@ -1,10 +1,10 @@
 # Remote Code
 
-WXT will automatically download and bundle imports with the `url:` prefix so the extension does not depend of remote code, [a requirement from Google for MV3](https://developer.chrome.com/docs/extensions/migrating/improve-security/#remove-remote-code).
+WXT will automatically download and bundle imports with the `url:` prefix so the extension does not depend on remote code, [a requirement from Google for MV3](https://developer.chrome.com/docs/extensions/migrating/improve-security/#remove-remote-code).
 
 ## Google Analytics
 
-For example, you can import google analytics:
+For example, you can import Google Analytics:
 
 ```ts
 // utils/google-analytics.ts

docs/guide/testing.md

@@ -22,4 +22,4 @@ If you want to try to use a different framework for unit tests, you will need to
 - **Global Variables**: If you consume them, manually define globals provided by WXT (like `import.meta.env.BROWSER`) by adding them to the global scope before accessing them (`import.meta.env.BROWSER = "chrome"`)
 - **Import paths**: If you use the `@/` or `~/` path aliases, add them to your test environment
 
-[Here's how Vitest is configured](https://github.com/wxt-dev/wxt/blob/main/src/testing/wxt-vitest-plugin.ts) for reference.
+[Here's how Vitest is configured](https://github.com/wxt-dev/wxt/blob/main/packages/wxt/src/testing/wxt-vitest-plugin.ts) for reference.

package.json

@@ -15,8 +15,7 @@
     "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",
-    "sync-releases": "pnpx changelogen@latest gh release"
+    "docs:preview": "pnpm -s docs:gen && vitepress preview docs"
   },
   "devDependencies": {
     "@aklinker1/check": "^1.1.1",
@@ -44,11 +43,6 @@
   "lint-staged": {
     "*": "prettier --ignore-unknown --write"
   },
-  "changelog": {
-    "excludeAuthors": [
-      "aaronklinker1@gmail.com"
-    ]
-  },
   "pnpm": {
     "peerDependencyRules": {
       "ignoreMissing": [

packages/wxt/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## v0.18.2
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/v0.18.1...v0.18.2)
+
+### 🚀 Enhancements
+
+- **runner:** Add `keepProfileChanges` option ([#655](https://github.com/wxt-dev/wxt/pull/655))
+
+### 🩹 Fixes
+
+- Automatically detect and add "sidePanel" permission ([5fcaf7c](https://github.com/wxt-dev/wxt/commit/5fcaf7c))
+
+### 📖 Documentation
+
+- Fix `wxt-vitest-plugin` reference ([#650](https://github.com/wxt-dev/wxt/pull/650))
+- Fix spelling mistake in remote-code.md ([#652](https://github.com/wxt-dev/wxt/pull/652))
+- Correct event handler name in handling-updates.md ([#653](https://github.com/wxt-dev/wxt/pull/653))
+- Fix iframe typos ([c74e530](https://github.com/wxt-dev/wxt/commit/c74e530))
+
+### ❤️ Contributors
+
+- Edoan ([@EdoanR](http://github.com/EdoanR))
+- Linus Norton ([@linusnorton](http://github.com/linusnorton))
+- Jeffrey Zang ([@jeffrey-zang](http://github.com/jeffrey-zang))
+- Emmanuel Ferdman <emmanuelferdman@gmail.com>
+
+## v0.18.1
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/v0.18.0...v0.18.1)
+
+### 🩹 Fixes
+
+- `_background` is not defined ([#649](https://github.com/wxt-dev/wxt/pull/649))
+
+### 🏡 Chore
+
+- Add root README back ([ec3dd52](https://github.com/wxt-dev/wxt/commit/ec3dd52))
+
+### 🤖 CI
+
+- Fix sync releases workflow ([dc5b55b](https://github.com/wxt-dev/wxt/commit/dc5b55b))
+
 ## v0.18.0
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/v0.17.12...v0.18.0)
@@ -12,7 +54,7 @@
 
 ### 🩹 Fixes
 
-- ⚠️  Automatically move `host_permissions` to `permissions` for MV2 ([#626](https://github.com/wxt-dev/wxt/pull/626))
+- ⚠️ Automatically move `host_permissions` to `permissions` for MV2 ([#626](https://github.com/wxt-dev/wxt/pull/626))
 - **dep:** Upgrade `@webext-core/isolated-element` to v1.1.2 ([#625](https://github.com/wxt-dev/wxt/pull/625))
 
 ### 📖 Documentation
@@ -39,18 +81,19 @@
 
 #### ⚠️ Breaking Changes
 
-- ⚠️  Automatically move `host_permissions` to `permissions` for MV2 ([#626](https://github.com/wxt-dev/wxt/pull/626))
+- ⚠️ Automatically move `host_permissions` to `permissions` for MV2 ([#626](https://github.com/wxt-dev/wxt/pull/626))
+
+  Out of an abundance of caution, I've marked this as a breaking change because permission generation has changed. **_If you list `host_permissions` in your `wxt.config.ts`'s manifest and have released your extension_**, double check that your `permissions` and `host_permissions` have not changed for all browsers you target in your `.output/*/manifest.json` files. Permission changes can cause the extension to be disabled on update, and can cause a drop in users, so be sure to double check for differences compared to the previous manifest version.
 
 ### ❤️ Contributors
 
-- Aaron <aaronklinker1@gmail.com>
-- Alegal200 <alex.gallez11@gmail.com>
+- Alegal200 ([@alegal200](https://github.com/alegal200))
 - Yacine-bens ([@yacine-bens](http://github.com/yacine-bens))
-- Ayden <itxcc420@gmail.com>
+- Ayden ([@AydenGen](https://github.com/AydenGen))
 - Wuzequanyouzi ([@wuzequanyouzi](http://github.com/wuzequanyouzi))
 - Can Rau ([@CanRau](http://github.com/CanRau))
 - 日高 凌 ([@ryohidaka](http://github.com/ryohidaka))
-- Bas Van Zanten <bas.van.zanten007@gmail.com>
+- Bas Van Zanten ([@Bas950](http://github.com/Bas950))
 - ThinkStu ([@Bistutu](http://github.com/Bistutu))
 
 ## v0.17.12
@@ -312,11 +355,11 @@
 
 ### 🚀 Enhancements
 
-- **storage:** ⚠️  Improved support for default values on storage items ([#477](https://github.com/wxt-dev/wxt/pull/477))
+- **storage:** ⚠️ Improved support for default values on storage items ([#477](https://github.com/wxt-dev/wxt/pull/477))
 
 ### 🩹 Fixes
 
-- **storage:** ⚠️  Only run migrations when the extension is updated ([#478](https://github.com/wxt-dev/wxt/pull/478))
+- **storage:** ⚠️ Only run migrations when the extension is updated ([#478](https://github.com/wxt-dev/wxt/pull/478))
 - Improve dev mode for content scripts registered at runtime ([#474](https://github.com/wxt-dev/wxt/pull/474))
 
 ### 📖 Documentation
@@ -344,12 +387,13 @@ const item = storage.defineItem<number | null>("local:count", {
 })
 ```
 
-The `defaultValue` property is now required if passing in the second options argument. 
+The `defaultValue` property is now required if passing in the second options argument.
 
 If you exclude the second options argument, it will default to being nullable, as before.
 
 ```ts
-const item: WxtStorageItem<number | null> = storage.defineItem<number>("local:count");
+const item: WxtStorageItem<number | null> =
+  storage.defineItem<number>('local:count');
 const value: number | null = await item.getValue();
 ```
 
@@ -359,13 +403,13 @@ For storage items that are not nullable, the `watch` callback types has improved
 
 ```ts
 // >=0.17
-const item = storage.defineItem<number>("local:count", { defaultValue: 0 });
+const item = storage.defineItem<number>('local:count', { defaultValue: 0 });
 item.watch((newValue: number | null, oldValue: number | null) => {
   // ...
 });
 
 // >=0.17
-const item = storage.defineItem<number>("local:count", { defaultValue: 0 });
+const item = storage.defineItem<number>('local:count', { defaultValue: 0 });
 item.watch((newValue: number, oldValue: number) => {
   // ...
 });
@@ -595,7 +639,7 @@ item.migrate();
 
 ### 🚀 Enhancements
 
-- ⚠️  ESM background support ([#398](https://github.com/wxt-dev/wxt/pull/398))
+- ⚠️ ESM background support ([#398](https://github.com/wxt-dev/wxt/pull/398))
 
 ### 📖 Documentation
 
@@ -612,23 +656,23 @@ item.migrate();
 In [#398](https://github.com/wxt-dev/wxt/pull/398), HTML pages' 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.
 
 - Before:
-   ```
-   .output/
-     <target>/
-       chunks/
-         some-shared-chunk-<hash>.js
-         popup-<hash>.js
-       popup.html
-   ```
+  ```
+  .output/
+    <target>/
+      chunks/
+        some-shared-chunk-<hash>.js
+        popup-<hash>.js
+      popup.html
+  ```
 - After:
-   ```
-   .output/
-     <target>/
-       chunks/
-         some-shared-chunk-<hash>.js
-       popup.html
-       popup.js
-   ```
+  ```
+  .output/
+    <target>/
+      chunks/
+        some-shared-chunk-<hash>.js
+      popup.html
+      popup.js
+  ```
 
 This effects all HTML files, not just the Popup. The hash has been removed, and it's been moved to the root of the build target folder, not inside the `chunks/` directory. Moving files like this has not historically increased review times or triggered in-depth reviews when submitting updates to the stores.
 
@@ -694,12 +738,12 @@ This effects all HTML files, not just the Popup. The hash has been removed, and
 
 ### 🚀 Enhancements
 
-- **zip:** ⚠️  Add `includeSources` and rename `ignoredSources` to `excludeSources` ([#378](https://github.com/wxt-dev/wxt/pull/378))
+- **zip:** ⚠️ Add `includeSources` and rename `ignoredSources` to `excludeSources` ([#378](https://github.com/wxt-dev/wxt/pull/378))
 
 ### 🩹 Fixes
 
 - Generate missing sourcemap in `wxt:unimport` plugin ([#381](https://github.com/wxt-dev/wxt/pull/381))
-- ⚠️  Move browser constants to `import.meta.env` ([#380](https://github.com/wxt-dev/wxt/pull/380))
+- ⚠️ Move browser constants to `import.meta.env` ([#380](https://github.com/wxt-dev/wxt/pull/380))
 - Enable inline sourcemaps by default during development ([#382](https://github.com/wxt-dev/wxt/pull/382))
 
 ### 📖 Documentation
@@ -849,7 +893,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🚀 Enhancements
 
-- ⚠️  Refactor content script UI functions and add helper for "integrated" UIs ([#333](https://github.com/wxt-dev/wxt/pull/333))
+- ⚠️ Refactor content script UI functions and add helper for "integrated" UIs ([#333](https://github.com/wxt-dev/wxt/pull/333))
 
 #### ⚠️ Breaking Changes
 
@@ -858,7 +902,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 - `createContentScriptUi({ ... })` &rarr; `createShadowRootUi({ ... })`
 - `createContentScriptIframe({ ... })` &rarr; `createIframeUi({ ... })`
 - `type: "inline" | "overlay" | "modal"` has been changed to `position: "inline" | "overlay" | "modal"`
-- `onRemove` is now called ***before*** the UI is removed from the DOM, previously it was called after the UI was removed
+- `onRemove` is now called **_before_** the UI is removed from the DOM, previously it was called after the UI was removed
 - `mount` option has been renamed to `onMount`, to better match the related option, `onRemove`.
 
 ## v0.13.5
@@ -954,7 +998,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🚀 Enhancements
 
-- ⚠️  New `wxt/storage` APIs ([#300](https://github.com/wxt-dev/wxt/pull/300))
+- ⚠️ New `wxt/storage` APIs ([#300](https://github.com/wxt-dev/wxt/pull/300))
 
 #### ⚠️ Breaking Changes
 
@@ -1011,7 +1055,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🚀 Enhancements
 
-- ⚠️  Add support for "main world" content scripts ([#284](https://github.com/wxt-dev/wxt/pull/284))
+- ⚠️ Add support for "main world" content scripts ([#284](https://github.com/wxt-dev/wxt/pull/284))
 
 ### 🩹 Fixes
 
@@ -1033,10 +1077,10 @@ 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:
-   ```diff
-   - import { defineBackground, defineContentScript } from 'wxt/client';
-   + import { defineBackground, defineContentScript } from 'wxt/sandbox';
-   ```
+  ```diff
+  - import { defineBackground, defineContentScript } from 'wxt/client';
+  + import { defineBackground, defineContentScript } from 'wxt/sandbox';
+  ```
 
 ## v0.11.2
 
@@ -1074,7 +1118,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🚀 Enhancements
 
-- ⚠️  Vite 5 support ([#261](https://github.com/wxt-dev/wxt/pull/261))
+- ⚠️ Vite 5 support ([#261](https://github.com/wxt-dev/wxt/pull/261))
 
 ### 📖 Documentation
 
@@ -1166,7 +1210,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 ### 🚀 Enhancements
 
 - List `bun` as an experimental option in `wxt init` ([#233](https://github.com/wxt-dev/wxt/pull/233))
-- ⚠️  Allow plural directory and only png's for manifest icons ([#237](https://github.com/wxt-dev/wxt/pull/237))
+- ⚠️ Allow plural directory and only png's for manifest icons ([#237](https://github.com/wxt-dev/wxt/pull/237))
 - Add `wxt/storage` API ([#234](https://github.com/wxt-dev/wxt/pull/234))
 
 ### 🩹 Fixes
@@ -1238,7 +1282,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🩹 Fixes
 
-- ⚠️  Remove `lib` from `.wxt/tsconfig.json` ([#209](https://github.com/wxt-dev/wxt/pull/209))
+- ⚠️ Remove `lib` from `.wxt/tsconfig.json` ([#209](https://github.com/wxt-dev/wxt/pull/209))
 
 ### 📖 Documentation
 
@@ -1251,15 +1295,15 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 #### ⚠️ Breaking Changes
 
-- ⚠️  Removed [`"WebWorker"` types](https://www.typescriptlang.org/tsconfig/lib.html) from `.wxt/tsconfig.json` ([#209](https://github.com/wxt-dev/wxt/pull/209)). These types are useful for MV3 projects using a service worker. To add them back to your project, add the following to your project's TSConfig:
-   ```diff
-   {
-     "extends": "./.wxt/tsconfig.json",
-   + "compilerOptions": {
-   +   "lib": ["ESNext", "DOM", "WebWorker"]
-   + }
-   }
-   ```
+- ⚠️ Removed [`"WebWorker"` types](https://www.typescriptlang.org/tsconfig/lib.html) from `.wxt/tsconfig.json` ([#209](https://github.com/wxt-dev/wxt/pull/209)). These types are useful for MV3 projects using a service worker. To add them back to your project, add the following to your project's TSConfig:
+  ```diff
+  {
+    "extends": "./.wxt/tsconfig.json",
+  + "compilerOptions": {
+  +   "lib": ["ESNext", "DOM", "WebWorker"]
+  + }
+  }
+  ```
 
 ### ❤️ Contributors
 
@@ -1373,7 +1417,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🚀 Enhancements
 
-- ⚠️  Use `defineUnlistedScript` to define unlisted scripts ([#167](https://github.com/wxt-dev/wxt/pull/167))
+- ⚠️ Use `defineUnlistedScript` to define unlisted scripts ([#167](https://github.com/wxt-dev/wxt/pull/167))
 
 ### 📖 Documentation
 
@@ -1381,12 +1425,12 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🌊 Types
 
-- ⚠️  Rename `BackgroundScriptDefintition` to `BackgroundDefinition` ([446f265](https://github.com/wxt-dev/wxt/commit/446f265))
+- ⚠️ Rename `BackgroundScriptDefintition` to `BackgroundDefinition` ([446f265](https://github.com/wxt-dev/wxt/commit/446f265))
 
 #### ⚠️ Breaking Changes
 
-- ⚠️  Unlisted scripts must now `export default defineUnlistedScript(...)` ([#167](https://github.com/wxt-dev/wxt/pull/167))
-- ⚠️  Rename `BackgroundScriptDefintition` to `BackgroundDefinition` ([446f265](https://github.com/wxt-dev/wxt/commit/446f265))
+- ⚠️ Unlisted scripts must now `export default defineUnlistedScript(...)` ([#167](https://github.com/wxt-dev/wxt/pull/167))
+- ⚠️ Rename `BackgroundScriptDefintition` to `BackgroundDefinition` ([446f265](https://github.com/wxt-dev/wxt/commit/446f265))
 
 ### ❤️ Contributors
 
@@ -1479,7 +1523,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 ### 🩹 Fixes
 
 - Validate transformed manifest correctly ([4b2012c](https://github.com/wxt-dev/wxt/commit/4b2012c))
-- ⚠️  Output content script CSS to `content-scripts/<name>.css` ([#140](https://github.com/wxt-dev/wxt/pull/140))
+- ⚠️ Output content script CSS to `content-scripts/<name>.css` ([#140](https://github.com/wxt-dev/wxt/pull/140))
 - Reorder typescript paths to give priority to `@` and `~` over `@@` and `~~` ([#142](https://github.com/wxt-dev/wxt/pull/142))
 
 ### 🏡 Chore
@@ -1577,7 +1621,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 ### 🚀 Enhancements
 
 - Export `ContentScriptContext` from `wxt/client` ([1f448d1](https://github.com/wxt-dev/wxt/commit/1f448d1))
-- ⚠️  Require a function for `vite` configuration ([#121](https://github.com/wxt-dev/wxt/pull/121))
+- ⚠️ Require a function for `vite` configuration ([#121](https://github.com/wxt-dev/wxt/pull/121))
 
 ### 🩹 Fixes
 
@@ -1586,7 +1630,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 #### ⚠️ Breaking Changes
 
-- ⚠️  The `vite` config option must now be a function. If you were using an object before, change it from `vite: { ... }` to `vite: () => ({ ... })`. ([#121](https://github.com/wxt-dev/wxt/pull/121))
+- ⚠️ The `vite` config option must now be a function. If you were using an object before, change it from `vite: { ... }` to `vite: () => ({ ... })`. ([#121](https://github.com/wxt-dev/wxt/pull/121))
 
 ## v0.5.6
 
@@ -1653,7 +1697,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 ### 🩹 Fixes
 
 - **types:** Don't write to files if nothing changes ([#107](https://github.com/wxt-dev/wxt/pull/107))
-- ⚠️  Change default `publicDir` to `<srcDir>/public` ([5f15f9c](https://github.com/wxt-dev/wxt/commit/5f15f9c))
+- ⚠️ Change default `publicDir` to `<srcDir>/public` ([5f15f9c](https://github.com/wxt-dev/wxt/commit/5f15f9c))
 
 ### 📖 Documentation
 
@@ -1673,7 +1717,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 #### ⚠️ Breaking Changes
 
-- ⚠️  Change default `publicDir` to `<srcDir>/public` ([5f15f9c](https://github.com/wxt-dev/wxt/commit/5f15f9c))
+- ⚠️ Change default `publicDir` to `<srcDir>/public` ([5f15f9c](https://github.com/wxt-dev/wxt/commit/5f15f9c))
 
 ## v0.4.1
 
@@ -1701,7 +1745,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 - Allow adding custom content scripts ([b428a62](https://github.com/wxt-dev/wxt/commit/b428a62))
 - Don't overwrite `wxt.config.ts` content scripts, append entrypoints to it ([5f5f1d9](https://github.com/wxt-dev/wxt/commit/5f5f1d9))
-- ⚠️  Use relative path aliases inside `.wxt/tsconfig.json` ([#102](https://github.com/wxt-dev/wxt/pull/102))
+- ⚠️ Use relative path aliases inside `.wxt/tsconfig.json` ([#102](https://github.com/wxt-dev/wxt/pull/102))
 
 ### 📖 Documentation
 
@@ -1734,7 +1778,7 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 #### ⚠️ Breaking Changes
 
-- ⚠️  Use relative path aliases inside `.wxt/tsconfig.json` ([#102](https://github.com/wxt-dev/wxt/pull/102))
+- ⚠️ Use relative path aliases inside `.wxt/tsconfig.json` ([#102](https://github.com/wxt-dev/wxt/pull/102))
 
 ## v0.3.2
 
@@ -1806,8 +1850,8 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 ### 🚀 Enhancements
 
-- ⚠️  Add type safety to `browser.runtime.getURL` ([58a84ec](https://github.com/wxt-dev/wxt/commit/58a84ec))
-- ⚠️  Change default `publicDir` to `<rootDir>/public` ([19c0948](https://github.com/wxt-dev/wxt/commit/19c0948))
+- ⚠️ Add type safety to `browser.runtime.getURL` ([58a84ec](https://github.com/wxt-dev/wxt/commit/58a84ec))
+- ⚠️ Change default `publicDir` to `<rootDir>/public` ([19c0948](https://github.com/wxt-dev/wxt/commit/19c0948))
 - Windows support ([#50](https://github.com/wxt-dev/wxt/pull/50))
 
 ### 🩹 Fixes
@@ -1826,10 +1870,10 @@ Renamed undocumented constants for detecting the build config at runtime in [#38
 
 - Improve checks against `demo/` extension ([9cc464f](https://github.com/wxt-dev/wxt/commit/9cc464f))
 
-#### ⚠️  Breaking Changes
+#### ⚠️ Breaking Changes
 
-- ⚠️  Add type safety to `browser.runtime.getURL` ([58a84ec](https://github.com/wxt-dev/wxt/commit/58a84ec))
-- ⚠️  Change default `publicDir` to `<rootDir>/public` ([19c0948](https://github.com/wxt-dev/wxt/commit/19c0948))
+- ⚠️ Add type safety to `browser.runtime.getURL` ([58a84ec](https://github.com/wxt-dev/wxt/commit/58a84ec))
+- ⚠️ Change default `publicDir` to `<rootDir>/public` ([19c0948](https://github.com/wxt-dev/wxt/commit/19c0948))
 
 ## v0.2.5
 

packages/wxt/e2e/tests/output-structure.test.ts

@@ -294,9 +294,10 @@ describe('Output Directory Structure', () => {
           warn: (...args) => print(console.warn, ...args),
           error: (...args) => print(console.error, ...args)
         };
+        var result;
         try {
-          const res = definition.main();
-          if (res instanceof Promise) {
+          result = definition.main();
+          if (result instanceof Promise) {
             console.warn(
               "The background's main() function return a promise, but it must be synchronous"
             );
@@ -352,7 +353,7 @@ describe('Output Directory Structure', () => {
       .toMatchInlineSnapshot(`
         ".output/chrome-mv3/background.js
         ----------------------------------------
-        (function() {
+        var _background = function() {
           "use strict";
           function defineBackground(arg) {
             if (typeof arg === "function")
@@ -379,9 +380,10 @@ describe('Output Directory Structure', () => {
             warn: (...args) => print(console.warn, ...args),
             error: (...args) => print(console.error, ...args)
           };
+          var result;
           try {
-            const res = definition.main();
-            if (res instanceof Promise) {
+            result = definition.main();
+            if (result instanceof Promise) {
               console.warn(
                 "The background's main() function return a promise, but it must be synchronous"
               );
@@ -390,7 +392,9 @@ describe('Output Directory Structure', () => {
             logger.error("The background crashed on startup!");
             throw err;
           }
-        })();
+          var background_entrypoint_default = result;
+          return background_entrypoint_default;
+        }();
         _background;
         "
       `);

packages/wxt/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "Next gen framework for developing web extensions",
   "repository": {
     "type": "git",
@@ -88,7 +88,7 @@
     "check:tsc-virtual": "tsc --noEmit -p src/virtual",
     "test": "vitest",
     "test:e2e": "vitest -r e2e",
-    "test:e2e:2": "vitest --config e2e/vitest.config.ts"
+    "sync-releases": "pnpx changelogen@latest gh release"
   },
   "dependencies": {
     "@aklinker1/rollup-plugin-visualizer": "5.12.0",
@@ -148,5 +148,10 @@
     "tsup": "^8.0.1",
     "tsx": "^4.6.2",
     "typescript": "^5.3.2"
+  },
+  "changelog": {
+    "excludeAuthors": [
+      "aaronklinker1@gmail.com"
+    ]
   }
 }

packages/wxt/src/core/runners/web-ext.ts

@@ -35,6 +35,7 @@ export function createWebExtRunner(): ExtensionRunner {
         console: wxtUserConfig?.openConsole,
         devtools: wxtUserConfig?.openDevtools,
         startUrl: wxtUserConfig?.startUrls,
+        keepProfileChanges: wxtUserConfig?.keepProfileChanges,
         ...(wxt.config.browser === 'firefox'
           ? {
               firefox: wxtUserConfig?.binaries?.firefox,

packages/wxt/src/core/utils/__tests__/manifest.test.ts

@@ -897,7 +897,7 @@ describe('Manifest Utils', () => {
 
     describe('sidepanel', () => {
       it.each(['chrome', 'safari', 'edge'])(
-        'should include a side_panel ignoring all options for %s',
+        'should include the side_panel and permission, ignoring all options for %s',
         async (browser) => {
           const sidepanel = fakeSidepanelEntrypoint({
             outputDir: outDir,
@@ -909,12 +909,14 @@ describe('Manifest Utils', () => {
               manifestVersion: 3,
               browser,
               outDir,
+              command: 'build',
             },
           });
           const expected = {
             side_panel: {
               default_path: 'sidepanel.html',
             },
+            permissions: ['sidePanel'],
           };
 
           const { manifest: actual } = await generateManifest(

packages/wxt/src/core/utils/manifest.ts

@@ -347,6 +347,7 @@ function addEntrypoints(
       manifest.side_panel = {
         default_path: page,
       };
+      addPermission(manifest, 'sidePanel');
     } else {
       wxt.logger.warn(
         'Side panel not supported by Chromium using MV2. side_panel.default_path was not added to the manifest',

packages/wxt/src/types/index.ts

@@ -927,6 +927,10 @@ export interface ExtensionRunnerConfig {
    * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#start-url
    */
   startUrls?: string[];
+  /**
+   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#keep-profile-changes
+   */
+  keepProfileChanges?: boolean;
 }
 
 export interface WxtBuilder {

packages/wxt/src/virtual/background-entrypoint.ts

@@ -34,10 +34,12 @@ if (import.meta.env.COMMAND === 'serve') {
   });
 }
 
+let result;
+
 try {
-  const res = definition.main();
+  result = definition.main();
   // @ts-expect-error: res shouldn't be a promise, but we're checking it anyways
-  if (res instanceof Promise) {
+  if (result instanceof Promise) {
     console.warn(
       "The background's main() function return a promise, but it must be synchronous",
     );
@@ -46,3 +48,9 @@ try {
   logger.error('The background crashed on startup!');
   throw err;
 }
+
+// Return the main function's result to the background when executed via the
+// scripting API. Default export causes the IIFE to return a value.
+// https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/scripting/executeScript#return_value
+// Tested on both Chrome and Firefox
+export default result;