@dodona/papyros 1.0.1 → 2.0.0-beta.0

package/dist/App.d.ts

@@ -1 +1 @@
-export {};
+import "./Papyros.css";

package/dist/App.js

@@ -0,0 +1,73 @@
+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 "./Papyros.css";
+import { addPapyrosPrefix, DEFAULT_LOCALE, DEFAULT_PROGRAMMING_LANGUAGE, DEFAULT_SERVICE_WORKER } from "./Constants";
+import { Papyros } from "./Papyros";
+import { InputMode } from "./InputManager";
+import { BatchInputHandler } from "./input/BatchInputHandler";
+const LOCAL_STORAGE_KEYS = {
+    code: addPapyrosPrefix("previous-code"),
+    input: addPapyrosPrefix("previous-batch-input")
+};
+function setUpEditor(editor, storageKey) {
+    const previousValue = window.localStorage.getItem(storageKey);
+    if (previousValue) {
+        editor.setText(previousValue);
+    }
+    editor.onChange({
+        onChange: (text) => {
+            window.localStorage.setItem(storageKey, text);
+        },
+        delay: 0
+    });
+}
+function startPapyros() {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Retrieve initial locale and programming language from URL
+        // This allows easier sharing of Papyros-related links with others
+        // While preventing loading an unwanted backend
+        const urlParams = new URLSearchParams(window.location.search);
+        const language = Papyros.toProgrammingLanguage(urlParams.get("language") ||
+            DEFAULT_PROGRAMMING_LANGUAGE);
+        const locale = urlParams.get("locale") || DEFAULT_LOCALE;
+        const config = {
+            standAlone: true,
+            programmingLanguage: language,
+            locale: locale,
+            inputMode: InputMode.Batch,
+            channelOptions: {
+                serviceWorkerName: DEFAULT_SERVICE_WORKER
+            }
+        };
+        const papyros = new Papyros(config);
+        let darkMode = false;
+        if (window.matchMedia) {
+            darkMode = window.matchMedia("(prefers-color-scheme: dark)").matches;
+            window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change", e => {
+                papyros.setDarkMode(e.matches);
+            });
+        }
+        papyros.render({
+            standAloneOptions: {
+                parentElementId: "root"
+            },
+            darkMode: darkMode
+        });
+        setUpEditor(papyros.codeRunner.editor, LOCAL_STORAGE_KEYS.code);
+        papyros.codeRunner.editor.focus();
+        const handler = papyros.codeRunner.inputManager.getInputHandler(InputMode.Batch);
+        if (handler instanceof BatchInputHandler) {
+            setUpEditor(handler.batchEditor, LOCAL_STORAGE_KEYS.input);
+        }
+        yield papyros.launch();
+    });
+}
+startPapyros();
+//# sourceMappingURL=App.js.map

package/dist/App.js.map

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

package/dist/Backend.d.ts

@@ -1,40 +1,6 @@
-import { CompletionContext, CompletionResult } from "@codemirror/autocomplete";
 import { BackendEvent } from "./BackendEvent";
 import { SyncExtras } from "comsync";
 import { BackendEventQueue } from "./BackendEventQueue";
-/**
- * Interface to represent the CodeMirror CompletionContext in a worker
- */
-export interface WorkerAutocompleteContext {
-    /**
-     * Whether the autocompletion was explicitly requested (using keybindings)
-     */
-    explicit: boolean;
-    /**
-     * The absolute position in the CodeMirror document
-     */
-    pos: number;
-    /**
-     * The line number of the cursor while completing (1-based)
-     */
-    line: number;
-    /**
-     * The column number of the cursor while completing (1-based)
-     */
-    column: number;
-    /**
-     * The full text to autocomplete for
-     */
-    text: string;
-    /**
-     * The match before the cursor (determined by a regex)
-     */
-    before: {
-        from: number;
-        to: number;
-        text: string;
-    } | null;
-}
 export interface WorkerDiagnostic {
     /**
      * 1-based index of the starting line containing the issue
@@ -111,20 +77,6 @@ export declare abstract class Backend<Extras extends SyncExtras = SyncExtras> {
      * @return {Promise<void>} Promise of execution
      */
     abstract runCode(extras: Extras, code: string, mode?: string): Promise<void>;
-    /**
-     * Converts the context to a cloneable object containing useful properties
-     * to generate autocompletion suggestions with
-     * Class instances are not passable to workers, so we extract the useful information
-     * @param {CompletionContext} context Current context to autocomplete for
-     * @param {RegExp} expr Expression to match the previous token with
-     * @return {WorkerAutocompleteContext} Completion context that can be passed as a message
-     */
-    static convertCompletionContext(context: CompletionContext, expr?: RegExp): WorkerAutocompleteContext;
-    /**
-     * Generate autocompletion suggestions for the given context
-     * @param {WorkerAutocompleteContext} context Context to autcomplete in
-     */
-    abstract autocomplete(context: WorkerAutocompleteContext): Promise<CompletionResult | null>;
     /**
      * Generate linting suggestions for the given code
      * @param {string} code The code to lint

package/dist/Backend.js

@@ -0,0 +1,76 @@
+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 "./BackendEvent";
+import { syncExpose } from "comsync";
+import { BackendEventQueue } from "./BackendEventQueue";
+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
+     * @param {function():void} onOverflow Callback for when overflow occurs
+     * @return {Promise<void>} Promise of launching
+     */
+    launch(onEvent, onOverflow) {
+        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), onOverflow);
+            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 [];
+    }
+    /**
+     * @return {boolean} Whether too many output events were generated
+     */
+    hasOverflow() {
+        return this.queue.hasOverflow();
+    }
+    /**
+     * @return {Array<BackendEvent>} The events that happened after overflow
+     */
+    getOverflow() {
+        return this.queue.getOverflow();
+    }
+}
+//# sourceMappingURL=Backend.js.map

