npm - @titocandradev/neatcore - Versions diffs - 0.3.3 → 0.4.1 - Mend

@titocandradev/neatcore 0.3.3 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -145,4 +145,4 @@ NeatCore is designed as a strongly-typed engineering utility foundation
 Read full API Design Guideline here:
-👉 https://github.com/tcandra24/neat-core/blob/main/docs/API_DESIGN_GUIDELINE.md
+👉 https://tcandra24.github.io/neat-core/

package/dist/index.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-'use strict';function u(e,t){if(t<=0)return [];let r=[];for(let n=0;n<e.length;n+=t)r.push(e.slice(n,n+t));return r}function c(e){return [...new Set(e)]}function p(e,t){let r=new Set;return e.filter(n=>{let o=n[t];return r.has(o)?false:(r.add(o),true)})}function f(e,t){return e.reduce((r,n)=>{let o=String(n[t]);return r[o]||(r[o]=[]),r[o].push(n),r},{})}function y(e,t){let r;return function(...n){clearTimeout(r),r=setTimeout(()=>{e(...n);},t);}}async function m(e){try{return [null,typeof e=="function"?await e():await e]}catch(t){return [t,null]}}function d(e){return Object.keys(e).length===0}function C(e,t){let r={};for(let n of t)n in e&&(r[n]=e[n]);return r}function k(e,t){let r={...e};for(let n of t)delete r[n];return r}function b(e,t,r){let n=t.split("."),o=e;for(let i of n){if(o==null)return r;o=o[i];}return o===void 0?r:o}function w(e){return e?e.charAt(0).toUpperCase()+e.slice(1):""}function j(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" "):""}function E(e){return e?e.trim().replace(/[^a-zA-Z0-9]+(.)?/g,(t,r)=>r?r.toUpperCase():"").replace(/^(.)/,t=>t.toLowerCase()):""}function S(e){return e?e.trim().replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase():""}function v(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()).join(" "):""}exports.capitalize=w;exports.capitalizeWords=j;exports.chunk=u;exports.debounce=y;exports.get=b;exports.groupBy=f;exports.initialWords=v;exports.isEmptyObject=d;exports.omit=k;exports.pick=C;exports.toCamelCase=E;exports.toKebabCase=S;exports.tryCatch=m;exports.unique=c;exports.uniqueBy=p;//# sourceMappingURL=index.cjs.map
+'use strict';function u(e,t){if(t<=0)return [];let r=[];for(let n=0;n<e.length;n+=t)r.push(e.slice(n,n+t));return r}function a(e){return [...new Set(e)]}function T(e,t){let r=new Set;return e.filter(n=>{let o=n[t];return r.has(o)?false:(r.add(o),true)})}function l(e,t){return e.reduce((r,n)=>{let o=String(n[t]);return r[o]||(r[o]=[]),r[o].push(n),r},{})}function g(e,t){let r=new Set(t);return e.filter(n=>!r.has(n))}function m(e,t){let r=new Set(t);return e.filter(n=>r.has(n))}function C(e,t,r="asc"){return [...e].sort((n,o)=>{let i=t(n),s=t(o);return i<s?r==="asc"?-1:1:i>s?r==="asc"?1:-1:0})}function k(e,t){let r;return function(...n){clearTimeout(r),r=setTimeout(()=>{e(...n);},t);}}async function b(e){try{return [null,typeof e=="function"?await e():await e]}catch(t){return [t,null]}}function w(e){return Object.keys(e).length===0}function R(e,t){let r={};for(let n of t)n in e&&(r[n]=e[n]);return r}function S(e,t){let r={...e};for(let n of t)delete r[n];return r}function z(e,t,r){let n=t.split("."),o=e;for(let i of n){if(o==null)return r;o=o[i];}return o===void 0?r:o}function $(...e){return e.reduce((t,r)=>({...t,...r}),{})}function E(e){return e?e.charAt(0).toUpperCase()+e.slice(1):""}function B(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" "):""}function O(e){return e?e.trim().replace(/[^a-zA-Z0-9]+(.)?/g,(t,r)=>r?r.toUpperCase():"").replace(/^(.)/,t=>t.toLowerCase()):""}function q(e){return e?e.trim().replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase():""}function D(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()).join(" "):""}function N(e,t,r="..."){return e.length<=t?e:e.slice(0,t).trimEnd()+r}function G(e){return e.toLowerCase().trim().normalize("NFD").replace(/[\u0300-\u036f]/g,"").replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")}function J(e){return e?e.trim().replace(/([a-z0-9])([A-Z])/g,"$1_$2").replace(/[_\s]+/g,"_").toLowerCase():""}exports.capitalize=E;exports.capitalizeWords=B;exports.chunk=u;exports.debounce=k;exports.difference=g;exports.get=z;exports.groupBy=l;exports.initialWords=D;exports.intersection=m;exports.isEmptyObject=w;exports.merge=$;exports.omit=S;exports.pick=R;exports.slugify=G;exports.sortBy=C;exports.toCamelCase=O;exports.toKebabCase=q;exports.toSnakeCase=J;exports.truncate=N;exports.tryCatch=b;exports.unique=a;exports.uniqueBy=T;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/array/chunk.ts","../src/array/unique.ts","../src/array/uniqueBy.ts","../src/array/groupBy.ts","../src/function/debounce.ts","../src/function/tryCatch.ts","../src/object/isEmptyObject.ts","../src/object/pick.ts","../src/object/omit.ts","../src/object/get.ts","../src/string/capitalize.ts","../src/string/capitalizeWords.ts","../src/string/toCamelCase.ts","../src/string/toKebabCase.ts","../src/string/initialWords.ts"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","debounce","fn","delay","timeout","args","tryCatch","input","error","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase","initialWords"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\r\n Split an array into smaller arrays (chunks) of a given size.\r\n \r\n Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n * @param size - The size of each chunk. Must be greater than 0.\r\n \r\n @returns A new array containing chunked subarrays.\r\n \r\n @example\r\n * ```ts\r\n * chunk([1, 2, 3, 4, 5], 2);\r\n * // [[1, 2], [3, 4], [5]]\r\n * ```\r\n \r\n @throws If size is less than 1.\r\n /\r\nexport function chunk<T>(arr: T[], size: number): T[][] {\r\n if (size <= 0) return [];\r\n\r\n const result: T[][] = [];\r\n\r\n for (let i = 0; i < arr.length; i += size) {\r\n result.push(arr.slice(i, i + size));\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Remove duplicate values from an array.\r\n \r\n Uses strict equality comparison.\r\n * Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n \r\n @returns A new array with unique values.\r\n \r\n @example\r\n * ```ts\r\n * unique([1, 1, 2, 3]);\r\n * // [1, 2, 3]\r\n * ```\r\n /\r\nexport function unique<T>(array: T[]): T[] {\r\n return [...new Set(array)];\r\n}\r\n","/\r\n Remove duplicate values from an array based on a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to determine uniqueness.\r\n * @returns A new array with unique values based on the specified key.\r\n \r\n @example\r\n * ```ts\r\n * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], \"id\");\r\n * // [{ id: 1 }, { id: 2 }]\r\n * ```\r\n /\r\nexport function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[] {\r\n const seen = new Set<T[K]>();\r\n\r\n return array.filter((item) => {\r\n const value = item[key];\r\n if (seen.has(value)) return false;\r\n seen.add(value);\r\n return true;\r\n });\r\n}\r\n","/\r\n Group array items by a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to group by.\r\n * @returns An object where keys are group identifiers and values are arrays of grouped items.\r\n \r\n @example\r\n * ```ts\r\n * groupBy([{ id: 1, name: \"Alice\" }, { id: 2, name: \"Bob\" }, { id: 1, name: \"Charlie\" }], \"id\");\r\n * // {\r\n * // 1: [{ id: 1, name: \"Alice\" }, { id: 1, name: \"Charlie\" }],\r\n * // 2: [{ id: 2, name: \"Bob\" }]\r\n * // }\r\n * ```\r\n /\r\nexport function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]> {\r\n return array.reduce(\r\n (acc, item) => {\r\n const groupKey = String(item[key]);\r\n\r\n if (!acc[groupKey]) {\r\n acc[groupKey] = [];\r\n }\r\n\r\n acc[groupKey].push(item);\r\n return acc;\r\n },\r\n {} as Record<string, T[]>,\r\n );\r\n}\r\n","/\r\n Debounce a function.\r\n \r\n @param fn - The function to debounce.\r\n * @param delay - The debounce delay in milliseconds.\r\n * @returns A debounced version of the input function.\r\n /\r\nexport function debounce<T extends (...args: any[]) => void>(fn: T, delay: number) {\r\n let timeout: ReturnType<typeof setTimeout>;\r\n\r\n return function (...args: Parameters<T>) {\r\n clearTimeout(timeout);\r\n\r\n timeout = setTimeout(() => {\r\n fn(...args);\r\n }, delay);\r\n };\r\n}\r\n","/\r\n Tries to execute a promise and catches any errors that occur.\r\n \r\n @param promise - The promise to execute.\r\n * @returns A tuple containing either an error or the result.\r\n /\r\nexport async function tryCatch<T>(input: Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: () => Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: Promise<T> \| (() => Promise<T>)): Promise<TryCatchResult<T>> {\r\n try {\r\n const result = typeof input === \"function\" ? await input() : await input;\r\n\r\n return [null, result];\r\n } catch (error) {\r\n return [error as Error, null];\r\n }\r\n}\r\n\r\nexport type TryCatchResult<T> = [Error \| null, T \| null];\r\n","/\r\n Check if an object is empty.\r\n \r\n @param obj - The object to check.\r\n * @returns True if the object is empty, false otherwise.\r\n /\r\nexport function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean {\r\n return Object.keys(obj).length === 0;\r\n}\r\n","/\r\n Create a new object by picking specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to pick.\r\n * @returns A new object with only the picked keys.\r\n /\r\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K> {\r\n const result = {} as Pick<T, K>;\r\n\r\n for (const key of keys) {\r\n if (key in obj) {\r\n result[key] = obj[key];\r\n }\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Create a new object by omitting specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to omit.\r\n * @returns A new object without the omitted keys.\r\n /\r\nexport function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K> {\r\n const result = { ...obj };\r\n\r\n for (const key of keys) {\r\n delete result[key];\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Get a nested property value from an object.\r\n \r\n @param obj - The source object.\r\n * @param path - The dot-separated path to the property.\r\n * @param defaultValue - The default value to return if the property is not found.\r\n * @returns The value of the property or the default value.\r\n /\r\nexport function get(obj: any, path: string, defaultValue?: any) {\r\n const keys = path.split(\".\");\r\n let result = obj;\r\n\r\n for (const key of keys) {\r\n if (result == null) return defaultValue;\r\n result = result[key];\r\n }\r\n\r\n return result === undefined ? defaultValue : result;\r\n}\r\n","/\r\n Capitalize the first letter of a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter capitalized.\r\n /\r\nexport function capitalize(str: string): string {\r\n if (!str) return \"\";\r\n return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter of each word capitalized.\r\n /\r\nexport function capitalizeWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\r\n .join(\" \");\r\n}\r\n","/\r\n Convert a string to camel case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to camel case.\r\n /\r\nexport function toCamelCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/[^a-zA-Z0-9]+(.)?/g, (_, char: string) => (char ? char.toUpperCase() : \"\"))\r\n .replace(/^(.)/, (match) => match.toLowerCase());\r\n}\r\n","/\r\n Convert a string to kebab case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to kebab case.\r\n /\r\nexport function toKebabCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\r\n .replace(/[_\\s]+/g, \"-\")\r\n .toLowerCase();\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the only show first letter of each word capitalized.\r\n */\r\nexport function initialWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase())\r\n .join(\" \");\r\n}\r\n"]}
1	+ {"version":3,"sources":["../src/array/chunk.ts","../src/array/unique.ts","../src/array/uniqueBy.ts","../src/array/groupBy.ts","../src/array/difference.ts","../src/array/intersection.ts","../src/array/sortBy.ts","../src/function/debounce.ts","../src/function/tryCatch.ts","../src/object/isEmptyObject.ts","../src/object/pick.ts","../src/object/omit.ts","../src/object/get.ts","../src/object/merge.ts","../src/string/capitalize.ts","../src/string/capitalizeWords.ts","../src/string/toCamelCase.ts","../src/string/toKebabCase.ts","../src/string/initialWords.ts","../src/string/truncate.ts","../src/string/slugify.ts","../src/string/toSnakeCase.ts"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","difference","values","set","intersection","sortBy","selector","direction","a","b","aValue","bValue","debounce","fn","delay","timeout","args","tryCatch","input","error","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","merge","objects","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase","initialWords","truncate","maxLength","suffix","slugify","toSnakeCase"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\r\n Split an array into smaller arrays (chunks) of a given size.\r\n \r\n Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n * @param size - The size of each chunk. Must be greater than 0.\r\n \r\n @returns A new array containing chunked subarrays.\r\n \r\n @example\r\n * ```ts\r\n * chunk([1, 2, 3, 4, 5], 2);\r\n * // [[1, 2], [3, 4], [5]]\r\n * ```\r\n \r\n @throws If size is less than 1.\r\n /\r\nexport function chunk<T>(arr: T[], size: number): T[][] {\r\n if (size <= 0) return [];\r\n\r\n const result: T[][] = [];\r\n\r\n for (let i = 0; i < arr.length; i += size) {\r\n result.push(arr.slice(i, i + size));\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Remove duplicate values from an array.\r\n \r\n Uses strict equality comparison.\r\n * Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n \r\n @returns A new array with unique values.\r\n \r\n @example\r\n * ```ts\r\n * unique([1, 1, 2, 3]);\r\n * // [1, 2, 3]\r\n * ```\r\n /\r\nexport function unique<T>(array: T[]): T[] {\r\n return [...new Set(array)];\r\n}\r\n","/\r\n Remove duplicate values from an array based on a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to determine uniqueness.\r\n * @returns A new array with unique values based on the specified key.\r\n \r\n @example\r\n * ```ts\r\n * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], \"id\");\r\n * // [{ id: 1 }, { id: 2 }]\r\n * ```\r\n /\r\nexport function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[] {\r\n const seen = new Set<T[K]>();\r\n\r\n return array.filter((item) => {\r\n const value = item[key];\r\n if (seen.has(value)) return false;\r\n seen.add(value);\r\n return true;\r\n });\r\n}\r\n","/\r\n Group array items by a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to group by.\r\n * @returns An object where keys are group identifiers and values are arrays of grouped items.\r\n \r\n @example\r\n * ```ts\r\n * groupBy([{ id: 1, name: \"Alice\" }, { id: 2, name: \"Bob\" }, { id: 1, name: \"Charlie\" }], \"id\");\r\n * // {\r\n * // 1: [{ id: 1, name: \"Alice\" }, { id: 1, name: \"Charlie\" }],\r\n * // 2: [{ id: 2, name: \"Bob\" }]\r\n * // }\r\n * ```\r\n /\r\nexport function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]> {\r\n return array.reduce(\r\n (acc, item) => {\r\n const groupKey = String(item[key]);\r\n\r\n if (!acc[groupKey]) {\r\n acc[groupKey] = [];\r\n }\r\n\r\n acc[groupKey].push(item);\r\n return acc;\r\n },\r\n {} as Record<string, T[]>,\r\n );\r\n}\r\n","/\r\n Computes the difference between two arrays.\r\n * @param array The original array.\r\n * @param values The array of values to exclude from the original array.\r\n * @returns A new array containing the values from the original array that are not in the values array.\r\n /\r\nexport function difference<T>(array: T[], values: T[]): T[] {\r\n const set = new Set(values);\r\n return array.filter((item) => !set.has(item));\r\n}\r\n","/\r\n Computes the intersection between two arrays.\r\n * @param array The original array.\r\n * @param values The array of values to include from the original array.\r\n * @returns A new array containing the values from the original array that are also in the values array.\r\n /\r\nexport function intersection<T>(array: T[], values: T[]): T[] {\r\n const set = new Set(values);\r\n return array.filter((item) => set.has(item));\r\n}\r\n","/\r\n Sorts an array of objects by a specified property.\r\n * @param array The array to sort.\r\n * @param selector A function that selects the property to sort by.\r\n * @returns A new array sorted by the specified property.\r\n /\r\nexport function sortBy<T>(array: T[], selector: (item: T) => string \| number, direction: \"asc\" \| \"desc\" = \"asc\"): T[] {\r\n return [...array].sort((a, b) => {\r\n const aValue = selector(a);\r\n const bValue = selector(b);\r\n\r\n if (aValue < bValue) return direction === \"asc\" ? -1 : 1;\r\n if (aValue > bValue) return direction === \"asc\" ? 1 : -1;\r\n return 0;\r\n });\r\n}\r\n","/\r\n Debounce a function.\r\n \r\n @param fn - The function to debounce.\r\n * @param delay - The debounce delay in milliseconds.\r\n * @returns A debounced version of the input function.\r\n /\r\nexport function debounce<T extends (...args: any[]) => void>(fn: T, delay: number) {\r\n let timeout: ReturnType<typeof setTimeout>;\r\n\r\n return function (...args: Parameters<T>) {\r\n clearTimeout(timeout);\r\n\r\n timeout = setTimeout(() => {\r\n fn(...args);\r\n }, delay);\r\n };\r\n}\r\n","/\r\n Tries to execute a promise and catches any errors that occur.\r\n \r\n @param promise - The promise to execute.\r\n * @returns A tuple containing either an error or the result.\r\n /\r\nexport async function tryCatch<T>(input: Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: () => Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: Promise<T> \| (() => Promise<T>)): Promise<TryCatchResult<T>> {\r\n try {\r\n const result = typeof input === \"function\" ? await input() : await input;\r\n\r\n return [null, result];\r\n } catch (error) {\r\n return [error as Error, null];\r\n }\r\n}\r\n\r\nexport type TryCatchResult<T> = [Error \| null, T \| null];\r\n","/\r\n Check if an object is empty.\r\n \r\n @param obj - The object to check.\r\n * @returns True if the object is empty, false otherwise.\r\n /\r\nexport function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean {\r\n return Object.keys(obj).length === 0;\r\n}\r\n","/\r\n Create a new object by picking specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to pick.\r\n * @returns A new object with only the picked keys.\r\n /\r\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K> {\r\n const result = {} as Pick<T, K>;\r\n\r\n for (const key of keys) {\r\n if (key in obj) {\r\n result[key] = obj[key];\r\n }\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Create a new object by omitting specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to omit.\r\n * @returns A new object without the omitted keys.\r\n /\r\nexport function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K> {\r\n const result = { ...obj };\r\n\r\n for (const key of keys) {\r\n delete result[key];\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Get a nested property value from an object.\r\n \r\n @param obj - The source object.\r\n * @param path - The dot-separated path to the property.\r\n * @param defaultValue - The default value to return if the property is not found.\r\n * @returns The value of the property or the default value.\r\n /\r\nexport function get(obj: any, path: string, defaultValue?: any) {\r\n const keys = path.split(\".\");\r\n let result = obj;\r\n\r\n for (const key of keys) {\r\n if (result == null) return defaultValue;\r\n result = result[key];\r\n }\r\n\r\n return result === undefined ? defaultValue : result;\r\n}\r\n","/\r\n Merges multiple objects into one.\r\n * @param objects The objects to merge.\r\n * @returns A new object containing the merged properties.\r\n /\r\nexport function merge<T extends object[]>(...objects: T): UnionToIntersection<T[number]> {\r\n return objects.reduce((acc, obj) => {\r\n return { ...acc, ...obj };\r\n }, {}) as any;\r\n}\r\n\r\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\r\n","/\r\n Capitalize the first letter of a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter capitalized.\r\n /\r\nexport function capitalize(str: string): string {\r\n if (!str) return \"\";\r\n return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter of each word capitalized.\r\n /\r\nexport function capitalizeWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\r\n .join(\" \");\r\n}\r\n","/\r\n Convert a string to camel case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to camel case.\r\n /\r\nexport function toCamelCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/[^a-zA-Z0-9]+(.)?/g, (_, char: string) => (char ? char.toUpperCase() : \"\"))\r\n .replace(/^(.)/, (match) => match.toLowerCase());\r\n}\r\n","/\r\n Convert a string to kebab case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to kebab case.\r\n /\r\nexport function toKebabCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\r\n .replace(/[_\\s]+/g, \"-\")\r\n .toLowerCase();\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the only show first letter of each word capitalized.\r\n /\r\nexport function initialWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase())\r\n .join(\" \");\r\n}\r\n","/\r\n Convert a long string to truncate string.\r\n \r\n @param value - The input string.\r\n * @param maxLength - Length on string to truncate\r\n * @param suffix - The string to append at the end of the truncated string\r\n * @returns The input string converted to truncate string.\r\n /\r\nexport function truncate(value: string, maxLength: number, suffix = \"...\"): string {\r\n if (value.length <= maxLength) return value;\r\n return value.slice(0, maxLength).trimEnd() + suffix;\r\n}\r\n","/\r\n Convert a string to a URL-friendly slug.\r\n \r\n @param value - The input string.\r\n * @returns The slugified string.\r\n /\r\nexport function slugify(value: string): string {\r\n return value\r\n .toLowerCase()\r\n .trim()\r\n .normalize(\"NFD\")\r\n .replace(/[\\u0300-\\u036f]/g, \"\")\r\n .replace(/[^a-z0-9]+/g, \"-\")\r\n .replace(/^-+\|-+$/g, \"\");\r\n}\r\n","/\r\n Convert a string to snake case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to snake case.\r\n */\r\nexport function toSnakeCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/([a-z0-9])([A-Z])/g, \"$1_$2\")\r\n .replace(/[_\\s]+/g, \"_\")\r\n .toLowerCase();\r\n}\r\n"]}

