@tb-dev/utils 3.2.1 → 3.3.0

package/dist/array/index.d.ts

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

package/dist/array/trim-array.d.ts

@@ -1,2 +1,9 @@
+export interface TrimArrayOptions {
+    /**
+     * Whether to allow empty strings.
+     * @default false
+     */
+    allowEmpty?: boolean;
+}
 /** Trims each string in the array, removing any empty strings. */
-export declare function trimArray(array: string[]): string[];
+export declare function trimArray(array: string[], options?: TrimArrayOptions): string[];

package/dist/index.cjs

@@ -23,14 +23,15 @@ function toArray(item) {
   const array = item ?? [];
   return Array.isArray(array) ? array : [array];
 }
-function trimArray(array) {
-  return array.map((it) => it.trim()).filter(Boolean);
+function trimArray(array, options = {}) {
+  const _array = array.map((it) => it.trim());
+  return options.allowEmpty ? _array : _array.filter(Boolean);
 }
 function panic(...args) {
   throw new Error(args.join(" "));
 }
 function todo(...args) {
-  panic(format("TODO", args));
+  panic(format("not yet implemented", args));
 }
 function unimplemented(...args) {
   panic(format("not implemented", args));
@@ -45,14 +46,14 @@ function format(base, args) {
   }
   return message;
 }
-function splitWhitespace(value) {
+function splitWhitespace(value, options = {}) {
   if (!value) return [];
   if (Array.isArray(value)) {
-    const array = value.map((it) => splitWhitespace(it));
+    const array = value.map((it) => splitWhitespace(it, options));
     return array.flat(Number.POSITIVE_INFINITY);
   }
   value = value.trim().split(/\s/);
-  return trimArray(value);
+  return trimArray(value, options);
 }
 function sleep(ms) {
   return new Promise((resolve) => void setTimeout(resolve, ms));

package/dist/index.js

@@ -21,14 +21,15 @@ function toArray(item) {
   const array = item ?? [];
   return Array.isArray(array) ? array : [array];
 }
-function trimArray(array) {
-  return array.map((it) => it.trim()).filter(Boolean);
+function trimArray(array, options = {}) {
+  const _array = array.map((it) => it.trim());
+  return options.allowEmpty ? _array : _array.filter(Boolean);
 }
 function panic(...args) {
   throw new Error(args.join(" "));
 }
 function todo(...args) {
-  panic(format("TODO", args));
+  panic(format("not yet implemented", args));
 }
 function unimplemented(...args) {
   panic(format("not implemented", args));
@@ -43,14 +44,14 @@ function format(base, args) {
   }
   return message;
 }
-function splitWhitespace(value) {
+function splitWhitespace(value, options = {}) {
   if (!value) return [];
   if (Array.isArray(value)) {
-    const array = value.map((it) => splitWhitespace(it));
+    const array = value.map((it) => splitWhitespace(it, options));
     return array.flat(Number.POSITIVE_INFINITY);
   }
   value = value.trim().split(/\s/);
-  return trimArray(value);
+  return trimArray(value, options);
 }
 function sleep(ms) {
   return new Promise((resolve) => void setTimeout(resolve, ms));

package/dist/string/index.d.ts

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

package/dist/string/split-whitespace.d.ts

@@ -1,4 +1,6 @@
 import { Nullish } from '../types';
+import { TrimArrayOptions } from '../array/trim-array';
+export type SplitWhitespaceOptions = TrimArrayOptions;
 /**
  * Splits a string or an array of strings (recursively) by whitespace.
  *
@@ -9,4 +11,4 @@ import { Nullish } from '../types';
  * splitWhitespace(['a ', ['b', ['c d']]]); // ['a', 'b', 'c', 'd']
  * ```
  */
-export declare function splitWhitespace(value: Nullish<string | string[]>): string[];
+export declare function splitWhitespace(value: Nullish<string | string[]>, options?: SplitWhitespaceOptions): string[];

package/dist/types.d.ts

@@ -27,6 +27,7 @@ export type PickByValue<T, V> = {
 export type PickPartial<T, K extends keyof T> = Pick<Partial<T>, K>;
 /** Constructs a type by picking the set of properties `K` from a required version of `T`. */
 export type PickRequired<T, K extends keyof T> = Pick<Required<T>, K>;
+/** Removes the readonly modifier from all properties of T. */
 export type Writeable<T> = {
     -readonly [P in keyof T]: T[P];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tb-dev/utils",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "TypeScript utils",
   "license": "MIT",
   "type": "module",
@@ -26,20 +26,20 @@
     "*.{?(c|m)@(j|t)s,css,vue,md,json}": "prettier --write"
   },
   "devDependencies": {
-    "@tb-dev/eslint-config": "^5.2.2",
-    "@types/node": "^22.5.2",
-    "@vitest/ui": "^2.0.5",
-    "eslint": "^9.9.1",
-    "husky": "^9.1.5",
+    "@tb-dev/eslint-config": "^5.3.2",
+    "@types/node": "^22.5.4",
+    "@vitest/ui": "^2.1.1",
+    "eslint": "^9.10.0",
+    "husky": "^9.1.6",
     "lint-staged": "^15.2.10",
     "prettier": "^3.3.3",
     "tslib": "^2.7.0",
-    "typedoc": "^0.26.6",
-    "typedoc-plugin-mdn-links": "^3.2.11",
-    "typescript": "^5.5.4",
-    "vite": "^5.4.2",
-    "vite-plugin-dts": "^4.1.0",
-    "vitest": "^2.0.5"
+    "typedoc": "^0.26.7",
+    "typedoc-plugin-mdn-links": "^3.2.12",
+    "typescript": "^5.6.2",
+    "vite": "^5.4.5",
+    "vite-plugin-dts": "^4.2.1",
+    "vitest": "^2.1.1"
   },
   "files": [
     "dist"