@theholocron/misc-utils 1.8.2 → 1.8.3

package/README.md

@@ -1,6 +1,6 @@
 # `@theholocron/misc-utils`
 
-Miscellaneous browser utilities.
+Miscellaneous utilities.
 
 ## Installation
 
@@ -10,6 +10,23 @@ pnpm add @theholocron/misc-utils
 
 ## Usage
 
+### `errorMessage(err)`
+
+Stringifies a caught value for display — `err.message` for a real
+`Error`, `String(err)` for anything else. `catch` blocks only ever get
+`unknown` in TypeScript; this is the one line nearly every one of them
+needs.
+
+```typescript
+import { errorMessage } from "@theholocron/misc-utils";
+
+try {
+  doSomething();
+} catch (err) {
+  console.error(errorMessage(err));
+}
+```
+
 ### Konami code detector
 
 ```typescript

package/dist/index.d.mts

@@ -2,6 +2,15 @@
 type TKonamiCode = "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "KeyA" | "KeyB";
 declare function is(event: KeyboardEvent): boolean;
 //#endregion
+//#region src/error-message.d.ts
+/**
+ * Stringifies a caught value for display — `err.message` for a real
+ * `Error`, `String(err)` for anything else (a thrown string, a plugin's
+ * custom error-like object, …). `catch` blocks only ever get `unknown`
+ * in TypeScript, so this is the one line nearly every one of them needs.
+ */
+export declare function errorMessage(err: unknown): string;
+//#endregion
 //#region src/index.d.ts
 export declare const konami: {
   CODE: TKonamiCode[];

package/dist/index.mjs

@@ -23,10 +23,21 @@ function is(event) {
 	return false;
 }
 //#endregion
+//#region src/error-message.ts
+/**
+* Stringifies a caught value for display — `err.message` for a real
+* `Error`, `String(err)` for anything else (a thrown string, a plugin's
+* custom error-like object, …). `catch` blocks only ever get `unknown`
+* in TypeScript, so this is the one line nearly every one of them needs.
+*/
+function errorMessage(err) {
+	return err instanceof Error ? err.message : String(err);
+}
+//#endregion
 //#region src/index.ts
 const konami = {
 	CODE,
 	is
 };
 //#endregion
-export { konami };
+export { errorMessage, konami };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/misc-utils",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "description": "Miscellaneous utilities.",
   "keywords": [
     "misc",
@@ -20,15 +20,16 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
     }
   },
   "files": [
     "dist"
   ],
   "devDependencies": {
+    "@theholocron/cli": "5.0.0-alpha.3",
     "@theholocron/tsdown-config": "^8.2.0",
     "@theholocron/vitest-config": "^8.2.0",
     "@tsconfig/node-lts": "^24.0.1",
@@ -46,10 +47,10 @@
   "releases": "https://github.com/theholocron/utils/releases",
   "wiki": "https://github.com/theholocron/utils/wiki",
   "scripts": {
-    "build": "tsdown",
-    "lint": "eslint .",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "npx tsc --noEmit"
+    "delivery.build": "tsdown",
+    "sourceQuality.staticAnalysis": "holocron run sourceQuality.staticAnalysis --",
+    "test:watch": "vitest",
+    "verification.typeSafety": "holocron run verification.typeSafety --",
+    "verification.unitTests": "holocron run verification.unitTests --"
   }
 }