@plugjs/expect5 0.4.0

package/dist/expectation/print.mjs

@@ -0,0 +1,256 @@
+// expectation/print.ts
+import { $grn, $gry, $red, $und, $wht, $ylw } from "@plugjs/plug/logging";
+import { textDiff } from "@plugjs/plug/utils";
+import { stringifyValue } from "./types.mjs";
+var _opnPar = $gry("(");
+var _clsPar = $gry(")");
+var _opnCrl = $gry("{");
+var _clsCrl = $gry("}");
+var _curls = $gry("{}");
+var _opnSqr = $gry("[");
+var _clsSqr = $gry("]");
+var _squares = $gry("[]");
+var _slash = $gry("/");
+var _tilde = $gry("~");
+var _hellip = $gry("\u2026");
+var _error = `${_opnPar}${$gry($und("error"))}${_clsPar}`;
+var _string = `${_opnPar}${$gry($und("string"))}${_clsPar}`;
+var _extraProps = $gry("\u2026 extra props \u2026");
+var _diffHeader = `${$wht("Differences")} ${_opnPar}${$red("actual")}${_slash}${$grn("expected")}${_slash}${$ylw("errors")}${_clsPar}:`;
+function printBaseDiff(log, diff, prop, mapping, comma) {
+  if ("props" in diff)
+    return printObjectDiff(log, diff, prop, mapping, comma);
+  if ("values" in diff)
+    return printObjectDiff(log, diff, prop, mapping, comma);
+  if ("mappings" in diff)
+    return printObjectDiff(log, diff, prop, mapping, comma);
+  if ("expected" in diff)
+    return printExpectedDiff(log, diff, prop, mapping, comma);
+  if ("missing" in diff)
+    return printMissingDiff(log, diff, prop, mapping, comma);
+  if ("extra" in diff)
+    return printExtraDiff(log, diff, prop, mapping, comma);
+  const { prefix, suffix } = diff.error ? (
+    // default style if error is the only property
+    fixups(prop, mapping, comma, diff.error)
+  ) : diff.diff ? (
+    // label as "differs" if no error was found
+    fixups(prop, mapping, comma, diff.error, $red, "differs")
+  ) : fixups(prop, mapping, comma, diff.error);
+  dump(log, diff.value, prefix, suffix, diff.diff ? $red : $wht);
+}
+function printExpectedDiff(log, diff, prop, mapping, comma) {
+  if (typeof diff.value === "string" && typeof diff.expected === "string") {
+    const { prefix, suffix } = fixups(prop, mapping, false, diff.error);
+    log.warn(`${prefix}${_string}${suffix}`);
+    textDiff(diff.value, diff.expected).split("\n").forEach((line) => {
+      log.warn(`  ${_hellip} ${line}`);
+    });
+  } else if (diff.value === null || typeof diff.value !== "object") {
+    const { prefix, suffix } = fixups(prop, mapping, comma, diff.error);
+    const joined = `${prefix}${$red(stringify(diff.value))} ${_tilde} `;
+    dump(log, diff.expected, joined, suffix, $grn);
+  } else if (diff.expected === null || typeof diff.expected !== "object") {
+    const { prefix, suffix } = fixups(prop, mapping, comma, diff.error);
+    const joined = ` ${_tilde} ${$grn(stringify(diff.expected))}${suffix}`;
+    dump(log, diff.value, prefix, joined, $red);
+  } else {
+    const { prefix, suffix: suffix1 } = fixups(prop, mapping, false, "");
+    const { suffix: suffix2 } = fixups(prop, mapping, comma, diff.error);
+    const lastLine = dumpAndContinue(log, diff.expected, prefix, suffix1, $red);
+    dump(log, diff.value, `${lastLine} ${_tilde} `, suffix2, $grn);
+  }
+}
+function printMissingDiff(log, diff, prop, mapping, comma) {
+  const { prefix, suffix } = fixups(prop, mapping, comma, diff.error, $red, "missing");
+  dump(log, diff.missing, prefix, suffix, $red);
+}
+function printExtraDiff(log, diff, prop, mapping, comma) {
+  const { prefix, suffix } = fixups(prop, mapping, comma, diff.error, $red, "extra");
+  dump(log, diff.extra, prefix, suffix, $red);
+}
+function printObjectDiff(log, diff, prop, mapping, comma) {
+  const { prefix, suffix } = fixups(prop, mapping, comma, diff.error);
+  const value = diff.value;
+  const ctor = Object.getPrototypeOf(value)?.constructor;
+  const string = ctor === Object || ctor === Array ? "" : stringifyValue(value);
+  let line = string ? `${prefix}${$wht(string)} ` : prefix;
+  let marked = false;
+  if (diff.values) {
+    if (diff.values.length === 0) {
+      line = `${line}${_squares}`;
+    } else {
+      log.warn(`${line}${_opnSqr}`);
+      log.enter();
+      try {
+        for (const subdiff of diff.values) {
+          printBaseDiff(log, subdiff, "", false, true);
+        }
+      } finally {
+        log.leave();
+      }
+      line = _clsSqr;
+    }
+    marked = true;
+  } else if (diff.mappings) {
+    if (Object.keys(diff.mappings).length === 0) {
+      line = `${line}${_curls}`;
+    } else {
+      log.warn(`${line}${_opnCrl}`);
+      log.enter();
+      try {
+        for (const [key, subdiff] of diff.mappings) {
+          printBaseDiff(log, subdiff, stringifyValue(key), true, true);
+        }
+      } finally {
+        log.leave();
+      }
+      line = _clsCrl;
+    }
+    marked = true;
+  }
+  if (diff.props) {
+    if (marked)
+      line = `${line} ${_extraProps} `;
+    if (Object.keys(diff.props).length === 0) {
+      line = `${line}${_curls}`;
+    } else {
+      log.warn(`${line}${_opnCrl}`);
+      log.enter();
+      try {
+        for (const [prop2, subdiff] of Object.entries(diff.props)) {
+          printBaseDiff(log, subdiff, stringifyValue(prop2), false, true);
+        }
+      } finally {
+        log.leave();
+      }
+      line = _clsCrl;
+    }
+    marked = true;
+  }
+  log.warn(`${line}${suffix}`);
+}
+function stringify(value) {
+  if (typeof value === "string")
+    return JSON.stringify(value);
+  return stringifyValue(value);
+}
+function fixups(prop, mapping, comma, error, color, label) {
+  if (error)
+    color = color || $ylw;
+  const lbl = label ? `${_opnPar}${$gry($und(label))}${_clsPar} ` : "";
+  const sep = mapping ? " => " : ": ";
+  const prefix = prop ? color ? `${$gry(lbl)}${color(prop)}${$gry(sep)}` : `${$gry(lbl)}${prop}${$gry(sep)}` : label ? `${$gry(lbl)}` : "";
+  error = error ? ` ${_error} ${$ylw(error)}` : "";
+  const suffix = `${comma ? $gry(",") : ""}${error}`;
+  return { prefix, suffix };
+}
+function dump(log, value, prefix, suffix, color, stack = []) {
+  log.warn(dumpAndContinue(log, value, prefix, suffix, color, stack));
+}
+function dumpAndContinue(log, value, prefix, suffix, color, stack = []) {
+  if (value === null || typeof value !== "object") {
+    return `${prefix}${color(stringify(value))}${suffix}`;
+  }
+  const circular = stack.indexOf(value);
+  if (circular >= 0) {
+    return `${prefix}${$gry($und(`<circular ${circular}>`))}${suffix}`;
+  }
+  const ctor = Object.getPrototypeOf(value)?.constructor;
+  const string = ctor === Object || ctor === Array ? "" : stringifyValue(value);
+  const keys = new Set(Object.keys(value));
+  let line = string ? `${prefix}${$wht(string)} ` : prefix;
+  let marked = false;
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      line = `${line}${_squares}`;
+    } else {
+      log.warn(`${line}${_opnSqr}`);
+      log.enter();
+      try {
+        for (let i = 0; i < value.length; i++) {
+          const { prefix: prefix2, suffix: suffix2 } = fixups("", false, true, void 0, color);
+          dump(log, value[i], prefix2, suffix2, color, [...stack, value]);
+          keys.delete(String(i));
+        }
+      } finally {
+        log.leave();
+      }
+      line = _clsSqr;
+    }
+    marked = true;
+  } else if (value instanceof Set) {
+    if (value.size === 0) {
+      line = `${line}${_squares}`;
+    } else {
+      log.warn(`${line}${_opnSqr}`);
+      log.enter();
+      try {
+        const { prefix: prefix2, suffix: suffix2 } = fixups("", false, true, void 0, color);
+        value.forEach((v) => dump(log, v, prefix2, suffix2, color, [...stack, value]));
+      } finally {
+        log.leave();
+      }
+      line = _clsSqr;
+    }
+    marked = true;
+  } else if (value instanceof Map) {
+    if (value.size === 0) {
+      line = `${line}${_curls}`;
+    } else {
+      log.warn(`${line}${_opnCrl}`);
+      log.enter();
+      try {
+        for (const [key, subvalue] of value) {
+          const { prefix: prefix2, suffix: suffix2 } = fixups(stringifyValue(key), true, true, void 0, color);
+          dump(log, subvalue, prefix2, suffix2, color, [...stack, value]);
+        }
+      } finally {
+        log.leave();
+      }
+      line = _clsCrl;
+    }
+    marked = true;
+  }
+  if (value instanceof String) {
+    const length = value.valueOf().length;
+    for (let i = 0; i < length; i++)
+      keys.delete(String(i));
+  }
+  if (keys.size) {
+    if (marked)
+      line = `${line} ${_extraProps} `;
+    log.warn(`${line}${_opnCrl}`);
+    log.enter();
+    try {
+      for (const key of keys) {
+        const { prefix: prefix2, suffix: suffix2 } = fixups(stringifyValue(key), false, true, void 0, color);
+        dump(log, value[key], prefix2, suffix2, color, [...stack, value]);
+      }
+    } finally {
+      log.leave();
+    }
+    line = _clsCrl;
+    marked = true;
+  }
+  if (marked) {
+    return `${line}${suffix}`;
+  } else {
+    return `${line}${_curls}${suffix}`;
+  }
+}
+function printDiff(log, diff, header = true) {
+  if (!header)
+    return printBaseDiff(log, diff, "", false, false);
+  log.warn(_diffHeader);
+  log.enter();
+  try {
+    printBaseDiff(log, diff, "", false, false);
+  } finally {
+    log.leave();
+  }
+}
+export {
+  printDiff
+};
+//# sourceMappingURL=print.mjs.map

