vivth 1.5.8 → 1.5.9

package/README.md

@@ -5383,9 +5383,7 @@ A type-safe `typeof` helper.
 ```js
 /**
  * @template {keyof typeof TypeMap} K
- * @param {unknown} object - The value to check.
- * @param {K} type - The type string to compare against.
- * @returns {object is typeof TypeMap[K]} - Returns true if the type matches, narrowing the type.
+ * @typedef {import('./IsTypeOf.mts').IsTypeOf<K>} IsTypeOf
  */
 ```
 
@@ -6113,48 +6111,33 @@ const effer = newDerived(async ({ subscribe }) => {
 
 #### reference: `VivthyNeinth_instance.onMutate`
 
+- manually registering object celeanup;
+
 ```js
 /**
- * @type {Set<()=>Promise<void>>}
+ * @param {()=>Promise<void>} callback
+ * @returns {void}
  */
 ```
 
 - <i>example</i>:
 
 ```js
- import { watch } from "chokidar";
-  /// on VivthyNeinth arg callback scope
- const { onCleanups } = this;
- const watcher = watch('/src/');
- watcher.addListener('all', (...args)=>{
- 	// listener code;
- });
- onCleanups.add(async()=>{
- watcher.removeAllListeners();
- watcher.close();
- })
- ///
-	/ 	#onCleanups = new Set();  	/
-   @description
- - manually registering object celeanup;
- @param {()=>Promise<void>} callback
- @returns {void}
- @example
- import { watch } from 'chokidar';
-  /// on VivthyNeinth export callback scope
- const watcher = watch('D://my/dir/path');
- // preferably to declare the cleanup right bellow it's object creation;
- // set 'I__the_developer__have_provided_onFileMutations_cleanupCallbacks_for_every_long_running_object_in_this_file' to false if you might want to save before full cleanup is written;
- this.onMutate(async () => {
- 	watcher.removeAllListeners();
- 	watcher.close();
- });
-  watcher.addListener('all', (eventName, path, stats) => {
- 	//
- })
- ///
- // alternative: use vivth `modules` that returns object that implements `VivthCleanup`;
- // and call uses `registerObjectWithAutoCleanup`;
+import { watch } from "chokidar";
+/// on VivthyNeinth export callback scope
+const watcher = watch("D://my/dir/path");
+// preferably to declare the cleanup right bellow it's object creation;
+// set 'I__the_developer__have_provided_onFileMutations_cleanupCallbacks_for_every_long_running_object_in_this_file' to false if you might want to save before full cleanup is written;
+this.onMutate(async () => {
+  watcher.removeAllListeners();
+  watcher.close();
+});
+watcher.addListener("all", (eventName, path, stats) => {
+  //
+});
+///
+// alternative: use vivth `modules` that returns object that implements `VivthCleanup`;
+// and call uses `registerObjectWithAutoCleanup`;
 ```
 
 #### reference: `VivthyNeinth_instance.onExit`

package/generated/types/generated/vivth/exports/unsupported.d.mts

@@ -0,0 +1 @@
+export { FileSelfMapper } from "../../../src/bundler/FileSelfMapper.mjs";

package/generated/types/src/bundler/FileSelfMapper.d.mts

@@ -36,6 +36,15 @@
  * @implements {VivthCleanup}
  */
 export class FileSelfMapper implements VivthCleanup {
+    /**
+     * @param { string } path
+     * @param { (path:{mapTo:string, src:string}, content:string)=>(string|false) } [postprosess]
+     * @returns { Promise<void> }
+     */
+    static #writeHTML: (path: string, postprosess?: (path: {
+        mapTo: string;
+        src: string;
+    }, content: string) => (string | false)) => Promise<void>;
     /**
      * @param { string } path
      * @param { (path:{mapTo:string, src:string}, content:string)=>(string|false) } [postprosess]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vivth",
-  "version": "1.5.8",
+  "version": "1.5.9",
   "description": "library primitives",
   "devDependencies": {
     "@types/bun": "^1.3.3",

package/src/bundler/FileSelfMapper.mjs

@@ -3,8 +3,10 @@
 import { dirname, extname, relative } from 'node:path';
 import { readFile } from 'node:fs/promises';
 
+import { build } from 'esbuild';
 import { watch } from 'chokidar';
 import { compileAsync } from 'sass';
+import { createDocument } from 'domino';
 
 import { Paths } from '../class/Paths.mjs';
 import { QChannel } from '../class/QChannel.mjs';
@@ -92,8 +94,8 @@ export class FileSelfMapper {
 	constructor(watchPath, options) {
 		SafeExit.instance?.addCallback(this.vivthCleanup);
 		const watcherFullPath = Paths.diskAbsolute(watchPath);
-		const watcher = watch(watcherFullPath, { ignoreInitial: false });
-		watcher.addListener('all', async (eventName, path, stats) => {
+		this.#watcher = watch(watcherFullPath, { ignoreInitial: false });
+		this.#watcher.addListener('all', async (eventName, path, stats) => {
 			path = Paths.normalize(path);
 			const [, errorWatcherListener] = await this.#q.callback(path, async ({ isLastOnQ }) => {
 				await this.#listenerQ(isLastOnQ, eventName, path, watcherFullPath, options, stats);
@@ -111,6 +113,7 @@ export class FileSelfMapper {
 			);
 		});
 	}
+	#watcher;
 	/**
 	 * @type {QChannel<string>}
 	 */
