vivth 0.11.1 → 1.0.0

package/README.src.md

@@ -0,0 +1,35 @@
+## HOW TO INSTALL
+
+- example uses `npm`, you can allways use your own favourite package manager;
+
+```shell
+npm i vivth
+```
+
+## vivth
+
+- `vivth` are intended to be a collections of usefull `primitives`, and not to be directly used as
+  underlying framework;
+- completely `JSruntime` agnostic:
+  > - instead of `vivth` trying to guess, all runtime specific API should be provided by dev;
+- contains helpers to help you write data driven javascript program, including:
+  > - collections of extremely ⚡ performant `signal` classes;
+  >   > - `vivth` deliberately take away `auto-subscription`:
+  >   >   > - and introducing more imperative way of subsrciption yet still simple enough, which in
+  >   >   >   turn, it completely removes total code blocking on previously needed auto subsrciption
+  >   >   >   process on first run;
+  >   >   > - and also make previously unthinkable dynamic subscription on conditionals that runs
+  >   >   >   outside first run, now completely possible;
+  > - collections of `queue-helper` classes;
+  > - fully typed `worker-threads` abstraction;
+  > - ` error as value` function helper;
+  > - opionated `autoDocumentation`;
+  > - opionated `bundler`;
+
+## versions:
+
+- `1.0.0:b`:
+  > - beta release;
+  > - checking edge cases;
+  > - stable API, the exposed API access are highly unlikely to changes, only the underlying code
+  >   might changes for improving performance;

package/bun.lock

