@ntnyq/utils 0.1.1 → 0.1.3

package/dist/index.cjs

@@ -24,17 +24,33 @@ __export(src_exports, {
   cAF: () => cAF,
   camelCase: () => camelCase,
   capitalize: () => capitalize,
+  chunk: () => chunk,
+  clamp: () => clamp,
   days: () => days,
   flatCase: () => flatCase,
+  getObjectType: () => getObjectType,
+  hasOwnProperty: () => hasOwnProperty,
   hours: () => hours,
+  isArray: () => isArray,
+  isBoolean: () => isBoolean,
   isBrowser: () => isBrowser,
+  isFunction: () => isFunction,
+  isInteger: () => isInteger,
+  isNativePromise: () => isNativePromise,
+  isNull: () => isNull,
+  isNumber: () => isNumber,
+  isPromise: () => isPromise,
+  isString: () => isString,
+  isUndefined: () => isUndefined,
   isUppercase: () => isUppercase,
   join: () => join,
   kebabCase: () => kebabCase,
   lowerFirst: () => lowerFirst,
   minutes: () => minutes,
   noop: () => noop,
+  omit: () => omit,
   pascalCase: () => pascalCase,
+  pick: () => pick,
   rAF: () => rAF,
   seconds: () => seconds,
   snakeCase: () => snakeCase,
@@ -51,6 +67,44 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/is/index.ts
+function getObjectType(value) {
+  return Object.prototype.toString.call(value).slice(8, -1);
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isInteger(value) {
+  return Number.isInteger(value);
+}
+function isBoolean(value) {
+  return typeof value === "boolean";
+}
+function isFunction(value) {
+  return typeof value === "function";
+}
+function isArray(value) {
+  return Array.isArray(value);
+}
+function isUndefined(value) {
+  return value === void 0;
+}
+function isNull(value) {
+  return value === null;
+}
+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);
+}
+
 // src/fn/noop.ts
 var noop = () => {
 };
@@ -183,6 +237,11 @@ function weeks(count) {
   return count * ONE_WEEK;
 }
 
+// src/misc/clamp.ts
+function clamp(value, min = Number.NEGATIVE_INFINITY, max = Number.POSITIVE_INFINITY) {
+  return Math.min(Math.max(value, min), max);
+}
+
 // src/misc/waitFor.ts
 function waitFor(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -198,6 +257,15 @@ var warnOnce = (message) => {
   console.warn(message);
 };
 
+// src/array/chunk.ts
+function chunk(array, size) {
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+
 // src/array/unique.ts
 function unique(array) {
   return Array.from(new Set(array));
@@ -224,23 +292,62 @@ function join(array, options = {}) {
   if (!Array.isArray(array) || !array.length) return "";
   return array.filter((v) => Boolean(v) || v === 0).join(separator);
 }
+
+// src/object/omit.ts
+function omit(object, ...keys) {
+  keys.forEach((key) => delete object[key]);
+  return object;
+}
+
+// src/object/hasOwnProperty.ts
+function hasOwnProperty(object, key) {
+  return Object.prototype.hasOwnProperty.call(object, key);
+}
+
+// src/object/pick.ts
+function pick(object, keys) {
+  return Object.assign(
+    {},
+    ...keys.map((key) => {
+      if (object && hasOwnProperty(object, key)) {
+        return { [key]: object[key] };
+      }
+    })
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   NOOP,
   cAF,
   camelCase,
   capitalize,
+  chunk,
+  clamp,
   days,
   flatCase,
+  getObjectType,
+  hasOwnProperty,
   hours,
+  isArray,
+  isBoolean,
   isBrowser,
+  isFunction,
+  isInteger,
+  isNativePromise,
+  isNull,
+  isNumber,
+  isPromise,
+  isString,
+  isUndefined,
   isUppercase,
   join,
   kebabCase,
   lowerFirst,
   minutes,
   noop,
+  omit,
   pascalCase,
+  pick,
   rAF,
   seconds,
   snakeCase,

package/dist/index.d.cts

@@ -1,6 +1,23 @@
 import { upperFirst } from 'scule';
 export * from 'scule';
 
+/**
+ * @file is utils
+ * @category is
+ * @copyright {@link https://github.com/sindresorhus/is}
+ */
+declare function getObjectType(value: unknown): string;
+declare function isString(value: unknown): value is string;
+declare function isNumber(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 isNativePromise<T = unknown>(value: unknown): value is Promise<T>;
+declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
+
 /**
  * A function that does nothing.
  */
@@ -57,6 +74,15 @@ declare function hours(count: number): number;
 declare function days(count: number): number;
 declare function weeks(count: number): number;
 
+/**
+ * Clamps a number between a minimum and maximum value
+ * @param value the value to clamp within the given range
+ * @param min the minimum value to clamp
+ * @param max the maximum value to clamp
+ * @returns the new value
+ */
+declare function clamp(value: number, min?: number, max?: number): number;
+
 /**
  * Wait for a number of milliseconds
  *
@@ -74,6 +100,14 @@ declare function waitFor(ms: number): Promise<unknown>;
 
 declare const warnOnce: (message: string) => void;
 
+/**
+ * Splits an array into smaller chunks of a given size.
+ * @param array The array to split
+ * @param size The size of each chunk
+ * @returns An array of arrays, where each sub-array has `size` elements from the original array.
+ */
+declare function chunk<T>(array: T[], size: number): T[][];
+
 /**
  * Returns a new array with unique values.
  * @param array - The array to process.
@@ -117,4 +151,10 @@ interface JoinOptions {
  */
 declare function join(array: JoinableValue[], options?: JoinOptions): string;
 
-export { type AnyFn, type Arrayable, type Awaitable, type MayBe, NOOP, type Nullable, type Prettify, cAF, capitalize, days, hours, isBrowser, join, minutes, noop, rAF, seconds, toArray, unique, uniqueBy, waitFor, warnOnce, weeks };
+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;
+
+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 };

package/dist/index.d.ts

@@ -1,6 +1,23 @@
 import { upperFirst } from 'scule';
 export * from 'scule';
 
+/**
+ * @file is utils
+ * @category is
+ * @copyright {@link https://github.com/sindresorhus/is}
+ */
+declare function getObjectType(value: unknown): string;
+declare function isString(value: unknown): value is string;
+declare function isNumber(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 isNativePromise<T = unknown>(value: unknown): value is Promise<T>;
+declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
+
 /**
  * A function that does nothing.
  */
@@ -57,6 +74,15 @@ declare function hours(count: number): number;
 declare function days(count: number): number;
 declare function weeks(count: number): number;
 
+/**
+ * Clamps a number between a minimum and maximum value
+ * @param value the value to clamp within the given range
+ * @param min the minimum value to clamp
+ * @param max the maximum value to clamp
+ * @returns the new value
+ */
+declare function clamp(value: number, min?: number, max?: number): number;
+
 /**
  * Wait for a number of milliseconds
  *
@@ -74,6 +100,14 @@ declare function waitFor(ms: number): Promise<unknown>;
 
 declare const warnOnce: (message: string) => void;
 
+/**
+ * Splits an array into smaller chunks of a given size.
+ * @param array The array to split
+ * @param size The size of each chunk
+ * @returns An array of arrays, where each sub-array has `size` elements from the original array.
+ */
+declare function chunk<T>(array: T[], size: number): T[][];
+
 /**
  * Returns a new array with unique values.
  * @param array - The array to process.
@@ -117,4 +151,10 @@ interface JoinOptions {
  */
 declare function join(array: JoinableValue[], options?: JoinOptions): string;
 
-export { type AnyFn, type Arrayable, type Awaitable, type MayBe, NOOP, type Nullable, type Prettify, cAF, capitalize, days, hours, isBrowser, join, minutes, noop, rAF, seconds, toArray, unique, uniqueBy, waitFor, warnOnce, weeks };
+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;
+
+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 };

package/dist/index.js

@@ -1,3 +1,41 @@
+// src/is/index.ts
+function getObjectType(value) {
+  return Object.prototype.toString.call(value).slice(8, -1);
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isInteger(value) {
+  return Number.isInteger(value);
+}
+function isBoolean(value) {
+  return typeof value === "boolean";
+}
+function isFunction(value) {
+  return typeof value === "function";
+}
+function isArray(value) {
+  return Array.isArray(value);
+}
+function isUndefined(value) {
+  return value === void 0;
+}
+function isNull(value) {
+  return value === null;
+}
+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);
+}
+
 // src/fn/noop.ts
 var noop = () => {
 };
@@ -130,6 +168,11 @@ function weeks(count) {
   return count * ONE_WEEK;
 }
 
+// src/misc/clamp.ts
+function clamp(value, min = Number.NEGATIVE_INFINITY, max = Number.POSITIVE_INFINITY) {
+  return Math.min(Math.max(value, min), max);
+}
+
 // src/misc/waitFor.ts
 function waitFor(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -145,6 +188,15 @@ var warnOnce = (message) => {
   console.warn(message);
 };
 
+// src/array/chunk.ts
+function chunk(array, size) {
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+
 // src/array/unique.ts
 function unique(array) {
   return Array.from(new Set(array));
@@ -171,22 +223,61 @@ function join(array, options = {}) {
   if (!Array.isArray(array) || !array.length) return "";
   return array.filter((v) => Boolean(v) || v === 0).join(separator);
 }
+
+// src/object/omit.ts
+function omit(object, ...keys) {
+  keys.forEach((key) => delete object[key]);
+  return object;
+}
+
+// src/object/hasOwnProperty.ts
+function hasOwnProperty(object, key) {
+  return Object.prototype.hasOwnProperty.call(object, key);
+}
+
+// src/object/pick.ts
+function pick(object, keys) {
+  return Object.assign(
+    {},
+    ...keys.map((key) => {
+      if (object && hasOwnProperty(object, key)) {
+        return { [key]: object[key] };
+      }
+    })
+  );
+}
 export {
   NOOP,
   cAF,
   camelCase,
   capitalize,
+  chunk,
+  clamp,
   days,
   flatCase,
+  getObjectType,
+  hasOwnProperty,
   hours,
+  isArray,
+  isBoolean,
   isBrowser,
+  isFunction,
+  isInteger,
+  isNativePromise,
+  isNull,
+  isNumber,
+  isPromise,
+  isString,
+  isUndefined,
   isUppercase,
   join,
   kebabCase,
   lowerFirst,
   minutes,
   noop,
+  omit,
   pascalCase,
+  pick,
   rAF,
   seconds,
   snakeCase,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Common used utils.",
   "keywords": [
     "utils"
@@ -40,19 +40,19 @@
     "scule": "^1.3.0"
   },
   "devDependencies": {
-    "@ntnyq/eslint-config": "^3.0.0-beta.17",
+    "@ntnyq/eslint-config": "^3.0.0-beta.19",
     "@ntnyq/prettier-config": "^1.21.3",
-    "@vitest/coverage-v8": "^2.1.1",
-    "bumpp": "^9.5.2",
-    "eslint": "^9.11.1",
+    "@vitest/coverage-v8": "^2.1.2",
+    "bumpp": "^9.7.1",
+    "eslint": "^9.12.0",
     "husky": "^9.1.6",
     "nano-staged": "^0.8.0",
     "npm-run-all2": "^6.2.3",
-    "pnpm": "^9.11.0",
+    "pnpm": "^9.12.1",
     "prettier": "^3.3.3",
     "tsup": "^8.3.0",
-    "typescript": "^5.6.2",
-    "vitest": "^2.1.1"
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.2"
   },
   "engines": {
     "node": ">=18.18.0"