package/dist/expectation/print.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/expectation/print.ts"],
+  "mappings": "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",
+  "names": ["prop", "prefix", "suffix"]
+}

package/dist/expectation/throwing.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// expectation/throwing.ts
+var throwing_exports = {};
+__export(throwing_exports, {
+  ToThrow: () => ToThrow,
+  ToThrowError: () => ToThrowError
+});
+module.exports = __toCommonJS(throwing_exports);
+var import_types = require("./types.cjs");
+var ToThrow = class {
+  expect(context, negative, assert) {
+    (0, import_types.assertType)(context, "function");
+    let thrown;
+    let error;
+    try {
+      context.value();
+      thrown = false;
+      error = void 0;
+    } catch (caught) {
+      thrown = true;
+      error = caught;
+    }
+    if (thrown === negative) {
+      throw new import_types.ExpectationError(context, negative, "to throw");
+    } else if (thrown && assert) {
+      assert(context.forValue(error));
+    }
+  }
+};
+var ToThrowError = class {
+  expect(context, negative, ...args) {
+    context.negated(negative).toThrow((assert) => assert.toBeError(...args));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ToThrow,
+  ToThrowError
+});
+//# sourceMappingURL=throwing.cjs.map

package/dist/expectation/throwing.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/expectation/throwing.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA6C;AAKtC,IAAM,UAAN,MAAqC;AAAA,EAC1C,OACI,SACA,UACA,QACI;AACN,iCAAW,SAAS,UAAU;AAE9B,QAAI;AACJ,QAAI;AACJ,QAAI;AACF,cAAQ,MAAM;AACd,eAAS;AACT,cAAQ;AAAA,IACV,SAAS,QAAP;AACA,eAAS;AACT,cAAQ;AAAA,IACV;AAEA,QAAI,WAAW,UAAU;AACvB,YAAM,IAAI,8BAAiB,SAAS,UAAU,UAAU;AAAA,IAC1D,WAAW,UAAU,QAAQ;AAC3B,aAAO,QAAQ,SAAS,KAAK,CAAC;AAAA,IAChC;AAAA,EACF;AACF;AAEO,IAAM,eAAN,MAA0C;AAAA,EAC/C,OACI,SACA,aACG,MAKC;AACN,YAAQ,QAAQ,QAAQ,EAAE,QAAQ,CAAC,WAAW,OAAO,UAAU,GAAG,IAAI,CAAC;AAAA,EACzE;AACF;",
+  "names": []
+}

