@dodona/papyros 4.1.1 → 4.1.2

package/dist/Library.d.ts

@@ -0,0 +1,11 @@
+import "./frontend/components/Input";
+import "./frontend/components/Output";
+import "./frontend/components/CodeRunner";
+import "./frontend/components/Debugger";
+import { Papyros, papyros } from "./frontend/state/Papyros";
+import { InputMode } from "./frontend/state/InputOutput";
+import { RunMode } from "./backend/Backend";
+import { ProgrammingLanguage } from "./ProgrammingLanguage";
+import { OutputType, FriendlyError } from "./frontend/state/InputOutput";
+export { Papyros, InputMode, RunMode, ProgrammingLanguage, OutputType, papyros };
+export type { FriendlyError };

package/dist/Library.js

@@ -0,0 +1,11 @@
+import "./frontend/components/Input";
+import "./frontend/components/Output";
+import "./frontend/components/CodeRunner";
+import "./frontend/components/Debugger";
+import { Papyros, papyros } from "./frontend/state/Papyros";
+import { InputMode } from "./frontend/state/InputOutput";
+import { RunMode } from "./backend/Backend";
+import { ProgrammingLanguage } from "./ProgrammingLanguage";
+import { OutputType } from "./frontend/state/InputOutput";
+export { Papyros, InputMode, RunMode, ProgrammingLanguage, OutputType, papyros };
+//# sourceMappingURL=Library.js.map

package/dist/Library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Library.js","sourceRoot":"","sources":["../src/Library.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AACrC,OAAO,8BAA8B,CAAC;AACtC,OAAO,kCAAkC,CAAC;AAC1C,OAAO,gCAAgC,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAiB,MAAM,8BAA8B,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC"}

package/dist/ProgrammingLanguage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * String enum representing programming languages supported by Papyros
+ */
+export declare enum ProgrammingLanguage {
+    Python = "Python",
+    JavaScript = "JavaScript"
+}

package/dist/ProgrammingLanguage.js

@@ -0,0 +1,9 @@
+/**
+ * String enum representing programming languages supported by Papyros
+ */
+export var ProgrammingLanguage;
+(function (ProgrammingLanguage) {
+    ProgrammingLanguage["Python"] = "Python";
+    ProgrammingLanguage["JavaScript"] = "JavaScript";
+})(ProgrammingLanguage || (ProgrammingLanguage = {}));
+//# sourceMappingURL=ProgrammingLanguage.js.map

package/dist/ProgrammingLanguage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgrammingLanguage.js","sourceRoot":"","sources":["../src/ProgrammingLanguage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,wCAAiB,CAAA;IACjB,gDAAyB,CAAA;AAC7B,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B"}

package/dist/backend/Backend.d.ts

@@ -0,0 +1,92 @@
+import { BackendEvent } from "../communication/BackendEvent";
+import { SyncExtras } from "comsync";
+import { BackendEventQueue } from "../communication/BackendEventQueue";
+export interface WorkerDiagnostic {
+    /**
+     * 1-based index of the starting line containing the issue
+     */
+    lineNr: number;
+    /**
+     * 0-based index of the column in the starting line
+     */
+    columnNr: number;
+    /**
+     * 1-based index of the ending line containing the issue
+     * Can be the same as lineNr
+     */
+    endLineNr: number;
+    /**
+     * 0-based index of the column in the ending line
+     */
+    endColumnNr: number;
+    /**
+     * Severity of the issue
+     */
+    severity: "info" | "warning" | "error";
+    /**
+     * Message describing the issue
+     */
+    message: string;
+}
+export declare enum RunMode {
+    Run = "run",
+    Debug = "debug",
+    Doctest = "doctest"
+}
+export declare abstract class Backend<Extras extends SyncExtras = SyncExtras> {
+    /**
+     * SyncExtras object that grants access to helpful methods
+     * for synchronous operations
+     */
+    protected extras: Extras;
+    /**
+     * Callback to handle events published by this Backend
+     */
+    protected onEvent: (e: BackendEvent) => any;
+    /**
+     * Queue to handle published events without overloading the thread
+     */
+    protected queue: BackendEventQueue;
+    /**
+     * Constructor is limited as it is meant to be used as a WebWorker
+     * Proper initialization occurs in the launch method when the worker is started
+     * Synchronously exposing methods should be done here
+     */
+    constructor();
+    /**
+     * @return {any} The function to expose methods for Comsync to allow interrupting
+     */
+    protected syncExpose(): any;
+    /**
+     * Initialize the backend by doing all setup-related work
+     * @param {function(BackendEvent):void} onEvent Callback for when events occur
+     * @return {Promise<void>} Promise of launching
+     */
+    launch(onEvent: (e: BackendEvent) => void): Promise<void>;
+    /**
+     * Determine whether the modes supported by this Backend are active
+     * @param {string} code The current code in the editor
+     * @return {Array<RunMode>} The run modes of this Backend
+     */
+    runModes(code: string): Array<RunMode>;
+    /**
+     * Executes the given code
+     * @param {Extras} extras Helper properties to run code
+     * @param {string} code The code to run
+     * @param {string} mode The mode to run the code in
+     * @return {Promise<void>} Promise of execution
+     */
+    abstract runCode(extras: Extras, code: string, mode?: string): Promise<void>;
+    /**
+     * Generate linting suggestions for the given code
+     * @param {string} code The code to lint
+     */
+    abstract lintCode(code: string): Promise<Array<WorkerDiagnostic>>;
+    /**
+     * Provide files to be used by the backend
+     * @param {Record<string, string>} inlineFiles Map of file names to their contents
+     * @param {Record<string, string>} hrefFiles Map of file names to URLS with their contents
+     * @return {Promise<void>} Resolves when the files are present in the backend
+     */
+    provideFiles(inlineFiles: Record<string, string>, hrefFiles: Record<string, string>): Promise<void>;
+}