package/dist/index.d.cts CHANGED Viewed

@@ -75,6 +75,30 @@ declare function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[
  */
 declare function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]>;
+/**
+ * Computes the difference between two arrays.
+ * @param array The original array.
+ * @param values The array of values to exclude from the original array.
+ * @returns A new array containing the values from the original array that are not in the values array.
+ */
+declare function difference<T>(array: T[], values: T[]): T[];
+/**
+ * Computes the intersection between two arrays.
+ * @param array The original array.
+ * @param values The array of values to include from the original array.
+ * @returns A new array containing the values from the original array that are also in the values array.
+ */
+declare function intersection<T>(array: T[], values: T[]): T[];
+/**
+ * Sorts an array of objects by a specified property.
+ * @param array The array to sort.
+ * @param selector A function that selects the property to sort by.
+ * @returns A new array sorted by the specified property.
+ */
+declare function sortBy<T>(array: T[], selector: (item: T) => string | number, direction?: "asc" | "desc"): T[];
 /**
  * Debounce a function.
  *
@@ -130,6 +154,14 @@ declare function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T,
  */
 declare function get(obj: any, path: string, defaultValue?: any): any;
+/**
+ * Merges multiple objects into one.
+ * @param objects The objects to merge.
+ * @returns A new object containing the merged properties.
+ */
+declare function merge<T extends object[]>(...objects: T): UnionToIntersection<T[number]>;
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
  * Capitalize the first letter of a string.
  *
