wxt 0.20.13 → 0.20.14

package/dist/core/utils/testing/fake-objects.mjs

@@ -1,326 +0,0 @@
-import { resolve } from "path";
-import { faker } from "@faker-js/faker";
-import merge from "lodash.merge";
-import { mock } from "vitest-mock-extended";
-import { vi } from "vitest";
-import { setWxtForTesting } from "../../../core/wxt.mjs";
-faker.seed(import.meta.test.SEED);
-function fakeObjectCreator(base) {
-  return (overrides) => merge(base(), overrides);
-}
-export function fakeFileName() {
-  return faker.string.alphanumeric() + "." + faker.string.alpha({ length: 3 });
-}
-export function fakeFile(root = process.cwd()) {
-  return resolve(root, fakeFileName());
-}
-export function fakeDir(root = process.cwd()) {
-  return resolve(root, faker.string.alphanumeric());
-}
-export const fakeEntrypoint = (options) => faker.helpers.arrayElement([
-  fakePopupEntrypoint,
-  fakeGenericEntrypoint,
-  fakeOptionsEntrypoint,
-  fakeBackgroundEntrypoint,
-  fakeContentScriptEntrypoint,
-  fakeUnlistedScriptEntrypoint
-])(options);
-export const fakeContentScriptEntrypoint = fakeObjectCreator(() => ({
-  type: "content-script",
-  inputPath: fakeFile("src"),
-  name: faker.string.alpha(),
-  options: {
-    matches: [],
-    matchAboutBlank: faker.datatype.boolean(),
-    matchOriginAsFallback: faker.helpers.arrayElement([
-      true,
-      false,
-      void 0
-    ]),
-    runAt: faker.helpers.arrayElement([
-      "document_start",
-      "document_end",
-      "document_idle",
-      void 0
-    ])
-  },
-  outputDir: fakeDir(".output"),
-  skipped: faker.datatype.boolean()
-}));
-export const fakeBackgroundEntrypoint = fakeObjectCreator(
-  () => ({
-    type: "background",
-    inputPath: "entrypoints/background.ts",
-    name: "background",
-    options: {
-      persistent: faker.datatype.boolean(),
-      type: faker.helpers.maybe(() => "module")
-    },
-    outputDir: fakeDir(".output"),
-    skipped: faker.datatype.boolean()
-  })
-);
-export const fakeUnlistedScriptEntrypoint = fakeObjectCreator(() => ({
-  type: "unlisted-script",
-  inputPath: fakeFile("src"),
-  name: faker.string.alpha(),
-  outputDir: fakeDir(".output"),
-  options: {},
-  skipped: faker.datatype.boolean()
-}));
-export const fakeOptionsEntrypoint = fakeObjectCreator(
-  () => ({
-    type: "options",
-    inputPath: "entrypoints/options.html",
-    name: "options",
-    outputDir: fakeDir(".output"),
-    options: {
-      browserStyle: faker.datatype.boolean(),
-      chromeStyle: faker.datatype.boolean(),
-      openInTab: faker.datatype.boolean()
-    },
-    skipped: faker.datatype.boolean()
-  })
-);
-export const fakePopupEntrypoint = fakeObjectCreator(() => ({
-  type: "popup",
-  inputPath: "entrypoints/popup.html",
-  name: "popup",
-  outputDir: fakeDir(".output"),
-  options: {
-    defaultTitle: faker.helpers.arrayElement([
-      faker.person.fullName(),
-      void 0
-    ]),
-    defaultIcon: faker.helpers.arrayElement([
-      {
-        "16": "icon/16.png",
-        "24": "icon/24.png",
-        "64": "icon/64.png"
-      }
-    ]),
-    mv2Key: faker.helpers.arrayElement([
-      "browser_action",
-      "page_action",
-      void 0
-    ])
-  },
-  skipped: faker.datatype.boolean()
-}));
-export const fakeSidepanelEntrypoint = fakeObjectCreator(
-  () => ({
-    type: "sidepanel",
-    inputPath: "entrypoints/sidepanel.html",
-    name: "sidepanel",
-    outputDir: fakeDir(".output"),
-    options: {
-      defaultTitle: faker.helpers.arrayElement([
-        faker.person.fullName(),
-        void 0
-      ]),
-      defaultIcon: faker.helpers.arrayElement([
-        {
-          "16": "icon/16.png",
-          "24": "icon/24.png",
-          "64": "icon/64.png"
-        }
-      ]),
-      openAtInstall: faker.helpers.arrayElement([true, false, void 0])
-    },
-    skipped: faker.datatype.boolean()
-  })
-);
-export const fakeGenericEntrypoint = fakeObjectCreator(
-  () => ({
-    type: faker.helpers.arrayElement([
-      "sandbox",
-      "bookmarks",
-      "history",
-      "newtab",
-      "devtools",
-      "unlisted-page",
-      "unlisted-script"
-    ]),
-    inputPath: fakeFile("src"),
-    name: faker.string.alpha(),
-    outputDir: fakeDir(".output"),
-    options: {},
-    skipped: faker.datatype.boolean()
-  })
-);
-export const fakeOutputChunk = fakeObjectCreator(() => ({
-  type: "chunk",
-  fileName: faker.string.alphanumeric(),
-  moduleIds: []
-}));
-export const fakeOutputAsset = fakeObjectCreator(() => ({
-  type: "asset",
-  fileName: fakeFileName()
-}));
-export function fakeOutputFile() {
-  return faker.helpers.arrayElement([fakeOutputAsset(), fakeOutputChunk()]);
-}
-export const fakeManifest = fakeObjectCreator(() => ({
-  manifest_version: faker.helpers.arrayElement([2, 3]),
-  name: faker.string.alphanumeric(),
-  version: `${faker.number.int()}.${faker.number.int()}.${faker.number.int()}`
-}));
-export const fakeUserManifest = fakeObjectCreator(() => ({
-  name: faker.string.alphanumeric(),
-  version: `${faker.number.int()}.${faker.number.int()}.${faker.number.int()}`
-}));
-export function fakeArray(createItem, count = 3) {
-  const array = [];
-  for (let i = 0; i < count; i++) {
-    array.push(createItem());
-  }
-  return array;
-}
-export const fakeResolvedConfig = fakeObjectCreator(() => {
-  const browser = faker.helpers.arrayElement(["chrome", "firefox"]);
-  const command = faker.helpers.arrayElement(["build", "serve"]);
-  const manifestVersion = faker.helpers.arrayElement([2, 3]);
-  const mode = faker.helpers.arrayElement(["development", "production"]);
-  return {
-    browser,
-    targetBrowsers: [],
-    command,
-    entrypointsDir: fakeDir(),
-    modulesDir: fakeDir(),
-    builtinModules: [],
-    userModules: [],
-    env: { browser, command, manifestVersion, mode },
-    fsCache: mock(),
-    imports: {
-      disabled: faker.datatype.boolean(),
-      eslintrc: {
-        enabled: faker.helpers.arrayElement([false, 8, 9]),
-        filePath: fakeFile(),
-        globalsPropValue: faker.helpers.arrayElement([
-          true,
-          false,
-          "readable",
-          "readonly",
-          "writable",
-          "writeable"
-        ])
-      }
-    },
-    logger: mock(),
-    manifest: fakeUserManifest(),
-    manifestVersion,
-    mode,
-    outBaseDir: fakeDir(),
-    outDir: fakeDir(),
-    publicDir: fakeDir(),
-    root: fakeDir(),
-    wxtModuleDir: fakeDir(),
-    runnerConfig: {
-      config: {}
-    },
-    debug: faker.datatype.boolean(),
-    srcDir: fakeDir(),
-    typesDir: fakeDir(),
-    wxtDir: fakeDir(),
-    analysis: {
-      enabled: false,
-      open: false,
-      template: "treemap",
-      outputFile: fakeFile(),
-      outputDir: fakeDir(),
-      outputName: "stats",
-      keepArtifacts: false
-    },
-    zip: {
-      artifactTemplate: "{{name}}-{{version}}.zip",
-      includeSources: [],
-      excludeSources: [],
-      exclude: [],
-      sourcesRoot: fakeDir(),
-      sourcesTemplate: "{{name}}-sources.zip",
-      name: faker.person.firstName().toLowerCase(),
-      downloadedPackagesDir: fakeDir(),
-      downloadPackages: [],
-      compressionLevel: 9,
-      zipSources: false
-    },
-    userConfigMetadata: {},
-    alias: {},
-    experimental: {},
-    dev: {
-      reloadCommand: "Alt+R"
-    },
-    hooks: {},
-    vite: () => ({}),
-    plugins: []
-  };
-});
-export const fakeWxt = fakeObjectCreator(() => ({
-  config: fakeResolvedConfig(),
-  hook: vi.fn(),
-  hooks: mock(),
-  logger: mock(),
-  reloadConfig: vi.fn(),
-  pm: mock(),
-  server: faker.helpers.arrayElement([void 0, fakeWxtDevServer()]),
-  builder: mock()
-}));
-export const fakeWxtDevServer = fakeObjectCreator(() => ({
-  currentOutput: fakeBuildOutput(),
-  host: "localhost",
-  port: 3e3,
-  origin: "http://localhost:3000",
-  reloadContentScript: vi.fn(),
-  reloadExtension: vi.fn(),
-  reloadPage: vi.fn(),
-  restart: vi.fn(),
-  restartBrowser: vi.fn(),
-  start: vi.fn(),
-  stop: vi.fn(),
-  transformHtml: vi.fn(),
-  watcher: mock(),
-  ws: mock()
-}));
-export function setFakeWxt(overrides) {
-  const wxt = fakeWxt(overrides);
-  setWxtForTesting(wxt);
-  return wxt;
-}
-export const fakeBuildOutput = fakeObjectCreator(() => ({
-  manifest: fakeManifest(),
-  publicAssets: fakeArray(fakeOutputAsset),
-  steps: fakeArray(fakeBuildStepOutput)
-}));
-export const fakeBuildStepOutput = fakeObjectCreator(() => ({
-  chunks: fakeArray(fakeOutputChunk),
-  entrypoints: fakeArray(fakeEntrypoint)
-}));
-export const fakeManifestCommand = fakeObjectCreator(
-  () => ({
-    description: faker.string.sample(),
-    suggested_key: {
-      default: `${faker.helpers.arrayElement(["ctrl", "alt"])}+${faker.number.int(
-        {
-          min: 0,
-          max: 9
-        }
-      )}`
-    }
-  })
-);
-export const fakeDevServer = fakeObjectCreator(() => ({
-  host: "localhost",
-  port: 5173,
-  origin: "http://localhost:3000",
-  reloadContentScript: vi.fn(),
-  reloadExtension: vi.fn(),
-  reloadPage: vi.fn(),
-  restart: vi.fn(),
-  restartBrowser: vi.fn(),
-  stop: vi.fn(),
-  start: vi.fn(),
-  watcher: mock(),
-  transformHtml: vi.fn(),
-  ws: mock(),
-  currentOutput: void 0
-}));

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

