@tb-dev/utils 1.8.6 → 2.0.1

package/dist/array.d.ts

@@ -1,6 +1,8 @@
-import { MaybeArray, Nullish } from '@tb-dev/utility-types';
+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/index.d.ts

@@ -1,6 +1,7 @@
 export * from './array';
 export * from './panic';
 export * from './regex';
+export * from './types';
 export * from './string';
 export * from './promise';
 /**

package/dist/panic.d.ts

@@ -1,3 +1,4 @@
+/** Throws an error with the given message. */
 export declare function panic(...args: any[]): never;
 export declare function todo(...args: any[]): never;
 export declare function unimplemented(...args: any[]): never;

package/dist/promise.d.ts

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

package/dist/string.d.ts

@@ -1,3 +1,13 @@
-import { Nullish } from '@tb-dev/utility-types';
+import { Nullish } from './types';
 
+/**
+ * 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']
+ * ```
+ */
 export declare function splitWhitespace(value: Nullish<string | string[]>): string[];

package/dist/types.cjs

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

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+export type ExtractPartial<T, K extends keyof T> = Partial<T>[K];
+export type ExtractRequired<T, K extends keyof T> = Required<T>[K];
+export type Fn = () => void;
+/** Something may be an array. */
+export type MaybeArray<T> = T | T[];
+/** Something may be an array or a Set. */
+export type MaybeArrayOrSet<T> = MaybeArray<T> | MaybeSet<T>;
+/** Something may be a promise. */
+export type MaybePromise<T> = T | PromiseLike<T>;
+/** Something may be a Set. */
+export type MaybeSet<T> = T | Set<T>;
+/** Something may be nullish. */
+export type Nullish<T> = T | null | undefined;
+/** Constructs a type where all properties of `T` may be nullish. */
+export type PartialNullish<T> = {
+    [P in keyof T]?: Nullish<T[P]>;
+};
+/**
+ * Like `Pick`, but constructs the type based on the values.
+ */
+export type PickByValue<T, V> = {
+    [P in keyof T as T[P] extends V ? P : never]: T[P];
+};
+/** Constructs a type by picking the set of properties `K` from a partial version of `T`. */
+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>;
+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. */
+export type WithRequired<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;

package/dist/types.js

@@ -0,0 +1 @@
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tb-dev/utils",
-  "version": "1.8.6",
+  "version": "2.0.1",
   "description": "TypeScript utils",
   "license": "MIT",
   "type": "module",
@@ -26,21 +26,18 @@
     "*.{?(c|m)@(j|t)s,css,vue,md,json}": "prettier --write",
     "*.{?(c|m)@(j|t)s,vue}": "pnpm run lint"
   },
-  "dependencies": {
-    "@tb-dev/utility-types": "^1.4.4"
-  },
   "devDependencies": {
-    "@tb-dev/eslint-config": "^3.8.8",
-    "@types/node": "^20.14.9",
+    "@tb-dev/eslint-config": "^3.8.10",
+    "@types/node": "^20.14.11",
     "eslint": "^8.57.0",
-    "husky": "^9.0.11",
+    "husky": "^9.1.0",
     "lint-staged": "^15.2.7",
-    "prettier": "^3.3.2",
+    "prettier": "^3.3.3",
     "tslib": "^2.6.3",
-    "typedoc": "^0.26.3",
-    "typedoc-plugin-mdn-links": "^3.2.2",
+    "typedoc": "^0.26.4",
+    "typedoc-plugin-mdn-links": "^3.2.4",
     "typescript": "^5.5.3",
-    "vite": "^5.3.3",
+    "vite": "^5.3.4",
     "vite-plugin-dts": "^3.9.1"
   },
   "files": [
@@ -79,6 +76,11 @@
       "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": {