@myusufazmi/ultimate-tools 1.0.0 → 1.1.1

package/README.md

@@ -1,52 +1,147 @@
-# Ultimate JS Tools
+# 🚀 @myusufazmi/ultimate-tools
 
-A lightweight, high-performance, and modular JavaScript utility library designed for modern web applications. No external dependencies.
+A premium, lightweight, and modern JavaScript utility library designed for high-performance web development. Zero dependencies, pure ESM, and built for speed.
 
-## Modules
+[![npm version](https://img.shields.io/npm/v/@myusufazmi/ultimate-tools.svg?style=flat-square)](https://www.npmjs.com/package/@myusufazmi/ultimate-tools)
+[![license](https://img.shields.io/npm/l/@myusufazmi/ultimate-tools.svg?style=flat-square)](https://github.com/myusufazmi/ultimate-tools/blob/main/LICENSE)
 
-### DOM Utilities (`dom.js`)
+---
 
-- `$(selector, context)`: Fast query selector.
-- `$$(selector, context)`: Query selector all returning an array.
-- `create(tag, options)`: Advanced element creation.
-- `on(parent, event, selector, handler)`: Efficient event delegation.
+## 📦 Installation
 
-### HTTP Utilities (`http.js`)
+```bash
+npm install @myusufazmi/ultimate-tools
+```
+
+---
+
+## 🛠 Modules & API Reference
+
+### 🏗 DOM Utilities
+
+Performance-oriented DOM manipulation with event delegation.
+
+```javascript
+import { $, $$, create, on } from "@myusufazmi/ultimate-tools";
+```
+
+- **`$(selector, context = document)`**: Returns a single element.
+- **`$$(selector, context = document)`**: Returns an **array** of elements.
+- **`create(tag, options)`**: Create complex elements declaratively.
+- **`on(parent, event, selector, handler)`**: High-performance event delegation.
 
-- `http.get(url, options)`
-- `http.post(url, body, options)`
-- `http.put(url, body, options)`
-- `http.delete(url, options)`
-- Supports JSON by default and interceptors.
+---
 
-### Storage Utilities (`storage.js`)
+### 🌐 HTTP Wrapper
 
-- `local.set(key, value)`, `local.get(key, fallback)`
-- `session.set(key, value)`, `session.get(key, fallback)`
-- Auto-serialization/deserialization for all data types.
+A clean, promise-based wrapper for the Fetch API with JSON support by default.
 
-### State Management (`state.js`)
+```javascript
+import { http } from "@myusufazmi/ultimate-tools";
+```
 
-- `createStore(initialValue)`: Reactive state management with `subscribe`, `update`, and `get`.
+- **`http.get(url, options)`**
+- **`http.post(url, body, options)`**
+- **`http.put(url, body, options)`**
+- **`http.delete(url, options)`**
 
-### General Utilities (`utils.js`)
+---
 
-- `debounce(fn, delay)`
-- `throttle(fn, limit)`
-- `deepClone(obj)`
-- `uuid()`: Simple unique ID generator.
+### 📅 Date Utilities (NEW v1.1.0)
 
-## Usage
+Simple and efficient date formatting and manipulation.
 
 ```javascript
-import { $, on, createStore } from "./src/index.js";
+import { formatDate, relativeTime, addDays } from "@myusufazmi/ultimate-tools";
+
+formatDate(new Date(), "YYYY-MM-DD HH:mm:ss"); // "2026-02-09 11:58:39"
+relativeTime(new Date(Date.now() - 3600000)); // "1 hours ago"
+addDays(new Date(), 7); // Date object + 7 days
+```
+
+---
+
+### 💎 Formatting Utilities (NEW v1.1.0)
+
+Tools for number, currency, and string formatting.
+
+```javascript
+import {
+  currency,
+  number,
+  slugify,
+  truncate,
+} from "@myusufazmi/ultimate-tools";
+
+currency(50000); // "Rp 50.000,00" (default id-ID)
+number(1234.56, 1); // "1.234,6"
+slugify("Halo Dunia!"); // "halo-dunia"
+truncate("Teks yang sangat panjang sekali", 10); // "Teks yang..."
+```
+
+---
+
+### 🛡 Validation Utilities (NEW v1.1.0)
+
+Common regex-based validation helpers.
+
+```javascript
+import { isEmail, isStrongPassword, isEmpty } from "@myusufazmi/ultimate-tools";
+
+isEmail("test@example.com"); // true
+isStrongPassword("Pass123"); // false (too short)
+isEmpty("   "); // true
+```
+
+---
+
+### 💾 Storage Management
+
+Type-safe and auto-serialized storage for persistent data.
+
+```javascript
+import { local, session } from "@myusufazmi/ultimate-tools";
+```
+
+- **`local.set(key, value)`** / **`session.set(key, value)`**
+- **`local.get(key, fallback)`** / **`session.get(key, fallback)`**
+
+---
+
+### 🔄 State Management
+
+A tiny ( < 1KB) reactive state manager.
+
+```javascript
+import { createStore } from "@myusufazmi/ultimate-tools";
 
 const count = createStore(0);
-count.subscribe((val) => console.log("Count:", val));
+count.subscribe((val) => console.log(val));
+count.update((n) => n + 1);
+```
+
+---
 
-on(document, "click", "#btn", () => count.update((n) => n + 1));
+### ⚡ General Utilities
+
+Essential helpers for common logic patterns.
+
+```javascript
+import {
+  debounce,
+  throttle,
+  deepClone,
+  uuid,
+} from "@myusufazmi/ultimate-tools";
 ```
 
-## Demo
+- **`debounce(fn, delay)`**
+- **`throttle(fn, limit)`**
+- **`deepClone(obj)`**
+- **`uuid()`**
+
+---
+
+## 📜 License
 
-Open `examples/index.html` in your browser to see the tools in action.
+ISC © 2026 [myusufazmi](https://github.com/myusufazmi)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myusufazmi/ultimate-tools",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Modern JS utility library for high-performance projects",
   "main": "src/index.js",
   "module": "src/index.js",

package/src/date.js

@@ -0,0 +1,70 @@
+/**
+ * Date Utilities
+ * Simple and efficient date formatting and manipulation.
+ */
+
+/**
+ * Basic Date Formatter
+ * @param {Date|string|number} date
+ * @param {string} pattern - Default: 'YYYY-MM-DD'
+ * @returns {string}
+ */
+export const formatDate = (date, pattern = "YYYY-MM-DD") => {
+  const d = new Date(date);
+  if (isNaN(d.getTime())) return "Invalid Date";
+
+  const map = {
+    YYYY: d.getFullYear(),
+    MM: String(d.getMonth() + 1).padStart(2, "0"),
+    DD: String(d.getDate()).padStart(2, "0"),
+    HH: String(d.getHours()).padStart(2, "0"),
+    mm: String(d.getMinutes()).padStart(2, "0"),
+    ss: String(d.getSeconds()).padStart(2, "0"),
+  };
+
+  return pattern.replace(/YYYY|MM|DD|HH|mm|ss/g, (matched) => map[matched]);
+};
+
+/**
+ * Returns a human-readable relative time (e.g., "5 minutes ago")
+ * @param {Date|string|number} date
+ * @returns {string}
+ */
+export const relativeTime = (date) => {
+  const d = new Date(date);
+  const now = new Date();
+  const diff = Math.floor((now - d) / 1000);
+
+  if (diff < 60) return "just now";
+  if (diff < 3600) return `${Math.floor(diff / 60)} minutes ago`;
+  if (diff < 86400) return `${Math.floor(diff / 3600)} hours ago`;
+  if (diff < 2592000) return `${Math.floor(diff / 86400)} days ago`;
+
+  return formatDate(d);
+};
+
+/**
+ * Add days to a date
+ * @param {Date|string|number} date
+ * @param {number} days
+ * @returns {Date}
+ */
+export const addDays = (date, days) => {
+  const d = new Date(date);
+  d.setDate(d.getDate() + days);
+  return d;
+};
+
+/**
+ * Check if two dates are the same day
+ * @param {Date} d1
+ * @param {Date} d2
+ * @returns {boolean}
+ */
+export const isSameDay = (d1, d2) => {
+  return (
+    d1.getFullYear() === d2.getFullYear() &&
+    d1.getMonth() === d2.getMonth() &&
+    d1.getDate() === d2.getDate()
+  );
+};

package/src/format.js

@@ -0,0 +1,67 @@
+/**
+ * Formatting Utilities
+ * Tools for number, currency, and string formatting.
+ */
+
+/**
+ * Currency Formatter
+ * @param {number} amount
+ * @param {string} locale - Default: 'id-ID'
+ * @param {string} currency - Default: 'IDR'
+ * @returns {string}
+ */
+export const currency = (amount, locale = "id-ID", currency = "IDR") => {
+  return new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency: currency,
+  }).format(amount);
+};
+
+/**
+ * Number Formatter with decimals
+ * @param {number} n
+ * @param {number} decimals - Default: 0
+ * @returns {string}
+ */
+export const number = (n, decimals = 0) => {
+  return new Intl.NumberFormat("id-ID", {
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals,
+  }).format(n);
+};
+
+/**
+ * Truncate string with ellipsis
+ * @param {string} str
+ * @param {number} length - Default: 30
+ * @returns {string}
+ */
+export const truncate = (str, length = 30) => {
+  if (!str) return "";
+  return str.length > length ? str.substring(0, length) + "..." : str;
+};
+
+/**
+ * Convert string to slug (URL friendly)
+ * @param {string} str
+ * @returns {string}
+ */
+export const slugify = (str) => {
+  if (!str) return "";
+  return str
+    .toLowerCase()
+    .trim()
+    .replace(/[^\w\s-]/g, "")
+    .replace(/[\s_-]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+};
+
+/**
+ * Capitalize first letter of each word
+ * @param {string} str
+ * @returns {string}
+ */
+export const capitalize = (str) => {
+  if (!str) return "";
+  return str.replace(/\b\w/g, (l) => l.toUpperCase());
+};

package/src/index.js

@@ -3,3 +3,6 @@ export * from "./http.js";
 export * from "./storage.js";
 export * from "./state.js";
 export * from "./utils.js";
+export * from "./date.js";
+export * from "./format.js";
+export * from "./validation.js";

package/src/validation.js

@@ -0,0 +1,56 @@
+/**
+ * Validation Utilities
+ * Common regex-based validation helpers.
+ */
+
+/**
+ * Check if string is a valid email
+ * @param {string} str
+ * @returns {boolean}
+ */
+export const isEmail = (str) => {
+  const re = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return re.test(str);
+};
+
+/**
+ * Check if string is a valid URL
+ * @param {string} str
+ * @returns {boolean}
+ */
+export const isURL = (str) => {
+  try {
+    new URL(str);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * Check if string contains only numbers
+ * @param {string} str
+ * @returns {boolean}
+ */
+export const isNumeric = (str) => {
+  return /^\d+$/.test(str);
+};
+
+/**
+ * Check for strong password
+ * (Min 8 chars, 1 uppercase, 1 lowercase, 1 number)
+ * @param {string} str
+ * @returns {boolean}
+ */
+export const isStrongPassword = (str) => {
+  return /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{8,}$/.test(str);
+};
+
+/**
+ * Check if string is empty or only whitespace
+ * @param {string} str
+ * @returns {boolean}
+ */
+export const isEmpty = (str) => {
+  return !str || str.trim().length === 0;
+};