@ntnyq/utils 0.1.2 → 0.1.3

package/dist/index.cjs

@@ -24,9 +24,12 @@ __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,
@@ -45,7 +48,9 @@ __export(src_exports, {
   lowerFirst: () => lowerFirst,
   minutes: () => minutes,
   noop: () => noop,
+  omit: () => omit,
   pascalCase: () => pascalCase,
+  pick: () => pick,
   rAF: () => rAF,
   seconds: () => seconds,
   snakeCase: () => snakeCase,
@@ -232,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));
@@ -247,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));
@@ -273,15 +292,41 @@ 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,
@@ -300,7 +345,9 @@ function join(array, options = {}) {
   lowerFirst,
   minutes,
   noop,
+  omit,
   pascalCase,
+  pick,
   rAF,
   seconds,
   snakeCase,

package/dist/index.d.cts

@@ -74,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
  *
@@ -91,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.
@@ -134,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, getObjectType, hours, isArray, isBoolean, isBrowser, isFunction, isInteger, isNativePromise, isNull, isNumber, isPromise, isString, isUndefined, 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

@@ -74,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
  *
@@ -91,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.
@@ -134,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, getObjectType, hours, isArray, isBoolean, isBrowser, isFunction, isInteger, isNativePromise, isNull, isNumber, isPromise, isString, isUndefined, 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

@@ -168,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));
@@ -183,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));
@@ -209,14 +223,40 @@ 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,
@@ -235,7 +275,9 @@ export {
   lowerFirst,
   minutes,
   noop,
+  omit,
   pascalCase,
+  pick,
   rAF,
   seconds,
   snakeCase,

package/package.json

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