my-awesome-utils-ufeek 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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

@@ -0,0 +1,71 @@
+# my-awesome-utils
+
+A simple collection of useful utility functions for JavaScript/TypeScript projects.
+
+## Installation
+
+```bash
+npm install my-awesome-utils
+```
+
+## Usage
+
+```typescript
+import { capitalize, slugify, formatRupiah, chunk, isEmpty } from "my-awesome-utils";
+
+// String utilities
+capitalize("hello");          // "Hello"
+slugify("Hello World!");      // "hello-world"
+
+// Number utilities
+formatRupiah(50000);          // "Rp 50.000"
+
+// Array utilities
+chunk([1, 2, 3, 4, 5], 2);   // [[1,2], [3,4], [5]]
+
+// Object utilities
+isEmpty({});                  // true
+isEmpty("  ");                // true
+```
+
+## API Reference
+
+### String Utilities
+
+| Function | Description |
+|----------|-------------|
+| `capitalize(str)` | Capitalize the first letter of a string |
+| `slugify(str)` | Convert a string to URL-friendly slug format |
+| `truncate(str, maxLength, suffix?)` | Truncate a string with ellipsis |
+| `randomString(length?)` | Generate a random alphanumeric string |
+
+### Number Utilities
+
+| Function | Description |
+|----------|-------------|
+| `clamp(value, min, max)` | Clamp a number between min and max |
+| `randomInt(min, max)` | Generate a random integer (inclusive) |
+| `formatRupiah(amount)` | Format number to Indonesian Rupiah |
+| `percentage(value, total)` | Calculate percentage |
+
+### Array Utilities
+
+| Function | Description |
+|----------|-------------|
+| `shuffle(array)` | Shuffle an array (Fisher-Yates) |
+| `unique(array)` | Get unique values from an array |
+| `chunk(array, size)` | Split array into chunks |
+| `groupBy(array, keyFn)` | Group array items by a key function |
+
+### Object Utilities
+
+| Function | Description |
+|----------|-------------|
+| `deepClone(obj)` | Deep clone an object |
+| `pick(obj, keys)` | Pick specific keys from an object |
+| `omit(obj, keys)` | Omit specific keys from an object |
+| `isEmpty(value)` | Check if a value is empty |
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,74 @@
+/**
+ * Capitalize the first letter of a string
+ */
+declare function capitalize(str: string): string;
+/**
+ * Convert a string to slug format (URL-friendly)
+ * @example slugify("Hello World!") => "hello-world"
+ */
+declare function slugify(str: string): string;
+/**
+ * Truncate a string to a specified length and append ellipsis
+ */
+declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * Generate a random string with given length
+ */
+declare function randomString(length?: number): string;
+
+/**
+ * Clamp a number between a minimum and maximum value
+ */
+declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Generate a random integer between min and max (inclusive)
+ */
+declare function randomInt(min: number, max: number): number;
+/**
+ * Format a number to Indonesian Rupiah currency
+ * @example formatRupiah(50000) => "Rp 50.000"
+ */
+declare function formatRupiah(amount: number): string;
+/**
+ * Calculate percentage of a value
+ */
+declare function percentage(value: number, total: number): number;
+
+/**
+ * Shuffle an array using Fisher-Yates algorithm
+ */
+declare function shuffle<T>(array: T[]): T[];
+/**
+ * Get unique values from an array
+ */
+declare function unique<T>(array: T[]): T[];
+/**
+ * Chunk an array into smaller arrays of a specified size
+ * @example chunk([1,2,3,4,5], 2) => [[1,2],[3,4],[5]]
+ */
+declare function chunk<T>(array: T[], size: number): T[][];
+/**
+ * Group array items by a key function
+ */
+declare function groupBy<T>(array: T[], keyFn: (item: T) => string): Record<string, T[]>;
+
+/**
+ * Deep clone an object (structured clone)
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Pick specific keys from an object
+ * @example pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) => { a: 1, c: 3 }
+ */
+declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Omit specific keys from an object
+ * @example omit({ a: 1, b: 2, c: 3 }, ['b']) => { a: 1, c: 3 }
+ */
+declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * Check if a value is empty (null, undefined, empty string, empty array, empty object)
+ */
+declare function isEmpty(value: unknown): boolean;
+
+export { capitalize, chunk, clamp, deepClone, formatRupiah, groupBy, isEmpty, omit, percentage, pick, randomInt, randomString, shuffle, slugify, truncate, unique };

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Capitalize the first letter of a string
+ */
+declare function capitalize(str: string): string;
+/**
+ * Convert a string to slug format (URL-friendly)
+ * @example slugify("Hello World!") => "hello-world"
+ */
+declare function slugify(str: string): string;
+/**
+ * Truncate a string to a specified length and append ellipsis
+ */
+declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * Generate a random string with given length
+ */
+declare function randomString(length?: number): string;
+
+/**
+ * Clamp a number between a minimum and maximum value
+ */
+declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Generate a random integer between min and max (inclusive)
+ */
+declare function randomInt(min: number, max: number): number;
+/**
+ * Format a number to Indonesian Rupiah currency
+ * @example formatRupiah(50000) => "Rp 50.000"
+ */
+declare function formatRupiah(amount: number): string;
+/**
+ * Calculate percentage of a value
+ */
+declare function percentage(value: number, total: number): number;
+
+/**
+ * Shuffle an array using Fisher-Yates algorithm
+ */
+declare function shuffle<T>(array: T[]): T[];
+/**
+ * Get unique values from an array
+ */
+declare function unique<T>(array: T[]): T[];
+/**
+ * Chunk an array into smaller arrays of a specified size
+ * @example chunk([1,2,3,4,5], 2) => [[1,2],[3,4],[5]]
+ */
+declare function chunk<T>(array: T[], size: number): T[][];
+/**
+ * Group array items by a key function
+ */
+declare function groupBy<T>(array: T[], keyFn: (item: T) => string): Record<string, T[]>;
+
+/**
+ * Deep clone an object (structured clone)
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Pick specific keys from an object
+ * @example pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) => { a: 1, c: 3 }
+ */
+declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Omit specific keys from an object
+ * @example omit({ a: 1, b: 2, c: 3 }, ['b']) => { a: 1, c: 3 }
+ */
+declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * Check if a value is empty (null, undefined, empty string, empty array, empty object)
+ */
+declare function isEmpty(value: unknown): boolean;
+
+export { capitalize, chunk, clamp, deepClone, formatRupiah, groupBy, isEmpty, omit, percentage, pick, randomInt, randomString, shuffle, slugify, truncate, unique };

