@tb-dev/utils 7.3.4 → 7.3.5

package/dist/index.js

@@ -1,111 +1,127 @@
+//#region src/array/to-array.ts
+/** Converts the item to an array if it isn't already. */
 function toArray(item) {
-  const array = item ?? [];
-  return Array.isArray(array) ? array : [array];
+	const array = item ?? [];
+	return Array.isArray(array) ? array : [array];
 }
-
+//#endregion
+//#region src/array/trim-array.ts
+/** Trims each string in the array, removing any empty strings. */
 function trimArray(array, options = {}) {
-  const _array = array.map((it) => it.trim());
-  return options.allowEmpty ? _array : _array.filter(Boolean);
+	const _array = array.map((it) => it.trim());
+	return options.allowEmpty ? _array : _array.filter(Boolean);
 }
-
+//#endregion
+//#region src/array/upsert.ts
+/** Pushes an item to the array if it doesn't exist, otherwise updates it. */
 function upsert(array, item, predicate) {
-  const index = array.findIndex(
-    predicate ?? ((value) => value === item)
-  );
-  if (index === -1) {
-    array.push(item);
-  } else {
-    array[index] = item;
-  }
-}
-
-const noop = () => {
-};
-
+	const index = array.findIndex(predicate ?? ((value) => value === item));
+	if (index === -1) array.push(item);
+	else array[index] = item;
+}
+//#endregion
+//#region src/function/noop.ts
+var noop = () => {};
+//#endregion
+//#region src/nil/is-nil.ts
 function isNil(value) {
-  return value === void 0 || value === null;
+	return value === void 0 || value === null;
 }
-
+//#endregion
+//#region src/panic/index.ts
+/** Throws an error with the given message. */
 function panic(...args) {
-  throw new Error(args.join(" "));
+	throw new Error(args.join(" "));
 }
 function todo(...args) {
-  panic(format("not yet implemented", args));
+	panic(format("not yet implemented", args));
 }
 function unimplemented(...args) {
-  panic(format("not implemented", args));
+	panic(format("not implemented", args));
 }
 function unreachable(...args) {
-  panic(format("unreachable", args));
+	panic(format("unreachable", args));
 }
 function format(base, args) {
-  let message = base;
-  if (args.length > 0) {
-    message = `${message}: ${args.join(" ")}`;
-  }
-  return message;
+	let message = base;
+	if (args.length > 0) message = `${message}: ${args.join(" ")}`;
+	return message;
 }
-
+//#endregion
+//#region src/option/unwrap.ts
 function unwrap(value, message = "`unwrap` called with a nil value") {
-  return isNil(value) ? panic(message) : value;
+	return isNil(value) ? panic(message) : value;
 }
 function unwrapOr(value, other) {
-  return isNil(value) ? other : value;
+	return isNil(value) ? other : value;
 }
 function unwrapOrElse(value, fn) {
-  return isNil(value) ? fn() : value;
+	return isNil(value) ? fn() : value;
 }
-
+//#endregion
+//#region src/promise/flush-promises.ts
+/** Flushes pending promises. */
 function flushPromises() {
-  return new Promise((resolve) => void setTimeout(resolve, 0));
-}
-
-class PromiseSet {
-  promises = /* @__PURE__ */ new Set();
-  chain(promise) {
-    this.promises.add(promise);
-    return this;
-  }
-  async join() {
-    await Promise.all(this.promises);
-    this.promises.clear();
-  }
-  async joinFlushed() {
-    await this.join();
-    await flushPromises();
-  }
-  static from(promises) {
-    const set = new PromiseSet();
-    for (const promise of promises) {
-      set.promises.add(promise);
-    }
-    return set;
-  }
-}
-
+	return new Promise((resolve) => void setTimeout(resolve, 0));
+}
+//#endregion
+//#region src/promise/promise-set.ts
+var PromiseSet = class PromiseSet {
+	promises = /* @__PURE__ */ new Set();
+	chain(promise) {
+		this.promises.add(promise);
+		return this;
+	}
+	async join() {
+		await Promise.all(this.promises);
+		this.promises.clear();
+	}
+	async joinFlushed() {
+		await this.join();
+		await flushPromises();
+	}
+	static from(promises) {
+		const set = new PromiseSet();
+		for (const promise of promises) set.promises.add(promise);
+		return set;
+	}
+};
+//#endregion
+//#region src/promise/sleep.ts
 function sleep(ms) {
-  return new Promise((resolve) => void setTimeout(resolve, ms));
+	return new Promise((resolve) => void setTimeout(resolve, ms));
 }
-
+//#endregion
+//#region src/promise/timeout.ts
 function timeout(f, ms) {
-  return Promise.race([f(), sleep(ms).then(() => null)]);
-}
-
+	return Promise.race([f(), sleep(ms).then(() => null)]);
+}
+//#endregion
+//#region src/string/split-whitespace.ts
+/**
+* Splits a string or an array of strings (recursively) by whitespace.
+*
+* @example
+* ```ts
+* splitWhitespace('a b c'); // ['a', 'b', 'c']
+* splitWhitespace(['a b', 'c']); // ['a', 'b', 'c']
+* splitWhitespace(['a ', ['b', ['c d']]]); // ['a', 'b', 'c', 'd']
+* ```
+*/
 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 [];
-}
-
+	if (value) {
+		if (Array.isArray(value)) return value.map((it) => splitWhitespace(it, options)).flat(Number.POSITIVE_INFINITY);
+		value = value.trim().split(/\s/);
+		return trimArray(value, options);
+	}
+	return [];
+}
+//#endregion
+//#region src/index.ts
+/** Adds the pixel unit to a value if it is a number. */
 function toPixel(value) {
-  if (typeof value === "number") return `${value}px`;
-  return value;
+	if (typeof value === "number") return `${value}px`;
+	return value;
 }
-
+//#endregion
 export { PromiseSet, flushPromises, isNil, noop, panic, sleep, splitWhitespace, timeout, toArray, toPixel, todo, trimArray, unimplemented, unreachable, unwrap, unwrapOr, unwrapOrElse, upsert };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tb-dev/utils",
-  "version": "7.3.4",
+  "version": "7.3.5",
   "description": "TypeScript utils",
   "license": "MIT",
   "type": "module",
@@ -24,17 +24,17 @@
     "typescript"
   ],
   "devDependencies": {
-    "@tb-dev/eslint-config": "^9.0.2",
-    "@types/node": "^25.3.0",
-    "@vitest/ui": "^4.0.18",
-    "eslint": "^10.0.2",
+    "@tb-dev/eslint-config": "^9.0.3",
+    "@types/node": "^25.5.0",
+    "@vitest/ui": "^4.1.0",
+    "eslint": "^10.0.3",
     "tslib": "^2.8.1",
     "typedoc": "^0.28.17",
     "typedoc-plugin-mdn-links": "^5.1.1",
     "typescript": "^5.9.3",
-    "vite": "^7.3.1",
+    "vite": "^8.0.0",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "files": [
     "dist"