package/dist/backend/Backend.js

@@ -0,0 +1,79 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { BackendEventType } from "../communication/BackendEvent";
+import { syncExpose } from "comsync";
+import { BackendEventQueue } from "../communication/BackendEventQueue";
+export var RunMode;
+(function (RunMode) {
+    RunMode["Run"] = "run";
+    RunMode["Debug"] = "debug";
+    RunMode["Doctest"] = "doctest";
+})(RunMode || (RunMode = {}));
+export class Backend {
+    /**
+     * Constructor is limited as it is meant to be used as a WebWorker
+     * Proper initialization occurs in the launch method when the worker is started
+     * Synchronously exposing methods should be done here
+     */
+    constructor() {
+        this.extras = {};
+        this.onEvent = () => {
+            // Empty, initialized in launch
+        };
+        this.runCode = this.syncExpose()(this.runCode.bind(this));
+        this.queue = {};
+    }
+    /**
+     * @return {any} The function to expose methods for Comsync to allow interrupting
+     */
+    syncExpose() {
+        return syncExpose;
+    }
+    /**
+     * Initialize the backend by doing all setup-related work
+     * @param {function(BackendEvent):void} onEvent Callback for when events occur
+     * @return {Promise<void>} Promise of launching
+     */
+    launch(onEvent) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.onEvent = (e) => {
+                onEvent(e);
+                if (e.type === BackendEventType.Sleep) {
+                    return this.extras.syncSleep(e.data);
+                }
+                else if (e.type === BackendEventType.Input) {
+                    return this.extras.readMessage();
+                }
+            };
+            this.queue = new BackendEventQueue(this.onEvent.bind(this));
+            return Promise.resolve();
+        });
+    }
+    /**
+     * Determine whether the modes supported by this Backend are active
+     * @param {string} code The current code in the editor
+     * @return {Array<RunMode>} The run modes of this Backend
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    runModes(code) {
+        return [];
+    }
+    /**
+     * Provide files to be used by the backend
+     * @param {Record<string, string>} inlineFiles Map of file names to their contents
+     * @param {Record<string, string>} hrefFiles Map of file names to URLS with their contents
+     * @return {Promise<void>} Resolves when the files are present in the backend
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    provideFiles(inlineFiles, hrefFiles) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=Backend.js.map

package/dist/backend/Backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backend.js","sourceRoot":"","sources":["../../src/backend/Backend.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAgB,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AA8BvE,MAAM,CAAN,IAAY,OAIX;AAJD,WAAY,OAAO;IACf,sBAAW,CAAA;IACX,0BAAe,CAAA;IACf,8BAAmB,CAAA;AACvB,CAAC,EAJW,OAAO,KAAP,OAAO,QAIlB;AAED,MAAM,OAAgB,OAAO;IAczB;;;;OAIG;IACH;QACI,IAAI,CAAC,MAAM,GAAG,EAAY,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE;YAChB,+BAA+B;QACnC,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,EAAuB,CAAC;IACzC,CAAC;IAED;;OAEG;IACO,UAAU;QAChB,OAAO,UAAU,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACU,MAAM,CAAC,OAAkC;;YAClD,IAAI,CAAC,OAAO,GAAG,CAAC,CAAe,EAAE,EAAE;gBAC/B,OAAO,CAAC,CAAC,CAAC,CAAC;gBACX,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,KAAK,EAAE,CAAC;oBACpC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACzC,CAAC;qBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,KAAK,EAAE,CAAC;oBAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBACrC,CAAC;YACL,CAAC,CAAC;YACF,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5D,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;KAAA;IAED;;;;OAIG;IACH,6DAA6D;IACtD,QAAQ,CAAC,IAAY;QACxB,OAAO,EAAE,CAAC;IACd,CAAC;IAiBD;;;;;OAKG;IACH,6DAA6D;IACtD,YAAY,CAAC,WAAmC,EAAE,SAAiC;QACtF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;CACJ"}

package/dist/backend/workers/javascript/JavaScriptWorker.d.ts

@@ -0,0 +1,39 @@
+import { Backend, WorkerDiagnostic } from "../../Backend";
+import { SyncExtras } from "comsync";
+/**
+ * Implementation of a JavaScript backend for Papyros
+ * by using eval and overriding some builtins
+ */
+export declare class JavaScriptWorker extends Backend<SyncExtras> {
+    /**
+     * Convert varargs to a string, similar to how the console does it
+     * @param {any[]} args The values to join into a string
+     * @return {string} The string representation
+     */
+    private static stringify;
+    /**
+     * Prompt the user for input with a message
+     * @param {string} text The message to show when asking for input
+     * @return {string} The value the user gave
+     */
+    private prompt;
+    /**
+     * Print values to the output screen
+     * @param {any[]} args The values to log
+     */
+    private consoleLog;
+    /**
+     * Print values to the error screen
+     * @param {any[]} args The error values to log
+     */
+    private consoleError;
+    /**
+     * Helper method to generate suggestions based on properties in an object
+     * @param {number} from Where in the document the autocompletion starts
+     * @param {any} object Object with properties that might be relevant
+     * @return {CompletionResult} Autocompletion suggestions
+     */
+    private static completeProperties;
+    runCode(extras: SyncExtras, code: string): Promise<any>;
+    lintCode(): Promise<Array<WorkerDiagnostic>>;
+}