package/dist/expectation/throwing.d.ts

@@ -0,0 +1,8 @@
+import type { Expectation, Expectations } from './expect';
+import type { Constructor, StringMatcher } from './types';
+export declare class ToThrow implements Expectation {
+    expect(context: Expectations, negative: boolean, assert?: (errorExpectations: Expectations) => void): void;
+}
+export declare class ToThrowError implements Expectation {
+    expect(context: Expectations, negative: boolean, ...args: [] | [message: StringMatcher] | [constructor: Constructor<Error>] | [constructor: Constructor<Error>, message: StringMatcher]): void;
+}

package/dist/expectation/throwing.mjs

@@ -0,0 +1,32 @@
+// expectation/throwing.ts
+import { ExpectationError, assertType } from "./types.mjs";
+var ToThrow = class {
+  expect(context, negative, assert) {
+    assertType(context, "function");
+    let thrown;
+    let error;
+    try {
+      context.value();
+      thrown = false;
+      error = void 0;
+    } catch (caught) {
+      thrown = true;
+      error = caught;
+    }
+    if (thrown === negative) {
+      throw new ExpectationError(context, negative, "to throw");
+    } else if (thrown && assert) {
+      assert(context.forValue(error));
+    }
+  }
+};
+var ToThrowError = class {
+  expect(context, negative, ...args) {
+    context.negated(negative).toThrow((assert) => assert.toBeError(...args));
+  }
+};
+export {
+  ToThrow,
+  ToThrowError
+};
+//# sourceMappingURL=throwing.mjs.map

