trousse 1.0.1 → 1.1.1

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/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.d.ts

@@ -1,10 +1,10 @@
 import { Pattern } from "./types.js";
 
 //#region src/matching.d.ts
-declare const isAnyOf: (value: string, patterns: Array<Pattern>, parser?: (value: string) => string) => boolean;
-declare const includesAnyOf: (value: string, patterns: Array<Pattern>, parser?: (value: string) => string) => boolean;
-declare const startsWithAnyOf: (value: string, patterns: Array<Pattern>) => boolean;
-declare const endsWithAnyOf: (value: string, patterns: Array<Pattern>) => boolean;
-declare const anyWordMatchesAnyOf: (value: string, patterns: Array<Pattern>) => boolean;
+declare const isAnyOf: (value: string, patterns: ReadonlyArray<Pattern>, parser?: (value: string) => string) => boolean;
+declare const includesAnyOf: (value: string, patterns: ReadonlyArray<Pattern>, parser?: (value: string) => string) => boolean;
+declare const startsWithAnyOf: (value: string, patterns: ReadonlyArray<Pattern>) => boolean;
+declare const endsWithAnyOf: (value: string, patterns: ReadonlyArray<Pattern>) => boolean;
+declare const anyWordMatchesAnyOf: (value: string, patterns: ReadonlyArray<Pattern>) => boolean;
 //#endregion
 export { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, startsWithAnyOf };

package/dist/urls.d.ts

@@ -1,7 +1,7 @@
 //#region src/urls.d.ts
 declare const parseUrl: (value: string | URL, base?: string | URL) => URL | undefined;
 declare const getPathSegments: (value: string | URL) => Array<string>;
-declare const isHostOf: (url: string | URL, hosts: string | Array<string>) => boolean;
-declare const isSubdomainOf: (url: string | URL, domains: string | Array<string>) => boolean;
+declare const isHostOf: (url: string | URL, hosts: string | ReadonlyArray<string>) => boolean;
+declare const isSubdomainOf: (url: string | URL, domains: string | ReadonlyArray<string>) => boolean;
 //#endregion
 export { getPathSegments, isHostOf, isSubdomainOf, parseUrl };

package/dist/urls.js

@@ -12,12 +12,12 @@ const getPathSegments = (value) => {
 const isHostOf = (url, hosts) => {
 	const hostname = parseUrl(url)?.hostname;
 	if (!hostname) return false;
-	return isAnyOf(hostname, Array.isArray(hosts) ? hosts : [hosts]);
+	return isAnyOf(hostname, typeof hosts === "string" ? [hosts] : hosts);
 };
 const isSubdomainOf = (url, domains) => {
 	const hostname = parseUrl(url)?.hostname;
 	if (!hostname) return false;
-	return endsWithAnyOf(hostname, (Array.isArray(domains) ? domains : [domains]).map((domain) => `.${domain}`));
+	return endsWithAnyOf(hostname, (typeof domains === "string" ? [domains] : domains).map((domain) => `.${domain}`));
 };
 //#endregion
 export { getPathSegments, isHostOf, isSubdomainOf, parseUrl };

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.1"
+  "version": "1.1.1"
 }