package/dist/backend/workers/javascript/JavaScriptWorker.js

@@ -0,0 +1,158 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Backend } from "../../Backend";
+import { BackendEventType } from "../../../communication/BackendEvent";
+/**
+ * Implementation of a JavaScript backend for Papyros
+ * by using eval and overriding some builtins
+ */
+export class JavaScriptWorker extends Backend {
+    /**
+     * Convert varargs to a string, similar to how the console does it
+     * @param {any[]} args The values to join into a string
+     * @return {string} The string representation
+     */
+    static stringify(...args) {
+        const asString = args
+            .map((a) => {
+            if (Array.isArray(a)) {
+                return JSON.stringify(a);
+            }
+            else if (typeof a === "string") {
+                return a;
+            }
+            else if (typeof a === "number") {
+                return a + "";
+            }
+            else if (typeof a === "object" && "toString" in a) {
+                let aString = a.toString();
+                if (aString === "[object Object]") {
+                    // useless toString, so use JSON
+                    aString = JSON.stringify(a);
+                }
+                return aString;
+            }
+            else {
+                return JSON.stringify(args);
+            }
+        })
+            .join(" ");
+        return asString;
+    }
+    /**
+     * Prompt the user for input with a message
+     * @param {string} text The message to show when asking for input
+     * @return {string} The value the user gave
+     */
+    prompt(text = "") {
+        return this.onEvent({
+            type: BackendEventType.Input,
+            data: text,
+            contentType: "text/plain",
+        });
+    }
+    /**
+     * Print values to the output screen
+     * @param {any[]} args The values to log
+     */
+    consoleLog(...args) {
+        this.queue.put(BackendEventType.Output, JavaScriptWorker.stringify(...args) + "\n", "text/plain");
+    }
+    /**
+     * Print values to the error screen
+     * @param {any[]} args The error values to log
+     */
+    consoleError(...args) {
+        this.queue.put(BackendEventType.Error, JavaScriptWorker.stringify(...args) + "\n", "text/plain");
+    }
+    /**
+     * Helper method to generate suggestions based on properties in an object
+     * @param {number} from Where in the document the autocompletion starts
+     * @param {any} object Object with properties that might be relevant
+     * @return {CompletionResult} Autocompletion suggestions
+     */
+    static completeProperties(from, object) {
+        const options = Object.keys(object).map((name) => {
+            return {
+                label: name,
+                type: typeof object[name] === "function" ? "function" : "variable",
+            };
+        });
+        return {
+            from,
+            options,
+            validFor: /^[\w$]*$/,
+        };
+    }
+    runCode(extras, code) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.extras = extras;
+            this.queue.reset();
+            // Builtins to store before execution and restore afterwards
+            // Workers do not have access to prompt
+            const oldContent = {
+                "console.log": console.log,
+                "console.error": console.error,
+            };
+            // Overrides for the builtins
+            const newContext = {
+                prompt: this.prompt.bind(this),
+                "console.log": this.consoleLog.bind(this),
+                "console.error": this.consoleError.bind(this),
+            };
+            // Override the builtins
+            new Function("ctx", Object.keys(newContext)
+                .map((k) => `${k} = ctx['${k}'];`)
+                .join("\n"))(newContext);
+            let result;
+            try {
+                // run the user's code
+                this.onEvent({
+                    type: BackendEventType.Start,
+                    contentType: "text/plain",
+                    data: "RunCode",
+                });
+                result = yield eval(code);
+            }
+            catch (error) {
+                // try to create a friendly traceback
+                Error.captureStackTrace(error);
+                result = yield this.onEvent({
+                    type: BackendEventType.Error,
+                    contentType: "application/json",
+                    data: {
+                        name: error.constructor.name,
+                        what: error.message,
+                        traceback: error.stack,
+                    },
+                });
+            }
+            finally {
+                // restore the old builtins
+                new Function("ctx", Object.keys(oldContent)
+                    .map((k) => `${k} = ctx['${k}'];`)
+                    .join("\n"))(oldContent);
+                this.queue.flush();
+                this.onEvent({
+                    type: BackendEventType.End,
+                    contentType: "text/plain",
+                    data: "CodeFinished",
+                });
+            }
+            return result;
+        });
+    }
+    lintCode() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return Promise.resolve([]);
+        });
+    }
+}
+//# sourceMappingURL=JavaScriptWorker.js.map

