wxt 0.21.2 → 0.21.4

package/dist/types.d.mts

@@ -441,7 +441,23 @@ interface InlineConfig {
    */
   alias?: Record<string, string>;
   /** Experimental settings - use with caution. */
-  experimental?: {};
+  experimental?: {
+    /**
+     * Some libraries include unicode characters Chrome does not allow in
+     * extensions. If you receive "Could not load content script... it is not
+     * UTF-8 encoded", enable this setting.
+     *
+     * It is not enabled by default because it will slow down your build, and
+     * because it's very rare to have the problematic characters in JS. So not
+     * every extension needs this flag enabled.
+     *
+     * For more details, see:
+     *
+     * - https://github.com/wxt-dev/wxt/issues/353
+     * - https://github.com/wxt-dev/wxt/issues/2535
+     */
+    escapeUnicode?: boolean;
+  };
   /** Config effecting dev mode only. */
   dev?: {
     server?: {
@@ -618,6 +634,17 @@ interface Logger {
   success(...args: any[]): void;
   level: LogLevel;
 }
+/**
+ * The logger available at `wxt.logger`. Extends {@link Logger} with a `warnOnce`
+ * which only logs a message once per process.
+ */
+interface WxtLogger extends Logger {
+  /**
+   * Same as {@link Logger.warn}, but only logs a given message once per process,
+   * even if called multiple times with the same arguments.
+   */
+  warnOnce(...args: any[]): void;
+}
 interface BaseEntrypointOptions {
   /**
    * List of target browsers to include this entrypoint in. Defaults to being
@@ -1106,21 +1133,6 @@ interface WebExtConfig {
    *   default_directory: "/my/custom/dir",
    *   },
    *   }
-   *
-   * @default
-   * // Enable dev mode and allow content script sourcemaps
-   * {
-   *   devtools: {
-   *     synced_preferences_sync_disabled: {
-   *       skipContentScripts: false,
-   *     },
-   *   }
-   *   extensions: {
-   *     ui: {
-   *       developer_mode: true,
-   *     },
-   *   }
-   * }
    */
   chromiumPref?: Record<string, any>;
   /**
@@ -1365,8 +1377,8 @@ interface Wxt {
   hooks: Hookable<WxtHooks>;
   /** Alias for `wxt.hooks.hook(...)`. */
   hook: Hookable<WxtHooks>['hook'];
-  /** Alias for config.logger */
-  logger: Logger;
+  /** Wraps `config.logger`, adding `warnOnce`. */
+  logger: WxtLogger;
   /** Reload config file and update `wxt.config` with the result. */
   reloadConfig: () => Promise<void>;
   /** Package manager utilities. */
@@ -1417,7 +1429,7 @@ interface ResolvedConfig$1 {
   targetBrowsers: TargetBrowser[];
   manifestVersion: TargetManifestVersion;
   env: ConfigEnv;
-  logger: Logger;
+  logger: WxtLogger;
   imports: WxtResolvedUnimportOptions;
   manifest: UserManifest;
   fsCache: FsCache;
@@ -1449,7 +1461,9 @@ interface ResolvedConfig$1 {
   userConfigMetadata: Omit<ResolvedConfig<UserConfig>, 'config'>;
   /** Import aliases to absolute paths. */
   alias: Record<string, string>;
-  experimental: {};
+  experimental: {
+    escapeUnicode: boolean;
+  };
   /** List of warning identifiers to suppress during the build process. */
   suppressWarnings: {
     firefoxDataCollection?: boolean;
@@ -1508,28 +1522,29 @@ interface ExtensionRunner {
   canOpen?(): boolean;
 }
 type EslintGlobalsPropValue = boolean | 'readonly' | 'readable' | 'writable' | 'writeable';
+type EslintConfigVersion = 8 | 9;
 interface Eslintrc {
   /**
-   * When true, generates a file that can be used by ESLint to know which
-   * variables are valid globals.
+   * Determines if and in what format a config file will be generated to inform
+   * ESLint of unimport globals.
    *
-   * - `'auto'`: Check if eslint is installed, and if it is, generate a compatible
-   *   config file.
-   * - `true`: Same as `'auto'`.
-   * - `false`: Don't generate the file.
-   * - `8`: Generate a config file compatible with ESLint 8.
-   * - `9`: Generate a config file compatible with ESLint 9.
+   * - `true`: If eslint is installed, generate a compatible config file based on
+   *   the installed version.
+   * - `false`: Never generate the file.
+   * - `8`: Generate an eslintrc file compatible with ESLint &lte; 8.
+   * - `9`: Generate a flat config file compatible with ESLint &gte; 9.
+   * - `'auto'` (Deprecated): Same as `true`.
    *
-   * @default 'auto'
+   * @default true
    */
-  enabled?: 'auto' | boolean | 8 | 9;
+  enabled?: boolean | 'auto' | EslintConfigVersion;
   /**
    * File path to save the generated eslint config.
    *
    * Default depends on version of ESLint used:
    *
-   * - 9 and above: './.wxt/eslint-auto-imports.mjs'
-   * - 8 and below: './.wxt/eslintrc-auto-import.json'
+   * - &gte; 9: './.wxt/eslint-auto-imports.mjs'
+   * - &lte; 8: './.wxt/eslintrc-auto-import.json'
    */
   filePath?: string;
   /** @default true */
@@ -1537,7 +1552,7 @@ interface Eslintrc {
 }
 interface ResolvedEslintrc {
   /** False if disabled, otherwise the major version of ESLint installed */
-  enabled: false | 8 | 9;
+  enabled: false | EslintConfigVersion;
   /** Absolute path */
   filePath: string;
   globalsPropValue: EslintGlobalsPropValue;
@@ -1683,4 +1698,4 @@ interface WxtDirFileEntry {
   tsReference?: boolean;
 }
 //#endregion
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintConfigVersion, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtLogger, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };

package/dist/utils/content-script-ui/iframe.d.mts

@@ -6,6 +6,8 @@ import * as _$wxt_browser0 from "wxt/browser";
 /**
  * Create a content script UI using an iframe.
  *
+ * @param options - Iframe options. See {@link ContentScriptUiOptions} for shared
+ *   positioning, anchoring, `append`, and removal options.
  * @see https://wxt.dev/guide/essentials/content-scripts.html#iframe
  */
 declare function createIframeUi<TMounted>(ctx: ContentScriptContext, options: IframeContentScriptUiOptions<TMounted>): IframeContentScriptUi<TMounted>;

package/dist/utils/content-script-ui/iframe.mjs

@@ -5,6 +5,8 @@ import { browser } from "wxt/browser";
 /**
 * Create a content script UI using an iframe.
 *
+* @param options - Iframe options. See {@link ContentScriptUiOptions} for shared
+*   positioning, anchoring, `append`, and removal options.
 * @see https://wxt.dev/guide/essentials/content-scripts.html#iframe
 */
 function createIframeUi(ctx, options) {

package/dist/utils/content-script-ui/integrated.d.mts

@@ -5,6 +5,8 @@ import { ContentScriptUi, ContentScriptUiOptions } from "./types.mjs";
 /**
  * Create a content script UI without any isolation.
  *
+ * @param options - Integrated UI options. See {@link ContentScriptUiOptions} for
+ *   shared positioning, anchoring, `append`, and removal options.
  * @see https://wxt.dev/guide/essentials/content-scripts.html#integrated
  */
 declare function createIntegratedUi<TMounted>(ctx: ContentScriptContext, options: IntegratedContentScriptUiOptions<TMounted>): IntegratedContentScriptUi<TMounted>;

package/dist/utils/content-script-ui/integrated.mjs

@@ -3,6 +3,8 @@ import { applyPosition, createMountFunctions, mountUi } from "./shared.mjs";
 /**
 * Create a content script UI without any isolation.
 *
+* @param options - Integrated UI options. See {@link ContentScriptUiOptions} for
+*   shared positioning, anchoring, `append`, and removal options.
 * @see https://wxt.dev/guide/essentials/content-scripts.html#integrated
 */
 function createIntegratedUi(ctx, options) {

package/dist/utils/content-script-ui/shadow-root.d.mts

@@ -8,6 +8,8 @@ import { ContentScriptUi, ContentScriptUiOptions } from "./types.mjs";
  *
  * > This function is async because it has to load the CSS via a network call.
  *
+ * @param options - Shadow root options. See {@link ContentScriptUiOptions} for
+ *   shared positioning, anchoring, `append`, and removal options.
  * @see https://wxt.dev/guide/essentials/content-scripts.html#shadow-root
  */
 declare function createShadowRootUi<TMounted>(ctx: ContentScriptContext, options: ShadowRootContentScriptUiOptions<TMounted>): Promise<ShadowRootContentScriptUi<TMounted>>;

package/dist/utils/content-script-ui/shadow-root.mjs

@@ -11,6 +11,8 @@ import { createIsolatedElement } from "@webext-core/isolated-element";
 *
 * > This function is async because it has to load the CSS via a network call.
 *
+* @param options - Shadow root options. See {@link ContentScriptUiOptions} for
+*   shared positioning, anchoring, `append`, and removal options.
 * @see https://wxt.dev/guide/essentials/content-scripts.html#shadow-root
 */
 async function createShadowRootUi(ctx, options) {

package/dist/version.mjs

@@ -1,4 +1,4 @@
 //#region src/version.ts
-const version = "0.21.2";
+const version = "0.21.4";
 //#endregion
 export { version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.21.2",
+  "version": "0.21.4",
   "description": "⚡ Next-gen Web Extension Framework",
   "license": "MIT",
   "scripts": {
@@ -17,39 +17,31 @@
   "dependencies": {
     "@1natsu/wait-element": "^4.1.2",
     "@aklinker1/rollup-plugin-visualizer": "5.12.0",
+    "@aklinker1/zero-zip": "^1.0.1",
+    "@topcli/prompts": "^4.0.0",
     "@webext-core/fake-browser": "^2.0.1",
     "@webext-core/isolated-element": "^1.1.3 || ^2 || ^3",
     "@webext-core/match-patterns": "^2.0.0",
-    "@wxt-dev/browser": "^0.2.2",
+    "@wxt-dev/browser": ">=0.1",
     "@wxt-dev/storage": "^1.0.0",
-    "async-mutex": "^0.5.0",
     "c12": "^3.3.4",
     "cac": "^6.7.14 || ^7.0.0",
     "chokidar": "^5.0.0",
-    "ci-info": "^4.4.0",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
     "dotenv-expand": "^13.0.0",
     "filesize": "^11.0.17",
-    "get-port-please": "^3.2.0",
     "giget": "^1.2.3 || ^2.0.0 || ^3.0.0",
     "hookable": "^6.1.0",
-    "import-meta-resolve": "^4.2.0",
-    "is-wsl": "^3.1.1",
     "json5": "^2.2.3",
-    "jszip": "^3.10.1",
     "linkedom": "^0.18.12",
     "magicast": "^0.5.2",
-    "nano-spawn": "^2.0.0",
-    "nanospinner": "^1.2.2",
-    "normalize-path": "^3.0.0",
     "nypm": "^0.6.5",
-    "ohash": "^2.0.11",
-    "open": "^11.0.0",
     "picomatch": "^4.0.3",
-    "prompts": "^2.4.2",
-    "publish-browser-extension": "^5.1.0",
-    "scule": "^1.3.0",
+    "publish-browser-extension": "^5.1.0 || ^6.0.0",
+    "superlock": "^1.3.2",
+    "tiny-open": "^1.3.0",
+    "tinyexec": "^1.2.4",
     "tinyglobby": "^0.2.16",
     "unimport": "^3.13.1 || ^4.0.0 || ^5.0.0 || ^6.0.0"
   },
@@ -81,15 +73,20 @@
     "@types/prompts": "^2.4.9",
     "eslint": "^10.1.0",
     "extract-zip": "^2.0.1",
+    "get-port-please": "^3.2.0",
     "happy-dom": "^20.8.3",
+    "is-wsl": "^3.1.1",
     "lodash.merge": "^4.6.2",
+    "normalize-path": "^3.0.0",
+    "ohash": "^2.0.11",
     "oxlint": "^1.63.0",
     "publint": "^0.3.18",
+    "scule": "^1.3.0",
     "tsdown": "^0.21.0",
     "typescript": "^6.0.3",
-    "vite": "^7.3.1",
-    "vitest": "^4.1.5",
-    "vitest-plugin-random-seed": "^1.1.2",
+    "vite": "^8.2.0",
+    "vitest": "^4.1.10",
+    "vitest-plugin-random-seed": "^2.0.2",
     "web-ext": "^10.5.0"
   },
   "repository": {