@tb-dev/utils 1.5.2 → 1.7.0

package/dist/array.cjs

@@ -8,16 +8,6 @@ function upsert(array, item, predicate) {
     array[index] = item;
   }
 }
-function splitWhitespace(value) {
-  if (!value)
-    return [];
-  if (Array.isArray(value)) {
-    const array = value.map((i) => splitWhitespace(i));
-    return array.flat(Number.POSITIVE_INFINITY);
-  }
-  value = value.trim().split(/\s/);
-  return trimArray(value);
-}
 function toArray(item) {
   const array = item ?? [];
   return Array.isArray(array) ? array : [array];
@@ -25,7 +15,6 @@ function toArray(item) {
 function trimArray(array) {
   return array.map((i) => i.trim()).filter(Boolean);
 }
-exports.splitWhitespace = splitWhitespace;
 exports.toArray = toArray;
 exports.trimArray = trimArray;
 exports.upsert = upsert;

package/dist/array.d.ts

@@ -1,6 +1,6 @@
 import { MaybeArray, Nullish } from '@tb-dev/utility-types';
 
-export declare function upsert<T>(array: T[], item: T, predicate: (item: T) => boolean): void;
-export declare function splitWhitespace(value: Nullish<string | string[]>): string[];
+/** Pushes an item to the array if it doesn't exist, otherwise updates it. */
+export declare function upsert<T>(array: T[], item: T, predicate: (value: T) => boolean): void;
 export declare function toArray<T>(item?: Nullish<MaybeArray<T>>): T[];
 export declare function trimArray(array: string[]): string[];

package/dist/array.js

@@ -6,16 +6,6 @@ function upsert(array, item, predicate) {
     array[index] = item;
   }
 }
-function splitWhitespace(value) {
-  if (!value)
-    return [];
-  if (Array.isArray(value)) {
-    const array = value.map((i) => splitWhitespace(i));
-    return array.flat(Number.POSITIVE_INFINITY);
-  }
-  value = value.trim().split(/\s/);
-  return trimArray(value);
-}
 function toArray(item) {
   const array = item ?? [];
   return Array.isArray(array) ? array : [array];
@@ -24,7 +14,6 @@ function trimArray(array) {
   return array.map((i) => i.trim()).filter(Boolean);
 }
 export {
-  splitWhitespace,
   toArray,
   trimArray,
   upsert

package/dist/index.cjs

@@ -2,6 +2,23 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const regex = require("./regex.cjs");
 const array = require("./array.cjs");
+const panic = require("./panic.cjs");
+function splitWhitespace(value) {
+  if (!value)
+    return [];
+  if (Array.isArray(value)) {
+    const array2 = value.map((i) => splitWhitespace(i));
+    return array2.flat(Number.POSITIVE_INFINITY);
+  }
+  value = value.trim().split(/\s/);
+  return array.trimArray(value);
+}
+function flush() {
+  return new Promise((resolve) => void setTimeout(resolve, 0));
+}
+function sleep(ms) {
+  return new Promise((resolve) => void setTimeout(resolve, ms));
+}
 function isEmpty(value) {
   if (isNullish(value)) {
     return true;
@@ -26,11 +43,17 @@ function toPixel(value) {
   return value;
 }
 exports.regex = regex.regex;
-exports.splitWhitespace = array.splitWhitespace;
 exports.toArray = array.toArray;
 exports.trimArray = array.trimArray;
 exports.upsert = array.upsert;
+exports.panic = panic.panic;
+exports.todo = panic.todo;
+exports.unimplemented = panic.unimplemented;
+exports.unreachable = panic.unreachable;
+exports.flush = flush;
 exports.isEmpty = isEmpty;
 exports.isNullish = isNullish;
 exports.noop = noop;
+exports.sleep = sleep;
+exports.splitWhitespace = splitWhitespace;
 exports.toPixel = toPixel;

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 export * from './array';
+export * from './panic';
 export * from './regex';
+export * from './string';
+export * from './promise';
 /**
- * Check if a value is empty.
+ * 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.
@@ -12,8 +15,5 @@ export * from './regex';
 export declare function isEmpty(value?: unknown): boolean;
 export declare function isNullish(value: unknown): value is null | undefined;
 export declare const noop: () => void;
-/**
- * Add the pixel unit to a value.
- * If the value is a string, it is returned unchanged.
- */
+/** Adds the pixel unit to a value. */
 export declare function toPixel(value: string | number): string;

package/dist/index.js

@@ -1,5 +1,23 @@
 import { regex } from "./regex.js";
-import { splitWhitespace, toArray, trimArray, upsert } from "./array.js";
+import { trimArray } from "./array.js";
+import { toArray, upsert } from "./array.js";
+import { panic, todo, unimplemented, unreachable } from "./panic.js";
+function splitWhitespace(value) {
+  if (!value)
+    return [];
+  if (Array.isArray(value)) {
+    const array = value.map((i) => splitWhitespace(i));
+    return array.flat(Number.POSITIVE_INFINITY);
+  }
+  value = value.trim().split(/\s/);
+  return trimArray(value);
+}
+function flush() {
+  return new Promise((resolve) => void setTimeout(resolve, 0));
+}
+function sleep(ms) {
+  return new Promise((resolve) => void setTimeout(resolve, ms));
+}
 function isEmpty(value) {
   if (isNullish(value)) {
     return true;
@@ -24,13 +42,19 @@ function toPixel(value) {
   return value;
 }
 export {
+  flush,
   isEmpty,
   isNullish,
   noop,
+  panic,
   regex,
+  sleep,
   splitWhitespace,
   toArray,
   toPixel,
+  todo,
   trimArray,
+  unimplemented,
+  unreachable,
   upsert
 };

package/dist/panic.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function panic(message) {
+  throw new Error(message);
+}
+function todo(message = "not yet implemented") {
+  panic(message);
+}
+function unimplemented(message = "not implemented") {
+  panic(message);
+}
+function unreachable(message = "unreachable") {
+  panic(message);
+}
+exports.panic = panic;
+exports.todo = todo;
+exports.unimplemented = unimplemented;
+exports.unreachable = unreachable;

package/dist/panic.d.ts

@@ -0,0 +1,4 @@
+export declare function panic(message?: string): never;
+export declare function todo(message?: string): never;
+export declare function unimplemented(message?: string): never;
+export declare function unreachable(message?: string): never;

package/dist/panic.js

@@ -0,0 +1,18 @@
+function panic(message) {
+  throw new Error(message);
+}
+function todo(message = "not yet implemented") {
+  panic(message);
+}
+function unimplemented(message = "not implemented") {
+  panic(message);
+}
+function unreachable(message = "unreachable") {
+  panic(message);
+}
+export {
+  panic,
+  todo,
+  unimplemented,
+  unreachable
+};

package/dist/promise.d.ts

@@ -0,0 +1,2 @@
+export declare function flush(): Promise<void>;
+export declare function sleep(ms: number): Promise<void>;

package/dist/string.d.ts

@@ -0,0 +1,3 @@
+import { Nullish } from '@tb-dev/utility-types';
+
+export declare function splitWhitespace(value: Nullish<string | string[]>): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tb-dev/utils",
-  "version": "1.5.2",
+  "version": "1.7.0",
   "description": "TypeScript utils",
   "license": "MIT",
   "type": "module",
@@ -30,18 +30,18 @@
     "@tb-dev/utility-types": "^1.2.7"
   },
   "devDependencies": {
-    "@tb-dev/eslint-config": "^3.4.0",
-    "@types/node": "^20.12.7",
+    "@tb-dev/eslint-config": "^3.5.1",
+    "@types/node": "^20.12.11",
     "eslint": "^8.57.0",
     "husky": "^9.0.11",
     "lint-staged": "^15.2.2",
     "prettier": "^3.2.5",
     "tslib": "^2.6.2",
     "typedoc": "^0.25.13",
-    "typedoc-plugin-mdn-links": "^3.1.23",
+    "typedoc-plugin-mdn-links": "^3.1.24",
     "typescript": "^5.4.5",
-    "vite": "^5.2.10",
-    "vite-plugin-dts": "^3.9.0"
+    "vite": "^5.2.11",
+    "vite-plugin-dts": "^3.9.1"
   },
   "files": [
     "dist"
@@ -60,10 +60,25 @@
       "import": "./dist/array.js",
       "require": "./dist/array.cjs"
     },
+    "./panic": {
+      "types": "./dist/panic.d.ts",
+      "import": "./dist/panic.js",
+      "require": "./dist/panic.cjs"
+    },
+    "./promise": {
+      "types": "./dist/promise.d.ts",
+      "import": "./dist/promise.js",
+      "require": "./dist/promise.cjs"
+    },
     "./regex": {
       "types": "./dist/regex.d.ts",
       "import": "./dist/regex.js",
       "require": "./dist/regex.cjs"
+    },
+    "./string": {
+      "types": "./dist/string.d.ts",
+      "import": "./dist/string.js",
+      "require": "./dist/string.cjs"
     }
   },
   "scripts": {
@@ -72,6 +87,7 @@
     "format": "prettier . --write",
     "format-check": "prettier . --check",
     "lint": "eslint . --config eslint.config.js --cache",
+    "lint-fix": "eslint . --config eslint.config.js --cache --fix",
     "release": "pnpm run build && pnpm publish",
     "type-check": "tsc --noEmit",
     "update": "miho update major -t"