@@ -170,4 +202,30 @@ declare function toKebabCase(str: string): string;
  */
 declare function initialWords(str: string): string;
-export { type TryCatchResult, capitalize, capitalizeWords, chunk, debounce, get, groupBy, initialWords, isEmptyObject, omit, pick, toCamelCase, toKebabCase, tryCatch, unique, uniqueBy };
+/**
+ * Convert a long string to truncate string.
+ *
+ * @param value - The input string.
+ * @param maxLength - Length on string to truncate
+ * @param suffix - The string to append at the end of the truncated string
+ * @returns The input string converted to truncate string.
+ */
+declare function truncate(value: string, maxLength: number, suffix?: string): string;
+/**
+ * Convert a string to a URL-friendly slug.
+ *
+ * @param value - The input string.
+ * @returns The slugified string.
+ */
+declare function slugify(value: string): string;
+/**
+ * Convert a string to snake case.
+ *
+ * @param str - The input string.
+ * @returns The input string converted to snake case.
+ */
+declare function toSnakeCase(str: string): string;
+export { type TryCatchResult, capitalize, capitalizeWords, chunk, debounce, difference, get, groupBy, initialWords, intersection, isEmptyObject, merge, omit, pick, slugify, sortBy, toCamelCase, toKebabCase, toSnakeCase, truncate, tryCatch, unique, uniqueBy };

