@khgtrn/lib 1.0.2 → 1.0.3

package/README.md

@@ -61,9 +61,12 @@ Without an explicit `O`, it defaults to `any`.
 | --- | --- |
 | `isEmpty(value)` | Checks whether a value is empty (string, `0`, `false`, null/undefined, empty array/object) |
 | `isNumber(value)` | Type-guard: a valid finite number (not NaN/Infinity) |
+| `nullish(value, defaultValue)` | Returns `value` unless it's `null`/`undefined`, in which case returns `defaultValue` — a `??`-equivalent for pre-3.7 TypeScript |
+| `jsonParse(s, defaultValue?)` | `JSON.parse` with a fallback value instead of throwing on invalid input |
 | `vi2en(s)` | Strips Vietnamese diacritics (`"Điều chỉnh"` -> `"Dieu chinh"`) |
 | `crlf2lf(value)` | Normalizes `\r\n` -> `\n` |
 | `removeNewline(value)` | Removes all newlines, trims surrounding whitespace |
+| `padStart(str, targetLength, padChar?)` / `padEnd(str, targetLength, padChar?)` | Pads a string to a target length by adding characters to the left/right (defaults to `"0"`) |
 | `shuffleArray(array)` | Shuffles an array in place (Fisher-Yates) |
 | `objectValueToArray(obj)` | Collects an object's values into an array |
 | `groupBy(list, fn)` | Groups items by a computed key |

package/dist/cjs/func.d.ts

@@ -19,6 +19,21 @@ export declare function isEmpty(value: any): boolean;
  * @returns Type-guard: `true` if `value` is a finite number.
  */
 export declare function isNumber(value: any): value is number;
+/**
+ * Nếu giá trị của `value` không phải là null hoặc undefined thì lấy, ngược lại trả về `defaultValue`.
+ * @note Sử dụng thay cho cú pháp `??`. Nếu TS3.7 trở lên thì không cần dùng.
+ * @param value Giá trị cần kiểm tra
+ * @param defaultValue Giá trị mặc định trả về nếu `value` là null hoặc undefined
+ * @global
+ */
+export declare function nullish(value: any, defaultValue: any): any;
+/**
+ * JSON.parse với giá trị mặc định nếu có lỗi
+ * @param s giá trị JSON cần parse
+ * @param defaultValue giá trị mặc định trả về nếu có lỗi khi parse. Mặc định là null
+ * @returns any
+ */
+export declare function jsonParse<T = any>(s: string, defaultValue?: T | any): T | null;
 /**
  * Converts Vietnamese diacritics to their plain ASCII equivalents
  * (e.g. `"Điều chỉnh"` -> `"Dieu chinh"`).
@@ -40,6 +55,24 @@ export declare function crlf2lf(value: string): string;
  * @returns The string with all newlines removed.
  */
 export declare function removeNewline(value: string): string;