@@ -1,9 +0,0 @@
-export declare function formatDuration(duration: number): string;
-/**
- * Add a timeout to a promise.
- */
-export declare function withTimeout<T>(promise: Promise<T>, duration: number): Promise<T>;
-/**
- * @deprecated Don't use in production, just for testing and slowing things down.
- */
-export declare function sleep(ms: number): Promise<void>;

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

@@ -1,11 +0,0 @@
-/**
- * Removes any code used at runtime related to an entrypoint's main function.
- * 1. Removes or clears out `main` function from returned object
- * 2. Removes any unused functions/variables outside the definition that aren't being called/used
- * 3. Removes unused imports
- * 3. Removes value-less, side-effect only imports (like `import "./styles.css"` or `import "polyfill"`)
- */
-export declare function removeMainFunctionCode(code: string): {
-    code: string;
-    map?: string;
-};

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

@@ -1,13 +0,0 @@
-import type { Browser } from '@wxt-dev/browser';
-/**
- * Remove optional from key, but keep undefined if present
- *
- * @example
- * type Test = NullablyRequired<{a?: string, b: number}>
- * // type Test = {a: string | undefined, b: number}
- */
-export type NullablyRequired<T> = {
-    [K in keyof Required<T>]: T[K];
-};
-export type ManifestContentScript = NonNullable<Browser.runtime.Manifest['content_scripts']>[number];
-export type ManifestV3WebAccessibleResource = NonNullable<Browser.runtime.ManifestV3['web_accessible_resources']>[number];

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