package/dist/index.d.ts CHANGED Viewed

@@ -75,6 +75,30 @@ declare function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[
  */
 declare function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]>;
+/**
+ * Computes the difference between two arrays.
+ * @param array The original array.
+ * @param values The array of values to exclude from the original array.
+ * @returns A new array containing the values from the original array that are not in the values array.
+ */
+declare function difference<T>(array: T[], values: T[]): T[];
+/**
+ * Computes the intersection between two arrays.
+ * @param array The original array.
+ * @param values The array of values to include from the original array.
+ * @returns A new array containing the values from the original array that are also in the values array.
+ */
+declare function intersection<T>(array: T[], values: T[]): T[];
+/**
+ * Sorts an array of objects by a specified property.
+ * @param array The array to sort.
+ * @param selector A function that selects the property to sort by.
+ * @returns A new array sorted by the specified property.
+ */
+declare function sortBy<T>(array: T[], selector: (item: T) => string | number, direction?: "asc" | "desc"): T[];
 /**
  * Debounce a function.
  *
@@ -130,6 +154,14 @@ declare function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T,
  */
 declare function get(obj: any, path: string, defaultValue?: any): any;
+/**
+ * Merges multiple objects into one.
+ * @param objects The objects to merge.
+ * @returns A new object containing the merged properties.
+ */
+declare function merge<T extends object[]>(...objects: T): UnionToIntersection<T[number]>;
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
  * Capitalize the first letter of a string.
  *
@@ -170,4 +202,30 @@ declare function toKebabCase(str: string): string;
  */
 declare function initialWords(str: string): string;
-export { type TryCatchResult, capitalize, capitalizeWords, chunk, debounce, get, groupBy, initialWords, isEmptyObject, omit, pick, toCamelCase, toKebabCase, tryCatch, unique, uniqueBy };
+/**
+ * Convert a long string to truncate string.
+ *
+ * @param value - The input string.
+ * @param maxLength - Length on string to truncate
+ * @param suffix - The string to append at the end of the truncated string
+ * @returns The input string converted to truncate string.
+ */
+declare function truncate(value: string, maxLength: number, suffix?: string): string;
+/**
+ * Convert a string to a URL-friendly slug.
+ *
+ * @param value - The input string.
+ * @returns The slugified string.
+ */
+declare function slugify(value: string): string;
+/**
+ * Convert a string to snake case.
+ *
+ * @param str - The input string.
+ * @returns The input string converted to snake case.
+ */
+declare function toSnakeCase(str: string): string;
+export { type TryCatchResult, capitalize, capitalizeWords, chunk, debounce, difference, get, groupBy, initialWords, intersection, isEmptyObject, merge, omit, pick, slugify, sortBy, toCamelCase, toKebabCase, toSnakeCase, truncate, tryCatch, unique, uniqueBy };

package/dist/index.js CHANGED Viewed

