vivth 1.3.0 → 1.3.2

package/README.md

@@ -1881,9 +1881,32 @@ npm i vivth
 ```js  
  import { SafeExit } from 'vivth'; 	 
  	 
- SafeExit.instance.addCallback(()=>{ 	 
+ const exitCallback () => { 	 
  	// code 	 
- })
+ } 	 
+ SafeExit.instance.addCallback(exitCallback);
+ 
+```
+
+#### reference:`SafeExit_instance.removeCallback`
+- optional exit event removal; 	 
+- the callbacks will be removed from registered via `addCallback` exiting;
+
+```js
+/**
+ * @param {()=>(Promise<void>)} cb 	 
+ */
+```
+ - <i>example</i>:
+```js  
+ import { SafeExit } from 'vivth'; 	 
+ 	 
+ const exitCallback () => { 	 
+ 	// code 	 
+ } 	 
+ SafeExit.instance.addCallback(exitCallback); 	 
+ 	 
+ SafeExit.instance.removeCallback(exitCallback);
  
 ```
 
@@ -2367,7 +2390,8 @@ npm i vivth
 >>- you can always look at `vivth/src` files to check how the source, and the `README.md` and `index.mjs` documentation/generation results;  
 >6) this types of arrow functions will be converted to regullar function, for concise type emition:  
 >>- validly exported function;  
->>- static/instance method(s) with generic template;
+>>- static/instance method(s) with generic template;  
+>7) transpile `.ts` and `.mts` to `.mjs` same name and directory;
 
 
 #### reference:`new JSautoDOC`

package/package.json

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

package/src/class/SafeExit.mjs

@@ -137,13 +137,32 @@ export class SafeExit {
 	 * @example
 	 * import { SafeExit } from 'vivth';
 	 *
-	 * SafeExit.instance.addCallback(()=>{
+	 * const exitCallback () => {
 	 * 	// code
-	 * })
+	 * }
+	 * SafeExit.instance.addCallback(exitCallback);
 	 */
 	addCallback = (cb) => {
 		safeCleanUpCBs.add(cb);
 	};
+	/**
+	 * @description
+	 * - optional exit event removal;
+	 * - the callbacks will be removed from registered via `addCallback` exiting;
+	 * @param {()=>(Promise<void>)} cb
+	 * @example
+	 * import { SafeExit } from 'vivth';
+	 *
+	 * const exitCallback () => {
+	 * 	// code
+	 * }
+	 * SafeExit.instance.addCallback(exitCallback);
+	 *
+	 * SafeExit.instance.removeCallback(exitCallback);
+	 */
+	removeCallback = (cb) => {
+		safeCleanUpCBs.delete(cb);
+	};
 	/**
 	 * @type {()=>void}
 	 */

package/src/doc/JSautoDOC.mjs

@@ -50,6 +50,7 @@ const acceptableExt = new Set(['.mjs', '.mts', '.ts']);
  * >6) this types of arrow functions will be converted to regullar function, for concise type emition:
  * >>- validly exported function;
  * >>- static/instance method(s) with generic template;
+ * >7) transpile `.ts` and `.mts` to `.mjs` same name and directory;
  */
 export class JSautoDOC {
 	/**
@@ -114,6 +115,7 @@ export class JSautoDOC {
 				return;
 			}
 			if (ext !== '.mjs') {
+				// no need to be awaited
 				TsToMjs(path, {
 					encoding,
 				});

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

@@ -75,7 +75,7 @@ export function CompileJS({ entryPoint, minifyFirst, encoding, outDir, compiler,
     encoding?: BufferEncoding | undefined;
     minifyFirst: boolean;
     outDir: string;
-    compiler?: "pkg" | "bun" | "deno" | undefined;
+    compiler?: "bun" | "deno" | "pkg" | undefined;
     compilerArguments?: Record<string, string> | undefined;
     esBundlerPlugins?: import("esbuild").Plugin[] | undefined;
 }): ReturnType<typeof TryAsync<{

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

@@ -93,11 +93,28 @@ export class SafeExit {
      * @example
      * import { SafeExit } from 'vivth';
      *
-     * SafeExit.instance.addCallback(()=>{
+     * const exitCallback () => {
      * 	// code
-     * })
+     * }
+     * SafeExit.instance.addCallback(exitCallback);
      */
     addCallback: (cb: () => (Promise<void>)) => void;
+    /**
+     * @description
+     * - optional exit event removal;
+     * - the callbacks will be removed from registered via `addCallback` exiting;
+     * @param {()=>(Promise<void>)} cb
+     * @example
+     * import { SafeExit } from 'vivth';
+     *
+     * const exitCallback () => {
+     * 	// code
+     * }
+     * SafeExit.instance.addCallback(exitCallback);
+     *
+     * SafeExit.instance.removeCallback(exitCallback);
+     */
+    removeCallback: (cb: () => (Promise<void>)) => void;
     #private;
 }
 import { EnvSignal } from './EnvSignal.mjs';

package/types/src/doc/JSautoDOC.d.mts

@@ -18,6 +18,7 @@
  * >6) this types of arrow functions will be converted to regullar function, for concise type emition:
  * >>- validly exported function;
  * >>- static/instance method(s) with generic template;
+ * >7) transpile `.ts` and `.mts` to `.mjs` same name and directory;
  */
 export class JSautoDOC {
     /**