@angular-builders/custom-esbuild 17.1.0-beta.0 → 17.1.0-beta.2

package/README.md

@@ -100,7 +100,7 @@ Builder options:
   "build": {
     "builder": "@angular-builders/custom-esbuild:application",
     "options": {
-      "plugins": ["./esbuild/plugin-1.js", "./esbuild/plugin-2.js"],
+      "plugins": ["./esbuild/plugins.ts", "./esbuild/plugin-2.js"],
       "indexHtmlTransformer": "./esbuild/index-html-transformer.js",
       "outputPath": "dist/my-cool-client",
       "index": "src/index.html",
@@ -112,6 +112,49 @@ Builder options:
 
 In the above example, we specify the list of `plugins` that should implement the ESBuild plugin schema. These plugins are custom user plugins and are added to the original ESBuild Angular configuration. Additionally, the `indexHtmlTransformer` property is used to specify the path to the file that exports the function used to modify the `index.html`.
 
+The plugin file can export either a single plugin or a list of plugins:
+
+```ts
+// esbuild/plugins.ts
+import type { Plugin, PluginBuild } from 'esbuild';
+
+const defineTextPlugin: Plugin = {
+  name: 'define-text',
+  setup(build: PluginBuild) {
+    const options = build.initialOptions;
+    options.define.buildText = JSON.stringify('This text is provided during the compilation');
+  },
+};
+
+export default defineTextPlugin;
+```
+
+Or:
+
+```ts
+// esbuild/plugins.ts
+import type { Plugin, PluginBuild } from 'esbuild';
+
+const defineTextPlugin: Plugin = {
+  name: 'define-text',
+  setup(build: PluginBuild) {
+    const options = build.initialOptions;
+    options.define.buildText = JSON.stringify('This text is provided during the compilation');
+  },
+};
+
+const updateExternalPlugin: Plugin = {
+  name: 'update-external',
+  setup(build: PluginBuild) {
+    const options = build.initialOptions;
+    options.external ??= [];
+    options.external.push('elysia');
+  },
+};
+
+export default [defineTextPlugin, updateExternalPlugin];
+```
+
 ## Custom ESBuild `dev-server`
 
 The `@angular-builders/custom-esbuild:dev-server` is an enhanced version of the `@angular-devkit/build-angular:dev-server` builder that allows the specification of `middlewares` (Vite's `Connect` functions). It also obtains `plugins` and `indexHtmlTransformer` from the `:application` configuration to run the Vite server with all the necessary configuration applied.

package/dist/application/index.js

@@ -10,17 +10,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCustomEsbuildApplication = void 0;
+const path = require("node:path");
 const architect_1 = require("@angular-devkit/architect");
 const build_angular_1 = require("@angular-devkit/build-angular");
 const core_1 = require("@angular-devkit/core");
 const rxjs_1 = require("rxjs");
 const utils_1 = require("../utils");
+const load_plugins_1 = require("../load-plugins");
 function buildCustomEsbuildApplication(options, context) {
     const workspaceRoot = (0, core_1.normalize)(context.workspaceRoot);
-    const tsConfig = `${(0, core_1.getSystemPath)(workspaceRoot)}/${options.tsConfig}`;
+    const tsConfig = path.join((0, core_1.getSystemPath)(workspaceRoot), options.tsConfig);
     return (0, rxjs_1.defer)(() => __awaiter(this, void 0, void 0, function* () {
-        const paths = options.plugins || [];
-        const codePlugins = yield Promise.all(paths.map(path => (0, utils_1.loadModule)(workspaceRoot, path, tsConfig, context.logger)));
+        const codePlugins = yield (0, load_plugins_1.loadPlugins)(options.plugins, workspaceRoot, tsConfig, context.logger);
         const indexHtmlTransformer = options.indexHtmlTransformer
             ? yield (0, utils_1.loadModule)(workspaceRoot, options.indexHtmlTransformer, tsConfig, context.logger)
             : undefined;

package/dist/application/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAA0E;AAC1E,iEAAiE;AACjE,+CAAsE;AAEtE,+BAAwC;AAGxC,oCAAsC;AAGtC,SAAgB,6BAA6B,CAC3C,OAAuC,EACvC,OAAuB;IAEvB,MAAM,aAAa,GAAG,IAAA,gBAAS,EAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,GAAG,IAAA,oBAAa,EAAC,aAAa,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAEvE,OAAO,IAAA,YAAK,EAAC,GAAS,EAAE;QACtB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,kBAAU,EAAS,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CACrF,CAAC;QAEF,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB;YACvD,CAAC,CAAC,MAAM,IAAA,kBAAU,EAAC,aAAa,EAAE,OAAO,CAAC,oBAAoB,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC;YACzF,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAkC,CAAC;IAC/E,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC,IAAA,gBAAS,EAAC,UAAU,CAAC,EAAE,CAAC,IAAA,gCAAgB,EAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC;AAnBD,sEAmBC;AAED,kBAAe,IAAA,yBAAa,EAC1B,6BAA6B,CAC9B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,kCAAkC;AAClC,yDAA0E;AAC1E,iEAAiE;AACjE,+CAAsE;AAEtE,+BAAwC;AAExC,oCAAsC;AACtC,kDAA8C;AAG9C,SAAgB,6BAA6B,CAC3C,OAAuC,EACvC,OAAuB;IAEvB,MAAM,aAAa,GAAG,IAAA,gBAAS,EAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,oBAAa,EAAC,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3E,OAAO,IAAA,YAAK,EAAC,GAAS,EAAE;QACtB,MAAM,WAAW,GAAG,MAAM,IAAA,0BAAW,EAAC,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEhG,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB;YACvD,CAAC,CAAC,MAAM,IAAA,kBAAU,EAAC,aAAa,EAAE,OAAO,CAAC,oBAAoB,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC;YACzF,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAkC,CAAC;IAC/E,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC,IAAA,gBAAS,EAAC,UAAU,CAAC,EAAE,CAAC,IAAA,gCAAgB,EAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC;AAhBD,sEAgBC;AAED,kBAAe,IAAA,yBAAa,EAC1B,6BAA6B,CAC9B,CAAC"}

package/dist/dev-server/index.js

@@ -16,6 +16,7 @@ const build_angular_1 = require("@angular-devkit/build-angular");
 const core_1 = require("@angular-devkit/core");
 const rxjs_1 = require("rxjs");
 const utils_1 = require("../utils");
+const load_plugins_1 = require("../load-plugins");
 const patch_builder_context_1 = require("./patch-builder-context");
 function executeCustomDevServerBuilder(options, context) {
     var _a;
@@ -33,7 +34,7 @@ function executeCustomDevServerBuilder(options, context) {
         const middleware = yield Promise.all((options.middlewares || []).map(path => 
         // https://github.com/angular/angular-cli/pull/26212/files#diff-a99020cbdb97d20b2bc686bcb64b31942107d56db06fd880171b0a86f7859e6eR52
         (0, utils_1.loadModule)(workspaceRoot, path, tsConfig, context.logger)));
-        const buildPlugins = yield Promise.all((buildOptions.plugins || []).map(path => (0, utils_1.loadModule)(workspaceRoot, path, tsConfig, context.logger)));
+        const buildPlugins = yield (0, load_plugins_1.loadPlugins)(buildOptions.plugins, workspaceRoot, tsConfig, context.logger);
         const indexHtmlTransformer = buildOptions.indexHtmlTransformer
             ? yield (0, utils_1.loadModule)(workspaceRoot, buildOptions.indexHtmlTransformer, tsConfig, context.logger)
             : undefined;

package/dist/dev-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev-server/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,kCAAkC;AAClC,yDAAkG;AAClG,iEAIuC;AAEvC,+CAAsE;AACtE,+BAAmD;AAInD,oCAAsC;AACtC,mEAA8D;AAM9D,SAAgB,6BAA6B,CAC3C,OAAqC,EACrC,OAAuB;;IAEvB,MAAM,WAAW,GAAG,IAAA,kCAAsB;IACxC,uCAAuC;IACvC,MAAA,OAAO,CAAC,WAAW,mCAAI,OAAO,CAAC,aAAc,CAC9C,CAAC;IAEF,SAAe,qBAAqB;;YAClC,OAAO,CAAC,MAAM,OAAO,CAAC,gBAAgB,CACpC,WAAW,CACZ,CAA8C,CAAC;QAClD,CAAC;KAAA;IAED,MAAM,aAAa,GAAG,IAAA,gBAAS,EAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD,OAAO,IAAA,WAAI,EAAC,qBAAqB,EAAE,CAAC,CAAC,IAAI,CACvC,IAAA,gBAAS,EAAC,CAAM,YAAY,EAAC,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,oBAAa,EAAC,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEhF,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACrC,mIAAmI;QACnI,IAAA,kBAAU,EAA6B,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CACtF,CACF,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACtC,IAAA,kBAAU,EAAS,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAClE,CACF,CAAC;QAEF,MAAM,oBAAoB,GAAuB,YAAY,CAAC,oBAAoB;YAChF,CAAC,CAAC,MAAM,IAAA,kBAAU,EACd,aAAa,EACb,YAAY,CAAC,oBAAoB,EACjC,QAAQ,EACR,OAAO,CAAC,MAAM,CACf;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,IAAA,2CAAmB,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAE1C,OAAO;YACL,UAAU,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE;YAC/C,UAAU,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE;SACzC,CAAC;IACJ,CAAC,CAAA,CAAC,EACF,IAAA,gBAAS,EAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,CACvC,IAAA,uCAAuB,EAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAClE,CACF,CAAC;AACJ,CAAC;AAtDD,sEAsDC;AAED,kBAAe,IAAA,yBAAa,EAC1B,6BAA6B,CAC9B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev-server/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,kCAAkC;AAClC,yDAAkG;AAClG,iEAIuC;AAEvC,+CAAsE;AACtE,+BAAmD;AAGnD,oCAAsC;AACtC,kDAA8C;AAC9C,mEAA8D;AAM9D,SAAgB,6BAA6B,CAC3C,OAAqC,EACrC,OAAuB;;IAEvB,MAAM,WAAW,GAAG,IAAA,kCAAsB;IACxC,uCAAuC;IACvC,MAAA,OAAO,CAAC,WAAW,mCAAI,OAAO,CAAC,aAAc,CAC9C,CAAC;IAEF,SAAe,qBAAqB;;YAClC,OAAO,CAAC,MAAM,OAAO,CAAC,gBAAgB,CACpC,WAAW,CACZ,CAA8C,CAAC;QAClD,CAAC;KAAA;IAED,MAAM,aAAa,GAAG,IAAA,gBAAS,EAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD,OAAO,IAAA,WAAI,EAAC,qBAAqB,EAAE,CAAC,CAAC,IAAI,CACvC,IAAA,gBAAS,EAAC,CAAM,YAAY,EAAC,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,oBAAa,EAAC,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEhF,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACrC,mIAAmI;QACnI,IAAA,kBAAU,EAA6B,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CACtF,CACF,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,IAAA,0BAAW,EACpC,YAAY,CAAC,OAAO,EACpB,aAAa,EACb,QAAQ,EACR,OAAO,CAAC,MAAM,CACf,CAAC;QAEF,MAAM,oBAAoB,GAAuB,YAAY,CAAC,oBAAoB;YAChF,CAAC,CAAC,MAAM,IAAA,kBAAU,EACd,aAAa,EACb,YAAY,CAAC,oBAAoB,EACjC,QAAQ,EACR,OAAO,CAAC,MAAM,CACf;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,IAAA,2CAAmB,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAE1C,OAAO;YACL,UAAU,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE;YAC/C,UAAU,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE;SACzC,CAAC;IACJ,CAAC,CAAA,CAAC,EACF,IAAA,gBAAS,EAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,CACvC,IAAA,uCAAuB,EAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAClE,CACF,CAAC;AACJ,CAAC;AAvDD,sEAuDC;AAED,kBAAe,IAAA,yBAAa,EAC1B,6BAA6B,CAC9B,CAAC"}

package/dist/load-plugins.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'esbuild';
+import type { Path, logging } from '@angular-devkit/core';
+export declare function loadPlugins(paths: string[] | undefined, workspaceRoot: Path, tsConfig: string, logger: logging.LoggerApi): Promise<Plugin[]>;

package/dist/load-plugins.js

@@ -0,0 +1,21 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPlugins = void 0;
+const utils_1 = require("./utils");
+function loadPlugins(paths, workspaceRoot, tsConfig, logger) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const plugins = yield Promise.all((paths || []).map(path => (0, utils_1.loadModule)(workspaceRoot, path, tsConfig, logger)));
+        return plugins.flat();
+    });
+}
+exports.loadPlugins = loadPlugins;
+//# sourceMappingURL=load-plugins.js.map

package/dist/load-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-plugins.js","sourceRoot":"","sources":["../src/load-plugins.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,mCAAqC;AAErC,SAAsB,WAAW,CAC/B,KAA2B,EAC3B,aAAmB,EACnB,QAAgB,EAChB,MAAyB;;QAEzB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,kBAAU,EAAoB,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAChG,CAAC;QAEF,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;CAAA;AAXD,kCAWC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular-builders/custom-esbuild",
-  "version": "17.1.0-beta.0",
+  "version": "17.1.0-beta.2",
   "description": "Custom esbuild builders for Angular build facade. Allow to modify Angular build configuration without ejecting it",
   "main": "dist/index.js",
   "files": [
@@ -49,10 +49,10 @@
     "@angular/compiler-cli": "^17.1.0"
   },
   "devDependencies": {
-    "esbuild": "0.19.11",
+    "esbuild": "0.20.0",
     "jest": "29.7.0",
     "rimraf": "^5.0.0",
     "typescript": "5.3.3"
   },
-  "gitHead": "f3717627f153147ca950d2d1062ee368fbe08f2b"
+  "gitHead": "6399221460cdc49510b2226d31f98c89ce42a468"
 }