@@ -1,15 +0,0 @@
-import { Entrypoint } from '../../types';
-export declare function validateEntrypoints(entrypoints: Entrypoint[]): ValidationResults;
-export interface ValidationResult {
-    type: 'warning' | 'error';
-    message: string;
-    entrypoint: Entrypoint;
-    value: any;
-}
-export interface ValidationResults {
-    errors: ValidationResult[];
-    errorCount: number;
-    warningCount: number;
-}
-export declare class ValidationError extends Error {
-}

package/dist/core/utils/virtual-modules.d.ts

@@ -1,22 +0,0 @@
-export declare const virtualEntrypointTypes: ("background" | "unlisted-script" | "content-script-main-world" | "content-script-isolated-world")[];
-export type VirtualEntrypointType = (typeof virtualEntrypointTypes)[0];
-/**
- * All the names of entrypoint files in the `src/virtual/` and `dist/virtual/` directories, minus the extension.
- */
-export declare const virtualEntrypointModuleNames: ("background-entrypoint" | "unlisted-script-entrypoint" | "content-script-main-world-entrypoint" | "content-script-isolated-world-entrypoint")[];
-/**
- * Name of entrypoint files in the `src/virtual/` and `dist/virtual/` directories, minus the extension.
- */
-export type VirtualEntrypointModuleName = (typeof virtualEntrypointModuleNames)[0];
-/**
- * All the names of files in the `src/virtual/` and `dist/virtual/` directories, minus the extension.
- */
-export declare const virtualModuleNames: ("background-entrypoint" | "unlisted-script-entrypoint" | "content-script-main-world-entrypoint" | "content-script-isolated-world-entrypoint" | "mock-browser" | "reload-html")[];
-/**
- * Name of files in the `src/virtual/` and `dist/virtual/` directories, minus the extension.
- */
-export type VirtualModuleName = (typeof virtualModuleNames)[0];
-/**
- * Import alias used for importing a virtual module
- */
-export type VirtualModuleId = `virtual:wxt-${VirtualModuleName}`;

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