package/dist/backend/workers/javascript/JavaScriptWorker.js.map

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

package/dist/backend/workers/javascript/worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/backend/workers/javascript/worker.js

@@ -0,0 +1,5 @@
+import * as Comlink from "comlink";
+import { JavaScriptWorker } from "./JavaScriptWorker";
+const worker = new JavaScriptWorker();
+Comlink.expose(worker);
+//# sourceMappingURL=worker.js.map

package/dist/backend/workers/javascript/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../../src/backend/workers/javascript/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;AACtC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC"}

package/dist/backend/workers/python/PythonWorker.d.ts

@@ -0,0 +1,32 @@
+import { Backend, RunMode, WorkerDiagnostic } from "../../Backend";
+import { BackendEvent } from "../../../communication/BackendEvent";
+import { PyodideExtras } from "pyodide-worker-runner";
+/**
+ * Implementation of a Python backend for Papyros
+ * Powered by Pyodide (https://pyodide.org/)
+ */
+export declare class PythonWorker extends Backend<PyodideExtras> {
+    private pyodide;
+    private papyros;
+    /**
+     * Promise to asynchronously install imports needed by the code
+     */
+    private installPromise;
+    constructor();
+    private static convert;
+    /**
+     * @return {any} Function to expose a method with Pyodide support
+     */
+    protected syncExpose(): any;
+    private static getPyodide;
+    launch(onEvent: (e: BackendEvent) => void): Promise<void>;
+    /**
+     * Helper method to install imports and prevent race conditions with double downloading
+     * @param {string} code The code containing import statements
+     */
+    private installImports;
+    runModes(code: string): Array<RunMode>;
+    runCode(extras: PyodideExtras, code: string, mode?: string): Promise<any>;
+    lintCode(code: string): Promise<Array<WorkerDiagnostic>>;
+    provideFiles(inlineFiles: Record<string, string>, hrefFiles: Record<string, string>): Promise<void>;
+}

package/dist/backend/workers/python/PythonWorker.js