+/**
+ * Thêm ký tự vào đầu chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào đầu chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào đầu nếu cần thiết
+ * @global
+ */
+export declare function padStart(str: string, targetLength: number, padChar?: string): string;
+/**
+ * Thêm ký tự vào cuối chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào cuối chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào cuối nếu cần thiết
+ * @global
+ */
+export declare function padEnd(str: string, targetLength: number, padChar?: string): string;
 /**
  * Shuffles an array in place using the Fisher-Yates algorithm.
  * @param array - Array to shuffle (mutated directly).

package/dist/cjs/func.js

@@ -2,9 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isEmpty = isEmpty;
 exports.isNumber = isNumber;
+exports.nullish = nullish;
+exports.jsonParse = jsonParse;
 exports.vi2en = vi2en;
 exports.crlf2lf = crlf2lf;
 exports.removeNewline = removeNewline;
+exports.padStart = padStart;
+exports.padEnd = padEnd;
 exports.shuffleArray = shuffleArray;
 exports.objectValueToArray = objectValueToArray;
 exports.groupBy = groupBy;
@@ -68,6 +72,30 @@ function isEmpty(value) {
 function isNumber(value) {
     return typeof value === "number" && Number.isFinite(value);
 }
+/**
+ * Nếu giá trị của `value` không phải là null hoặc undefined thì lấy, ngược lại trả về `defaultValue`.
+ * @note Sử dụng thay cho cú pháp `??`. Nếu TS3.7 trở lên thì không cần dùng.
+ * @param value Giá trị cần kiểm tra
+ * @param defaultValue Giá trị mặc định trả về nếu `value` là null hoặc undefined
+ * @global
+ */
+function nullish(value, defaultValue) {
+    return value !== null && value !== undefined ? value : defaultValue;
+}
+/**
+ * JSON.parse với giá trị mặc định nếu có lỗi
+ * @param s giá trị JSON cần parse
+ * @param defaultValue giá trị mặc định trả về nếu có lỗi khi parse. Mặc định là null
+ * @returns any
+ */
+function jsonParse(s, defaultValue = null) {
+    try {
+        return JSON.parse(s);
+    }
+    catch (e) {
+        return defaultValue;
+    }
+}
 /**
  * Converts Vietnamese diacritics to their plain ASCII equivalents
  * (e.g. `"Điều chỉnh"` -> `"Dieu chinh"`).
@@ -102,6 +130,40 @@ function crlf2lf(value) {
 function removeNewline(value) {
     return crlf2lf(value).trim().replace(/\n/g, "");
 }
+/**
+ * Thêm ký tự vào đầu chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào đầu chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào đầu nếu cần thiết
+ * @global
+ */
+function padStart(str, targetLength, padChar = "0") {
+    str = String(str);
+    if (str.length >= targetLength || !padChar)
+        return str;
+    const padding = padChar
+        .repeat(Math.ceil((targetLength - str.length) / padChar.length))
+        .substring(0, targetLength - str.length);
+    return padding + str;
+}
+/**
+ * Thêm ký tự vào cuối chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào cuối chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào cuối nếu cần thiết
+ * @global
+ */
+function padEnd(str, targetLength, padChar = "0") {
+    str = String(str);
+    if (str.length >= targetLength || !padChar)
+        return str;
+    const padding = padChar
+        .repeat(Math.ceil((targetLength - str.length) / padChar.length))
+        .substring(0, targetLength - str.length);
+    return str + padding;
+}
 /**
  * Shuffles an array in place using the Fisher-Yates algorithm.
  * @param array - Array to shuffle (mutated directly).
@@ -121,10 +183,9 @@ function shuffleArray(array) {
  * @returns Array of the object's values.
  */
 function objectValueToArray(obj) {
-    var arr = [];
-    for (var i in obj)
-        arr.push(obj[i]);
-    return arr;
+    if (obj === null || obj === undefined)
+        return [];
+    return Object.keys(obj).map((key) => obj[key]);
 }
 /**
  * Groups list items by the key returned from `fn`, similar to Lodash's
@@ -161,15 +222,18 @@ function removeByKey(objectOrArray, keys) {
         return objectOrArray.map((item) => typeof item === "object" && item !== null ? removeByKey(item, keys) : item);
     }
     if (typeof objectOrArray === "object" && objectOrArray !== null) {
-        const entries = Object.entries(objectOrArray)
-            .filter(([key]) => !keys.includes(key))
-            .map(([key, value]) => {
-            if (Array.isArray(value) || (typeof value === "object" && value !== null)) {
-                return [key, removeByKey(value, keys)];
-            }
-            return [key, value];
+        const source = objectOrArray;
+        const result = {};
+        Object.keys(source).forEach((key) => {
+            if (keys.includes(key))
+                return;
+            const value = source[key];
+            result[key] =
+                Array.isArray(value) || (typeof value === "object" && value !== null)
+                    ? removeByKey(value, keys)
+                    : value;
         });
-        return Object.fromEntries(entries);
+        return result;
     }
     // Primitives are returned as-is
     return objectOrArray;
@@ -204,22 +268,18 @@ function removeEmptyValue(objectOrArray, options = {}) {
         return result;
     }
     if (typeof objectOrArray === "object" && objectOrArray !== null) {
-        const entries = Object.entries(objectOrArray)
-            .map(([key, value]) => {
-            if (Array.isArray(value) || (typeof value === "object" && value !== null)) {
-                return [
-                    key,
-                    removeEmptyValue(value, {
-                        removeNull,
-                        removeUndefined,
-                        removeEmptyString,
-                    }),
-                ];
+        const source = objectOrArray;
+        const result = {};
+        Object.keys(source).forEach((key) => {
+            const rawValue = source[key];
+            const value = Array.isArray(rawValue) || (typeof rawValue === "object" && rawValue !== null)
+                ? removeEmptyValue(rawValue, { removeNull, removeUndefined, removeEmptyString })
+                : rawValue;
+            if (!shouldRemove(value)) {
+                result[key] = value;
             }
-            return [key, value];
-        })
-            .filter(([, value]) => !shouldRemove(value));
-        return Object.fromEntries(entries);
+        });
+        return result;
     }
     return objectOrArray;
 }

package/dist/esm/func.d.ts

@@ -19,6 +19,21 @@ export declare function isEmpty(value: any): boolean;
  * @returns Type-guard: `true` if `value` is a finite number.
  */
 export declare function isNumber(value: any): value is number;
