trousse 1.0.0 → 1.1.0

package/README.md

@@ -4,7 +4,7 @@
 [![npm version](https://img.shields.io/npm/v/trousse.svg)](https://www.npmjs.com/package/trousse)
 [![license](https://img.shields.io/npm/l/trousse.svg)](https://github.com/macieklamberski/trousse/blob/main/LICENSE)
 
-Personal toolbox of shared TypeScript utilities used across my projects: type guards, coercions, matching and array helpers.
+Personal toolbox of shared TypeScript utilities used across my projects: type guards, coercions, matching, array and locale interpolation helpers.
 
 ## Installation
 

package/dist/index.d.ts

@@ -3,7 +3,8 @@ import { MaybePromise, Nullish, Pattern } from "./types.js";
 import { coerceArray, coerceBoolean, coerceDate, coerceNumber, coerceSingular, coerceString } from "./coercions.js";
 import { isBoolean, isFunction, isNonEmptyString, isNullish, isNumber, isObject, isPlainObject, isPresent, isString, isValidDate } from "./is.js";
 import { isJsonLike, isParseableJson } from "./json.js";
+import { escapeHtml, t, tx } from "./locales.js";
 import { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, startsWithAnyOf } from "./matching.js";
 import { sleep } from "./timers.js";
 import { getPathSegments, isHostOf, isSubdomainOf, parseUrl } from "./urls.js";
-export { type MaybePromise, type Nullish, type Pattern, anyWordMatchesAnyOf, coerceArray, coerceBoolean, coerceDate, coerceNumber, coerceSingular, coerceString, endsWithAnyOf, getPathSegments, includesAnyOf, isAnyOf, isBoolean, isFunction, isHostOf, isJsonLike, isNonEmptyString, isNullish, isNumber, isObject, isParseableJson, isPlainObject, isPresent, isString, isSubdomainOf, isValidDate, omitEmpty, parseUrl, sleep, startsWithAnyOf };
+export { type MaybePromise, type Nullish, type Pattern, anyWordMatchesAnyOf, coerceArray, coerceBoolean, coerceDate, coerceNumber, coerceSingular, coerceString, endsWithAnyOf, escapeHtml, getPathSegments, includesAnyOf, isAnyOf, isBoolean, isFunction, isHostOf, isJsonLike, isNonEmptyString, isNullish, isNumber, isObject, isParseableJson, isPlainObject, isPresent, isString, isSubdomainOf, isValidDate, omitEmpty, parseUrl, sleep, startsWithAnyOf, t, tx };

package/dist/index.js

@@ -2,7 +2,8 @@ import { isBoolean, isFunction, isNonEmptyString, isNullish, isNumber, isObject,
 import { omitEmpty } from "./arrays.js";
 import { coerceArray, coerceBoolean, coerceDate, coerceNumber, coerceSingular, coerceString } from "./coercions.js";
 import { isJsonLike, isParseableJson } from "./json.js";
+import { escapeHtml, t, tx } from "./locales.js";
 import { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, startsWithAnyOf } from "./matching.js";
 import { sleep } from "./timers.js";
 import { getPathSegments, isHostOf, isSubdomainOf, parseUrl } from "./urls.js";
-export { anyWordMatchesAnyOf, coerceArray, coerceBoolean, coerceDate, coerceNumber, coerceSingular, coerceString, endsWithAnyOf, getPathSegments, includesAnyOf, isAnyOf, isBoolean, isFunction, isHostOf, isJsonLike, isNonEmptyString, isNullish, isNumber, isObject, isParseableJson, isPlainObject, isPresent, isString, isSubdomainOf, isValidDate, omitEmpty, parseUrl, sleep, startsWithAnyOf };
+export { anyWordMatchesAnyOf, coerceArray, coerceBoolean, coerceDate, coerceNumber, coerceSingular, coerceString, endsWithAnyOf, escapeHtml, getPathSegments, includesAnyOf, isAnyOf, isBoolean, isFunction, isHostOf, isJsonLike, isNonEmptyString, isNullish, isNumber, isObject, isParseableJson, isPlainObject, isPresent, isString, isSubdomainOf, isValidDate, omitEmpty, parseUrl, sleep, startsWithAnyOf, t, tx };

package/dist/is.js

@@ -25,7 +25,10 @@ const isPlainObject = (value) => {
 };
 const whitespaceOnlyRegex = /^\p{White_Space}*$/u;
 const isNonEmptyString = (value) => {
-	return isString(value) && value !== "" && !whitespaceOnlyRegex.test(value);
+	if (!isString(value) || value === "") return false;
+	const code = value.charCodeAt(0);
+	if (code > 32 && code < 127) return true;
+	return !whitespaceOnlyRegex.test(value);
 };
 const isValidDate = (value) => {
 	return value instanceof Date && !Number.isNaN(value.getTime());

package/dist/json.js

@@ -1,11 +1,16 @@
 //#region src/json.ts
-const jsonObjectStartRegex = /^\s*\{/;
-const jsonObjectEndRegex = /\}\s*$/;
-const jsonArrayStartRegex = /^\s*\[/;
-const jsonArrayEndRegex = /\]\s*$/;
+const isWhitespaceCode = (code) => {
+	return code >= 9 && code <= 13 || code === 32 || code === 160 || code === 5760 || code >= 8192 && code <= 8202 || code === 8232 || code === 8233 || code === 8239 || code === 8287 || code === 12288 || code === 65279;
+};
 const isJsonLike = (value) => {
 	if (value.length < 2) return false;
-	return jsonObjectStartRegex.test(value) && jsonObjectEndRegex.test(value) || jsonArrayStartRegex.test(value) && jsonArrayEndRegex.test(value);
+	let start = 0;
+	let end = value.length - 1;
+	while (start < end && isWhitespaceCode(value.charCodeAt(start))) start++;
+	while (end > start && isWhitespaceCode(value.charCodeAt(end))) end--;
+	const first = value.charCodeAt(start);
+	const last = value.charCodeAt(end);
+	return first === 123 && last === 125 || first === 91 && last === 93;
 };
 const isParseableJson = (value) => {
 	try {

package/dist/locales.d.ts

@@ -0,0 +1,6 @@
+//#region src/locales.d.ts
+declare const escapeHtml: (value: string) => string;
+declare const t: (template: string, params: Record<string, string | number>) => string;
+declare const tx: (template: string, params: Record<string, string | number>) => string;
+//#endregion
+export { escapeHtml, t, tx };

package/dist/locales.js

@@ -0,0 +1,22 @@
+//#region src/locales.ts
+const placeholderRegex = /\{\{(\w+)\}\}/g;
+const escapableRegex = /[&<>"']/g;
+const escapeHtml = (value) => {
+	return value.replace(escapableRegex, (char) => {
+		switch (char) {
+			case "&": return "&amp;";
+			case "<": return "&lt;";
+			case ">": return "&gt;";
+			case "\"": return "&quot;";
+			default: return "&#39;";
+		}
+	});
+};
+const t = (template, params) => {
+	return template.replace(placeholderRegex, (_, key) => String(params[key]));
+};
+const tx = (template, params) => {
+	return template.replace(placeholderRegex, (_, key) => escapeHtml(String(params[key])));
+};
+//#endregion
+export { escapeHtml, t, tx };

package/dist/matching.js

@@ -29,7 +29,16 @@ const endsWithAnyOf = (value, patterns) => {
 	});
 };
 const anyWordMatchesAnyOf = (value, patterns) => {
-	return value.toLowerCase().split(whitespaceRegex).some((word) => isAnyOf(word, patterns));
+	const stringPatterns = [];
+	const regexPatterns = [];
+	for (const pattern of patterns) if (pattern instanceof RegExp) regexPatterns.push(pattern);
+	else stringPatterns.push(pattern.toLowerCase().trim());
+	const words = value.toLowerCase().split(whitespaceRegex);
+	for (const word of words) {
+		for (const stringPattern of stringPatterns) if (word === stringPattern) return true;
+		for (const regexPattern of regexPatterns) if (regexPattern.test(word)) return true;
+	}
+	return false;
 };
 //#endregion
 export { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, startsWithAnyOf };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trousse",
-  "description": "Personal toolbox of shared TypeScript utilities: type guards, coercions, matching and array helpers.",
+  "description": "Personal toolbox of shared TypeScript utilities: type guards, coercions, matching, array and locale interpolation helpers.",
   "repository": {
     "type": "git",
     "url": "https://github.com/macieklamberski/trousse.git"
@@ -40,5 +40,5 @@
     "kvalita": "^1.15.0",
     "tsdown": "^0.22.2"
   },
-  "version": "1.0.0"
+  "version": "1.1.0"
 }