@ntnyq/utils 0.4.5 → 0.5.1

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  Color: () => Color,
   NOOP: () => NOOP,
   at: () => at,
   cAF: () => cAF,
@@ -28,8 +29,10 @@ __export(index_exports, {
   chunk: () => chunk,
   clamp: () => clamp,
   cleanObject: () => cleanObject,
+  createPadString: () => createPadString,
   days: () => days,
   debounce: () => debounce,
+  enhance: () => enhance,
   ensurePrefix: () => ensurePrefix,
   ensureSuffix: () => ensureSuffix,
   escapeHtml: () => escapeHtml,
@@ -39,6 +42,7 @@ __export(index_exports, {
   hasOwn: () => hasOwn,
   hours: () => hours,
   interopDefault: () => interopDefault,
+  intersect: () => intersect,
   isArray: () => isArray,
   isArrayEqual: () => isArrayEqual,
   isBigInt: () => isBigInt,
@@ -86,6 +90,11 @@ __export(index_exports, {
   pascalCase: () => pascalCase,
   pick: () => pick,
   rAF: () => rAF,
+  randomHexColor: () => randomHexColor,
+  randomNumber: () => randomNumber,
+  randomRGBAColor: () => randomRGBAColor,
+  randomRGBColor: () => randomRGBColor,
+  randomString: () => randomString,
   resolveSubOptions: () => resolveSubOptions,
   seconds: () => seconds,
   slash: () => slash,
@@ -124,7 +133,9 @@ function isDeepEqual(value1, value2) {
     if (keys.length !== Object.keys(value2).length) {
       return false;
     }
-    return keys.every((key) => isDeepEqual(value1[key], value2[key]));
+    return keys.every(
+      (key) => isDeepEqual(value1[key], value2[key])
+    );
   }
   return Object.is(value1, value2);
 }
@@ -334,7 +345,10 @@ function throttle(delay, callback, options = {}) {
     if (!isDebounce && elapsed > delay) {
       exec(now);
     } else {
-      timeoutId = setTimeout(isDebounce ? clear : exec, isDebounce ? delay : delay - elapsed);
+      timeoutId = setTimeout(
+        isDebounce ? clear : exec,
+        isDebounce ? delay : delay - elapsed
+      );
     }
   }
   wrapper.cancel = cancel;
@@ -412,6 +426,11 @@ function mergeArrayable(...args) {
   return args.flatMap((i) => toArray(i));
 }
 
+// src/array/intersect.ts
+function intersect(a, b) {
+  return a.filter((item) => b.includes(item));
+}
+
 // src/array/isArrayEqual.ts
 function isArrayEqual(array1, array2) {
   if (array1.length !== array2.length) {
@@ -420,6 +439,12 @@ function isArrayEqual(array1, array2) {
   return array1.every((item, idx) => item === array2[idx]);
 }
 
+// src/string/pad.ts
+function createPadString(options) {
+  const { length, char } = options;
+  return (value) => (char.repeat(length) + value).slice(-length);
+}
+
 // src/string/join.ts
 function join(array, options = {}) {
   const { separator = "" } = options;
@@ -432,6 +457,30 @@ function slash(input) {
   return input.replace(/\\/g, "/");
 }
 
+// src/number/random.ts
+function randomNumber(min, max = 0, options = {}) {
+  if (max === 0) {
+    max = min;
+    min = 0;
+  }
+  if (min > max) {
+    ;
+    [min, max] = [max, min];
+  }
+  return Math.trunc(
+    Math.random() * (max - min + (options.includeMax ? 1 : 0)) + min
+  );
+}
+
+// src/string/random.ts
+function randomString(length = 16, chars = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ") {
+  const result = [];
+  for (let i = length; i > 0; --i) {
+    result.push(chars[randomNumber(chars.length)]);
+  }
+  return result.join("");
+}
+
 // src/string/unindent.ts
 var _RE_FULL_WS = /^\s*$/;
 function unindent(input) {
@@ -465,6 +514,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]);
@@ -496,11 +658,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) => {
@@ -659,6 +821,7 @@ function resolveSubOptions(options, key) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  Color,
   NOOP,
   at,
   cAF,
@@ -667,8 +830,10 @@ function resolveSubOptions(options, key) {
   chunk,
   clamp,
   cleanObject,
+  createPadString,
   days,
   debounce,
+  enhance,
   ensurePrefix,
   ensureSuffix,
   escapeHtml,
@@ -678,6 +843,7 @@ function resolveSubOptions(options, key) {
   hasOwn,
   hours,
   interopDefault,
+  intersect,
   isArray,
   isArrayEqual,
   isBigInt,
@@ -725,6 +891,11 @@ function resolveSubOptions(options, key) {
   pascalCase,
   pick,
   rAF,
+  randomHexColor,
+  randomNumber,
+  randomRGBAColor,
+  randomRGBColor,
+  randomString,
   resolveSubOptions,
   seconds,
   slash,

package/dist/index.d.cts

@@ -207,7 +207,10 @@ type Awaitable<T> = Promise<T> | T;
 type Callable<T> = AnyFn<any, T> | T;
 type MayBe<T> = T | undefined;
 type Nullable<T> = T | null;
-type PrimitiveType = bigint | boolean | number | string | symbol | null | undefined;
+/**
+ * Overwrite some keys type
+ */
+type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
 /**
  * Prettify object type
  */
@@ -215,10 +218,7 @@ type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
 type PrettifyV2<T> = Omit<T, never>;
-/**
- * Overwrite some keys type
- */
-type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
+type PrimitiveType = bigint | boolean | number | string | symbol | null | undefined;
 /**
  * Resolve `boolean | Record<string, any>` to `Record<string, any>`
  */
@@ -244,8 +244,78 @@ declare function flattenArrayable<T>(array?: Nullable<Arrayable<T | Array<T>>>):
  */
 declare function mergeArrayable<T>(...args: Nullable<Arrayable<T>>[]): Array<T>;
 
+/**
+ * Get intersect items
+ *
+ * @returns intersect items
+ */
+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;
+}
+declare function createPadString(options: CreatePadStringOptions): (value: string) => string;
+
 type JoinableValue = string | number | null | undefined;
 interface JoinOptions {
     /**
@@ -266,6 +336,15 @@ declare function join(array: JoinableValue[], options?: JoinOptions): string;
  */
 declare function slash(input: string): string;
 
+/**
+ * randome a string useing given chars
+ *
+ * @param length - string length
+ * @param chars - string chars
+ * @returns random string
+ */
+declare function randomString(length?: number, chars?: string): string;
+
 /**
  * Remove common leading whitespace from a template string
  * Empty lines at the beginning and end of the template string are also removed.
@@ -319,19 +398,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;
     /**
@@ -428,4 +507,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 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, days, debounce, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, 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, 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, capitalize, 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

@@ -207,7 +207,10 @@ type Awaitable<T> = Promise<T> | T;
 type Callable<T> = AnyFn<any, T> | T;
 type MayBe<T> = T | undefined;
 type Nullable<T> = T | null;
-type PrimitiveType = bigint | boolean | number | string | symbol | null | undefined;
+/**
+ * Overwrite some keys type
+ */
+type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
 /**
  * Prettify object type
  */
@@ -215,10 +218,7 @@ type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
 type PrettifyV2<T> = Omit<T, never>;
-/**
- * Overwrite some keys type
- */
-type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
+type PrimitiveType = bigint | boolean | number | string | symbol | null | undefined;
 /**
  * Resolve `boolean | Record<string, any>` to `Record<string, any>`
  */
@@ -244,8 +244,78 @@ declare function flattenArrayable<T>(array?: Nullable<Arrayable<T | Array<T>>>):
  */
 declare function mergeArrayable<T>(...args: Nullable<Arrayable<T>>[]): Array<T>;
 
+/**
+ * Get intersect items
+ *
+ * @returns intersect items
+ */
+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;
+}
+declare function createPadString(options: CreatePadStringOptions): (value: string) => string;
+
 type JoinableValue = string | number | null | undefined;
 interface JoinOptions {
     /**
@@ -266,6 +336,15 @@ declare function join(array: JoinableValue[], options?: JoinOptions): string;
  */
 declare function slash(input: string): string;
 
+/**
+ * randome a string useing given chars
+ *
+ * @param length - string length
+ * @param chars - string chars
+ * @returns random string
+ */
+declare function randomString(length?: number, chars?: string): string;
+
 /**
  * Remove common leading whitespace from a template string
  * Empty lines at the beginning and end of the template string are also removed.
@@ -319,19 +398,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;
     /**
@@ -428,4 +507,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 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, days, debounce, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, 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, 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, capitalize, 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

@@ -16,7 +16,9 @@ function isDeepEqual(value1, value2) {
     if (keys.length !== Object.keys(value2).length) {
       return false;
     }
-    return keys.every((key) => isDeepEqual(value1[key], value2[key]));
+    return keys.every(
+      (key) => isDeepEqual(value1[key], value2[key])
+    );
   }
   return Object.is(value1, value2);
 }
@@ -226,7 +228,10 @@ function throttle(delay, callback, options = {}) {
     if (!isDebounce && elapsed > delay) {
       exec(now);
     } else {
-      timeoutId = setTimeout(isDebounce ? clear : exec, isDebounce ? delay : delay - elapsed);
+      timeoutId = setTimeout(
+        isDebounce ? clear : exec,
+        isDebounce ? delay : delay - elapsed
+      );
     }
   }
   wrapper.cancel = cancel;
@@ -304,6 +309,11 @@ function mergeArrayable(...args) {
   return args.flatMap((i) => toArray(i));
 }
 
+// src/array/intersect.ts
+function intersect(a, b) {
+  return a.filter((item) => b.includes(item));
+}
+
 // src/array/isArrayEqual.ts
 function isArrayEqual(array1, array2) {
   if (array1.length !== array2.length) {
@@ -312,6 +322,12 @@ function isArrayEqual(array1, array2) {
   return array1.every((item, idx) => item === array2[idx]);
 }
 
+// src/string/pad.ts
+function createPadString(options) {
+  const { length, char } = options;
+  return (value) => (char.repeat(length) + value).slice(-length);
+}
+
 // src/string/join.ts
 function join(array, options = {}) {
   const { separator = "" } = options;
@@ -324,6 +340,30 @@ function slash(input) {
   return input.replace(/\\/g, "/");
 }
 
+// src/number/random.ts
+function randomNumber(min, max = 0, options = {}) {
+  if (max === 0) {
+    max = min;
+    min = 0;
+  }
+  if (min > max) {
+    ;
+    [min, max] = [max, min];
+  }
+  return Math.trunc(
+    Math.random() * (max - min + (options.includeMax ? 1 : 0)) + min
+  );
+}
+
+// src/string/random.ts
+function randomString(length = 16, chars = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ") {
+  const result = [];
+  for (let i = length; i > 0; --i) {
+    result.push(chars[randomNumber(chars.length)]);
+  }
+  return result.join("");
+}
+
 // src/string/unindent.ts
 var _RE_FULL_WS = /^\s*$/;
 function unindent(input) {
@@ -357,6 +397,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]);
@@ -388,11 +541,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) => {
@@ -550,6 +703,7 @@ function resolveSubOptions(options, key) {
   return typeof options[key] === "boolean" ? {} : options[key] || {};
 }
 export {
+  Color,
   NOOP,
   at,
   cAF,
@@ -558,8 +712,10 @@ export {
   chunk,
   clamp,
   cleanObject,
+  createPadString,
   days,
   debounce,
+  enhance,
   ensurePrefix,
   ensureSuffix,
   escapeHtml,
@@ -569,6 +725,7 @@ export {
   hasOwn,
   hours,
   interopDefault,
+  intersect,
   isArray,
   isArrayEqual,
   isBigInt,
@@ -616,6 +773,11 @@ export {
   pascalCase,
   pick,
   rAF,
+  randomHexColor,
+  randomNumber,
+  randomRGBAColor,
+  randomRGBColor,
+  randomString,
   resolveSubOptions,
   seconds,
   slash,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.4.5",
+  "version": "0.5.1",
   "description": "Common used utils.",
   "keywords": [
     "utils"
@@ -40,18 +40,18 @@
     "scule": "^1.3.0"
   },
   "devDependencies": {
-    "@ntnyq/eslint-config": "^3.10.4",
-    "@ntnyq/prettier-config": "^1.22.0",
-    "@vitest/coverage-v8": "^3.0.0-beta.3",
-    "bumpp": "^9.9.2",
-    "eslint": "^9.17.0",
+    "@ntnyq/eslint-config": "^4.0.0-beta.3",
+    "@ntnyq/prettier-config": "^2.0.0-beta.2",
+    "@vitest/coverage-v8": "^3.0.5",
+    "bumpp": "^10.0.3",
+    "eslint": "^9.20.0",
     "husky": "^9.1.7",
     "nano-staged": "^0.8.0",
     "npm-run-all2": "^7.0.2",
-    "prettier": "^3.4.2",
-    "tsup": "^8.3.5",
-    "typescript": "^5.7.2",
-    "vitest": "^3.0.0-beta.3"
+    "prettier": "^3.5.0",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
   },
   "engines": {
     "node": ">=18.18.0"