@@ -3,18 +3,70 @@
   "workspaces": {
     "": {
       "name": "vivth",
+      "dependencies": {
+        "chokidar": "^4.0.3",
+        "esbuild": "^0.25.9",
+      },
       "devDependencies": {
-        "@html_first/js_lib_template": "link:@html_first/js_lib_template",
         "@html_first/simple_queue": "^1.3.1",
         "@types/bun": "latest",
-        "chokidar": "^4.0.3",
         "concurrently": "^9.1.2",
         "typescript": "^5.8.3",
       },
     },
   },
   "packages": {
-    "@html_first/js_lib_template": ["@html_first/js_lib_template@link:@html_first/js_lib_template", {}],
+    "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.25.9", "", { "os": "aix", "cpu": "ppc64" }, "sha512-OaGtL73Jck6pBKjNIe24BnFE6agGl+6KxDtTfHhy1HmhthfKouEcOhqpSL64K4/0WCtbKFLOdzD/44cJ4k9opA=="],
+
+    "@esbuild/android-arm": ["@esbuild/android-arm@0.25.9", "", { "os": "android", "cpu": "arm" }, "sha512-5WNI1DaMtxQ7t7B6xa572XMXpHAaI/9Hnhk8lcxF4zVN4xstUgTlvuGDorBguKEnZO70qwEcLpfifMLoxiPqHQ=="],
+
+    "@esbuild/android-arm64": ["@esbuild/android-arm64@0.25.9", "", { "os": "android", "cpu": "arm64" }, "sha512-IDrddSmpSv51ftWslJMvl3Q2ZT98fUSL2/rlUXuVqRXHCs5EUF1/f+jbjF5+NG9UffUDMCiTyh8iec7u8RlTLg=="],
+
+    "@esbuild/android-x64": ["@esbuild/android-x64@0.25.9", "", { "os": "android", "cpu": "x64" }, "sha512-I853iMZ1hWZdNllhVZKm34f4wErd4lMyeV7BLzEExGEIZYsOzqDWDf+y082izYUE8gtJnYHdeDpN/6tUdwvfiw=="],
+
+    "@esbuild/darwin-arm64": ["@esbuild/darwin-arm64@0.25.9", "", { "os": "darwin", "cpu": "arm64" }, "sha512-XIpIDMAjOELi/9PB30vEbVMs3GV1v2zkkPnuyRRURbhqjyzIINwj+nbQATh4H9GxUgH1kFsEyQMxwiLFKUS6Rg=="],
+
+    "@esbuild/darwin-x64": ["@esbuild/darwin-x64@0.25.9", "", { "os": "darwin", "cpu": "x64" }, "sha512-jhHfBzjYTA1IQu8VyrjCX4ApJDnH+ez+IYVEoJHeqJm9VhG9Dh2BYaJritkYK3vMaXrf7Ogr/0MQ8/MeIefsPQ=="],
+
+    "@esbuild/freebsd-arm64": ["@esbuild/freebsd-arm64@0.25.9", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-z93DmbnY6fX9+KdD4Ue/H6sYs+bhFQJNCPZsi4XWJoYblUqT06MQUdBCpcSfuiN72AbqeBFu5LVQTjfXDE2A6Q=="],
+
+    "@esbuild/freebsd-x64": ["@esbuild/freebsd-x64@0.25.9", "", { "os": "freebsd", "cpu": "x64" }, "sha512-mrKX6H/vOyo5v71YfXWJxLVxgy1kyt1MQaD8wZJgJfG4gq4DpQGpgTB74e5yBeQdyMTbgxp0YtNj7NuHN0PoZg=="],
+
+    "@esbuild/linux-arm": ["@esbuild/linux-arm@0.25.9", "", { "os": "linux", "cpu": "arm" }, "sha512-HBU2Xv78SMgaydBmdor38lg8YDnFKSARg1Q6AT0/y2ezUAKiZvc211RDFHlEZRFNRVhcMamiToo7bDx3VEOYQw=="],
+
+    "@esbuild/linux-arm64": ["@esbuild/linux-arm64@0.25.9", "", { "os": "linux", "cpu": "arm64" }, "sha512-BlB7bIcLT3G26urh5Dmse7fiLmLXnRlopw4s8DalgZ8ef79Jj4aUcYbk90g8iCa2467HX8SAIidbL7gsqXHdRw=="],
+
+    "@esbuild/linux-ia32": ["@esbuild/linux-ia32@0.25.9", "", { "os": "linux", "cpu": "ia32" }, "sha512-e7S3MOJPZGp2QW6AK6+Ly81rC7oOSerQ+P8L0ta4FhVi+/j/v2yZzx5CqqDaWjtPFfYz21Vi1S0auHrap3Ma3A=="],
+
+    "@esbuild/linux-loong64": ["@esbuild/linux-loong64@0.25.9", "", { "os": "linux", "cpu": "none" }, "sha512-Sbe10Bnn0oUAB2AalYztvGcK+o6YFFA/9829PhOCUS9vkJElXGdphz0A3DbMdP8gmKkqPmPcMJmJOrI3VYB1JQ=="],
+
+    "@esbuild/linux-mips64el": ["@esbuild/linux-mips64el@0.25.9", "", { "os": "linux", "cpu": "none" }, "sha512-YcM5br0mVyZw2jcQeLIkhWtKPeVfAerES5PvOzaDxVtIyZ2NUBZKNLjC5z3/fUlDgT6w89VsxP2qzNipOaaDyA=="],
+
+    "@esbuild/linux-ppc64": ["@esbuild/linux-ppc64@0.25.9", "", { "os": "linux", "cpu": "ppc64" }, "sha512-++0HQvasdo20JytyDpFvQtNrEsAgNG2CY1CLMwGXfFTKGBGQT3bOeLSYE2l1fYdvML5KUuwn9Z8L1EWe2tzs1w=="],
+
+    "@esbuild/linux-riscv64": ["@esbuild/linux-riscv64@0.25.9", "", { "os": "linux", "cpu": "none" }, "sha512-uNIBa279Y3fkjV+2cUjx36xkx7eSjb8IvnL01eXUKXez/CBHNRw5ekCGMPM0BcmqBxBcdgUWuUXmVWwm4CH9kg=="],
+
+    "@esbuild/linux-s390x": ["@esbuild/linux-s390x@0.25.9", "", { "os": "linux", "cpu": "s390x" }, "sha512-Mfiphvp3MjC/lctb+7D287Xw1DGzqJPb/J2aHHcHxflUo+8tmN/6d4k6I2yFR7BVo5/g7x2Monq4+Yew0EHRIA=="],
+
+    "@esbuild/linux-x64": ["@esbuild/linux-x64@0.25.9", "", { "os": "linux", "cpu": "x64" }, "sha512-iSwByxzRe48YVkmpbgoxVzn76BXjlYFXC7NvLYq+b+kDjyyk30J0JY47DIn8z1MO3K0oSl9fZoRmZPQI4Hklzg=="],
+
+    "@esbuild/netbsd-arm64": ["@esbuild/netbsd-arm64@0.25.9", "", { "os": "none", "cpu": "arm64" }, "sha512-9jNJl6FqaUG+COdQMjSCGW4QiMHH88xWbvZ+kRVblZsWrkXlABuGdFJ1E9L7HK+T0Yqd4akKNa/lO0+jDxQD4Q=="],
+
+    "@esbuild/netbsd-x64": ["@esbuild/netbsd-x64@0.25.9", "", { "os": "none", "cpu": "x64" }, "sha512-RLLdkflmqRG8KanPGOU7Rpg829ZHu8nFy5Pqdi9U01VYtG9Y0zOG6Vr2z4/S+/3zIyOxiK6cCeYNWOFR9QP87g=="],
+
+    "@esbuild/openbsd-arm64": ["@esbuild/openbsd-arm64@0.25.9", "", { "os": "openbsd", "cpu": "arm64" }, "sha512-YaFBlPGeDasft5IIM+CQAhJAqS3St3nJzDEgsgFixcfZeyGPCd6eJBWzke5piZuZ7CtL656eOSYKk4Ls2C0FRQ=="],
+
+    "@esbuild/openbsd-x64": ["@esbuild/openbsd-x64@0.25.9", "", { "os": "openbsd", "cpu": "x64" }, "sha512-1MkgTCuvMGWuqVtAvkpkXFmtL8XhWy+j4jaSO2wxfJtilVCi0ZE37b8uOdMItIHz4I6z1bWWtEX4CJwcKYLcuA=="],
+
+    "@esbuild/openharmony-arm64": ["@esbuild/openharmony-arm64@0.25.9", "", { "os": "none", "cpu": "arm64" }, "sha512-4Xd0xNiMVXKh6Fa7HEJQbrpP3m3DDn43jKxMjxLLRjWnRsfxjORYJlXPO4JNcXtOyfajXorRKY9NkOpTHptErg=="],
+
+    "@esbuild/sunos-x64": ["@esbuild/sunos-x64@0.25.9", "", { "os": "sunos", "cpu": "x64" }, "sha512-WjH4s6hzo00nNezhp3wFIAfmGZ8U7KtrJNlFMRKxiI9mxEK1scOMAaa9i4crUtu+tBr+0IN6JCuAcSBJZfnphw=="],
+
+    "@esbuild/win32-arm64": ["@esbuild/win32-arm64@0.25.9", "", { "os": "win32", "cpu": "arm64" }, "sha512-mGFrVJHmZiRqmP8xFOc6b84/7xa5y5YvR1x8djzXpJBSv/UsNK6aqec+6JDjConTgvvQefdGhFDAs2DLAds6gQ=="],
+
+    "@esbuild/win32-ia32": ["@esbuild/win32-ia32@0.25.9", "", { "os": "win32", "cpu": "ia32" }, "sha512-b33gLVU2k11nVx1OhX3C8QQP6UHQK4ZtN56oFWvVXvz2VkDoe6fbG8TOgHFxEvqeqohmRnIHe5A1+HADk4OQww=="],
+
+    "@esbuild/win32-x64": ["@esbuild/win32-x64@0.25.9", "", { "os": "win32", "cpu": "x64" }, "sha512-PPOl1mi6lpLNQxnGoyAfschAodRFYXJ+9fs6WHXz7CSWKbOqiMZsubC+BQsVKuul+3vKLuwTHsS2c2y9EoKwxQ=="],
 
     "@html_first/simple_queue": ["@html_first/simple_queue@1.3.1", "", {}, "sha512-YidSXC9aTa0iQAxOA9NIAQWtKp/PU6IwLU+tvlDV62FAy2vwa3/SdpvaMFkBS+3/3t0qOKQ8mZYesDWdhY9Yig=="],
 
@@ -44,6 +96,8 @@
 
     "emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
 
+    "esbuild": ["esbuild@0.25.9", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.25.9", "@esbuild/android-arm": "0.25.9", "@esbuild/android-arm64": "0.25.9", "@esbuild/android-x64": "0.25.9", "@esbuild/darwin-arm64": "0.25.9", "@esbuild/darwin-x64": "0.25.9", "@esbuild/freebsd-arm64": "0.25.9", "@esbuild/freebsd-x64": "0.25.9", "@esbuild/linux-arm": "0.25.9", "@esbuild/linux-arm64": "0.25.9", "@esbuild/linux-ia32": "0.25.9", "@esbuild/linux-loong64": "0.25.9", "@esbuild/linux-mips64el": "0.25.9", "@esbuild/linux-ppc64": "0.25.9", "@esbuild/linux-riscv64": "0.25.9", "@esbuild/linux-s390x": "0.25.9", "@esbuild/linux-x64": "0.25.9", "@esbuild/netbsd-arm64": "0.25.9", "@esbuild/netbsd-x64": "0.25.9", "@esbuild/openbsd-arm64": "0.25.9", "@esbuild/openbsd-x64": "0.25.9", "@esbuild/openharmony-arm64": "0.25.9", "@esbuild/sunos-x64": "0.25.9", "@esbuild/win32-arm64": "0.25.9", "@esbuild/win32-ia32": "0.25.9", "@esbuild/win32-x64": "0.25.9" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-CRbODhYyQx3qp7ZEwzxOk4JBqmD/seJrzPa/cGjY1VtIn5E09Oi9/dB4JwctnfZ8Q8iT7rioVv5k/FNT/uf54g=="],
+
     "escalade": ["escalade@3.2.0", "", {}, "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA=="],
 
     "get-caller-file": ["get-caller-file@2.0.5", "", {}, "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="],

package/dev/index.mjs

@@ -1,28 +1,27 @@
 // @ts-check
 
-import { __JSDev } from '@html_first/js_lib_template';
+import { Console } from '../src/class/Console.mjs';
+import { Setup } from '../src/class/Setup.mjs';
+import { JSautoDOC } from '../src/doc/JSautoDOC.mjs';
 
-new __JSDev({
-	filePath: './index.mjs',
-	folderPath: './src',
-	readMePath: './README.md',
-	copyright: ['developed and published under MIT license,'],
-	description: [
-		'## HOW TO INSTALL',
-		'```shell',
-		'npm i vivth',
-		'```',
-		'```shell',
-		'bun i vivth',
-		'```',
-		'',
-		'## vivth',
-		'- contains helpers to help you write autosubscriber pattern javascript program, including:',
-		'>- collections of signal based functions and classes;',
-		'>- collections of queue helper functions and classes;',
-		'',
-		'- `vivth` technically can run in any `js runtime`, since it uses non platform specific api;',
-		'- it is written specifically to be used as a primitives for javascript library or runtime, so there are no complex abstraction is, nor will be, added in `vivth` it self;',
-		'',
-	],
-}).run();
+const { paths, safeExit } = Setup;
+
+new paths({
+	root: process?.env?.INIT_CWD ?? process?.cwd(),
+});
+
+new safeExit({
+	exitEventNames: ['SIGINT', 'SIGTERM', 'exit'],
+	exitCallbackListeners: (eventName) => {
+		process.once(eventName, function () {
+			safeExit.instance.exiting.correction(true);
+			Console.log(`safe exit via "${eventName}"`);
+		});
+	},
+});
+
+new JSautoDOC({
+	paths: { dir: 'src', file: 'index.mjs', readMe: 'README.md' },
+	copyright: 'this library is made and distributed under MIT license;',
+	tableOfContentTitle: 'list of exported API and typehelpers',
+});

package/index.mjs

@@ -1,38 +1,60 @@
 // @ts-check
+
 /**
- * generated using:
- * @see {@link https://www.npmjs.com/package/@html_first/js_lib_template | @html_first/js_lib_template}
+ * automatically generated by `vivth.MJSautoDOC`
  * @copyright
- * developed and published under MIT license,
- * @description
- * ## HOW TO INSTALL
- * ```shell
- * npm i vivth
- * ```
- * ```shell
- * bun i vivth
- * ```
- * 
- * ## vivth
- * - contains helpers to help you write autosubscriber pattern javascript program, including:
- * >- collections of signal based functions and classes;
- * >- collections of queue helper functions and classes;
- * 
- * - `vivth` technically can run in any `js runtime`, since it uses non platform specific api;
- * - it is written specifically to be used as a primitives for javascript library or runtime, so there are no complex abstraction is, nor will be, added in `vivth` it self;
- * 
+ * this library is made and distributed under MIT license;
  */
-export { $ } from './src/class/$.mjs';
+
+export { CompileMJS } from './src/bundler/CompileMJS.mjs';
+export { EsBundler } from './src/bundler/EsBundler.mjs';
+export { Console } from './src/class/Console.mjs';
 export { Derived } from './src/class/Derived.mjs';
-export { PingFIFO } from './src/class/PingFIFO.mjs';
-export { PingUnique } from './src/class/PingUnique.mjs';
-export { Q } from './src/class/Q.mjs';
-export { QFIFO } from './src/class/QFIFO.mjs';
-export { QUnique } from './src/class/QUnique.mjs';
+export { Effect } from './src/class/Effect.mjs';
+export { EnvSignal } from './src/class/EnvSignal.mjs';
+export { EventSignal } from './src/class/EventSignal.mjs';
+export { ListDerived } from './src/class/ListDerived.mjs';
+export { ListSignal } from './src/class/ListSignal.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 { NewQBlock } from './src/function/NewQBlock.mjs';
+export { WorkerMainThread } from './src/class/WorkerMainThread.mjs';
+export { WorkerResult } from './src/class/WorkerResult.mjs';
+export { WorkerThread } from './src/class/WorkerThread.mjs';
+export { Base64URL } from './src/common/Base64URL.mjs';
+export { EventNameSpace } from './src/common/EventNameSpace.mjs';
+export { JSautoDOC } from './src/doc/JSautoDOC.mjs';
+export { CreateImmutable } from './src/function/CreateImmutable.mjs';
+export { EventCheck } from './src/function/EventCheck.mjs';
+export { EventObject } from './src/function/EventObject.mjs';
+export { IsAsync } from './src/function/IsAsync.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';
-/**
- * @typedef {{}|null|number|string|boolean|symbol|bigint|function} AnyButUndefined
+export { TsToMjs } from './src/function/TsToMjs.mjs';
+export { WriteFileSafe } from './src/function/WriteFileSafe.mjs';
+/**
+ * @typedef {import('./src/types/AnyButUndefined.mjs').AnyButUndefined} AnyButUndefined
+ */
+/**
+ * @typedef {import('./src/types/ExtnameType.mjs').ExtnameType} ExtnameType
+ */
+/**
+ * @typedef {import('./src/types/IsListSignal.mjs').IsListSignal} IsListSignal
+ */
+/**
+ * @typedef {import('./src/types/ListArg.mjs').ListArg} ListArg
+ */
+/**
+ * @typedef {import('./src/types/MutationType.mjs').MutationType} MutationType
+ */
+/**
+ * @typedef {import('./src/types/QCBFIFOReturn.mjs').QCBFIFOReturn} QCBFIFOReturn
+ */
+/**
+ * @typedef {import('./src/types/QCBReturn.mjs').QCBReturn} QCBReturn
  */

package/package.json

@@ -1,20 +1,19 @@
 {
 	"name": "vivth",
-	"version": "0.11.1",
+	"version": "1.0.0",
 	"description": "extremely simple signal as library primitives",
 	"main": "index.mjs",
 	"types": "./types/index.d.mts",
-	"scripts": {
-		"dev": "concurrently 'bun --watch ./dev/index.mjs' 'bun tsc --watch'"
-	},
 	"devDependencies": {
-		"@html_first/js_lib_template": "link:@html_first/js_lib_template",
 		"typescript": "^5.8.3",
 		"@html_first/simple_queue": "^1.3.1",
 		"concurrently": "^9.1.2",
-		"chokidar": "^4.0.3",
 		"@types/bun": "latest"
 	},
+	"dependencies": {
+		"chokidar": "^4.0.3",
+		"esbuild": "^0.25.9"
+	},
 	"peerDependencies": {},
 	"repository": {
 		"type": "git",
@@ -22,7 +21,8 @@
 	},
 	"keywords": [
 		"simple",
-		"signal"
+		"signal",
+		"data driven"
 	],
 	"author": "hakim_jazuli",
 	"license": "MIT",
@@ -30,5 +30,9 @@
 		"url": "https://github.com/hakimjazuli/vivth/issues"
 	},
 	"homepage": "https://github.com/hakimjazuli/vivth#readme",
+	"scripts": {
+		"dev": "concurrently 'bun --watch ./dev/index.mjs'",
+		"typed": "bun tsc --watch"
+	},
 	"sideEffects": false
 }

