@ntnyq/utils 0.4.5 → 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,
@@ -86,6 +88,7 @@ __export(index_exports, {
   pascalCase: () => pascalCase,
   pick: () => pick,
   rAF: () => rAF,
+  randomString: () => randomString,
   resolveSubOptions: () => resolveSubOptions,
   seconds: () => seconds,
   slash: () => slash,
@@ -124,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);
 }
@@ -334,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;
@@ -412,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) {
@@ -420,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;
@@ -432,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) {
@@ -667,6 +708,7 @@ function resolveSubOptions(options, key) {
   chunk,
   clamp,
   cleanObject,
+  createPadString,
   days,
   debounce,
   ensurePrefix,
@@ -678,6 +720,7 @@ function resolveSubOptions(options, key) {
   hasOwn,
   hours,
   interopDefault,
+  intersect,
   isArray,
   isArrayEqual,
   isBigInt,
@@ -725,6 +768,7 @@ function resolveSubOptions(options, key) {
   pascalCase,
   pick,
   rAF,
+  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,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 {
     /**
@@ -266,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.
@@ -428,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, 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 };
+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

@@ -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,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 {
     /**
@@ -266,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.
@@ -428,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, 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 };
+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);
 }
@@ -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,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) {
@@ -558,6 +596,7 @@ export {
   chunk,
   clamp,
   cleanObject,
+  createPadString,
   days,
   debounce,
   ensurePrefix,
@@ -569,6 +608,7 @@ export {
   hasOwn,
   hours,
   interopDefault,
+  intersect,
   isArray,
   isArrayEqual,
   isBigInt,
@@ -616,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.5",
+  "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"