package/dist/index.js

@@ -0,0 +1,157 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  capitalize: () => capitalize,
+  chunk: () => chunk,
+  clamp: () => clamp,
+  deepClone: () => deepClone,
+  formatRupiah: () => formatRupiah,
+  groupBy: () => groupBy,
+  isEmpty: () => isEmpty,
+  omit: () => omit,
+  percentage: () => percentage,
+  pick: () => pick,
+  randomInt: () => randomInt,
+  randomString: () => randomString,
+  shuffle: () => shuffle,
+  slugify: () => slugify,
+  truncate: () => truncate,
+  unique: () => unique
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/string.ts
+function capitalize(str) {
+  if (!str) return str;
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function slugify(str) {
+  return str.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function truncate(str, maxLength, suffix = "...") {
+  if (str.length <= maxLength) return str;
+  return str.slice(0, maxLength - suffix.length) + suffix;
+}
+function randomString(length = 8) {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length));
+  }
+  return result;
+}
+
+// src/number.ts
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function randomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function formatRupiah(amount) {
+  return "Rp " + amount.toFixed(0).replace(/\B(?=(\d{3})+(?!\d))/g, ".");
+}
+function percentage(value, total) {
+  if (total === 0) return 0;
+  return value / total * 100;
+}
+
+// src/array.ts
+function shuffle(array) {
+  const result = [...array];
+  for (let i = result.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [result[i], result[j]] = [result[j], result[i]];
+  }
+  return result;
+}
+function unique(array) {
+  return [...new Set(array)];
+}
+function chunk(array, size) {
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+function groupBy(array, keyFn) {
+  return array.reduce(
+    (result, item) => {
+      const key = keyFn(item);
+      if (!result[key]) {
+        result[key] = [];
+      }
+      result[key].push(item);
+      return result;
+    },
+    {}
+  );
+}
+
+// src/object.ts
+function deepClone(obj) {
+  return JSON.parse(JSON.stringify(obj));
+}
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+function omit(obj, keys) {
+  const result = { ...obj };
+  for (const key of keys) {
+    delete result[key];
+  }
+  return result;
+}
+function isEmpty(value) {
+  if (value == null) return true;
+  if (typeof value === "string") return value.trim().length === 0;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === "object") return Object.keys(value).length === 0;
+  return false;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  capitalize,
+  chunk,
+  clamp,
+  deepClone,
+  formatRupiah,
+  groupBy,
+  isEmpty,
+  omit,
+  percentage,
+  pick,
+  randomInt,
+  randomString,
+  shuffle,
+  slugify,
+  truncate,
+  unique
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/string.ts","../src/number.ts","../src/array.ts","../src/object.ts"],"sourcesContent":["// String utilities\nexport { capitalize, slugify, truncate, randomString } from \"./string\";\n\n// Number utilities\nexport { clamp, randomInt, formatRupiah, percentage } from \"./number\";\n\n// Array utilities\nexport { shuffle, unique, chunk, groupBy } from \"./array\";\n\n// Object utilities\nexport { deepClone, pick, omit, isEmpty } from \"./object\";\n","/**\n * Capitalize the first letter of a string\n */\nexport function capitalize(str: string): string {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Convert a string to slug format (URL-friendly)\n * @example slugify(\"Hello World!\") => \"hello-world\"\n */\nexport function slugify(str: string): string {\n  return str\n    .toLowerCase()\n    .trim()\n    .replace(/[^\\w\\s-]/g, \"\")\n    .replace(/[\\s_]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\n/**\n * Truncate a string to a specified length and append ellipsis\n */\nexport function truncate(str: string, maxLength: number, suffix = \"...\"): string {\n  if (str.length <= maxLength) return str;\n  return str.slice(0, maxLength - suffix.length) + suffix;\n}\n\n/**\n * Generate a random string with given length\n */\nexport function randomString(length: number = 8): string {\n  const chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n","/**\n * Clamp a number between a minimum and maximum value\n */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\n/**\n * Generate a random integer between min and max (inclusive)\n */\nexport function randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/**\n * Format a number to Indonesian Rupiah currency\n * @example formatRupiah(50000) => \"Rp 50.000\"\n */\nexport function formatRupiah(amount: number): string {\n  return \"Rp \" + amount.toFixed(0).replace(/\\B(?=(\\d{3})+(?!\\d))/g, \".\");\n}\n\n/**\n * Calculate percentage of a value\n */\nexport function percentage(value: number, total: number): number {\n  if (total === 0) return 0;\n  return (value / total) * 100;\n}\n","/**\n * Shuffle an array using Fisher-Yates algorithm\n */\nexport function shuffle<T>(array: T[]): T[] {\n  const result = [...array];\n  for (let i = result.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [result[i], result[j]] = [result[j], result[i]];\n  }\n  return result;\n}\n\n/**\n * Get unique values from an array\n */\nexport function unique<T>(array: T[]): T[] {\n  return [...new Set(array)];\n}\n\n/**\n * Chunk an array into smaller arrays of a specified size\n * @example chunk([1,2,3,4,5], 2) => [[1,2],[3,4],[5]]\n */\nexport function chunk<T>(array: T[], size: number): T[][] {\n  const result: T[][] = [];\n  for (let i = 0; i < array.length; i += size) {\n    result.push(array.slice(i, i + size));\n  }\n  return result;\n}\n\n/**\n * Group array items by a key function\n */\nexport function groupBy<T>(array: T[], keyFn: (item: T) => string): Record<string, T[]> {\n  return array.reduce(\n    (result, item) => {\n      const key = keyFn(item);\n      if (!result[key]) {\n        result[key] = [];\n      }\n      result[key].push(item);\n      return result;\n    },\n    {} as Record<string, T[]>\n  );\n}\n","/**\n * Deep clone an object (structured clone)\n */\nexport function deepClone<T>(obj: T): T {\n  return JSON.parse(JSON.stringify(obj));\n}\n\n/**\n * Pick specific keys from an object\n * @example pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) => { a: 1, c: 3 }\n */\nexport function pick<T extends Record<string, unknown>, K extends keyof T>(\n  obj: T,\n  keys: K[]\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) {\n    if (key in obj) {\n      result[key] = obj[key];\n    }\n  }\n  return result;\n}\n\n/**\n * Omit specific keys from an object\n * @example omit({ a: 1, b: 2, c: 3 }, ['b']) => { a: 1, c: 3 }\n */\nexport function omit<T extends Record<string, unknown>, K extends keyof T>(\n  obj: T,\n  keys: K[]\n): Omit<T, K> {\n  const result = { ...obj };\n  for (const key of keys) {\n    delete result[key];\n  }\n  return result as Omit<T, K>;\n}\n\n/**\n * Check if a value is empty (null, undefined, empty string, empty array, empty object)\n */\nexport function isEmpty(value: unknown): boolean {\n  if (value == null) return true;\n  if (typeof value === \"string\") return value.trim().length === 0;\n  if (Array.isArray(value)) return value.length === 0;\n  if (typeof value === \"object\") return Object.keys(value as object).length === 0;\n  return false;\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,115 @@
+// src/string.ts
+function capitalize(str) {
+  if (!str) return str;
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function slugify(str) {
+  return str.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function truncate(str, maxLength, suffix = "...") {
+  if (str.length <= maxLength) return str;
+  return str.slice(0, maxLength - suffix.length) + suffix;
+}
+function randomString(length = 8) {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length));
+  }
+  return result;
+}
+
+// src/number.ts
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function randomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function formatRupiah(amount) {
+  return "Rp " + amount.toFixed(0).replace(/\B(?=(\d{3})+(?!\d))/g, ".");
+}
+function percentage(value, total) {
+  if (total === 0) return 0;
+  return value / total * 100;
+}
+
+// src/array.ts
+function shuffle(array) {
+  const result = [...array];
+  for (let i = result.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [result[i], result[j]] = [result[j], result[i]];
+  }
+  return result;
+}
+function unique(array) {
+  return [...new Set(array)];
+}
+function chunk(array, size) {
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+function groupBy(array, keyFn) {
+  return array.reduce(
+    (result, item) => {
+      const key = keyFn(item);
+      if (!result[key]) {
+        result[key] = [];
+      }
+      result[key].push(item);
+      return result;
+    },
+    {}
+  );
+}
+
+// src/object.ts
+function deepClone(obj) {
+  return JSON.parse(JSON.stringify(obj));
+}
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+function omit(obj, keys) {
+  const result = { ...obj };
+  for (const key of keys) {
+    delete result[key];
+  }
+  return result;
+}
+function isEmpty(value) {
+  if (value == null) return true;
+  if (typeof value === "string") return value.trim().length === 0;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === "object") return Object.keys(value).length === 0;
+  return false;
+}
+export {
+  capitalize,
+  chunk,
+  clamp,
+  deepClone,
+  formatRupiah,
+  groupBy,
+  isEmpty,
+  omit,
+  percentage,
+  pick,
+  randomInt,
+  randomString,
+  shuffle,
+  slugify,
+  truncate,
+  unique
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/string.ts","../src/number.ts","../src/array.ts","../src/object.ts"],"sourcesContent":["/**\n * Capitalize the first letter of a string\n */\nexport function capitalize(str: string): string {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Convert a string to slug format (URL-friendly)\n * @example slugify(\"Hello World!\") => \"hello-world\"\n */\nexport function slugify(str: string): string {\n  return str\n    .toLowerCase()\n    .trim()\n    .replace(/[^\\w\\s-]/g, \"\")\n    .replace(/[\\s_]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\n/**\n * Truncate a string to a specified length and append ellipsis\n */\nexport function truncate(str: string, maxLength: number, suffix = \"...\"): string {\n  if (str.length <= maxLength) return str;\n  return str.slice(0, maxLength - suffix.length) + suffix;\n}\n\n/**\n * Generate a random string with given length\n */\nexport function randomString(length: number = 8): string {\n  const chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n","/**\n * Clamp a number between a minimum and maximum value\n */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\n/**\n * Generate a random integer between min and max (inclusive)\n */\nexport function randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/**\n * Format a number to Indonesian Rupiah currency\n * @example formatRupiah(50000) => \"Rp 50.000\"\n */\nexport function formatRupiah(amount: number): string {\n  return \"Rp \" + amount.toFixed(0).replace(/\\B(?=(\\d{3})+(?!\\d))/g, \".\");\n}\n\n/**\n * Calculate percentage of a value\n */\nexport function percentage(value: number, total: number): number {\n  if (total === 0) return 0;\n  return (value / total) * 100;\n}\n","/**\n * Shuffle an array using Fisher-Yates algorithm\n */\nexport function shuffle<T>(array: T[]): T[] {\n  const result = [...array];\n  for (let i = result.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [result[i], result[j]] = [result[j], result[i]];\n  }\n  return result;\n}\n\n/**\n * Get unique values from an array\n */\nexport function unique<T>(array: T[]): T[] {\n  return [...new Set(array)];\n}\n\n/**\n * Chunk an array into smaller arrays of a specified size\n * @example chunk([1,2,3,4,5], 2) => [[1,2],[3,4],[5]]\n */\nexport function chunk<T>(array: T[], size: number): T[][] {\n  const result: T[][] = [];\n  for (let i = 0; i < array.length; i += size) {\n    result.push(array.slice(i, i + size));\n  }\n  return result;\n}\n\n/**\n * Group array items by a key function\n */\nexport function groupBy<T>(array: T[], keyFn: (item: T) => string): Record<string, T[]> {\n  return array.reduce(\n    (result, item) => {\n      const key = keyFn(item);\n      if (!result[key]) {\n        result[key] = [];\n      }\n      result[key].push(item);\n      return result;\n    },\n    {} as Record<string, T[]>\n  );\n}\n","/**\n * Deep clone an object (structured clone)\n */\nexport function deepClone<T>(obj: T): T {\n  return JSON.parse(JSON.stringify(obj));\n}\n\n/**\n * Pick specific keys from an object\n * @example pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) => { a: 1, c: 3 }\n */\nexport function pick<T extends Record<string, unknown>, K extends keyof T>(\n  obj: T,\n  keys: K[]\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) {\n    if (key in obj) {\n      result[key] = obj[key];\n    }\n  }\n  return result;\n}\n\n/**\n * Omit specific keys from an object\n * @example omit({ a: 1, b: 2, c: 3 }, ['b']) => { a: 1, c: 3 }\n */\nexport function omit<T extends Record<string, unknown>, K extends keyof T>(\n  obj: T,\n  keys: K[]\n): Omit<T, K> {\n  const result = { ...obj };\n  for (const key of keys) {\n    delete result[key];\n  }\n  return result as Omit<T, K>;\n}\n\n/**\n * Check if a value is empty (null, undefined, empty string, empty array, empty object)\n */\nexport function isEmpty(value: unknown): boolean {\n  if (value == null) return true;\n  if (typeof value === \"string\") return value.trim().length === 0;\n  if (Array.isArray(value)) return value.length === 0;\n  if (typeof value === \"object\") return Object.keys(value as object).length === 0;\n  return false;\n}\n"],"mappings":";AAGO,SAAS,WAAW,KAAqB;AAC9C,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC;AAClD;AAMO,SAAS,QAAQ,KAAqB;AAC3C,SAAO,IACJ,YAAY,EACZ,KAAK,EACL,QAAQ,aAAa,EAAE,EACvB,QAAQ,WAAW,GAAG,EACtB,QAAQ,YAAY,EAAE;AAC3B;AAKO,SAAS,SAAS,KAAa,WAAmB,SAAS,OAAe;AAC/E,MAAI,IAAI,UAAU,UAAW,QAAO;AACpC,SAAO,IAAI,MAAM,GAAG,YAAY,OAAO,MAAM,IAAI;AACnD;AAKO,SAAS,aAAa,SAAiB,GAAW;AACvD,QAAM,QAAQ;AACd,MAAI,SAAS;AACb,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,cAAU,MAAM,OAAO,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,CAAC;AAAA,EACjE;AACA,SAAO;AACT;;;ACpCO,SAAS,MAAM,OAAe,KAAa,KAAqB;AACrE,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,GAAG,GAAG,GAAG;AAC3C;AAKO,SAAS,UAAU,KAAa,KAAqB;AAC1D,SAAO,KAAK,MAAM,KAAK,OAAO,KAAK,MAAM,MAAM,EAAE,IAAI;AACvD;AAMO,SAAS,aAAa,QAAwB;AACnD,SAAO,QAAQ,OAAO,QAAQ,CAAC,EAAE,QAAQ,yBAAyB,GAAG;AACvE;AAKO,SAAS,WAAW,OAAe,OAAuB;AAC/D,MAAI,UAAU,EAAG,QAAO;AACxB,SAAQ,QAAQ,QAAS;AAC3B;;;ACzBO,SAAS,QAAW,OAAiB;AAC1C,QAAM,SAAS,CAAC,GAAG,KAAK;AACxB,WAAS,IAAI,OAAO,SAAS,GAAG,IAAI,GAAG,KAAK;AAC1C,UAAM,IAAI,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,EAAE;AAC5C,KAAC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AAAA,EAChD;AACA,SAAO;AACT;AAKO,SAAS,OAAU,OAAiB;AACzC,SAAO,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC;AAC3B;AAMO,SAAS,MAAS,OAAY,MAAqB;AACxD,QAAM,SAAgB,CAAC;AACvB,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,MAAM;AAC3C,WAAO,KAAK,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC;AAAA,EACtC;AACA,SAAO;AACT;AAKO,SAAS,QAAW,OAAY,OAAiD;AACtF,SAAO,MAAM;AAAA,IACX,CAAC,QAAQ,SAAS;AAChB,YAAM,MAAM,MAAM,IAAI;AACtB,UAAI,CAAC,OAAO,GAAG,GAAG;AAChB,eAAO,GAAG,IAAI,CAAC;AAAA,MACjB;AACA,aAAO,GAAG,EAAE,KAAK,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IACA,CAAC;AAAA,EACH;AACF;;;AC3CO,SAAS,UAAa,KAAW;AACtC,SAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AACvC;AAMO,SAAS,KACd,KACA,MACY;AACZ,QAAM,SAAS,CAAC;AAChB,aAAW,OAAO,MAAM;AACtB,QAAI,OAAO,KAAK;AACd,aAAO,GAAG,IAAI,IAAI,GAAG;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AACT;AAMO,SAAS,KACd,KACA,MACY;AACZ,QAAM,SAAS,EAAE,GAAG,IAAI;AACxB,aAAW,OAAO,MAAM;AACtB,WAAO,OAAO,GAAG;AAAA,EACnB;AACA,SAAO;AACT;AAKO,SAAS,QAAQ,OAAyB;AAC/C,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO,MAAM,KAAK,EAAE,WAAW;AAC9D,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,WAAW;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK,KAAe,EAAE,WAAW;AAC9E,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "my-awesome-utils-ufeek",
+  "version": "1.0.0",
+  "description": "A simple collection of useful utility functions",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "utils",
+    "utility",
+    "helpers",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}