bump version for early release

update test snapshot
get it working
2024-04-19 20:34:36 -05:00 · 2024-04-19 20:33:21 -05:00 · 2024-04-19 20:31:32 -05:00 · 2024-04-19 16:25:17 -05:00 · 2024-04-19 15:59:14 -05:00 · 2024-04-19 08:00:41 -05:00
54 changed files with 1016 additions and 367 deletions
@@ -1,5 +1,51 @@
 # Changelog

+## v0.17.12
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/v0.17.11...v0.17.12)
+
+### 🚀 Enhancements
+
+- Add hooks for extending vite config ([#599](https://github.com/wxt-dev/wxt/pull/599))
+
+### 🩹 Fixes
+
+- **content-script-ui:** Properly assign and unassign mounted value ([#598](https://github.com/wxt-dev/wxt/pull/598))
+
+### 📖 Documentation
+
+- Add discord server link ([#593](https://github.com/wxt-dev/wxt/pull/593))
+
+### 🏡 Chore
+
+- Remove unnecssary 'Omit' types ([db57c8e](https://github.com/wxt-dev/wxt/commit/db57c8e))
+- **deps-dev:** Bump @aklinker1/check from 1.1.1 to 1.2.0 ([#588](https://github.com/wxt-dev/wxt/pull/588))
+- **deps-dev:** Bump vue from 3.3.10 to 3.4.21 ([#589](https://github.com/wxt-dev/wxt/pull/589))
+- **deps-dev:** Bump sass from 1.69.5 to 1.72.0 ([#591](https://github.com/wxt-dev/wxt/pull/591))
+
+## v0.17.11
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/v0.17.10...v0.17.11)
+
+### 🩹 Fixes
+
+- Resolve absolute paths from the public directory properly ([#583](https://github.com/wxt-dev/wxt/pull/583))
+
+### 📖 Documentation
+
+- Fix `zip.includeSources` example ([16fc584](https://github.com/wxt-dev/wxt/commit/16fc584))
+- Add "GitHub Custom Notifier" to homepage ([#580](https://github.com/wxt-dev/wxt/pull/580))
+
+### 🏡 Chore
+
+- Simplify virtual module setup ([#581](https://github.com/wxt-dev/wxt/pull/581))
+- Add some array utils ([#582](https://github.com/wxt-dev/wxt/pull/582))
+- Extract helper function ([d3b14af](https://github.com/wxt-dev/wxt/commit/d3b14af))
+
+### ❤️ Contributors
+
+- Qiwei Yang ([@qiweiii](http://github.com/qiweiii))
+
 ## v0.17.10

 [compare changes](https://github.com/wxt-dev/wxt/compare/v0.17.9...v0.17.10)
@@ -29,6 +29,8 @@
  <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)
@@ -1,4 +1,4 @@
-import messages from 'public/_locales/en/messages.json';
+import messages from '~/public/_locales/en/messages.json';

 export default defineBackground({
  // type: 'module',
@@ -12,9 +12,6 @@ export default defineConfig({
      },
    ],
  },
-  alias: {
-    public: 'src/public',
-  },
  zip: {
    downloadPackages: ['sass'],
  },
@@ -21,6 +21,10 @@ const chromeExtensionIds = [
  'aiakblgmlabokilgljkglggnpflljdgp', // Markdown Sticky Notes
  'nomnkbngkijpffepcgbbofhcnafpkiep', // DocVersionRedirector
  'ceicccfeikoipigeghddpocceifjelph', // Plex Skipper
+  'aelkipgppclpfimeamgmlonimflbhlgf', // GitHub Custom Notifier
+  'djnlaiohfaaifbibleebjggkghlmcpcj', // Fluent Read
+  'nhclljcpfmmaiojbhhnkpjcfmacfcian', // Facebook Video Controls
+  'mblkhbaakhbhiimkbcnmeciblfhmafna', // ElemSnap - Quick capture of webpage elements and conversion to images
 ];

 const { data, err, isLoading } = useListExtensionDetails(chromeExtensionIds);
@@ -146,6 +146,9 @@ export default defineConfig({
      ],
    },

-    socialLinks: [{ icon: 'github', link: 'https://github.com/wxt-dev/wxt' }],
+    socialLinks: [
+      { icon: 'discord', link: 'https://discord.gg/ZFsZqGery9' },
+      { icon: 'github', link: 'https://github.com/wxt-dev/wxt' },
+    ],
  },
 });
@@ -63,7 +63,7 @@ Files in the assets directory will be processed by Vite. They are imported in yo
    <!-- ... -->
  </head>
  <body>
-    <img src="~/illustration.svg" />
+    <img src="~/assets/illustration.svg" />
    <!-- ... -->
  </body>
 </html>
@@ -89,7 +89,7 @@ For a full list of entrypoints and each of their options, see the [`/entrypoints

 ### Side Effects

-You cannot use imported variables outside the `main` function is JS entrypoints. This includes options, as shown below:
+You cannot use imported variables outside the `main` function in JS entrypoints. This includes options, as shown below:

 ```ts
 // entrypoints/content.ts
@@ -39,9 +39,9 @@ Then we can use `browser.storage` to save the install date to local storage.
 ```ts
 // background.ts
 export default defineBackground(() => {
-  browser.runtime.onInstall.addEventListener(({ reason }) => {
+  browser.runtime.onInstalled.addListener(({ reason }) => {
    if (reason === 'install') {
-      browser.storage.local.setItem({ installDate: Date.now() });
+      browser.storage.local.set({ installDate: Date.now() });
    }
  });
 });
@@ -11,7 +11,7 @@ The manifest.json is generated at build-time based on files in the `entrypoints/
 While entrypoints are generated and added to the manifest at build-time, you can customize or add to your `manifest.json` in the config file.

 ```ts
-// wxt.config.tsentrypoint of your extension
+// wxt.config.ts entrypoint of your extension
 import { defineConfig } from 'wxt';

 export default defineConfig({
@@ -9,16 +9,21 @@ const hooks: WxtHooks = {
  'build:manifestGenerated': vi.fn(),
  'entrypoints:resolved': vi.fn(),
  'entrypoints:grouped': vi.fn(),
+  'vite:build:extendConfig': vi.fn(),
+  'vite:devServer:extendConfig': vi.fn(),
 };

-function expectHooksToBeCalled(called: Record<keyof WxtHooks, boolean>) {
+function expectHooksToBeCalled(
+  called: Record<keyof WxtHooks, boolean | number>,
+) {
  Object.keys(hooks).forEach((key) => {
    const hookName = key as keyof WxtHooks;
-    const times = called[hookName] ? 1 : 0;
+    const value = called[hookName];
+    const times = typeof value === 'number' ? value : value ? 1 : 0;
    expect(
      hooks[hookName],
      `Expected "${hookName}" to be called ${times} time(s)`,
-    ).toBeCalledTimes(called[hookName] ? 1 : 0);
+    ).toBeCalledTimes(times);
  });
 }

@@ -40,6 +45,8 @@ describe('Hooks', () => {
      'build:manifestGenerated': false,
      'entrypoints:grouped': false,
      'entrypoints:resolved': true,
+      'vite:build:extendConfig': false,
+      'vite:devServer:extendConfig': false,
    });
  });

@@ -56,6 +63,8 @@ describe('Hooks', () => {
      'build:manifestGenerated': true,
      'entrypoints:grouped': true,
      'entrypoints:resolved': true,
+      'vite:build:extendConfig': 1,
+      'vite:devServer:extendConfig': false,
    });
  });

@@ -72,6 +81,8 @@ describe('Hooks', () => {
      'build:manifestGenerated': true,
      'entrypoints:grouped': true,
      'entrypoints:resolved': true,
+      'vite:build:extendConfig': 1,
+      'vite:devServer:extendConfig': false,
    });
  });

@@ -94,6 +105,8 @@ describe('Hooks', () => {
      'build:manifestGenerated': true,
      'entrypoints:grouped': true,
      'entrypoints:resolved': true,
+      'vite:build:extendConfig': 2,
+      'vite:devServer:extendConfig': 1,
    });
  });
 });
@@ -272,7 +272,7 @@ describe('Output Directory Structure', () => {
      .toMatchInlineSnapshot(`
        ".output/chrome-mv3/background.js
        ----------------------------------------
-        import { l as logHello } from "./chunks/log-bezs0tt4.js";
+        import { l as logHello } from "./chunks/log-BsZv2eRn.js";
        function defineBackground(arg) {
          if (typeof arg === "function")
            return { main: arg };
@@ -362,11 +362,13 @@ describe('Output Directory Structure', () => {
          function logHello(name) {
            console.log(\`Hello \${name}!\`);
          }
+          _background;
          const definition = defineBackground({
            main() {
              logHello("background");
            }
          });
+          _background;
          chrome;
          function print(method, ...args) {
            return;
@@ -389,6 +391,7 @@ describe('Output Directory Structure', () => {
            throw err;
          }
        })();
+        _background;
        "
      `);
  });
@@ -1,7 +1,7 @@
 {
  "name": "wxt",
  "type": "module",
-  "version": "0.17.10",
+  "version": "0.17.13-alpha1",
  "description": "Next gen framework for developing web extensions",
  "engines": {
    "node": ">=18",
@@ -136,7 +136,7 @@
    "prompts": "^2.4.2",
    "publish-browser-extension": "^2.1.3",
    "unimport": "^3.4.0",
-    "vite": "^5.1.3",
+    "vite": "^5.2.8",
    "web-ext-run": "^0.2.0",
    "webextension-polyfill": "^0.10.0"
  },
@@ -8,6 +8,10 @@ import { consola } from 'consola';
 import pMap from 'p-map';
 import os from 'node:os';
 import path from 'node:path';
+import {
+  virtualModuleNames,
+  virtualEntrypointModuleNames,
+} from '~/core/utils/virtual-modules';

 const spinnerText = 'Building WXT';
 const spinner = ora(spinnerText).start();
@@ -20,12 +24,7 @@ const preset = {
  dts: true,
  silent: true,
  sourcemap: false,
-  external: [
-    'virtual:user-unlisted-script',
-    'virtual:user-content-script-isolated-world',
-    'virtual:user-content-script-main-world',
-    'virtual:user-background',
-  ],
+  external: virtualEntrypointModuleNames.map((name) => `virtual:user-${name}`),
 } satisfies tsup.Options;

 function spinnerPMap(configs: tsup.Options[]) {
@@ -74,17 +73,13 @@ const config: tsup.Options[] = [
  },
  {
    ...preset,
-    entry: {
-      'virtual/background-entrypoint': 'src/virtual/background-entrypoint.ts',
-      'virtual/content-script-isolated-world-entrypoint':
-        'src/virtual/content-script-isolated-world-entrypoint.ts',
-      'virtual/content-script-main-world-entrypoint':
-        'src/virtual/content-script-main-world-entrypoint.ts',
-      'virtual/mock-browser': 'src/virtual/mock-browser.ts',
-      'virtual/reload-html': 'src/virtual/reload-html.ts',
-      'virtual/unlisted-script-entrypoint':
-        'src/virtual/unlisted-script-entrypoint.ts',
-    },
+    entry: virtualModuleNames.reduce<Record<string, string>>(
+      (acc, moduleName) => {
+        acc[`virtual/${moduleName}`] = `src/virtual/${moduleName}.ts`;
+        return acc;
+      },
+      {},
+    ),
    format: ['esm'],
    splitting: false,
    dts: false,
@@ -1,5 +1,6 @@
 import { CAC, Command } from 'cac';
 import consola, { LogLevels } from 'consola';
+import { filterTruthy, toArray } from '~/core/utils/arrays';
 import { printHeader } from '~/core/utils/log';
 import { formatDuration } from '~/core/utils/time';
 import { ValidationError } from '~/core/utils/validation';
@@ -56,8 +57,8 @@ export function getArrayFromFlags<T>(
  flags: any,
  name: string,
 ): T[] | undefined {
-  const array = [flags[name]].flat() as Array<T | undefined>;
-  const result = array.filter((item) => item != null) as T[];
+  const array = toArray<T | undefined>(flags[name]);
+  const result = filterTruthy(array);
  return result.length ? result : undefined;
 }

@@ -404,4 +404,62 @@ describe('Content Script UIs', () => {
      });
    });
  });
+
+  describe('mounted value', () => {
+    describe('integrated', () => {
+      it('should set the mounted value based on the onMounted return value', () => {
+        const expected = Symbol();
+
+        const ui = createIntegratedUi(new ContentScriptContext('test'), {
+          position: 'inline',
+          onMount: () => expected,
+        });
+        expect(ui.mounted).toBeUndefined();
+
+        ui.mount();
+        expect(ui.mounted).toBe(expected);
+
+        ui.remove();
+        expect(ui.mounted).toBeUndefined();
+      });
+    });
+
+    describe('iframe', () => {
+      it('should set the mounted value based on the onMounted return value', async () => {
+        const expected = Symbol();
+
+        const ui = createIframeUi(new ContentScriptContext('test'), {
+          page: '',
+          position: 'inline',
+          onMount: () => expected,
+        });
+        expect(ui.mounted).toBeUndefined();
+
+        ui.mount();
+        expect(ui.mounted).toBe(expected);
+
+        ui.remove();
+        expect(ui.mounted).toBeUndefined();
+      });
+    });
+
+    describe('shadow-root', () => {
+      it('should set the mounted value based on the onMounted return value', async () => {
+        const expected = Symbol();
+
+        const ui = await createShadowRootUi(new ContentScriptContext('test'), {
+          name: 'test',
+          position: 'inline',
+          onMount: () => expected,
+        });
+        expect(ui.mounted).toBeUndefined();
+
+        ui.mount();
+        expect(ui.mounted).toBe(expected);
+
+        ui.remove();
+        expect(ui.mounted).toBeUndefined();
+      });
+    });
+  });
 });
@@ -35,12 +35,15 @@ export function createIntegratedUi<TMounted>(
  const remove = () => {
    options.onRemove?.(mounted);
    wrapper.remove();
+    mounted = undefined;
  };

  ctx.onInvalidated(remove);

  return {
-    mounted,
+    get mounted() {
+      return mounted;
+    },
    wrapper,
    mount,
    remove,
@@ -71,12 +74,15 @@ export function createIframeUi<TMounted>(
  const remove = () => {
    options.onRemove?.(mounted);
    wrapper.remove();
+    mounted = undefined;
  };

  ctx.onInvalidated(remove);

  return {
-    mounted,
+    get mounted() {
+      return mounted;
+    },
    iframe,
    wrapper,
    mount,
@@ -116,7 +122,7 @@ export async function createShadowRootUi<TMounted>(
  });
  shadowHost.setAttribute('data-wxt-shadow-root', '');

-  let mounted: TMounted;
+  let mounted: TMounted | undefined;

  const mount = () => {
    // Add shadow root element to DOM
@@ -134,6 +140,8 @@ export async function createShadowRootUi<TMounted>(
    // Remove children from uiContainer
    while (uiContainer.lastChild)
      uiContainer.removeChild(uiContainer.lastChild);
+    // Clear mounted value
+    mounted = undefined;
  };

  ctx.onInvalidated(remove);
@@ -144,7 +152,9 @@ export async function createShadowRootUi<TMounted>(
    uiContainer,
    mount,
    remove,
-    mounted: mounted!,
+    get mounted() {
+      return mounted;
+    },
  };
 }

@@ -3,19 +3,27 @@ import {
  BuildStepOutput,
  Entrypoint,
  ResolvedConfig,
-  VirtualEntrypointType,
  WxtBuilder,
  WxtBuilderServer,
  WxtDevServer,
+  WxtHooks,
 } from '~/types';
 import * as wxtPlugins from './plugins';
 import {
  getEntrypointBundlePath,
  isHtmlEntrypoint,
 } from '~/core/utils/entrypoints';
+import {
+  VirtualEntrypointType,
+  VirtualModuleId,
+} from '~/core/utils/virtual-modules';
+import { Hookable } from 'hookable';
+import { toArray } from '~/core/utils/arrays';
+import { safeVarName } from '~/core/utils/strings';

 export async function createViteBuilder(
  wxtConfig: ResolvedConfig,
+  hooks: Hookable<WxtHooks>,
  server?: WxtDevServer,
 ): Promise<WxtBuilder> {
  const vite = await import('vite');
@@ -32,6 +40,8 @@ export async function createViteBuilder(
    config.mode = wxtConfig.mode;

    config.build ??= {};
+    config.publicDir = wxtConfig.publicDir;
+    config.build.copyPublicDir = false;
    config.build.outDir = wxtConfig.outDir;
    config.build.emptyOutDir = false;
    // Disable minification for the dev command
@@ -48,10 +58,7 @@ export async function createViteBuilder(
      wxtPlugins.download(wxtConfig),
      wxtPlugins.devHtmlPrerender(wxtConfig, server),
      wxtPlugins.unimport(wxtConfig),
-      wxtPlugins.virtualEntrypoint('background', wxtConfig),
-      wxtPlugins.virtualEntrypoint('content-script-isolated-world', wxtConfig),
-      wxtPlugins.virtualEntrypoint('content-script-main-world', wxtConfig),
-      wxtPlugins.virtualEntrypoint('unlisted-script', wxtConfig),
+      wxtPlugins.resolveVirtualModules(wxtConfig),
      wxtPlugins.devServerGlobals(wxtConfig, server),
      wxtPlugins.tsconfigPaths(wxtConfig),
      wxtPlugins.noopBackground(),
@@ -81,14 +88,22 @@ export async function createViteBuilder(
      plugins.push(wxtPlugins.cssEntrypoints(entrypoint, wxtConfig));
    }

+    const iifeReturnValueName = safeVarName(entrypoint.name);
    const libMode: vite.UserConfig = {
      mode: wxtConfig.mode,
      plugins,
+      esbuild: {
+        // Add a footer with the returned value so it can return values to `scripting.executeScript`
+        // Footer is added apart of esbuild to make sure it's not minified. It
+        // get's removed if added to `build.rollupOptions.output.footer`
+        // See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/scripting/executeScript#return_value
+        footer: iifeReturnValueName + ';',
+      },
      build: {
        lib: {
          entry,
          formats: ['iife'],
-          name: '_',
+          name: iifeReturnValueName,
          fileName: entrypoint.name,
        },
        rollupOptions: {
@@ -196,6 +211,11 @@ export async function createViteBuilder(
      else entryConfig = getLibModeConfig(group);

      const buildConfig = vite.mergeConfig(await getBaseConfig(), entryConfig);
+      await hooks.callHook(
+        'vite:build:extendConfig',
+        toArray(group),
+        buildConfig,
+      );
      const result = await vite.build(buildConfig);
      return {
        entrypoints: group,
@@ -212,9 +232,9 @@ export async function createViteBuilder(
        },
      };
      const baseConfig = await getBaseConfig();
-      const viteServer = await vite.createServer(
-        vite.mergeConfig(baseConfig, serverConfig),
-      );
+      const finalConfig = vite.mergeConfig(baseConfig, serverConfig);
+      await hooks.callHook('vite:devServer:extendConfig', finalConfig);
+      const viteServer = await vite.createServer(finalConfig);

      const server: WxtBuilderServer = {
        async listen() {
@@ -268,7 +288,10 @@ function getRollupEntry(entrypoint: Entrypoint): string {
          : 'content-script-isolated-world';
      break;
  }
-  return virtualEntrypointType
-    ? `virtual:wxt-${virtualEntrypointType}?${entrypoint.inputPath}`
-    : entrypoint.inputPath;
+
+  if (virtualEntrypointType) {
+    const moduleId: VirtualModuleId = `virtual:wxt-${virtualEntrypointType}-entrypoint`;
+    return `${moduleId}?${entrypoint.inputPath}`;
+  }
+  return entrypoint.inputPath;
 }
@@ -5,9 +5,8 @@ import path from 'node:path';

 let increment = 0;

-export function bundleAnalysis(
-  config: Omit<ResolvedConfig, 'builder'>,
-): vite.Plugin {
+export function bundleAnalysis(config: ResolvedConfig): vite.Plugin {
+  // @ts-expect-error: Vite/Rollup type mismatch, but it's fine.
  return visualizer({
    template: 'raw-data',
    filename: path.resolve(
@@ -14,7 +14,7 @@ import { getEntrypointBundlePath } from '~/core/utils/entrypoints';
 */
 export function cssEntrypoints(
  entrypoint: Entrypoint,
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
 ): vite.Plugin {
  return {
    name: 'wxt:css-entrypoint',
@@ -12,7 +12,7 @@ let reactRefreshPreamble = '';
 * Pre-renders the HTML entrypoints when building the extension to connect to the dev server.
 */
 export function devHtmlPrerender(
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
  server: WxtDevServer | undefined,
 ): vite.PluginOption {
  const htmlReloadId = '@wxt/reload-html';
@@ -133,7 +133,7 @@ export function devHtmlPrerender(
 }

 export function pointToDevServer(
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
  server: WxtDevServer,
  id: string,
  document: Document,
@@ -5,7 +5,7 @@ import { ResolvedConfig, WxtDevServer } from '~/types';
 * Defines global constants about the dev server. Helps scripts connect to the server's web socket.
 */
 export function devServerGlobals(
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
  server: WxtDevServer | undefined,
 ): Plugin {
  return {
@@ -9,7 +9,7 @@ import { fetchCached } from '~/core/utils/network';
 * @example
 * import "url:https://google-tagmanager.com/gtag?id=XYZ";
 */
-export function download(config: Omit<ResolvedConfig, 'builder'>): Plugin {
+export function download(config: ResolvedConfig): Plugin {
  return {
    name: 'wxt:download',
    resolveId(id) {
@@ -6,9 +6,7 @@ import type * as vite from 'vite';
 * `webextension-polyfill` module to a virtual module and exporting the `chrome` global from the
 * virtual module.
 */
-export function excludeBrowserPolyfill(
-  config: Omit<ResolvedConfig, 'builder'>,
-): vite.Plugin {
+export function excludeBrowserPolyfill(config: ResolvedConfig): vite.Plugin {
  const virtualId = 'virtual:wxt-webextension-polyfill-disabled';

  return {
@@ -2,9 +2,7 @@ import type * as vite from 'vite';
 import { ResolvedConfig } from '~/types';
 import { getGlobals } from '~/core/utils/globals';

-export function globals(
-  config: Omit<ResolvedConfig, 'builder'>,
-): vite.PluginOption {
+export function globals(config: ResolvedConfig): vite.PluginOption {
  return {
    name: 'wxt:globals',
    config() {
@@ -3,7 +3,7 @@ export * from './devServerGlobals';
 export * from './download';
 export * from './multipageMove';
 export * from './unimport';
-export * from './virtualEntrypoint';
+export * from './resolveVirtualModules';
 export * from './tsconfigPaths';
 export * from './noopBackground';
 export * from './cssEntrypoints';
@@ -20,7 +20,7 @@ import { normalizePath } from '~/core/utils/paths';
 */
 export function multipageMove(
  entrypoints: Entrypoint[],
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
 ): vite.Plugin {
  return {
    name: 'wxt:multipage-move',
@@ -0,0 +1,41 @@
+import { Plugin } from 'vite';
+import { ResolvedConfig } from '~/types';
+import { normalizePath } from '~/core/utils/paths';
+import {
+  VirtualModuleId,
+  virtualModuleNames,
+} from '~/core/utils/virtual-modules';
+import fs from 'fs-extra';
+import { resolve } from 'path';
+
+/**
+ * Resolve all the virtual modules to the `node_modules/wxt/dist/virtual` directory.
+ */
+export function resolveVirtualModules(config: ResolvedConfig): Plugin[] {
+  return virtualModuleNames.map((name) => {
+    const virtualId: `${VirtualModuleId}?` = `virtual:wxt-${name}?`;
+    const resolvedVirtualId = '\0' + virtualId;
+    return {
+      name: `wxt:resolve-virtual-${name}`,
+      resolveId(id) {
+        // Id doesn't start with prefix, it looks like this:
+        // /path/to/project/virtual:wxt-background?/path/to/project/entrypoints/background.ts
+        const index = id.indexOf(virtualId);
+        if (index === -1) return;
+
+        const inputPath = normalizePath(id.substring(index + virtualId.length));
+        return resolvedVirtualId + inputPath;
+      },
+      async load(id) {
+        if (!id.startsWith(resolvedVirtualId)) return;
+
+        const inputPath = id.replace(resolvedVirtualId, '');
+        const template = await fs.readFile(
+          resolve(config.wxtModuleDir, `dist/virtual/${name}.js`),
+          'utf-8',
+        );
+        return template.replace(`virtual:user-${name}`, inputPath);
+      },
+    };
+  });
+}
@@ -1,9 +1,7 @@
 import { ResolvedConfig } from '~/types';
 import type * as vite from 'vite';

-export function tsconfigPaths(
-  config: Omit<ResolvedConfig, 'builder'>,
-): vite.Plugin {
+export function tsconfigPaths(config: ResolvedConfig): vite.Plugin {
  return {
    name: 'wxt:aliases',
    async config() {
@@ -15,9 +15,7 @@ const ENABLED_EXTENSIONS = new Set([
 /**
 * Inject any global imports defined by unimport
 */
-export function unimport(
-  config: Omit<ResolvedConfig, 'builder'>,
-): vite.PluginOption {
+export function unimport(config: ResolvedConfig): vite.PluginOption {
  const options = config.imports;
  if (options === false) return [];

@@ -1,39 +0,0 @@
-import { Plugin } from 'vite';
-import { ResolvedConfig, VirtualEntrypointType } from '~/types';
-import fs from 'fs-extra';
-import { resolve } from 'path';
-import { normalizePath } from '~/core/utils/paths';
-
-/**
- * Wraps a user's entrypoint with a vitual version with additional logic.
- */
-export function virtualEntrypoint(
-  type: VirtualEntrypointType,
-  config: Omit<ResolvedConfig, 'builder'>,
-): Plugin {
-  const virtualId = `virtual:wxt-${type}?`;
-  const resolvedVirtualId = `\0${virtualId}`;
-
-  return {
-    name: `wxt:virtual-entrypoint`,
-    resolveId(id) {
-      // Id doesn't start with prefix, it looks like this:
-      // /path/to/project/virtual:background?/path/to/project/entrypoints/background.ts
-      const index = id.indexOf(virtualId);
-      if (index === -1) return;
-
-      const inputPath = normalizePath(id.substring(index + virtualId.length));
-      return resolvedVirtualId + inputPath;
-    },
-    async load(id) {
-      if (!id.startsWith(resolvedVirtualId)) return;
-
-      const inputPath = id.replace(resolvedVirtualId, '');
-      const template = await fs.readFile(
-        resolve(config.wxtModuleDir, `dist/virtual/${type}-entrypoint.js`),
-        'utf-8',
-      );
-      return template.replace(`virtual:user-${type}`, inputPath);
-    },
-  };
-}
@@ -16,7 +16,7 @@ import { ResolvedConfig } from '~/types';
 * `npm list` and inline them automatically.
 */
 export function webextensionPolyfillMock(
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
 ): vite.PluginOption {
  return {
    name: 'wxt:testing-inline-deps',
@@ -26,7 +26,10 @@ import pc from 'picocolors';
 import { relative } from 'node:path';
 import { registerWxt, wxt } from './wxt';
 import { unnormalizePath } from './utils/paths';
-import { mapWxtOptionsToRegisteredContentScript } from './utils/content-scripts';
+import {
+  getContentScriptJs,
+  mapWxtOptionsToRegisteredContentScript,
+} from './utils/content-scripts';

 /**
 * Creates a dev server and pre-builds all the files that need to exist before loading the extension.
@@ -232,7 +235,7 @@ function reloadContentScripts(steps: BuildStepOutput[], server: WxtDevServer) {
      const entry = step.entrypoints;
      if (Array.isArray(entry) || entry.type !== 'content-script') return;

-      const js = [getEntrypointBundlePath(entry, wxt.config.outDir, '.js')];
+      const js = getContentScriptJs(wxt.config, entry);
      const cssMap = getContentScriptsCssMap(server.currentOutput, [entry]);
      const css = getContentScriptCssFiles([entry], cssMap);

@@ -0,0 +1,20 @@
+import { describe, it } from 'vitest';
+import {
+  VirtualModuleId,
+  VirtualModuleName,
+  VirtualEntrypointType,
+  VirtualEntrypointModuleName,
+} from '../virtual-modules';
+
+describe('Virtual Modules', () => {
+  it('should resolve types to litteral values, not string', () => {
+    // @ts-expect-error
+    const _c: VirtualEntrypointType = '';
+    // @ts-expect-error
+    const _d: VirtualEntrypointModuleName = '';
+    // @ts-expect-error
+    const _b: VirtualModuleName = '';
+    // @ts-expect-error
+    const _a: VirtualModuleId = '';
+  });
+});
@@ -21,3 +21,14 @@ export function some<T>(
    if (predicate(array[i], i)) return true;
  return false;
 }
+
+/**
+ * Convert an item or array to an array.
+ */
+export function toArray<T>(a: T | T[]): T[] {
+  return Array.isArray(a) ? a : [a];
+}
+
+export function filterTruthy<T>(array: Array<T | undefined>): T[] {
+  return array.filter((item) => !!item) as T[];
+}
@@ -5,6 +5,7 @@ import { dirname, resolve } from 'path';
 import type { Ora } from 'ora';
 import pc from 'picocolors';
 import { wxt } from '../../wxt';
+import { toArray } from '../arrays';

 export async function buildEntrypoints(
  groups: EntrypointGroup[],
@@ -13,7 +14,7 @@ export async function buildEntrypoints(
  const steps: BuildStepOutput[] = [];
  for (let i = 0; i < groups.length; i++) {
    const group = groups[i];
-    const groupNames = [group].flat().map((e) => e.name);
+    const groupNames = toArray(group).map((e) => e.name);
    const groupNameColored = groupNames.join(pc.dim(', '));
    spinner.text =
      pc.dim(`[${i + 1}/${groups.length}]`) + ` ${groupNameColored}`;
@@ -223,6 +223,7 @@ function resolveZipConfig(
    artifactTemplate: '{{name}}-{{version}}-{{browser}}.zip',
    sourcesRoot: root,
    includeSources: [],
+    compressionLevel: 9,
    ...mergedConfig.zip,
    excludeSources: [
      '**/node_modules',
@@ -1,5 +1,6 @@
 import type { Manifest, Scripting } from '~/browser';
-import { ContentScriptEntrypoint } from '~/types';
+import { ContentScriptEntrypoint, ResolvedConfig } from '~/types';
+import { getEntrypointBundlePath } from './entrypoints';

 /**
 * Returns a unique and consistent string hash based on a content scripts options.
@@ -83,3 +84,10 @@ export function mapWxtOptionsToRegisteredContentScript(
    world: options.world,
  };
 }
+
+export function getContentScriptJs(
+  config: ResolvedConfig,
+  entrypoint: ContentScriptEntrypoint,
+): string[] {
+  return [getEntrypointBundlePath(entrypoint, config.outDir, '.js')];
+}
@@ -1,7 +1,7 @@
 import { ResolvedConfig } from '~/types';

 export function getGlobals(
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
 ): Array<{ name: string; value: any; type: string }> {
  return [
    {
@@ -26,7 +26,7 @@ export async function isOnline(): Promise<boolean> {
 */
 export async function fetchCached(
  url: string,
-  config: Omit<ResolvedConfig, 'builder'>,
+  config: ResolvedConfig,
 ): Promise<string> {
  let content: string = '';

@@ -5,6 +5,14 @@ export function kebabCaseAlphanumeric(str: string): string {
    .replace(/\s+/g, '-'); // Replace spaces with hyphens
 }

+/**
+ * Return a safe variable name for a given string.
+ */
+export function safeVarName(str: string): string {
+  // _ prefix to ensure it doesn't start with a number
+  return '_' + kebabCaseAlphanumeric(str).replace('-', '_');
+}
+
 /**
 * Removes import statements from the top of a file. Keeps import.meta and inline, async `import()`
 * calls.
@@ -288,6 +288,7 @@ export const fakeResolvedConfig = fakeObjectCreator<ResolvedConfig>(() => {
      name: faker.person.firstName().toLowerCase(),
      downloadedPackagesDir: fakeDir(),
      downloadPackages: [],
+      compressionLevel: 9,
    },
    transformManifest: () => {},
    userConfigMetadata: {},
@@ -0,0 +1,37 @@
+export const virtualEntrypointTypes = [
+  'content-script-main-world' as const,
+  'content-script-isolated-world' as const,
+  'background' as const,
+  'unlisted-script' as const,
+];
+export type VirtualEntrypointType = (typeof virtualEntrypointTypes)[0];
+
+/**
+ * All the names of entrypoint files in the `src/virtual/` and `dist/virtual/` directories, minus the extension.
+ */
+export const virtualEntrypointModuleNames = virtualEntrypointTypes.map(
+  (name) => `${name}-entrypoint` as const,
+);
+/**
+ * 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 const virtualModuleNames = [
+  ...virtualEntrypointModuleNames,
+  'mock-browser' as const,
+  'reload-html' as const,
+];
+/**
+ * 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}`;
@@ -28,7 +28,7 @@ export async function registerWxt(
  const hooks = createHooks<WxtHooks>();
  const config = await resolveConfig(inlineConfig, command);
  const server = await getServer?.(config);
-  const builder = await createViteBuilder(config, server);
+  const builder = await createViteBuilder(config, hooks, server);
  const pm = await createWxtPackageManager(config.root);

  wxt = {
@@ -135,7 +135,15 @@ async function zipDir(
    }
  }
  await options?.additionalWork?.(archive);
-  const buffer = await archive.generateAsync({ type: 'base64' });
+  const buffer = await archive.generateAsync({
+    type: 'base64',
+    ...(wxt.config.zip.compressionLevel === 0
+      ? { compression: 'STORE' }
+      : {
+          compression: 'DEFLATE',
+          compressionOptions: { level: wxt.config.zip.compressionLevel },
+        }),
+  });
  await fs.writeFile(outputPath, buffer, 'base64');
 }

@@ -8,6 +8,7 @@
 import { Storage, browser } from '~/browser';
 import { dequal } from 'dequal/lite';
 import { logger } from './sandbox/utils/logger';
+import { toArray } from './core/utils/arrays';

 export const storage = createStorage();

@@ -107,7 +108,7 @@ function createStorage(): WxtStorage {
      await driver.removeItem(metaKey);
    } else {
      const newFields = getMetaValue(await driver.getItem(metaKey));
-      [properties].flat().forEach((field) => delete newFields[field]);
+      toArray(properties).forEach((field) => delete newFields[field]);
      await driver.setItem(metaKey, newFields);
    }
  };
@@ -173,7 +173,7 @@ export interface InlineConfig {
     *
     * @example
     * [
-     *   "coverage", // Ignore the coverage directory in the `sourcesRoot`
+     *   "coverage", // Include the coverage directory in the `sourcesRoot`
     * ]
     */
    excludeSources?: string[];
@@ -202,6 +202,14 @@ export interface InlineConfig {
     * ["@scope/package-name@1.1.3", "package-name@^2"]
     */
    downloadPackages?: string[];
+    /**
+     * Compression level to use when zipping files.
+     *
+     * Levels: 0 (no compression) to 9 (maximum compression).
+     *
+     * @default 9
+     */
+    compressionLevel?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
  };

  /**
@@ -361,6 +369,28 @@ export type WxtViteConfig = Omit<
  'root' | 'configFile' | 'mode'
 >;

+// TODO: Move into @wxt/vite-builder
+export interface WxtHooks {
+  /**
+   * Called when WXT has created Vite's config for a build step. Useful if you
+   * want to add plugins or update the vite config per entrypoint group.
+   *
+   * @param entrypoints The list of entrypoints being built with the provided config.
+   * @param viteConfig The config that will be used for the dev server.
+   */
+  'vite:build:extendConfig': (
+    entrypoints: readonly Entrypoint[],
+    viteConfig: vite.InlineConfig,
+  ) => HookResult;
+  /**
+   * Called when WXT has created Vite's config for the dev server. Useful if
+   * you want to add plugins or update the vite config per entrypoint group.
+   *
+   * @param viteConfig The config that will be used to build the entrypoints. Can be updated by reference.
+   */
+  'vite:devServer:extendConfig': (config: vite.InlineConfig) => HookResult;
+}
+
 export interface BuildOutput {
  manifest: Manifest.WebExtensionManifest;
  publicAssets: OutputAsset[];
@@ -564,8 +594,8 @@ export interface BaseContentScriptEntrypointOptions
   * - `"manifest"`: The content script will be added to the `content_scripts` entry in the
   *   manifest. This is the normal and most well known way of registering a content script.
   * - `"runtime"`: The content script's `matches` is added to `host_permissions` and you are
-   *   responsible for using the scripting API to register the content script dynamically at
-   *   runtime.
+   *   responsible for using the scripting API to register/execute the content script
+   *   dynamically at runtime.
   *
   * @default "manifest"
   */
@@ -707,16 +737,24 @@ export interface IsolatedWorldContentScriptDefinition
  extends IsolatedWorldContentScriptEntrypointOptions {
  /**
   * Main function executed when the content script is loaded.
+   *
+   * When running a content script with `browser.scripting.executeScript`,
+   * values returned from this function will be returned in the `executeScript`
+   * result as well. Otherwise returning a value does nothing.
   */
-  main(ctx: ContentScriptContext): void | Promise<void>;
+  main(ctx: ContentScriptContext): any | Promise<any>;
 }

 export interface MainWorldContentScriptDefinition
  extends MainWorldContentScriptEntrypointOptions {
  /**
   * Main function executed when the content script is loaded.
+   *
+   * When running a content script with `browser.scripting.executeScript`,
+   * values returned from this function will be returned in the `executeScript`
+   * result as well. Otherwise returning a value does nothing.
   */
-  main(): void | Promise<void>;
+  main(): any | Promise<any>;
 }

 export type ContentScriptDefinition =
@@ -733,8 +771,12 @@ export interface BackgroundDefinition extends BackgroundEntrypointOptions {
 export interface UnlistedScriptDefinition extends BaseEntrypointOptions {
  /**
   * Main function executed when the unlisted script is ran.
+   *
+   * When running a content script with `browser.scripting.executeScript`,
+   * values returned from this function will be returned in the `executeScript`
+   * result as well. Otherwise returning a value does nothing.
   */
-  main(): void | Promise<void>;
+  main(): any | Promise<any>;
 }

 /**
@@ -1057,6 +1099,7 @@ export interface ResolvedConfig {
    sourcesRoot: string;
    downloadedPackagesDir: string;
    downloadPackages: string[];
+    compressionLevel: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
  };
  /**
   * @deprecated Use `build:manifestGenerated` hook instead.
@@ -1103,12 +1146,6 @@ export interface ExtensionRunner {
  closeBrowser(): Promise<void>;
 }

-export type VirtualEntrypointType =
-  | 'content-script-main-world'
-  | 'content-script-isolated-world'
-  | 'background'
-  | 'unlisted-script';
-
 export type EslintGlobalsPropValue =
  | boolean
  | 'readonly'
@@ -1,4 +1,4 @@
-import definition from 'virtual:user-background';
+import definition from 'virtual:user-background-entrypoint';
 import { setupWebSocket } from './utils/setup-web-socket';
 import { logger } from '../sandbox/utils/logger';
 import { browser } from 'wxt/browser';
@@ -1,17 +1,24 @@
-import definition from 'virtual:user-content-script-isolated-world';
+import definition from 'virtual:user-content-script-isolated-world-entrypoint';
 import { logger } from '../sandbox/utils/logger';
 import { ContentScriptContext } from 'wxt/client';

-(async () => {
+const result = (async () => {
  try {
    const { main, ...options } = definition;
    const ctx = new ContentScriptContext(import.meta.env.ENTRYPOINT, options);

-    await main(ctx);
+    return await main(ctx);
  } catch (err) {
    logger.error(
      `The content script "${import.meta.env.ENTRYPOINT}" crashed on startup!`,
      err,
    );
+    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;
@@ -1,14 +1,21 @@
-import definition from 'virtual:user-content-script-main-world';
+import definition from 'virtual:user-content-script-main-world-entrypoint';
 import { logger } from '../sandbox/utils/logger';

-(async () => {
+const result = (async () => {
  try {
    const { main } = definition;
-    await main();
+    return await main();
  } catch (err) {
    logger.error(
      `The content script "${import.meta.env.ENTRYPOINT}" crashed on startup!`,
      err,
    );
+    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;
@@ -1,13 +1,20 @@
-import definition from 'virtual:user-unlisted-script';
+import definition from 'virtual:user-unlisted-script-entrypoint';
 import { logger } from '../sandbox/utils/logger';

-(async () => {
+const result = (async () => {
  try {
-    await definition.main();
+    return await definition.main();
  } catch (err) {
    logger.error(
      `The unlisted script "${import.meta.env.ENTRYPOINT}" crashed on startup!`,
      err,
    );
+    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;
@@ -1,11 +1,11 @@
 // Types required to make the virtual modules happy.

-declare module 'virtual:user-background' {
+declare module 'virtual:user-background-entrypoint' {
  const definition: { main: () => void };
  export default definition;
 }

-declare module 'virtual:user-content-script-isolated-world' {
+declare module 'virtual:user-content-script-isolated-world-entrypoint' {
  const definition: {
    main: (
      ctx: import('wxt/client').ContentScriptContext,
@@ -14,12 +14,12 @@ declare module 'virtual:user-content-script-isolated-world' {
  export default definition;
 }

-declare module 'virtual:user-content-script-main-world' {
+declare module 'virtual:user-content-script-main-world-entrypoint' {
  const definition: { main: () => void | Promise<void> };
  export default definition;
 }

-declare module 'virtual:user-unlisted-script' {
+declare module 'virtual:user-unlisted-script-entrypoint' {
  const definition: { main: () => void | Promise<void> };
  export default definition;
 }
@@ -10,5 +10,9 @@ export default defineConfig({
  },
  vite: () => ({
    plugins: [vue()],
+    build: {
+      // Enabling sourcemaps with Vue during development is known to cause problems with Vue
+      sourcemap: false,
+    },
  }),
 });
Author	SHA1	Message	Date
Aaron	d5fe4248e2	bump version for early release	2024-04-19 20:34:36 -05:00
Aaron	58140cf3e8	update test snapshot	2024-04-19 20:33:21 -05:00
Aaron	1a39f856af	get it working	2024-04-19 20:31:32 -05:00
Aaron	82b769e939	feat: Support returning values from scripts executed with the scripting API	2024-04-19 16:25:17 -05:00
Aaron	e47519fb76	docs: Update content script registration JSDoc See https://github.com/wxt-dev/wxt/discussions/623	2024-04-19 15:59:14 -05:00
Ayden	171e32c272	docs: Add ElemSnap to homepage (#621 )	2024-04-19 08:00:41 -05:00
wuzequanyouzi	54e5ed0bb4	chore: Update vue template config (#607 ) Co-authored-by: Aaron <aaronklinker1@gmail.com>	2024-04-15 12:43:43 -05:00
Aaron	a94d673f31	docs: Fix typo in assets page	2024-04-15 12:17:02 -05:00
yacine-bens	b7f7222c26	docs: Add Facebook Video Controls to homepage (#615 )	2024-04-15 12:13:06 -05:00
Can Rau	aa5a9d4fa9	docs: Tix typo in `entrypoints.md` (#614 )	2024-04-14 17:21:12 -05:00
日高凌	77da2d6ade	docs: Fix typo on example for wxt.config.ts. (#609 )	2024-04-12 09:00:15 -05:00
Bas van Zanten	3119c04e10	feat: Add zip compression settings (#605 )	2024-04-12 08:59:54 -05:00
couriourc	c09994263e	doc: Fix bad extension API examples (#608 )	2024-04-12 01:01:07 -05:00
ThinkStu	2a4fa9ae5c	docs: Add Fluent Read to homepage (#600 ) Co-authored-by: Aaron <aaronklinker1@gmail.com>	2024-04-07 09:01:02 -05:00
Aaron	c833d3b15b	Update test snapshot after vite upgrade	2024-04-07 08:53:15 -05:00
Aaron	d6e095bfce	Fix type error	2024-04-07 08:47:52 -05:00
Aaron	825160a3cc	chore(deps): Upgrade vite	2024-04-03 14:16:51 -05:00
Aaron	e29ca33f82	Add missing cleanup from PR	2024-04-03 14:15:55 -05:00
GitHub Actions	ca5a52c6f1	chore(release): v0.17.12	2024-04-03 19:04:03 +00:00
Aaron	982c69f8ae	feat: Add hooks for extending vite config (#599 )	2024-04-03 14:00:48 -05:00
Aaron	6fc7d9254a	fix(content-script-ui): Properly assign and unassign mounted value (#598 )	2024-04-03 12:38:46 -05:00
dependabot[bot]	2e0e104d48	chore(deps): bump c12 from 1.5.1 to 1.10.0 (#592 ) Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2024-04-01 23:23:11 -05:00
dependabot[bot]	02430fd7b8	chore(deps-dev): bump sass from 1.69.5 to 1.72.0 (#591 ) Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2024-04-01 23:23:01 -05:00
dependabot[bot]	2e6d35d193	chore(deps-dev): bump vue from 3.3.10 to 3.4.21 (#589 ) Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2024-04-01 23:08:37 -05:00
dependabot[bot]	7cf412ac1f	chore(deps): bump vitest from 1.2.2 to 1.4.0 (#590 ) Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2024-04-01 22:15:44 -05:00
Aaron	9398cbb596	docs: Add discord server link (#593 )	2024-04-01 19:13:12 -05:00
dependabot[bot]	ca9b96142e	chore(deps-dev): bump @aklinker1/check from 1.1.1 to 1.2.0 (#588 ) Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2024-04-01 18:10:28 -05:00
Aaron	db57c8e079	chore: Remove unnecssary 'Omit' types	2024-03-31 08:40:21 -05:00
GitHub Actions	7e37e11caf	chore(release): v0.17.11	2024-03-31 13:22:25 +00:00
Aaron	bb90029c54	fix: Resolve absolute paths from the public directory properly (#583 )	2024-03-31 08:19:06 -05:00
Aaron	d3b14afbce	chore: Extract helper function	2024-03-30 14:49:10 -05:00
Aaron	ba2197a609	chore: Add some array utils (#582 )	2024-03-30 13:30:45 -05:00
Aaron	4c558d3eb6	chore: Simplify virtual module setup (#581 )	2024-03-30 12:44:27 -05:00
Qiwei Yang	dcd175444a	docs: Add "GitHub Custom Notifier" to homepage (#580 )	2024-03-30 08:37:26 -05:00
Aaron	16fc58404a	docs: Fix `zip.includeSources` example	2024-03-30 08:37:00 -05:00