@titocandradev/neatcore 0.2.7 → 0.2.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tito Candra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -38,18 +38,18 @@ bun add @titocandradev/neatcore
 ### ES Module
 
 ```ts
-import { firstUppercase } from "@titocandradev/neatcore";
+import { capitalizeWords } from "@titocandradev/neatcore";
 
-firstUppercase("tito candra");
+capitalizeWords("tito candra");
 // → "Tito Candra"
 ```
 
 ### CommonJS
 
 ```js
-const { firstUppercase } = require("@titocandradev/neatcore");
+const { capitalizeWords } = require("@titocandradev/neatcore");
 
-firstUppercase("tito candra");
+capitalizeWords("tito candra");
 ```
 
 ---
@@ -58,12 +58,12 @@ firstUppercase("tito candra");
 
 ### 🔤 String
 
-- `firstUppercase(str: string): string`
+- `capitalizeWords(str: string): string`
 
 Example:
 
 ```ts
-firstUppercase("hello world");
+capitalizeWords("hello world");
 // → "Hello World"
 ```
 
@@ -86,7 +86,7 @@ NeatCore is built with the following principles:
 Import only what you need:
 
 ```ts
-import { firstUppercase } from "@titocandradev/neatcore";
+import { capitalizeWords } from "@titocandradev/neatcore";
 ```
 
 Modern bundlers like Vite, Webpack, and Rollup will automatically remove

package/dist/index.cjs.map

