@thi.ng/args 2.1.13 → 2.2.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2022-08-01T14:53:59Z
+- **Last updated**: 2022-08-23T10:37:04Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [2.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/args@2.2.0) (2022-08-15)
+
+#### 🚀 Features
+
+- add ParseError, update parse() err handling ([c854a13](https://github.com/thi-ng/umbrella/commit/c854a13))
+  - update parse() to re-throw any caught error wrapped as ParseError
+
 ### [2.1.6](https://github.com/thi-ng/umbrella/tree/@thi.ng/args@2.1.6) (2022-04-07)
 
 #### ♻️ Refactoring

package/README.md

@@ -71,7 +71,7 @@ node --experimental-repl-await
 > const args = await import("@thi.ng/args");
 ```
 
-Package sizes (gzipped, pre-treeshake): ESM: 2.44 KB
+Package sizes (gzipped, pre-treeshake): ESM: 2.49 KB
 
 ## Dependencies
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/args",
-  "version": "2.1.13",
+  "version": "2.2.1",
   "description": "Declarative, functional & typechecked CLI argument/options parser, value coercions etc.",
   "type": "module",
   "module": "./index.js",
@@ -34,14 +34,14 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.9",
+    "@thi.ng/api": "^8.4.1",
     "@thi.ng/checks": "^3.2.4",
     "@thi.ng/errors": "^2.1.10",
-    "@thi.ng/strings": "^3.3.9"
+    "@thi.ng/strings": "^3.3.11"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.25.0",
-    "@thi.ng/testament": "^0.2.11",
+    "@thi.ng/testament": "^0.2.12",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
     "typedoc": "^0.22.17",
@@ -96,5 +96,5 @@
   "thi.ng": {
     "year": 2018
   },
-  "gitHead": "01b7a47077d88c2aefe77650ce3340040bae00ee\n"
+  "gitHead": "be8423e2019e95c14a096260a93b9762dde0c768\n"
 }

package/parse.d.ts

@@ -1,4 +1,15 @@
+/// <reference types="node" />
 import type { IObjectOf } from "@thi.ng/api";
 import type { Args, ParseOpts, ParseResult } from "./api.js";
+export declare const ParseError: {
+    new (msg?: string | undefined): {
+        name: string;
+        message: string;
+        stack?: string | undefined;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
 export declare const parse: <T extends IObjectOf<any>>(specs: Args<T>, argv: string[], opts?: Partial<ParseOpts>) => ParseResult<T> | undefined;
 //# sourceMappingURL=parse.d.ts.map

package/parse.js

@@ -1,7 +1,9 @@
 import { isArray } from "@thi.ng/checks/is-array";
+import { defError } from "@thi.ng/errors/deferror";
 import { illegalArgs } from "@thi.ng/errors/illegal-arguments";
 import { camel } from "@thi.ng/strings/case";
 import { usage } from "./usage.js";
+export const ParseError = defError(() => "parse error");
 export const parse = (specs, argv, opts) => {
     opts = { start: 2, showUsage: true, help: ["--help", "-h"], ...opts };
     try {
@@ -11,7 +13,7 @@ export const parse = (specs, argv, opts) => {
         if (opts.showUsage) {
             console.log(e.message + "\n\n" + usage(specs, opts.usageOpts));
         }
-        throw e;
+        throw new ParseError(e.message);
     }
 };
 const parseOpts = (specs, argv, opts) => {