+/**
+ * Nếu giá trị của `value` không phải là null hoặc undefined thì lấy, ngược lại trả về `defaultValue`.
+ * @note Sử dụng thay cho cú pháp `??`. Nếu TS3.7 trở lên thì không cần dùng.
+ * @param value Giá trị cần kiểm tra
+ * @param defaultValue Giá trị mặc định trả về nếu `value` là null hoặc undefined
+ * @global
+ */
+export declare function nullish(value: any, defaultValue: any): any;
+/**
+ * JSON.parse với giá trị mặc định nếu có lỗi
+ * @param s giá trị JSON cần parse
+ * @param defaultValue giá trị mặc định trả về nếu có lỗi khi parse. Mặc định là null
+ * @returns any
+ */
+export declare function jsonParse<T = any>(s: string, defaultValue?: T | any): T | null;
 /**
  * Converts Vietnamese diacritics to their plain ASCII equivalents
  * (e.g. `"Điều chỉnh"` -> `"Dieu chinh"`).
@@ -40,6 +55,24 @@ export declare function crlf2lf(value: string): string;
  * @returns The string with all newlines removed.
  */
 export declare function removeNewline(value: string): string;
+/**
+ * Thêm ký tự vào đầu chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào đầu chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào đầu nếu cần thiết
+ * @global
+ */
+export declare function padStart(str: string, targetLength: number, padChar?: string): string;
+/**
+ * Thêm ký tự vào cuối chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào cuối chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào cuối nếu cần thiết
+ * @global
+ */
+export declare function padEnd(str: string, targetLength: number, padChar?: string): string;
 /**
  * Shuffles an array in place using the Fisher-Yates algorithm.
  * @param array - Array to shuffle (mutated directly).

package/dist/esm/func.js

@@ -41,6 +41,30 @@ export function isEmpty(value) {
 export function isNumber(value) {
     return typeof value === "number" && Number.isFinite(value);
 }
+/**
+ * Nếu giá trị của `value` không phải là null hoặc undefined thì lấy, ngược lại trả về `defaultValue`.
+ * @note Sử dụng thay cho cú pháp `??`. Nếu TS3.7 trở lên thì không cần dùng.
+ * @param value Giá trị cần kiểm tra
+ * @param defaultValue Giá trị mặc định trả về nếu `value` là null hoặc undefined
+ * @global
+ */
+export function nullish(value, defaultValue) {
+    return value !== null && value !== undefined ? value : defaultValue;
+}
+/**
+ * JSON.parse với giá trị mặc định nếu có lỗi
+ * @param s giá trị JSON cần parse
+ * @param defaultValue giá trị mặc định trả về nếu có lỗi khi parse. Mặc định là null
+ * @returns any
+ */
+export function jsonParse(s, defaultValue = null) {
+    try {
+        return JSON.parse(s);
+    }
+    catch (e) {
+        return defaultValue;
+    }
+}
 /**
  * Converts Vietnamese diacritics to their plain ASCII equivalents
  * (e.g. `"Điều chỉnh"` -> `"Dieu chinh"`).
@@ -75,6 +99,40 @@ export function crlf2lf(value) {
 export function removeNewline(value) {
     return crlf2lf(value).trim().replace(/\n/g, "");
 }
+/**
+ * Thêm ký tự vào đầu chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào đầu chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào đầu nếu cần thiết
+ * @global
+ */
+export function padStart(str, targetLength, padChar = "0") {
+    str = String(str);
+    if (str.length >= targetLength || !padChar)
+        return str;
+    const padding = padChar
+        .repeat(Math.ceil((targetLength - str.length) / padChar.length))
+        .substring(0, targetLength - str.length);
+    return padding + str;
+}
+/**
+ * Thêm ký tự vào cuối chuỗi cho đến khi đạt được độ dài mục tiêu
+ * @param str Chuỗi gốc
+ * @param targetLength Độ dài mục tiêu sau khi thêm ký tự
+ * @param padChar Ký tự dùng để thêm vào cuối chuỗi (mặc định là "0")
+ * @returns Chuỗi đã được thêm ký tự vào cuối nếu cần thiết
+ * @global
+ */
+export function padEnd(str, targetLength, padChar = "0") {
+    str = String(str);
+    if (str.length >= targetLength || !padChar)
+        return str;
+    const padding = padChar
+        .repeat(Math.ceil((targetLength - str.length) / padChar.length))
+        .substring(0, targetLength - str.length);
+    return str + padding;
+}
 /**
  * Shuffles an array in place using the Fisher-Yates algorithm.
  * @param array - Array to shuffle (mutated directly).
@@ -94,10 +152,9 @@ export function shuffleArray(array) {
  * @returns Array of the object's values.
  */
 export function objectValueToArray(obj) {
-    var arr = [];
-    for (var i in obj)
-        arr.push(obj[i]);
-    return arr;
+    if (obj === null || obj === undefined)
+        return [];
+    return Object.keys(obj).map((key) => obj[key]);
 }
 /**
  * Groups list items by the key returned from `fn`, similar to Lodash's
@@ -134,15 +191,18 @@ export function removeByKey(objectOrArray, keys) {
         return objectOrArray.map((item) => typeof item === "object" && item !== null ? removeByKey(item, keys) : item);
     }
     if (typeof objectOrArray === "object" && objectOrArray !== null) {
-        const entries = Object.entries(objectOrArray)
-            .filter(([key]) => !keys.includes(key))
-            .map(([key, value]) => {
-            if (Array.isArray(value) || (typeof value === "object" && value !== null)) {
-                return [key, removeByKey(value, keys)];
-            }
-            return [key, value];
+        const source = objectOrArray;
+        const result = {};
+        Object.keys(source).forEach((key) => {
+            if (keys.includes(key))
+                return;
+            const value = source[key];
+            result[key] =
+                Array.isArray(value) || (typeof value === "object" && value !== null)
+                    ? removeByKey(value, keys)
+                    : value;
         });
-        return Object.fromEntries(entries);
+        return result;
     }
     // Primitives are returned as-is
     return objectOrArray;
@@ -177,22 +237,18 @@ export function removeEmptyValue(objectOrArray, options = {}) {
         return result;
     }
     if (typeof objectOrArray === "object" && objectOrArray !== null) {
-        const entries = Object.entries(objectOrArray)
-            .map(([key, value]) => {
-            if (Array.isArray(value) || (typeof value === "object" && value !== null)) {
-                return [
-                    key,
-                    removeEmptyValue(value, {
-                        removeNull,
-                        removeUndefined,
-                        removeEmptyString,
-                    }),
-                ];
+        const source = objectOrArray;
+        const result = {};
+        Object.keys(source).forEach((key) => {
+            const rawValue = source[key];
+            const value = Array.isArray(rawValue) || (typeof rawValue === "object" && rawValue !== null)
+                ? removeEmptyValue(rawValue, { removeNull, removeUndefined, removeEmptyString })
+                : rawValue;
+            if (!shouldRemove(value)) {
+                result[key] = value;
             }
-            return [key, value];
-        })
-            .filter(([, value]) => !shouldRemove(value));
-        return Object.fromEntries(entries);
+        });
+        return result;
     }
     return objectOrArray;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khgtrn/lib",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Library for Typescript",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",