@helios-lang/compiler/src/parse/ParseContext.js

Helios is a Domain Specific Language that compiles to Plutus-Core (i.e. Cardano on-chain validator scripts). Helios is a non-Haskell alternative to Plutus. With this library you can compile Helios scripts and build Cardano transactions, all you need to bu

/**
 * @import { ErrorCollector, GenericGroup, Site, StringLiteral, TokenReader } from "@helios-lang/compiler-utils"
 */

/**
 * @typedef {(path: StringLiteral) => (string | undefined)} ImportPathTranslator
 */

/**
 * @typedef {{
 *   currentSite?: Site
 *   importPathTranslator?: ImportPathTranslator | undefined
 * }} ParseContextOptions
 */

export class ParseContext {
    /**
     * @readonly
     * @type {TokenReader}
     */
    reader

    /**
     * @readonly
     * @type {Site}
     */
    currentSite

    /**
     * @readonly
     * @type {ImportPathTranslator | undefined}
     */
    importPathTranslator

    /**
     * @param {TokenReader} reader
     * @param {ParseContextOptions} options
     */
    constructor(reader, options = {}) {
        this.reader = reader
        this.currentSite = options.currentSite ?? reader.tokens[0].site
        this.importPathTranslator = options.importPathTranslator
    }

    /**
     * @type {ErrorCollector}
     */
    get errors() {
        return this.reader.errors
    }

    /**
     * @param {Site} site
     * @returns {ParseContext}
     */
    atSite(site) {
        return new ParseContext(this.reader, {
            currentSite: site,
            importPathTranslator: this.importPathTranslator
        })
    }

    /**
     * @param {GenericGroup<TokenReader>} group
     * @param {number} fieldIndex
     * @returns {ParseContext}
     */
    inGroup(group, fieldIndex = 0) {
        return this.atSite(group.site).withReader(group.fields[fieldIndex])
    }

    /**
     * @param {TokenReader} r
     * @returns {ParseContext}
     */
    withReader(r) {
        return new ParseContext(r, {
            currentSite: this.currentSite,
            importPathTranslator: this.importPathTranslator
        })
    }
}