@idlebox/errors 0.1.17 → 0.1.18

package/lib/error-types/development.js

@@ -0,0 +1,50 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
+import { ErrorWithCode } from '../common/base.js';
+/**
+ * 由于程序出现bug导致的各类异常
+ */
+export class ProgramError extends ErrorWithCode {
+    constructor(message, opts) {
+        super(message, ExitCode.PROGRAM, opts);
+    }
+}
+export class NotImplementedError extends ProgramError {
+    constructor(message = '此功能未实现', opts) {
+        super(message, opts);
+    }
+}
+export class SoftwareDefectError extends ProgramError {
+}
+export class Assertion extends SoftwareDefectError {
+    static ok(value, message = '断言失败', opts) {
+        if (!value) {
+            if (!opts?.boundary) {
+                if (!opts)
+                    opts = {};
+                opts.boundary = Assertion.ok;
+            }
+            throw new SoftwareDefectError(`${message}: 应为真值, 实际为${typeof value}类型的 "${value}"`, opts);
+        }
+    }
+}
+export class VariableTypeError extends ProgramError {
+    object;
+    ExpectedClass;
+    constructor(object, { Expected, variableName = '变量', ...opts } = {}) {
+        let message = '';
+        if (Expected) {
+            message += `应是 ${Expected.name}`;
+        }
+        const Actual = object.constructor;
+        if (message) {
+            message += ', 实际是 ';
+        }
+        else {
+            message += '不能是 ';
+        }
+        message += Actual.name;
+        super(`${object}的类型${message}`, opts);
+        this.object = object;
+    }
+}
+//# sourceMappingURL=development.js.map

package/lib/error-types/development.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.js","sourceRoot":"","sources":["../../src/error-types/development.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;GAEG;AACH,MAAM,OAAgB,YAAa,SAAQ,aAAa;IACvD,YAAY,OAAe,EAAE,IAAoB;QAChD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACpD,YAAY,UAAkB,QAAQ,EAAE,IAAoB;QAC3D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;CAAG;AAExD,MAAM,OAAO,SAAU,SAAQ,mBAAmB;IACjD,MAAM,CAAC,EAAE,CAAC,KAAc,EAAE,UAAkB,MAAM,EAAE,IAAoB;QACvE,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI;oBAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC;YAC9B,CAAC;YACD,MAAM,IAAI,mBAAmB,CAAC,GAAG,OAAO,cAAc,OAAO,KAAK,QAAQ,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3F,CAAC;IACF,CAAC;CACD;AAOD,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAIjC;IAHD,aAAa,CAAY;IAEzC,YACiB,MAAW,EAC3B,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,IAAI,KAAgC,EAAE;QAE1E,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,QAAQ,CAAC;QACrB,CAAC;aAAM,CAAC;YACP,OAAO,IAAI,MAAM,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC;QAEvB,KAAK,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAhBtB,WAAM,GAAN,MAAM,CAAK;IAiB5B,CAAC;CACD"}

package/lib/error-types/nodejs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.d.ts","sourceRoot":"","sources":["../../src/error-types/nodejs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,IAAgC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC;AAErF,MAAM,WAAW,gBAAiB,SAAQ,KAAK;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,aAAa,CAAC,aAAa,CAAC,gBAAgB,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAE7I;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAEtF;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAEnF;AAED,uCAAuC;AACvC,eAAO,MAAM,WAAW,wBAAkB,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAE9G;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE1D"}

package/lib/error-types/nodejs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.js","sourceRoot":"","sources":["../../src/error-types/nodejs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAW/D;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAW;IAClD,OAAO,WAAW,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,aAAa,CAAC,gBAAgB,IAAI,EAAE,CAAC,IAAI,KAAK,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAC1H,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAU;IAC1C,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAU;IACvC,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,CAAU;IACzC,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAU;IACrC,OAAO,CAAC,YAAY,KAAK,IAAI,OAAQ,CAAS,CAAC,IAAI,KAAK,QAAQ,CAAC;AAClE,CAAC"}

package/lib/{common/unhandled-errors.d.ts → error-types/nodejs.unhandled.d.ts}

