Restrict ContractInterfaceFunction type alias usage

This commit restricts EnrichedContractInterfaceFunction type alias usage to
relevant methods and adds a JSDoc comment to the definition.

property.ts

@@ -11,7 +11,6 @@ import {
 } from "./shared";
 import { dim, green, red, underline, yellow } from "ansicolor";
 import { ContractInterfaceFunction } from "@hirosystems/clarinet-sdk-wasm";
-import { EnrichedContractInterfaceFunction } from "./shared.types";
 import {
   buildTraitReferenceMap,
   enrichInterfaceWithTraitData,
@@ -386,11 +385,8 @@ const validateDiscardFunction = (
   contractId: string,
   discardFunctionName: string,
   testFunctionName: string,
-  testContractsDiscardFunctions: Map<
-    string,
-    EnrichedContractInterfaceFunction[]
-  >,
-  testContractsTestFunctions: Map<string, EnrichedContractInterfaceFunction[]>,
+  testContractsDiscardFunctions: Map<string, ContractInterfaceFunction[]>,
+  testContractsTestFunctions: Map<string, ContractInterfaceFunction[]>,
   radio: EventEmitter
 ) => {
   const testFunction = testContractsTestFunctions
@@ -437,8 +433,8 @@ const validateDiscardFunction = (
  * @returns A boolean indicating if the parameters match.
  */
 export const isParamsMatch = (
-  testFunction: EnrichedContractInterfaceFunction,
-  discardFunction: EnrichedContractInterfaceFunction
+  testFunction: ContractInterfaceFunction,
+  discardFunction: ContractInterfaceFunction
 ) => {
   const sortedTestFunctionArgs = [...testFunction.args].sort((a, b) =>
     a.name.localeCompare(b.name)
@@ -458,5 +454,5 @@ export const isParamsMatch = (
  * @returns A boolean indicating if the return type is boolean.
  */
 export const isReturnTypeBoolean = (
-  discardFunction: EnrichedContractInterfaceFunction
+  discardFunction: ContractInterfaceFunction
 ) => discardFunction.outputs.type === "bool";

shared.ts

@@ -58,7 +58,7 @@ export const getFunctionsFromContractInterfaces = (
   );
 
 export const getFunctionsListForContract = (
-  functionsMap: Map<string, any[]>,
+  functionsMap: Map<string, EnrichedContractInterfaceFunction[]>,
   contractId: string
 ) => functionsMap.get(contractId) || [];
 

shared.types.ts

@@ -23,6 +23,10 @@ import { ImplementedTraitType, ImportedTraitType } from "./traits.types";
 
 // Types used for Clarity Value conversion.
 
+/**
+ * The type of the function interface, after the contract interface is
+ * "enriched" with additional information about trait references.
+ */
 export type EnrichedContractInterfaceFunction = {
   args: (
     | ContractInterfaceFunctionArg