@tb-dev/utils 2.1.0 → 3.0.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Andrew Ferreira
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 Andrew Ferreira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/array/index.d.ts

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

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

@@ -0,0 +1,4 @@
+import { MaybeArray, Nullish } from '../types';
+
+/** Converts the item to an array if it isn't already. */
+export declare function toArray<T>(item?: Nullish<MaybeArray<T>>): T[];

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

@@ -0,0 +1,2 @@
+/** Trims each string in the array, removing any empty strings. */
+export declare function trimArray(array: string[]): string[];

package/dist/array/upsert.d.ts

@@ -0,0 +1,2 @@
+/** 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;

package/dist/index.cjs

@@ -1,10 +1,77 @@
 "use strict";
+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);
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const regex = require("./regex.cjs");
-const array = require("./array.cjs");
-const panic = require("./panic.cjs");
-const string = require("./string.cjs");
-const promise = require("./promise.cjs");
+const float = /^\d+(?:\.(\d+))?$/;
+const regex = {
+  float
+};
+function upsert(array, item, predicate) {
+  const index = array.findIndex(predicate ?? ((it) => it === item));
+  if (index === -1) {
+    array.push(item);
+  } else {
+    array[index] = item;
+  }
+}
+function toArray(item) {
+  const array = item ?? [];
+  return Array.isArray(array) ? array : [array];
+}
+function trimArray(array) {
+  return array.map((it) => it.trim()).filter(Boolean);
+}
+function panic(...args) {
+  throw new Error(args.join(" "));
+}
+function todo(...args) {
+  panic(format("TODO", args));
+}
+function unimplemented(...args) {
+  panic(format("not implemented", args));
+}
+function unreachable(...args) {
+  panic(format("unreachable", args));
+}
+function format(base, args) {
+  let message = base;
+  if (args.length > 0) {
+    message = `${message}: ${args.join(" ")}`;
+  }
+  return message;
+}
+function splitWhitespace(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) {
+    const array = value.map((it) => splitWhitespace(it));
+    return array.flat(Number.POSITIVE_INFINITY);
+  }
+  value = value.trim().split(/\s/);
+  return trimArray(value);
+}
+function sleep(ms) {
+  return new Promise((resolve) => void setTimeout(resolve, ms));
+}
+class PromiseChain {
+  constructor() {
+    __publicField(this, "promises", /* @__PURE__ */ new Set());
+  }
+  chain(promise) {
+    this.promises.add(promise);
+    return this;
+  }
+  async join() {
+    await Promise.all(this.promises);
+    this.promises.clear();
+  }
+  static create() {
+    return new PromiseChain();
+  }
+}
+function flushPromises() {
+  return new Promise((resolve) => void setTimeout(resolve, 0));
+}
 function isEmpty(value) {
   if (isNullish(value)) {
     return true;
@@ -18,28 +85,29 @@ function isEmpty(value) {
   return false;
 }
 function isNullish(value) {
-  return value === null || value === void 0;
+  return value === void 0 || value === null;
 }
 const noop = () => {
 };
 function toPixel(value) {
-  if (typeof value === "number" || typeof value === "string" && regex.regex.float.test(value)) {
+  if (typeof value === "number" || typeof value === "string" && regex.float.test(value)) {
     return `${value}px`;
   }
   return value;
 }
-exports.regex = regex.regex;
-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.splitWhitespace = string.splitWhitespace;
-exports.flushPromises = promise.flushPromises;
-exports.sleep = promise.sleep;
+exports.PromiseChain = PromiseChain;
+exports.flushPromises = flushPromises;
 exports.isEmpty = isEmpty;
 exports.isNullish = isNullish;
 exports.noop = noop;
+exports.panic = panic;
+exports.regex = regex;
+exports.sleep = sleep;
+exports.splitWhitespace = splitWhitespace;
+exports.toArray = toArray;
 exports.toPixel = toPixel;
+exports.todo = todo;
+exports.trimArray = trimArray;
+exports.unimplemented = unimplemented;
+exports.unreachable = unreachable;
+exports.upsert = upsert;

package/dist/index.js

@@ -1,8 +1,75 @@
-import { regex } from "./regex.js";
-import { toArray, trimArray, upsert } from "./array.js";
-import { panic, todo, unimplemented, unreachable } from "./panic.js";
-import { splitWhitespace } from "./string.js";
-import { flushPromises, sleep } from "./promise.js";
+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 upsert(array, item, predicate) {
+  const index = array.findIndex(predicate ?? ((it) => it === item));
+  if (index === -1) {
+    array.push(item);
+  } else {
+    array[index] = item;
+  }
+}
+function toArray(item) {
+  const array = item ?? [];
+  return Array.isArray(array) ? array : [array];
+}
+function trimArray(array) {
+  return array.map((it) => it.trim()).filter(Boolean);
+}
+function panic(...args) {
+  throw new Error(args.join(" "));
+}
+function todo(...args) {
+  panic(format("TODO", args));
+}
+function unimplemented(...args) {
+  panic(format("not implemented", args));
+}
+function unreachable(...args) {
+  panic(format("unreachable", args));
+}
+function format(base, args) {
+  let message = base;
+  if (args.length > 0) {
+    message = `${message}: ${args.join(" ")}`;
+  }
+  return message;
+}
+function splitWhitespace(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) {
+    const array = value.map((it) => splitWhitespace(it));
+    return array.flat(Number.POSITIVE_INFINITY);
+  }
+  value = value.trim().split(/\s/);
+  return trimArray(value);
+}
+function sleep(ms) {
+  return new Promise((resolve) => void setTimeout(resolve, ms));
+}
+class PromiseChain {
+  constructor() {
+    __publicField(this, "promises", /* @__PURE__ */ new Set());
+  }
+  chain(promise) {
+    this.promises.add(promise);
+    return this;
+  }
+  async join() {
+    await Promise.all(this.promises);
+    this.promises.clear();
+  }
+  static create() {
+    return new PromiseChain();
+  }
+}
+function flushPromises() {
+  return new Promise((resolve) => void setTimeout(resolve, 0));
+}
 function isEmpty(value) {
   if (isNullish(value)) {
     return true;
@@ -16,7 +83,7 @@ function isEmpty(value) {
   return false;
 }
 function isNullish(value) {
-  return value === null || value === void 0;
+  return value === void 0 || value === null;
 }
 const noop = () => {
 };
@@ -27,6 +94,7 @@ function toPixel(value) {
   return value;
 }
 export {
+  PromiseChain,
   flushPromises,
   isEmpty,
   isNullish,

package/dist/{promise.d.ts → promise/flush-promises.d.ts}

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

package/dist/promise/index.d.ts

@@ -0,0 +1,3 @@
+export { sleep } from './sleep';
+export { PromiseChain } from './promise-chain';
+export { flushPromises } from './flush-promises';

package/dist/promise/promise-chain.d.ts

@@ -0,0 +1,6 @@
+export declare class PromiseChain {
+    private readonly promises;
+    chain(promise: Promise<any>): this;
+    join(): Promise<void>;
+    static create(): PromiseChain;
+}

package/dist/promise/sleep.d.ts

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

package/dist/string/index.d.ts

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

package/dist/{string.d.ts → string/split-whitespace.d.ts}

@@ -1,4 +1,4 @@
-import { Nullish } from './types';
+import { Nullish } from '../types';
 
 /**
  * Splits a string or an array of strings (recursively) by whitespace.

package/dist/types.d.ts

@@ -27,10 +27,6 @@ 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>;
-/** Constructs a type where all properties of `T` are strings. */
-export type StringifyObject<T> = {
-    [P in keyof T]: string;
-};
 /** Constructs a type consisting of some properties of T set to partial. */
 export type WithPartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 /** Constructs a type consisting of some properties of T set to partial. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tb-dev/utils",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "TypeScript utils",
   "license": "MIT",
   "type": "module",
@@ -23,22 +23,23 @@
     "typescript"
   ],
   "lint-staged": {
-    "*.{?(c|m)@(j|t)s,css,vue,md,json}": "prettier --write",
-    "*.{?(c|m)@(j|t)s,vue}": "pnpm run lint"
+    "*.{?(c|m)@(j|t)s,css,vue,md,json}": "prettier --write"
   },
   "devDependencies": {
-    "@tb-dev/eslint-config": "^4.4.2",
-    "@types/node": "^22.1.0",
-    "eslint": "^8.57.0",
+    "@tb-dev/eslint-config": "^5.2.0",
+    "@types/node": "^22.2.0",
+    "@vitest/ui": "^2.0.5",
+    "eslint": "^9.9.0",
     "husky": "^9.1.4",
     "lint-staged": "^15.2.8",
     "prettier": "^3.3.3",
     "tslib": "^2.6.3",
     "typedoc": "^0.26.5",
-    "typedoc-plugin-mdn-links": "^3.2.7",
+    "typedoc-plugin-mdn-links": "^3.2.8",
     "typescript": "^5.5.4",
-    "vite": "^5.3.5",
-    "vite-plugin-dts": "^3.9.1"
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^3.9.1",
+    "vitest": "^2.0.5"
   },
   "files": [
     "dist"
@@ -51,36 +52,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
-    },
-    "./array": {
-      "types": "./dist/array.d.ts",
-      "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"
-    },
-    "./types": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/types.js",
-      "require": "./dist/types.cjs"
     }
   },
   "scripts": {
@@ -91,6 +62,8 @@
     "lint": "eslint . --config eslint.config.js --cache",
     "lint-fix": "eslint . --config eslint.config.js --fix",
     "release": "pnpm run build && pnpm publish",
+    "test": "vitest",
+    "test:ui": "vitest --ui --watch",
     "type-check": "tsc --noEmit",
     "update": "miho update major -t"
   }

package/dist/array.cjs

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-function upsert(array, item, predicate) {
-  const index = array.findIndex(predicate);
-  if (index === -1) {
-    array.push(item);
-  } else {
-    array[index] = item;
-  }
-}
-function toArray(item) {
-  const array = item ?? [];
-  return Array.isArray(array) ? array : [array];
-}
-function trimArray(array) {
-  return array.map((i) => i.trim()).filter(Boolean);
-}
-exports.toArray = toArray;
-exports.trimArray = trimArray;
-exports.upsert = upsert;

package/dist/array.d.ts

@@ -1,8 +0,0 @@
-import { MaybeArray, Nullish } from './types';
-
-/** 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;
-/** Converts the item to an array if it isn't already. */
-export declare function toArray<T>(item?: Nullish<MaybeArray<T>>): T[];
-/** Trims each string in the array, removing any empty strings. */
-export declare function trimArray(array: string[]): string[];

package/dist/array.js

@@ -1,20 +0,0 @@
-function upsert(array, item, predicate) {
-  const index = array.findIndex(predicate);
-  if (index === -1) {
-    array.push(item);
-  } else {
-    array[index] = item;
-  }
-}
-function toArray(item) {
-  const array = item ?? [];
-  return Array.isArray(array) ? array : [array];
-}
-function trimArray(array) {
-  return array.map((i) => i.trim()).filter(Boolean);
-}
-export {
-  toArray,
-  trimArray,
-  upsert
-};

package/dist/panic.cjs

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-function panic(...args) {
-  throw new Error(args[0]);
-}
-function todo(...args) {
-  const message = typeof args[0] === "string" ? args[0] : "todo";
-  panic(message);
-}
-function unimplemented(...args) {
-  const message = typeof args[0] === "string" ? args[0] : "not implemented";
-  panic(message);
-}
-function unreachable(...args) {
-  const message = typeof args[0] === "string" ? args[0] : "unreachable";
-  panic(message);
-}
-exports.panic = panic;
-exports.todo = todo;
-exports.unimplemented = unimplemented;
-exports.unreachable = unreachable;

package/dist/panic.js

@@ -1,21 +0,0 @@
-function panic(...args) {
-  throw new Error(args[0]);
-}
-function todo(...args) {
-  const message = typeof args[0] === "string" ? args[0] : "todo";
-  panic(message);
-}
-function unimplemented(...args) {
-  const message = typeof args[0] === "string" ? args[0] : "not implemented";
-  panic(message);
-}
-function unreachable(...args) {
-  const message = typeof args[0] === "string" ? args[0] : "unreachable";
-  panic(message);
-}
-export {
-  panic,
-  todo,
-  unimplemented,
-  unreachable
-};

package/dist/promise.cjs

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const scheduler = typeof setImmediate === "function" ? setImmediate : setTimeout;
-function flushPromises() {
-  return new Promise((resolve) => void scheduler(resolve, 0));
-}
-function sleep(ms) {
-  return new Promise((resolve) => void setTimeout(resolve, ms));
-}
-exports.flushPromises = flushPromises;
-exports.sleep = sleep;

package/dist/promise.js

@@ -1,11 +0,0 @@
-const scheduler = typeof setImmediate === "function" ? setImmediate : setTimeout;
-function flushPromises() {
-  return new Promise((resolve) => void scheduler(resolve, 0));
-}
-function sleep(ms) {
-  return new Promise((resolve) => void setTimeout(resolve, ms));
-}
-export {
-  flushPromises,
-  sleep
-};

package/dist/regex.cjs

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const float = /^\d+(?:\.(\d+))?$/;
-const regex = {
-  float
-};
-exports.regex = regex;

package/dist/regex.js

@@ -1,7 +0,0 @@
-const float = /^\d+(?:\.(\d+))?$/;
-const regex = {
-  float
-};
-export {
-  regex
-};

package/dist/string.cjs

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const array = require("./array.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);
-}
-exports.splitWhitespace = splitWhitespace;

package/dist/string.js

@@ -1,13 +0,0 @@
-import { trimArray } from "./array.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);
-}
-export {
-  splitWhitespace
-};

package/dist/types.cjs

@@ -1 +0,0 @@
-"use strict";

package/dist/types.js

@@ -1 +0,0 @@
-