@@ -15,4 +15,4 @@ export declare class UncaughtException extends ProxiedError {
     constructor(error: Error);
 }
 export {};
-//# sourceMappingURL=unhandled-errors.d.ts.map
+//# sourceMappingURL=nodejs.unhandled.d.ts.map

package/lib/error-types/nodejs.unhandled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.unhandled.d.ts","sourceRoot":"","sources":["../../src/error-types/nodejs.unhandled.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,YAAa,SAAQ,KAAK;IACvB,KAAK,EAAE,GAAG,CAAC;gBAEP,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;IAK7C,IAAa,KAAK,IAAI,MAAM,CAS3B;CACD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;aAGlC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;gBADzC,MAAM,EAAE,OAAO,EACC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;CAI1C;AAED,qBAAa,iBAAkB,SAAQ,YAAY;aACtB,KAAK,EAAE,KAAK;gBAAZ,KAAK,EAAE,KAAK;CAGxC"}

package/lib/{common/unhandled-errors.js → error-types/nodejs.unhandled.js}

@@ -47,4 +47,4 @@ function removeFirstLine(text) {
     }
     return text;
 }
-//# sourceMappingURL=unhandled-errors.js.map
+//# sourceMappingURL=nodejs.unhandled.js.map

package/lib/error-types/nodejs.unhandled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.unhandled.js","sourceRoot":"","sources":["../../src/error-types/nodejs.unhandled.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,YAAa,SAAQ,KAAK;IAG/B,YAAY,MAAc,EAAE,QAAiB;QAC5C,KAAK,CAAC,GAAG,MAAM,KAAK,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,OAAQ,IAAY,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,IAAa,KAAK;QACjB,MAAM,KAAK,GAAQ,IAAI,CAAC,KAAK,CAAC;QAC9B,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,CAAC;QACF,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,wBAAwB,CAAC;IAChD,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAGlC;IAFjB,YACC,MAAe,EACC,OAAyB;QAEzC,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QAF7B,YAAO,GAAP,OAAO,CAAkB;IAG1C,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACtB;IAA5B,YAA4B,KAAY;QACvC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QADR,UAAK,GAAL,KAAK,CAAO;IAExC,CAAC;CACD;AAED,SAAS,WAAW,CAAC,MAAW;IAC/B,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACjE,OAAO,MAAM,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/lib/error-types/tools.d.ts

@@ -0,0 +1,28 @@
+import { ErrorWithCode } from '../common/base.js';
+import { humanReadable, type IHumanReadable } from '../common/human-readable.js';
+import type { IErrorOptions } from '../common/type.js';
+/**
+ * 发生本程序主动发起的取消行为时
+ * @public
+ */
+export declare class CanceledError extends ErrorWithCode implements IHumanReadable {
+    constructor(opts?: IErrorOptions);
+    static is(e: unknown): e is CanceledError;
+    [humanReadable](): string;
+}
+/**
+ * 某种操作超时
+ *
+ * @public
+ */
+export declare class TimeoutError extends ErrorWithCode implements IHumanReadable {
+    private readonly ms;
+    private readonly why;
+    private readonly what?;
+    constructor(ms: number, why?: string, opts?: IErrorOptions & {
+        what?: string;
+    });
+    static is(error: unknown): error is TimeoutError;
+    [humanReadable](): string;
+}
+//# sourceMappingURL=tools.d.ts.map

package/lib/error-types/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/error-types/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,aAAc,YAAW,cAAc;gBAC7D,IAAI,CAAC,EAAE,aAAa;IAIhC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa;IAIhC,CAAC,aAAa,CAAC;CAGxB;AAED;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,aAAc,YAAW,cAAc;IAIvE,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAS;gBAGb,EAAE,EAAE,MAAM,EACV,GAAG,SAAgB,EACpC,IAAI,CAAC,EAAE,aAAa,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAMzC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY;IAIvC,CAAC,aAAa,CAAC;CAGxB"}

package/lib/error-types/tools.js