package/dist/expectation/throwing.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/expectation/throwing.ts"],
+  "mappings": ";AAAA,SAAS,kBAAkB,kBAAkB;AAKtC,IAAM,UAAN,MAAqC;AAAA,EAC1C,OACI,SACA,UACA,QACI;AACN,eAAW,SAAS,UAAU;AAE9B,QAAI;AACJ,QAAI;AACJ,QAAI;AACF,cAAQ,MAAM;AACd,eAAS;AACT,cAAQ;AAAA,IACV,SAAS,QAAP;AACA,eAAS;AACT,cAAQ;AAAA,IACV;AAEA,QAAI,WAAW,UAAU;AACvB,YAAM,IAAI,iBAAiB,SAAS,UAAU,UAAU;AAAA,IAC1D,WAAW,UAAU,QAAQ;AAC3B,aAAO,QAAQ,SAAS,KAAK,CAAC;AAAA,IAChC;AAAA,EACF;AACF;AAEO,IAAM,eAAN,MAA0C;AAAA,EAC/C,OACI,SACA,aACG,MAKC;AACN,YAAQ,QAAQ,QAAQ,EAAE,QAAQ,CAAC,WAAW,OAAO,UAAU,GAAG,IAAI,CAAC;AAAA,EACzE;AACF;",
+  "names": []
+}

package/dist/expectation/types.cjs

