@hichchi/utils 0.0.1-alpha.0

package/src/lib/string.utils.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Break a string into words array.<br>
+ *
+ * This function will break any of below to words in examples into `['hello', 'world']`<br>
+ *
+ * @param {string} str String to break into words.
+ * @returns {string[]} Array of words.
+ *
+ * @example
+ * ```TypeScript
+ * breakToWords("helloWorld"); // ['hello', 'world']
+ * ```
+ *
+ * @example
+ * ```TypeScript
+ * breakToWords("hello_world"); // ['hello', 'world']
+ * ```
+ *
+ * @example
+ * ```TypeScript
+ * breakToWords("hello-world"); // ['hello', 'world']
+ * ```
+ *
+ * @example
+ * ```TypeScript
+ * breakToWords("hello world"); // ['hello', 'world']
+ * ```
+ */
+export declare function breakToWords(str: string): string[];
+/**
+ * Break a string into words array and format the string.<br>
+ *
+ * This function will break string into words and format the string using the provided function.<br>
+ *
+ * @param {string} str String to break into words.
+ * @param {() => string} format Formatting function.
+ * @returns {string} Formatted string.
+ *
+ * @example
+ * ```TypeScript
+ * breakToWords("helloWorld" , toFirstCase); // Hello world
+ * ```
+ */
+export declare function breakToWords(str: string, format: (str: string) => string): string;
+/**
+ * Convert a string to lower case.
+ * @param {string} [str] String to convert to lower case.
+ * @returns {string} String in lower case.
+ *
+ * @example
+ * ```TypeScript
+ * toLowerCase("Hello World"); // "hello world"
+ * ```
+ */
+export declare function toLowerCase(str?: string): string;
+/**
+ * Convert a string to lower cases and break into words with optional join or space.
+ * @param {string} [str] String to convert to lower cases and break into words.
+ * @param {string} [join] Optional string to join the words with.
+ * @returns {string} String in lower cases and broken into words.
+ *
+ * @example
+ * ```TypeScript
+ * toLowerCaseBreak("HelloWorld"); // "hello world"
+ * ```
+ */
+export declare function toLowerCaseBreak(str?: string, join?: string): string;
+/**
+ * Convert a string to upper case.
+ * @param {string} [str] String to convert to upper case.
+ * @returns {string} String in upper case.
+ *
+ * @example
+ * ```TypeScript
+ * toUpperCase("HelloWorld"); // "HELLO WORLD"
+ * ```
+ */
+export declare function toUpperCase(str?: string): string;
+/**
+ * Convert a string to upper cases and break into words with optional join or space.
+ * @param {string} [str] String to convert to upper cases and break into words.
+ * @param {string} [join] Optional string to join the words with.
+ * @returns {string} String in upper cases and broken into words.
+ *
+ * @example
+ * ```TypeScript
+ * toUpperCaseBreak("HelloWorld"); // "HELLO WORLD"
+ * ```
+ *
+ * @example
+ * ```TypeScript
+ * toUpperCaseBreak("HelloWorld", "! "); // "HELLO! WORLD"
+ */
+export declare function toUpperCaseBreak(str?: string, join?: string): string;
+/**
+ * Convert a string to first case (Capitalize first letter of the string).
+ * @param {string} [str] Optional string to join the words with.
+ * @returns {string} String in first case.
+ *
+ * @example
+ * ```TypeScript
+ * toFirstCase("hello world"); // "Hello world"
+ * ```
+ */
+export declare function toFirstCase(str?: string): string;
+export declare function toFirstCaseBreak(str?: string, join?: string): string;
+/**
+ * Convert a string to title case (Capitalize first letter of each word).
+ * @param {string} [str] String to convert to title case.
+ * @returns {string} String in title case.
+ *
+ * @example
+ * ```TypeScript
+ * toTitleCase("hello world"); // "Hello World"
+ * ```
+ */
+export declare function toTitleCase(str?: string): string;
+/**
+ * Convert a string to camel case.
+ * @param {string} [str] String to convert to camel case.
+ * @returns {string} String in camel case.
+ *
+ * @example
+ * ```TypeScript
+ * toCamelCase("hello world"); // "helloWorld"
+ * ```
+ */
+export declare function toCamelCase(str?: string): string;
+/**
+ * Convert a string to pascal case.
+ * @param {string} [str] String to convert to pascal case.
+ * @returns {string} String in pascal case.
+ *
+ * @example
+ * ```TypeScript
+ * toPascalCase("hello world"); // "HelloWorld"
+ * ```
+ */
+export declare function toPascalCase(str?: string): string;
+/**
+ * Convert a string to sentence case. (Capitalize first letter of every sentence).
+ * @param {string} [str] String to convert to sentence case.
+ * @returns {string} String in sentence case.
+ *
+ * @example
+ * ```TypeScript
+ * toSentenceCase("hello world. how are you?"); // "Hello world. How are you?"
+ * ```
+ */
+export declare function toSentenceCase(str: string): string;
+/**
+ * Convert a string to snake case.
+ * @param {string} [str] String to convert to snake case.
+ * @param {boolean} [caps] Whether to convert to upper case.
+ * @returns {string} String in snake case.
+ *
+ * @example
+ * ```TypeScript
+ * toSnakeCase("hello world"); // "hello_world"
+ *```
+ *
+ * @example
+ * ```TypeScript
+ * toSnakeCase("hello world", true); // "HELLO_WORLD"
+ * ```
+ */
+export declare function toSnakeCase(str?: string, caps?: boolean): string;
+/**
+ * Convert a string to kebab case.
+ * @param {string} [str] String to convert to kebab case.
+ * @param {boolean} [caps] Whether to convert to upper case.
+ * @returns {string} String in kebab case.
+ *
+ * @example
+ * ```TypeScript
+ * toKebabCase("hello world"); // "hello-world"
+ * ```
+ *
+ * @example
+ * ```TypeScript
+ * toKebabCase("hello world", true); // "HELLO-WORLD"
+ * ```
+ */
+export declare function toKebabCase(str?: string, caps?: boolean): string;
+/**
+ * Converts a string to a number.
+ * @param {number|string} str String to convert to a number.
+ * @returns {number|undefined} Number or undefined.
+ *
+ * @example
+ * ```TypeScript
+ * toNumber("123"); // 123
+ * ```
+ */
+export declare function toNumber(str: number | string): number | undefined;
+/**
+ * Remove HTML tags from a string and return plain text.
+ * @param {string} str String to remove HTML tags from.
+ * @returns {string} Plain text.
+ *
+ * @example
+ * ```TypeScript
+ * htmlToText("<h1>Hello World</h1>"); // "Hello World"
+ * ```
+ */
+export declare function htmlToText(str: string): string;
+/**
+ * Handles converting plural words to their singular form.
+ * @param {string} str String to convert to singular.
+ * @returns {string} Singular form of the string.
+ *
+ * @example
+ * ```TypeScript
+ * singular("children"); // "child"
+ * ```
+ */
+export declare function singular(str: string): string;

