@ntnyq/utils 0.1.3 → 0.3.0

package/dist/index.cjs

@@ -21,43 +21,64 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   NOOP: () => NOOP,
+  at: () => at,
   cAF: () => cAF,
   camelCase: () => camelCase,
   capitalize: () => capitalize,
   chunk: () => chunk,
   clamp: () => clamp,
   days: () => days,
+  debounce: () => debounce,
+  ensurePrefix: () => ensurePrefix,
+  ensureSuffix: () => ensureSuffix,
   flatCase: () => flatCase,
+  flattenArrayable: () => flattenArrayable,
   getObjectType: () => getObjectType,
-  hasOwnProperty: () => hasOwnProperty,
+  hasOwn: () => hasOwn,
   hours: () => hours,
   isArray: () => isArray,
+  isArrayEqual: () => isArrayEqual,
   isBoolean: () => isBoolean,
   isBrowser: () => isBrowser,
+  isEmptyString: () => isEmptyString,
+  isEmptyStringOrWhitespace: () => isEmptyStringOrWhitespace,
   isFunction: () => isFunction,
   isInteger: () => isInteger,
   isNativePromise: () => isNativePromise,
+  isNil: () => isNil,
   isNull: () => isNull,
   isNumber: () => isNumber,
+  isNumbericString: () => isNumbericString,
+  isObject: () => isObject,
   isPromise: () => isPromise,
+  isRegExp: () => isRegExp,
+  isSet: () => isSet,
   isString: () => isString,
   isUndefined: () => isUndefined,
   isUppercase: () => isUppercase,
+  isWhitespaceString: () => isWhitespaceString,
   join: () => join,
   kebabCase: () => kebabCase,
+  last: () => last,
   lowerFirst: () => lowerFirst,
+  mergeArrayable: () => mergeArrayable,
   minutes: () => minutes,
   noop: () => noop,
   omit: () => omit,
+  once: () => once,
   pascalCase: () => pascalCase,
   pick: () => pick,
   rAF: () => rAF,
   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,
