CompilerVerbosity = enum
  compVerbosityMin = (0, "0"), compVerbosityDefault = (1, "1"),
  compVerbosityHigh = (2, "2"), compVerbosityMax = (3, "3")

ERecoverableError = object of ValueError

ESuggestDone = object of ValueError

FileIndex = distinct int32

InstantiationInfo = typeof(instantiationInfo())

LineColPair = tuple[line: typeof(TLineInfo.line), col: typeof(TLineInfo.col)]

Severity {.pure.} = enum
  Hint, Warning, Error

TErrorOutput = enum
  eStdOut, eStdErr

TErrorOutputs = set[TErrorOutput]

TFileInfo = object
  fullPath*: AbsoluteFile    ## This is a canonical full filesystem path
  projPath*: RelativeFile    ## This is relative to the project's root
  shortName*: string         ## short name of the module
  quotedName*: Rope          ## cached quoted short name for codegen
                             ## purposes
  quotedFullName*: Rope      ## cached quoted full name for codegen
                             ## purposes
  lines*: seq[string]        ## the source code of the module used for
                             ## better error messages and embedding the
                             ## original source in the generated code
  dirtyFile*: AbsoluteFile   ## the file that is actually read into memory
                             ## and parsed; usually "" but is used
                             ## for 'nimsuggest'
  hash*: string              ## the checksum of the file
  dirty*: bool               ## for 'nimfix' like tooling
  

TLineInfo = object
  line*: uint16
  col*: int16
  fileIndex*: FileIndex

commandLineIdx = -3'i32

explanationsBaseUrl = "https://nim-works.github.io/nimskull"

InvalidFileIdx = -1'i32

trackPosInvalidFileIdx = -2'i32

unknownLineInfo = (line: 0'u16, col: -1'i16, fileIndex: -1'i32)

proc `==`(a, b: FileIndex): bool {.borrow, ...raises: [], tags: [].}

func clampLineCol(line, col: int): LineColPair {.inline, ...raises: [], tags: [].}

proc createDocLink(urlSuffix: string): string {....raises: [], tags: [].}

proc hash(i: TLineInfo): Hash {....raises: [], tags: [].}

func isKnown(info: TLineInfo): bool {....raises: [], tags: [].}

proc newLineInfo(fileIndex: FileIndex; line, col: int): TLineInfo {.inline,
    ...raises: [], tags: [].}

proc raiseRecoverableError(msg: string) {.noinline, ...raises: [ERecoverableError],
    tags: [].}

template instLoc(depth: int = -2): InstantiationInfo