desmost 0.1.0

package/dist/compiler/compile.d.ts

@@ -0,0 +1,32 @@
+import { type DesmostOptions } from "./options";
+import { Ast } from "../parser";
+/**
+ * Compile Desmost into Desmos.
+ *
+ * This calls the Desmost compiler: parsing and evaluating `source`, then injecting the results into an existing `desmos` instance. Pass in `options` to customise compilation.
+ *
+ * ## Example
+ *
+ * ```ts
+ * let calc = Desmos.GraphingCalculator();
+ *
+ * compile(calc, `/text{ sup world! }`);
+ *
+ * compile(calc, `/slider{ error! } :: t = 0`, {
+ *   errors: "crash",
+ * });
+ * ```
+ */
+export declare function compile(
+/** The Desmos calculator instance to compile into. */
+desmos: Desmos.Calculator, 
+/** The Desmost source code to compile. */
+source: string, 
+/** Compilation options. */
+options?: DesmostOptions): void | DesmostDebug;
+interface DesmostDebug {
+    duration: number;
+    ast: Ast[];
+}
+export {};
+//# sourceMappingURL=compile.d.ts.map

package/dist/compiler/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/compiler/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,WAAW,CAAC;AAGrE,OAAO,EAAiB,GAAG,EAAE,MAAM,WAAW,CAAC;AAI/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO;AACrB,sDAAsD;AACtD,MAAM,EAAE,MAAM,CAAC,UAAU;AAEzB,0CAA0C;AAC1C,MAAM,EAAE,MAAM;AAEd,2BAA2B;AAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI,GAAG,YAAY,CAsFrB;AAGD,UAAU,YAAY;IAEpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,GAAG,EAAE,CAAC;CACZ"}

package/dist/compiler/compile.js

@@ -0,0 +1,101 @@
+import { set_default_options } from "./options";
+import { evaluate_global_incantation, evaluate_expr, evaluate_error } from "./evaluate";
+import { DesmostParser, Ast } from "../parser";
+import { UnrecoverableError } from "../errors";
+/**
+ * Compile Desmost into Desmos.
+ *
+ * This calls the Desmost compiler: parsing and evaluating `source`, then injecting the results into an existing `desmos` instance. Pass in `options` to customise compilation.
+ *
+ * ## Example
+ *
+ * ```ts
+ * let calc = Desmos.GraphingCalculator();
+ *
+ * compile(calc, `/text{ sup world! }`);
+ *
+ * compile(calc, `/slider{ error! } :: t = 0`, {
+ *   errors: "crash",
+ * });
+ * ```
+ */
+export function compile(
+/** The Desmos calculator instance to compile into. */
+desmos, 
+/** The Desmost source code to compile. */
+source, 
+/** Compilation options. */
+options) {
+    if (desmos == undefined) {
+        console.error(`Desmost: No \`Desmos.Calculator\` instance provided, aborting compilation!`);
+        return;
+    }
+    if (source == undefined) {
+        console.error(`Desmost: No source code provided, aborting compilation!`);
+        return;
+    }
+    let t_init = performance.now();
+    let ast = [];
+    let opts = set_default_options(options);
+    let parser = new DesmostParser(source, opts);
+    /* To aggregate errors at the start, we need a target to retroactively inject errors into */
+    if (opts.place_errors === "start") {
+        desmos.setExpression({ id: "deferred-start", latex: "" });
+    }
+    let errors = [];
+    try {
+        while (true) {
+            let r = parser.parse_next();
+            if (r === null)
+                break;
+            if (opts.debug) {
+                ast.push(r);
+            }
+            let defer;
+            switch (r.kind) {
+                case Ast.Kind.INCANTATION_INVOCATION:
+                    defer = evaluate_global_incantation(r, desmos, opts);
+                    break;
+                case Ast.Kind.EXPRESSION:
+                    defer = evaluate_expr(r, desmos, opts);
+                    break;
+                case Ast.Kind.INVALID_INCANTATION:
+                    defer = evaluate_error(r.error, desmos, opts);
+                    break;
+            }
+            if (defer !== undefined) {
+                errors.push(defer);
+            }
+        }
+    }
+    catch (e) {
+        if (e instanceof UnrecoverableError) {
+            errors = [e.message];
+        }
+        else {
+            throw e;
+        }
+    }
+    if (errors.length > 0) {
+        let expr = {
+            type: "text",
+            text: errors.join("\n\n"),
+        };
+        switch (opts.place_errors) {
+            case "start":
+                desmos.setExpression({ ...expr, id: "deferred-start" });
+                break;
+            case "end":
+            case "inline":
+                desmos.setExpression(expr);
+                break;
+        }
+    }
+    if (opts.debug) {
+        return {
+            duration: performance.now() - t_init,
+            ast,
+        };
+    }
+}
+//# sourceMappingURL=compile.js.map