package/dist/Backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backend.js","sourceRoot":"","sources":["../src/Backend.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAgB,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAmCxD,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;;;;;OAKG;IACU,MAAM,CACf,OAAkC,EAClC,UAAsB;;YAEtB,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,EAAE,UAAU,CAAC,CAAC;YACxE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;KAAA;IAED;;;;OAIG;IACH,6DAA6D;IACtD,QAAQ,CAAC,IAAY;QACxB,OAAO,EAAE,CAAC;IACd,CAAC;IAiBD;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;CACJ"}

package/dist/BackendEvent.js

@@ -0,0 +1,24 @@
+/**
+ * Enum representing all possible types for supported events
+ */
+export var BackendEventType;
+(function (BackendEventType) {
+    BackendEventType["Start"] = "start";
+    BackendEventType["End"] = "end";
+    BackendEventType["Input"] = "input";
+    BackendEventType["Output"] = "output";
+    BackendEventType["Sleep"] = "sleep";
+    BackendEventType["Error"] = "error";
+    BackendEventType["Interrupt"] = "interrupt";
+    BackendEventType["Loading"] = "loading";
+})(BackendEventType || (BackendEventType = {}));
+/**
+ * All possible types for ease of iteration
+ */
+export const BACKEND_EVENT_TYPES = [
+    BackendEventType.Start, BackendEventType.End,
+    BackendEventType.Input, BackendEventType.Output,
+    BackendEventType.Sleep, BackendEventType.Error,
+    BackendEventType.Interrupt, BackendEventType.Loading
+];
+//# sourceMappingURL=BackendEvent.js.map

package/dist/BackendEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendEvent.js","sourceRoot":"","sources":["../src/BackendEvent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IACxB,mCAAe,CAAA;IACf,+BAAW,CAAA;IACX,mCAAe,CAAA;IACf,qCAAiB,CAAA;IACjB,mCAAe,CAAA;IACf,mCAAe,CAAA;IACf,2CAAuB,CAAA;IACvB,uCAAmB,CAAA;AACvB,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B;AACD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,CAAC,GAAG;IAC5C,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,CAAC,MAAM;IAC/C,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK;IAC9C,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,OAAO;CACvD,CAAC"}

package/dist/BackendEventQueue.js