@@ -0,0 +1,212 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// expectation/types.ts
+var types_exports = {};
+__export(types_exports, {
+  ExpectationError: () => ExpectationError,
+  assertType: () => assertType,
+  isMatcher: () => isMatcher,
+  isType: () => isType,
+  matcherMarker: () => matcherMarker,
+  prefixType: () => prefixType,
+  stringifyConstructor: () => stringifyConstructor,
+  stringifyObjectType: () => stringifyObjectType,
+  stringifyValue: () => stringifyValue,
+  typeOf: () => typeOf
+});
+module.exports = __toCommonJS(types_exports);
+function typeOf(value) {
+  if (value === null)
+    return "null";
+  const type = typeof value;
+  switch (type) {
+    case "bigint":
+    case "boolean":
+    case "function":
+    case "number":
+    case "string":
+    case "symbol":
+    case "undefined":
+      return type;
+  }
+  if (Array.isArray(value))
+    return "array";
+  if (value instanceof Promise)
+    return "promise";
+  if (typeof value["then"] === "function")
+    return "promise";
+  if (value instanceof Buffer)
+    return "buffer";
+  if (value instanceof RegExp)
+    return "regexp";
+  if (value instanceof Map)
+    return "map";
+  if (value instanceof Set)
+    return "set";
+  return "object";
+}
+function isType(context, type) {
+  return typeOf(context.value) === type;
+}
+function assertType(context, type) {
+  const { value } = context;
+  if (typeOf(value) === type)
+    return;
+  throw new ExpectationError(context, false, `to be ${prefixType(type)}`);
+}
+function constructorName(value) {
+  return Object.getPrototypeOf(value)?.constructor?.name;
+}
+function formatBinaryData(value, buffer) {
+  const binary = buffer.length > 20 ? `${buffer.toString("hex", 0, 20)}\u2026, length=${value.length}` : buffer.toString("hex");
+  return binary ? `[${constructorName(value)}: ${binary}]` : `[${constructorName(value)}: empty]`;
+}
+function stringifyObjectType(value) {
+  const proto = Object.getPrototypeOf(value);
+  if (!proto)
+    return "[Object: null prototype]";
+  return stringifyConstructor(proto.constructor);
+}
+function stringifyConstructor(ctor) {
+  if (!ctor)
+    return "[Object: no constructor]";
+  if (!ctor.name)
+    return "[Object: anonymous]";
+  return `[${ctor.name}]`;
+}
+function stringifyValue(value) {
+  if (value === null)
+    return "<null>";
+  if (value === void 0)
+    return "<undefined>";
+  switch (typeof value) {
+    case "string":
+      if (value.length > 40)
+        value = `${value.substring(0, 40)}\u2026, length=${value.length}`;
+      return JSON.stringify(value);
+    case "number":
+      if (value === Number.POSITIVE_INFINITY)
+        return "+Infinity";
+      if (value === Number.NEGATIVE_INFINITY)
+        return "-Infinity";
+      return String(value);
+    case "boolean":
+      return String(value);
+    case "bigint":
+      return `${value}n`;
+    case "function":
+      return value.name ? `<function ${value.name}>` : "<function>";
+    case "symbol":
+      return value.description ? `<symbol ${value.description}>` : "<symbol>";
+  }
+  if (isMatcher(value))
+    return "<matcher>";
+  if (value instanceof RegExp)
+    return String(value);
+  if (value instanceof Date)
+    return `[${constructorName(value)}: ${value.toISOString()}]`;
+  if (value instanceof Boolean)
+    return `[${constructorName(value)}: ${value.valueOf()}]`;
+  if (value instanceof Number)
+    return `[${constructorName(value)}: ${stringifyValue(value.valueOf())}]`;
+  if (value instanceof String)
+    return `[${constructorName(value)}: ${stringifyValue(value.valueOf())}]`;
+  if (Array.isArray(value))
+    return `[${constructorName(value)} (${value.length})]`;
+  if (value instanceof Set)
+    return `[${constructorName(value)} (${value.size})]`;
+  if (value instanceof Map)
+    return `[${constructorName(value)} (${value.size})]`;
+  if (value instanceof Buffer)
+    return formatBinaryData(value, value);
+  if (value instanceof Uint8Array)
+    return formatBinaryData(value, Buffer.from(value));
+  if (value instanceof ArrayBuffer)
+    return formatBinaryData(value, Buffer.from(value));
+  if (value instanceof SharedArrayBuffer)
+    return formatBinaryData(value, Buffer.from(value));
+  return stringifyObjectType(value);
+}
+function prefixType(type) {
+  switch (type) {
+    case "bigint":
+    case "boolean":
+    case "buffer":
+    case "function":
+    case "map":
+    case "number":
+    case "promise":
+    case "regexp":
+    case "set":
+    case "string":
+    case "symbol":
+      return `a <${type}>`;
+    case "array":
+    case "object":
+      return `an <${type}>`;
+    case "null":
+    case "undefined":
+      return `<${type}>`;
+    default:
+      return `of unknown type <${type}>`;
+  }
+}
+var matcherMarker = Symbol.for("expect5.matcher");
+function isMatcher(what) {
+  return what && what[matcherMarker] === matcherMarker;
+}
+var ExpectationError = class extends Error {
+  diff;
+  constructor(context, negative, details, diff) {
+    const { value } = context;
+    const not = negative ? " not" : "";
+    let preamble = stringifyValue(value);
+    if (context.parent) {
+      const properties = [];
+      while (context.parent) {
+        properties.push(`[${stringifyValue(context.parent.prop)}]`);
+        context = context.parent.context;
+      }
+      preamble = properties.reverse().join("");
+      const type = typeof context.value === "object" ? stringifyObjectType(context.value) : (
+        // parent values can not be null!
+        stringifyValue(context.value)
+      );
+      preamble = `property ${preamble} of ${type} (${stringifyValue(value)})`;
+    }
+    super(`Expected ${preamble}${not} ${details}`);
+    if (diff)
+      this.diff = diff;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExpectationError,
+  assertType,
+  isMatcher,
+  isType,
+  matcherMarker,
+  prefixType,
+  stringifyConstructor,
+  stringifyObjectType,
+  stringifyValue,
+  typeOf
+});
+//# sourceMappingURL=types.cjs.map