package/dist/compiler/compile.js.map

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

package/dist/compiler/evaluate.d.ts

@@ -0,0 +1,18 @@
+import type { DesmostOptions } from "./options";
+import { Ast } from "../parser";
+import { UnrecoverableError, type Unrecoverable } from "../errors";
+/**
+ * Evaluate arguments (if any) to a global incantation `invocation`, then apply the incantation to `desmos`.
+ */
+export declare function evaluate_global_incantation(invocation: Ast.IncantationInvocation, desmos: Desmos.Calculator, options: Required<DesmostOptions>): Unrecoverable<void | string>;
+/**
+ * Evaluate arguments (if any) to local incantation invocations on `expr`, then add `expr` to `desmos`.
+ */
+export declare function evaluate_expr(expr: Ast.Expression, desmos: Desmos.Calculator, options: Required<DesmostOptions>): Unrecoverable<void | string>;
+/**
+ * Handle an `InvalidInvocation`, respecting the user's preferences in `options`.
+ *
+ * If the user set `place_errors: start` or `place_errors: end`, this returns the formatted error message for deferred aggregation.
+ */
+export declare function evaluate_error(error: UnrecoverableError, desmos: Desmos.Calculator, options: Required<DesmostOptions>): Unrecoverable<void | string>;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/compiler/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/compiler/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAGnE;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,GAAG,CAAC,qBAAqB,EACrC,MAAM,EAAE,MAAM,CAAC,UAAU,EACzB,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAChC,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAiB9B;AAGD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,GAAG,CAAC,UAAU,EACpB,MAAM,EAAE,MAAM,CAAC,UAAU,EACzB,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAChC,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAgC9B;AAGD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,MAAM,CAAC,UAAU,EACzB,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAChC,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAuB9B"}

package/dist/compiler/evaluate.js