@@ -0,0 +1,135 @@
+import { BackendEventType } from "./BackendEvent";
+/**
+ * Queue to limit the amount of messages sent between threads
+ * This prevents communication issues which arise either in Comlink
+ * or in the WebWorker message passing code
+ */
+export class BackendEventQueue {
+    /**
+     * @param {function(BackendEvent):void} callback Function to process events in the queue
+     * @param {function():void} onOverflow Callback for when overflow occurs
+     * @param {number} limit The maximal amount of output lines to send before overflowing
+     * @param {number} flushTime The time in milliseconds before sending events through
+     */
+    constructor(callback, onOverflow, limit = 1000, flushTime = 100) {
+        this.callback = callback;
+        this.limit = limit;
+        this.flushTime = flushTime;
+        this.queue = [];
+        this.overflow = [];
+        this.onOverflow = onOverflow;
+        this.overflown = false;
+        this.lastFlushTime = new Date().getTime();
+        this.sendCount = 0;
+        this.decoder = new TextDecoder();
+    }
+    /**
+     * Add an element to the queue
+     * @param {BackendEventType} type The type of the event
+     * @param {string | BufferSource} text The data for the event
+     * @param {string | any} extra Extra data for the event
+     * If string, interpreted as the contentType
+     * If anything else, it should contain a contentType
+     * If the contentType is not textual, an error is thrown
+     */
+    put(type, text, extra) {
+        let stringData = "";
+        if (typeof text !== "string") {
+            stringData = this.decoder.decode(text);
+        }
+        else {
+            stringData = text;
+        }
+        let extraArgs = {};
+        let contentType = "text/plain";
+        if (extra) {
+            if (typeof extra === "string") {
+                contentType = extra;
+            }
+            else {
+                contentType = extra["contentType"];
+                delete extra["contentType"];
+                extraArgs = extra;
+            }
+        }
+        if (this.queue.length === 0 ||
+            !contentType.startsWith("text") || // Non textual cannot be combined
+            this.queue[this.queue.length - 1].type !== type || // Different type
+            // Can't be combined if contentType doesn't match
+            this.queue[this.queue.length - 1].contentType !== contentType) {
+            this.queue.push(Object.assign({ type: type, data: stringData, contentType: contentType }, extraArgs));
+        }
+        else { // Same kind of event, combine into one
+            this.queue[this.queue.length - 1].data += stringData;
+        }
+        if (this.shouldFlush()) {
+            this.flush();
+        }
+    }
+    /**
+     * @return {boolean} Whether the queue contents should be flushed
+     */
+    shouldFlush() {
+        return this.queue.length > 1 || // different types of Events present
+            new Date().getTime() - this.lastFlushTime > this.flushTime;
+    }
+    /**
+     * Reset the queue contents for a new run
+     */
+    reset() {
+        this.queue = [];
+        this.overflow = [];
+        this.overflown = false;
+        this.lastFlushTime = new Date().getTime();
+        this.sendCount = 0;
+    }
+    /**
+     * @param {BackendEvent} e The event put in the queue
+     * @return {number} The amount of lines of data in the event
+     */
+    static lines(e) {
+        return (e.data.match(/\n/g) || []).length + 1;
+    }
+    /**
+     * Flush the queue contents using the callback
+     */
+    flush() {
+        this.queue.forEach(e => {
+            if (e.type === BackendEventType.Output) {
+                this.overflow.push(e);
+                if (this.sendCount < this.limit) {
+                    this.sendCount += BackendEventQueue.lines(e);
+                    this.callback(e);
+                }
+                else if (!this.overflown) {
+                    this.overflown = true;
+                    this.onOverflow();
+                }
+            }
+            else {
+                this.callback(e);
+            }
+        });
+        this.queue = [];
+        this.lastFlushTime = new Date().getTime();
+    }
+    /**
+     * @return {boolean} Whether too many output events were generated
+     */
+    hasOverflow() {
+        return this.overflown;
+    }
+    /**
+     * @return {Array<BackendEvent>} The events that happened after overflow
+     */
+    getOverflow() {
+        return this.overflow;
+    }
+    /**
+     * @param {Function} callback The event-consuming callback
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+}
+//# sourceMappingURL=BackendEventQueue.js.map

package/dist/BackendEventQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendEventQueue.js","sourceRoot":"","sources":["../src/BackendEventQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IA2C1B;;;;;OAKG;IACH,YAAY,QAAmC,EAC3C,UAAsB,EACtB,KAAK,GAAG,IAAI,EAAE,SAAS,GAAG,GAAG;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;OAQG;IACI,GAAG,CAAC,IAAsB,EAAE,IAA2B,EAAE,KAAmB;QAC/E,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACJ,UAAU,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,WAAW,GAAG,YAAY,CAAC;QAC/B,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,WAAW,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACJ,WAAW,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;gBACnC,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC5B,SAAS,GAAG,KAAK,CAAC;YACtB,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YACvB,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,iCAAiC;YACpE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,iBAAiB;YACpE,iDAAiD;YACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,IAAI,iBACX,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,WAAW,IACrB,SAAS,EACd,CAAC;QACP,CAAC;aAAM,CAAC,CAAC,uCAAuC;YAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;OAEG;IACO,WAAW;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,oCAAoC;YAChE,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,KAAK,CAAC,CAAe;QAChC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACnB,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,MAAM,EAAE,CAAC;gBACrC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC9B,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC7C,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACrB,CAAC;qBAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;oBACtB,IAAI,CAAC,UAAU,EAAE,CAAC;gBACtB,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAmC;QAClD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ"}

package/dist/BackendManager.d.ts

@@ -7,7 +7,7 @@ import { SyncClient } from "comsync";
  * Callback type definition for subscribers
  * @param {BackendEvent} e The published event
  */
-declare type BackendEventListener = (e: BackendEvent) => void;
+type BackendEventListener = (e: BackendEvent) => void;
 /**
  * Abstract class to implement the singleton pattern
  * Static methods group functionality

package/dist/BackendManager.js

@@ -0,0 +1,94 @@
+import { ProgrammingLanguage } from "./ProgrammingLanguage";
+import { BackendEventType } from "./BackendEvent";
+import { LogType, papyrosLog } from "./util/Logging";
+import { makeChannel } from "sync-message";
+import { SyncClient } from "comsync";
+import { PyodideClient } from "pyodide-worker-runner";
+/**
+ * Abstract class to implement the singleton pattern
+ * Static methods group functionality
+ */
+export class BackendManager {
+    /**
+     * @param {ProgrammingLanguage} language The language to support
+     * @param {Function} backendCreator The constructor for a SyncClient
+     */
+    static registerBackend(language, backendCreator) {
+        BackendManager.removeBackend(language);
+        BackendManager.createBackendMap.set(language, backendCreator);
+    }
+    /**
+     * Start a backend for the given language and cache for reuse
+     * @param {ProgrammingLanguage} language The programming language supported by the backend
+     * @return {SyncClient<Backend>} A SyncClient for the Backend
+     */
+    static getBackend(language) {
+        if (this.backendMap.has(language)) { // Cached
+            return this.backendMap.get(language);
+        }
+        else if (this.createBackendMap.has(language)) {
+            // Create and then cache
+            const syncClient = this.createBackendMap.get(language)();
+            this.backendMap.set(language, syncClient);
+            return syncClient;
+        }
+        else {
+            throw new Error(`${language} is not yet supported.`);
+        }
+    }
+    /**
+     * Remove a backend for the given language
+     * @param {ProgrammingLanguage} language The programming language supported by the backend
+     * @return {boolean} Whether the remove operation had any effect
+     */
+    static removeBackend(language) {
+        this.backendMap.delete(language);
+        return this.createBackendMap.delete(language);
+    }
+    /**
+     * Register a callback for when an event of a certain type is published
+     * @param {BackendEventType} type The type of event to subscribe to
+     * @param {BackendEventListener} subscriber Callback for when an event
+     * of the given type is published
+     */
+    static subscribe(type, subscriber) {
+        if (!this.subscriberMap.has(type)) {
+            this.subscriberMap.set(type, []);
+        }
+        const subscribers = this.subscriberMap.get(type);
+        if (!subscribers.includes(subscriber)) {
+            subscribers.push(subscriber);
+        }
+    }
+    /**
+     * Publish an event, notifying all listeners for its type
+     * @param {BackendEventType} e The event to publish
+     */
+    static publish(e) {
+        papyrosLog(LogType.Debug, "Publishing event: ", e);
+        if (e.type === BackendEventType.Start) {
+            BackendManager.halted = false;
+        }
+        if (!BackendManager.halted && this.subscriberMap.has(e.type)) {
+            this.subscriberMap.get(e.type).forEach(cb => cb(e));
+        }
+    }
+    static halt() {
+        BackendManager.halted = true;
+    }
+}
+/**
+ * Initialise the fields and setup the maps
+ */
+(() => {
+    BackendManager.channel = makeChannel();
+    BackendManager.createBackendMap = new Map();
+    BackendManager.backendMap = new Map();
+    BackendManager.subscriberMap = new Map();
+    BackendManager.registerBackend(ProgrammingLanguage.Python, () => new PyodideClient(() => new Worker(new URL("./workers/python/worker", import.meta.url)), BackendManager.channel));
+    BackendManager.registerBackend(ProgrammingLanguage.JavaScript, () => new SyncClient(() => new Worker(new URL("./workers/javascript/worker", import.meta.url)), BackendManager.channel));
+    BackendManager.halted = false;
+    BackendManager.subscribe(BackendEventType.End, () => BackendManager.halt());
+    BackendManager.subscribe(BackendEventType.Interrupt, () => BackendManager.halt());
+})();
+//# sourceMappingURL=BackendManager.js.map

package/dist/BackendManager.js.map

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