package/dist/expectation/types.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/expectation/types.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoDO,SAAS,OAAO,OAA0B;AAC/C,MAAI,UAAU;AAAM,WAAO;AAG3B,QAAM,OAAO,OAAO;AACpB,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,EACX;AAGA,MAAI,MAAM,QAAQ,KAAK;AAAG,WAAO;AAEjC,MAAI,iBAAiB;AAAS,WAAO;AACrC,MAAI,OAAQ,MAAc,MAAM,MAAM;AAAY,WAAO;AAEzD,MAAI,iBAAiB;AAAQ,WAAO;AACpC,MAAI,iBAAiB;AAAQ,WAAO;AACpC,MAAI,iBAAiB;AAAK,WAAO;AACjC,MAAI,iBAAiB;AAAK,WAAO;AAGjC,SAAO;AACT;AAGO,SAAS,OACZ,SACA,MACwC;AAC1C,SAAO,OAAO,QAAQ,KAAK,MAAM;AACnC;AAGO,SAAS,WACZ,SACA,MACgD;AAClD,QAAM,EAAE,MAAM,IAAI;AAElB,MAAI,OAAO,KAAK,MAAM;AAAM;AAE5B,QAAM,IAAI,iBAAiB,SAAS,OAAO,SAAS,WAAW,IAAI,GAAG;AACxE;AAOA,SAAS,gBAAgB,OAAiC;AACxD,SAAO,OAAO,eAAe,KAAK,GAAG,aAAa;AACpD;AAGA,SAAS,iBAAiB,OAAyB,QAAwB;AACzE,QAAM,SAAS,OAAO,SAAS,KAC3B,GAAG,OAAO,SAAS,OAAO,GAAG,EAAE,mBAAmB,MAAM,WACxD,OAAO,SAAS,KAAK;AACzB,SAAO,SACH,IAAI,gBAAgB,KAAK,MAAM,YAC/B,IAAI,gBAAgB,KAAK;AAC/B;AAKO,SAAS,oBAAoB,OAAuB;AACzD,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,MAAI,CAAE;AAAO,WAAO;AACpB,SAAO,qBAAqB,MAAM,WAAW;AAC/C;AAGO,SAAS,qBAAqB,MAA2B;AAC9D,MAAI,CAAE;AAAM,WAAO;AACnB,MAAI,CAAE,KAAK;AAAM,WAAO;AACxB,SAAO,IAAI,KAAK;AAClB;AAGO,SAAS,eAAe,OAAwB;AACrD,MAAI,UAAU;AAAM,WAAO;AAC3B,MAAI,UAAU;AAAW,WAAO;AAEhC,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK;AACH,UAAI,MAAM,SAAS;AAAI,gBAAQ,GAAG,MAAM,UAAU,GAAG,EAAE,mBAAmB,MAAM;AAChF,aAAO,KAAK,UAAU,KAAK;AAAA,IAC7B,KAAK;AACH,UAAI,UAAU,OAAO;AAAmB,eAAO;AAC/C,UAAI,UAAU,OAAO;AAAmB,eAAO;AAC/C,aAAO,OAAO,KAAK;AAAA,IACrB,KAAK;AACH,aAAO,OAAO,KAAK;AAAA,IACrB,KAAK;AACH,aAAO,GAAG;AAAA,IACZ,KAAK;AACH,aAAO,MAAM,OAAO,aAAa,MAAM,UAAU;AAAA,IACnD,KAAK;AACH,aAAO,MAAM,cAAc,WAAW,MAAM,iBAAgB;AAAA,EAChE;AAGA,MAAI,UAAU,KAAK;AAAG,WAAO;AAC7B,MAAI,iBAAiB;AAAQ,WAAO,OAAO,KAAK;AAChD,MAAI,iBAAiB;AAAM,WAAO,IAAI,gBAAgB,KAAK,MAAM,MAAM,YAAY;AACnF,MAAI,iBAAiB;AAAS,WAAO,IAAI,gBAAgB,KAAK,MAAM,MAAM,QAAQ;AAClF,MAAI,iBAAiB;AAAQ,WAAO,IAAI,gBAAgB,KAAK,MAAM,eAAe,MAAM,QAAQ,CAAC;AACjG,MAAI,iBAAiB;AAAQ,WAAO,IAAI,gBAAgB,KAAK,MAAM,eAAe,MAAM,QAAQ,CAAC;AAEjG,MAAI,MAAM,QAAQ,KAAK;AAAG,WAAO,IAAI,gBAAgB,KAAK,MAAM,MAAM;AACtE,MAAI,iBAAiB;AAAK,WAAO,IAAI,gBAAgB,KAAK,MAAM,MAAM;AACtE,MAAI,iBAAiB;AAAK,WAAO,IAAI,gBAAgB,KAAK,MAAM,MAAM;AAEtE,MAAI,iBAAiB;AAAQ,WAAO,iBAAiB,OAAO,KAAK;AACjE,MAAI,iBAAiB;AAAY,WAAO,iBAAiB,OAAO,OAAO,KAAK,KAAK,CAAC;AAClF,MAAI,iBAAiB;AAAa,WAAO,iBAAiB,OAAO,OAAO,KAAK,KAAK,CAAC;AACnF,MAAI,iBAAiB;AAAmB,WAAO,iBAAiB,OAAO,OAAO,KAAK,KAAK,CAAC;AAGzF,SAAO,oBAAoB,KAAK;AAClC;AAGO,SAAS,WAAW,MAAwB;AACjD,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,MAAM;AAAA,IAEf,KAAK;AAAA,IACL,KAAK;AACH,aAAO,OAAO;AAAA,IAEhB,KAAK;AAAA,IACL,KAAK;AACH,aAAO,IAAI;AAAA,IAEb;AACE,aAAO,oBAAoB;AAAA,EAC/B;AACF;AAMO,IAAM,gBAAgB,OAAO,IAAI,iBAAiB;AAElD,SAAS,UAAU,MAAwC;AAChE,SAAO,QAAQ,KAAK,aAAa,MAAM;AACzC;AAMO,IAAM,mBAAN,cAA+B,MAAM;AAAA,EAC1C;AAAA,EAEA,YACI,SACA,UACA,SACA,MACF;AACA,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,MAAM,WAAW,SAAS;AAGhC,QAAI,WAAW,eAAe,KAAK;AACnC,QAAI,QAAQ,QAAQ;AAClB,YAAM,aAAoB,CAAC;AAE3B,aAAO,QAAQ,QAAQ;AACrB,mBAAW,KAAK,IAAI,eAAe,QAAQ,OAAO,IAAI,IAAI;AAC1D,kBAAU,QAAQ,OAAO;AAAA,MAC3B;AAEA,iBAAW,WAAW,QAAQ,EAAE,KAAK,EAAE;AAGvC,YAAM,OAAO,OAAO,QAAQ,UAAU,WAClC,oBAAoB,QAAQ,KAAe;AAAA;AAAA,QAC3C,eAAe,QAAQ,KAAK;AAAA;AAGhC,iBAAW,YAAY,eAAe,SAAS,eAAe,KAAK;AAAA,IACrE;AAEA,UAAM,YAAY,WAAW,OAAO,SAAS;AAE7C,QAAI;AAAM,WAAK,OAAO;AAAA,EACxB;AACF;",
+  "names": []
+}