@@ -0,0 +1,41 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
+import { ErrorWithCode } from '../common/base.js';
+import { humanReadable } from '../common/human-readable.js';
+/**
+ * 发生本程序主动发起的取消行为时
+ * @public
+ */
+export class CanceledError extends ErrorWithCode {
+    constructor(opts) {
+        super('Canceled', ExitCode.INTERRUPT, opts);
+    }
+    static is(e) {
+        return e instanceof CanceledError;
+    }
+    [humanReadable]() {
+        return '操作已应要求而取消';
+    }
+}
+/**
+ * 某种操作超时
+ *
+ * @public
+ */
+export class TimeoutError extends ErrorWithCode {
+    ms;
+    why;
+    what;
+    constructor(ms, why = 'no response', opts) {
+        super(`Timeout: ${why} in ${ms}ms${opts?.what ? ` (when ${opts.what})` : ''}`, ExitCode.TIMEOUT, opts);
+        this.ms = ms;
+        this.why = why;
+        this.what = opts?.what;
+    }
+    static is(error) {
+        return error instanceof TimeoutError;
+    }
+    [humanReadable]() {
+        return `操作超时: ${this.what ? this.what : '操作没有说明'}\n  - 时长: ${this.ms}ms\n  - 原因: ${this.why}`;
+    }
+}
+//# sourceMappingURL=tools.js.map

