/**
  * Retrieves all locations in the entire OpenAPI definition (and corresponding values) matching given JSON query.
  */
 public * GetDefinitionLocations(jsonQuery: string): Iterable<{ value: any, jsonPath: string }> {
   for (const path of nodes(this.fullyResolvedAndMergedDefinition, jsonQuery)) {
     yield {
       value: path.value,
       jsonPath: stringify(path.path)
     };
   }
 }

  /**
   * Determines the JSON path equivalent to the JSON reference at a given position.
   * OpenAPI definitions make use of these excessively.
   *
   * @param position The position to look at for a JSON reference.
   */
  public GetJsonPathFromJsonReferenceAt(position: Position): string | null {
    const fullyResolvedAndMergedDefinitionLocation = this.fullyResolvedAndMergedDefinitionMap.LookupForward(
      this.documentUri,
      position.line + 1, // VS Code deviates from the source map standard here... 0 vs. 1 based line numbers
      position.character)[0];
    if (fullyResolvedAndMergedDefinitionLocation) {

      const path = fullyResolvedAndMergedDefinitionLocation.path;
      if (path) {

        // is $ref?
        if (path.length > 0 && path[path.length - 1] === "$ref") {
          // lookup object
          const refValueJsonPointer: string = value(this.fullyResolvedAndMergedDefinition, stringify(path));
          const refValueJsonPath: JsonPath = parseJsonPointer(refValueJsonPointer);
          return stringify(refValueJsonPath);
        }
      } // else  { console.warn("no object path for that location"); return null; }
    } // else { console.log("reverse lookup failed (no big deal, may just hover empty space)"); return null; }

    return null;
  }

export function stringify(jsonPath: JsonPath): string {
  return jsonpath.stringify(["$" as JsonPathComponent].concat(jsonPath));
}