package/dist/expectation/types.d.ts

@@ -0,0 +1,57 @@
+/// <reference types="node" />
+import type { Diff } from './diff';
+import type { Expectations, ExpectationsMatcher } from './expect';
+/** A type identifying any constructor */
+export type Constructor<T = any> = new (...args: any[]) => T;
+/** A type identifying any function */
+export type Callable<T = any> = (...args: readonly any[]) => T;
+/** A simple _record_ indicating an `object` but never an `array` */
+export type NonArrayObject<T = any> = {
+    [a: string]: T;
+    [b: symbol]: T;
+    [c: number]: never;
+};
+/** A type identifying the parameter of `string.match(...)` */
+export type StringMatcher = string | RegExp | {
+    [Symbol.match](string: string): RegExpMatchArray | null;
+};
+/** Mappings for our _expanded_ {@link typeOf} implementation */
+export type TypeMappings = {
+    bigint: bigint;
+    boolean: boolean;
+    function: Callable;
+    number: number;
+    string: string;
+    symbol: symbol;
+    undefined: undefined;
+    array: readonly any[];
+    buffer: Buffer;
+    map: Map<any, any>;
+    promise: PromiseLike<any>;
+    regexp: RegExp;
+    set: Set<any>;
+    object: NonArrayObject<any>;
+    null: null;
+};
+/** Values returned by our own _expanded_ `{@link typeOf}` */
+export type TypeName = keyof TypeMappings;
+/** Expanded `typeof` implementation returning some extra types */
+export declare function typeOf(value: unknown): TypeName;
+/** Determines if the specified `value` is of the specified _expanded_ `type` */
+export declare function isType<T extends keyof TypeMappings>(context: Expectations, type: T): context is Expectations<TypeMappings[T]>;
+/** Asserts that the specified `value` is of the specified _expanded_ `type` */
+export declare function assertType<T extends keyof TypeMappings>(context: Expectations, type: T): asserts context is Expectations<TypeMappings[T]>;
+/** Stringify the type of an object (its constructor name) */
+export declare function stringifyObjectType(value: object): string;
+/** Stringify a constructor */
+export declare function stringifyConstructor(ctor: Constructor): string;
+/** Pretty print the value (strings, numbers, booleans) or return the type */
+export declare function stringifyValue(value: unknown): string;
+/** Add the `a`/`an`/... prefix to the type name */
+export declare function prefixType(type: TypeName): string;
+export declare const matcherMarker: unique symbol;
+export declare function isMatcher(what: any): what is ExpectationsMatcher;
+export declare class ExpectationError extends Error {
+    diff?: Diff | undefined;
+    constructor(context: Expectations, negative: boolean, details: string, diff?: Diff);
+}