@@ -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/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"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","debounce","fn","delay","timeout","args","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase"],"mappings":"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","file":"index.cjs","sourcesContent":["export 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","export function unique<T>(array: T[]): T[] {\r\n  return [...new Set(array)];\r\n}\r\n","export 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","export 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","export 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","export function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean {\r\n  return Object.keys(obj).length === 0;\r\n}\r\n","export 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","export 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","export 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","export function capitalize(str: string): string {\r\n  if (!str) return \"\";\r\n  return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n","export 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","export 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","export 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"]}
+{"version":3,"sources":["../src/array/chunk.ts","../src/array/unique.ts","../src/array/uniqueBy.ts","../src/array/groupBy.ts","../src/function/debounce.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"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","debounce","fn","delay","timeout","args","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase"],"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 * 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"]}

package/dist/index.d.cts

@@ -1,27 +1,155 @@
+/**
+ * Split an array into smaller arrays (chunks) of a given size.
+ *
+ * Does not mutate the original array.
+ *
+ * @typeParam T - Array element type.
+ * @param array - The source array.
+ * @param size - The size of each chunk. Must be greater than 0.
+ *
+ * @returns A new array containing chunked subarrays.
+ *
+ * @example
+ * ```ts
+ * chunk([1, 2, 3, 4, 5], 2);
+ * // [[1, 2], [3, 4], [5]]
+ * ```
+ *
+ * @throws If size is less than 1.
+ */
 declare function chunk<T>(arr: T[], size: number): T[][];
 
+/**
+ * Remove duplicate values from an array.
+ *
+ * Uses strict equality comparison.
+ * Does not mutate the original array.
+ *
+ * @typeParam T - Array element type.
+ * @param array - The source array.
+ *
+ * @returns A new array with unique values.
+ *
+ * @example
+ * ```ts
+ * unique([1, 1, 2, 3]);
+ * // [1, 2, 3]
+ * ```
+ */
 declare function unique<T>(array: T[]): T[];
 
+/**
+ * Remove duplicate values from an array based on a specific key.
+ *
+ * @typeParam T - Array element type.
+ * @typeParam K - Key type (must be string | number | symbol).
+ * @param array - The source array.
+ * @param key - The key to determine uniqueness.
+ * @returns A new array with unique values based on the specified key.
+ *
+ * @example
+ * ```ts
+ * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], "id");
+ * // [{ id: 1 }, { id: 2 }]
+ * ```
+ */
 declare function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[];
 
+/**
+ * Group array items by a specific key.
+ *
+ * @typeParam T - Array element type.
+ * @typeParam K - Key type (must be string | number | symbol).
+ * @param array - The source array.
+ * @param key - The key to group by.
+ * @returns An object where keys are group identifiers and values are arrays of grouped items.
+ *
+ * @example
+ * ```ts
+ * groupBy([{ id: 1, name: "Alice" }, { id: 2, name: "Bob" }, { id: 1, name: "Charlie" }], "id");
+ * // {
+ * //   1: [{ id: 1, name: "Alice" }, { id: 1, name: "Charlie" }],
+ * //   2: [{ id: 2, name: "Bob" }]
+ * // }
+ * ```
+ */
 declare function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]>;
 
+/**
+ * Debounce a function.
+ *
+ * @param fn - The function to debounce.
+ * @param delay - The debounce delay in milliseconds.
+ * @returns A debounced version of the input function.
+ */
 declare function debounce<T extends (...args: any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
 
+/**
+ * Check if an object is empty.
+ *
+ * @param obj - The object to check.
+ * @returns True if the object is empty, false otherwise.
+ */
 declare function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean;
 
+/**
+ * Create a new object by picking specified keys from the source object.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to pick.
+ * @returns A new object with only the picked keys.
+ */
 declare function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K>;
 
+/**
+ * Create a new object by omitting specified keys from the source object.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to omit.
+ * @returns A new object without the omitted keys.
+ */
 declare function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K>;
 
+/**
+ * Get a nested property value from an object.
+ *
+ * @param obj - The source object.
+ * @param path - The dot-separated path to the property.
+ * @param defaultValue - The default value to return if the property is not found.
+ * @returns The value of the property or the default value.
+ */
 declare function get(obj: any, path: string, defaultValue?: any): any;
 
+/**
+ * Capitalize the first letter of a string.
+ *
+ * @param str - The input string.
+ * @returns The input string with the first letter capitalized.
+ */
 declare function capitalize(str: string): string;
 
+/**
+ * Capitalize the first letter of each word in a string.
+ *
+ * @param str - The input string.
+ * @returns The input string with the first letter of each word capitalized.
+ */
 declare function capitalizeWords(str: string): string;
 
+/**
+ * Convert a string to camel case.
+ *
+ * @param str - The input string.
+ * @returns The input string converted to camel case.
+ */
 declare function toCamelCase(str: string): string;
 
+/**
+ * Convert a string to kebab case.
+ *
+ * @param str - The input string.
+ * @returns The input string converted to kebab case.
+ */
 declare function toKebabCase(str: string): string;
 
 export { capitalize, capitalizeWords, chunk, debounce, get, groupBy, isEmptyObject, omit, pick, toCamelCase, toKebabCase, unique, uniqueBy };

package/dist/index.d.ts

@@ -1,27 +1,155 @@
+/**
+ * Split an array into smaller arrays (chunks) of a given size.
+ *
+ * Does not mutate the original array.
+ *
+ * @typeParam T - Array element type.
+ * @param array - The source array.
+ * @param size - The size of each chunk. Must be greater than 0.
+ *
+ * @returns A new array containing chunked subarrays.
+ *
+ * @example
+ * ```ts
+ * chunk([1, 2, 3, 4, 5], 2);
+ * // [[1, 2], [3, 4], [5]]
+ * ```
+ *
+ * @throws If size is less than 1.
+ */
 declare function chunk<T>(arr: T[], size: number): T[][];
 
+/**
+ * Remove duplicate values from an array.
+ *
+ * Uses strict equality comparison.
+ * Does not mutate the original array.
+ *
+ * @typeParam T - Array element type.
+ * @param array - The source array.
+ *
+ * @returns A new array with unique values.
+ *
+ * @example
+ * ```ts
+ * unique([1, 1, 2, 3]);
+ * // [1, 2, 3]
+ * ```
+ */
 declare function unique<T>(array: T[]): T[];
 
+/**
+ * Remove duplicate values from an array based on a specific key.
+ *
+ * @typeParam T - Array element type.
+ * @typeParam K - Key type (must be string | number | symbol).
+ * @param array - The source array.
+ * @param key - The key to determine uniqueness.
+ * @returns A new array with unique values based on the specified key.
+ *
+ * @example
+ * ```ts
+ * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], "id");
+ * // [{ id: 1 }, { id: 2 }]
+ * ```
+ */
 declare function uniqueBy<T, K extends keyof T>(array: readonly T[], key: K): T[];
 
+/**
+ * Group array items by a specific key.
+ *
+ * @typeParam T - Array element type.
+ * @typeParam K - Key type (must be string | number | symbol).
+ * @param array - The source array.
+ * @param key - The key to group by.
+ * @returns An object where keys are group identifiers and values are arrays of grouped items.
+ *
+ * @example
+ * ```ts
+ * groupBy([{ id: 1, name: "Alice" }, { id: 2, name: "Bob" }, { id: 1, name: "Charlie" }], "id");
+ * // {
+ * //   1: [{ id: 1, name: "Alice" }, { id: 1, name: "Charlie" }],
+ * //   2: [{ id: 2, name: "Bob" }]
+ * // }
+ * ```
+ */
 declare function groupBy<T, K extends keyof T>(array: readonly T[], key: K): Record<string, T[]>;
 
+/**
+ * Debounce a function.
+ *
+ * @param fn - The function to debounce.
+ * @param delay - The debounce delay in milliseconds.
+ * @returns A debounced version of the input function.
+ */
 declare function debounce<T extends (...args: any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
 
+/**
+ * Check if an object is empty.
+ *
+ * @param obj - The object to check.
+ * @returns True if the object is empty, false otherwise.
+ */
 declare function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean;
 
+/**
+ * Create a new object by picking specified keys from the source object.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to pick.
+ * @returns A new object with only the picked keys.
+ */
 declare function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K>;
 
+/**
+ * Create a new object by omitting specified keys from the source object.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to omit.
+ * @returns A new object without the omitted keys.
+ */
 declare function omit<T, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K>;
 
+/**
+ * Get a nested property value from an object.
+ *
+ * @param obj - The source object.
+ * @param path - The dot-separated path to the property.
+ * @param defaultValue - The default value to return if the property is not found.
+ * @returns The value of the property or the default value.
+ */
 declare function get(obj: any, path: string, defaultValue?: any): any;
 
+/**
+ * Capitalize the first letter of a string.
+ *
+ * @param str - The input string.
+ * @returns The input string with the first letter capitalized.
+ */
 declare function capitalize(str: string): string;
 
+/**
+ * Capitalize the first letter of each word in a string.
+ *
+ * @param str - The input string.
+ * @returns The input string with the first letter of each word capitalized.
+ */
 declare function capitalizeWords(str: string): string;
 
+/**
+ * Convert a string to camel case.
+ *
+ * @param str - The input string.
+ * @returns The input string converted to camel case.
+ */
 declare function toCamelCase(str: string): string;
 
+/**
+ * Convert a string to kebab case.
+ *
+ * @param str - The input string.
+ * @returns The input string converted to kebab case.
+ */
 declare function toKebabCase(str: string): string;
 
 export { capitalize, capitalizeWords, chunk, debounce, get, groupBy, isEmptyObject, omit, pick, toCamelCase, toKebabCase, unique, uniqueBy };

package/dist/index.js.map

@@ -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/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"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","debounce","fn","delay","timeout","args","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase"],"mappings":"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","file":"index.js","sourcesContent":["export 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","export function unique<T>(array: T[]): T[] {\r\n  return [...new Set(array)];\r\n}\r\n","export 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","export 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","export 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","export function isEmptyObject(obj: Record<PropertyKey, unknown>): boolean {\r\n  return Object.keys(obj).length === 0;\r\n}\r\n","export 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","export 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","export 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","export function capitalize(str: string): string {\r\n  if (!str) return \"\";\r\n  return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n","export 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","export 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","export 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"]}
+{"version":3,"sources":["../src/array/chunk.ts","../src/array/unique.ts","../src/array/uniqueBy.ts","../src/array/groupBy.ts","../src/function/debounce.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"],"names":["chunk","arr","size","result","i","unique","array","uniqueBy","key","seen","item","value","groupBy","acc","groupKey","debounce","fn","delay","timeout","args","isEmptyObject","obj","pick","keys","omit","get","path","defaultValue","capitalize","str","capitalizeWords","word","toCamelCase","_","char","match","toKebabCase"],"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 * 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titocandradev/neatcore",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "private": false,
   "description": "A clean, zero-dependency, TypeScript-first utility core.",
   "homepage": "https://github.com/tcandra24/neat-core#readme",