vivth 1.4.3 → 1.4.4

package/README.md

@@ -92,6 +92,7 @@ npm i vivth
 - [GetRuntime](#getruntime)
 - [IsAsync](#isasync)
 - [LazyFactory](#lazyfactory)
+- [TemplateLiteral](#templateliteral)
 - [Timeout](#timeout)
 - [Tries](#tries)
 - [TryAsync](#tryasync)
@@ -3272,6 +3273,41 @@ myInstance["vivth:unwrapLazy;"](); // forcefully call factory generator;
 
 \*) <sub>[go to list of exported API and typehelpers](#list-of-exported-api-and-typehelpers)</sub>
 
+<h2 id="templateliteral">TemplateLiteral</h2>
+
+#### reference:`TemplateLiteral`
+
+- function helper to create template literal with VALUEhandler to handle each values;
+
+```js
+/**
+ * @template {(input:any)=>string|Promise<string>} VALUEHANDLER
+ * @param {VALUEHANDLER} valueHandler
+ * @param {(result:string)=>string} [postProcess]
+ * @returns {(strings:TemplateStringsArray,
+ * ...values:(Parameters<VALUEHANDLER>[0])[])=>
+ * ReturnType<VALUEHANDLER>}
+ */
+```
+
+- <i>example</i>:
+
+```js
+ import { TemplateLiteral } form 'vivth';
+
+ export const html = TemplateLiteral(
+  (val) => val,
+  // optional
+  (res) => return window.body.innerHTML = res
+ );
+
+ html`<div>${`<button>innerButton</button>`}</div>`;
+ // this will set innerHTML of body to '<div><button>innerButton</button></div>'
+
+```
+
+\*) <sub>[go to list of exported API and typehelpers](#list-of-exported-api-and-typehelpers)</sub>
+
 <h2 id="timeout">Timeout</h2>
 
 #### reference:`Timeout`

package/index.mjs

@@ -45,6 +45,7 @@ export { GetNamedImportAlias } from './src/function/GetNamedImportAlias.mjs';
 export { GetRuntime } from './src/function/GetRuntime.mjs';
 export { IsAsync } from './src/function/IsAsync.mjs';
 export { LazyFactory } from './src/function/LazyFactory.mjs';
+export { TemplateLiteral } from './src/function/TemplateLiteral.mjs';
 export { Timeout } from './src/function/Timeout.mjs';
 export { Tries } from './src/function/Tries.mjs';
 export { TryAsync } from './src/function/TryAsync.mjs';

package/package.json

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

package/src/class/LitExp.mjs

@@ -132,7 +132,7 @@ export class LitExp {
 					throw new Error('string undefined');
 				}
 				if (i + 1 == stringsLength && string === '') {
-					result.push('(?:\\s+?|;|,|$|)');
+					result.push('(?:\\s+?|;|,|$|\/\/)');
 				} else {
 					result.push(LitExp.escape(string));
 				}

package/src/function/TemplateLiteral.mjs

@@ -0,0 +1,67 @@
+// @ts-check
+
+import { IsAsync } from './IsAsync.mjs';
+
+/**
+ * @description
+ * - function helper to create template literal with VALUEhandler to handle each values;
+ * @template {(input:any)=>string|Promise<string>} VALUEHANDLER
+ * @param {VALUEHANDLER} valueHandler
+ * @param {(result:string)=>string} [postProcess]
+ * @returns {(strings:TemplateStringsArray,
+ * ...values:(Parameters<VALUEHANDLER>[0])[])=>
+ * ReturnType<VALUEHANDLER>}
+ * @example
+ * import { TemplateLiteral } form 'vivth';
+ *
+ * export const html = TemplateLiteral(
+ *  (val) => val,
+ *  // optional
+ *  (res) => return window.body.innerHTML = res
+ * );
+ *
+ * html`<div>${`<button>innerButton</button>`}</div>`;
+ * // this will set innerHTML of body to '<div><button>innerButton</button></div>'
+ */
+export function TemplateLiteral(valueHandler, postProcess = undefined) {
+	if (IsAsync(valueHandler)) {
+		// @ts-expect-error
+		return async (strings, ...values) => {
+			const result = [];
+			for (let i = 0; i < strings.length; i++) {
+				result.push(strings[i]);
+				if (i < values.length) {
+					const value = values[i];
+					if (value === undefined) {
+						continue;
+					}
+					result.push(await valueHandler(value));
+				}
+			}
+			const resTrue = result.join('');
+			if (!postProcess) {
+				return resTrue;
+			}
+			return postProcess(resTrue);
+		};
+	}
+	// @ts-expect-error
+	return (strings, ...values) => {
+		const result = [];
+		for (let i = 0; i < strings.length; i++) {
+			result.push(strings[i]);
+			if (i < values.length) {
+				const value = values[i];
+				if (value === undefined) {
+					continue;
+				}
+				result.push(valueHandler(value));
+			}
+		}
+		const resTrue = result.join('');
+		if (!postProcess) {
+			return resTrue;
+		}
+		return postProcess(resTrue);
+	};
+}

package/types/index.d.mts

@@ -37,6 +37,7 @@ export { GetNamedImportAlias } from "./src/function/GetNamedImportAlias.mjs";
 export { GetRuntime } from "./src/function/GetRuntime.mjs";
 export { IsAsync } from "./src/function/IsAsync.mjs";
 export { LazyFactory } from "./src/function/LazyFactory.mjs";
+export { TemplateLiteral } from "./src/function/TemplateLiteral.mjs";
 export { Timeout } from "./src/function/Timeout.mjs";
 export { Tries } from "./src/function/Tries.mjs";
 export { TryAsync } from "./src/function/TryAsync.mjs";

package/types/src/function/TemplateLiteral.d.mts

@@ -0,0 +1,22 @@
+/**
+ * @description
+ * - function helper to create template literal with VALUEhandler to handle each values;
+ * @template {(input:any)=>string|Promise<string>} VALUEHANDLER
+ * @param {VALUEHANDLER} valueHandler
+ * @param {(result:string)=>string} [postProcess]
+ * @returns {(strings:TemplateStringsArray,
+ * ...values:(Parameters<VALUEHANDLER>[0])[])=>
+ * ReturnType<VALUEHANDLER>}
+ * @example
+ * import { TemplateLiteral } form 'vivth';
+ *
+ * export const html = TemplateLiteral(
+ *  (val) => val,
+ *  // optional
+ *  (res) => return window.body.innerHTML = res
+ * );
+ *
+ * html`<div>${`<button>innerButton</button>`}</div>`;
+ * // this will set innerHTML of body to '<div><button>innerButton</button></div>'
+ */
+export function TemplateLiteral<VALUEHANDLER extends (input: any) => string | Promise<string>>(valueHandler: VALUEHANDLER, postProcess?: (result: string) => string): (strings: TemplateStringsArray, ...values: (Parameters<VALUEHANDLER>[0])[]) => ReturnType<VALUEHANDLER>;