@@ -0,0 +1,83 @@
+import { Ast } from "../parser";
+import { UnrecoverableError } from "../errors";
+/**
+ * Evaluate arguments (if any) to a global incantation `invocation`, then apply the incantation to `desmos`.
+ */
+export function evaluate_global_incantation(invocation, desmos, options) {
+    let data = undefined;
+    if ("arg_raw" in invocation && invocation.arg_raw != undefined) {
+        try {
+            data = invocation.incantation.evaluate_arg(invocation.arg_raw);
+        }
+        catch (e) {
+            let msg = evaluate_error(e, desmos, options);
+            if (msg != undefined) {
+                return msg;
+            }
+        }
+    }
+    invocation.incantation.apply(desmos, data);
+}
+/**
+ * Evaluate arguments (if any) to local incantation invocations on `expr`, then add `expr` to `desmos`.
+ */
+export function evaluate_expr(expr, desmos, options) {
+    let errors = [];
+    for (let invocation of expr.incantations) {
+        if (invocation.kind === Ast.Kind.INVALID_INCANTATION) {
+            let msg = evaluate_error(invocation.error, desmos, { ...options, place_errors: "start" });
+            if (msg != undefined) {
+                errors.push(msg);
+            }
+            continue;
+        }
+        let data = undefined;
+        if ("arg_raw" in invocation && invocation.arg_raw != undefined) {
+            try {
+                data = invocation.incantation.evaluate_arg(invocation.arg_raw);
+            }
+            catch (e) {
+                errors.push(format_error(e, options));
+                if (invocation.incantation.requires_arg)
+                    continue;
+            }
+        }
+        invocation.incantation.apply(expr.data, data);
+    }
+    if (errors.length > 0) {
+        desmos.setExpression({ type: "text", text: errors.join("\n\n") });
+    }
+    desmos.setExpression(expr.data);
+}
+/**
+ * Handle an `InvalidInvocation`, respecting the user's preferences in `options`.
+ *
+ * If the user set `place_errors: start` or `place_errors: end`, this returns the formatted error message for deferred aggregation.
+ */
+export function evaluate_error(error, desmos, options) {
+    switch (options.errors) {
+        case "crash":
+            throw error;
+        case "suppress":
+            console.error(error);
+            break;
+        default: switch (options.place_errors) {
+            case "end":
+            case "start":
+                return format_error(error, options);
+            default:
+                desmos.setExpression({
+                    type: "text",
+                    text: format_error(error, options),
+                });
+                break;
+        }
+    }
+}
+function format_error(e, options) {
+    let prefix = options.error_prefix;
+    let sep = (prefix === "" || prefix.endsWith("\n")) ? "" : " ";
+    return `${prefix}${sep}${e.name}: ${e.message}`;
+    // TODO maybe include stack? (configurable?)
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/compiler/evaluate.js.map

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

package/dist/compiler/index.d.ts

@@ -0,0 +1,3 @@
+export { compile } from "./compile";
+export type { DesmostOptions } from "./options";
+//# sourceMappingURL=index.d.ts.map

package/dist/compiler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/compiler/index.js

@@ -0,0 +1,2 @@
+export { compile } from "./compile";
+//# sourceMappingURL=index.js.map

package/dist/compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/compiler/options.d.ts

@@ -0,0 +1,54 @@
+/** Options to customise Desmost compilation. */
+export interface DesmostOptions {
+    /**
+     * How should errors be *surfaced*?
+     *
+     * Errors will always be logged to console for the developer; this setting affects how they visually reach the end user.
+     *
+     * - `surface` (default): Blocks that result in errors will become Desmos text expressions containing the error message, leaving other expressions unaffected.
+     * - `crash`: The entire compilation to Desmos will terminate with a single error message. This means you don't get any output at all, but errors are also immediately obvious.
+     * - `suppress`: Silently fail on the frontend (if you wish to give the illusion that everything is fine).
+     */
+    errors?: "surface" | "crash" | "suppress";
+    /**
+     * Where should errors be placed?
+     *
+     * - `inline` (default): Alongside or in place of the expression that produced it.
+     * - `end`: All aggregated at the end of the Desmos expressions list.
+     * - `start`: All aggregated at the start of the Desmos expressions list.
+     */
+    place_errors?: "inline" | "end" | "start";
+    /**
+     * The prefix to prepend to error blocks. Defaults to `[DESMOST ERROR]\n`. Provide a blank string if you wish for no prefix to be added.
+     */
+    error_prefix?: string;
+    /**
+     * Should comments be ignored, instead of turned into text expressions?
+     *
+     * Defaults to `false`, meaning comments are kept.
+     */
+    ignore_comments?: boolean;
+    /**
+     * Should all line breaks be ignored, instead of kept as blank expressions.
+     *
+     * Defaults to `false`, meaning all blank lines are kept.
+     */
+    ignore_line_breaks?: boolean;
+    /**
+     * Should trailing blank lines at the end of the source be ignored, instead of kept as blank expressions?
+     *
+     * Defaults to `false`, meaning trailing blank lines are kept.
+     */
+    ignore_trailing_blanks?: boolean;
+    /**
+     * Return debug diagnostics? This includes the unevaluated AST, and performance diagnostics.
+     *
+     * Defaults to `false`.
+     */
+    debug?: boolean;
+}
+/**
+ * Fill in `options` with Desmost's defaults to produce a complete `DesmostOptions` config.
+ */
+export declare function set_default_options(options: Partial<DesmostOptions> | undefined): Required<DesmostOptions>;
+//# sourceMappingURL=options.d.ts.map

package/dist/compiler/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/compiler/options.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAE7B;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;IAEzC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAA;IAEzC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAE5B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAEhC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAGD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,CAe1G"}

package/dist/compiler/options.js

@@ -0,0 +1,15 @@
+/**
+ * Fill in `options` with Desmost's defaults to produce a complete `DesmostOptions` config.
+ */
+export function set_default_options(options) {
+    options ??= {};
+    options.errors ??= "surface";
+    options.place_errors ??= "inline";
+    options.error_prefix ??= "[DESMOST ERROR]\n";
+    options.ignore_comments ??= false;
+    options.ignore_line_breaks ??= false;
+    options.ignore_trailing_blanks ??= false;
+    options.debug ??= false;
+    return options;
+}
+//# sourceMappingURL=options.js.map

package/dist/compiler/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/compiler/options.ts"],"names":[],"mappings":"AA0DA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA4C;IAE9E,OAAO,KAAK,EAAE,CAAC;IAEf,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;IAC7B,OAAO,CAAC,YAAY,KAAK,QAAQ,CAAC;IAClC,OAAO,CAAC,YAAY,KAAK,mBAAmB,CAAC;IAE7C,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC;IAClC,OAAO,CAAC,kBAAkB,KAAK,KAAK,CAAC;IACrC,OAAO,CAAC,sBAAsB,KAAK,KAAK,CAAC;IAEzC,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;IAExB,OAAO,OAAmC,CAAC;AAC7C,CAAC"}

package/dist/desmos.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The Desmos API (currently) is browser-only, so we polyfill the API objects we need here for the server-side.
+ */
+export declare enum DesmosColour {
+    RED = "#c74440",
+    BLUE = "#2d70b3",
+    GREEN = "#388c46",
+    PURPLE = "#6042a6",
+    ORANGE = "#fa7e19",
+    BLACK = "#000000"
+}
+//# sourceMappingURL=desmos.d.ts.map

package/dist/desmos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desmos.d.ts","sourceRoot":"","sources":["../src/desmos.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,YAAY;IAEtB,GAAG,YAAe;IAClB,IAAI,YAAc;IAClB,KAAK,YAAa;IAClB,MAAM,YAAY;IAClB,MAAM,YAAY;IAClB,KAAK,YAAa;CACnB"}

package/dist/desmos.js

@@ -0,0 +1,13 @@
+/**
+ * The Desmos API (currently) is browser-only, so we polyfill the API objects we need here for the server-side.
+ */
+export var DesmosColour;
+(function (DesmosColour) {
+    DesmosColour["RED"] = "#c74440";
+    DesmosColour["BLUE"] = "#2d70b3";
+    DesmosColour["GREEN"] = "#388c46";
+    DesmosColour["PURPLE"] = "#6042a6";
+    DesmosColour["ORANGE"] = "#fa7e19";
+    DesmosColour["BLACK"] = "#000000";
+})(DesmosColour || (DesmosColour = {}));
+//# sourceMappingURL=desmos.js.map

package/dist/desmos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desmos.js","sourceRoot":"","sources":["../src/desmos.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IAEtB,+BAAkB,CAAA;IAClB,gCAAkB,CAAA;IAClB,iCAAkB,CAAA;IAClB,kCAAkB,CAAA;IAClB,kCAAkB,CAAA;IAClB,iCAAkB,CAAA;AACpB,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB"}

package/dist/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The compiler encountered a fatal unrecoverable error, which will reach the end user.
+ *
+ * It's not *literally* unrecoverable in the sense that it will crash the compiler completely, but it means there are no further fallbacks to try.
+ */
+export declare class UnrecoverableError extends Error {
+}
+export declare namespace UnrecoverableError {
+    /** The parser unexpectedly reached the end of its entire input source code. */
+    class UnexpectedEnd extends UnrecoverableError {
+    }
+    /** The parser did not receive input that it expected. */
+    class MissingInput extends UnrecoverableError {
+    }
+    /** The parser received input that did not match what it expected. */
+    class UnexpectedInput extends UnrecoverableError {
+    }
+    /** The parser received excess input that it did not expect. */
+    class ExcessInput extends UnrecoverableError {
+    }
+    /** An incantation can't be applied here. */
+    class IllegalIncantation extends UnrecoverableError {
+    }
+    /** An incantation's argument couldn't be parsed. */
+    class InvalidArgument extends UnrecoverableError {
+    }
+}
+/** The compiler encountered a non-fatal recoverable failure (usually during speculative parsing), which only results in internal backtracking. */
+export declare class RecoverableFail {
+}
+/** Indicates that a function may throw a `RecoverableFail`. */
+export type Recoverable<Result> = Result | (Result & {
+    readonly __brand?: unique symbol;
+});
+/** Indicates that a function may throw an `UnrecoverableError`. */
+export type Unrecoverable<Result> = Result | (Result & {
+    readonly __brand?: unique symbol;
+});
+/**
+ * Indicates that a function may throw either a `RecoverableFail` *or* an `UnrecoverableError`.
+ *
+ * This is used in potentially ambiguous cases. For instance, the user might have invoked an unknown incantation, in which case we might want to `RecoverableFail` and fallback to parsing it as LaTeX; on the other hand, if they invoked a valid incantation, but did not supply the required argument, that's a definite `UnrecoverableError`.
+ */
+export type MaybeRecoverable<Result> = Recoverable<Result> | Unrecoverable<Result>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,yBAAiB,kBAAkB,CACnC;IACE,+EAA+E;IAC/E,MAAa,aAAc,SAAQ,kBAAkB;KAAG;IAExD,yDAAyD;IACzD,MAAa,YAAa,SAAQ,kBAAkB;KAAG;IAEvD,qEAAqE;IACrE,MAAa,eAAgB,SAAQ,kBAAkB;KAAG;IAE1D,+DAA+D;IAC/D,MAAa,WAAY,SAAQ,kBAAkB;KAAG;IAGtD,4CAA4C;IAC5C,MAAa,kBAAmB,SAAQ,kBAAkB;KAAG;IAE7D,oDAAoD;IACpD,MAAa,eAAgB,SAAQ,kBAAkB;KAAG;CAC3D;AAGD,kJAAkJ;AAClJ,qBAAa,eAAe;CAAG;AAG/B,+DAA+D;AAC/D,MAAM,MAAM,WAAW,CAAC,MAAM,IAAI,MAAM,IAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAA;CAAE,CAAA,CAAC;AAEzF,mEAAmE;AACnE,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI,MAAM,IAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAA;CAAE,CAAA,CAAC;AAE3F;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}