@@ -77,6 +98,18 @@ function isString(value) {
 function isNumber(value) {
   return typeof value === "number";
 }
+function isEmptyString(value) {
+  return isString(value) && value.length === 0;
+}
+function isWhitespaceString(value) {
+  return isString(value) && /^\s*$/.test(value);
+}
+function isEmptyStringOrWhitespace(value) {
+  return isEmptyString(value) || isWhitespaceString(value);
+}
+function isNumbericString(value) {
+  return isString(value) && !isEmptyStringOrWhitespace(value) && !Number.isNaN(Number(value));
+}
 function isInteger(value) {
   return Number.isInteger(value);
 }
@@ -95,6 +128,18 @@ function isUndefined(value) {
 function isNull(value) {
   return value === null;
 }
+function isNil(value) {
+  return isNull(value) || isUndefined(value);
+}
+function isObject(value) {
+  return getObjectType(value) === "Object";
+}
+function isRegExp(value) {
+  return getObjectType(value) === "RegExp";
+}
+function isSet(value) {
+  return getObjectType(value) === "Set";
+}
 function isNativePromise(value) {
   return getObjectType(value) === "Promise";
 }
@@ -110,6 +155,19 @@ var noop = () => {
 };
 var NOOP = noop;
 
+// src/fn/once.ts
+function once(func) {
+  let called = false;
+  return function(...args) {
+    if (called) {
+      return false;
+    }
+    called = true;
+    func.apply(this, args);
+    return true;
+  };
+}
+
 // src/env/isBrowser.ts
 var isBrowser = () => typeof document !== "undefined";
 
@@ -247,6 +305,53 @@ function waitFor(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+// src/misc/throttle.ts
+function throttle(delay, callback, options = {}) {
+  const { isDebounce } = options;
+  let lastExec = 0;
+  let cancelled = false;
+  let timeoutId;
+  function clearExistingTimeout() {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+  }
+  function cancel() {
+    clearExistingTimeout();
+    cancelled = true;
+  }
+  function wrapper(...args) {
+    if (cancelled) return;
+    const _this = this;
+    const now = Date.now();
+    const elapsed = now - lastExec;
+    function clear() {
+      timeoutId = void 0;
+    }
+    function exec(cur) {
+      lastExec = cur || Date.now();
+      callback.apply(_this, args);
+    }
+    if (isDebounce && !timeoutId) {
+      exec(now);
+    }
+    clearExistingTimeout();
+    if (!isDebounce && elapsed > delay) {
+      exec(now);
+    } else {
+      timeoutId = setTimeout(isDebounce ? clear : exec, isDebounce ? delay : delay - elapsed);
+    }
+  }
+  wrapper.cancel = cancel;
+  return wrapper;
+}
+function debounce(delay, callback, options = {}) {
+  return throttle(delay, callback, {
+    ...options,
+    isDebounce: true
+  });
+}
+
 // src/misc/warnOnce.ts
 var warned = /* @__PURE__ */ new Set();
 var warnOnce = (message) => {
@@ -257,6 +362,19 @@ var warnOnce = (message) => {
   console.warn(message);
 };
 
+// src/array/at.ts
+function at(array, index) {
+  const length = array.length;
+  if (!length) return void 0;
+  if (index < 0) {
+    index += length;
+  }
+  return array[index];
+}
+function last(array) {
+  return at(array, -1);
+}
+
 // src/array/chunk.ts
 function chunk(array, size) {
   const result = [];
@@ -286,6 +404,22 @@ function toArray(array) {
   return Array.isArray(array) ? array : [array];
 }
 
+// src/array/arrayable.ts
+function flattenArrayable(array) {
+  return toArray(array).flat(1);
+}
+function mergeArrayable(...args) {
+  return args.flatMap((i) => toArray(i));
+}
+
+// src/array/isArrayEqual.ts
+function isArrayEqual(array1, array2) {
+  if (array1.length !== array2.length) {
+    return false;
+  }
+  return array1.every((item, idx) => item === array2[idx]);
+}
+
 // src/string/join.ts
 function join(array, options = {}) {
   const { separator = "" } = options;
@@ -293,14 +427,52 @@ function join(array, options = {}) {
   return array.filter((v) => Boolean(v) || v === 0).join(separator);
 }
 
+// src/string/slash.ts
+function slash(input) {
+  return input.replace(/\\/g, "/");
+}
+
+// src/string/unindent.ts
+var _RE_FULL_WS = /^\s*$/;
+function unindent(input) {
+  const lines = (typeof input === "string" ? input : input[0]).split("\n");
+  const whitespaceLines = lines.map((line) => _RE_FULL_WS.test(line));
+  const commonIndent = lines.reduce((min, line, idx) => {
+    if (!whitespaceLines[idx]) {
+      return min;
+    }
+    const indent = line.match(/^\s/)?.[0].length;
+    return indent === void 0 ? min : Math.min(min, indent);
+  }, Number.POSITIVE_INFINITY);
+  let emptylinesHead = 0;
+  while (emptylinesHead < lines.length && whitespaceLines[emptylinesHead]) {
+    emptylinesHead++;
+  }
+  let emptylinesTail = 0;
+  while (emptylinesTail < lines.length && whitespaceLines[lines.length - emptylinesTail - 1]) {
+    emptylinesTail++;
+  }
+  return lines.slice(emptylinesHead, lines.length - emptylinesTail).map((line) => line.slice(commonIndent)).join("\n");
+}
+
+// src/string/ensurePrefix.ts
+function ensurePrefix(input, prefix) {
+  return input.startsWith(prefix) ? input : `${prefix}${input}`;
+}
+
+// src/string/ensureSuffix.ts
+function ensureSuffix(input, suffix) {
+  return input.endsWith(suffix) ? input : `${input}${suffix}`;
+}
+
 // src/object/omit.ts
 function omit(object, ...keys) {
   keys.forEach((key) => delete object[key]);
   return object;
 }
 
-// src/object/hasOwnProperty.ts
-function hasOwnProperty(object, key) {
+// src/object/hasOwn.ts
+function hasOwn(object, key) {
   return Object.prototype.hasOwnProperty.call(object, key);
 }
 
@@ -309,52 +481,104 @@ function pick(object, keys) {
   return Object.assign(
     {},
     ...keys.map((key) => {
-      if (object && hasOwnProperty(object, key)) {
+      if (object && hasOwn(object, key)) {
         return { [key]: object[key] };
       }
     })
   );
 }
+
+// src/object/isPlainObject.ts
+function isPlainObject(value) {
+  if (!isObject(value)) return false;
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
+}
+
+// src/object/sortObject.ts
+function sortObject(obj, options = {}) {
+  const { compareFn = (a, b) => a.localeCompare(b) } = options;
+  function sortKeys(obj2) {
+    const sortedKeys = Object.keys(obj2).sort(compareFn);
+    const result = {};
+    for (const key of sortedKeys) {
+      const value = obj2[key];
+      let newValue;
+      if (options.deep && isPlainObject(value)) {
+        newValue = sortKeys(value);
+      } else {
+        newValue = value;
+      }
+      Object.defineProperty(result, key, {
+        ...Object.getOwnPropertyDescriptor(obj2, key),
+        value: newValue
+      });
+    }
+    return result;
+  }
+  return sortKeys(obj);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   NOOP,
+  at,
   cAF,
   camelCase,
   capitalize,
   chunk,
   clamp,
   days,
+  debounce,
+  ensurePrefix,
+  ensureSuffix,
   flatCase,
+  flattenArrayable,
   getObjectType,
-  hasOwnProperty,
+  hasOwn,
   hours,
   isArray,
+  isArrayEqual,
   isBoolean,
   isBrowser,
+  isEmptyString,
+  isEmptyStringOrWhitespace,
   isFunction,
   isInteger,
   isNativePromise,
+  isNil,
   isNull,
   isNumber,
+  isNumbericString,
+  isObject,
   isPromise,
+  isRegExp,
+  isSet,
   isString,
   isUndefined,
   isUppercase,
+  isWhitespaceString,
   join,
   kebabCase,
+  last,
   lowerFirst,
+  mergeArrayable,
   minutes,
   noop,
   omit,
+  once,
   pascalCase,
   pick,
   rAF,
   seconds,
+  slash,
   snakeCase,
+  sortObject,
   splitByCase,
+  throttle,
   titleCase,
   toArray,
   trainCase,
+  unindent,
   unique,
   uniqueBy,
   upperFirst,

package/dist/index.d.cts

@@ -9,12 +9,24 @@ export * from 'scule';
 declare function getObjectType(value: unknown): string;
 declare function isString(value: unknown): value is string;
 declare function isNumber(value: unknown): value is number;
+declare function isEmptyString(value: unknown): value is '';
+type Whitespace = ' ';
+type NonEmptyString = string & {
+    0: '';
+};
+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 isInteger(value: unknown): value is number;
 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 isUndefined(value: unknown): value is undefined;
 declare function isNull(value: unknown): value is null;
+declare function isNil(value: unknown): value is null | undefined;
+declare function isObject(value: unknown): value is object;
+declare function isRegExp(value: unknown): value is RegExp;
+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>;
 
@@ -27,6 +39,8 @@ declare const noop: () => void;
  */
 declare const NOOP: () => void;
 
+declare function once<T extends unknown[]>(func: (...args: T) => void): (this: unknown, ...args: T) => boolean;
+
 /**
  * @file env.ts
  */
@@ -98,8 +112,43 @@ declare function clamp(value: number, min?: number, max?: number): number;
  */
 declare function waitFor(ms: number): Promise<unknown>;
 
+interface ThrottleDebounceOptions {
+    /**
+     * @default false
+     */
+    isDebounce?: boolean;
+}
+/**
+ * Throttle a function to limit its execution to a maximum of once per a specified time interval.
+ *
+ * @param delay - Zero or greater delay in milliseconds
+ * @param callback - A function to be throttled
+ * @param options - throttle options
+ * @returns A throttled function
+ */
+declare function throttle<T extends ((...args: any[]) => undefined | void) | undefined | null>(delay: number, callback: Exclude<T, undefined | null>, options?: ThrottleDebounceOptions): T & {
+    cancel: () => void;
+};
+declare function debounce<T extends ((...args: any[]) => undefined | void) | undefined | null>(delay: number, callback: Exclude<T, undefined | null>, options?: ThrottleDebounceOptions): T & {
+    cancel: () => void;
+};
+
 declare const warnOnce: (message: string) => void;
 
+/**
+ * Get array item by index, negative for backward
+ * @param array - given array
+ * @param index - index of item
+ * @returns undefined if not match, otherwise matched item
+ */
+declare function at<T>(array: readonly T[], index: number): T | undefined;
+/**
+ * Get the last item of given array
+ * @param array - given array
+ * @returns undefined if empty array, otherwise last item
+ */
+declare function last<T>(array: readonly T[]): T | undefined;
+
 /**
  * Splits an array into smaller chunks of a given size.
  * @param array The array to split
@@ -127,7 +176,11 @@ type MayBe<T> = T | undefined;
 type AnyFn<T = any, R = any> = (...args: T[]) => R;
 type Arrayable<T> = T | T[];
 type Awaitable<T> = T | Promise<T>;
-type Prettify<T> = Omit<T, never>;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type PrettifyV2<T> = Omit<T, never>;
+type PrimitiveType = number | bigint | string | boolean | symbol | null | undefined;
 
 /**
  * Converts a value to an array.
@@ -136,10 +189,25 @@ type Prettify<T> = Omit<T, never>;
  */
 declare function toArray<T>(array?: Nullable<Arrayable<T>>): T[];
 
+/**
+ * Convert `Arrayable<T>` to `Array<T>` and flatten the result
+ * @param array - given array
+ * @returns Array<T>
+ */
+declare function flattenArrayable<T>(array?: Nullable<Arrayable<T | Array<T>>>): Array<T>;
+/**
+ * Use rest arguments to merge arrays
+ * @param args - rest arguments
+ * @returns Array<T>
+ */
+declare function mergeArrayable<T>(...args: Nullable<Arrayable<T>>[]): Array<T>;
+
+declare function isArrayEqual(array1: unknown[], array2: unknown[]): boolean;
+
 type JoinableValue = string | number | null | undefined;
 interface JoinOptions {
     /**
-     * @default '''
+     * @default ''
      */
     separator?: string;
 }
@@ -151,10 +219,52 @@ interface JoinOptions {
  */
 declare function join(array: JoinableValue[], options?: JoinOptions): string;
 
+/**
+ * Replace backslash to slash
+ */
+declare function slash(input: string): string;
+
+/**
+ * Remove leading whitespace from a template string
+ * Empty lines at the beginning and end of the template string are also removed.
+ * @param input template string
+ *
+ * @example
+ *
+ * ```ts
+ * const str = unindent`
+ *   if (foo) {
+ *     bar()
+ *   }
+ * `
+ * ```
+ */
+declare function unindent(input: TemplateStringsArray | string): string;
+
+declare function ensurePrefix(input: string, prefix: string): string;
+
+declare function ensureSuffix(input: string, suffix: string): string;
+
 declare function omit<T, K extends keyof T>(object: T, ...keys: K[]): Omit<T, K>;
 
 declare function pick<T, K extends keyof T>(object: T, keys: K[]): Pick<T, K>;
 
-declare function hasOwnProperty<T, K extends keyof T>(object: T, key: K): boolean;
+declare function hasOwn<T, K extends keyof T>(object: T, key: K): boolean;
+
+interface SortObjectOptions {
+    /**
+     * Recursive sorting
+     * @default false
+     */
+    deep?: boolean;
+    /**
+     * Compare function
+     */
+    compareFn?: (left: string, right: string) => number;
+}
+/**
+ * Sort object properties
+ */
+declare function sortObject<T extends Record<string, any>>(obj: T, options?: SortObjectOptions): T;
 
-export { type AnyFn, type Arrayable, type Awaitable, type MayBe, NOOP, type Nullable, type Prettify, cAF, capitalize, chunk, clamp, days, getObjectType, hasOwnProperty, hours, isArray, isBoolean, isBrowser, isFunction, isInteger, isNativePromise, isNull, isNumber, isPromise, isString, isUndefined, join, minutes, noop, omit, pick, rAF, seconds, toArray, unique, uniqueBy, waitFor, warnOnce, weeks };
+export { type AnyFn, type Arrayable, type Awaitable, type MayBe, NOOP, type NonEmptyString, type Nullable, type Prettify, type PrettifyV2, type PrimitiveType, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, days, debounce, ensurePrefix, ensureSuffix, flattenArrayable, getObjectType, hasOwn, hours, isArray, isArrayEqual, isBoolean, isBrowser, isEmptyString, isEmptyStringOrWhitespace, isFunction, isInteger, isNativePromise, isNil, isNull, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.d.ts

@@ -9,12 +9,24 @@ export * from 'scule';
 declare function getObjectType(value: unknown): string;
 declare function isString(value: unknown): value is string;
 declare function isNumber(value: unknown): value is number;
+declare function isEmptyString(value: unknown): value is '';
+type Whitespace = ' ';
+type NonEmptyString = string & {
+    0: '';
+};
+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 isInteger(value: unknown): value is number;
 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 isUndefined(value: unknown): value is undefined;
 declare function isNull(value: unknown): value is null;
+declare function isNil(value: unknown): value is null | undefined;
+declare function isObject(value: unknown): value is object;
+declare function isRegExp(value: unknown): value is RegExp;
+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>;
 
@@ -27,6 +39,8 @@ declare const noop: () => void;
  */
 declare const NOOP: () => void;
 
+declare function once<T extends unknown[]>(func: (...args: T) => void): (this: unknown, ...args: T) => boolean;
+
 /**
  * @file env.ts
  */
@@ -98,8 +112,43 @@ declare function clamp(value: number, min?: number, max?: number): number;
  */
 declare function waitFor(ms: number): Promise<unknown>;
 
+interface ThrottleDebounceOptions {
+    /**
+     * @default false
+     */
+    isDebounce?: boolean;
+}
+/**
+ * Throttle a function to limit its execution to a maximum of once per a specified time interval.
+ *
+ * @param delay - Zero or greater delay in milliseconds
+ * @param callback - A function to be throttled
+ * @param options - throttle options
+ * @returns A throttled function
+ */
+declare function throttle<T extends ((...args: any[]) => undefined | void) | undefined | null>(delay: number, callback: Exclude<T, undefined | null>, options?: ThrottleDebounceOptions): T & {
+    cancel: () => void;
+};
+declare function debounce<T extends ((...args: any[]) => undefined | void) | undefined | null>(delay: number, callback: Exclude<T, undefined | null>, options?: ThrottleDebounceOptions): T & {
+    cancel: () => void;
+};
+
 declare const warnOnce: (message: string) => void;
 
+/**
+ * Get array item by index, negative for backward
+ * @param array - given array
+ * @param index - index of item
+ * @returns undefined if not match, otherwise matched item
+ */
+declare function at<T>(array: readonly T[], index: number): T | undefined;
+/**
+ * Get the last item of given array
+ * @param array - given array
+ * @returns undefined if empty array, otherwise last item
+ */
+declare function last<T>(array: readonly T[]): T | undefined;
+
 /**
  * Splits an array into smaller chunks of a given size.
  * @param array The array to split
@@ -127,7 +176,11 @@ type MayBe<T> = T | undefined;
 type AnyFn<T = any, R = any> = (...args: T[]) => R;
 type Arrayable<T> = T | T[];
 type Awaitable<T> = T | Promise<T>;
-type Prettify<T> = Omit<T, never>;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type PrettifyV2<T> = Omit<T, never>;
+type PrimitiveType = number | bigint | string | boolean | symbol | null | undefined;
 
 /**
  * Converts a value to an array.
@@ -136,10 +189,25 @@ type Prettify<T> = Omit<T, never>;
  */
 declare function toArray<T>(array?: Nullable<Arrayable<T>>): T[];
 
+/**
+ * Convert `Arrayable<T>` to `Array<T>` and flatten the result
+ * @param array - given array
+ * @returns Array<T>
+ */
+declare function flattenArrayable<T>(array?: Nullable<Arrayable<T | Array<T>>>): Array<T>;
+/**
+ * Use rest arguments to merge arrays
+ * @param args - rest arguments
+ * @returns Array<T>
+ */
+declare function mergeArrayable<T>(...args: Nullable<Arrayable<T>>[]): Array<T>;
+
+declare function isArrayEqual(array1: unknown[], array2: unknown[]): boolean;
+
 type JoinableValue = string | number | null | undefined;
 interface JoinOptions {
     /**
-     * @default '''
+     * @default ''
      */
     separator?: string;
 }
@@ -151,10 +219,52 @@ interface JoinOptions {
  */
 declare function join(array: JoinableValue[], options?: JoinOptions): string;
 
+/**
+ * Replace backslash to slash
+ */
+declare function slash(input: string): string;
+
+/**
+ * Remove leading whitespace from a template string
+ * Empty lines at the beginning and end of the template string are also removed.
+ * @param input template string
+ *
+ * @example
+ *
+ * ```ts
+ * const str = unindent`
+ *   if (foo) {
+ *     bar()
+ *   }
+ * `
+ * ```
+ */
+declare function unindent(input: TemplateStringsArray | string): string;
+
+declare function ensurePrefix(input: string, prefix: string): string;
+
+declare function ensureSuffix(input: string, suffix: string): string;
+
 declare function omit<T, K extends keyof T>(object: T, ...keys: K[]): Omit<T, K>;
 
 declare function pick<T, K extends keyof T>(object: T, keys: K[]): Pick<T, K>;
 
-declare function hasOwnProperty<T, K extends keyof T>(object: T, key: K): boolean;
+declare function hasOwn<T, K extends keyof T>(object: T, key: K): boolean;
+
+interface SortObjectOptions {
+    /**
+     * Recursive sorting
+     * @default false
+     */
+    deep?: boolean;
+    /**
+     * Compare function
+     */
+    compareFn?: (left: string, right: string) => number;
+}
+/**
+ * Sort object properties
+ */
+declare function sortObject<T extends Record<string, any>>(obj: T, options?: SortObjectOptions): T;
 
-export { type AnyFn, type Arrayable, type Awaitable, type MayBe, NOOP, type Nullable, type Prettify, cAF, capitalize, chunk, clamp, days, getObjectType, hasOwnProperty, hours, isArray, isBoolean, isBrowser, isFunction, isInteger, isNativePromise, isNull, isNumber, isPromise, isString, isUndefined, join, minutes, noop, omit, pick, rAF, seconds, toArray, unique, uniqueBy, waitFor, warnOnce, weeks };
+export { type AnyFn, type Arrayable, type Awaitable, type MayBe, NOOP, type NonEmptyString, type Nullable, type Prettify, type PrettifyV2, type PrimitiveType, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, days, debounce, ensurePrefix, ensureSuffix, flattenArrayable, getObjectType, hasOwn, hours, isArray, isArrayEqual, isBoolean, isBrowser, isEmptyString, isEmptyStringOrWhitespace, isFunction, isInteger, isNativePromise, isNil, isNull, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.js

@@ -8,6 +8,18 @@ function isString(value) {
 function isNumber(value) {
   return typeof value === "number";
 }
+function isEmptyString(value) {
+  return isString(value) && value.length === 0;
+}
+function isWhitespaceString(value) {
+  return isString(value) && /^\s*$/.test(value);
+}
+function isEmptyStringOrWhitespace(value) {
+  return isEmptyString(value) || isWhitespaceString(value);
+}
+function isNumbericString(value) {
+  return isString(value) && !isEmptyStringOrWhitespace(value) && !Number.isNaN(Number(value));
+}
 function isInteger(value) {
   return Number.isInteger(value);
 }
@@ -26,6 +38,18 @@ function isUndefined(value) {
 function isNull(value) {
   return value === null;
 }
+function isNil(value) {
+  return isNull(value) || isUndefined(value);
+}
+function isObject(value) {
+  return getObjectType(value) === "Object";
+}
+function isRegExp(value) {
+  return getObjectType(value) === "RegExp";
+}
+function isSet(value) {
+  return getObjectType(value) === "Set";
+}
 function isNativePromise(value) {
   return getObjectType(value) === "Promise";
 }
@@ -41,6 +65,19 @@ var noop = () => {
 };
 var NOOP = noop;
 
+// src/fn/once.ts
+function once(func) {
+  let called = false;
+  return function(...args) {
+    if (called) {
+      return false;
+    }
+    called = true;
+    func.apply(this, args);
+    return true;
+  };
+}
+
 // src/env/isBrowser.ts
 var isBrowser = () => typeof document !== "undefined";
 
@@ -178,6 +215,53 @@ function waitFor(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+// src/misc/throttle.ts
+function throttle(delay, callback, options = {}) {
+  const { isDebounce } = options;
+  let lastExec = 0;
+  let cancelled = false;
+  let timeoutId;
+  function clearExistingTimeout() {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+  }
+  function cancel() {
+    clearExistingTimeout();
+    cancelled = true;
+  }
+  function wrapper(...args) {
+    if (cancelled) return;
+    const _this = this;
+    const now = Date.now();
+    const elapsed = now - lastExec;
+    function clear() {
+      timeoutId = void 0;
+    }
+    function exec(cur) {
+      lastExec = cur || Date.now();
+      callback.apply(_this, args);
+    }
+    if (isDebounce && !timeoutId) {
+      exec(now);
+    }
+    clearExistingTimeout();
+    if (!isDebounce && elapsed > delay) {
+      exec(now);
+    } else {
+      timeoutId = setTimeout(isDebounce ? clear : exec, isDebounce ? delay : delay - elapsed);
+    }
+  }
+  wrapper.cancel = cancel;
+  return wrapper;
+}
+function debounce(delay, callback, options = {}) {
+  return throttle(delay, callback, {
+    ...options,
+    isDebounce: true
+  });
+}
+
 // src/misc/warnOnce.ts
 var warned = /* @__PURE__ */ new Set();
 var warnOnce = (message) => {
@@ -188,6 +272,19 @@ var warnOnce = (message) => {
   console.warn(message);
 };
 
+// src/array/at.ts
+function at(array, index) {
+  const length = array.length;
+  if (!length) return void 0;
+  if (index < 0) {
+    index += length;
+  }
+  return array[index];
+}
+function last(array) {
+  return at(array, -1);
+}
+
 // src/array/chunk.ts
 function chunk(array, size) {
   const result = [];
@@ -217,6 +314,22 @@ function toArray(array) {
   return Array.isArray(array) ? array : [array];
 }
 
+// src/array/arrayable.ts
+function flattenArrayable(array) {
+  return toArray(array).flat(1);
+}
+function mergeArrayable(...args) {
+  return args.flatMap((i) => toArray(i));
+}
+
+// src/array/isArrayEqual.ts
+function isArrayEqual(array1, array2) {
+  if (array1.length !== array2.length) {
+    return false;
+  }
+  return array1.every((item, idx) => item === array2[idx]);
+}
+
 // src/string/join.ts
 function join(array, options = {}) {
   const { separator = "" } = options;
@@ -224,14 +337,52 @@ function join(array, options = {}) {
   return array.filter((v) => Boolean(v) || v === 0).join(separator);
 }
 
+// src/string/slash.ts
+function slash(input) {
+  return input.replace(/\\/g, "/");
+}
+
+// src/string/unindent.ts
+var _RE_FULL_WS = /^\s*$/;
+function unindent(input) {
+  const lines = (typeof input === "string" ? input : input[0]).split("\n");
+  const whitespaceLines = lines.map((line) => _RE_FULL_WS.test(line));
+  const commonIndent = lines.reduce((min, line, idx) => {
+    if (!whitespaceLines[idx]) {
+      return min;
+    }
+    const indent = line.match(/^\s/)?.[0].length;
+    return indent === void 0 ? min : Math.min(min, indent);
+  }, Number.POSITIVE_INFINITY);
+  let emptylinesHead = 0;
+  while (emptylinesHead < lines.length && whitespaceLines[emptylinesHead]) {
+    emptylinesHead++;
+  }
+  let emptylinesTail = 0;
+  while (emptylinesTail < lines.length && whitespaceLines[lines.length - emptylinesTail - 1]) {
+    emptylinesTail++;
+  }
+  return lines.slice(emptylinesHead, lines.length - emptylinesTail).map((line) => line.slice(commonIndent)).join("\n");
+}
+
+// src/string/ensurePrefix.ts
+function ensurePrefix(input, prefix) {
+  return input.startsWith(prefix) ? input : `${prefix}${input}`;
+}
+
+// src/string/ensureSuffix.ts
+function ensureSuffix(input, suffix) {
+  return input.endsWith(suffix) ? input : `${input}${suffix}`;
+}
+
 // src/object/omit.ts
 function omit(object, ...keys) {
   keys.forEach((key) => delete object[key]);
   return object;
 }
 
-// src/object/hasOwnProperty.ts
-function hasOwnProperty(object, key) {
+// src/object/hasOwn.ts
+function hasOwn(object, key) {
   return Object.prototype.hasOwnProperty.call(object, key);
 }
 
@@ -240,51 +391,103 @@ function pick(object, keys) {
   return Object.assign(
     {},
     ...keys.map((key) => {
-      if (object && hasOwnProperty(object, key)) {
+      if (object && hasOwn(object, key)) {
         return { [key]: object[key] };
       }
     })
   );
 }
+
+// src/object/isPlainObject.ts
+function isPlainObject(value) {
+  if (!isObject(value)) return false;
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
+}
+
+// src/object/sortObject.ts
+function sortObject(obj, options = {}) {
+  const { compareFn = (a, b) => a.localeCompare(b) } = options;
+  function sortKeys(obj2) {
+    const sortedKeys = Object.keys(obj2).sort(compareFn);
+    const result = {};
+    for (const key of sortedKeys) {
+      const value = obj2[key];
+      let newValue;
+      if (options.deep && isPlainObject(value)) {
+        newValue = sortKeys(value);
+      } else {
+        newValue = value;
+      }
+      Object.defineProperty(result, key, {
+        ...Object.getOwnPropertyDescriptor(obj2, key),
+        value: newValue
+      });
+    }
+    return result;
+  }
+  return sortKeys(obj);
+}
 export {
   NOOP,
+  at,
   cAF,
   camelCase,
   capitalize,
   chunk,
   clamp,
   days,
+  debounce,
+  ensurePrefix,
+  ensureSuffix,
   flatCase,
+  flattenArrayable,
   getObjectType,
-  hasOwnProperty,
+  hasOwn,
   hours,
   isArray,
+  isArrayEqual,
   isBoolean,
   isBrowser,
+  isEmptyString,
+  isEmptyStringOrWhitespace,
   isFunction,
   isInteger,
   isNativePromise,
+  isNil,
   isNull,
   isNumber,
+  isNumbericString,
+  isObject,
   isPromise,
+  isRegExp,
+  isSet,
   isString,
   isUndefined,
   isUppercase,
+  isWhitespaceString,
   join,
   kebabCase,
+  last,
   lowerFirst,
+  mergeArrayable,
   minutes,
   noop,
   omit,
+  once,
   pascalCase,
   pick,
   rAF,
   seconds,
+  slash,
   snakeCase,
+  sortObject,
   splitByCase,
+  throttle,
   titleCase,
   toArray,
   trainCase,
+  unindent,
   unique,
   uniqueBy,
   upperFirst,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Common used utils.",
   "keywords": [
     "utils"
@@ -12,10 +12,10 @@
     "email": "ntnyq13@gmail.com"
   },
   "homepage": "https://github.com/ntnyq/utils#readme",
+  "repository": "ntnyq/utils",
   "bugs": {
     "url": "https://github.com/ntnyq/utils/issues"
   },
-  "repository": "ntnyq/utils",
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -40,19 +40,18 @@
     "scule": "^1.3.0"
   },
   "devDependencies": {
-    "@ntnyq/eslint-config": "^3.0.0-beta.19",
+    "@ntnyq/eslint-config": "^3.2.2",
     "@ntnyq/prettier-config": "^1.21.3",
-    "@vitest/coverage-v8": "^2.1.2",
-    "bumpp": "^9.7.1",
-    "eslint": "^9.12.0",
+    "@vitest/coverage-v8": "^2.1.5",
+    "bumpp": "^9.8.1",
+    "eslint": "^9.14.0",
     "husky": "^9.1.6",
     "nano-staged": "^0.8.0",
-    "npm-run-all2": "^6.2.3",
-    "pnpm": "^9.12.1",
+    "npm-run-all2": "^7.0.1",
     "prettier": "^3.3.3",
-    "tsup": "^8.3.0",
+    "tsup": "^8.3.5",
     "typescript": "^5.6.3",
-    "vitest": "^2.1.2"
+    "vitest": "^2.1.5"
   },
   "engines": {
     "node": ">=18.18.0"