vivth 1.2.1 → 1.2.3

package/index.mjs

@@ -6,12 +6,11 @@
  * this library is made and distributed under MIT license;
  */
 
-export { CompileJS } from './src/bundler/CompileJS.mjs';
 export { CreateESPlugin } from './src/bundler/CreateESPlugin.mjs';
 export { EsBundler } from './src/bundler/EsBundler.mjs';
 export { FSInline } from './src/bundler/FSInline.mjs';
 export { FSInlineAnalyzer } from './src/bundler/FSInlineAnalyzer.mjs';
-export { Console } from './src/class/Console.mjs';
+export { CompileJS } from './src/bundler/CompileJS.mjs';
 export { Derived } from './src/class/Derived.mjs';
 export { Effect } from './src/class/Effect.mjs';
 export { EnvSignal } from './src/class/EnvSignal.mjs';
@@ -19,28 +18,29 @@ export { EventSignal } from './src/class/EventSignal.mjs';
 export { FileSafe } from './src/class/FileSafe.mjs';
 export { ListDerived } from './src/class/ListDerived.mjs';
 export { ListSignal } from './src/class/ListSignal.mjs';
-export { LitExp } from './src/class/LitExp.mjs';
 export { Paths } from './src/class/Paths.mjs';
 export { QChannel } from './src/class/QChannel.mjs';
 export { SafeExit } from './src/class/SafeExit.mjs';
 export { Setup } from './src/class/Setup.mjs';
 export { Signal } from './src/class/Signal.mjs';
 export { WorkerMainThread } from './src/class/WorkerMainThread.mjs';
-export { Base64URL } from './src/common/Base64URL.mjs';
+export { Console } from './src/class/Console.mjs';
 export { Base64URLFromFile } from './src/common/Base64URLFromFile.mjs';
 export { EventNameSpace } from './src/common/EventNameSpace.mjs';
 export { JSautoDOC } from './src/doc/JSautoDOC.mjs';
-export { CreateImmutable } from './src/function/CreateImmutable.mjs';
+export { LitExp } from './src/class/LitExp.mjs';
 export { EventCheck } from './src/function/EventCheck.mjs';
 export { EventObject } from './src/function/EventObject.mjs';
-export { GetRuntime } from './src/function/GetRuntime.mjs';
 export { IsAsync } from './src/function/IsAsync.mjs';
+export { GetRuntime } from './src/function/GetRuntime.mjs';
 export { LazyFactory } from './src/function/LazyFactory.mjs';
 export { Timeout } from './src/function/Timeout.mjs';
 export { Try } from './src/function/Try.mjs';
 export { TryAsync } from './src/function/TryAsync.mjs';
 export { TrySync } from './src/function/TrySync.mjs';
 export { TsToMjs } from './src/function/TsToMjs.mjs';
+export { Base64URL } from './src/common/Base64URL.mjs';
+export { CreateImmutable } from './src/function/CreateImmutable.mjs';
 export { WorkerResult } from './src/class/WorkerResult.mjs';
 export { WorkerThread } from './src/class/WorkerThread.mjs';
 export { ToBundledJSPlugin } from './src/bundler/adds/ToBundledJSPlugin.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vivth",
-	"version": "1.2.1",
+	"version": "1.2.3",
 	"description": "library primitives",
 	"main": "index.mjs",
 	"types": "./types/index.d.mts",

package/src/bundler/CompileJS.mjs

@@ -1,6 +1,6 @@
 // @ts-check
 
-import { readFile, readdir } from 'node:fs/promises';
+import { readFile } from 'node:fs/promises';
 import { join, extname, basename, dirname } from 'node:path';
 import { platform } from 'node:os';
 
@@ -13,6 +13,7 @@ import { FSInlineAnalyzer } from './FSInlineAnalyzer.mjs';
 
 /**
  * @typedef {'win32' | 'linux' | 'darwin' | string} PlatformKey
+ * @typedef {import('./CreateESPlugin.mjs')["CreateESPlugin"]} CreateESPlugin
  */
 
 let binaryExtension = undefined;