@@ -1,4 +0,0 @@
-/**
- * Returns true when running on WSL or WSL2.
- */
-export declare function isWsl(): Promise<boolean>;

package/dist/core/wxt.d.ts

@@ -1,24 +0,0 @@
-import { InlineConfig, Wxt, WxtCommand } from '../types';
-/**
- * Global variable set once `createWxt` is called once. Since this variable is used everywhere, this
- * global can be used instead of passing the variable as a function parameter everywhere.
- */
-export declare let wxt: Wxt;
-/**
- * Create and register a global instance of the Wxt interface for use throughout the project.
- */
-export declare function registerWxt(command: WxtCommand, inlineConfig?: InlineConfig): Promise<void>;
-export declare function initWxtModules(): Promise<void>;
-/**
- * Unloads WXT modules.
- */
-export declare function deinitWxtModules(): void;
-/**
- * @internal ONLY USE FOR TESTING.
- *
- * @example
- * setWxtForTesting(fakeWxt({ ... }));
- * // Or use the shorthand
- * setFakeWxt({ ... })
- */
-export declare function setWxtForTesting(testInstance: Wxt): void;

package/dist/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * This module contains:
- * - JS APIs used by the CLI to build extensions or start dev mode.
- * - Helper functions for defining project config.
- * - Types for building and extension or configuring WXT.
- *
- * @module wxt
- */
-export * from './core';
-export * from './types';
-export * from './version';

package/dist/testing/fake-browser.d.ts

@@ -1,10 +0,0 @@
-/**
- * The fake browser is automatically used as a mock for the `wxt/browser` import
- * when using `wxt/testing/vitest-plugin` with Vitest. It is also setup to
- * reset all state before each test.
- *
- * This module is just a re-export of [@webext-core/fake-browser](https://webext-core.aklinker1.io/fake-browser/triggering-events).
- *
- * @module wxt/testing/fake-browser
- */
-export { fakeBrowser, type FakeBrowser } from '@webext-core/fake-browser';

package/dist/testing/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Utilities for unit testing WXT extensions.
- *
- * @deprecated Use `wxt/testing/*` instead to prevent issues with JSDOM or
- * HappyDOM environments. Will be removed in the next major version of WXT.
- *
- * @module wxt/testing
- */
-export * from './fake-browser';
-export * from './wxt-vitest-plugin';