@ntnyq/utils 0.4.4 → 0.5.0

package/dist/index.cjs

@@ -28,6 +28,7 @@ __export(index_exports, {
   chunk: () => chunk,
   clamp: () => clamp,
   cleanObject: () => cleanObject,
+  createPadString: () => createPadString,
   days: () => days,
   debounce: () => debounce,
   ensurePrefix: () => ensurePrefix,
@@ -39,6 +40,7 @@ __export(index_exports, {
   hasOwn: () => hasOwn,
   hours: () => hours,
   interopDefault: () => interopDefault,
+  intersect: () => intersect,
   isArray: () => isArray,
   isArrayEqual: () => isArrayEqual,
   isBigInt: () => isBigInt,
@@ -46,17 +48,23 @@ __export(index_exports, {
   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,
@@ -80,6 +88,7 @@ __export(index_exports, {
   pascalCase: () => pascalCase,
   pick: () => pick,
   rAF: () => rAF,
+  randomString: () => randomString,
   resolveSubOptions: () => resolveSubOptions,
   seconds: () => seconds,
   slash: () => slash,
@@ -118,7 +127,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);
 }
@@ -136,18 +147,10 @@ function isNull(value) {
 function isNil(value) {
   return isNull(value) || isUndefined(value);
 }
+var isNullOrUndefined = isNil;
 function isString(value) {
   return typeof value === "string";
 }
-function isNumber(value) {
-  return typeof value === "number";
-}
-function isZero(value) {
-  return value === 0;
-}
-function isNaN(value) {
-  return Number.isNaN(value);
-}
 function isEmptyString(value) {
   return isString(value) && value.length === 0;
 }
@@ -163,6 +166,15 @@ function isEmptyStringOrWhitespace(value) {
 function isNumbericString(value) {
   return isString(value) && !isEmptyStringOrWhitespace(value) && !Number.isNaN(Number(value));
 }
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isZero(value) {
+  return value === 0;
+}
+function isNaN(value) {
+  return Number.isNaN(value);
+}
 function isInteger(value) {
   return Number.isInteger(value);
 }
@@ -181,11 +193,26 @@ function isArray(value) {
 function isEmptyArray(value) {
   return isArray(value) && value.length === 0;
 }
+function isNonEmptyArray(value) {
+  return isArray(value) && value.length > 0;
+}
 function isObject(value) {
-  return getObjectType(value) === "Object";
+  return (typeof value === "object" || isFunction(value)) && !isNull(value);
 }
 function isEmptyObject(value) {
-  return isObject(value) && Object.keys(value).length === 0;
+  return isObject(value) && !isMap(value) && !isSet(value) && Object.keys(value).length === 0;
+}
+function isMap(value) {
+  return getObjectType(value) === "Map";
+}
+function isEmptyMap(value) {
+  return isMap(value) && value.size === 0;
+}
+function isSet(value) {
+  return getObjectType(value) === "Set";
+}
+function isEmptySet(value) {
+  return isSet(value) && value.size === 0;
 }
 function isRegExp(value) {
   return getObjectType(value) === "RegExp";
@@ -193,18 +220,18 @@ function isRegExp(value) {
 function isError(value) {
   return getObjectType(value) === "Error";
 }
-function isSet(value) {
-  return getObjectType(value) === "Set";
+function hasPromiseApi(value) {
+  return isFunction(value?.then) && isFunction(value?.catch);
 }
 function isNativePromise(value) {
   return getObjectType(value) === "Promise";
 }
-function hasPromiseApi(value) {
-  return isFunction(value?.then) && isFunction(value?.catch);
-}
 function isPromise(value) {
   return isNativePromise(value) || hasPromiseApi(value);
 }
+function isIterable(value) {
+  return isFunction(value?.[Symbol.iterator]);
+}
 
 // src/fn/noop.ts
 var noop = () => {
@@ -312,7 +339,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;
@@ -390,6 +420,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) {
@@ -398,6 +433,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;
@@ -410,6 +451,28 @@ function slash(input) {
   return input.replace(/\\/g, "/");
 }
 
+// src/number/random.ts
+function randomNumber(min, max = 0) {
+  if (max === 0) {
+    max = min;
+    min = 0;
+  }
+  if (min > max) {
+    ;
+    [min, max] = [max, min];
+  }
+  return Math.trunc(Math.random() * (max - min + 1) + 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) {
@@ -645,6 +708,7 @@ function resolveSubOptions(options, key) {
   chunk,
   clamp,
   cleanObject,
+  createPadString,
   days,
   debounce,
   ensurePrefix,
@@ -656,6 +720,7 @@ function resolveSubOptions(options, key) {
   hasOwn,
   hours,
   interopDefault,
+  intersect,
   isArray,
   isArrayEqual,
   isBigInt,
@@ -663,17 +728,23 @@ function resolveSubOptions(options, key) {
   isBrowser,
   isDeepEqual,
   isEmptyArray,
+  isEmptyMap,
   isEmptyObject,
+  isEmptySet,
   isEmptyString,
   isEmptyStringOrWhitespace,
   isError,
   isFunction,
   isInteger,
+  isIterable,
+  isMap,
   isNaN,
   isNativePromise,
   isNil,
+  isNonEmptyArray,
   isNonEmptyString,
   isNull,
+  isNullOrUndefined,
   isNumber,
   isNumbericString,
   isObject,
@@ -697,6 +768,7 @@ function resolveSubOptions(options, key) {
   pascalCase,
   pick,
   rAF,
+  randomString,
   resolveSubOptions,
   seconds,
   slash,

package/dist/index.d.cts

@@ -19,28 +19,34 @@ declare function getObjectType(value: unknown): string;
 declare function isUndefined(value: unknown): value is undefined;
 declare function isNull(value: unknown): value is null;
 declare function isNil(value: unknown): value is null | undefined;
+declare const isNullOrUndefined: typeof isNil;
 declare function isString(value: unknown): value is string;
-declare function isNumber(value: unknown): value is number;
-declare function isZero(value: unknown): value is 0;
-declare function isNaN(value: unknown): value is typeof Number.NaN;
 declare function isEmptyString(value: unknown): value is '';
 declare function isNonEmptyString(value: unknown): value is NonEmptyString;
 declare function isWhitespaceString(value: unknown): value is Whitespace;
 declare function isEmptyStringOrWhitespace(value: unknown): value is '' | Whitespace;
 declare function isNumbericString(value: unknown): value is `${number}`;
+declare function isNumber(value: unknown): value is number;
+declare function isZero(value: unknown): value is 0;
+declare function isNaN(value: unknown): value is typeof Number.NaN;
 declare function isInteger(value: unknown): value is number;
 declare function isBigInt(value: unknown): value is bigint;
 declare function isBoolean(value: unknown): value is boolean;
 declare function isFunction(value: unknown): value is Function;
 declare function isArray(value: unknown): value is unknown[];
 declare function isEmptyArray(value: unknown): value is [];
+declare function isNonEmptyArray<T = unknown, Item = unknown>(value: T | Item[]): value is [Item, ...Item[]];
 declare function isObject(value: unknown): value is object;
 declare function isEmptyObject(value: unknown): value is {};
+declare function isMap<Key = unknown, Value = unknown>(value: unknown): value is Map<Key, Value>;
+declare function isEmptyMap(value: unknown): value is Map<never, never>;
+declare function isSet<Value = unknown>(value: unknown): value is Set<Value>;
+declare function isEmptySet(value: unknown): value is Set<never>;
 declare function isRegExp(value: unknown): value is RegExp;
 declare function isError(value: unknown): value is Error;
-declare function isSet<Value = unknown>(value: unknown): value is Set<Value>;
 declare function isNativePromise<T = unknown>(value: unknown): value is Promise<T>;
 declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
+declare function isIterable<T = unknown>(value: unknown): value is Iterable<T>;
 
 /**
  * A function that does nothing.
@@ -201,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
  */
@@ -209,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>`
  */
@@ -238,8 +244,21 @@ 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;
 
+interface CreatePadStringOptions {
+    length: number;
+    char: string;
+}
+declare function createPadString(options: CreatePadStringOptions): (value: string) => string;
+
 type JoinableValue = string | number | null | undefined;
 interface JoinOptions {
     /**
@@ -260,6 +279,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.
@@ -422,4 +450,4 @@ 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, isEmptyObject, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isNaN, isNativePromise, isNil, isNonEmptyString, isNull, 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 };
+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 };

package/dist/index.d.ts

@@ -19,28 +19,34 @@ declare function getObjectType(value: unknown): string;
 declare function isUndefined(value: unknown): value is undefined;
 declare function isNull(value: unknown): value is null;
 declare function isNil(value: unknown): value is null | undefined;
+declare const isNullOrUndefined: typeof isNil;
 declare function isString(value: unknown): value is string;
-declare function isNumber(value: unknown): value is number;
-declare function isZero(value: unknown): value is 0;
-declare function isNaN(value: unknown): value is typeof Number.NaN;
 declare function isEmptyString(value: unknown): value is '';
 declare function isNonEmptyString(value: unknown): value is NonEmptyString;
 declare function isWhitespaceString(value: unknown): value is Whitespace;
 declare function isEmptyStringOrWhitespace(value: unknown): value is '' | Whitespace;
 declare function isNumbericString(value: unknown): value is `${number}`;
+declare function isNumber(value: unknown): value is number;
+declare function isZero(value: unknown): value is 0;
+declare function isNaN(value: unknown): value is typeof Number.NaN;
 declare function isInteger(value: unknown): value is number;
 declare function isBigInt(value: unknown): value is bigint;
 declare function isBoolean(value: unknown): value is boolean;
 declare function isFunction(value: unknown): value is Function;
 declare function isArray(value: unknown): value is unknown[];
 declare function isEmptyArray(value: unknown): value is [];
+declare function isNonEmptyArray<T = unknown, Item = unknown>(value: T | Item[]): value is [Item, ...Item[]];
 declare function isObject(value: unknown): value is object;
 declare function isEmptyObject(value: unknown): value is {};
+declare function isMap<Key = unknown, Value = unknown>(value: unknown): value is Map<Key, Value>;
+declare function isEmptyMap(value: unknown): value is Map<never, never>;
+declare function isSet<Value = unknown>(value: unknown): value is Set<Value>;
+declare function isEmptySet(value: unknown): value is Set<never>;
 declare function isRegExp(value: unknown): value is RegExp;
 declare function isError(value: unknown): value is Error;
-declare function isSet<Value = unknown>(value: unknown): value is Set<Value>;
 declare function isNativePromise<T = unknown>(value: unknown): value is Promise<T>;
 declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
+declare function isIterable<T = unknown>(value: unknown): value is Iterable<T>;
 
 /**
  * A function that does nothing.
@@ -201,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
  */
@@ -209,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>`
  */
@@ -238,8 +244,21 @@ 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;
 
+interface CreatePadStringOptions {
+    length: number;
+    char: string;
+}
+declare function createPadString(options: CreatePadStringOptions): (value: string) => string;
+
 type JoinableValue = string | number | null | undefined;
 interface JoinOptions {
     /**
@@ -260,6 +279,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.
@@ -422,4 +450,4 @@ 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, isEmptyObject, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isNaN, isNativePromise, isNil, isNonEmptyString, isNull, 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 };
+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 };

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);
 }
@@ -34,18 +36,10 @@ function isNull(value) {
 function isNil(value) {
   return isNull(value) || isUndefined(value);
 }
+var isNullOrUndefined = isNil;
 function isString(value) {
   return typeof value === "string";
 }
-function isNumber(value) {
-  return typeof value === "number";
-}
-function isZero(value) {
-  return value === 0;
-}
-function isNaN(value) {
-  return Number.isNaN(value);
-}
 function isEmptyString(value) {
   return isString(value) && value.length === 0;
 }
@@ -61,6 +55,15 @@ function isEmptyStringOrWhitespace(value) {
 function isNumbericString(value) {
   return isString(value) && !isEmptyStringOrWhitespace(value) && !Number.isNaN(Number(value));
 }
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isZero(value) {
+  return value === 0;
+}
+function isNaN(value) {
+  return Number.isNaN(value);
+}
 function isInteger(value) {
   return Number.isInteger(value);
 }
@@ -79,11 +82,26 @@ function isArray(value) {
 function isEmptyArray(value) {
   return isArray(value) && value.length === 0;
 }
+function isNonEmptyArray(value) {
+  return isArray(value) && value.length > 0;
+}
 function isObject(value) {
-  return getObjectType(value) === "Object";
+  return (typeof value === "object" || isFunction(value)) && !isNull(value);
 }
 function isEmptyObject(value) {
-  return isObject(value) && Object.keys(value).length === 0;
+  return isObject(value) && !isMap(value) && !isSet(value) && Object.keys(value).length === 0;
+}
+function isMap(value) {
+  return getObjectType(value) === "Map";
+}
+function isEmptyMap(value) {
+  return isMap(value) && value.size === 0;
+}
+function isSet(value) {
+  return getObjectType(value) === "Set";
+}
+function isEmptySet(value) {
+  return isSet(value) && value.size === 0;
 }
 function isRegExp(value) {
   return getObjectType(value) === "RegExp";
@@ -91,18 +109,18 @@ function isRegExp(value) {
 function isError(value) {
   return getObjectType(value) === "Error";
 }
-function isSet(value) {
-  return getObjectType(value) === "Set";
+function hasPromiseApi(value) {
+  return isFunction(value?.then) && isFunction(value?.catch);
 }
 function isNativePromise(value) {
   return getObjectType(value) === "Promise";
 }
-function hasPromiseApi(value) {
-  return isFunction(value?.then) && isFunction(value?.catch);
-}
 function isPromise(value) {
   return isNativePromise(value) || hasPromiseApi(value);
 }
+function isIterable(value) {
+  return isFunction(value?.[Symbol.iterator]);
+}
 
 // src/fn/noop.ts
 var noop = () => {
@@ -210,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;
@@ -288,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) {
@@ -296,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;
@@ -308,6 +340,28 @@ function slash(input) {
   return input.replace(/\\/g, "/");
 }
 
+// src/number/random.ts
+function randomNumber(min, max = 0) {
+  if (max === 0) {
+    max = min;
+    min = 0;
+  }
+  if (min > max) {
+    ;
+    [min, max] = [max, min];
+  }
+  return Math.trunc(Math.random() * (max - min + 1) + 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) {
@@ -542,6 +596,7 @@ export {
   chunk,
   clamp,
   cleanObject,
+  createPadString,
   days,
   debounce,
   ensurePrefix,
@@ -553,6 +608,7 @@ export {
   hasOwn,
   hours,
   interopDefault,
+  intersect,
   isArray,
   isArrayEqual,
   isBigInt,
@@ -560,17 +616,23 @@ export {
   isBrowser,
   isDeepEqual,
   isEmptyArray,
+  isEmptyMap,
   isEmptyObject,
+  isEmptySet,
   isEmptyString,
   isEmptyStringOrWhitespace,
   isError,
   isFunction,
   isInteger,
+  isIterable,
+  isMap,
   isNaN,
   isNativePromise,
   isNil,
+  isNonEmptyArray,
   isNonEmptyString,
   isNull,
+  isNullOrUndefined,
   isNumber,
   isNumbericString,
   isObject,
@@ -594,6 +656,7 @@ export {
   pascalCase,
   pick,
   rAF,
+  randomString,
   resolveSubOptions,
   seconds,
   slash,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "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.2",
+    "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"