@@ -97,6 +98,8 @@ const getBinaryExtension = () => {
  * - `key` are to used as `--keyName`;
  * - value are the following value of the key;
  * - no need to add the output/outdir, as it use the `options.outDir`;
+ * @param {ReturnType<CreateESPlugin>[]} [options.esBundlerPlugins]
+ * - plugins for `EsBundler`;
  * @return {ReturnType<TryAsync<{compileResult:Promise<any>,
  * commandCalled: string;
  * compiledBinFile: string;
@@ -115,7 +118,8 @@ const getBinaryExtension = () => {
  * 		compiler: 'pkg',
  * 		compilerArguments: {
  * 			target: ['node18-win-x64'],
- * 		}
+ * 		},
+ * 		esBundlerPlugins: [],
  * 	}),
  * 	CompileJS({
  * 		entryPoint: join(Paths.root, '/dev'),
@@ -124,7 +128,8 @@ const getBinaryExtension = () => {
  * 		compiler: 'bun',
  * 		compilerArguments: {
  * 			target: ['bun-win-x64'],
- * 		}
+ * 		},
+ * 		esBundlerPlugins: [],
  * 	}),
  * ])
  */
@@ -135,6 +140,7 @@ export async function CompileJS({
 	outDir,
 	compiler = undefined,
 	compilerArguments = undefined,
+	esBundlerPlugins = [],
 }) {
 	return await TryAsync(async () => {
 		/**
@@ -176,6 +182,7 @@ export async function CompileJS({
 			{
 				minify: minifyFirst,
 				format,
+				plugins: esBundlerPlugins,
 			}
 		);
 		if (errorPrep) {

package/src/bundler/EsBundler.mjs

@@ -71,7 +71,6 @@ export async function EsBundler(
 				contents: content,
 				loader,
 				resolveDir: root ?? Paths.root,
-				...esbuildOptions.banner,
 			},
 			bundle: true,
 			write: false,

package/src/bundler/FSInlineAnalyzer.mjs

@@ -101,9 +101,7 @@ export class FSInlineAnalyzer {
 			}
 			const {
 				result: { named: namedWorker },
-				regexp,
 			} = resultMatchingWorker;
-
 			for (let i = 0; i < namedWorker.length; i++) {
 				const { path } = namedWorker[i];
 				const fullPath = join(Paths.root, path);

package/src/class/WorkerMainThread.mjs

@@ -43,31 +43,32 @@ export class WorkerMainThread {
 	 * @param {typeof WorkerMainThread["pathValidator"]} param0.pathValidator
 	 * - example:
 	 * ```js
-	 * async (workerPath, root, base) => {
+	 * async (workerPath, root) => {
 	 *  const truePathCheck = `${root}/${base}/${workerPath}`;
 	 * 	const res = await fetch(truePathCheck);
 	 * 	// might also check wheter it need base or not
 	 * 	return await res.ok;
 	 * }
 	 * ```
-	 * @param {typeof WorkerMainThread["basePath"]} [param0.basePath]
-	 * - additonal realtivePath from rootPath;
-	 * - default: '';
 	 * @example
 	 * import { Worker } from 'node:worker_threads';
 	 * import { WorkerMainThread } from 'vivth';
 	 *
 	 * WorkerMainThread.setup({
 	 * 	workerClass: Worker,
-	 * 	basePath: 'public/assets/js/workers',
-	 * 	pathValidator: async (workerPath, root, base) => {
-	 * 		const res = await fetch(`${root}/${base}/${workerPath}`);
-	 * 		// might also check wheter it need base or not
-	 * 		return await res.ok;
+	 * 	pathValidator: async ({worker, root}) => {
+	 * 		const res = await fetch(`${root}/${worker}`);
+	 * 		if (res.ok) {
+	 * 			return res
+	 * 		}
+	 * 		const res2 = await fetch(`${root}/someAdditionalPath/${worker}`);
+	 * 		if (res2.ok) {
+	 * 			return res2
+	 * 		}
 	 * 	},
 	 * });
 	 */
-	static setup = ({ workerClass, pathValidator, basePath = '' }) => {
+	static setup = ({ workerClass, pathValidator }) => {
 		if (!Paths.root) {
 			return;
 		}
@@ -78,7 +79,6 @@ export class WorkerMainThread {
 		WorkerMainThread.#isRegistered = true;
 		WorkerMainThread.workerClass = workerClass;
 		WorkerMainThread.pathValidator = pathValidator;
-		WorkerMainThread.basePath = basePath;
 	};
 	/**
 	 * @description
@@ -87,18 +87,11 @@ export class WorkerMainThread {
 	 * @type {typeof Worker|typeof import('worker_threads').Worker}
 	 */
 	static workerClass;
-	/**
-	 * @description
-	 * - reference for worker file `basePath`;
-	 * - edit via `setup`;
-	 * @type {string}
-	 */
-	static basePath;
 	/**
 	 * @description
 	 * - reference for validating path;
 	 * - edit via `setup`;
-	 * @type {(paths:{worker: string, root:string, base: string})=>Promise<string>}
+	 * @type {(paths:{worker: string, root:string})=>Promise<string>}
 	 */
 	static pathValidator;
 	static #options = /** @type {import('worker_threads').WorkerOptions & { type?: 'module' }} */ ({
@@ -157,7 +150,6 @@ export class WorkerMainThread {
 			return await pathValidator({
 				worker: handler,
 				root: Paths.root,
-				base: WorkerMainThread.basePath,
 			});
 		});
 		if (error) {

package/src/class/WorkerMainThreadBundled.mjs

@@ -33,9 +33,8 @@ export class WorkerMainThread {
 	 * @param {Object} param0
 	 * @param {typeof WorkerMainThread["workerClass"]} param0.workerClass
 	 * @param {typeof WorkerMainThread["pathValidator"]} param0.pathValidator
-	 * @param {typeof WorkerMainThread["basePath"]} [param0.basePath]
 	 */
-	static setup = ({ workerClass, pathValidator, basePath = '' }) => {
+	static setup = ({ workerClass, pathValidator }) => {
 		if (!Paths.root) {
 			return;
 		}
@@ -46,18 +45,13 @@ export class WorkerMainThread {
 		WorkerMainThread.#isRegistered = true;
 		WorkerMainThread.workerClass = workerClass;
 		WorkerMainThread.pathValidator = pathValidator;
-		WorkerMainThread.basePath = basePath;
 	};
 	/**
 	 * @type {typeof Worker|typeof import('worker_threads').Worker}
 	 */
 	static workerClass;
 	/**
-	 * @type {string}
-	 */
-	static basePath;
-	/**
-	 * @type {(paths:{worker: string, root:string, base: string})=>Promise<string>}
+	 * @type {(paths:{worker: string, root:string})=>Promise<string>}
 	 */
 	static pathValidator;
 	static #options = /** @type {import('worker_threads').WorkerOptions & { type?: 'module' }} */ ({

package/types/index.d.mts

@@ -1,9 +1,8 @@
-export { CompileJS } from "./src/bundler/CompileJS.mjs";
 export { CreateESPlugin } from "./src/bundler/CreateESPlugin.mjs";
 export { EsBundler } from "./src/bundler/EsBundler.mjs";
 export { FSInline } from "./src/bundler/FSInline.mjs";
 export { FSInlineAnalyzer } from "./src/bundler/FSInlineAnalyzer.mjs";
-export { Console } from "./src/class/Console.mjs";
+export { CompileJS } from "./src/bundler/CompileJS.mjs";
 export { Derived } from "./src/class/Derived.mjs";
 export { Effect } from "./src/class/Effect.mjs";
 export { EnvSignal } from "./src/class/EnvSignal.mjs";
@@ -11,28 +10,29 @@ export { EventSignal } from "./src/class/EventSignal.mjs";
 export { FileSafe } from "./src/class/FileSafe.mjs";
 export { ListDerived } from "./src/class/ListDerived.mjs";
 export { ListSignal } from "./src/class/ListSignal.mjs";
-export { LitExp } from "./src/class/LitExp.mjs";
 export { Paths } from "./src/class/Paths.mjs";
 export { QChannel } from "./src/class/QChannel.mjs";
 export { SafeExit } from "./src/class/SafeExit.mjs";
 export { Setup } from "./src/class/Setup.mjs";
 export { Signal } from "./src/class/Signal.mjs";
 export { WorkerMainThread } from "./src/class/WorkerMainThread.mjs";
-export { Base64URL } from "./src/common/Base64URL.mjs";
+export { Console } from "./src/class/Console.mjs";
 export { Base64URLFromFile } from "./src/common/Base64URLFromFile.mjs";
 export { EventNameSpace } from "./src/common/EventNameSpace.mjs";
 export { JSautoDOC } from "./src/doc/JSautoDOC.mjs";
-export { CreateImmutable } from "./src/function/CreateImmutable.mjs";
+export { LitExp } from "./src/class/LitExp.mjs";
 export { EventCheck } from "./src/function/EventCheck.mjs";
 export { EventObject } from "./src/function/EventObject.mjs";
-export { GetRuntime } from "./src/function/GetRuntime.mjs";
 export { IsAsync } from "./src/function/IsAsync.mjs";
+export { GetRuntime } from "./src/function/GetRuntime.mjs";
 export { LazyFactory } from "./src/function/LazyFactory.mjs";
 export { Timeout } from "./src/function/Timeout.mjs";
 export { Try } from "./src/function/Try.mjs";
 export { TryAsync } from "./src/function/TryAsync.mjs";
 export { TrySync } from "./src/function/TrySync.mjs";
 export { TsToMjs } from "./src/function/TsToMjs.mjs";
+export { Base64URL } from "./src/common/Base64URL.mjs";
+export { CreateImmutable } from "./src/function/CreateImmutable.mjs";
 export { WorkerResult } from "./src/class/WorkerResult.mjs";
 export { WorkerThread } from "./src/class/WorkerThread.mjs";
 export { ToBundledJSPlugin } from "./src/bundler/adds/ToBundledJSPlugin.mjs";

package/types/src/bundler/CompileJS.d.mts

@@ -35,6 +35,8 @@
  * - `key` are to used as `--keyName`;
  * - value are the following value of the key;
  * - no need to add the output/outdir, as it use the `options.outDir`;
+ * @param {ReturnType<CreateESPlugin>[]} [options.esBundlerPlugins]
+ * - plugins for `EsBundler`;
  * @return {ReturnType<TryAsync<{compileResult:Promise<any>,
  * commandCalled: string;
  * compiledBinFile: string;
@@ -53,7 +55,8 @@
  * 		compiler: 'pkg',
  * 		compilerArguments: {
  * 			target: ['node18-win-x64'],
- * 		}
+ * 		},
+ * 		esBundlerPlugins: [],
  * 	}),
  * 	CompileJS({
  * 		entryPoint: join(Paths.root, '/dev'),
@@ -62,17 +65,20 @@
  * 		compiler: 'bun',
  * 		compilerArguments: {
  * 			target: ['bun-win-x64'],
- * 		}
+ * 		},
+ * 		esBundlerPlugins: [],
  * 	}),
  * ])
  */
-export function CompileJS({ entryPoint, minifyFirst, encoding, outDir, compiler, compilerArguments, }: {
+export function CompileJS({ entryPoint, minifyFirst, encoding, outDir, compiler, compilerArguments, esBundlerPlugins, }: {
     entryPoint: string;
     encoding?: BufferEncoding;
     minifyFirst: boolean;
     outDir: string;
     compiler?: "pkg" | "bun" | "deno";
     compilerArguments?: Record<string, string>;
+    esBundlerPlugins?: ReturnType<CreateESPlugin>[];
 }): ReturnType<typeof TryAsync>;
 export type PlatformKey = "win32" | "linux" | "darwin" | string;
+export type CreateESPlugin = typeof import("./CreateESPlugin.mjs")["CreateESPlugin"];
 import { TryAsync } from '../function/TryAsync.mjs';

package/types/src/class/Setup.d.mts

@@ -54,10 +54,9 @@ export class Setup {
      * 	},
      * });
      */
-    static workerMain: ({ workerClass, pathValidator, basePath }: {
+    static workerMain: ({ workerClass, pathValidator }: {
         workerClass: (typeof WorkerMainThread)["workerClass"];
         pathValidator: (typeof WorkerMainThread)["pathValidator"];
-        basePath?: (typeof WorkerMainThread)["basePath"];
     }) => void;
     /**
      * @description

package/types/src/class/WorkerMainThread.d.mts

@@ -29,34 +29,34 @@ export class WorkerMainThread<WT extends WorkerThread> {
      * @param {typeof WorkerMainThread["pathValidator"]} param0.pathValidator
      * - example:
      * ```js
-     * async (workerPath, root, base) => {
+     * async (workerPath, root) => {
      *  const truePathCheck = `${root}/${base}/${workerPath}`;
      * 	const res = await fetch(truePathCheck);
      * 	// might also check wheter it need base or not
      * 	return await res.ok;
      * }
      * ```
-     * @param {typeof WorkerMainThread["basePath"]} [param0.basePath]
-     * - additonal realtivePath from rootPath;
-     * - default: '';
      * @example
      * import { Worker } from 'node:worker_threads';
      * import { WorkerMainThread } from 'vivth';
      *
      * WorkerMainThread.setup({
      * 	workerClass: Worker,
-     * 	basePath: 'public/assets/js/workers',
-     * 	pathValidator: async (workerPath, root, base) => {
-     * 		const res = await fetch(`${root}/${base}/${workerPath}`);
-     * 		// might also check wheter it need base or not
-     * 		return await res.ok;
+     * 	pathValidator: async ({worker, root}) => {
+     * 		const res = await fetch(`${root}/${worker}`);
+     * 		if (res.ok) {
+     * 			return res
+     * 		}
+     * 		const res2 = await fetch(`${root}/someAdditionalPath/${worker}`);
+     * 		if (res2.ok) {
+     * 			return res2
+     * 		}
      * 	},
      * });
      */
-    static setup: ({ workerClass, pathValidator, basePath }: {
+    static setup: ({ workerClass, pathValidator }: {
         workerClass: (typeof WorkerMainThread)["workerClass"];
         pathValidator: (typeof WorkerMainThread)["pathValidator"];
-        basePath?: (typeof WorkerMainThread)["basePath"];
     }) => void;
     /**
      * @description
@@ -65,23 +65,15 @@ export class WorkerMainThread<WT extends WorkerThread> {
      * @type {typeof Worker|typeof import('worker_threads').Worker}
      */
     static workerClass: typeof Worker | typeof import("worker_threads").Worker;
-    /**
-     * @description
-     * - reference for worker file `basePath`;
-     * - edit via `setup`;
-     * @type {string}
-     */
-    static basePath: string;
     /**
      * @description
      * - reference for validating path;
      * - edit via `setup`;
-     * @type {(paths:{worker: string, root:string, base: string})=>Promise<string>}
+     * @type {(paths:{worker: string, root:string})=>Promise<string>}
      */
     static pathValidator: (paths: {
         worker: string;
         root: string;
-        base: string;
     }) => Promise<string>;
     static #options: import("worker_threads").WorkerOptions & {
         type?: "module";

package/types/src/class/WorkerMainThreadBundled.d.mts

@@ -18,28 +18,21 @@ export class WorkerMainThread<WT extends WorkerThread> {
      * @param {Object} param0
      * @param {typeof WorkerMainThread["workerClass"]} param0.workerClass
      * @param {typeof WorkerMainThread["pathValidator"]} param0.pathValidator
-     * @param {typeof WorkerMainThread["basePath"]} [param0.basePath]
      */
-    static setup: ({ workerClass, pathValidator, basePath }: {
+    static setup: ({ workerClass, pathValidator }: {
         workerClass: (typeof WorkerMainThread)["workerClass"];
         pathValidator: (typeof WorkerMainThread)["pathValidator"];
-        basePath?: (typeof WorkerMainThread)["basePath"];
     }) => void;
     /**
      * @type {typeof Worker|typeof import('worker_threads').Worker}
      */
     static workerClass: typeof Worker | typeof import("worker_threads").Worker;
     /**
-     * @type {string}
-     */
-    static basePath: string;
-    /**
-     * @type {(paths:{worker: string, root:string, base: string})=>Promise<string>}
+     * @type {(paths:{worker: string, root:string})=>Promise<string>}
      */
     static pathValidator: (paths: {
         worker: string;
         root: string;
-        base: string;
     }) => Promise<string>;
     static #options: import("worker_threads").WorkerOptions & {
         type?: "module";