package/dist/errors.js

@@ -0,0 +1,38 @@
+/**
+ * The compiler encountered a fatal unrecoverable error, which will reach the end user.
+ *
+ * It's not *literally* unrecoverable in the sense that it will crash the compiler completely, but it means there are no further fallbacks to try.
+ */
+export class UnrecoverableError extends Error {
+}
+(function (UnrecoverableError) {
+    /** The parser unexpectedly reached the end of its entire input source code. */
+    class UnexpectedEnd extends UnrecoverableError {
+    }
+    UnrecoverableError.UnexpectedEnd = UnexpectedEnd;
+    /** The parser did not receive input that it expected. */
+    class MissingInput extends UnrecoverableError {
+    }
+    UnrecoverableError.MissingInput = MissingInput;
+    /** The parser received input that did not match what it expected. */
+    class UnexpectedInput extends UnrecoverableError {
+    }
+    UnrecoverableError.UnexpectedInput = UnexpectedInput;
+    /** The parser received excess input that it did not expect. */
+    class ExcessInput extends UnrecoverableError {
+    }
+    UnrecoverableError.ExcessInput = ExcessInput;
+    /** An incantation can't be applied here. */
+    class IllegalIncantation extends UnrecoverableError {
+    }
+    UnrecoverableError.IllegalIncantation = IllegalIncantation;
+    /** An incantation's argument couldn't be parsed. */
+    class InvalidArgument extends UnrecoverableError {
+    }
+    UnrecoverableError.InvalidArgument = InvalidArgument;
+})(UnrecoverableError || (UnrecoverableError = {}));
+/** The compiler encountered a non-fatal recoverable failure (usually during speculative parsing), which only results in internal backtracking. */
+export class RecoverableFail {
+}
+;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,WAAiB,kBAAkB;IAEjC,+EAA+E;IAC/E,MAAa,aAAc,SAAQ,kBAAkB;KAAG;IAA3C,mBAAA,aAAa,gBAA8B,CAAA;IAExD,yDAAyD;IACzD,MAAa,YAAa,SAAQ,kBAAkB;KAAG;IAA1C,mBAAA,YAAY,eAA8B,CAAA;IAEvD,qEAAqE;IACrE,MAAa,eAAgB,SAAQ,kBAAkB;KAAG;IAA7C,mBAAA,eAAe,kBAA8B,CAAA;IAE1D,+DAA+D;IAC/D,MAAa,WAAY,SAAQ,kBAAkB;KAAG;IAAzC,mBAAA,WAAW,cAA8B,CAAA;IAGtD,4CAA4C;IAC5C,MAAa,kBAAmB,SAAQ,kBAAkB;KAAG;IAAhD,mBAAA,kBAAkB,qBAA8B,CAAA;IAE7D,oDAAoD;IACpD,MAAa,eAAgB,SAAQ,kBAAkB;KAAG;IAA7C,mBAAA,eAAe,kBAA8B,CAAA;AAC5D,CAAC,EApBgB,kBAAkB,KAAlB,kBAAkB,QAoBlC;AAGD,kJAAkJ;AAClJ,MAAM,OAAO,eAAe;CAAG;AAO4D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { compile, type DesmostOptions } from "./compiler";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { compile } from "./compiler";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAuB,MAAM,YAAY,CAAC"}

