@tb-dev/utils 5.1.4 → 6.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Andrew Ferreira
+Copyright (c) 2025 Andrew Ferreira <andrew.shien2@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/array/index.d.ts

@@ -1,3 +1,3 @@
-export { upsert } from './upsert';
-export { toArray } from './to-array';
-export { trimArray, type TrimArrayOptions } from './trim-array';
+export * from './to-array';
+export * from './trim-array';
+export * from './upsert';

package/dist/index.d.ts

@@ -1,20 +1,10 @@
-export * from './nil';
 export * from './array';
+export * from './function';
+export * from './nil';
+export * from './option';
 export * from './panic';
-export * from './regex';
-export * from './types';
-export * from './string';
 export * from './promise';
-export * from './function';
-/**
- * Checks if a value is empty.
- *
- * Arrays and strings are considered empty if they have a length of 0.
- * Map and Sets are considered empty if they have a size of 0.
- *
- * This function does not check for empty objects.
- * Any other value is considered empty only if it is nullish.
- */
-export declare function isEmpty(value?: unknown): boolean;
-/** Adds the pixel unit to a value. */
+export * from './string';
+export type * from './types';
+/** Adds the pixel unit to a value if it is a number. */
 export declare function toPixel(value: string | number): string;

package/dist/index.js

@@ -1,14 +1,14 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-const float = /^\d+(?:\.(\d+))?$/;
-const regex = {
-  float
-};
-function isNil(value) {
-  return value === void 0 || value === null;
+function toArray(item) {
+  const array = item ?? [];
+  return Array.isArray(array) ? array : [array];
+}
+function trimArray(array, options = {}) {
+  const _array = array.map((it) => it.trim());
+  return options.allowEmpty ? _array : _array.filter(Boolean);
 }
-const isNullish = isNil;
 function upsert(array, item, predicate) {
   const index = array.findIndex(predicate ?? ((value) => value === item));
   if (index === -1) {
@@ -17,14 +17,12 @@ function upsert(array, item, predicate) {
     array[index] = item;
   }
 }
-function toArray(item) {
-  const array = item ?? [];
-  return Array.isArray(array) ? array : [array];
-}
-function trimArray(array, options = {}) {
-  const _array = array.map((it) => it.trim());
-  return options.allowEmpty ? _array : _array.filter(Boolean);
+const noop = () => {
+};
+function isNil(value) {
+  return value === void 0 || value === null;
 }
+const isNullish = isNil;
 function panic(...args) {
   throw new Error(args.join(" "));
 }
@@ -44,17 +42,14 @@ function format(base, args) {
   }
   return message;
 }
-function splitWhitespace(value, options = {}) {
-  if (!value) return [];
-  if (Array.isArray(value)) {
-    const array = value.map((it) => splitWhitespace(it, options));
-    return array.flat(Number.POSITIVE_INFINITY);
-  }
-  value = value.trim().split(/\s/);
-  return trimArray(value, options);
+function unwrap(value, message = "`unwrap` called with a nil value") {
+  return isNil(value) ? panic(message) : value;
 }
-function sleep(ms) {
-  return new Promise((resolve) => void setTimeout(resolve, ms));
+function unwrapOr(value, other) {
+  return isNil(value) ? other : value;
+}
+function unwrapOrElse(value, fn) {
+  return isNil(value) ? fn() : value;
 }
 function flushPromises() {
   return new Promise((resolve) => void setTimeout(resolve, 0));
@@ -83,35 +78,31 @@ class PromiseSet {
     return set;
   }
 }
-const noop = () => {
-};
-function isEmpty(value) {
-  if (isNullish(value)) {
-    return true;
-  }
-  if (Array.isArray(value) || typeof value === "string") {
-    return value.length === 0;
-  }
-  if (value instanceof Map || value instanceof Set) {
-    return value.size === 0;
+function sleep(ms) {
+  return new Promise((resolve) => void setTimeout(resolve, ms));
+}
+function splitWhitespace(value, options = {}) {
+  if (value) {
+    if (Array.isArray(value)) {
+      const array = value.map((it) => splitWhitespace(it, options));
+      return array.flat(Number.POSITIVE_INFINITY);
+    }
+    value = value.trim().split(/\s/);
+    return trimArray(value, options);
   }
-  return false;
+  return [];
 }
 function toPixel(value) {
-  if (typeof value === "number" || typeof value === "string" && regex.float.test(value)) {
-    return `${value}px`;
-  }
+  if (typeof value === "number") return `${value}px`;
   return value;
 }
 export {
   PromiseSet,
   flushPromises,
-  isEmpty,
   isNil,
   isNullish,
   noop,
   panic,
-  regex,
   sleep,
   splitWhitespace,
   toArray,
@@ -120,5 +111,8 @@ export {
   trimArray,
   unimplemented,
   unreachable,
+  unwrap,
+  unwrapOr,
+  unwrapOrElse,
   upsert
 };

package/dist/nil/index.d.ts

@@ -1 +1 @@
-export { isNil, isNullish } from './is-nil';
+export * from './is-nil';

package/dist/option/index.d.ts

@@ -0,0 +1 @@
+export * from './unwrap';

package/dist/option/unwrap.d.ts

@@ -0,0 +1,4 @@
+import { Option } from '../types';
+export declare function unwrap<T>(value: Option<T>, message?: string): T;
+export declare function unwrapOr<T>(value: Option<T>, other: T): T;
+export declare function unwrapOrElse<T>(value: Option<T>, fn: () => T): T;

package/dist/promise/flush-promises.d.ts

@@ -1,2 +1,2 @@
-/** Flushes all pending promises. */
+/** Flushes pending promises. */
 export declare function flushPromises(): Promise<void>;

package/dist/promise/index.d.ts

@@ -1,3 +1,3 @@
-export { sleep } from './sleep';
-export { PromiseSet } from './promise-set';
-export { flushPromises } from './flush-promises';
+export * from './flush-promises';
+export * from './promise-set';
+export * from './sleep';

package/dist/string/index.d.ts

@@ -1 +1 @@
-export { splitWhitespace, type SplitWhitespaceOptions } from './split-whitespace';
+export * from './split-whitespace';

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@tb-dev/utils",
-  "version": "5.1.4",
+  "version": "6.0.0",
   "description": "TypeScript utils",
   "license": "MIT",
   "type": "module",
   "private": false,
+  "funding": "https://github.com/sponsors/ferreira-tb",
   "homepage": "https://tb.dev.br/utils/",
   "author": {
     "name": "Andrew Ferreira",
@@ -24,7 +25,7 @@
   ],
   "devDependencies": {
     "@tb-dev/eslint-config": "^6.7.1",
-    "@types/node": "^22.13.11",
+    "@types/node": "^22.13.14",
     "@vitest/ui": "^3.0.9",
     "eslint": "^9.23.0",
     "prettier": "^3.5.3",
@@ -32,7 +33,7 @@
     "typedoc": "^0.28.1",
     "typedoc-plugin-mdn-links": "^5.0.1",
     "typescript": "^5.8.2",
-    "vite": "^6.2.2",
+    "vite": "^6.2.3",
     "vite-plugin-dts": "^4.5.3",
     "vitest": "^3.0.9"
   },

package/dist/regex.d.ts

@@ -1,3 +0,0 @@
-export declare const regex: {
-    readonly float: RegExp;
-};