@nomicfoundation/hardhat-utils 3.0.3 → 3.0.5

package/dist/src/internal/lang.js

@@ -7,28 +7,30 @@ export async function getDeepCloneFunction() {
     }
     return clone;
 }
-export function deepMergeImpl(target, source) {
+export function deepMergeImpl(target, source, shouldOverwriteUndefined) {
     /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    -- The result is expected to include properties from both target and source,
-    but initially only target is spread in, so a cast is needed. */
+    -- Result will include properties from both T and S, but starts with only T */
     const result = { ...target };
-    /*  eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    -- TypeScript cannot infer the correct union of string and symbol keys, but all keys come from U */
+    /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+    -- All keys come from S, TypeScript can't infer the union of string and symbol keys */
     const keys = [
         ...Object.keys(source),
         ...Object.getOwnPropertySymbols(source),
     ];
     for (const key of keys) {
         if (isObject(source[key]) &&
-            // Only merge recursively objects that are not class instances
+            // Only merge plain objects, not class instances
             Object.getPrototypeOf(source[key]) === Object.prototype) {
             /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-            -- The call signature expects the second argument to be of type U; the type is correct, but TypeScript can't infer it here. */
-            result[key] = deepMergeImpl(result[key] ?? {}, source[key]);
+            -- result[key] will have the correct type after assignment but TS can't infer it */
+            result[key] = deepMergeImpl(result[key] ?? {}, 
+            /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+            -- source[key] is known to be from S but TS can't infer it */
+            source[key], shouldOverwriteUndefined);
         }
-        else {
+        else if (shouldOverwriteUndefined || source[key] !== undefined) {
             /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-            --  Cast required because TypeScript can't guarantee that a dynamic key from `U` exists in `T & U` or has the correct value type. */
+            -- result[key] will have the correct type after assignment but TS can't infer it */
             result[key] = source[key];
         }
     }

package/dist/src/internal/lang.js.map

@@ -1 +1 @@
-{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../../src/internal/lang.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,IAAI,KAAK,GAAoC,IAAI,CAAC;AAClD,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,KAAK,GAAG,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAS,EACT,MAAS;IAET;;mEAE+D;IAC/D,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAW,CAAC;IAEtC;uGACmG;IACnG,MAAM,IAAI,GAAG;QACX,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACtB,GAAG,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC;KACtB,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IACE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,8DAA8D;YAC9D,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,EACvD,CAAC;YACD;0IAC8H;YAC9H,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,GAAG,CAAM,CACjC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN;gJACoI;YACpI,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAsC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../../src/internal/lang.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,IAAI,KAAK,GAAoC,IAAI,CAAC;AAClD,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,KAAK,GAAG,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAS,EACT,MAAS,EACT,wBAAiC;IAEjC;kFAC8E;IAC9E,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAW,CAAC;IAEtC;0FACsF;IACtF,MAAM,IAAI,GAAG;QACX,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACtB,GAAG,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC;KACtB,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IACE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,gDAAgD;YAChD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,EACvD,CAAC;YACD;+FACmF;YACnF,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CACzB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;YACjB;yEAC6D;YAC7D,MAAM,CAAC,GAAG,CAAM,EAChB,wBAAwB,CACY,CAAC;QACzC,CAAC;aAAM,IAAI,wBAAwB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACjE;+FACmF;YACnF,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAsC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/internal/panic-errors.d.ts

@@ -0,0 +1,2 @@
+export declare function panicErrorCodeToReason(errorCode: bigint): string | undefined;
+//# sourceMappingURL=panic-errors.d.ts.map

package/dist/src/internal/panic-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panic-errors.d.ts","sourceRoot":"","sources":["../../../src/internal/panic-errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsB5E"}

package/dist/src/internal/panic-errors.js

@@ -0,0 +1,24 @@
+export function panicErrorCodeToReason(errorCode) {
+    // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- we are only covering some of the integer range
+    switch (errorCode) {
+        case 0x1n:
+            return "Assertion error";
+        case 0x11n:
+            return "Arithmetic operation overflowed outside of an unchecked block";
+        case 0x12n:
+            return "Division or modulo division by zero";
+        case 0x21n:
+            return "Tried to convert a value into an enum, but the value was too big or negative";
+        case 0x22n:
+            return "Incorrectly encoded storage byte array";
+        case 0x31n:
+            return ".pop() was called on an empty array";
+        case 0x32n:
+            return "Array accessed at an out-of-bounds or negative index";
+        case 0x41n:
+            return "Too much memory was allocated, or an array was created that is too large";
+        case 0x51n:
+            return "Called a zero-initialized variable of internal function type";
+    }
+}
+//# sourceMappingURL=panic-errors.js.map

package/dist/src/internal/panic-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panic-errors.js","sourceRoot":"","sources":["../../../src/internal/panic-errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,4HAA4H;IAC5H,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,iBAAiB,CAAC;QAC3B,KAAK,KAAK;YACR,OAAO,+DAA+D,CAAC;QACzE,KAAK,KAAK;YACR,OAAO,qCAAqC,CAAC;QAC/C,KAAK,KAAK;YACR,OAAO,8EAA8E,CAAC;QACxF,KAAK,KAAK;YACR,OAAO,wCAAwC,CAAC;QAClD,KAAK,KAAK;YACR,OAAO,qCAAqC,CAAC;QAC/C,KAAK,KAAK;YACR,OAAO,sDAAsD,CAAC;QAChE,KAAK,KAAK;YACR,OAAO,0EAA0E,CAAC;QACpF,KAAK,KAAK;YACR,OAAO,8DAA8D,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/src/lang.d.ts

@@ -18,20 +18,28 @@ export declare function deepEqual<T>(x: T, y: T): Promise<boolean>;
  *
  * @remarks
  * - Arrays or `undefined` values are not valid inputs.
- * - Functions: If a function exists in both the target and source, the source function overwrites the target.
- * - Symbol properties: Symbol-keyed properties are merged just like string keys.
- * - Class instances: Class instances are not merged recursively. If a class instance exists in the source, it will replace the one in the target.
+ * - Functions: If a function exists in both the target and source, the source
+ * function overwrites the target.
+ * - Symbol properties: Symbol-keyed properties are merged just like string
+ * keys.
+ * - Class instances: Class instances are not merged recursively. If a class
+ * instance exists in the source, it will replace the one in the target.
  *
  * @param target The target object to merge into.
  * @param source The source object to merge from.
+ * @param shouldOverwriteUndefined If true, properties with `undefined` values
+ * in the source will overwrite those in the target. Default is true.
  * @returns A new object containing the deeply merged properties.
  *
  * @example
  * deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // => { a: { b: 1, c: 2 } }
  *
- * deepMerge({ a: { fn: () => "from target" } }, { a: { fn: () => "from source" } }) // => { a: { fn: () => "from source" } }
+ * deepMerge(
+ *   { a: { fn: () => "from target" } },
+ *   { a: { fn: () => "from source" } }
+ * ) // => { a: { fn: () => "from source" } }
  */
-export declare function deepMerge<T extends object, U extends object>(target: T, source: U): T & U;
+export declare function deepMerge<T extends object, U extends object>(target: T, source: U, shouldOverwriteUndefined?: boolean): T & U;
 /**
  * Checks if a value is an object. This function returns false for arrays.
  *

package/dist/src/lang.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lang.d.ts","sourceRoot":"","sources":["../../src/lang.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAIvD;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAI/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC1D,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,GACR,CAAC,GAAG,CAAC,CAEP;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAE3C;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA4BzE"}
+{"version":3,"file":"lang.d.ts","sourceRoot":"","sources":["../../src/lang.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAIvD;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAI/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC1D,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,wBAAwB,GAAE,OAAc,GACvC,CAAC,GAAG,CAAC,CAEP;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAE3C;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA4BzE"}

package/dist/src/lang.js

@@ -25,21 +25,29 @@ export async function deepEqual(x, y) {
  *
  * @remarks
  * - Arrays or `undefined` values are not valid inputs.
- * - Functions: If a function exists in both the target and source, the source function overwrites the target.
- * - Symbol properties: Symbol-keyed properties are merged just like string keys.
- * - Class instances: Class instances are not merged recursively. If a class instance exists in the source, it will replace the one in the target.
+ * - Functions: If a function exists in both the target and source, the source
+ * function overwrites the target.
+ * - Symbol properties: Symbol-keyed properties are merged just like string
+ * keys.
+ * - Class instances: Class instances are not merged recursively. If a class
+ * instance exists in the source, it will replace the one in the target.
  *
  * @param target The target object to merge into.
  * @param source The source object to merge from.
+ * @param shouldOverwriteUndefined If true, properties with `undefined` values
+ * in the source will overwrite those in the target. Default is true.
  * @returns A new object containing the deeply merged properties.
  *
  * @example
  * deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // => { a: { b: 1, c: 2 } }
  *
- * deepMerge({ a: { fn: () => "from target" } }, { a: { fn: () => "from source" } }) // => { a: { fn: () => "from source" } }
+ * deepMerge(
+ *   { a: { fn: () => "from target" } },
+ *   { a: { fn: () => "from source" } }
+ * ) // => { a: { fn: () => "from source" } }
  */
-export function deepMerge(target, source) {
-    return deepMergeImpl(target, source);
+export function deepMerge(target, source, shouldOverwriteUndefined = true) {
+    return deepMergeImpl(target, source, shouldOverwriteUndefined);
 }
 /**
  * Checks if a value is an object. This function returns false for arrays.

package/dist/src/lang.js.map

@@ -1 +1 @@
-{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../src/lang.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,KAAQ;IACzC,MAAM,UAAU,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAEhD,OAAO,UAAU,CAAI,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,CAAI,EAAE,CAAI;IAC3C,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAE9D,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,MAAS;IAET,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe;IACzC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAyB,GAAY;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,aAAa,GACjB,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,MAAM,IAAI,GAAG,CAAC,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpE;wEACoE;IACpE,MAAM,QAAQ,GAAG,GAAU,CAAC;IAE5B,2FAA2F;IAC3F,MAAM,gBAAgB,GAAG;QACvB,aAAa;QACb,gBAAgB;QAChB,eAAe;QACf,sBAAsB;QACtB,gBAAgB;QAChB,UAAU;QACV,SAAS;KACV,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjE,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../src/lang.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,KAAQ;IACzC,MAAM,UAAU,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAEhD,OAAO,UAAU,CAAI,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,CAAI,EAAE,CAAI;IAC3C,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAE9D,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,MAAS,EACT,2BAAoC,IAAI;IAExC,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,wBAAwB,CAAC,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe;IACzC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAyB,GAAY;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,aAAa,GACjB,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,MAAM,IAAI,GAAG,CAAC,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpE;wEACoE;IACpE,MAAM,QAAQ,GAAG,GAAU,CAAC;IAE5B,2FAA2F;IAC3F,MAAM,gBAAgB,GAAG;QACvB,aAAa;QACb,gBAAgB;QAChB,eAAe;QACf,sBAAsB;QACtB,gBAAgB;QAChB,UAAU;QACV,SAAS;KACV,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjE,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/panic-errors.d.ts

@@ -1,2 +1,15 @@
+/**
+ * Converts a Solidity panic error code into a human-readable revert message.
+ *
+ * Solidity defines a set of standardized panic codes (0x01, 0x11, etc.)
+ * that represent specific runtime errors (e.g. arithmetic overflow).
+ * This function looks up the corresponding reason string and formats it
+ * into a message similar to what clients like Hardhat or ethers.js display.
+ *
+ * @param errorCode The panic error code returned by the EVM as a bigint.
+ * @returns A formatted message string:
+ * - `"reverted with panic code <hex> (<reason>)"` if the code is recognized.
+ * - `"reverted with unknown panic code <hex>"` if the code is not recognized.
+ */
 export declare function panicErrorCodeToMessage(errorCode: bigint): string;
 //# sourceMappingURL=panic-errors.d.ts.map

package/dist/src/panic-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panic-errors.d.ts","sourceRoot":"","sources":["../../src/panic-errors.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQjE"}
+{"version":3,"file":"panic-errors.d.ts","sourceRoot":"","sources":["../../src/panic-errors.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQjE"}

package/dist/src/panic-errors.js

@@ -1,4 +1,18 @@
 import { numberToHexString } from "./hex.js";
+import { panicErrorCodeToReason } from "./internal/panic-errors.js";
+/**
+ * Converts a Solidity panic error code into a human-readable revert message.
+ *
+ * Solidity defines a set of standardized panic codes (0x01, 0x11, etc.)
+ * that represent specific runtime errors (e.g. arithmetic overflow).
+ * This function looks up the corresponding reason string and formats it
+ * into a message similar to what clients like Hardhat or ethers.js display.
+ *
+ * @param errorCode The panic error code returned by the EVM as a bigint.
+ * @returns A formatted message string:
+ * - `"reverted with panic code <hex> (<reason>)"` if the code is recognized.
+ * - `"reverted with unknown panic code <hex>"` if the code is not recognized.
+ */
 export function panicErrorCodeToMessage(errorCode) {
     const reason = panicErrorCodeToReason(errorCode);
     if (reason !== undefined) {
@@ -6,27 +20,4 @@ export function panicErrorCodeToMessage(errorCode) {
     }
     return `reverted with unknown panic code ${numberToHexString(errorCode)}`;
 }
-function panicErrorCodeToReason(errorCode) {
-    // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- we are only covering some of the integer range
-    switch (errorCode) {
-        case 0x1n:
-            return "Assertion error";
-        case 0x11n:
-            return "Arithmetic operation overflowed outside of an unchecked block";
-        case 0x12n:
-            return "Division or modulo division by zero";
-        case 0x21n:
-            return "Tried to convert a value into an enum, but the value was too big or negative";
-        case 0x22n:
-            return "Incorrectly encoded storage byte array";
-        case 0x31n:
-            return ".pop() was called on an empty array";
-        case 0x32n:
-            return "Array accessed at an out-of-bounds or negative index";
-        case 0x41n:
-            return "Too much memory was allocated, or an array was created that is too large";
-        case 0x51n:
-            return "Called a zero-initialized variable of internal function type";
-    }
-}
 //# sourceMappingURL=panic-errors.js.map

package/dist/src/panic-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"panic-errors.js","sourceRoot":"","sources":["../../src/panic-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,4BAA4B,iBAAiB,CAAC,SAAS,CAAC,KAAK,MAAM,GAAG,CAAC;IAChF,CAAC;IAED,OAAO,oCAAoC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,sBAAsB,CAAC,SAAiB;IAC/C,4HAA4H;IAC5H,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,iBAAiB,CAAC;QAC3B,KAAK,KAAK;YACR,OAAO,+DAA+D,CAAC;QACzE,KAAK,KAAK;YACR,OAAO,qCAAqC,CAAC;QAC/C,KAAK,KAAK;YACR,OAAO,8EAA8E,CAAC;QACxF,KAAK,KAAK;YACR,OAAO,wCAAwC,CAAC;QAClD,KAAK,KAAK;YACR,OAAO,qCAAqC,CAAC;QAC/C,KAAK,KAAK;YACR,OAAO,sDAAsD,CAAC;QAChE,KAAK,KAAK;YACR,OAAO,0EAA0E,CAAC;QACpF,KAAK,KAAK;YACR,OAAO,8DAA8D,CAAC;IAC1E,CAAC;AACH,CAAC"}
+{"version":3,"file":"panic-errors.js","sourceRoot":"","sources":["../../src/panic-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,4BAA4B,iBAAiB,CAAC,SAAS,CAAC,KAAK,MAAM,GAAG,CAAC;IAChF,CAAC;IAED,OAAO,oCAAoC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;AAC5E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nomicfoundation/hardhat-utils",
-  "version": "3.0.3",
+  "version": "3.0.5",
   "description": "Utilities for Hardhat and its plugins",
   "homepage": "https://github.com/nomicfoundation/hardhat/tree/v-next/v-next/hardhat-utils",
   "repository": {
@@ -23,6 +23,7 @@
     "./env": "./dist/src/env.js",
     "./error": "./dist/src/error.js",
     "./eth": "./dist/src/eth.js",
+    "./format": "./dist/src/format.js",
     "./fs": "./dist/src/fs.js",
     "./global-dir": "./dist/src/global-dir.js",
     "./hex": "./dist/src/hex.js",

package/src/format.ts

@@ -0,0 +1,267 @@
+import {
+  getColumnWidths,
+  getContentWidth,
+  getHeadingWidth,
+  getStringWidth,
+  renderContentLine,
+  renderHeaderOpen,
+  renderRowSeparator,
+  renderSectionClose,
+} from "./internal/format.js";
+
+export type TableRow = string[];
+export interface TableDivider {
+  type: "divider";
+}
+export type TableItem = TableRow | TableDivider;
+
+export const divider: TableDivider = { type: "divider" };
+
+/**
+ * Formats an array of rows and dividers into a table string.
+ *
+ * @param items An array of table rows (string arrays) and dividers.
+ * Dividers are objects with type: "divider" and will be rendered as table dividers.
+ * @returns The formatted table as a string, ready to be rendered.
+ *
+ * @example
+ * ```ts
+ * formatTable([
+ *   ["Name", "Age"],
+ *   divider,
+ *   ["Alice", "30"],
+ *   ["Bob", "25"],
+ *   divider,
+ *   ["Average", "27.5"]
+ * ]);
+ *
+ * // =>
+ * // | Name    | Age  |
+ * // | ------- | ---- |
+ * // | Alice   | 30   |
+ * // | Bob     | 25   |
+ * // | ------- | ---- |
+ * // | Average | 27.5 |
+ * ```
+ */
+export function formatTable(items: TableItem[]): string {
+  const widths: number[] = [];
+  const dataRows: string[][] = [];
+
+  for (const item of items) {
+    if (Array.isArray(item)) {
+      dataRows.push([...item]);
+    }
+  }
+
+  // Calculate maximum width for each column
+  for (const row of dataRows) {
+    for (let i = 0; i < row.length; i++) {
+      while (i >= widths.length) {
+        widths.push(0);
+      }
+      widths[i] = Math.max(widths[i], getStringWidth(row[i]));
+    }
+  }
+
+  const dividerRow = widths.map((width) => "-".repeat(width));
+  const outputRows: string[][] = [];
+
+  for (const item of items) {
+    if (Array.isArray(item)) {
+      const row = [...item];
+      // Pad the row to match the number of columns
+      while (row.length < widths.length) {
+        row.push("");
+      }
+      outputRows.push(row);
+    } else {
+      outputRows.push([...dividerRow]);
+    }
+  }
+
+  outputRows.forEach((row) => {
+    for (let i = 0; i < row.length; i++) {
+      const displayWidth = getStringWidth(row[i]);
+      const actualLength = row[i].length;
+      // Adjust padding to account for difference between display width and actual length
+      row[i] = row[i].padEnd(widths[i] + actualLength - displayWidth);
+    }
+  });
+
+  return outputRows.map((row) => `| ${row.join(" | ")} |`).join("\n");
+}
+
+export interface TableTitleV2 {
+  type: "title";
+  text: string;
+}
+
+export interface TableSectionHeaderV2 {
+  type: "section-header";
+  text: string;
+}
+
+export interface TableHeaderV2 {
+  type: "header";
+  cells: string[];
+}
+
+export interface TableRowV2 {
+  type: "row";
+  cells: string[];
+}
+
+export type TableItemV2 =
+  | TableTitleV2
+  | TableSectionHeaderV2
+  | TableHeaderV2
+  | TableRowV2;
+
+/**
+ * Formats an array of titles, section headers, headers, and rows into a table
+ * string with box-drawing characters.
+ *
+ * Features:
+ * - Titles are centered in a standalone box with double borders (╔═╗)
+ * - Section headers group related content with automatic closing
+ * - Headers and rows can have different numbers of cells
+ * - Rows with fewer cells than max columns are handled with special rendering
+ *
+ * @param items An array of table items (titles, section headers, headers, and rows).
+ * Sections are automatically closed when a new section-header or title appears, or
+ * at the end of the table.
+ * @returns The formatted table as a string, ready to be rendered.
+ *
+ * @example
+ * ```ts
+ * formatTableV2([
+ *   { type: "title", text: "My Table" },
+ *   { type: "section-header", text: "User Data" },
+ *   { type: "header", cells: ["Name", "Age", "City"] },
+ *   { type: "row", cells: ["Alice", "30", "NYC"] },
+ *   { type: "row", cells: ["Bob", "25", "LA"] },
+ *   { type: "section-header", text: "Summary" },
+ *   { type: "header", cells: ["Total", "Count"] },
+ *   { type: "row", cells: ["55", "2"] }
+ * ]);
+ *
+ * // =>
+ * // ╔═══════════════════╗
+ * // ║     My Table      ║
+ * // ╚═══════════════════╝
+ * // ╔═══════════════════╗
+ * // ║ User Data         ║
+ * // ╟───────┬─────┬─────╢
+ * // ║ Name  │ Age │ City║
+ * // ╟───────┼─────┼─────╢
+ * // ║ Alice │ 30  │ NYC ║
+ * // ╟───────┼─────┼─────╢
+ * // ║ Bob   │ 25  │ LA  ║
+ * // ╚═══════╧═════╧═════╝
+ * // ╔═══════════════════╗
+ * // ║ Summary           ║
+ * // ╟───────┬───────────╢
+ * // ║ Total │ Count     ║
+ * // ╟───────┼───────────╢
+ * // ║ 55    │ 2         ║
+ * // ╚═══════╧═══════════╝
+ * ```
+ */
+export function formatTableV2(items: TableItemV2[]): string {
+  if (items.length === 0) {
+    return "";
+  }
+
+  const columnWidths = getColumnWidths(items);
+  const contentWidth = getContentWidth(columnWidths);
+  const headingWidth = getHeadingWidth(items);
+
+  // If heading is wider than content, expand last column to fit
+  if (headingWidth > contentWidth && columnWidths.length > 0) {
+    const extraSpace = headingWidth - contentWidth;
+    columnWidths[columnWidths.length - 1] += extraSpace;
+  }
+
+  const tableWidth = Math.max(contentWidth, headingWidth);
+
+  const lines: string[] = [];
+  let previousCellCount = 0; // Keep track of previous row/header cell count
+  let inSection = false;
+
+  for (let i = 0; i < items.length; i++) {
+    const [previous, current] = [items[i - 1], items[i]];
+
+    if (current.type === "title") {
+      if (inSection) {
+        lines.push(renderSectionClose(columnWidths, previousCellCount));
+        inSection = false;
+      }
+
+      lines.push("╔" + "═".repeat(tableWidth) + "╗");
+      const titleDisplayWidth = getStringWidth(current.text);
+      const titleActualLength = current.text.length;
+      const centeredTitle = current.text
+        .padStart(
+          (tableWidth + titleDisplayWidth) / 2 +
+            (titleActualLength - titleDisplayWidth),
+        )
+        .padEnd(tableWidth + (titleActualLength - titleDisplayWidth));
+      lines.push("║" + centeredTitle + "║");
+      lines.push("╚" + "═".repeat(tableWidth) + "╝");
+    } else if (current.type === "section-header") {
+      if (inSection) {
+        lines.push(renderSectionClose(columnWidths, previousCellCount));
+      }
+
+      lines.push("╔" + "═".repeat(tableWidth) + "╗");
+      const headerDisplayWidth = getStringWidth(current.text);
+      const headerActualLength = current.text.length;
+      const paddedHeader = current.text.padEnd(
+        tableWidth - 2 + (headerActualLength - headerDisplayWidth),
+      );
+      lines.push("║ " + paddedHeader + " ║");
+      inSection = true;
+    } else if (current.type === "header") {
+      const currentCellCount = current.cells.length;
+      const innerJoiner =
+        previous !== undefined && previous.type === "section-header"
+          ? "┬"
+          : "┼";
+      const needsTransition =
+        previous !== undefined &&
+        previous.type !== "section-header" &&
+        currentCellCount < previousCellCount;
+
+      lines.push(
+        renderHeaderOpen(
+          columnWidths,
+          currentCellCount,
+          innerJoiner,
+          needsTransition,
+        ),
+      );
+      lines.push(
+        renderContentLine(current.cells, columnWidths, currentCellCount),
+      );
+      previousCellCount = currentCellCount;
+    } else if (current.type === "row") {
+      const currentCellCount = current.cells.length;
+
+      // Only add separator if previous wasn't a row
+      if (previous === undefined || previous.type !== "row") {
+        lines.push(renderRowSeparator(columnWidths, currentCellCount));
+      }
+      lines.push(
+        renderContentLine(current.cells, columnWidths, currentCellCount),
+      );
+      previousCellCount = currentCellCount;
+    }
+  }
+
+  if (inSection) {
+    lines.push(renderSectionClose(columnWidths, previousCellCount));
+  }
+
+  return lines.join("\n");
+}