package/dist/magic/expr/index.d.ts

@@ -0,0 +1,3 @@
+import { ArgIncantation, type EXPR } from "../incantation";
+export declare const EXPR_INCANTATIONS: ArgIncantation<EXPR>[];
+//# sourceMappingURL=index.d.ts.map

package/dist/magic/expr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/magic/expr/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAM3D,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,EAInD,CAAC"}

package/dist/magic/expr/index.js

@@ -0,0 +1,8 @@
+import { ArgIncantation } from "../incantation";
+import { LatexIncantation } from "./latex";
+import { TextIncantation } from "./text";
+export const EXPR_INCANTATIONS = [
+    new LatexIncantation(),
+    new TextIncantation(),
+];
+//# sourceMappingURL=index.js.map

package/dist/magic/expr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/magic/expr/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGzC,MAAM,CAAC,MAAM,iBAAiB,GAC9B;IACE,IAAI,gBAAgB,EAAE;IACtB,IAAI,eAAe,EAAE;CACtB,CAAC"}

package/dist/magic/expr/latex.d.ts

@@ -0,0 +1,10 @@
+import { Incantation, ArgIncantation, type EXPR } from "../incantation";
+export declare class LatexIncantation extends ArgIncantation<EXPR> {
+    readonly description = "Produce a LaTeX expression. This allows the input to span multiple lines.";
+    readonly identifier = "latex";
+    readonly requires_arg = true;
+    readonly arg_type = Incantation.ArgType.LATEX;
+    apply(target: Desmos.ExpressionState, data: string): void;
+    evaluate_arg(data: string): string;
+}
+//# sourceMappingURL=latex.d.ts.map

