@ntnyq/utils 0.5.0 → 0.5.2

package/dist/index.cjs

@@ -15,26 +15,26 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  Color: () => Color,
   NOOP: () => NOOP,
   at: () => at,
   cAF: () => cAF,
-  camelCase: () => camelCase,
-  capitalize: () => capitalize,
   chunk: () => chunk,
   clamp: () => clamp,
   cleanObject: () => cleanObject,
   createPadString: () => createPadString,
   days: () => days,
   debounce: () => debounce,
+  enhance: () => enhance,
   ensurePrefix: () => ensurePrefix,
   ensureSuffix: () => ensureSuffix,
   escapeHtml: () => escapeHtml,
-  flatCase: () => flatCase,
   flattenArrayable: () => flattenArrayable,
   getObjectType: () => getObjectType,
   hasOwn: () => hasOwn,
@@ -73,36 +73,31 @@ __export(index_exports, {
   isSet: () => isSet,
   isString: () => isString,
   isUndefined: () => isUndefined,
-  isUppercase: () => isUppercase,
   isWhitespaceString: () => isWhitespaceString,
   isZero: () => isZero,
   join: () => join,
-  kebabCase: () => kebabCase,
   last: () => last,
-  lowerFirst: () => lowerFirst,
   mergeArrayable: () => mergeArrayable,
   minutes: () => minutes,
   noop: () => noop,
   omit: () => omit,
   once: () => once,
-  pascalCase: () => pascalCase,
   pick: () => pick,
   rAF: () => rAF,
+  randomHexColor: () => randomHexColor,
+  randomNumber: () => randomNumber,
+  randomRGBAColor: () => randomRGBAColor,
+  randomRGBColor: () => randomRGBColor,
   randomString: () => randomString,
   resolveSubOptions: () => resolveSubOptions,
   seconds: () => seconds,
   slash: () => slash,
-  snakeCase: () => snakeCase,
   sortObject: () => sortObject,
-  splitByCase: () => splitByCase,
   throttle: () => throttle,
-  titleCase: () => titleCase,
   toArray: () => toArray,
-  trainCase: () => trainCase,
   unindent: () => unindent,
   unique: () => unique,
   uniqueBy: () => uniqueBy,
-  upperFirst: () => upperFirst,
   waitFor: () => waitFor,
   warnOnce: () => warnOnce,
   weeks: () => weeks
@@ -116,19 +111,22 @@ function isDeepEqual(value1, value2) {
   if (type1 !== type2) {
     return false;
   }
-  if (isArray(value1)) {
+  if (isArray(value1) && isArray(value2)) {
     if (value1.length !== value2.length) {
       return false;
     }
     return value1.every((item, index) => isDeepEqual(item, value2[index]));
   }
-  if (isObject(value1)) {
+  if (isObject(value1) && isObject(value2)) {
     const keys = Object.keys(value1);
     if (keys.length !== Object.keys(value2).length) {
       return false;
     }
     return keys.every(
-      (key) => isDeepEqual(value1[key], value2[key])
+      (key) => isDeepEqual(
+        value1[key],
+        value2[key]
+      )
     );
   }
   return Object.is(value1, value2);
@@ -221,7 +219,10 @@ function isError(value) {
   return getObjectType(value) === "Error";
 }
 function hasPromiseApi(value) {
-  return isFunction(value?.then) && isFunction(value?.catch);
+  return (
+    // eslint-disable-next-line @typescript-eslint/unbound-method
+    isFunction(value?.then) && isFunction(value?.catch)
+  );
 }
 function isNativePromise(value) {
   return getObjectType(value) === "Promise";
@@ -301,7 +302,7 @@ function clamp(value, min = Number.NEGATIVE_INFINITY, max = Number.POSITIVE_INFI
 }
 
 // src/misc/waitFor.ts
-function waitFor(ms) {
+async function waitFor(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
@@ -452,7 +453,7 @@ function slash(input) {
 }
 
 // src/number/random.ts
-function randomNumber(min, max = 0) {
+function randomNumber(min, max = 0, options = {}) {
   if (max === 0) {
     max = min;
     min = 0;
@@ -461,7 +462,9 @@ function randomNumber(min, max = 0) {
     ;
     [min, max] = [max, min];
   }
-  return Math.trunc(Math.random() * (max - min + 1) + min);
+  return Math.trunc(
+    Math.random() * (max - min + (options.includeMax ? 1 : 0)) + min
+  );
 }
 
 // src/string/random.ts
@@ -506,6 +509,119 @@ function ensureSuffix(input, suffix) {
   return input.endsWith(suffix) ? input : `${input}${suffix}`;
 }
 
+// src/color/color.ts
+var pad2 = createPadString({ length: 2, char: "0" });
+var RE_VALID_HEX_COLOR = /^#(?:[0-9a-f]{6}|[0-9a-f]{3})$/i;
+function validateHexColor(hex) {
+  if (hex.length !== 4 && hex.length !== 7) return false;
+  if (!hex.startsWith("#")) return false;
+  return RE_VALID_HEX_COLOR.test(hex);
+}
+function normalizeHexString(hex) {
+  return hex.length === 6 ? hex : hex.replace(/./g, "$&$&");
+}
+var Color = class _Color {
+  constructor(red = 0, green = 0, blue = 0, alpha = 1) {
+    this.red = red;
+    this.green = green;
+    this.blue = blue;
+    this.alpha = alpha;
+  }
+  static fromRGB(red, green, blue) {
+    return new _Color(red, green, blue);
+  }
+  static fromRGBA(red, green, blue, alpha) {
+    return new _Color(red, green, blue, alpha);
+  }
+  static fromHex(hex) {
+    if (!validateHexColor(hex)) {
+      throw new Error("Invalid hex color");
+    }
+    const [red, green, blue] = normalizeHexString(hex.slice(1)).match(/.{2}/g)?.map((value) => Number.parseInt(value, 16)) ?? [0, 0, 0];
+    return new _Color(red, green, blue);
+  }
+  get brightness() {
+    return (this.red * 299 + this.green * 587 + this.blue * 114) / 1e3;
+  }
+  get isDark() {
+    return this.brightness < 128;
+  }
+  get isLight() {
+    return !this.isDark;
+  }
+  toHexString(isUpperCase = true) {
+    const hexString = `#${pad2(this.red.toString(16))}${pad2(this.green.toString(16))}${pad2(this.blue.toString(16))}`;
+    return isUpperCase ? hexString.toUpperCase() : hexString;
+  }
+  toRGBAString() {
+    return `rgba(${this.red}, ${this.green}, ${this.blue}, ${this.alpha})`;
+  }
+  /**
+   * add alpha value to {@link Color}
+   *
+   * @param alpha - alpha value
+   * @returns instance of {@link Color}
+   */
+  withAlpha(alpha = 1) {
+    return new _Color(this.red, this.green, this.blue, alpha);
+  }
+  /**
+   * lighten the color by percentage
+   *
+   * @param percentage - percentage to lighten
+   */
+  lighten(percentage = 0) {
+    const amount = Math.round(percentage / 100 * 255);
+    return new _Color(
+      Math.min(this.red + amount, 255),
+      Math.min(this.green + amount, 255),
+      Math.min(this.blue + amount, 255),
+      this.alpha
+    );
+  }
+  /**
+   * darken the color by percentage
+   *
+   * @param percentage - percentage to darken
+   */
+  darken(percentage = 0) {
+    const amount = Math.round(percentage / 100 * 255);
+    return new _Color(
+      Math.max(this.red - amount, 0),
+      Math.max(this.green - amount, 0),
+      Math.max(this.blue - amount, 0),
+      this.alpha
+    );
+  }
+};
+
+// src/color/random.ts
+var MAX_RGB = 255;
+function randomRGBColor() {
+  return `rgb(${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)})`;
+}
+function randomRGBAColor() {
+  return `rgba(${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)}, ${Math.random().toFixed(1)})`;
+}
+function randomHexColor() {
+  return `#${Math.random().toString(16).slice(2, 8)}`;
+}
+
+// src/proxy/enhance.ts
+function enhance(module2, extra) {
+  return new Proxy(module2, {
+    get(target, key, receiver) {
+      if (Reflect.has(extra, key)) {
+        return Reflect.get(extra, key, receiver);
+      }
+      return Reflect.get(target, key, receiver);
+    },
+    has(target, key) {
+      return Reflect.has(extra, key) || Reflect.has(target, key);
+    }
+  });
+}
+
 // src/object/omit.ts
 function omit(object, ...keys) {
   keys.forEach((key) => delete object[key]);
@@ -537,11 +653,11 @@ function cleanObject(obj, options = {}) {
   const {
     cleanUndefined = true,
     cleanNull = true,
-    cleanZero = false,
     cleanNaN = true,
-    cleanEmptyString = true,
-    cleanEmptyArray = true,
-    cleanEmptyObject = true,
+    cleanZero = false,
+    cleanEmptyString = false,
+    cleanEmptyArray = false,
+    cleanEmptyObject = false,
     recursive = true
   } = options;
   Object.keys(obj).forEach((key) => {
@@ -605,88 +721,18 @@ function sortObject(obj, options = {}) {
   return sortKeys(obj);
 }
 
-// node_modules/.pnpm/scule@1.3.0/node_modules/scule/dist/index.mjs
-var NUMBER_CHAR_RE = /\d/;
-var STR_SPLITTERS = ["-", "_", "/", "."];
-function isUppercase(char = "") {
-  if (NUMBER_CHAR_RE.test(char)) {
-    return void 0;
-  }
-  return char !== char.toLowerCase();
-}
-function splitByCase(str, separators) {
-  const splitters = separators ?? STR_SPLITTERS;
-  const parts = [];
-  if (!str || typeof str !== "string") {
-    return parts;
-  }
-  let buff = "";
-  let previousUpper;
-  let previousSplitter;
-  for (const char of str) {
-    const isSplitter = splitters.includes(char);
-    if (isSplitter === true) {
-      parts.push(buff);
-      buff = "";
-      previousUpper = void 0;
-      continue;
-    }
-    const isUpper = isUppercase(char);
-    if (previousSplitter === false) {
-      if (previousUpper === false && isUpper === true) {
-        parts.push(buff);
-        buff = char;
-        previousUpper = isUpper;
-        continue;
-      }
-      if (previousUpper === true && isUpper === false && buff.length > 1) {
-        const lastChar = buff.at(-1);
-        parts.push(buff.slice(0, Math.max(0, buff.length - 1)));
-        buff = lastChar + char;
-        previousUpper = isUpper;
-        continue;
-      }
-    }
-    buff += char;
-    previousUpper = isUpper;
-    previousSplitter = isSplitter;
-  }
-  parts.push(buff);
-  return parts;
-}
-function upperFirst(str) {
-  return str ? str[0].toUpperCase() + str.slice(1) : "";
-}
-function lowerFirst(str) {
-  return str ? str[0].toLowerCase() + str.slice(1) : "";
-}
-function pascalCase(str, opts) {
-  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("") : "";
-}
-function camelCase(str, opts) {
-  return lowerFirst(pascalCase(str || "", opts));
-}
-function kebabCase(str, joiner) {
-  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => p.toLowerCase()).join(joiner ?? "-") : "";
-}
-function snakeCase(str) {
-  return kebabCase(str || "", "_");
-}
-function flatCase(str) {
-  return kebabCase(str || "", "");
-}
-function trainCase(str, opts) {
-  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("-");
-}
-var titleCaseExceptions = /^(a|an|and|as|at|but|by|for|if|in|is|nor|of|on|or|the|to|with)$/i;
-function titleCase(str, opts) {
-  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map(
-    (p) => titleCaseExceptions.test(p) ? p.toLowerCase() : upperFirst(opts?.normalize ? p.toLowerCase() : p)
-  ).join(" ");
-}
+// src/vendor/index.ts
+var vendor_exports = {};
 
-// src/vendor/scule.ts
-var capitalize = upperFirst;
+// src/vendor/changeCase.ts
+var changeCase_exports = {};
+__reExport(changeCase_exports, require("change-case"));
+
+// src/vendor/index.ts
+__reExport(vendor_exports, changeCase_exports);
+
+// src/index.ts
+__reExport(index_exports, vendor_exports, module.exports);
 
 // src/module/interopDefault.ts
 async function interopDefault(mod) {
@@ -700,21 +746,20 @@ function resolveSubOptions(options, key) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  Color,
   NOOP,
   at,
   cAF,
-  camelCase,
-  capitalize,
   chunk,
   clamp,
   cleanObject,
   createPadString,
   days,
   debounce,
+  enhance,
   ensurePrefix,
   ensureSuffix,
   escapeHtml,
-  flatCase,
   flattenArrayable,
   getObjectType,
   hasOwn,
@@ -753,36 +798,31 @@ function resolveSubOptions(options, key) {
   isSet,
   isString,
   isUndefined,
-  isUppercase,
   isWhitespaceString,
   isZero,
   join,
-  kebabCase,
   last,
-  lowerFirst,
   mergeArrayable,
   minutes,
   noop,
   omit,
   once,
-  pascalCase,
   pick,
   rAF,
+  randomHexColor,
+  randomNumber,
+  randomRGBAColor,
+  randomRGBColor,
   randomString,
   resolveSubOptions,
   seconds,
   slash,
-  snakeCase,
   sortObject,
-  splitByCase,
   throttle,
-  titleCase,
   toArray,
-  trainCase,
   unindent,
   unique,
   uniqueBy,
-  upperFirst,
   waitFor,
   warnOnce,
   weeks

package/dist/index.d.cts

@@ -1,5 +1,4 @@
-import { upperFirst } from 'scule';
-export * from 'scule';
+export * from 'change-case';
 
 /**
  * check if two values are deeply equal
@@ -119,7 +118,7 @@ declare function clamp(value: number, min?: number, max?: number): number;
  * // do somthing after 3 seconds
  * ```
  */
-declare function waitFor(ms: number): Promise<unknown>;
+declare function waitFor(ms: number): Promise<void>;
 
 interface ThrottleDebounceOptions {
     /**
@@ -253,6 +252,63 @@ declare function intersect<T>(a: T[], b: T[]): T[];
 
 declare function isArrayEqual(array1: unknown[], array2: unknown[]): boolean;
 
+declare class Color {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+    constructor(red?: number, green?: number, blue?: number, alpha?: number);
+    static fromRGB(red: number, green: number, blue: number): Color;
+    static fromRGBA(red: number, green: number, blue: number, alpha: number): Color;
+    static fromHex(hex: string): Color;
+    get brightness(): number;
+    get isDark(): boolean;
+    get isLight(): boolean;
+    toHexString(isUpperCase?: boolean): string;
+    toRGBAString(): string;
+    /**
+     * add alpha value to {@link Color}
+     *
+     * @param alpha - alpha value
+     * @returns instance of {@link Color}
+     */
+    withAlpha(alpha?: number): Color;
+    /**
+     * lighten the color by percentage
+     *
+     * @param percentage - percentage to lighten
+     */
+    lighten(percentage?: number): Color;
+    /**
+     * darken the color by percentage
+     *
+     * @param percentage - percentage to darken
+     */
+    darken(percentage?: number): Color;
+}
+
+/**
+ * get a random RGB color
+ * @returns a random RGB color
+ */
+declare function randomRGBColor(): string;
+/**
+ * get a random RGBA color
+ * @returns a random RGBA color
+ */
+declare function randomRGBAColor(): string;
+/**
+ * get a random hex color
+ * @returns a random hex color
+ */
+declare function randomHexColor(): string;
+
+/**
+ * enhance object
+ * @module proxy
+ */
+declare function enhance<T extends Record<PropertyKey, any>, E extends Record<PropertyKey, any>>(module: T, extra: E): T;
+
 interface CreatePadStringOptions {
     length: number;
     char: string;
@@ -341,19 +397,19 @@ interface CleanObjectOptions {
     /**
      * clean empty string
      *
-     * @default true
+     * @default false
      */
     cleanEmptyString?: boolean;
     /**
      * clean empty array
      *
-     * @default true
+     * @default false
      */
     cleanEmptyArray?: boolean;
     /**
      * clean empty object
      *
-     * @default true
+     * @default false
      */
     cleanEmptyObject?: boolean;
     /**
@@ -395,16 +451,6 @@ interface SortObjectOptions {
  */
 declare function sortObject<T extends Record<string, any>>(obj: T, options?: SortObjectOptions): T;
 
-/**
- * @file case utils
- * @module vendor
- */
-
-/**
- * @deprecated use upperFirst instead
- */
-declare const capitalize: typeof upperFirst;
-
 /**
  * Interop default export from a module
  *
@@ -450,4 +496,21 @@ declare function interopDefault<T>(mod: Awaitable<T>): Promise<InteropModuleDefa
  */
 declare function resolveSubOptions<T extends Record<string, any>, K extends keyof T>(options: T, key: K): Partial<ResolvedOptions<T[K]>>;
 
-export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, cleanObject, createPadString, days, debounce, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, randomString, resolveSubOptions, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+interface RamdomNumberOptions {
+    /**
+     * include max value
+     *
+     * @default false
+     */
+    includeMax?: boolean;
+}
+/**
+ * random an integer by given range
+ *
+ * @param min - min value
+ * @param max - max value
+ * @returns random integer in range
+ */
+declare function randomNumber(min: number, max?: number, options?: RamdomNumberOptions): number;
+
+export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, Color, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type RamdomNumberOptions, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { upperFirst } from 'scule';
-export * from 'scule';
+export * from 'change-case';
 
 /**
  * check if two values are deeply equal
@@ -119,7 +118,7 @@ declare function clamp(value: number, min?: number, max?: number): number;
  * // do somthing after 3 seconds
  * ```
  */
-declare function waitFor(ms: number): Promise<unknown>;
+declare function waitFor(ms: number): Promise<void>;
 
 interface ThrottleDebounceOptions {
     /**
@@ -253,6 +252,63 @@ declare function intersect<T>(a: T[], b: T[]): T[];
 
 declare function isArrayEqual(array1: unknown[], array2: unknown[]): boolean;
 
+declare class Color {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+    constructor(red?: number, green?: number, blue?: number, alpha?: number);
+    static fromRGB(red: number, green: number, blue: number): Color;
+    static fromRGBA(red: number, green: number, blue: number, alpha: number): Color;
+    static fromHex(hex: string): Color;
+    get brightness(): number;
+    get isDark(): boolean;
+    get isLight(): boolean;
+    toHexString(isUpperCase?: boolean): string;
+    toRGBAString(): string;
+    /**
+     * add alpha value to {@link Color}
+     *
+     * @param alpha - alpha value
+     * @returns instance of {@link Color}
+     */
+    withAlpha(alpha?: number): Color;
+    /**
+     * lighten the color by percentage
+     *
+     * @param percentage - percentage to lighten
+     */
+    lighten(percentage?: number): Color;
+    /**
+     * darken the color by percentage
+     *
+     * @param percentage - percentage to darken
+     */
+    darken(percentage?: number): Color;
+}
+
+/**
+ * get a random RGB color
+ * @returns a random RGB color
+ */
+declare function randomRGBColor(): string;
+/**
+ * get a random RGBA color
+ * @returns a random RGBA color
+ */
+declare function randomRGBAColor(): string;
+/**
+ * get a random hex color
+ * @returns a random hex color
+ */
+declare function randomHexColor(): string;
+
+/**
+ * enhance object
+ * @module proxy
+ */
+declare function enhance<T extends Record<PropertyKey, any>, E extends Record<PropertyKey, any>>(module: T, extra: E): T;
+
 interface CreatePadStringOptions {
     length: number;
     char: string;
@@ -341,19 +397,19 @@ interface CleanObjectOptions {
     /**
      * clean empty string
      *
-     * @default true
+     * @default false
      */
     cleanEmptyString?: boolean;
     /**
      * clean empty array
      *
-     * @default true
+     * @default false
      */
     cleanEmptyArray?: boolean;
     /**
      * clean empty object
      *
-     * @default true
+     * @default false
      */
     cleanEmptyObject?: boolean;
     /**
@@ -395,16 +451,6 @@ interface SortObjectOptions {
  */
 declare function sortObject<T extends Record<string, any>>(obj: T, options?: SortObjectOptions): T;
 
-/**
- * @file case utils
- * @module vendor
- */
-
-/**
- * @deprecated use upperFirst instead
- */
-declare const capitalize: typeof upperFirst;
-
 /**
  * Interop default export from a module
  *
@@ -450,4 +496,21 @@ declare function interopDefault<T>(mod: Awaitable<T>): Promise<InteropModuleDefa
  */
 declare function resolveSubOptions<T extends Record<string, any>, K extends keyof T>(options: T, key: K): Partial<ResolvedOptions<T[K]>>;
 
-export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, cleanObject, createPadString, days, debounce, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, randomString, resolveSubOptions, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+interface RamdomNumberOptions {
+    /**
+     * include max value
+     *
+     * @default false
+     */
+    includeMax?: boolean;
+}
+/**
+ * random an integer by given range
+ *
+ * @param min - min value
+ * @param max - max value
+ * @returns random integer in range
+ */
+declare function randomNumber(min: number, max?: number, options?: RamdomNumberOptions): number;
+
+export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, Color, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type RamdomNumberOptions, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.js

@@ -1,3 +1,106 @@
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Color: () => Color,
+  NOOP: () => NOOP,
+  at: () => at,
+  cAF: () => cAF,
+  chunk: () => chunk,
+  clamp: () => clamp,
+  cleanObject: () => cleanObject,
+  createPadString: () => createPadString,
+  days: () => days,
+  debounce: () => debounce,
+  enhance: () => enhance,
+  ensurePrefix: () => ensurePrefix,
+  ensureSuffix: () => ensureSuffix,
+  escapeHtml: () => escapeHtml,
+  flattenArrayable: () => flattenArrayable,
+  getObjectType: () => getObjectType,
+  hasOwn: () => hasOwn,
+  hours: () => hours,
+  interopDefault: () => interopDefault,
+  intersect: () => intersect,
+  isArray: () => isArray,
+  isArrayEqual: () => isArrayEqual,
+  isBigInt: () => isBigInt,
+  isBoolean: () => isBoolean,
+  isBrowser: () => isBrowser,
+  isDeepEqual: () => isDeepEqual,
+  isEmptyArray: () => isEmptyArray,
+  isEmptyMap: () => isEmptyMap,
+  isEmptyObject: () => isEmptyObject,
+  isEmptySet: () => isEmptySet,
+  isEmptyString: () => isEmptyString,
+  isEmptyStringOrWhitespace: () => isEmptyStringOrWhitespace,
+  isError: () => isError,
+  isFunction: () => isFunction,
+  isInteger: () => isInteger,
+  isIterable: () => isIterable,
+  isMap: () => isMap,
+  isNaN: () => isNaN,
+  isNativePromise: () => isNativePromise,
+  isNil: () => isNil,
+  isNonEmptyArray: () => isNonEmptyArray,
+  isNonEmptyString: () => isNonEmptyString,
+  isNull: () => isNull,
+  isNullOrUndefined: () => isNullOrUndefined,
+  isNumber: () => isNumber,
+  isNumbericString: () => isNumbericString,
+  isObject: () => isObject,
+  isPromise: () => isPromise,
+  isRegExp: () => isRegExp,
+  isSet: () => isSet,
+  isString: () => isString,
+  isUndefined: () => isUndefined,
+  isWhitespaceString: () => isWhitespaceString,
+  isZero: () => isZero,
+  join: () => join,
+  last: () => last,
+  mergeArrayable: () => mergeArrayable,
+  minutes: () => minutes,
+  noop: () => noop,
+  omit: () => omit,
+  once: () => once,
+  pick: () => pick,
+  rAF: () => rAF,
+  randomHexColor: () => randomHexColor,
+  randomNumber: () => randomNumber,
+  randomRGBAColor: () => randomRGBAColor,
+  randomRGBColor: () => randomRGBColor,
+  randomString: () => randomString,
+  resolveSubOptions: () => resolveSubOptions,
+  seconds: () => seconds,
+  slash: () => slash,
+  sortObject: () => sortObject,
+  throttle: () => throttle,
+  toArray: () => toArray,
+  unindent: () => unindent,
+  unique: () => unique,
+  uniqueBy: () => uniqueBy,
+  waitFor: () => waitFor,
+  warnOnce: () => warnOnce,
+  weeks: () => weeks
+});
+
 // src/is/isDeepEqual.ts
 function isDeepEqual(value1, value2) {
   const type1 = getObjectType(value1);
@@ -5,19 +108,22 @@ function isDeepEqual(value1, value2) {
   if (type1 !== type2) {
     return false;
   }
-  if (isArray(value1)) {
+  if (isArray(value1) && isArray(value2)) {
     if (value1.length !== value2.length) {
       return false;
     }
     return value1.every((item, index) => isDeepEqual(item, value2[index]));
   }
-  if (isObject(value1)) {
+  if (isObject(value1) && isObject(value2)) {
     const keys = Object.keys(value1);
     if (keys.length !== Object.keys(value2).length) {
       return false;
     }
     return keys.every(
-      (key) => isDeepEqual(value1[key], value2[key])
+      (key) => isDeepEqual(
+        value1[key],
+        value2[key]
+      )
     );
   }
   return Object.is(value1, value2);
@@ -110,7 +216,10 @@ function isError(value) {
   return getObjectType(value) === "Error";
 }
 function hasPromiseApi(value) {
-  return isFunction(value?.then) && isFunction(value?.catch);
+  return (
+    // eslint-disable-next-line @typescript-eslint/unbound-method
+    isFunction(value?.then) && isFunction(value?.catch)
+  );
 }
 function isNativePromise(value) {
   return getObjectType(value) === "Promise";
@@ -190,7 +299,7 @@ function clamp(value, min = Number.NEGATIVE_INFINITY, max = Number.POSITIVE_INFI
 }
 
 // src/misc/waitFor.ts
-function waitFor(ms) {
+async function waitFor(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
@@ -341,7 +450,7 @@ function slash(input) {
 }
 
 // src/number/random.ts
-function randomNumber(min, max = 0) {
+function randomNumber(min, max = 0, options = {}) {
   if (max === 0) {
     max = min;
     min = 0;
@@ -350,7 +459,9 @@ function randomNumber(min, max = 0) {
     ;
     [min, max] = [max, min];
   }
-  return Math.trunc(Math.random() * (max - min + 1) + min);
+  return Math.trunc(
+    Math.random() * (max - min + (options.includeMax ? 1 : 0)) + min
+  );
 }
 
 // src/string/random.ts
@@ -395,6 +506,119 @@ function ensureSuffix(input, suffix) {
   return input.endsWith(suffix) ? input : `${input}${suffix}`;
 }
 
+// src/color/color.ts
+var pad2 = createPadString({ length: 2, char: "0" });
+var RE_VALID_HEX_COLOR = /^#(?:[0-9a-f]{6}|[0-9a-f]{3})$/i;
+function validateHexColor(hex) {
+  if (hex.length !== 4 && hex.length !== 7) return false;
+  if (!hex.startsWith("#")) return false;
+  return RE_VALID_HEX_COLOR.test(hex);
+}
+function normalizeHexString(hex) {
+  return hex.length === 6 ? hex : hex.replace(/./g, "$&$&");
+}
+var Color = class _Color {
+  constructor(red = 0, green = 0, blue = 0, alpha = 1) {
+    this.red = red;
+    this.green = green;
+    this.blue = blue;
+    this.alpha = alpha;
+  }
+  static fromRGB(red, green, blue) {
+    return new _Color(red, green, blue);
+  }
+  static fromRGBA(red, green, blue, alpha) {
+    return new _Color(red, green, blue, alpha);
+  }
+  static fromHex(hex) {
+    if (!validateHexColor(hex)) {
+      throw new Error("Invalid hex color");
+    }
+    const [red, green, blue] = normalizeHexString(hex.slice(1)).match(/.{2}/g)?.map((value) => Number.parseInt(value, 16)) ?? [0, 0, 0];
+    return new _Color(red, green, blue);
+  }
+  get brightness() {
+    return (this.red * 299 + this.green * 587 + this.blue * 114) / 1e3;
+  }
+  get isDark() {
+    return this.brightness < 128;
+  }
+  get isLight() {
+    return !this.isDark;
+  }
+  toHexString(isUpperCase = true) {
+    const hexString = `#${pad2(this.red.toString(16))}${pad2(this.green.toString(16))}${pad2(this.blue.toString(16))}`;
+    return isUpperCase ? hexString.toUpperCase() : hexString;
+  }
+  toRGBAString() {
+    return `rgba(${this.red}, ${this.green}, ${this.blue}, ${this.alpha})`;
+  }
+  /**
+   * add alpha value to {@link Color}
+   *
+   * @param alpha - alpha value
+   * @returns instance of {@link Color}
+   */
+  withAlpha(alpha = 1) {
+    return new _Color(this.red, this.green, this.blue, alpha);
+  }
+  /**
+   * lighten the color by percentage
+   *
+   * @param percentage - percentage to lighten
+   */
+  lighten(percentage = 0) {
+    const amount = Math.round(percentage / 100 * 255);
+    return new _Color(
+      Math.min(this.red + amount, 255),
+      Math.min(this.green + amount, 255),
+      Math.min(this.blue + amount, 255),
+      this.alpha
+    );
+  }
+  /**
+   * darken the color by percentage
+   *
+   * @param percentage - percentage to darken
+   */
+  darken(percentage = 0) {
+    const amount = Math.round(percentage / 100 * 255);
+    return new _Color(
+      Math.max(this.red - amount, 0),
+      Math.max(this.green - amount, 0),
+      Math.max(this.blue - amount, 0),
+      this.alpha
+    );
+  }
+};
+
+// src/color/random.ts
+var MAX_RGB = 255;
+function randomRGBColor() {
+  return `rgb(${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)})`;
+}
+function randomRGBAColor() {
+  return `rgba(${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)}, ${randomNumber(MAX_RGB)}, ${Math.random().toFixed(1)})`;
+}
+function randomHexColor() {
+  return `#${Math.random().toString(16).slice(2, 8)}`;
+}
+
+// src/proxy/enhance.ts
+function enhance(module, extra) {
+  return new Proxy(module, {
+    get(target, key, receiver) {
+      if (Reflect.has(extra, key)) {
+        return Reflect.get(extra, key, receiver);
+      }
+      return Reflect.get(target, key, receiver);
+    },
+    has(target, key) {
+      return Reflect.has(extra, key) || Reflect.has(target, key);
+    }
+  });
+}
+
 // src/object/omit.ts
 function omit(object, ...keys) {
   keys.forEach((key) => delete object[key]);
@@ -426,11 +650,11 @@ function cleanObject(obj, options = {}) {
   const {
     cleanUndefined = true,
     cleanNull = true,
-    cleanZero = false,
     cleanNaN = true,
-    cleanEmptyString = true,
-    cleanEmptyArray = true,
-    cleanEmptyObject = true,
+    cleanZero = false,
+    cleanEmptyString = false,
+    cleanEmptyArray = false,
+    cleanEmptyObject = false,
     recursive = true
   } = options;
   Object.keys(obj).forEach((key) => {
@@ -494,88 +718,19 @@ function sortObject(obj, options = {}) {
   return sortKeys(obj);
 }
 
-// node_modules/.pnpm/scule@1.3.0/node_modules/scule/dist/index.mjs
-var NUMBER_CHAR_RE = /\d/;
-var STR_SPLITTERS = ["-", "_", "/", "."];
-function isUppercase(char = "") {
-  if (NUMBER_CHAR_RE.test(char)) {
-    return void 0;
-  }
-  return char !== char.toLowerCase();
-}
-function splitByCase(str, separators) {
-  const splitters = separators ?? STR_SPLITTERS;
-  const parts = [];
-  if (!str || typeof str !== "string") {
-    return parts;
-  }
-  let buff = "";
-  let previousUpper;
-  let previousSplitter;
-  for (const char of str) {
-    const isSplitter = splitters.includes(char);
-    if (isSplitter === true) {
-      parts.push(buff);
-      buff = "";
-      previousUpper = void 0;
-      continue;
-    }
-    const isUpper = isUppercase(char);
-    if (previousSplitter === false) {
-      if (previousUpper === false && isUpper === true) {
-        parts.push(buff);
-        buff = char;
-        previousUpper = isUpper;
-        continue;
-      }
-      if (previousUpper === true && isUpper === false && buff.length > 1) {
-        const lastChar = buff.at(-1);
-        parts.push(buff.slice(0, Math.max(0, buff.length - 1)));
-        buff = lastChar + char;
-        previousUpper = isUpper;
-        continue;
-      }
-    }
-    buff += char;
-    previousUpper = isUpper;
-    previousSplitter = isSplitter;
-  }
-  parts.push(buff);
-  return parts;
-}
-function upperFirst(str) {
-  return str ? str[0].toUpperCase() + str.slice(1) : "";
-}
-function lowerFirst(str) {
-  return str ? str[0].toLowerCase() + str.slice(1) : "";
-}
-function pascalCase(str, opts) {
-  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("") : "";
-}
-function camelCase(str, opts) {
-  return lowerFirst(pascalCase(str || "", opts));
-}
-function kebabCase(str, joiner) {
-  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => p.toLowerCase()).join(joiner ?? "-") : "";
-}
-function snakeCase(str) {
-  return kebabCase(str || "", "_");
-}
-function flatCase(str) {
-  return kebabCase(str || "", "");
-}
-function trainCase(str, opts) {
-  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("-");
-}
-var titleCaseExceptions = /^(a|an|and|as|at|but|by|for|if|in|is|nor|of|on|or|the|to|with)$/i;
-function titleCase(str, opts) {
-  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map(
-    (p) => titleCaseExceptions.test(p) ? p.toLowerCase() : upperFirst(opts?.normalize ? p.toLowerCase() : p)
-  ).join(" ");
-}
+// src/vendor/index.ts
+var vendor_exports = {};
+
+// src/vendor/changeCase.ts
+var changeCase_exports = {};
+__reExport(changeCase_exports, change_case_star);
+import * as change_case_star from "change-case";
+
+// src/vendor/index.ts
+__reExport(vendor_exports, changeCase_exports);
 
-// src/vendor/scule.ts
-var capitalize = upperFirst;
+// src/index.ts
+__reExport(index_exports, vendor_exports);
 
 // src/module/interopDefault.ts
 async function interopDefault(mod) {
@@ -588,21 +743,20 @@ function resolveSubOptions(options, key) {
   return typeof options[key] === "boolean" ? {} : options[key] || {};
 }
 export {
+  Color,
   NOOP,
   at,
   cAF,
-  camelCase,
-  capitalize,
   chunk,
   clamp,
   cleanObject,
   createPadString,
   days,
   debounce,
+  enhance,
   ensurePrefix,
   ensureSuffix,
   escapeHtml,
-  flatCase,
   flattenArrayable,
   getObjectType,
   hasOwn,
@@ -641,36 +795,31 @@ export {
   isSet,
   isString,
   isUndefined,
-  isUppercase,
   isWhitespaceString,
   isZero,
   join,
-  kebabCase,
   last,
-  lowerFirst,
   mergeArrayable,
   minutes,
   noop,
   omit,
   once,
-  pascalCase,
   pick,
   rAF,
+  randomHexColor,
+  randomNumber,
+  randomRGBAColor,
+  randomRGBColor,
   randomString,
   resolveSubOptions,
   seconds,
   slash,
-  snakeCase,
   sortObject,
-  splitByCase,
   throttle,
-  titleCase,
   toArray,
-  trainCase,
   unindent,
   unique,
   uniqueBy,
-  upperFirst,
   waitFor,
   warnOnce,
   weeks

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Common used utils.",
   "keywords": [
     "utils"
@@ -37,18 +37,18 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "scule": "^1.3.0"
+    "change-case": "^5.4.4"
   },
   "devDependencies": {
-    "@ntnyq/eslint-config": "^4.0.0-beta.3",
+    "@ntnyq/eslint-config": "^4.0.0-beta.4",
     "@ntnyq/prettier-config": "^2.0.0-beta.2",
     "@vitest/coverage-v8": "^3.0.5",
-    "bumpp": "^10.0.2",
-    "eslint": "^9.20.0",
+    "bumpp": "^10.0.3",
+    "eslint": "^9.20.1",
     "husky": "^9.1.7",
     "nano-staged": "^0.8.0",
     "npm-run-all2": "^7.0.2",
-    "prettier": "^3.5.0",
+    "prettier": "^3.5.1",
     "tsup": "^8.3.6",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5"