0.1.0

Author: NikolaRHristov

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.1.0
+
+-   Custom esbuild file
+
 ## 0.0.11
 
 -   Cleanup

README.md

@@ -0,0 +1,55 @@
+# Build scripts and configuration
+
+## Installation
+
+Add configuration and setup scripts:
+
+```sh
+npm install -D -E baxast
+```
+
+## Usage
+
+`package.json`
+
+```json
+{
+	"name": "my-awesome-package",
+	"scripts": {
+		"prepublishOnly": "baxast 'Source/**/*.ts'"
+	},
+	"dependencies": {
+		"baxast": "latest"
+	}
+}
+```
+
+or with a custom esbuild config file:
+
+```json
+{
+	"scripts": {
+		"prepublishOnly": "baxast 'Source/**/*.ts' -es ESBuild.ts"
+	}
+}
+```
+
+#### See an example of a config file in [ESBuild.ts](Source/Configuration/esbuild.ts)
+
+`tsconfig.json`
+
+```json
+{
+	"compilerOptions": {
+		"outDir": "Target"
+	},
+	"extends": "./Source/Configuration/TypeScript",
+	"include": ["Source"]
+}
+```
+
+The script will now automatically compile your build files with [esbuild] and
+add TypeScript types.
+
+[baxast]: https://npmjs.org/baxast
+[esbuild]: https://npmjs.org/esbuild

Source/Command/Build.ts

@@ -4,11 +4,15 @@ import type { BuildOptions } from "esbuild";
 import { build as Build } from "esbuild";
 import type { Pattern } from "fast-glob";
 import Glob from "fast-glob";
-import esbuild from "../Configuration/esbuild.js";
+import _esbuild from "../Configuration/esbuild.js";
+import File from "../Library/File.js";
 
 export type Pipe = string[];
 
-export default async (Files: Pattern[], Options?: { TypeScript?: string }) => {
+export default async (
+	Files: Pattern[],
+	Options?: { esbuild?: string; TypeScript?: string }
+) => {
 	const Pipe: Pipe = [];
 
 	for (const File of Files) {
@@ -21,18 +25,19 @@ export default async (Files: Pattern[], Options?: { TypeScript?: string }) => {
 
 	Pipe.reverse();
 
+	const esbuild = Merge(_esbuild, {
+		entryPoints: Object.fromEntries(
+			Pipe.map((File) => [
+				File.replace("Source/", "").split(".").slice(0, -1.0).join("."),
+				File,
+			])
+		),
+	} satisfies BuildOptions);
+
 	await Build(
-		Merge(esbuild, {
-			entryPoints: Object.fromEntries(
-				Pipe.map((File) => [
-					File.replace("Source/", "")
-						.split(".")
-						.slice(0, -1.0)
-						.join("."),
-					File,
-				])
-			),
-		} satisfies BuildOptions)
+		Options?.esbuild
+			? Merge(esbuild, await File(Options?.esbuild))
+			: esbuild
 	);
 
 	if (Options?.TypeScript) {

Source/Configuration/TypeScript.json

@@ -23,7 +23,7 @@
 		"lib": [
 			"ESNext"
 		],
-		"module": "NodeNext",
+		"module": "ESNext",
 		"moduleResolution": "NodeNext",
 		"noFallthroughCasesInSwitch": true,
 		"noImplicitOverride": true,
@@ -40,7 +40,8 @@
 		"strictNullChecks": true,
 		"target": "ESNext",
 		"types": [
-			"node"
+			"node",
+			"@types/node"
 		],
 		"verbatimModuleSyntax": true
 	},

Source/Configuration/esbuild.ts

@@ -11,7 +11,6 @@ export default {
 	platform: "node",
 	target: "esnext",
 	write: true,
-	sourcemap: false,
 	plugins: [
 		{
 			name: "Target",

Source/Index.ts

@@ -8,6 +8,7 @@ try {
 		.version((await _JSON("../package.json", import.meta.url))?.version)
 		.description("Builds files")
 		.argument("<Files...>", "Files to build")
+		.option("-es, --esbuild <File>", "esbuild configuration file")
 		.option("-ts, --TypeScript <File>", "TypeScript configuration file")
 		.action(Build)
 		.parse();

Source/Library/File.ts

@@ -0,0 +1,30 @@
+import { readFile as _File, writeFile as File } from "fs/promises";
+import TypeScript from "typescript";
+import { pathToFileURL as URL } from "url";
+import _JSON from "./JSON.js";
+
+export default async (Path: string) => {
+	if (Path.split(".").pop() === "ts") {
+		const { options } = TypeScript.convertCompilerOptionsFromJson(
+			(await _JSON("../Configuration/TypeScript.json", import.meta.url))
+				?.compilerOptions,
+			"."
+		);
+
+		TypeScript.createProgram(
+			[Path],
+			options,
+			TypeScript.createCompilerHost(options)
+		).emit();
+
+		await File(
+			Path.replace(".ts", ".js"),
+			TypeScript.transpile(
+				(await _File(Path, "utf-8")).toString(),
+				options
+			)
+		);
+	}
+
+	return (await import(URL(Path).toString().replace(".ts", ".js"))).default;
+};

Target/Command/Build.d.ts

@@ -1,6 +1,7 @@
 import type { Pattern } from "fast-glob";
 export type Pipe = string[];
 declare const _default: (Files: Pattern[], Options?: {
+    esbuild?: string;
     TypeScript?: string;
 }) => Promise<void>;
 export default _default;

Target/Command/Build.js

@@ -23,7 +23,7 @@
 		"lib": [
 			"ESNext"
 		],
-		"module": "NodeNext",
+		"module": "ESNext",
 		"moduleResolution": "NodeNext",
 		"noFallthroughCasesInSwitch": true,
 		"noImplicitOverride": true,
@@ -40,7 +40,8 @@
 		"strictNullChecks": true,
 		"target": "ESNext",
 		"types": [
-			"node"
+			"node",
+			"@types/node"
 		],
 		"verbatimModuleSyntax": true
 	},

Target/Configuration/TypeScript.json

@@ -5,7 +5,6 @@ declare const _default: {
     platform: "node";
     target: string;
     write: true;
-    sourcemap: false;
     plugins: any[];
 };
 export default _default;

Target/Configuration/esbuild.d.ts

@@ -0,0 +1,2 @@
+declare const _default: (Path: string) => Promise<any>;
+export default _default;

Target/Configuration/esbuild.js

@@ -1,6 +1,6 @@
 {
 	"name": "baxast",
-	"version": "0.0.11",
+	"version": "0.1.0",
 	"homepage": "https://github.com/baxast/baxast#readme",
 	"bugs": {
 		"url": "https://github.com/baxast/baxast/issues"
@@ -24,7 +24,8 @@
 		"esbuild": "0.19.0",
 		"esbuild-plugin-copy": "2.1.1",
 		"fast-glob": "3.3.1",
-		"typescript": "5.1.6"
+		"typescript": "5.1.6",
+		"@types/node": "20.4.9"
 	},
 	"devDependencies": {
 		"@types/node": "20.4.9",