package/dist/magic/expr/latex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latex.d.ts","sourceRoot":"","sources":["../../../src/magic/expr/latex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGxE,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,IAAI,CAAC;IAExD,SAAkB,WAAW,+EACkD;IAE/E,SAAkB,UAAU,WAAY;IACxC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,6BAAgC;IAE1D,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKxD;IAEQ,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1C;CACF"}

package/dist/magic/expr/latex.js

@@ -0,0 +1,16 @@
+import { Incantation, ArgIncantation } from "../incantation";
+export class LatexIncantation extends ArgIncantation {
+    description = "Produce a LaTeX expression. This allows the input to span multiple lines.";
+    identifier = "latex";
+    requires_arg = true;
+    arg_type = Incantation.ArgType.LATEX;
+    apply(target, data) {
+        target.type = "expression";
+        // @ts-expect-error: outdated types
+        target.latex = data;
+    }
+    evaluate_arg(data) {
+        return data;
+    }
+}
+//# sourceMappingURL=latex.js.map

package/dist/magic/expr/latex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latex.js","sourceRoot":"","sources":["../../../src/magic/expr/latex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAGxE,MAAM,OAAO,gBAAiB,SAAQ,cAAoB;IAEtC,WAAW,GACzB,2EAA2E,CAAA;IAE7D,UAAU,GAAK,OAAO,CAAA;IACtB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAA;IAE1D,KAAK,CAAC,MAA8B,EAAE,IAAY;QAEhD,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;QAC3B,mCAAmC;QACnC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAEQ,YAAY,CAAC,IAAY;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/magic/expr/text.d.ts

