@moonlight-mod/esbuild-config 1.0.0 → 1.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright © 2025 moonlight contributors
+Copyright © 2026 moonlight contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/dist/factory.d.ts

@@ -1,8 +1,7 @@
-import fs from "node:fs";
 import type { Plugin, BuildResult, BuildOptions } from "esbuild";
 import betterLogging from "./plugins/betterLogging.js";
 import webpackImports from "./plugins/webpackImports.js";
-declare const sides: readonly ["index", "webpackModules", "node", "host"];
+export declare const sides: readonly ["index", "webpackModules", "node", "host"];
 export interface ESBuildFactoryOptions {
     /**
      * The name of your extension.
@@ -35,7 +34,7 @@ export interface ESBuildFactoryOptions {
      * A string determining what target to compile your extension to.
      * @remarks In utility functions other than {@link defineConfig}, this is automatically generated.
      */
-    side: typeof sides[number];
+    side: (typeof sides)[number];
     /**
      * A list of extra "external" dependencies, (i.e., dependencies that the
      * {@link side}'s runtime already provides and thus doesn't need to be bundled)
@@ -59,5 +58,5 @@ export interface ESBuildFactoryOptions {
 export declare function defineConfig(options: ESBuildFactoryOptions): BuildOptions | null;
 export declare function defineConfigs(options: Omit<ESBuildFactoryOptions, "side">): BuildOptions[];
 export declare function buildExtension(options: Omit<ESBuildFactoryOptions, "side">): Promise<BuildResult[]>;
-export declare function watchExtension(options: Omit<ESBuildFactoryOptions, "side">): Promise<fs.FSWatcher[]>;
-export { defineConfig as makeExtConfig, defineConfigs as makeExtConfigs, buildExtension as buildExt, watchExtension as watchExt, betterLogging as deduplicatedLogging, webpackImports as wpImport, };
+export declare function watchExtension(options: Omit<ESBuildFactoryOptions, "side">): Promise<import("esbuild").BuildContext<BuildOptions>[]>;
+export { defineConfig as makeExtConfig, defineConfigs as makeExtConfigs, buildExtension as buildExt, watchExtension as watchExt, betterLogging as deduplicatedLogging, webpackImports as wpImport };

package/dist/factory.js

@@ -1,21 +1,10 @@
 import fs from "node:fs";
 import path from "node:path";
-import { build, context } from "esbuild";
 import betterLogging from "./plugins/betterLogging.js";
 import webpackImports from "./plugins/webpackImports.js";
 import copyFile from "./plugins/copyFile.js";
-const prod = process.env.NODE_ENV === "production";
-const external = [
-    "electron",
-    "fs",
-    "path",
-    "module",
-    "events",
-    "original-fs",
-    "discord" // mappings
-];
-const sides = ["index", "webpackModules", "node", "host"];
-const fileExts = ["js", "jsx", "ts", "tsx"];
+import { prod, external, fileExts, buildConfigs, watchConfigs, applyDropLabels } from "./shared.js";
+export const sides = ["index", "webpackModules", "node", "host"];
 export function defineConfig(options) {
     const entry = options.entry ?? options.src;
     const output = options.output ?? options.dst;
@@ -52,15 +41,17 @@ export function defineConfig(options) {
     return {
         entryPoints: entryPoints,
         outdir: side === "webpackModules" ? path.join(output, "webpackModules") : output,
-        format: esm && side === "index" ? "esm" : "iife",
+        format: esm && side === "index" ? "esm" : "cjs",
         globalName: "module.exports",
         platform: ["index", "webpackModules"].includes(side) ? "browser" : "node",
         treeShaking: true,
         bundle: true,
         minify: prod,
         sourcemap: "inline",
+        dropLabels: applyDropLabels(side),
         external: [...external, ...extraExternal],
         plugins: [
+            // TODO: maybe don't apply this for each side as this does 4x copies lol
             copyFile(path.join(entry, "manifest.json"), path.join(output, "manifest.json")),
             copyFile(path.join(entry, "style.css"), path.join(output, "style.css")),
             webpackImports,
@@ -71,35 +62,14 @@ export function defineConfig(options) {
     };
 }
 export function defineConfigs(options) {
-    return sides
-        .map((side) => defineConfig({ ...options, side }))
-        .filter((config) => config != null);
+    return sides.map((side) => defineConfig({ ...options, side })).filter((config) => config != null);
 }
 export async function buildExtension(options) {
-    const configs = defineConfigs(options);
-    const builds = [];
-    configs.forEach(async (config) => builds.push(await build(config)));
-    return builds;
+    return buildConfigs(defineConfigs(options));
 }
 export async function watchExtension(options) {
-    const buildConfigs = defineConfigs(options);
-    const watchers = [];
-    for (const config of buildConfigs) {
-        const ctx = await context(config);
-        async function rebuild() {
-            try {
-                await ctx.rebuild();
-            }
-            catch {
-                // esbuild will log errors, we just need to not do anything
-            }
-        }
-        await rebuild();
-        const watcher = fs.watch(options.entry, { recursive: true }, async () => await rebuild());
-        watchers.push(watcher);
-    }
-    return watchers;
+    return watchConfigs(defineConfigs(options));
 }
 // In GitHub PR #3, these original names were modified to be more descriptive.
 // We re-export these as to not break backwards compatibility with older plugins.
-export { defineConfig as makeExtConfig, defineConfigs as makeExtConfigs, buildExtension as buildExt, watchExtension as watchExt, betterLogging as deduplicatedLogging, webpackImports as wpImport, };
+export { defineConfig as makeExtConfig, defineConfigs as makeExtConfigs, buildExtension as buildExt, watchExtension as watchExt, betterLogging as deduplicatedLogging, webpackImports as wpImport };

package/dist/internal.d.ts

@@ -0,0 +1,21 @@
+import type { BuildOptions, Plugin } from "esbuild";
+export declare const define: {
+    MOONLIGHT_BRANCH: string;
+    MOONLIGHT_VERSION: string;
+};
+export declare const sides: readonly ["injector", "web-preload", "node-preload", "browser"];
+export interface CoreFactoryOptions {
+    name: string;
+    side: (typeof sides)[number];
+    entry: string;
+    output: string;
+    extraExternal?: string[];
+    extraPlugins?: Plugin[];
+    extraConfig?: BuildOptions;
+}
+export declare function defineCoreConfig(options: CoreFactoryOptions): BuildOptions;
+export interface CoreFactoryPathsOptions {
+    cleanPaths?: string[];
+}
+export declare function buildOrWatchConfigs(paths: CoreFactoryPathsOptions, ...configs: BuildOptions[]): Promise<void>;
+export declare function buildOrWatchCore(paths: CoreFactoryPathsOptions, ...configs: CoreFactoryOptions[]): Promise<void>;

package/dist/internal.js

@@ -0,0 +1,50 @@
+// everything here is specifically for moonlight's core; no stability guarantees
+import fs from "node:fs/promises";
+import { prod, external, applyDropLabels, watchConfigs, buildConfigs } from "./shared.js";
+import webpackImports from "./plugins/webpackImports.js";
+import betterLogging from "./plugins/betterLogging.js";
+export const define = {
+    MOONLIGHT_BRANCH: JSON.stringify(process.env.MOONLIGHT_BRANCH ?? "dev"),
+    MOONLIGHT_VERSION: JSON.stringify(process.env.MOONLIGHT_VERSION ?? "dev")
+};
+export const sides = ["injector", "web-preload", "node-preload", "browser"];
+export function defineCoreConfig(options) {
+    return {
+        entryPoints: [options.entry],
+        outfile: options.output,
+        format: ["web-preload", "browser"].includes(options.side) ? "iife" : "cjs",
+        platform: ["web-preload", "browser"].includes(options.side) ? "browser" : "node",
+        treeShaking: true,
+        bundle: true,
+        minify: prod,
+        sourcemap: "inline",
+        define,
+        dropLabels: applyDropLabels(options.side),
+        external: [...external, ...(options.extraExternal ?? [])],
+        plugins: [webpackImports, betterLogging(options.name), ...(options.extraPlugins ?? [])],
+        ...options.extraConfig
+    };
+}
+export async function buildOrWatchConfigs(paths, ...configs) {
+    const watch = process.argv.includes("--watch");
+    const clean = process.argv.includes("--clean");
+    if (clean) {
+        // since esbuild-config *is* the clean script, the package.json shorthand script filters it out
+        if (paths.cleanPaths) {
+            for (const path of paths.cleanPaths) {
+                await fs.rm(path, { recursive: true, force: true });
+            }
+        }
+    }
+    else {
+        if (watch) {
+            await watchConfigs(configs);
+        }
+        else {
+            await buildConfigs(configs);
+        }
+    }
+}
+export function buildOrWatchCore(paths, ...configs) {
+    return buildOrWatchConfigs(paths, ...configs.map((config) => defineCoreConfig(config)));
+}

package/dist/plugins/betterLogging.js

@@ -16,7 +16,7 @@ export const betterLogging = (tag) => ({
                     kind: "warning",
                     color: true
                 }),
-                formatMessages(result.errors, { kind: "error", color: true }),
+                formatMessages(result.errors, { kind: "error", color: true })
             ]).then((a) => a.flat());
             for (const message of formatted) {
                 if (lastMessages.has(message))

package/dist/plugins/copyFile.js

@@ -2,13 +2,13 @@ import fs from "node:fs";
 import path from "node:path";
 export const copyFile = (src, dest) => ({
     name: "copy-files",
-    setup: build => build.onEnd(() => {
+    setup: (build) => build.onEnd(() => {
         if (!fs.existsSync(src))
             return;
         const dir = path.dirname(dest);
         if (!fs.existsSync(dir))
             fs.mkdirSync(dir, { recursive: true });
         fs.copyFileSync(src, dest);
-    }),
+    })
 });
 export default copyFile;

package/dist/plugins/webpackImports.js

@@ -1,8 +1,8 @@
 const webpackImports = {
     name: "webpack-imports",
-    setup: build => build.onResolve({ filter: /^@moonlight-mod\/wp\// }, args => ({
+    setup: (build) => build.onResolve({ filter: /^@moonlight-mod\/wp\// }, (args) => ({
         path: args.path.replace(/^@moonlight-mod\/wp\//, ""),
         external: true
-    })),
+    }))
 };
 export default webpackImports;

package/dist/shared.d.ts

@@ -0,0 +1,15 @@
+import { type BuildOptions } from "esbuild";
+export declare const prod: boolean;
+export declare const external: string[];
+export declare const fileExts: string[];
+export declare const dropLabels: {
+    injector: string[];
+    nodePreload: string[];
+    webPreload: string[];
+    browser: string[];
+    webTarget: string[];
+    nodeTarget: string[];
+};
+export declare function applyDropLabels(side: string): string[];
+export declare function buildConfigs(buildConfigs: BuildOptions[]): Promise<import("esbuild").BuildResult<BuildOptions>[]>;
+export declare function watchConfigs(buildConfigs: BuildOptions[]): Promise<import("esbuild").BuildContext<BuildOptions>[]>;

package/dist/shared.js

@@ -0,0 +1,38 @@
+import { build, context } from "esbuild";
+export const prod = process.env.NODE_ENV === "production";
+export const external = [
+    "electron",
+    "fs",
+    "path",
+    "module",
+    "original-fs",
+    "discord" // mappings
+];
+export const fileExts = ["js", "jsx", "ts", "tsx"];
+export const dropLabels = {
+    injector: ["injector", "host"],
+    nodePreload: ["node-preload", "node"],
+    webPreload: ["web-preload", "index", "webpackModules"],
+    browser: ["browser", "index", "webpackModules"],
+    webTarget: ["web-preload", "browser", "index", "webpackModules"],
+    nodeTarget: ["node-preload", "injector", "node", "host"]
+};
+export function applyDropLabels(side) {
+    const result = [];
+    for (const [label, sides] of Object.entries(dropLabels)) {
+        if (!sides.includes(side)) {
+            result.push(label);
+        }
+    }
+    return result;
+}
+export function buildConfigs(buildConfigs) {
+    return Promise.all(buildConfigs.map((config) => build(config)));
+}
+export function watchConfigs(buildConfigs) {
+    return Promise.all(buildConfigs.map(async (config) => {
+        const ctx = await context(config);
+        await ctx.watch();
+        return ctx;
+    }));
+}

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@moonlight-mod/esbuild-config",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "private": false,
-  "description": "Yet another Discord mod's shared esbuild config",
   "license": "MIT",
   "homepage": "https://moonlight-mod.github.io/",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/moonlight-mod/esbuild-config.git"
+    "url": "git+https://github.com/moonlight-mod/moonlight.git"
   },
   "bugs": {
-    "url": "https://github.com/moonlight-mod/esbuild-config/issues"
+    "url": "https://github.com/moonlight-mod/moonlight/issues"
   },
+  "engineStrict": false,
   "engines": {
     "node": ">=22",
     "pnpm": ">=10",
@@ -21,20 +21,26 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./internal": "./dist/internal.js"
+  },
   "files": [
-    "dist"
+    "dist",
+    "!dist/*.tsbuildinfo"
   ],
   "devDependencies": {
-    "@types/node": "^22.14.0",
-    "prettier": "^3.4.2",
-    "esbuild": "^0.25.2",
-    "typescript": "^5.8.3"
+    "@types/node": "22.14.0",
+    "esbuild": "^0.19.3",
+    "typescript": "^5.3.3"
   },
   "peerDependencies": {
     "esbuild": ">= 0.19"
   },
   "scripts": {
     "build": "tsc --build",
-    "clean": "pnpm build --clean"
+    "dev": "pnpm run build --watch --preserveWatchOutput",
+    "clean": "pnpm run build --clean",
+    "typecheck": "pnpm run build --noEmit"
   }
 }

package/README.md

@@ -1,3 +0,0 @@
-# `@moonlight-mod/esbuild-config`
-
-A simple and effective `esbuild` configuration for moonlight extensions and builds.

package/dist/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["../src/factory.ts","../src/index.ts","../src/plugins/betterLogging.ts","../src/plugins/copyFile.ts","../src/plugins/index.ts","../src/plugins/webpackImports.ts"],"version":"5.8.3"}