wxt 0.19.16 → 0.19.18

package/dist/core/wxt.mjs

@@ -5,12 +5,11 @@ import { createViteBuilder } from "./builders/vite/index.mjs";
 import { builtinModules } from "../builtin-modules/index.mjs";
 import { relative } from "path";
 export let wxt;
-export async function registerWxt(command, inlineConfig = {}, getServer) {
+export async function registerWxt(command, inlineConfig = {}) {
   process.env.NODE_ENV ??= command === "serve" ? "development" : "production";
   const hooks = createHooks();
   const config = await resolveConfig(inlineConfig, command);
-  const server = await getServer?.(config);
-  const builder = await createViteBuilder(config, hooks, server);
+  const builder = await createViteBuilder(config, hooks, () => wxt.server);
   const pm = await createWxtPackageManager(config.root);
   wxt = {
     config,
@@ -25,23 +24,18 @@ export async function registerWxt(command, inlineConfig = {}, getServer) {
     },
     pm,
     builder,
-    server
+    server: void 0
   };
-  const initModule = async (module) => {
-    if (module.hooks) wxt.hooks.addHooks(module.hooks);
-    await module.setup?.(
-      wxt,
-      // @ts-expect-error: Untyped configKey field
-      module.configKey ? config[module.configKey] : void 0
-    );
-  };
-  for (const builtinModule of builtinModules) await initModule(builtinModule);
-  for (const userModule of config.userModules) await initModule(userModule);
-  wxt.hooks.addHooks(config.hooks);
+  await initWxtModules();
+}
+export async function initWxtModules() {
+  for (const mod of builtinModules) await initWxtModule(mod);
+  for (const mod of wxt.config.userModules) await initWxtModule(mod);
+  wxt.hooks.addHooks(wxt.config.hooks);
   if (wxt.config.debug) {
     const order = [
       ...builtinModules.map((module) => module.name),
-      ...config.userModules.map(
+      ...wxt.config.userModules.map(
         (module) => relative(wxt.config.root, module.id)
       ),
       "wxt.config.ts > hooks"
@@ -54,6 +48,17 @@ export async function registerWxt(command, inlineConfig = {}, getServer) {
   await wxt.hooks.callHook("ready", wxt);
   await wxt.hooks.callHook("config:resolved", wxt);
 }
+async function initWxtModule(module) {
+  if (module.hooks) wxt.hooks.addHooks(module.hooks);
+  await module.setup?.(
+    wxt,
+    // @ts-expect-error: Untyped configKey field
+    module.configKey ? wxt.config[module.configKey] : void 0
+  );
+}
+export function deinitWxtModules() {
+  wxt.hooks.removeAllHooks();
+}
 export function setWxtForTesting(testInstance) {
   wxt = testInstance;
 }

package/dist/types.d.ts

@@ -44,6 +44,7 @@ export interface InlineConfig {
      * A list of entrypoint names (`"popup"`, `"options"`, etc.) to build. Will speed up the build if
      * your extension has lots of entrypoints, and you don't need to build all of them to develop a
      * feature.
+     * If specified, this completely overrides the `include`/`exclude` option provided per-entrypoint.
      */
     filterEntrypoints?: string[];
     /**
@@ -269,7 +270,7 @@ export interface InlineConfig {
     analysis?: {
         /**
          * Explicitly include bundle analysis when running `wxt build`. This can be overridden by the
-         * command line `--analysis` option.
+         * command line `--analyze` option.
          *
          * @default false
          */
@@ -552,7 +553,7 @@ export interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
     type?: PerBrowserOption<'module'>;
 }
 export interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
-    matches: PerBrowserOption<Manifest.ContentScript['matches']>;
+    matches?: PerBrowserOption<Manifest.ContentScript['matches']>;
     /**
      * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
      * @default "documentIdle"
@@ -682,7 +683,14 @@ export interface BaseEntrypoint {
      * subdirectory of it.
      */
     outputDir: string;
-    skipped: boolean;
+    /**
+     * When true, the entrypoint will not be built by WXT. Normally this is set
+     * based on the `filterEntrypoints` config or the entrypoint's
+     * `include`/`exclude` options defined inside the file.
+     *
+     * See https://wxt.dev/guide/essentials/target-different-browsers.html#filtering-entrypoints
+     */
+    skipped?: boolean;
 }
 export interface GenericEntrypoint extends BaseEntrypoint {
     type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'devtools' | 'unlisted-page' | 'unlisted-script' | 'unlisted-style' | 'content-script-style';
@@ -984,7 +992,8 @@ export interface ServerInfo {
 export type HookResult = Promise<void> | void;
 export interface WxtHooks {
     /**
-     * Called only one time after WXT initialization, when the WXT instance is ready to work.
+     * Called after WXT modules are initialized, when the WXT instance is ready to
+     * be used. `wxt.server` isn't available yet, use `server:created` to get it.
      * @param wxt The configured WXT object
      */
     ready: (wxt: Wxt) => HookResult;
@@ -1105,6 +1114,24 @@ export interface WxtHooks {
      * @param zipFiles An array of paths to all created zip files
      */
     'zip:done': (wxt: Wxt, zipFiles: string[]) => HookResult;
+    /**
+     * Called when the dev server is created (and `wxt.server` is assigned). Server has not been started yet.
+     * @param wxt The configured WXT object
+     * @param server Same as `wxt.server`, the object WXT uses to control the dev server.
+     */
+    'server:created': (wxt: Wxt, server: WxtDevServer) => HookResult;
+    /**
+     * Called when the dev server is started.
+     * @param wxt The configured WXT object
+     * @param server Same as `wxt.server`, the object WXT uses to control the dev server.
+     */
+    'server:started': (wxt: Wxt, server: WxtDevServer) => HookResult;
+    /**
+     * Called when the dev server is stopped.
+     * @param wxt The configured WXT object
+     * @param server Same as `wxt.server`, the object WXT uses to control the dev server.
+     */
+    'server:closed': (wxt: Wxt, server: WxtDevServer) => HookResult;
 }
 export interface Wxt {
     config: ResolvedConfig;
@@ -1118,7 +1145,7 @@ export interface Wxt {
      */
     logger: Logger;
     /**
-     * Reload config file and update the `config` field with the result.
+     * Reload config file and update `wxt.config` with the result.
      */
     reloadConfig: () => Promise<void>;
     /**

package/dist/version.mjs

@@ -1 +1 @@
-export const version = "0.19.16";
+export const version = "0.19.18";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.19.16",
+  "version": "0.19.18",
   "description": "Next gen framework for developing web extensions",
   "repository": {
     "type": "git",
@@ -89,7 +89,7 @@
     "fast-glob": "^3.3.2",
     "filesize": "^10.1.6",
     "fs-extra": "^11.2.0",
-    "get-port": "^7.1.0",
+    "get-port-please": "^3.1.2",
     "giget": "^1.2.3",
     "hookable": "^5.5.3",
     "is-wsl": "^3.1.0",
@@ -111,7 +111,7 @@
     "publish-browser-extension": "^2.2.2",
     "scule": "^1.3.0",
     "unimport": "^3.13.1",
-    "vite": "^5.4.11",
+    "vite": "^5.0.0 || ^6.0.0",
     "vite-node": "^2.1.4",
     "web-ext-run": "^0.2.1",
     "webextension-polyfill": "^0.12.0"