@@ -0,0 +1,9 @@
+import { Incantation, ArgIncantation, type EXPR } from "../incantation";
+export declare class TextIncantation extends ArgIncantation<EXPR> {
+    readonly description = "Produce a text expression (\u201CAdd Note\u201D in the Desmos GUI).";
+    readonly identifier = "text";
+    readonly requires_arg = true;
+    readonly arg_type = Incantation.ArgType.STRING;
+    apply(target: Desmos.ExpressionState, data: string): void;
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/magic/expr/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/magic/expr/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGxE,qBAAa,eAAgB,SAAQ,cAAc,CAAC,IAAI,CAAC;IAEvD,SAAkB,WAAW,yEACkC;IAE/D,SAAkB,UAAU,UAAW;IACvC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,QAK1D;CACF"}

package/dist/magic/expr/text.js

@@ -0,0 +1,13 @@
+import { Incantation, ArgIncantation } from "../incantation";
+export class TextIncantation extends ArgIncantation {
+    description = "Produce a text expression (“Add Note” in the Desmos GUI).";
+    identifier = "text";
+    requires_arg = true;
+    arg_type = Incantation.ArgType.STRING;
+    apply(target, data) {
+        target.type = "text";
+        // @ts-expect-error: outdated types
+        target.text = data;
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/magic/expr/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/magic/expr/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAGxE,MAAM,OAAO,eAAgB,SAAQ,cAAoB;IAErC,WAAW,GACzB,2DAA2D,CAAA;IAE7C,UAAU,GAAK,MAAM,CAAA;IACrB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAElD,KAAK,CAAC,MAA8B,EAAE,IAAY;QAEzD,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC;QACrB,mCAAmC;QACnC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/magic/global/dark-mode.d.ts

@@ -0,0 +1,7 @@
+import { Incantation, type GLOBAL } from "../incantation";
+export declare class DarkModeIncantation extends Incantation<GLOBAL> {
+    readonly description = "Enable dark mode for the calculator, which inverts all colours.";
+    readonly identifier = "dark";
+    apply(target: Desmos.Calculator): void;
+}
+//# sourceMappingURL=dark-mode.d.ts.map

package/dist/magic/global/dark-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark-mode.d.ts","sourceRoot":"","sources":["../../../src/magic/global/dark-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG1D,qBAAa,mBAAoB,SAAQ,WAAW,CAAC,MAAM,CAAC;IAE1D,SAAkB,WAAW,qEACwC;IAErE,SAAkB,UAAU,UAAS;IAErC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,QAK9B;CACF"}

package/dist/magic/global/dark-mode.js

@@ -0,0 +1,11 @@
+import { Incantation } from "../incantation";
+export class DarkModeIncantation extends Incantation {
+    description = "Enable dark mode for the calculator, which inverts all colours.";
+    identifier = "dark";
+    apply(target) {
+        target.updateSettings({
+            invertedColors: true,
+        });
+    }
+}
+//# sourceMappingURL=dark-mode.js.map

package/dist/magic/global/dark-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark-mode.js","sourceRoot":"","sources":["../../../src/magic/global/dark-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,gBAAgB,CAAC;AAG1D,MAAM,OAAO,mBAAoB,SAAQ,WAAmB;IAExC,WAAW,GACzB,iEAAiE,CAAA;IAEnD,UAAU,GAAG,MAAM,CAAA;IAErC,KAAK,CAAC,MAAyB;QAE7B,MAAM,CAAC,cAAc,CAAC;YACpB,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/magic/global/desmos.d.ts

@@ -0,0 +1,9 @@
+import { Incantation, ArgIncantation, type GLOBAL } from "../incantation";
+export declare class DesmosIncantation extends ArgIncantation<GLOBAL> {
+    readonly description = "Set the configuration of the calculator via `Calculator.updateSettings()`.";
+    readonly identifier = "desmos";
+    readonly requires_arg = false;
+    readonly arg_type = Incantation.ArgType.OBJECT;
+    apply(target: Desmos.Calculator, data: Desmos.GraphConfiguration & Desmos.GraphSettings): void;
+}
+//# sourceMappingURL=desmos.d.ts.map