@@ -0,0 +1,117 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Backend, RunMode } from "../../Backend";
+import { pyodideExpose, loadPyodideAndPackage } from "pyodide-worker-runner";
+const pythonPackageUrl = new URL("./python_package.tar.gz.load_by_url", import.meta.url).href;
+/**
+ * Implementation of a Python backend for Papyros
+ * Powered by Pyodide (https://pyodide.org/)
+ */
+export class PythonWorker extends Backend {
+    constructor() {
+        super();
+        this.pyodide = {};
+        this.installPromise = null;
+    }
+    static convert(data) {
+        return data.toJs ? data.toJs({ dict_converter: Object.fromEntries }) : data;
+    }
+    /**
+     * @return {any} Function to expose a method with Pyodide support
+     */
+    syncExpose() {
+        return pyodideExpose;
+    }
+    static getPyodide() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield loadPyodideAndPackage({ url: pythonPackageUrl, format: ".tgz" });
+        });
+    }
+    launch(onEvent) {
+        const _super = Object.create(null, {
+            launch: { get: () => super.launch }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            yield _super.launch.call(this, onEvent);
+            this.pyodide = yield PythonWorker.getPyodide();
+            // Python calls our function with a PyProxy dict or a Js Map,
+            // These must be converted to a PapyrosEvent (JS Object) to allow message passing
+            this.papyros = this.pyodide.pyimport("papyros").Papyros.callKwargs({
+                callback: (e) => {
+                    const converted = PythonWorker.convert(e);
+                    return this.onEvent(converted);
+                },
+                buffer_constructor: (cb) => {
+                    this.queue.setCallback(cb);
+                    return this.queue;
+                },
+            });
+            // preload micropip to allow installing packages
+            yield this.pyodide.loadPackage("micropip");
+        });
+    }
+    /**
+     * Helper method to install imports and prevent race conditions with double downloading
+     * @param {string} code The code containing import statements
+     */
+    installImports(code) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (this.installPromise == null) {
+                this.installPromise = (_a = this.papyros) === null || _a === void 0 ? void 0 : _a.install_imports.callKwargs({
+                    source_code: code,
+                    ignore_missing: true,
+                });
+            }
+            yield this.installPromise;
+            this.installPromise = null;
+        });
+    }
+    runModes(code) {
+        var _a;
+        let modes = super.runModes(code);
+        if ((_a = this.papyros) === null || _a === void 0 ? void 0 : _a.has_doctests(code)) {
+            modes = [RunMode.Doctest, ...modes];
+        }
+        modes = [RunMode.Debug, ...modes];
+        return modes;
+    }
+    runCode(extras_1, code_1) {
+        return __awaiter(this, arguments, void 0, function* (extras, code, mode = "exec") {
+            var _a;
+            this.extras = extras;
+            if (extras.interruptBuffer) {
+                this.pyodide.setInterruptBuffer(extras.interruptBuffer);
+            }
+            yield this.installImports(code);
+            return yield ((_a = this.papyros) === null || _a === void 0 ? void 0 : _a.run_async.callKwargs({
+                source_code: code,
+                mode: mode,
+            }));
+        });
+    }
+    lintCode(code) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield this.installImports(code);
+            return PythonWorker.convert(((_a = this.papyros) === null || _a === void 0 ? void 0 : _a.lint(code)) || []);
+        });
+    }
+    provideFiles(inlineFiles, hrefFiles) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield ((_a = this.papyros) === null || _a === void 0 ? void 0 : _a.provide_files.callKwargs({
+                inline_files: JSON.stringify(inlineFiles),
+                href_files: JSON.stringify(hrefFiles),
+            }));
+        });
+    }
+}
+//# sourceMappingURL=PythonWorker.js.map

package/dist/backend/workers/python/PythonWorker.js.map

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

package/dist/backend/workers/python/worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/backend/workers/python/worker.js

@@ -0,0 +1,5 @@
+import * as Comlink from "comlink";
+import { PythonWorker } from "./PythonWorker";
+const worker = new PythonWorker();
+Comlink.expose(worker);
+//# sourceMappingURL=worker.js.map

package/dist/backend/workers/python/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../../src/backend/workers/python/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;AAClC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC"}

package/dist/communication/BackendEvent.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Enum representing all possible types for supported events
+ */
+export declare enum BackendEventType {
+    Start = "start",
+    End = "end",
+    Input = "input",
+    Output = "output",
+    Sleep = "sleep",
+    Error = "error",
+    Interrupt = "interrupt",
+    Loading = "loading",
+    Frame = "frame",
+    FrameChange = "frame-change",
+    Stop = "stop"
+}
+/**
+ * Interface for events used for communication between threads
+ */
+export interface BackendEvent {
+    /**
+     * The type of action generating this event
+     */
+    type: BackendEventType;
+    /**
+     * The actual data stored in this event
+     */
+    data: any;
+    /**
+     * The format used for the data to help with parsing
+     */
+    contentType?: string;
+}