zakir-core 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# @zakir/core
+
+Zero-dependency core utility library.
+
+## Install
+```bash
+npm i @zakir/core

package/dist/array.d.ts

@@ -0,0 +1,2 @@
+export declare function unique<T>(arr: T[]): T[];
+export declare function chunk<T>(arr: T[], size: number): T[][];

package/dist/array.js

@@ -0,0 +1,10 @@
+export function unique(arr) {
+    return Array.from(new Set(arr));
+}
+export function chunk(arr, size) {
+    const res = [];
+    for (let i = 0; i < arr.length; i += size) {
+        res.push(arr.slice(i, i + size));
+    }
+    return res;
+}

package/dist/function.d.ts

@@ -0,0 +1,2 @@
+export declare function debounce<T extends (...args: any[]) => void>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+export declare function throttle<T extends (...args: any[]) => void>(fn: T, delay?: number): (...args: Parameters<T>) => void;

package/dist/function.js

@@ -0,0 +1,17 @@
+export function debounce(fn, delay = 300) {
+    let timer;
+    return (...args) => {
+        clearTimeout(timer);
+        timer = setTimeout(() => fn(...args), delay);
+    };
+}
+export function throttle(fn, delay = 300) {
+    let last = 0;
+    return (...args) => {
+        const now = Date.now();
+        if (now - last >= delay) {
+            last = now;
+            fn(...args);
+        }
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./object";
+export * from "./function";
+export * from "./string";
+export * from "./number";
+export * from "./time";
+export * from "./array";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./object";
+export * from "./function";
+export * from "./string";
+export * from "./number";
+export * from "./time";
+export * from "./array";

package/dist/number.d.ts

@@ -0,0 +1,2 @@
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function random(min?: number, max?: number): number;

package/dist/number.js

@@ -0,0 +1,6 @@
+export function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+export function random(min = 0, max = 1) {
+    return Math.random() * (max - min) + min;
+}

package/dist/object.d.ts

@@ -0,0 +1,3 @@
+export declare function deepClone<T>(value: T): T;
+export declare function isEmpty(value: any): boolean;
+export declare function merge<T extends object, U extends object>(target: T, source: U): T & U;

package/dist/object.js

@@ -0,0 +1,32 @@
+export function deepClone(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value)) {
+        return value.map(deepClone);
+    }
+    const result = {};
+    for (const key in value) {
+        result[key] = deepClone(value[key]);
+    }
+    return result;
+}
+export function isEmpty(value) {
+    if (value == null)
+        return true;
+    if (Array.isArray(value) || typeof value === "string")
+        return value.length === 0;
+    if (typeof value === "object")
+        return Object.keys(value).length === 0;
+    return false;
+}
+export function merge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        const val = source[key];
+        result[key] =
+            typeof val === "object" && !Array.isArray(val)
+                ? merge(target[key] || {}, val)
+                : val;
+    }
+    return result;
+}

package/dist/string.d.ts

@@ -0,0 +1,2 @@
+export declare function uuid(): string;
+export declare function capitalize(str: string): string;

package/dist/string.js

@@ -0,0 +1,8 @@
+export function uuid() {
+    return crypto.randomUUID();
+}
+export function capitalize(str) {
+    if (!str)
+        return str;
+    return str[0].toUpperCase() + str.slice(1);
+}

package/dist/test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test.js

@@ -0,0 +1,16 @@
+import { deepClone, isEmpty, merge } from "./index";
+// deepClone
+const original = { a: 1, b: { c: 2 } };
+const cloned = deepClone(original);
+cloned.b.c = 99;
+console.log(original.b.c); // 2
+console.log(cloned.b.c); // 99
+// isEmpty
+console.log(isEmpty([])); // true
+console.log(isEmpty({})); // true
+console.log(isEmpty("")); // true
+console.log(isEmpty(null)); // true
+console.log(isEmpty({ a: 1 })); // false
+// merge
+const merged = merge({ a: 1, b: { c: 2 } }, { b: { d: 3 } });
+console.log(merged);

package/dist/time.d.ts

@@ -0,0 +1 @@
+export declare function sleep(ms: number): Promise<void>;

package/dist/time.js

@@ -0,0 +1,3 @@
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "zakir-core",
+  "version": "0.1.0",
+  "description": "Core utility functions – zero dependency",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "utils",
+    "core",
+    "vanilla-js"
+  ],
+  "author": "Zakir",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}