wxt 0.19.10-alpha1 → 0.19.10

package/README.md

@@ -0,0 +1,90 @@
+<!-- DO NOT EDIT, THIS FILE WAS GENERATED BY '../../scripts/generate-readmes.sh' -->
+<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>
+
+<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>
+
+<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>
+
+<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
+
+## Quick Start
+
+Bootstrap a new project:
+
+<!-- automd:pm-x version="latest" name="wxt" args="init" -->
+
+```sh
+# npm
+npx wxt@latest init
+
+# pnpm
+pnpm dlx wxt@latest init
+
+# bun
+bunx wxt@latest init
+```
+
+<!-- /automd -->
+
+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
+- 📦 Modular architecture with [WXT modules](https://wxt.dev/guide/go-further/reusable-modules.html#overview)
+- 🖍️ Quickly bootstrap a new project
+- 📏 Bundle analysis
+- ⬇️ Download and bundle remote URL imports
+
+## 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>
+
+<!-- /automd -->

package/dist/client/content-scripts/ui/index.d.ts

@@ -4,13 +4,13 @@ export * from './types';
 /**
  * Create a content script UI without any isolation.
  *
- * @see https://wxt.dev/guide/key-concepts/content-script-ui#integrated
+ * @see https://wxt.dev/guide/key-concepts/content-script-ui.html#integrated
  */
 export declare function createIntegratedUi<TMounted>(ctx: ContentScriptContext, options: IntegratedContentScriptUiOptions<TMounted>): IntegratedContentScriptUi<TMounted>;
 /**
  * Create a content script UI using an iframe.
  *
- * @see https://wxt.dev/guide/key-concepts/content-script-ui#iframe
+ * @see https://wxt.dev/guide/key-concepts/content-script-ui.html#iframe
  */
 export declare function createIframeUi<TMounted>(ctx: ContentScriptContext, options: IframeContentScriptUiOptions<TMounted>): IframeContentScriptUi<TMounted>;
 /**
@@ -18,6 +18,6 @@ export declare function createIframeUi<TMounted>(ctx: ContentScriptContext, opti
  *
  * > This function is async because it has to load the CSS via a network call.
  *
- * @see https://wxt.dev/guide/key-concepts/content-script-ui#shadowroot
+ * @see https://wxt.dev/guide/key-concepts/content-script-ui.html#shadowroot
  */
 export declare function createShadowRootUi<TMounted>(ctx: ContentScriptContext, options: ShadowRootContentScriptUiOptions<TMounted>): Promise<ShadowRootContentScriptUi<TMounted>>;

package/dist/core/create-server.mjs

@@ -1,3 +1,4 @@
+import { debounce } from "perfect-debounce";
 import { getEntrypointBundlePath, isHtmlEntrypoint } from "./utils/entrypoints.mjs";
 import {
   getContentScriptCssFiles,
@@ -98,7 +99,7 @@ export async function createServer(inlineConfig) {
 function createFileReloader(server) {
   const fileChangedMutex = new Mutex();
   const changeQueue = [];
-  return async (event, path) => {
+  const cb = async (event, path) => {
     changeQueue.push([event, path]);
     await fileChangedMutex.runExclusive(async () => {
       if (server.currentOutput == null) return;
@@ -151,6 +152,10 @@ function createFileReloader(server) {
       }
     });
   };
+  return debounce(cb, wxt.config.dev.server.watchDebounce, {
+    leading: true,
+    trailing: false
+  });
 }
 function reloadContentScripts(steps, server) {
   if (wxt.config.manifestVersion === 3) {

package/dist/core/utils/building/resolve-config.mjs

@@ -8,6 +8,8 @@ import { normalizePath } from "../paths.mjs";
 import glob from "fast-glob";
 import { builtinModules } from "../../../builtin-modules/index.mjs";
 import { getEslintVersion } from "../eslint.mjs";
+import { safeStringToNumber } from "../number.mjs";
+import { loadEnv } from "../env.mjs";
 export async function resolveConfig(inlineConfig, command) {
   let userConfig = {};
   let userConfigMetadata;
@@ -32,6 +34,7 @@ export async function resolveConfig(inlineConfig, command) {
   const manifestVersion = mergedConfig.manifestVersion ?? (browser === "firefox" || browser === "safari" ? 2 : 3);
   const mode = mergedConfig.mode ?? COMMAND_MODES[command];
   const env = { browser, command, manifestVersion, mode };
+  loadEnv(mode);
   const root = path.resolve(
     inlineConfig.root ?? userConfig.root ?? process.cwd()
   );
@@ -78,7 +81,8 @@ export async function resolveConfig(inlineConfig, command) {
     }
     devServerConfig = {
       port,
-      hostname: mergedConfig.dev?.server?.hostname ?? "localhost"
+      hostname: mergedConfig.dev?.server?.hostname ?? "localhost",
+      watchDebounce: safeStringToNumber(process.env.WXT_WATCH_DEBOUNCE) ?? 800
     };
   }
   const userModules = await resolveWxtUserModules(

package/dist/core/utils/env.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Load environment files based on the current mode.
+ */
+export declare function loadEnv(mode: string): import("dotenv").DotenvConfigOutput;

package/dist/core/utils/env.mjs

@@ -0,0 +1,6 @@
+import { config } from "dotenv";
+export function loadEnv(mode) {
+  return config({
+    path: [`.env`, `.env.local`, `.env.${mode}`, `.env.${mode}.local`]
+  });
+}

package/dist/core/utils/manifest.mjs

@@ -27,7 +27,7 @@ export async function generateManifest(entrypoints, buildOutput) {
   if (versionName == null) {
     versionName = "0.0.0";
     wxt.logger.warn(
-      'Extension version not found, defaulting to "0.0.0". Add a version to your `package.json` or `wxt.config.ts` file. For more details, see: https://wxt.dev/guide/key-concepts/manifest#version-and-version-name'
+      'Extension version not found, defaulting to "0.0.0". Add a version to your `package.json` or `wxt.config.ts` file. For more details, see: https://wxt.dev/guide/key-concepts/manifest.html#version-and-version-name'
     );
   }
   const version = wxt.config.manifest.version ?? simplifyVersion(versionName);

package/dist/core/utils/number.d.ts

@@ -0,0 +1 @@
+export declare function safeStringToNumber(str: string | undefined): number | null;

package/dist/core/utils/number.mjs

@@ -0,0 +1,4 @@
+export function safeStringToNumber(str) {
+  const num = Number(str);
+  return isNaN(num) ? null : num;
+}