@@ -127,6 +130,8 @@ export class FileSelfMapper {
 				await this.#runCleanupOfSpecificPath(path);
 			})[0],
 		);
+		this.#watcher.removeAllListeners();
+		this.#watcher.close();
 	};
 
 	/**
@@ -172,6 +177,10 @@ export class FileSelfMapper {
 			return;
 		}
 		const extension = extname(path);
+		if (extension === '.html') {
+			await FileSelfMapper.#writeHTML(path, options.postProcessDirectCopy);
+			return;
+		}
 		if (
 			extension !== '.scss' &&
 			extension !== '.sass' &&
@@ -188,6 +197,84 @@ export class FileSelfMapper {
 		}
 		await this.#bundleJS(watcherFullPath, path, options);
 	};
+	/**
+	 * @param { string } path
+	 * @param { (path:{mapTo:string, src:string}, content:string)=>(string|false) } [postprosess]
+	 * @returns { Promise<void> }
+	 */
+	static #writeHTML = async (path, postprosess) => {
+		const { content: originalContent, targetPaths } = await FileSelfMapper.#getTargetPath(path);
+		let newContent = originalContent;
+		const resDocument = createDocument(originalContent);
+		const fileSelfMapperAttribute = 'vivth-file-self-mapper';
+		const handledScripts = resDocument.querySelectorAll(`script[${fileSelfMapperAttribute}]`);
+		await Promise.all(
+			ForOfSync(handledScripts, async (scriptElement) => {
+				const directionsString = scriptElement.getAttribute(fileSelfMapperAttribute);
+				scriptElement.removeAttribute(fileSelfMapperAttribute);
+				if (!directionsString) return;
+				const directions = new Set(directionsString.split(';'));
+				const hasMin = directions.has('min');
+				const inner = scriptElement.innerHTML;
+				const res = await build({
+					write: false,
+					stdin: {
+						contents: inner,
+						loader: 'js',
+						resolveDir: dirname(path),
+					},
+					bundle: false,
+					logLevel: 'silent',
+					minify: hasMin,
+					format: directions.has('iife')
+						? 'iife'
+						: scriptElement.getAttribute('type') === 'module'
+							? 'esm'
+							: undefined,
+				});
+				if (res.errors.length) {
+					Console.error({
+						errorBuildingInlineScript: {
+							outer: scriptElement.outerHTML,
+							message: 'failed to build using esbuild.build',
+						},
+					});
+					return;
+				}
+
+				const minified = res.outputFiles[0]?.text;
+				newContent = newContent.replace(
+					inner,
+					// @ts-expect-error
+					minified,
+				);
+			})[0],
+		);
+		await Promise.all(
+			ForOfSync(targetPaths, async (target) => {
+				let processedContent;
+				if (postprosess) {
+					postprosess({ mapTo: target, src: path }, newContent);
+				}
+				const [, errorWriteHTML] = await FileSafe.write(
+					target,
+					(!!processedContent ? processedContent : newContent).replace(
+						/\s*vivth-file-self-mapper\="[\s\S]*?"\s*/g,
+						'',
+					),
+					{
+						encoding: Preferrence.encoding,
+					},
+				);
+				if (errorWriteHTML) {
+					Console.error({ errorWriteHTML }, { now: true });
+					return;
+				}
+				Console.info(`✅ Successfully map:'${path}' to:'${target}'`, { now: true });
+			})[0],
+		);
+	};
+
 	/**
 	 * @param { string } path
 	 * @param { (path:{mapTo:string, src:string}, content:string)=>(string|false) } [postprosess]

package/src/neinth/VivthyNeinth.mjs

@@ -333,22 +333,7 @@ export class VivthyNeinth {
 	);
 
 	/**
-	 * @description
 	 * @type {Set<()=>Promise<void>>}
-	 * @example
-	 * import { watch } from "chokidar";
-	 *
-	 * /// on VivthyNeinth arg callback scope
-	 * const { onCleanups } = this;
-	 * const watcher = watch('/src/');
-	 * watcher.addListener('all', (...args)=>{
-	 * 	// listener code;
-	 * });
-	 * onCleanups.add(async()=>{
-	 *	watcher.removeAllListeners();
-	 *	watcher.close();
-	 * })
-	 * ///
 	 */
 	#onCleanups = new Set();
 

package/src/web/signals/IsInViewPortSignal.mjs

@@ -115,7 +115,6 @@ export class IsInViewPortSignal extends Signal {
 		);
 	}
 	/**
-	 *
 	 * @param {boolean} newValue
 	 */
 	#setSuperValue(newValue) {