desmost 0.1.0 → 0.1.2

package/dist/src/parser/generic-parser.js

@@ -1,143 +0,0 @@
-import { RecoverableFail, UnrecoverableError } from "../errors";
-const IGNORED_CHARACTERS = new Set([
-    "\r",
-]);
-/**
- * A stateful lazy parser, providing core methods for parsing.
- *
- * Many methods come in `<verb>` and `try_<verb>` pairs. On parsing failure, the former throws an `UnrecoverableError`, but the latter instead backtracks and only throws a `RecoverableFail`.
- */
-export class GenericParser {
-    /** The source code this parser is parsing. */
-    source;
-    /** The current position in the source code the parser is pointing to. */
-    i = 0;
-    /** The number of characters in the source code. */
-    length;
-    /** Create a parser for parsing `source`. */
-    constructor(source) {
-        this.source = source;
-        this.length = source.length;
-    }
-    /**
-     * Is the parser currently pointing at an invalid character?
-     */
-    out_of_bounds() {
-        return this.i >= this.length;
-    }
-    /**
-     * Get the character the parser is currently pointing at, or `undefined` if the parser is out-of-bounds.
-     */
-    get current() {
-        return this.source.at(this.i);
-    }
-    /**
-     * Get the character *after* the current one that the parser points at.
-     */
-    next() {
-        return this.source.at(this.i + 1);
-    }
-    /**
-     * Peek a snippet of the upcoming source text (for error messages).
-     */
-    preview() {
-        return this.source.slice(this.i, this.i + 20) + "...";
-    }
-    /**
-     * Advance to the next character, skipping ignored characters.
-     *
-     * Errors if the parser is the out-of-bounds *before* advancing.
-     */
-    advance(error_msg) {
-        if (this.out_of_bounds()) {
-            throw new UnrecoverableError.UnexpectedEnd(error_msg ?? "Unexpected end of input");
-        }
-        this.i++;
-        // @ts-expect-error: `this.current == undefined` is a true negative
-        if (IGNORED_CHARACTERS.has(this.current)) {
-            this.advance();
-        }
-    }
-    /**
-     * Attempt to advance to the next character, skipping ignored characters.
-     */
-    try_advance() {
-        try {
-            this.advance();
-        }
-        catch {
-            throw new RecoverableFail();
-        }
-    }
-    /**
-     * Consume `raw`, erroring if `raw` was not found.
-     */
-    consume(raw, error_msg) {
-        if (this.out_of_bounds()) {
-            throw new UnrecoverableError.UnexpectedEnd(`Unexpected end of input while trying to consume: \`${raw}\``);
-        }
-        let ii = 0;
-        while (this.current === raw[ii]) {
-            this.advance(`Unexpected end of input while trying to consume: \`${raw}\``);
-            ii++;
-            if (ii === raw.length)
-                return;
-        }
-        throw new UnrecoverableError.UnexpectedInput(error_msg ?? `Expected: \`${raw}\`, but found: \`${this.preview()}\``);
-    }
-    /**
-     * Attempt to consume `raw`, backtracking and throwing if `raw` was not found.
-     */
-    try_consume(raw) {
-        let init = this.i;
-        let ii = 0;
-        while (this.current === raw[ii]) {
-            this.try_advance();
-            ii++;
-            if (ii === raw.length)
-                return;
-            if (this.i === this.length)
-                break;
-        }
-        this.i = init;
-        throw new RecoverableFail();
-    }
-    /**
-     * Consume 0 or more space characters.
-     */
-    consume_spaces() {
-        /* NOTE: Callers should be able to assume this is safe to call even when at end of input, since it should just match 0 characters */
-        if (this.out_of_bounds())
-            return;
-        while (this.current === " ") {
-            this.advance();
-        }
-    }
-    /**
-     * Consume 0 or more whitespace characters.
-     *
-     * Same as `.consume_spaces()`, but allows newlines.
-     */
-    consume_whitespace() {
-        /* NOTE: Callers should be able to assume this is safe to call even when at end of input, since it should just match 0 characters */
-        if (this.i >= this.length)
-            return;
-        while (this.current === " " || this.current === "\n") {
-            this.advance();
-        }
-    }
-    consume_end_of_block(error_msg) {
-        if (this.i >= this.length)
-            return;
-        this.consume_spaces();
-        try {
-            this.try_consume("\n");
-        }
-        catch (e) {
-            if (!(e instanceof RecoverableFail))
-                throw e;
-            throw new UnrecoverableError.ExcessInput(error_msg ?? `Expected end of block, but found: \`${this.preview()}\``);
-        }
-    }
-}
-//# sourceMappingURL=generic-parser.js.map

package/dist/src/parser/generic-parser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generic-parser.js","sourceRoot":"","sources":["../../../src/parser/generic-parser.ts"],"names":[],"mappings":"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"}

package/dist/src/parser/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Implements `DesmostParser`, the Desmost parsing engine.
- *
- * The parsing engine makes heavy use of exceptions for backtracking, which is *very unperformant*, but makes for *much more readable code*. Desmost isn't expecting to parse huge documents of source code, so I decided this is an acceptable trade-off.
- */
-export { DesmostParser } from "./desmost-parser";
-export { Ast } from "./ast";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/parser/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC"}

package/dist/src/parser/index.js

@@ -1,8 +0,0 @@
-/**
- * Implements `DesmostParser`, the Desmost parsing engine.
- *
- * The parsing engine makes heavy use of exceptions for backtracking, which is *very unperformant*, but makes for *much more readable code*. Desmost isn't expecting to parse huge documents of source code, so I decided this is an acceptable trade-off.
- */
-export { DesmostParser } from "./desmost-parser";
-export { Ast } from "./ast";
-//# sourceMappingURL=index.js.map

package/dist/src/parser/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC"}