@@ -1,2 +1,2 @@
-function u(e,t){if(t<=0)return [];let r=[];for(let n=0;n<e.length;n+=t)r.push(e.slice(n,n+t));return r}function c(e){return [...new Set(e)]}function p(e,t){let r=new Set;return e.filter(n=>{let o=n[t];return r.has(o)?false:(r.add(o),true)})}function f(e,t){return e.reduce((r,n)=>{let o=String(n[t]);return r[o]||(r[o]=[]),r[o].push(n),r},{})}function y(e,t){let r;return function(...n){clearTimeout(r),r=setTimeout(()=>{e(...n);},t);}}async function m(e){try{return [null,typeof e=="function"?await e():await e]}catch(t){return [t,null]}}function d(e){return Object.keys(e).length===0}function C(e,t){let r={};for(let n of t)n in e&&(r[n]=e[n]);return r}function k(e,t){let r={...e};for(let n of t)delete r[n];return r}function b(e,t,r){let n=t.split("."),o=e;for(let i of n){if(o==null)return r;o=o[i];}return o===void 0?r:o}function w(e){return e?e.charAt(0).toUpperCase()+e.slice(1):""}function j(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" "):""}function E(e){return e?e.trim().replace(/[^a-zA-Z0-9]+(.)?/g,(t,r)=>r?r.toUpperCase():"").replace(/^(.)/,t=>t.toLowerCase()):""}function S(e){return e?e.trim().replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase():""}function v(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()).join(" "):""}export{w as capitalize,j as capitalizeWords,u as chunk,y as debounce,b as get,f as groupBy,v as initialWords,d as isEmptyObject,k as omit,C as pick,E as toCamelCase,S as toKebabCase,m as tryCatch,c as unique,p as uniqueBy};//# sourceMappingURL=index.js.map
+function u(e,t){if(t<=0)return [];let r=[];for(let n=0;n<e.length;n+=t)r.push(e.slice(n,n+t));return r}function a(e){return [...new Set(e)]}function T(e,t){let r=new Set;return e.filter(n=>{let o=n[t];return r.has(o)?false:(r.add(o),true)})}function l(e,t){return e.reduce((r,n)=>{let o=String(n[t]);return r[o]||(r[o]=[]),r[o].push(n),r},{})}function g(e,t){let r=new Set(t);return e.filter(n=>!r.has(n))}function m(e,t){let r=new Set(t);return e.filter(n=>r.has(n))}function C(e,t,r="asc"){return [...e].sort((n,o)=>{let i=t(n),s=t(o);return i<s?r==="asc"?-1:1:i>s?r==="asc"?1:-1:0})}function k(e,t){let r;return function(...n){clearTimeout(r),r=setTimeout(()=>{e(...n);},t);}}async function b(e){try{return [null,typeof e=="function"?await e():await e]}catch(t){return [t,null]}}function w(e){return Object.keys(e).length===0}function R(e,t){let r={};for(let n of t)n in e&&(r[n]=e[n]);return r}function S(e,t){let r={...e};for(let n of t)delete r[n];return r}function z(e,t,r){let n=t.split("."),o=e;for(let i of n){if(o==null)return r;o=o[i];}return o===void 0?r:o}function $(...e){return e.reduce((t,r)=>({...t,...r}),{})}function E(e){return e?e.charAt(0).toUpperCase()+e.slice(1):""}function B(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" "):""}function O(e){return e?e.trim().replace(/[^a-zA-Z0-9]+(.)?/g,(t,r)=>r?r.toUpperCase():"").replace(/^(.)/,t=>t.toLowerCase()):""}function q(e){return e?e.trim().replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase():""}function D(e){return e?e.trim().split(/\s+/).map(t=>t.charAt(0).toUpperCase()).join(" "):""}function N(e,t,r="..."){return e.length<=t?e:e.slice(0,t).trimEnd()+r}function G(e){return e.toLowerCase().trim().normalize("NFD").replace(/[\u0300-\u036f]/g,"").replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")}function J(e){return e?e.trim().replace(/([a-z0-9])([A-Z])/g,"$1_$2").replace(/[_\s]+/g,"_").toLowerCase():""}export{E as capitalize,B as capitalizeWords,u as chunk,k as debounce,g as difference,z as get,l as groupBy,D as initialWords,m as intersection,w as isEmptyObject,$ as merge,S as omit,R as pick,G as slugify,C as sortBy,O as toCamelCase,q as toKebabCase,J as toSnakeCase,N as truncate,b as tryCatch,a as unique,T as uniqueBy};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/array/chunk.ts","../src/array/unique.ts","../src/array/uniqueBy.ts","../src/array/groupBy.ts","../src/function/debounce.ts","../src/function/tryCatch.ts","../src/object/isEmptyObject.ts","../src/object/pick.ts","../src/object/omit.ts","../src/object/get.ts","../src/string/capitalize.ts","../src/string/capitalizeWords.ts","../src/string/toCamelCase.ts","../src/string/toKebabCase.ts","../src/string/initialWords.ts"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","debounce","fn","delay","timeout","args","tryCatch","input","error","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase","initialWords"],"mappings":"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","file":"index.js","sourcesContent":["/*\r\n Split an array into smaller arrays (chunks) of a given size.\r\n \r\n Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n * @param size - The size of each chunk. Must be greater than 0.\r\n \r\n @returns A new array containing chunked subarrays.\r\n \r\n @example\r\n * ```ts\r\n * chunk([1, 2, 3, 4, 5], 2);\r\n * // [[1, 2], [3, 4], [5]]\r\n * ```\r\n \r\n @throws If size is less than 1.\r\n /\r\nexport function chunk<T>(arr: T[], size: number): T[][] {\r\n if (size <= 0) return [];\r\n\r\n const result: T[][] = [];\r\n\r\n for (let i = 0; i < arr.length; i += size) {\r\n result.push(arr.slice(i, i + size));\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Remove duplicate values from an array.\r\n \r\n Uses strict equality comparison.\r\n * Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n \r\n @returns A new array with unique values.\r\n \r\n @example\r\n * ```ts\r\n * unique([1, 1, 2, 3]);\r\n * // [1, 2, 3]\r\n * ```\r\n /\r\nexport function unique<T>(array: T[]): T[] {\r\n return [...new Set(array)];\r\n}\r\n","/\r\n Remove duplicate values from an array based on a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to determine uniqueness.\r\n * @returns A new array with unique values based on the specified key.\r\n \r\n @example\r\n * ```ts\r\n * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], \"id\");\r\n * // [{ id: 1 }, { id: 2 }]\r\n * ```\r\n /\r\nexport function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[] {\r\n const seen = new Set<T[K]>();\r\n\r\n return array.filter((item) => {\r\n const value = item[key];\r\n if (seen.has(value)) return false;\r\n seen.add(value);\r\n return true;\r\n });\r\n}\r\n","/\r\n Group array items by a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to group by.\r\n * @returns An object where keys are group identifiers and values are arrays of grouped items.\r\n \r\n @example\r\n * ```ts\r\n * groupBy([{ id: 1, name: \"Alice\" }, { id: 2, name: \"Bob\" }, { id: 1, name: \"Charlie\" }], \"id\");\r\n * // {\r\n * // 1: [{ id: 1, name: \"Alice\" }, { id: 1, name: \"Charlie\" }],\r\n * // 2: [{ id: 2, name: \"Bob\" }]\r\n * // }\r\n * ```\r\n /\r\nexport function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]> {\r\n return array.reduce(\r\n (acc, item) => {\r\n const groupKey = String(item[key]);\r\n\r\n if (!acc[groupKey]) {\r\n acc[groupKey] = [];\r\n }\r\n\r\n acc[groupKey].push(item);\r\n return acc;\r\n },\r\n {} as Record<string, T[]>,\r\n );\r\n}\r\n","/\r\n Debounce a function.\r\n \r\n @param fn - The function to debounce.\r\n * @param delay - The debounce delay in milliseconds.\r\n * @returns A debounced version of the input function.\r\n /\r\nexport function debounce<T extends (...args: any[]) => void>(fn: T, delay: number) {\r\n let timeout: ReturnType<typeof setTimeout>;\r\n\r\n return function (...args: Parameters<T>) {\r\n clearTimeout(timeout);\r\n\r\n timeout = setTimeout(() => {\r\n fn(...args);\r\n }, delay);\r\n };\r\n}\r\n","/\r\n Tries to execute a promise and catches any errors that occur.\r\n \r\n @param promise - The promise to execute.\r\n * @returns A tuple containing either an error or the result.\r\n /\r\nexport async function tryCatch<T>(input: Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: () => Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: Promise<T> \| (() => Promise<T>)): Promise<TryCatchResult<T>> {\r\n try {\r\n const result = typeof input === \"function\" ? await input() : await input;\r\n\r\n return [null, result];\r\n } catch (error) {\r\n return [error as Error, null];\r\n }\r\n}\r\n\r\nexport type TryCatchResult<T> = [Error \| null, T \| null];\r\n","/\r\n Check if an object is empty.\r\n \r\n @param obj - The object to check.\r\n * @returns True if the object is empty, false otherwise.\r\n /\r\nexport function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean {\r\n return Object.keys(obj).length === 0;\r\n}\r\n","/\r\n Create a new object by picking specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to pick.\r\n * @returns A new object with only the picked keys.\r\n /\r\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K> {\r\n const result = {} as Pick<T, K>;\r\n\r\n for (const key of keys) {\r\n if (key in obj) {\r\n result[key] = obj[key];\r\n }\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Create a new object by omitting specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to omit.\r\n * @returns A new object without the omitted keys.\r\n /\r\nexport function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K> {\r\n const result = { ...obj };\r\n\r\n for (const key of keys) {\r\n delete result[key];\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Get a nested property value from an object.\r\n \r\n @param obj - The source object.\r\n * @param path - The dot-separated path to the property.\r\n * @param defaultValue - The default value to return if the property is not found.\r\n * @returns The value of the property or the default value.\r\n /\r\nexport function get(obj: any, path: string, defaultValue?: any) {\r\n const keys = path.split(\".\");\r\n let result = obj;\r\n\r\n for (const key of keys) {\r\n if (result == null) return defaultValue;\r\n result = result[key];\r\n }\r\n\r\n return result === undefined ? defaultValue : result;\r\n}\r\n","/\r\n Capitalize the first letter of a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter capitalized.\r\n /\r\nexport function capitalize(str: string): string {\r\n if (!str) return \"\";\r\n return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter of each word capitalized.\r\n /\r\nexport function capitalizeWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\r\n .join(\" \");\r\n}\r\n","/\r\n Convert a string to camel case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to camel case.\r\n /\r\nexport function toCamelCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/[^a-zA-Z0-9]+(.)?/g, (_, char: string) => (char ? char.toUpperCase() : \"\"))\r\n .replace(/^(.)/, (match) => match.toLowerCase());\r\n}\r\n","/\r\n Convert a string to kebab case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to kebab case.\r\n /\r\nexport function toKebabCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\r\n .replace(/[_\\s]+/g, \"-\")\r\n .toLowerCase();\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the only show first letter of each word capitalized.\r\n */\r\nexport function initialWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase())\r\n .join(\" \");\r\n}\r\n"]}
1	+ {"version":3,"sources":["../src/array/chunk.ts","../src/array/unique.ts","../src/array/uniqueBy.ts","../src/array/groupBy.ts","../src/array/difference.ts","../src/array/intersection.ts","../src/array/sortBy.ts","../src/function/debounce.ts","../src/function/tryCatch.ts","../src/object/isEmptyObject.ts","../src/object/pick.ts","../src/object/omit.ts","../src/object/get.ts","../src/object/merge.ts","../src/string/capitalize.ts","../src/string/capitalizeWords.ts","../src/string/toCamelCase.ts","../src/string/toKebabCase.ts","../src/string/initialWords.ts","../src/string/truncate.ts","../src/string/slugify.ts","../src/string/toSnakeCase.ts"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","difference","values","set","intersection","sortBy","selector","direction","a","b","aValue","bValue","debounce","fn","delay","timeout","args","tryCatch","input","error","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","merge","objects","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase","initialWords","truncate","maxLength","suffix","slugify","toSnakeCase"],"mappings":"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","file":"index.js","sourcesContent":["/*\r\n Split an array into smaller arrays (chunks) of a given size.\r\n \r\n Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n * @param size - The size of each chunk. Must be greater than 0.\r\n \r\n @returns A new array containing chunked subarrays.\r\n \r\n @example\r\n * ```ts\r\n * chunk([1, 2, 3, 4, 5], 2);\r\n * // [[1, 2], [3, 4], [5]]\r\n * ```\r\n \r\n @throws If size is less than 1.\r\n /\r\nexport function chunk<T>(arr: T[], size: number): T[][] {\r\n if (size <= 0) return [];\r\n\r\n const result: T[][] = [];\r\n\r\n for (let i = 0; i < arr.length; i += size) {\r\n result.push(arr.slice(i, i + size));\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Remove duplicate values from an array.\r\n \r\n Uses strict equality comparison.\r\n * Does not mutate the original array.\r\n \r\n @typeParam T - Array element type.\r\n * @param array - The source array.\r\n \r\n @returns A new array with unique values.\r\n \r\n @example\r\n * ```ts\r\n * unique([1, 1, 2, 3]);\r\n * // [1, 2, 3]\r\n * ```\r\n /\r\nexport function unique<T>(array: T[]): T[] {\r\n return [...new Set(array)];\r\n}\r\n","/\r\n Remove duplicate values from an array based on a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to determine uniqueness.\r\n * @returns A new array with unique values based on the specified key.\r\n \r\n @example\r\n * ```ts\r\n * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], \"id\");\r\n * // [{ id: 1 }, { id: 2 }]\r\n * ```\r\n /\r\nexport function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[] {\r\n const seen = new Set<T[K]>();\r\n\r\n return array.filter((item) => {\r\n const value = item[key];\r\n if (seen.has(value)) return false;\r\n seen.add(value);\r\n return true;\r\n });\r\n}\r\n","/\r\n Group array items by a specific key.\r\n \r\n @typeParam T - Array element type.\r\n * @typeParam K - Key type (must be string \| number \| symbol).\r\n * @param array - The source array.\r\n * @param key - The key to group by.\r\n * @returns An object where keys are group identifiers and values are arrays of grouped items.\r\n \r\n @example\r\n * ```ts\r\n * groupBy([{ id: 1, name: \"Alice\" }, { id: 2, name: \"Bob\" }, { id: 1, name: \"Charlie\" }], \"id\");\r\n * // {\r\n * // 1: [{ id: 1, name: \"Alice\" }, { id: 1, name: \"Charlie\" }],\r\n * // 2: [{ id: 2, name: \"Bob\" }]\r\n * // }\r\n * ```\r\n /\r\nexport function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]> {\r\n return array.reduce(\r\n (acc, item) => {\r\n const groupKey = String(item[key]);\r\n\r\n if (!acc[groupKey]) {\r\n acc[groupKey] = [];\r\n }\r\n\r\n acc[groupKey].push(item);\r\n return acc;\r\n },\r\n {} as Record<string, T[]>,\r\n );\r\n}\r\n","/\r\n Computes the difference between two arrays.\r\n * @param array The original array.\r\n * @param values The array of values to exclude from the original array.\r\n * @returns A new array containing the values from the original array that are not in the values array.\r\n /\r\nexport function difference<T>(array: T[], values: T[]): T[] {\r\n const set = new Set(values);\r\n return array.filter((item) => !set.has(item));\r\n}\r\n","/\r\n Computes the intersection between two arrays.\r\n * @param array The original array.\r\n * @param values The array of values to include from the original array.\r\n * @returns A new array containing the values from the original array that are also in the values array.\r\n /\r\nexport function intersection<T>(array: T[], values: T[]): T[] {\r\n const set = new Set(values);\r\n return array.filter((item) => set.has(item));\r\n}\r\n","/\r\n Sorts an array of objects by a specified property.\r\n * @param array The array to sort.\r\n * @param selector A function that selects the property to sort by.\r\n * @returns A new array sorted by the specified property.\r\n /\r\nexport function sortBy<T>(array: T[], selector: (item: T) => string \| number, direction: \"asc\" \| \"desc\" = \"asc\"): T[] {\r\n return [...array].sort((a, b) => {\r\n const aValue = selector(a);\r\n const bValue = selector(b);\r\n\r\n if (aValue < bValue) return direction === \"asc\" ? -1 : 1;\r\n if (aValue > bValue) return direction === \"asc\" ? 1 : -1;\r\n return 0;\r\n });\r\n}\r\n","/\r\n Debounce a function.\r\n \r\n @param fn - The function to debounce.\r\n * @param delay - The debounce delay in milliseconds.\r\n * @returns A debounced version of the input function.\r\n /\r\nexport function debounce<T extends (...args: any[]) => void>(fn: T, delay: number) {\r\n let timeout: ReturnType<typeof setTimeout>;\r\n\r\n return function (...args: Parameters<T>) {\r\n clearTimeout(timeout);\r\n\r\n timeout = setTimeout(() => {\r\n fn(...args);\r\n }, delay);\r\n };\r\n}\r\n","/\r\n Tries to execute a promise and catches any errors that occur.\r\n \r\n @param promise - The promise to execute.\r\n * @returns A tuple containing either an error or the result.\r\n /\r\nexport async function tryCatch<T>(input: Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: () => Promise<T>): Promise<TryCatchResult<T>>;\r\n\r\nexport async function tryCatch<T>(input: Promise<T> \| (() => Promise<T>)): Promise<TryCatchResult<T>> {\r\n try {\r\n const result = typeof input === \"function\" ? await input() : await input;\r\n\r\n return [null, result];\r\n } catch (error) {\r\n return [error as Error, null];\r\n }\r\n}\r\n\r\nexport type TryCatchResult<T> = [Error \| null, T \| null];\r\n","/\r\n Check if an object is empty.\r\n \r\n @param obj - The object to check.\r\n * @returns True if the object is empty, false otherwise.\r\n /\r\nexport function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean {\r\n return Object.keys(obj).length === 0;\r\n}\r\n","/\r\n Create a new object by picking specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to pick.\r\n * @returns A new object with only the picked keys.\r\n /\r\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K> {\r\n const result = {} as Pick<T, K>;\r\n\r\n for (const key of keys) {\r\n if (key in obj) {\r\n result[key] = obj[key];\r\n }\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Create a new object by omitting specified keys from the source object.\r\n \r\n @param obj - The source object.\r\n * @param keys - The keys to omit.\r\n * @returns A new object without the omitted keys.\r\n /\r\nexport function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K> {\r\n const result = { ...obj };\r\n\r\n for (const key of keys) {\r\n delete result[key];\r\n }\r\n\r\n return result;\r\n}\r\n","/\r\n Get a nested property value from an object.\r\n \r\n @param obj - The source object.\r\n * @param path - The dot-separated path to the property.\r\n * @param defaultValue - The default value to return if the property is not found.\r\n * @returns The value of the property or the default value.\r\n /\r\nexport function get(obj: any, path: string, defaultValue?: any) {\r\n const keys = path.split(\".\");\r\n let result = obj;\r\n\r\n for (const key of keys) {\r\n if (result == null) return defaultValue;\r\n result = result[key];\r\n }\r\n\r\n return result === undefined ? defaultValue : result;\r\n}\r\n","/\r\n Merges multiple objects into one.\r\n * @param objects The objects to merge.\r\n * @returns A new object containing the merged properties.\r\n /\r\nexport function merge<T extends object[]>(...objects: T): UnionToIntersection<T[number]> {\r\n return objects.reduce((acc, obj) => {\r\n return { ...acc, ...obj };\r\n }, {}) as any;\r\n}\r\n\r\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\r\n","/\r\n Capitalize the first letter of a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter capitalized.\r\n /\r\nexport function capitalize(str: string): string {\r\n if (!str) return \"\";\r\n return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the first letter of each word capitalized.\r\n /\r\nexport function capitalizeWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\r\n .join(\" \");\r\n}\r\n","/\r\n Convert a string to camel case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to camel case.\r\n /\r\nexport function toCamelCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/[^a-zA-Z0-9]+(.)?/g, (_, char: string) => (char ? char.toUpperCase() : \"\"))\r\n .replace(/^(.)/, (match) => match.toLowerCase());\r\n}\r\n","/\r\n Convert a string to kebab case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to kebab case.\r\n /\r\nexport function toKebabCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\r\n .replace(/[_\\s]+/g, \"-\")\r\n .toLowerCase();\r\n}\r\n","/\r\n Capitalize the first letter of each word in a string.\r\n \r\n @param str - The input string.\r\n * @returns The input string with the only show first letter of each word capitalized.\r\n /\r\nexport function initialWords(str: string): string {\r\n if (!str) return \"\";\r\n return str\r\n .trim()\r\n .split(/\\s+/)\r\n .map((word) => word.charAt(0).toUpperCase())\r\n .join(\" \");\r\n}\r\n","/\r\n Convert a long string to truncate string.\r\n \r\n @param value - The input string.\r\n * @param maxLength - Length on string to truncate\r\n * @param suffix - The string to append at the end of the truncated string\r\n * @returns The input string converted to truncate string.\r\n /\r\nexport function truncate(value: string, maxLength: number, suffix = \"...\"): string {\r\n if (value.length <= maxLength) return value;\r\n return value.slice(0, maxLength).trimEnd() + suffix;\r\n}\r\n","/\r\n Convert a string to a URL-friendly slug.\r\n \r\n @param value - The input string.\r\n * @returns The slugified string.\r\n /\r\nexport function slugify(value: string): string {\r\n return value\r\n .toLowerCase()\r\n .trim()\r\n .normalize(\"NFD\")\r\n .replace(/[\\u0300-\\u036f]/g, \"\")\r\n .replace(/[^a-z0-9]+/g, \"-\")\r\n .replace(/^-+\|-+$/g, \"\");\r\n}\r\n","/\r\n Convert a string to snake case.\r\n \r\n @param str - The input string.\r\n * @returns The input string converted to snake case.\r\n */\r\nexport function toSnakeCase(str: string): string {\r\n if (!str) return \"\";\r\n\r\n return str\r\n .trim()\r\n .replace(/([a-z0-9])([A-Z])/g, \"$1_$2\")\r\n .replace(/[_\\s]+/g, \"_\")\r\n .toLowerCase();\r\n}\r\n"]}

package/package.json CHANGED Viewed

@@ -1,123 +1,127 @@
-{
-  "name": "@titocandradev/neatcore",
-  "version": "0.3.3",
-  "private": false,
-  "description": "A clean, zero-dependency, TypeScript-first utility core.",
-  "homepage": "https://github.com/tcandra24/neat-core#readme",
-  "bugs": {
-    "url": "https://github.com/tcandra24/neat-core/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tcandra24/neat-core.git"
-  },
-  "license": "MIT",
-  "author": "Tito Candra",
-  "keywords": [
-    "module",
-    "util"
-  ],
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.ts",
-  "directories": {
-    "test": "tests"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "tsup --watch",
-    "build": "tsup",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "coverage": "vitest run --coverage"
-  },
-  "dependencies": {
-    "acorn": "^8.15.0",
-    "any-promise": "^1.3.0",
-    "assertion-error": "^2.0.1",
-    "ast-v8-to-istanbul": "^0.3.11",
-    "bundle-require": "^5.1.0",
-    "cac": "^6.7.14",
-    "chai": "^6.2.2",
-    "chokidar": "^4.0.3",
-    "commander": "^4.1.1",
-    "confbox": "^0.1.8",
-    "consola": "^3.4.2",
-    "debug": "^4.4.3",
-    "es-module-lexer": "^1.7.0",
-    "esbuild": "^0.27.3",
-    "estree-walker": "^3.0.3",
-    "expect-type": "^1.3.0",
-    "fdir": "^6.5.0",
-    "fix-dts-default-cjs-exports": "^1.0.1",
-    "has-flag": "^4.0.0",
-    "html-escaper": "^2.0.2",
-    "istanbul-lib-coverage": "^3.2.2",
-    "istanbul-lib-report": "^3.0.1",
-    "istanbul-reports": "^3.2.0",
-    "joycon": "^3.1.1",
-    "js-tokens": "^10.0.0",
-    "lilconfig": "^3.1.3",
-    "lines-and-columns": "^1.2.4",
-    "load-tsconfig": "^0.2.5",
-    "magic-string": "^0.30.21",
-    "magicast": "^0.5.2",
-    "make-dir": "^4.0.0",
-    "mlly": "^1.8.0",
-    "ms": "^2.1.3",
-    "mz": "^2.7.0",
-    "nanoid": "^3.3.11",
-    "object-assign": "^4.1.1",
-    "obug": "^2.1.1",
-    "pathe": "^2.0.3",
-    "picocolors": "^1.1.1",
-    "picomatch": "^4.0.3",
-    "pirates": "^4.0.7",
-    "pkg-types": "^1.3.1",
-    "postcss": "^8.5.6",
-    "postcss-load-config": "^6.0.1",
-    "readdirp": "^4.1.2",
-    "resolve-from": "^5.0.0",
-    "rollup": "^4.57.1",
-    "semver": "^7.7.4",
-    "siginfo": "^2.0.0",
-    "source-map": "^0.7.6",
-    "source-map-js": "^1.2.1",
-    "stackback": "^0.0.2",
-    "std-env": "^3.10.0",
-    "sucrase": "^3.35.1",
-    "supports-color": "^7.2.0",
-    "thenify": "^3.3.1",
-    "thenify-all": "^1.6.0",
-    "tinybench": "^2.9.0",
-    "tinyexec": "^0.3.2",
-    "tinyglobby": "^0.2.15",
-    "tinyrainbow": "^3.0.3",
-    "tree-kill": "^1.2.2",
-    "ts-interface-checker": "^0.1.13",
-    "ufo": "^1.6.3",
-    "undici-types": "^7.16.0",
-    "vite": "^7.3.1",
-    "why-is-node-running": "^2.3.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.2.3",
-    "@vitest/coverage-v8": "^4.0.18",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "sideEffects": false,
-  "module": "./dist/index.js"
-}
+{
+  "name": "@titocandradev/neatcore",
+  "version": "0.4.1",
+  "private": false,
+  "description": "A clean, zero-dependency, TypeScript-first utility core.",
+  "homepage": "https://tcandra24.github.io/neat-core/",
+  "bugs": {
+    "url": "https://github.com/tcandra24/neat-core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tcandra24/neat-core.git"
+  },
+  "license": "MIT",
+  "author": "Tito Candra",
+  "keywords": [
+    "module",
+    "util"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "directories": {
+    "test": "tests"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "coverage": "vitest run --coverage",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "dependencies": {
+    "acorn": "^8.15.0",
+    "any-promise": "^1.3.0",
+    "assertion-error": "^2.0.1",
+    "ast-v8-to-istanbul": "^0.3.11",
+    "bundle-require": "^5.1.0",
+    "cac": "^6.7.14",
+    "chai": "^6.2.2",
+    "chokidar": "^4.0.3",
+    "commander": "^4.1.1",
+    "confbox": "^0.1.8",
+    "consola": "^3.4.2",
+    "debug": "^4.4.3",
+    "es-module-lexer": "^1.7.0",
+    "esbuild": "^0.27.3",
+    "estree-walker": "^3.0.3",
+    "expect-type": "^1.3.0",
+    "fdir": "^6.5.0",
+    "fix-dts-default-cjs-exports": "^1.0.1",
+    "has-flag": "^4.0.0",
+    "html-escaper": "^2.0.2",
+    "istanbul-lib-coverage": "^3.2.2",
+    "istanbul-lib-report": "^3.0.1",
+    "istanbul-reports": "^3.2.0",
+    "joycon": "^3.1.1",
+    "js-tokens": "^10.0.0",
+    "lilconfig": "^3.1.3",
+    "lines-and-columns": "^1.2.4",
+    "load-tsconfig": "^0.2.5",
+    "magic-string": "^0.30.21",
+    "magicast": "^0.5.2",
+    "make-dir": "^4.0.0",
+    "mlly": "^1.8.0",
+    "ms": "^2.1.3",
+    "mz": "^2.7.0",
+    "nanoid": "^3.3.11",
+    "object-assign": "^4.1.1",
+    "obug": "^2.1.1",
+    "pathe": "^2.0.3",
+    "picocolors": "^1.1.1",
+    "picomatch": "^4.0.3",
+    "pirates": "^4.0.7",
+    "pkg-types": "^1.3.1",
+    "postcss": "^8.5.6",
+    "postcss-load-config": "^6.0.1",
+    "readdirp": "^4.1.2",
+    "resolve-from": "^5.0.0",
+    "rollup": "^4.57.1",
+    "semver": "^7.7.4",
+    "siginfo": "^2.0.0",
+    "source-map": "^0.7.6",
+    "source-map-js": "^1.2.1",
+    "stackback": "^0.0.2",
+    "std-env": "^3.10.0",
+    "sucrase": "^3.35.1",
+    "supports-color": "^7.2.0",
+    "thenify": "^3.3.1",
+    "thenify-all": "^1.6.0",
+    "tinybench": "^2.9.0",
+    "tinyexec": "^0.3.2",
+    "tinyglobby": "^0.2.15",
+    "tinyrainbow": "^3.0.3",
+    "tree-kill": "^1.2.2",
+    "ts-interface-checker": "^0.1.13",
+    "ufo": "^1.6.3",
+    "undici-types": "^7.16.0",
+    "vite": "^7.3.1",
+    "why-is-node-running": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "@vitest/coverage-v8": "^4.0.18",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitepress": "^2.0.0-alpha.16",
+    "vitest": "^4.0.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "module": "./dist/index.js"
+}