package/lib/error-types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/error-types/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAuB,MAAM,6BAA6B,CAAC;AAGjF;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC/C,YAAY,IAAoB;QAC/B,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,CAAU;QACnB,OAAO,CAAC,YAAY,aAAa,CAAC;IACnC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,WAAW,CAAC;IACpB,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IAI5B;IACA;IAJD,IAAI,CAAU;IAE/B,YACkB,EAAU,EACV,MAAM,aAAa,EACpC,IAAwC;QAExC,KAAK,CAAC,YAAY,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAJtF,OAAE,GAAF,EAAE,CAAQ;QACV,QAAG,GAAH,GAAG,CAAgB;QAIpC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,KAAc;QACvB,OAAO,KAAK,YAAY,YAAY,CAAC;IACtC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,aAAa,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/F,CAAC;CACD"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@idlebox/errors",
   "description": "A collection of my errors.",
   "type": "module",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "exports": {
     ".": {
       "source": "./src/autoindex.ts",
@@ -16,7 +16,7 @@
   },
   "devDependencies": {
     "@build-script/baseline-rig": "latest",
-    "@mpis/run": "^0.0.21"
+    "@mpis/run": "^0.0.25"
   },
   "license": "MIT",
   "author": "GongT <admin@gongt.me>",

package/src/autoindex.ts

@@ -22,37 +22,53 @@
 /* codes/wellknown-exit-codes.ts */
 	// Identifiers (1)
 	export { ExitCode } from "./codes/wellknown-exit-codes.js";
-/* common/application.ts */
-	// Identifiers (3)
-	export { Exit } from "./common/application.js";
-	export { InterruptError } from "./common/application.js";
-	export { UsageError } from "./common/application.js";
 /* common/base.ts */
-	// Identifiers (8)
-	export type { IErrorOptions } from "./common/base.js";
-	export { humanReadable } from "./common/base.js";
-	export type { IHumanReadable } from "./common/base.js";
-	export { isHumanReadableError } from "./common/base.js";
-	export { NotError } from "./common/base.js";
+	// Identifiers (2)
 	export { ErrorWithCode } from "./common/base.js";
-	export { CanceledError } from "./common/base.js";
-	export { TimeoutError } from "./common/base.js";
-/* common/development.ts */
-	// Identifiers (4)
-	export { ProgramError } from "./common/development.js";
-	export { NotImplementedError } from "./common/development.js";
-	export { SoftwareDefectError } from "./common/development.js";
-	export { Assertion } from "./common/development.js";
-/* common/nodejs.ts */
+	export { TypeErrorWithCode } from "./common/base.js";
+/* common/human-readable.ts */
+	// Identifiers (3)
+	export { humanReadable } from "./common/human-readable.js";
+	export type { IHumanReadable } from "./common/human-readable.js";
+	export { isHumanReadable } from "./common/human-readable.js";
+/* common/not-error.ts */
+	// Identifiers (1)
+	export { NotError } from "./common/not-error.js";
+/* common/type.ts */
+	// Identifiers (1)
+	export type { IErrorOptions } from "./common/type.js";
+/* common/v8.ts */
+	// Identifiers (0)
+/* error-types/application.ts */
+	// Identifiers (3)
+	export { Exit } from "./error-types/application.js";
+	export { InterruptError } from "./error-types/application.js";
+	export { UsageError } from "./error-types/application.js";
+/* error-types/dependency.ts */
+	// Identifiers (2)
+	export { DependencyError } from "./error-types/dependency.js";
+	export { ChildProcessExitError } from "./error-types/dependency.js";
+/* error-types/development.ts */
+	// Identifiers (5)
+	export { ProgramError } from "./error-types/development.js";
+	export { NotImplementedError } from "./error-types/development.js";
+	export { SoftwareDefectError } from "./error-types/development.js";
+	export { Assertion } from "./error-types/development.js";
+	export { VariableTypeError } from "./error-types/development.js";
+/* error-types/nodejs.ts */
 	// Identifiers (7)
-	export type { OpenSSLException } from "./common/nodejs.js";
-	export { isModuleResolutionError } from "./common/nodejs.js";
-	export { isNotExistsError } from "./common/nodejs.js";
-	export { isExistsError } from "./common/nodejs.js";
-	export { isTypeError } from "./common/nodejs.js";
-	export { isFileTypeError } from "./common/nodejs.js";
-	export { isNodeError } from "./common/nodejs.js";
-/* common/unhandled-errors.ts */
+	export type { OpenSSLException } from "./error-types/nodejs.js";
+	export { isModuleResolutionError } from "./error-types/nodejs.js";
+	export { isNotExistsError } from "./error-types/nodejs.js";
+	export { isExistsError } from "./error-types/nodejs.js";
+	export { isTypeError } from "./error-types/nodejs.js";
+	export { isFileTypeError } from "./error-types/nodejs.js";
+	export { isNodeError } from "./error-types/nodejs.js";
+/* error-types/nodejs.unhandled.ts */
+	// Identifiers (2)
+	export { UnhandledRejection } from "./error-types/nodejs.unhandled.js";
+	export { UncaughtException } from "./error-types/nodejs.unhandled.js";
+/* error-types/tools.ts */
 	// Identifiers (2)
-	export { UnhandledRejection } from "./common/unhandled-errors.js";
-	export { UncaughtException } from "./common/unhandled-errors.js";
+	export { CanceledError } from "./error-types/tools.js";
+	export { TimeoutError } from "./error-types/tools.js";

package/src/common/base.ts

@@ -1,51 +1,10 @@
-import { ExitCode } from '../codes/wellknown-exit-codes.js';
-
-function noop() {}
-
-const replaceStackTrace = Error.captureStackTrace ?? noop;
-
-export interface IErrorOptions {
-	/**
-	 * stack属性的边界函数
-	 * @see {Error.captureStackTrace}
-	 */
-	boundary?: CallableFunction;
-
-	/**
-	 * cause属性的值
-	 * @see {Error.cause}
-	 */
-	cause?: unknown;
-}
-
-export const humanReadable = Symbol('humanReadable');
-export interface IHumanReadable {
-	[humanReadable](): string;
-}
-
-export function isHumanReadableError(error: unknown): error is IHumanReadable {
-	return error instanceof Object && humanReadable in error;
-}
-
-/**
- * 利用try...catch统一接口，或是用于分支条件等，未发生错误的情况
- */
-export class NotError implements IHumanReadable {
-	constructor(public readonly extra_message: string = '') {}
-
-	get stack() {
-		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
-	}
-	get message() {
-		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
-	}
-
-	[humanReadable]() {
-		return `你不应该看到此消息。你无需尝试处理该错误，请联系开发者。[hint: ${this.extra_message}]`;
-	}
-}
+import { humanReadable, type IHumanReadable } from './human-readable.js';
+import type { IErrorOptions } from './type.js';
+import { captureStackTrace } from './v8.js';
 
 /**
+ * 最基本的错误类型
+ * 其他所有错误的基类
  * @abstract
  */
 export class ErrorWithCode extends Error implements IHumanReadable {
@@ -56,7 +15,7 @@ export class ErrorWithCode extends Error implements IHumanReadable {
 	) {
 		super(message, opts);
 
-		replaceStackTrace(this, opts?.boundary ?? this.constructor);
+		captureStackTrace(this, opts?.boundary ?? this.constructor);
 	}
 
 	public override get name() {
@@ -66,55 +25,17 @@ export class ErrorWithCode extends Error implements IHumanReadable {
 	[humanReadable]() {
 		let msg: string;
 		if (this.code === 0) {
-			msg = '程序正常结束';
+			msg = '未发生异常';
 		} else {
-			msg = `程序以非0状态正常结束，状态码：${this.code}`;
+			msg = `异常状态 [${this.code}]`;
 		}
 		return `${msg}\n  - 但是你不应该看到此信息，开发者忘记处理此种情况`;
 	}
 }
 
-Object.setPrototypeOf(ErrorWithCode.prototype, Error.prototype);
+export class TypeErrorWithCode extends ErrorWithCode {}
 
 /**
- * Error when something.cancel() is called
- * @public
+ * 假装继承自 TypeError
  */
-export class CanceledError extends ErrorWithCode implements IHumanReadable {
-	constructor(opts?: IErrorOptions) {
-		super('Canceled', ExitCode.INTERRUPT, opts);
-	}
-
-	static is(e: unknown): e is CanceledError {
-		return e instanceof CanceledError;
-	}
-
-	override [humanReadable]() {
-		return '操作已应用户要求而取消';
-	}
-}
-
-/**
- * Error when something timeout
- * @public
- */
-export class TimeoutError extends ErrorWithCode implements IHumanReadable {
-	private readonly what?: string;
-
-	constructor(
-		private readonly ms: number,
-		private readonly why = 'no response',
-		opts?: IErrorOptions & { what?: string },
-	) {
-		super(`Timeout: ${why} in ${ms}ms${opts?.what ? ` (when ${opts.what})` : ''}`, ExitCode.TIMEOUT, opts);
-		this.what = opts?.what;
-	}
-
-	static is(error: unknown): error is TimeoutError {
-		return error instanceof TimeoutError;
-	}
-
-	override [humanReadable]() {
-		return `操作超时: ${this.what ? this.what : '操作没有说明'}\n  - 时长: ${this.ms}ms\n  - 原因: ${this.why}`;
-	}
-}
+Object.setPrototypeOf(TypeErrorWithCode.prototype, TypeError.prototype);

package/src/common/human-readable.ts

@@ -0,0 +1,8 @@
+export const humanReadable = Symbol('humanReadable');
+export interface IHumanReadable {
+	[humanReadable](): string;
+}
+
+export function isHumanReadable(error: unknown): error is IHumanReadable {
+	return error instanceof Object && humanReadable in error;
+}

package/src/common/not-error.ts

@@ -0,0 +1,19 @@
+import { humanReadable, type IHumanReadable } from './human-readable.js';
+
+/**
+ * 利用try...catch统一接口，或是用于分支条件等，未发生错误的情况
+ */
+export class NotError implements IHumanReadable {
+	constructor(public readonly extra_message: string = '') {}
+
+	get stack() {
+		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
+	}
+	get message() {
+		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
+	}
+
+	[humanReadable]() {
+		return `你不应该看到此消息。你无需尝试处理该错误，请联系开发者。[hint: ${this.extra_message}]`;
+	}
+}

package/src/common/type-shim.ts

@@ -0,0 +1,7 @@
+// biome-ignore-all lint/suspicious/noTsIgnore: 切换文件
+
+/** @ts-ignore */
+export type ChildProcess = import('node:child_process').ChildProcess;
+
+/** @ts-ignore */
+export type SignalsType = NodeJS.Signals;

package/src/common/type.ts

@@ -0,0 +1,13 @@
+export interface IErrorOptions {
+	/**
+	 * stack属性的边界函数
+	 * @see {Error.captureStackTrace}
+	 */
+	boundary?: CallableFunction;
+
+	/**
+	 * cause属性的值
+	 * @see {Error.cause}
+	 */
+	cause?: unknown;
+}

package/src/common/v8.ts

@@ -0,0 +1,4 @@
+function noop() {}
+
+/** @internal */
+export const captureStackTrace = Error.captureStackTrace ?? noop;

package/src/{common → error-types}/application.ts

@@ -1,5 +1,7 @@
 import { ExitCode } from '../codes/wellknown-exit-codes.js';
-import { ErrorWithCode, humanReadable, type IErrorOptions } from './base.js';
+import { ErrorWithCode } from '../common/base.js';
+import { humanReadable } from '../common/human-readable.js';
+import type { IErrorOptions } from '../common/type.js';
 
 /**
  * 程序因为正常运行结束而退出
@@ -30,6 +32,7 @@ export class InterruptError extends ErrorWithCode {
 
 /**
  * 由于错误的参数、配置导致错误
+ * 非程序问题
  */
 export class UsageError extends ErrorWithCode {
 	constructor(message: string, opts?: IErrorOptions) {

package/src/error-types/dependency.ts

@@ -0,0 +1,51 @@
+import type { ChildProcess, SignalsType } from '../common/type-shim.js';
+import type { IErrorOptions } from '../common/type.js';
+import { ProgramError } from './development.js';
+
+export class DependencyError extends ProgramError {}
+
+interface IChildProcessErrorOptions extends IErrorOptions {
+	readonly commandline?: readonly string[];
+	readonly pid?: number;
+	readonly workingDirectory?: string;
+	readonly exitCode?: number;
+	readonly signal?: SignalsType;
+	readonly process?: ChildProcess;
+}
+
+export class ChildProcessExitError extends DependencyError {
+	public pid?: number;
+	public commandline?: readonly string[];
+	public workingDirectory?: string;
+	public exitCode?: number;
+	public signal?: SignalsType;
+	public process?: ChildProcess;
+
+	constructor({ pid, commandline, workingDirectory, exitCode, signal, process, ...opts }: IChildProcessErrorOptions) {
+		let message = '';
+		message += pid ? `子进程 ${pid} ` : '未知子进程';
+		message += '非预期退出, ';
+		if (exitCode) {
+			message += `返回 ${exitCode}`;
+		} else if (signal) {
+			message += `信号 ${signal}`;
+		} else {
+			message += '可能未正常启动';
+		}
+		if (commandline) {
+			message += `\n  命令行: ${commandline.join(' ')}`;
+		}
+		if (workingDirectory) {
+			message += `\n  工作目录: ${workingDirectory}`;
+		}
+
+		super(message, opts);
+
+		this.pid = pid;
+		this.commandline = commandline;
+		this.workingDirectory = workingDirectory;
+		this.exitCode = exitCode;
+		this.signal = signal;
+		this.process = process;
+	}
+}

package/src/error-types/development.ts

@@ -0,0 +1,61 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
+import { ErrorWithCode } from '../common/base.js';
+import type { IErrorOptions } from '../common/type.js';
+
+/**
+ * 由于程序出现bug导致的各类异常
+ */
+export abstract class ProgramError extends ErrorWithCode {
+	constructor(message: string, opts?: IErrorOptions) {
+		super(message, ExitCode.PROGRAM, opts);
+	}
+}
+
+export class NotImplementedError extends ProgramError {
+	constructor(message: string = '此功能未实现', opts?: IErrorOptions) {
+		super(message, opts);
+	}
+}
+
+export class SoftwareDefectError extends ProgramError {}
+
+export class Assertion extends SoftwareDefectError {
+	static ok(value: unknown, message: string = '断言失败', opts?: IErrorOptions): asserts value {
+		if (!value) {
+			if (!opts?.boundary) {
+				if (!opts) opts = {};
+				opts.boundary = Assertion.ok;
+			}
+			throw new SoftwareDefectError(`${message}: 应为真值, 实际为${typeof value}类型的 "${value}"`, opts);
+		}
+	}
+}
+
+interface IVariableTypeErrorOptions extends IErrorOptions {
+	Expected?: Function;
+	variableName?: string;
+}
+
+export class VariableTypeError extends ProgramError {
+	public readonly ExpectedClass?: Function;
+
+	constructor(
+		public readonly object: any,
+		{ Expected, variableName = '变量', ...opts }: IVariableTypeErrorOptions = {},
+	) {
+		let message = '';
+		if (Expected) {
+			message += `应是 ${Expected.name}`;
+		}
+
+		const Actual = object.constructor;
+		if (message) {
+			message += ', 实际是 ';
+		} else {
+			message += '不能是 ';
+		}
+		message += Actual.name;
+
+		super(`${object}的类型${message}`, opts);
+	}
+}

package/src/error-types/tools.ts

@@ -0,0 +1,48 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
+import { ErrorWithCode } from '../common/base.js';
+import { humanReadable, type IHumanReadable } from '../common/human-readable.js';
+import type { IErrorOptions } from '../common/type.js';
+
+/**
+ * 发生本程序主动发起的取消行为时
+ * @public
+ */
+export class CanceledError extends ErrorWithCode implements IHumanReadable {
+	constructor(opts?: IErrorOptions) {
+		super('Canceled', ExitCode.INTERRUPT, opts);
+	}
+
+	static is(e: unknown): e is CanceledError {
+		return e instanceof CanceledError;
+	}
+
+	override [humanReadable]() {
+		return '操作已应要求而取消';
+	}
+}
+
+/**
+ * 某种操作超时
+ *
+ * @public
+ */
+export class TimeoutError extends ErrorWithCode implements IHumanReadable {
+	private readonly what?: string;
+
+	constructor(
+		private readonly ms: number,
+		private readonly why = 'no response',
+		opts?: IErrorOptions & { what?: string },
+	) {
+		super(`Timeout: ${why} in ${ms}ms${opts?.what ? ` (when ${opts.what})` : ''}`, ExitCode.TIMEOUT, opts);
+		this.what = opts?.what;
+	}
+
+	static is(error: unknown): error is TimeoutError {
+		return error instanceof TimeoutError;
+	}
+
+	override [humanReadable]() {
+		return `操作超时: ${this.what ? this.what : '操作没有说明'}\n  - 时长: ${this.ms}ms\n  - 原因: ${this.why}`;
+	}
+}

package/lib/common/application.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/common/application.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE7E;;;GAGG;AACH,qBAAa,IAAK,SAAQ,aAAa;gBAC1B,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;CAG9C;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa;aAE/B,MAAM,EAAE,MAAM,CAAC,OAAO;gBAAtB,MAAM,EAAE,MAAM,CAAC,OAAO,EACtC,IAAI,CAAC,EAAE,aAAa;IAKZ,CAAC,aAAa,CAAC;CAGxB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;IAIxC,CAAC,aAAa,CAAC;CAGxB"}

package/lib/common/application.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"application.js","sourceRoot":"","sources":["../../src/common/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAC;AAE7E;;;GAGG;AACH,MAAM,OAAO,IAAK,SAAQ,aAAa;IACtC,YAAY,IAAY,EAAE,IAAoB;QAC7C,KAAK,CAAC,0BAA0B,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAE/B;IADjB,YACiB,MAAsB,EACtC,IAAoB;QAEpB,KAAK,CAAC,uBAAuB,MAAM,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAHjD,WAAM,GAAN,MAAM,CAAgB;IAIvC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,SAAS,IAAI,CAAC,MAAM,OAAO,CAAC;IACpC,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,aAAa;IAC5C,YAAY,OAAe,EAAE,IAAoB;QAChD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,SAAS,IAAI,CAAC,OAAO,+BAA+B,CAAC;IAC7D,CAAC;CACD"}

package/lib/common/development.d.ts

@@ -1,12 +0,0 @@
-import { ErrorWithCode, type IErrorOptions } from './base.js';
-export declare abstract class ProgramError extends ErrorWithCode {
-    constructor(message: string, opts?: IErrorOptions);
-}
-export declare class NotImplementedError extends ProgramError {
-}
-export declare class SoftwareDefectError extends ProgramError {
-}
-export declare class Assertion extends SoftwareDefectError {
-    static ok(value: unknown, message?: string, opts?: IErrorOptions): asserts value;
-}
-//# sourceMappingURL=development.d.ts.map