package/src/lib/string.utils.js

@@ -0,0 +1,314 @@
+"use strict";
+// noinspection JSUnusedGlobalSymbols
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.breakToWords = breakToWords;
+exports.toLowerCase = toLowerCase;
+exports.toLowerCaseBreak = toLowerCaseBreak;
+exports.toUpperCase = toUpperCase;
+exports.toUpperCaseBreak = toUpperCaseBreak;
+exports.toFirstCase = toFirstCase;
+exports.toFirstCaseBreak = toFirstCaseBreak;
+exports.toTitleCase = toTitleCase;
+exports.toCamelCase = toCamelCase;
+exports.toPascalCase = toPascalCase;
+exports.toSentenceCase = toSentenceCase;
+exports.toSnakeCase = toSnakeCase;
+exports.toKebabCase = toKebabCase;
+exports.toNumber = toNumber;
+exports.htmlToText = htmlToText;
+exports.singular = singular;
+function breakToWords(str, format) {
+    var _a, _b;
+    if (!str) {
+        return format ? "" : [];
+    }
+    try {
+        const words = (_b = (_a = str
+            .match(/[A-Z]{2,}(?=[A-Z][a-z]+\d*|\b)|[A-Z]?[a-z]+\d*|[A-Z]+|\d+/g)) === null || _a === void 0 ? void 0 : _a.map((s) => s.toLowerCase())) !== null && _b !== void 0 ? _b : [];
+        return format ? words.map(format).join(" ") : words;
+    }
+    catch (_c) {
+        return format ? "" : [];
+    }
+}
+/**
+ * Convert a string to lower case.
+ * @param {string} [str] String to convert to lower case.
+ * @returns {string} String in lower case.
+ *
+ * @example
+ * ```TypeScript
+ * toLowerCase("Hello World"); // "hello world"
+ * ```
+ */
+function toLowerCase(str) {
+    if (!str) {
+        return "";
+    }
+    return str.toLowerCase();
+}
+/**
+ * Convert a string to lower cases and break into words with optional join or space.
+ * @param {string} [str] String to convert to lower cases and break into words.
+ * @param {string} [join] Optional string to join the words with.
+ * @returns {string} String in lower cases and broken into words.
+ *
+ * @example
+ * ```TypeScript
+ * toLowerCaseBreak("HelloWorld"); // "hello world"
+ * ```
+ */
+function toLowerCaseBreak(str, join) {
+    if (!str) {
+        return "";
+    }
+    return breakToWords(str)
+        .map(s => s.toLowerCase())
+        .join(join !== null && join !== void 0 ? join : " ");
+}
+/**
+ * Convert a string to upper case.
+ * @param {string} [str] String to convert to upper case.
+ * @returns {string} String in upper case.
+ *
+ * @example
+ * ```TypeScript
+ * toUpperCase("HelloWorld"); // "HELLO WORLD"
+ * ```
+ */
+function toUpperCase(str) {
+    if (!str) {
+        return "";
+    }
+    return str.toUpperCase();
+}
+/**
+ * Convert a string to upper cases and break into words with optional join or space.
+ * @param {string} [str] String to convert to upper cases and break into words.
+ * @param {string} [join] Optional string to join the words with.
+ * @returns {string} String in upper cases and broken into words.
+ *
+ * @example
+ * ```TypeScript
+ * toUpperCaseBreak("HelloWorld"); // "HELLO WORLD"
+ * ```
+ *
+ * @example
+ * ```TypeScript
+ * toUpperCaseBreak("HelloWorld", "! "); // "HELLO! WORLD"
+ */
+function toUpperCaseBreak(str, join) {
+    if (!str) {
+        return "";
+    }
+    return breakToWords(str)
+        .map(s => s.toUpperCase())
+        .join(join !== null && join !== void 0 ? join : " ");
+}
+/**
+ * Convert a string to first case (Capitalize first letter of the string).
+ * @param {string} [str] Optional string to join the words with.
+ * @returns {string} String in first case.
+ *
+ * @example
+ * ```TypeScript
+ * toFirstCase("hello world"); // "Hello world"
+ * ```
+ */
+function toFirstCase(str) {
+    var _a;
+    if (!str) {
+        return "";
+    }
+    return (((_a = str[0]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || "") + str.slice(1).toLowerCase();
+}
+function toFirstCaseBreak(str, join) {
+    if (!str) {
+        return "";
+    }
+    return breakToWords(str)
+        .map((s, i) => (i === 0 ? toFirstCase(s) : s.toLowerCase()))
+        .join(join !== null && join !== void 0 ? join : " ");
+}
+/**
+ * Convert a string to title case (Capitalize first letter of each word).
+ * @param {string} [str] String to convert to title case.
+ * @returns {string} String in title case.
+ *
+ * @example
+ * ```TypeScript
+ * toTitleCase("hello world"); // "Hello World"
+ * ```
+ */
+function toTitleCase(str) {
+    if (!str) {
+        return "";
+    }
+    return breakToWords(str)
+        .map(s => toFirstCase(s))
+        .join(" ");
+}
+/**
+ * Convert a string to camel case.
+ * @param {string} [str] String to convert to camel case.
+ * @returns {string} String in camel case.
+ *
+ * @example
+ * ```TypeScript
+ * toCamelCase("hello world"); // "helloWorld"
+ * ```
+ */
+function toCamelCase(str) {
+    if (!str) {
+        return "";
+    }
+    return breakToWords(str)
+        .map((s, i) => (i === 0 ? s.toLowerCase() : toFirstCase(s)))
+        .join("");
+}
+/**
+ * Convert a string to pascal case.
+ * @param {string} [str] String to convert to pascal case.
+ * @returns {string} String in pascal case.
+ *
+ * @example
+ * ```TypeScript
+ * toPascalCase("hello world"); // "HelloWorld"
+ * ```
+ */
+function toPascalCase(str) {
+    if (!str) {
+        return "";
+    }
+    return breakToWords(str)
+        .map(s => toFirstCase(s))
+        .join("");
+}
+/**
+ * Convert a string to sentence case. (Capitalize first letter of every sentence).
+ * @param {string} [str] String to convert to sentence case.
+ * @returns {string} String in sentence case.
+ *
+ * @example
+ * ```TypeScript
+ * toSentenceCase("hello world. how are you?"); // "Hello world. How are you?"
+ * ```
+ */
+function toSentenceCase(str) {
+    return str
+        .split(".")
+        .map(s => toFirstCase(s.trim()))
+        .join(". ");
+}
+/**
+ * Convert a string to snake case.
+ * @param {string} [str] String to convert to snake case.
+ * @param {boolean} [caps] Whether to convert to upper case.
+ * @returns {string} String in snake case.
+ *
+ * @example
+ * ```TypeScript
+ * toSnakeCase("hello world"); // "hello_world"
+ *```
+ *
+ * @example
+ * ```TypeScript
+ * toSnakeCase("hello world", true); // "HELLO_WORLD"
+ * ```
+ */
+function toSnakeCase(str, caps) {
+    if (!str) {
+        return "";
+    }
+    const snake = breakToWords(str).join("_");
+    return caps ? snake.toUpperCase() : snake.toLowerCase();
+}
+/**
+ * Convert a string to kebab case.
+ * @param {string} [str] String to convert to kebab case.
+ * @param {boolean} [caps] Whether to convert to upper case.
+ * @returns {string} String in kebab case.
+ *
+ * @example
+ * ```TypeScript
+ * toKebabCase("hello world"); // "hello-world"
+ * ```
+ *
+ * @example
+ * ```TypeScript
+ * toKebabCase("hello world", true); // "HELLO-WORLD"
+ * ```
+ */
+function toKebabCase(str, caps) {
+    if (!str) {
+        return "";
+    }
+    const kebab = breakToWords(str).join("-");
+    return caps ? kebab.toUpperCase() : kebab.toLowerCase();
+}
+/**
+ * Converts a string to a number.
+ * @param {number|string} str String to convert to a number.
+ * @returns {number|undefined} Number or undefined.
+ *
+ * @example
+ * ```TypeScript
+ * toNumber("123"); // 123
+ * ```
+ */
+function toNumber(str) {
+    return !isNaN(Number(str)) ? Number(str) : undefined;
+}
+/**
+ * Remove HTML tags from a string and return plain text.
+ * @param {string} str String to remove HTML tags from.
+ * @returns {string} Plain text.
+ *
+ * @example
+ * ```TypeScript
+ * htmlToText("<h1>Hello World</h1>"); // "Hello World"
+ * ```
+ */
+function htmlToText(str) {
+    return str.replace(/<[^>]*>?/gm, "");
+}
+/**
+ * Handles converting plural words to their singular form.
+ * @param {string} str String to convert to singular.
+ * @returns {string} Singular form of the string.
+ *
+ * @example
+ * ```TypeScript
+ * singular("children"); // "child"
+ * ```
+ */
+function singular(str) {
+    if (!str)
+        return str;
+    // General rules and exceptions for singularizing
+    const rules = [
+        { regex: /children$/i, replacement: "child" }, // e.g., children -> child
+        { regex: /men$/i, replacement: "man" }, // e.g., men -> man
+        { regex: /women$/i, replacement: "woman" }, // e.g., women -> woman
+        { regex: /teeth$/i, replacement: "tooth" }, // e.g., teeth -> tooth
+        { regex: /feet$/i, replacement: "foot" }, // e.g., feet -> foot
+        // eslint-disable-next-line @typescript-eslint/no-magic-numbers
+        { regex: /(buses|dishes|matches)$/i, replacement: (match) => match.slice(0, -2) }, // e.g., buses -> bus
+        { regex: /oes$/i, replacement: "o" }, // e.g., potatoes -> potato
+        { regex: /ies$/i, replacement: "y" }, // e.g., parties -> party
+        { regex: /ves$/i, replacement: "f" }, // e.g., wolves -> wolf
+        { regex: /cacti$/i, replacement: "cactus" }, // e.g., cacti -> cactus
+        { regex: /data$/i, replacement: "datum" }, // e.g., data -> datum
+        { regex: /phenomena$/i, replacement: "phenomenon" }, // e.g., phenomena -> phenomenon
+        { regex: /s$/i, replacement: "" }, // e.g., cats -> cat
+    ];
+    // Iterate over rules and apply the first matching one
+    for (const rule of rules) {
+        if (rule.regex.test(str)) {
+            return str.replace(rule.regex, typeof rule.replacement === "string" ? rule.replacement : rule.replacement(str));
+        }
+    }
+    // Return the original string if no rules match
+    return str;
+}
+//# sourceMappingURL=string.utils.js.map

package/src/lib/string.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.js","sourceRoot":"","sources":["../../../../../libs/utils/src/lib/string.utils.ts"],"names":[],"mappings":"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"}

package/src/lib/types.d.ts

@@ -0,0 +1,20 @@
+export type LiteralObject<T = any> = {
+    [key: string]: T;
+};
+export type PartialWithNull<T> = {
+    [p in keyof T]?: T[p] | null;
+};
+/**
+ * Represents a type for autocompleting string values.
+ *
+ * The `LooseAutocomplete` type allows autocompletion for a set of predefined string literals
+ * while still permitting other string values that are not part of the predefined set.
+ *
+ * This is useful in cases where a set of recommended values is available,
+ * but the user is also given the flexibility to provide custom input as needed.
+ *
+ * @template T Extends string - The set of predefined literal string options for autocompletion.
+ *
+ * @author Matt Pocock (https://www.totaltypescript.com/tips/create-autocomplete-helper-which-allows-for-arbitrary-values)
+ */
+export type LooseAutocomplete<T extends string> = T | Omit<string, T>;

package/src/lib/types.js

@@ -0,0 +1,4 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/src/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../libs/utils/src/lib/types.ts"],"names":[],"mappings":";AAAA,uDAAuD"}

package/src/lib/utils.d.ts

@@ -0,0 +1,7 @@
+export * from "./interfaces";
+export * from "./types";
+export * from "./string.utils";
+export * from "./string-template.utils";
+export * from "./object.utils";
+export * from "./file.utils";
+export * from "./assertions.utils";

package/src/lib/utils.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./interfaces"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./string.utils"), exports);
+tslib_1.__exportStar(require("./string-template.utils"), exports);
+tslib_1.__exportStar(require("./object.utils"), exports);
+tslib_1.__exportStar(require("./file.utils"), exports);
+tslib_1.__exportStar(require("./assertions.utils"), exports);
+//# sourceMappingURL=utils.js.map

package/src/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../libs/utils/src/lib/utils.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,kDAAwB;AACxB,yDAA+B;AAC/B,kEAAwC;AACxC,yDAA+B;AAC/B,uDAA6B;AAC7B,6DAAmC"}