package/src/bundler/CompileMJS.mjs

@@ -0,0 +1,110 @@
+// @ts-check
+
+import { readFile } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+
+import { Paths } from '../class/Paths.mjs';
+import { EsBundler } from './EsBundler.mjs';
+import { Console } from '../class/Console.mjs';
+import { WriteFileSafe } from '../function/WriteFileSafe.mjs';
+
+/**
+ * @description
+ * - function to bundle to single mjs file, including the workerThread;
+ * @param {Object} options
+ * @param {string} options.entryPoint
+ * @param {string} options.outputNoExt
+ * - no extention needed, result will always be '.mjs';
+ * @param {BufferEncoding} options.encoding
+ * @param {boolean} [options.minify]
+ * - default false;
+ * @param {boolean} [options.asBinary]
+ * - default false;
+ * @returns {Promise<ReturnType<typeof WriteFileSafe>>}
+ * @example
+ * import { Paths, CompileMJS } from 'vivth';
+ *
+ * new Paths({
+ * 	root: process?.env?.INIT_CWD ?? process?.cwd(),
+ * });
+ *
+ * CompileMJS({
+ * 	entryPoint: '/index.mjs',
+ * 	encoding: 'utf-8',
+ * 	outputNoExt: '/test/compiled',
+ * 	minify: false,
+ * 	asBinary: true,
+ * });
+ */
+export const CompileMJS = async ({
+	entryPoint,
+	encoding,
+	outputNoExt,
+	minify = false,
+	asBinary = false,
+}) => {
+	const rootPath = Paths.root;
+	const fullpathEntry = join(rootPath, entryPoint);
+	const fulloutput = join(rootPath, `${outputNoExt}.mjs`);
+	const mainext = extname(fullpathEntry);
+	const [content, error] = await EsBundler(
+		{
+			content: await readFile(fullpathEntry, { encoding }),
+			extension: mainext,
+			asBinary: false,
+		},
+		{
+			minify: false,
+			keepNames: true,
+		}
+	);
+	if (error) {
+		Console.error(error);
+		return;
+	}
+	let strippedComment = content.replace(/\/\*\*[\s\S]*?\*\//gm, '');
+	const workersMatched = strippedComment
+		.matchAll(
+			/new\s(WorkerMainThread\w*?)\(['"]([\s\S]*?\.worker\.[\s\S]*?)['"][\s\S]*?(?:{([\s\S]*?)}|)[\s\S]*?\)/gm
+		)
+		.toArray();
+	/**
+	 * @type {Set<string>}
+	 */
+	const fileNames = new Set();
+	for (const [string, className, path_, options] of workersMatched) {
+		fileNames.add(path_);
+		const newComment = `new ${className}(vivthWorkerFilesObject["${path_}"], {${
+			options ?? ''
+		}}, true)`;
+		strippedComment = strippedComment.replace(string, newComment);
+	}
+	const vivthWorkerFilesObject = {};
+	for await (const path_ of fileNames) {
+		const workerFullPath = join(rootPath, path_);
+		const content = await readFile(workerFullPath, { encoding });
+		const [bundle, _] = await EsBundler(
+			{
+				content,
+				extension: extname(workerFullPath),
+			},
+			{
+				minify: true,
+			}
+		);
+		vivthWorkerFilesObject[path_] = bundle;
+	}
+	const [finalContent] = await EsBundler(
+		{
+			content: `const vivthWorkerFilesObject = ${JSON.stringify(
+				vivthWorkerFilesObject
+			)};\n${strippedComment}`,
+			extension: mainext,
+			asBinary,
+		},
+		{ minify }
+	);
+	return await WriteFileSafe(fulloutput, finalContent, {
+		encoding,
+	});
+};

package/src/bundler/EsBundler.mjs

@@ -0,0 +1,79 @@
+// @ts-check
+
+import { build } from 'esbuild';
+
+import { Console } from '../class/Console.mjs';
+import { Paths } from '../class/Paths.mjs';
+import { TryAsync } from '../function/TryAsync.mjs';
+
+/**
+ * @description
+ * - opinionated bundler for extension below using esbuild;
+ * - bundles all imports into a single output string;
+ * @param {Object} options
+ * @param {string} options.content
+ * - the code can also uses composites from the result from multiple readFiles;
+ * - the import statements on the content should use absolute path from project root, prefixed with forward slash;
+ * @param {string} options.extension
+ * @param {boolean} [options.asBinary]
+ * @param {Omit<Parameters<build>[0], 'entryPoints'|'bundle'|'write'|'format'|'sourcemap'|'external'|'stdin'>} [esbuildOptions]
+ * @returns {Promise<ReturnType<typeof TryAsync<string>>>}
+ * @example
+ * import { EsBundler } from 'vivth';
+ *
+ * const bundledString = EsBundler(,
+ * 	{
+ * 		content: ``,
+ * 		extension: '.mts',
+ * 		...options
+ * 	},
+ * 	{
+ * 	...esbuildOptions,
+ * });
+ */
+export const EsBundler = async ({ content, extension, asBinary = false }, esbuildOptions = {}) => {
+	return await TryAsync(async () => {
+		/** @type {Parameters<build>[0]['stdin']['loader']} */
+		let loader;
+		switch (extension) {
+			case '.mts':
+			case '.ts':
+				loader = 'ts';
+				break;
+			case '.mjs':
+				loader = 'js';
+				break;
+			default:
+				const error = {
+					extension,
+					message: 'Invalid extension passed to EsBundler',
+					acceptedextensions: ['.mts', '.ts', '.mjs'],
+				};
+				Console.error(error);
+				throw new Error(JSON.stringify(error));
+		}
+		const result = await build({
+			target: 'esnext',
+			platform: 'node',
+			...esbuildOptions,
+			stdin: {
+				contents: content,
+				loader,
+				resolveDir: Paths.root,
+			},
+			format: 'esm',
+			bundle: true,
+			write: false,
+			sourcemap: false,
+			external: [],
+			banner: {
+				js: asBinary ? '#!/usr/bin/env node' : '',
+			},
+		});
+		if (result.warnings?.length) {
+			Console.warn(result.warnings.map((w) => w.text).join('\n'));
+		}
+		const resString = result.outputFiles?.[0]?.text;
+		return resString ?? '';
+	});
+};

package/src/class/Console.mjs

@@ -0,0 +1,62 @@
+// @ts-check
+
+/**
+ * @description
+ * - class with static methods to print to standard console with added style;
+ */
+export class Console {
+	/**
+	 * @param {string} prefix
+	 * @param {'log'|'info'|'error'|'warn'} mode
+	 * - Console method to use
+	 * @param {any} data
+	 * @param {string} color
+	 * @param {string} bgcolor
+	 * @returns {void}
+	 */
+	static #call = (prefix, mode, data, color, bgcolor) => {
+		/** @type {unknown} */
+		const fn = console[mode];
+		if (typeof fn !== 'function') {
+			return;
+		}
+		fn.call(
+			console,
+			`%c${prefix} ${mode.toUpperCase()}:`,
+			`color:${color};background:${bgcolor};padding:2px 6px;border-radius:4px;`,
+			data
+		);
+	};
+	/**
+	 * @description
+	 * @param {any} data
+	 * @returns {void}
+	 */
+	static log = (data) => {
+		Console.#call('🟢', 'log', data, 'white', '#2e7d32');
+	};
+	/**
+	 * @description
+	 * @param {any} data
+	 * @returns {void}
+	 */
+	static info = (data) => {
+		Console.#call('🔵', 'info', data, 'white', '#1565c0');
+	};
+	/**
+	 * @description
+	 * @param {any} data
+	 * @returns {void}
+	 */
+	static warn = (data) => {
+		Console.#call('🟠', 'warn', data, 'black', '#ffb300');
+	};
+	/**
+	 * @description
+	 * @param {any} data
+	 * @returns {void}
+	 */
+	static error = (data) => {
+		Console.#call('🔴', 'error', data, 'white', '#c62828');
+	};
+}

package/src/class/Derived.mjs

@@ -1,48 +1,64 @@
 // @ts-check
 
 import { Signal } from './Signal.mjs';
-import { $ } from './$.mjs';
-import { isAsync } from '../common.mjs';
+import { Effect } from './Effect.mjs';
+import { Console } from './Console.mjs';
 
 /**
  * @description
- * - a class for creating signal which its value are derived from other signal (`Derived` and `Signal` alike);
- * - can be subscribed by using [New$](#new$);
- * - for minimal total bundle size use `function` [NewDerived](#newderived) instead;
- */
-/**
+ * - a class for creating derived version of [Signal](#signal);
  * @template V
  * @extends Signal<V>
  */
 export class Derived extends Signal {
 	/**
-	 * @param {()=>V} derivedFunction
+	 * @description
+	 * - Derived used [Signal](#signal) and [Effect](#effect) under the hood;
+	 * @param {(effectInstanceOptions:Effect["options"])=>Promise<V>} derivedFunction
+	 * @example
+	 * import { Signal, Derived } from  'vivth';
+	 *
+	 * const count = new Signal(0);
+	 * const double = new Derived(async({
+	 * 		subscribe,
+	 * 		// : registrar callback for this derived instance, immediately return the signal instance
+	 * 	}) => {
+	 * 	return subscribe(count).value + count.value;
+	 * 	// double listen to count changes, by returning the value, double.value also changes
+	 * 	// notice the count.value are accessed double, but it's all safe,
+	 * 	// since the wrapped one is the only one that are recorded as notifier.
+	 * });
+	 *
+	 * count.value++;
 	 */
 	constructor(derivedFunction) {
-		// @ts-expect-error
-		super(0);
-		const real = isAsync(derivedFunction)
-			? async () => {
-					super.value = await derivedFunction();
-			  }
-			: () => {
-					super.value = derivedFunction();
-			  };
-		new $(real);
+		super(undefined);
+		new Effect(async (options) => {
+			super.value = await derivedFunction(options);
+		});
 	}
 	/**
+	 * @description
+	 * - the most recent value of the instance
+	 * - can be turn into reactive with Effect or Derived instantiation;
 	 * @type {V}
 	 */
 	get value() {
 		return super.value;
 	}
 	/**
+	 * @description
+	 * - Derived instance value cannot be manually assigned;
+	 * - it's value should always be determined by it's own `derivedFunction`;
 	 * @private
+	 * @type {V}
 	 */
-	set value(_) {
-		console.warn({
+	set value(newValue) {
+		Console.warn({
+			newValue,
+			currentValue: super.value,
 			derivedInstance: this,
-			warning: 'NewDerived.value cannot be manually assigned',
+			warning: 'derivedInstance.value cannot be manually assigned',
 		});
 	}
 }