code-battles 1.2.1 → 1.4.0

package/dist/cjs/index.js

@@ -3,6 +3,7 @@
 require('@mantine/core/styles.css');
 require('@mantine/dates/styles.css');
 require('@mantine/notifications/styles.css');
+require('@mantine/dropzone/styles.css');
 var core = require('@mantine/core');
 var dates = require('@mantine/dates');
 var hooks = require('@mantine/hooks');
@@ -12,6 +13,7 @@ var auth = require('firebase/auth');
 var firestore = require('firebase/firestore');
 var React = require('react');
 var reactRouterDom = require('react-router-dom');
+var dropzone = require('@mantine/dropzone');
 var jsxRuntime = require('react/jsx-runtime');
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -411,19 +413,28 @@ const toPlacing = (n) => {
 };
 const runNoUI = (map, apis, playerBots, verbose) => {
     const players = playerBots.map((api) => (api === "None" ? "" : apis[api]));
-    tryUntilFailure(() => 
+    tryUntilSuccess(() => 
     // @ts-ignore
     window._startSimulation(map, players, playerBots, true, false, verbose));
 };
-const tryUntilFailure = (f, timeout = 500) => {
+const tryUntilSuccess = (f, timeout = 500) => {
     try {
         f();
     }
     catch (error) {
         console.log("Failed, waiting for timeout...", error === null || error === void 0 ? void 0 : error.message);
-        setTimeout(() => tryUntilFailure(f, timeout), timeout);
+        setTimeout(() => tryUntilSuccess(f, timeout), timeout);
     }
 };
+const downloadFile = (filename, mimeType, contents) => {
+    const a = document.createElement("a");
+    a.style.display = "none";
+    document.body.appendChild(a);
+    a.href = `data:${mimeType};charset=utf-8,${encodeURIComponent(contents)}`;
+    a.download = filename;
+    a.click();
+    document.body.removeChild(a);
+};
 
 const useLocalStorage = ({ key, defaultValue, }) => {
     const [value, setValue] = React.useState(getLocalStorage(key, defaultValue !== null && defaultValue !== void 0 ? defaultValue : null));
@@ -2501,6 +2512,8 @@ const RunSimulationBlock = () => {
         remaining = Math.max(...Object.values(runningNoUIN));
     }
     const run = () => {
+        // @ts-ignore
+        window._isSimulationFromFile = false;
         navigate(`/simulation/${map.replaceAll(" ", "-")}/${playerBots.join("-")}`);
     };
     const startRunNoUI = () => {
@@ -2583,7 +2596,31 @@ const RunSimulationBlock = () => {
         remaining !== 0 && (React.createElement("p", { style: { textAlign: "center", marginTop: 10 } },
             "Remaining Simulations: ",
             remaining)),
-        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" })));
+        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" }),
+        React.createElement(dropzone.Dropzone, { mt: "xs", multiple: false, onDrop: (files) => __awaiter(void 0, void 0, void 0, function* () {
+                if (files.length !== 1) {
+                    return;
+                }
+                const file = files[0];
+                const text = yield file.text();
+                // @ts-ignore
+                window._navigate = navigate;
+                // @ts-ignore
+                window._isSimulationFromFile = true;
+                tryUntilSuccess(() => {
+                    // @ts-ignore
+                    window._startSimulationFromFile(text);
+                });
+            }), style: {
+                textAlign: "center",
+                paddingTop: 20,
+                paddingBottom: 20,
+                paddingLeft: 10,
+                paddingRight: 10,
+            } },
+            React.createElement("span", null,
+                React.createElement("i", { className: "fa-solid fa-file-code", style: { marginRight: 10 } }),
+                "Drag a simulation file here or click to select a file to run a simulation from a file"))));
 };
 
 const TournamentBlock = ({ pointModifier, inline, title }) => {
@@ -15902,12 +15939,17 @@ const Simulation = () => {
     let { map, playerapis } = reactRouterDom.useParams();
     const location = reactRouterDom.useLocation();
     const [winner, setWinner] = React.useState();
+    const [downloadBytes, setDownloadBytes] = React.useState(false);
     const navigate = reactRouterDom.useNavigate();
     const colorScheme = hooks.useColorScheme();
     const showcaseMode = location.search.includes("showcase=true");
     React.useEffect(() => {
         n((engine) => __awaiter(void 0, void 0, void 0, function* () { return yield loadFull(engine); }));
         // @ts-ignore
+        window.showDownload = () => {
+            setDownloadBytes(true);
+        };
+        // @ts-ignore
         window.showWinner = (winner, verbose) => {
             if (admin) {
                 setWinner(winner);
@@ -15937,8 +15979,12 @@ const Simulation = () => {
     const playerNames = (_a = playerapis === null || playerapis === void 0 ? void 0 : playerapis.split("-")) !== null && _a !== void 0 ? _a : [];
     const players = playerNames.map((api) => (api === "None" ? "" : apis[api]));
     React.useEffect(() => {
-        if (!loading && players && playerapis) {
-            tryUntilFailure(() => 
+        if (!loading &&
+            players &&
+            playerapis &&
+            // @ts-ignore
+            window._isSimulationFromFile !== true) {
+            tryUntilSuccess(() => 
             // @ts-ignore
             window._startSimulation(map, players, playerNames, false, !showcaseMode, true));
         }
@@ -16020,9 +16066,14 @@ const Simulation = () => {
                 !location.search.includes("background=true") && (React.createElement(React.Fragment, null,
                     React.createElement("div", { style: { textAlign: "center", flexGrow: 1 } },
                         showcaseMode || (React.createElement(React.Fragment, null,
+                            React.createElement("span", { id: "render-status", style: { marginRight: 10 } }),
                             React.createElement(core.NumberInput, { id: "breakpoint", label: "Breakpoint", min: 0, leftSection: React.createElement("i", { className: "fa-solid fa-stopwatch" }), display: "inline-block", maw: "35%", mr: "xs" }),
                             React.createElement(core.Button, { style: { flex: "none" }, my: "xs", w: 100, leftSection: React.createElement("i", { className: "fa-solid fa-wand-magic" }), color: "grape", id: "step", mr: "xs", radius: "20px" }, "Step"))),
-                        React.createElement(PlayPauseButton, null)),
+                        React.createElement(PlayPauseButton, null),
+                        downloadBytes && (React.createElement(core.Button, { ml: "xs", radius: "20px", leftSection: React.createElement("i", { className: "fa-solid fa-download" }), color: "blue", onClick: () => downloadFile(`${playerNames.join("-")}.btl`, "text/plain", 
+                            // @ts-ignore
+                            window.simulationToDownload) }, "Download Simulation"))),
+                    showcaseMode && React.createElement("span", { id: "render-status" }),
                     React.createElement("p", { style: { margin: 0 } }, "Playback Speed"),
                     React.createElement(core.Slider, { style: { flex: "none" }, mb: 30, w: 500, maw: "85%", min: -2, defaultValue: 0, marks: [
                             { value: -2, label: "1/4" },

package/dist/cjs/types/index.d.ts

@@ -2,6 +2,7 @@ import "@fortawesome/fontawesome-free/css/all.css";
 import "@mantine/core/styles.css";
 import "@mantine/dates/styles.css";
 import "@mantine/notifications/styles.css";
+import "@mantine/dropzone/styles.css";
 import "prismjs/plugins/line-numbers/prism-line-numbers.css";
 import "prismjs/themes/prism.css";
 import "./index.css";

package/dist/cjs/types/utilities.d.ts

@@ -11,4 +11,5 @@ export declare const updatePointModifier: () => void;
 export declare const toPlacing: (n: number) => string;
 export declare const zeroPad: (s: string, l: number) => string;
 export declare const runNoUI: (map: string, apis: Record<string, any>, playerBots: string[], verbose: boolean) => void;
-export declare const tryUntilFailure: (f: () => void, timeout?: number) => void;
+export declare const tryUntilSuccess: (f: () => void, timeout?: number) => void;
+export declare const downloadFile: (filename: string, mimeType: string, contents: string) => void;

package/dist/code_battles/__init__.py

@@ -1,9 +1,7 @@
 import sys
 
-from code_battles.utilities import GameCanvas, Alignment
-from code_battles.battles import CodeBattles, is_web
-from js import window
-from pyscript.ffi import create_proxy
+from code_battles.utilities import GameCanvas, Alignment, is_web, is_worker
+from code_battles.battles import CodeBattles
 
 
 def run_game(battles: CodeBattles):
@@ -11,8 +9,21 @@ def run_game(battles: CodeBattles):
     Binds the given code battles instance to the React code to enable all simulations.
     """
 
-    if is_web:
+    if is_web():
+        from js import window
+        from pyscript.ffi import create_proxy
+
         window._startSimulation = create_proxy(battles._start_simulation)
+        window._startSimulationFromFile = create_proxy(
+            battles._start_simulation_from_file
+        )
+    elif is_worker():
+        setattr(
+            sys.modules["__main__"],
+            "_run_webworker_simulation",
+            battles._run_webworker_simulation,
+        )
+        setattr(sys.modules["__main__"], "__export__", ["_run_webworker_simulation"])
     else:
         battles._run_local_simulation()
 

package/dist/code_battles/battles.py

@@ -1,36 +1,81 @@
 import asyncio
+import base64
+from dataclasses import dataclass
+import datetime
 import json
 import math
 import time
 import random
 import sys
 import traceback
+import gzip
 
 from typing import Any, Dict, Generic, List, Optional, Tuple, TypeVar
 from code_battles.utilities import (
     GameCanvas,
     console_log,
     download_image,
+    navigate,
     set_results,
     show_alert,
+    show_download,
+    web_only,
+    is_web,
 )
-from js import Audio, Image, document, window, FontFace
-from pyscript.ffi import create_proxy
+
+try:
+    import js
+except Exception:
+    pass
 
 GameStateType = TypeVar("GameStateType")
 APIImplementationType = TypeVar("APIImplementationType")
 APIType = TypeVar("APIType")
 PlayerRequestsType = TypeVar("PlayerRequestsType")
 
-is_web = "MicroPython" in sys.version or "pyodide" in sys.executable
-
-
-def web_only(method):
-    def wrapper(*args, **kwargs):
-        if is_web:
-            return method(*args, **kwargs)
 
-    return wrapper
+@dataclass
+class Simulation:
+    map: str
+    player_names: str
+    game: str
+    version: str
+    timestamp: datetime.datetime
+    logs: list
+    decisions: List[bytes]
+
+    def dump(self):
+        return base64.b64encode(
+            gzip.compress(
+                json.dumps(
+                    {
+                        "map": self.map,
+                        "playerNames": self.player_names,
+                        "game": self.game,
+                        "version": self.version,
+                        "timestamp": self.timestamp.isoformat(),
+                        "logs": self.logs,
+                        "decisions": [
+                            base64.b64encode(decision).decode()
+                            for decision in self.decisions
+                        ],
+                    }
+                ).encode()
+            )
+        ).decode()
+
+    @staticmethod
+    def load(file: str):
+        contents = json.loads(gzip.decompress(base64.b64decode(file)))
+        return Simulation(
+            contents["map"],
+            contents["playerNames"],
+            contents["game"],
+            contents["version"],
+            datetime.datetime.fromisoformat(contents["timestamp"]),
+            contents["logs"],
+            [base64.b64decode(decision) for decision in contents["decisions"]],
+        )
 
 
 class CodeBattles(
@@ -56,7 +101,7 @@ class CodeBattles(
     """The name of the players. This is populated before any of the overridable methods run."""
     map: str
     """The name of the map. This is populated before any of the overridable methods run."""
-    map_image: Image
+    map_image: "js.Image"
     """The map image. This is populated before any of the overridable methods run."""
     canvas: GameCanvas
     """The game's canvas. Useful for the :func:`render` method. This is populated before any of the overridable methods run, but it isn't populated for background simulations, so you should only use it in :func:`render`."""
@@ -79,7 +124,9 @@ class CodeBattles(
     _player_globals: List[Dict[str, Any]]
     _initialized: bool
     _eliminated: List[int]
-    _sounds: Dict[str, Audio] = {}
+    _sounds: Dict[str, "js.Audio"] = {}
+    _decisions: List[bytes]
+    _since_last_render: int
 
     def render(self) -> None:
         """
@@ -191,12 +238,12 @@ class CodeBattles(
 
         return 1
 
-    def configure_map_image_url(self, map: str):
+    def configure_map_image_url(self, map: str) -> str:
         """The URL containing the map image for the given map. By default, this takes the lowercase, replaces spaces with _ and loads from `/images/maps` which is stored in `public/images/maps` in a project."""
 
         return "/images/maps/" + map.lower().replace(" ", "_") + ".png"
 
-    def configure_sound_url(self, name: str):
+    def configure_sound_url(self, name: str) -> str:
         """The URL containing the sound for the given name. By default, this takes the lowercase, replaces spaces with _ and loads from `/sounds` which is stored in `public/sounds` in a project."""
 
         return "/sounds/" + name.lower().replace(" ", "_") + ".mp3"
@@ -206,6 +253,14 @@ class CodeBattles(
 
         return "CodeBattlesBot"
 
+    def configure_render_rate(self, playback_speed: float) -> int:
+        """
+        The amount of frames to simulate before each render.
+
+        For games with an intensive `render` method, this is useful for higher playback speeds.
+        """
+        return 1
+
     def configure_bot_globals(self) -> Dict[str, Any]:
         """
         Configure additional available global items, such as libraries from the Python standard library, bots can use.
@@ -224,14 +279,19 @@ class CodeBattles(
             "random": random,
         }
 
+    def configure_version(self) -> str:
+        """Configure the version of the game, which is stored in the simulation files."""
+        return "1.0.0"
+
     @web_only
     def download_images(
         self, sources: List[Tuple[str, str]]
-    ) -> asyncio.Future[Dict[str, Image]]:
+    ) -> asyncio.Future[Dict[str, "js.Image"]]:
         """
         :param sources: A list of ``(image_name, image_url)`` to download.
         :returns: A future which can be ``await``'d containing a dictionary mapping each ``image_name`` to its loaded image.
         """
+        from js import Image
 
         remaining_images: List[str] = []
         result = asyncio.Future()
@@ -268,6 +328,7 @@ class CodeBattles(
     @web_only
     async def load_font(self, name: str, url: str) -> None:
         """Loads the font from the specified url as the specified name."""
+        from js import FontFace, document
 
         ff = FontFace.new(name, f"url({url})")
         await ff.load()
@@ -334,7 +395,7 @@ class CodeBattles(
 
         For game-global log entries (not coming from a specific player), don't specify a ``player_index``.
         """
-        if is_web:
+        if is_web():
             console_log(-1 if player_index is None else player_index, text, color)
         else:
             self._logs.append(
@@ -349,6 +410,7 @@ class CodeBattles(
     @web_only
     def play_sound(self, sound: str):
         """Plays the given sound, from the URL given by :func:`configure_sound_url`."""
+        from js import window, Audio
 
         if sound not in self._sounds:
             self._sounds[sound] = Audio.new(self.configure_sound_url(sound))
@@ -356,7 +418,16 @@ class CodeBattles(
         volume = window.localStorage.getItem("Volume") or 0
         s = self._sounds[sound].cloneNode(True)
         s.volume = volume
-        s.play()
+
+        async def p():
+            try:
+                await s.play()
+            except Exception:
+                print(
+                    f"Warning: couldn't play sound '{sound}'. Make sure the `sound` and `configure_sound_url` are correct."
+                )
+
+        asyncio.get_event_loop().run_until_complete(p())
 
     @property
     def time(self) -> str:
@@ -370,7 +441,11 @@ class CodeBattles(
 
         return len(self.active_players) <= 1
 
+    @web_only
     def _initialize(self):
+        from js import window, document
+        from pyscript.ffi import create_proxy
+
         window.addEventListener("resize", create_proxy(lambda _: self._resize_canvas()))
         document.getElementById("playpause").onclick = create_proxy(
             lambda _: asyncio.get_event_loop().run_until_complete(self._play_pause())
@@ -383,6 +458,9 @@ class CodeBattles(
 
     def _initialize_simulation(self, player_codes: List[str]):
         self.step = 0
+        self._logs = []
+        self._decisions = []
+        self._decision_index = 0
         self.active_players = list(range(len(self.player_names)))
         self.active_players = list(range(len(self.player_names)))
         self.state = self.create_initial_state()
@@ -392,6 +470,39 @@ class CodeBattles(
         ]
         self._eliminated = []
         self._player_globals = self._get_initial_player_globals(player_codes)
+        self._since_last_render = 1
+        self._start_time = time.time()
+
+    def _run_webworker_simulation(
+        self, map: str, player_names_str: str, player_codes_str: str
+    ):
+        from pyscript import sync
+
+        # JS to Python
+        player_names = json.loads(player_names_str)
+        player_codes = json.loads(player_codes_str)
+
+        self.map = map
+        self.player_names = player_names
+        self.background = True
+        self.console_visible = False
+        self.verbose = False
+        self._initialize_simulation(player_codes)
+        while not self.over:
+            self._logs = []
+            decisions = self.make_decisions()
+            logs = self._logs
+            self._logs = []
+            self.apply_decisions(decisions)
+
+            sync.update_step(
+                base64.b64encode(decisions).decode(),
+                json.dumps(logs),
+                "true" if self.over else "false",
+            )
+
+            if not self.over:
+                self.step += 1
 
     def _run_local_simulation(self):
         self.map = sys.argv[1]
@@ -399,7 +510,6 @@ class CodeBattles(
         self.background = True
         self.console_visible = False
         self.verbose = False
-        self._logs = []
         player_codes = []
         for filename in sys.argv[3:]:
             with open(filename, "r") as f:
@@ -432,6 +542,72 @@ class CodeBattles(
         loop = asyncio.get_event_loop()
         loop.run_until_complete(self._start_simulation_async(*args, **kwargs))
 
+    def _start_simulation_from_file(self, contents: str):
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._start_simulation_from_file_async(contents))
+
+    async def _start_simulation_from_file_async(self, contents: str):
+        from js import document
+
+        try:
+            simulation = Simulation.load(str(contents))
+            navigate(
+                f"/simulation/{simulation.map}/{'-'.join(simulation.player_names)}"
+            )
+            show_alert(
+                "Loaded simulation file!",
+                f"{', '.join(simulation.player_names)} competed in {simulation.map} at {simulation.timestamp}",
+                "blue",
+                "fa-solid fa-file-code",
+                0,
+            )
+            if simulation.game != self.__class__.__name__:
+                show_alert(
+                    "Warning: game mismatch!",
+                    f"Simulation file is for game {simulation.game} while the website is running {self.__class__.__name__}!",
+                    "yellow",
+                    "fa-solid fa-exclamation",
+                    0,
+                )
+            if simulation.version != self.configure_version():
+                show_alert(
+                    "Warning: version mismatch!",
+                    f"Simulation file is for version {simulation.version} while the website is running {self.configure_version()}!",
+                    "yellow",
+                    "fa-solid fa-exclamation",
+                    0,
+                )
+            while document.getElementById("loader") is None:
+                await asyncio.sleep(0.01)
+            if not hasattr(self, "_initialized"):
+                self._initialize()
+            self.map = simulation.map
+            self.map_image = await download_image(
+                self.configure_map_image_url(simulation.map)
+            )
+            self.player_names = simulation.player_names
+            self.background = False
+            self.console_visible = True
+            self.verbose = False
+            self._initialize_simulation(["" for _ in simulation.player_names])
+            self._decisions = simulation.decisions
+            self._logs = simulation.logs
+            self.canvas = GameCanvas(
+                document.getElementById("simulation"),
+                self.configure_board_count(),
+                self.map_image,
+                document.body.clientWidth - 440,
+                document.body.clientHeight - 280,
+                self.configure_extra_width(),
+                self.configure_extra_height(),
+            )
+            document.getElementById("loader").style.display = "none"
+            await self.setup()
+            self.render()
+        except Exception as e:
+            print(e)
+
+    @web_only
     async def _start_simulation_async(
         self,
         map: str,
@@ -441,7 +617,18 @@ class CodeBattles(
         console_visible: bool,
         verbose: bool,
     ):
+        from js import document
+        from pyscript import workers
+
+        # JS to Python
+        player_names = [str(x) for x in player_names]
+        player_codes = [str(x) for x in player_codes]
+
         try:
+            render_status = document.getElementById("render-status")
+            if render_status is not None:
+                render_status.textContent = "Rendering: Initializing..."
+
             self.map = map
             self.player_names = player_names
             self.map_image = await download_image(self.configure_map_image_url(map))
@@ -458,7 +645,9 @@ class CodeBattles(
                     document.body.clientWidth - 440
                     if console_visible
                     else document.body.clientWidth - 40,
-                    document.body.clientHeight - 280,
+                    document.body.clientHeight - 280
+                    if console_visible
+                    else document.body.clientHeight - 160,
                     self.configure_extra_width(),
                     self.configure_extra_height(),
                 )
@@ -472,11 +661,52 @@ class CodeBattles(
                 document.getElementById("loader").style.display = "none"
                 self.render()
 
+                self._worker = await workers["worker"]
+                self._worker.update_step = self._update_step
+                self._worker._run_webworker_simulation(
+                    map, json.dumps(player_names), json.dumps(player_codes)
+                )
+
             if self.background:
                 await self._play_pause()
         except Exception:
             traceback.print_exc()
 
+    def _update_step(self, decisions_str: str, logs_str: str, is_over_str: str):
+        from js import window, document
+
+        now = time.time()
+        decisions = base64.b64decode(str(decisions_str))
+        logs: list = json.loads(str(logs_str))
+        is_over = str(is_over_str) == "true"
+
+        self._decisions.append(decisions)
+        self._logs.append(logs)
+
+        if is_over:
+            try:
+                simulation = Simulation(
+                    self.map,
+                    self.player_names,
+                    self.__class__.__name__,
+                    self.configure_version(),
+                    datetime.datetime.now(),
+                    self._logs,
+                    self._decisions,
+                )
+                window.simulationToDownload = simulation.dump()
+                show_download()
+            except Exception as e:
+                print(e)
+
+        render_status = document.getElementById("render-status")
+        if render_status is not None:
+            render_status.textContent = (
+                f"Rendering: Complete! ({int(now - self._start_time)}s)"
+                if is_over
+                else f"Rendering: Frame {len(self._decisions)} ({int(now - self._start_time)}s)"
+            )
+
     def _get_initial_player_globals(self, player_codes: List[str]):
         contexts = [
             self.create_api_implementation(i) for i in range(len(self.player_names))
@@ -542,7 +772,10 @@ class CodeBattles(
 
         return player_globals
 
+    @web_only
     def _resize_canvas(self):
+        from js import document
+
         if not hasattr(self, "canvas"):
             return
 
@@ -550,14 +783,33 @@ class CodeBattles(
             document.body.clientWidth - 440
             if self.console_visible
             else document.body.clientWidth - 40,
-            document.body.clientHeight - 280,
+            document.body.clientHeight - 280
+            if self.console_visible
+            else document.body.clientHeight - 160,
         )
         if not self.background:
             self.render()
 
+    @web_only
     def _step(self):
+        from js import document, setTimeout
+        from pyscript.ffi import create_proxy
+
         if not self.over:
-            self.apply_decisions(self.make_decisions())
+            if len(self._decisions) == self._decision_index:
+                print("Warning: sleeping because decisions were not made yet!")
+                setTimeout(create_proxy(self._step), 100)
+                return
+            else:
+                logs = self._logs[self._decision_index]
+                for log in logs:
+                    console_log(
+                        -1 if log["player_index"] is None else log["player_index"],
+                        log["text"],
+                        log["color"],
+                    )
+                self.apply_decisions(self._decisions[self._decision_index])
+                self._decision_index += 1
 
         if not self.over:
             self.step += 1
@@ -568,9 +820,17 @@ class CodeBattles(
             set_results(
                 self.player_names, self._eliminated[::-1], self.map, self.verbose
             )
+            self.render()
 
         if not self.background:
-            self.render()
+            if self._since_last_render >= self.configure_render_rate(
+                self._get_playback_speed()
+            ):
+                self.render()
+                self._since_last_render = 1
+            else:
+                self._since_last_render += 1
+
             if (
                 self.over
                 and "Pause" in document.getElementById("playpause").textContent
@@ -585,7 +845,10 @@ class CodeBattles(
             if self.over:
                 document.getElementById("noui-progress").style.display = "none"
 
+    @web_only
     def _should_play(self):
+        from js import document
+
         if self.over:
             return False
 
@@ -600,7 +863,10 @@ class CodeBattles(
 
         return True
 
+    @web_only
     def _get_playback_speed(self):
+        from js import document
+
         return 2 ** float(
             document.getElementById("timescale")
             .getElementsByClassName("mantine-Slider-thumb")
@@ -608,7 +874,10 @@ class CodeBattles(
             .ariaValueNow
         )
 
+    @web_only
     def _get_breakpoint(self):
+        from js import document
+
         breakpoint_element = document.getElementById("breakpoint")
         if breakpoint_element is None or breakpoint_element.value == "":
             return -1

package/dist/code_battles/js.pyi

@@ -15,6 +15,7 @@ class TwoDContext:
     font: str
     fillStyle: str
     strokeStyle: str
+    lineWidth: int
 
     @staticmethod
     def beginPath(): ...
@@ -28,6 +29,10 @@ class TwoDContext:
         counterclockwise=False,
     ): ...
     @staticmethod
+    def moveTo(x: int, y: int): ...
+    @staticmethod
+    def lineTo(x: int, y: int): ...
+    @staticmethod
     def stroke(): ...
     @staticmethod
     def fill(): ...

package/dist/code_battles/pyscript/__init__.pyi

@@ -0,0 +1,4 @@
+from typing import Literal
+
+class PyWorker:
+    def __init__(self, path: str, type: Literal["micropython", "pyodide"]): ...

package/dist/code_battles/utilities.py

@@ -2,10 +2,39 @@
 
 import asyncio
 import math
+import sys
 from typing import Callable, List, Union
 from enum import Enum
 
-from js import Element, Image, window
+try:
+    import js
+except Exception:
+    pass
+
+
+def is_worker():
+    try:
+        from js import window  # noqa: F401
+
+        return False
+    except Exception:
+        return True
+
+
+def is_web():
+    return (
+        "MicroPython" in sys.version or "pyodide" in sys.executable
+    ) and not is_worker()
+
+
+def web_only(method):
+    if is_web():
+        return method
+
+    def wrapper(*args, **kwargs):
+        print(f"Warning: {method.__name__} should only be called in a web context.")
+
+    return wrapper
 
 
 class Alignment(Enum):
@@ -13,7 +42,10 @@ class Alignment(Enum):
     TOP_LEFT = 1
 
 
-def download_image(src: str) -> Image:
+@web_only
+def download_image(src: str):
+    from js import Image
+
     result = asyncio.Future()
     image = Image.new()
     image.onload = lambda _: result.set_result(image)
@@ -24,14 +56,22 @@ def download_image(src: str) -> Image:
 def show_alert(
     title: str, alert: str, color: str, icon: str, limit_time: int = 5000, is_code=True
 ):
-    if hasattr(window, "showAlert"):
-        try:
-            window.showAlert(title, alert, color, icon, limit_time, is_code)
-        except Exception as e:
-            print(e)
+    if is_web():
+        from js import window
 
+        if hasattr(window, "showAlert"):
+            try:
+                window.showAlert(title, alert, color, icon, limit_time, is_code)
+            except Exception as e:
+                print(e)
+    else:
+        print(f"[ALERT] {title}: {alert}")
 
+
+@web_only
 def set_results(player_names: List[str], places: List[int], map: str, verbose: bool):
+    from js import window
+
     if hasattr(window, "setResults"):
         try:
             window.setResults(player_names, places, map, verbose)
@@ -39,7 +79,32 @@ def set_results(player_names: List[str], places: List[int], map: str, verbose: b
             print(e)
 
 
+@web_only
+def show_download():
+    from js import window
+
+    if hasattr(window, "showDownload"):
+        try:
+            window.showDownload()
+        except Exception as e:
+            print(e)
+
+
+@web_only
+def navigate(route: str):
+    from js import window
+
+    if hasattr(window, "_navigate"):
+        try:
+            window._navigate(route)
+        except Exception as e:
+            print(e)
+
+
+@web_only
 def download_json(filename: str, contents: str):
+    from js import window
+
     if hasattr(window, "downloadJson"):
         try:
             window.downloadJson(filename, contents)
@@ -47,7 +112,10 @@ def download_json(filename: str, contents: str):
             print(e)
 
 
+@web_only
 def console_log(player_index: int, text: str, color: str):
+    from js import window
+
     if hasattr(window, "consoleLog"):
         try:
             window.consoleLog(player_index, text, color)
@@ -71,9 +139,9 @@ class GameCanvas:
 
     def __init__(
         self,
-        canvas: Element,
+        canvas: "js.Element",
         player_count: int,
-        map_image: Image,
+        map_image: "js.Image",
         max_width: int,
         max_height: int,
         extra_width: int,
@@ -89,7 +157,7 @@ class GameCanvas:
 
     def draw_element(
         self,
-        image: Image,
+        image: "js.Image",
         x: int,
         y: int,
         width: int,
@@ -143,6 +211,26 @@ class GameCanvas:
         self.context.fillStyle = color
         self.context.fillText(text, x, y)
 
+    def draw_line(
+        self,
+        start_x: int,
+        start_y: int,
+        end_x: int,
+        end_y: int,
+        stroke="black",
+        stroke_width=10,
+        board_index=0,
+    ):
+        start_x, start_y = self._translate_position(board_index, start_x, start_y)
+        end_x, end_y = self._translate_position(board_index, end_x, end_y)
+
+        self.context.strokeStyle = stroke
+        self.context.lineWidth = stroke_width * self._scale
+        self.context.beginPath()
+        self.context.moveTo(start_x, start_y)
+        self.context.lineTo(end_x, end_y)
+        self.context.stroke()
+
     def draw_circle(
         self,
         x: int,
@@ -150,6 +238,7 @@ class GameCanvas:
         radius: float,
         fill="black",
         stroke="transparent",
+        stroke_width=2,
         board_index=0,
     ):
         """
@@ -157,8 +246,10 @@ class GameCanvas:
         """
 
         x, y = self._translate_position(board_index, x, y)
+
         self.context.fillStyle = fill
         self.context.strokeStyle = stroke
+        self.context.lineWidth = stroke_width * self._scale
         self.context.beginPath()
         self.context.arc(x, y, radius * self._scale, 0, 2 * math.pi)
         self.context.stroke()
@@ -187,6 +278,8 @@ class GameCanvas:
         return self.map_image.width * self.player_count
 
     def _fit_into(self, max_width: int, max_height: int):
+        from js import window
+
         if self.map_image.width == 0 or self.map_image.height == 0:
             raise Exception("Map image invalid!")
         aspect_ratio = (self.map_image.width * self.player_count + self.extra_width) / (

package/dist/code_battles/worker.py

@@ -0,0 +1,6 @@
+def run_game(game):
+    # game = pickle.loads(game)
+    print("Hi", game, type(game))  # game.player_names)
+
+
+__export__ = ["run_game"]

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 import '@mantine/core/styles.css';
 import '@mantine/dates/styles.css';
 import '@mantine/notifications/styles.css';
+import '@mantine/dropzone/styles.css';
 import { TextInput, Button, Alert, Slider, Box, Select, NumberInput, Table, Badge, Autocomplete, Loader, MantineProvider } from '@mantine/core';
 import { TimeInput, DatesProvider } from '@mantine/dates';
 import { useColorScheme, useViewportSize } from '@mantine/hooks';
@@ -10,6 +11,7 @@ import { onAuthStateChanged, signInWithEmailAndPassword, signOut, getAuth } from
 import { onSnapshot, refEqual, doc, getDoc, setDoc, Timestamp, getFirestore } from 'firebase/firestore';
 import React, { useEffect, useReducer, useCallback, useMemo, createContext, useContext, useState, useRef, cloneElement, Component, createElement } from 'react';
 import { useNavigate, useLocation, useParams, Routes, Route, BrowserRouter } from 'react-router-dom';
+import { Dropzone } from '@mantine/dropzone';
 import { jsx } from 'react/jsx-runtime';
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -409,19 +411,28 @@ const toPlacing = (n) => {
 };
 const runNoUI = (map, apis, playerBots, verbose) => {
     const players = playerBots.map((api) => (api === "None" ? "" : apis[api]));
-    tryUntilFailure(() => 
+    tryUntilSuccess(() => 
     // @ts-ignore
     window._startSimulation(map, players, playerBots, true, false, verbose));
 };
-const tryUntilFailure = (f, timeout = 500) => {
+const tryUntilSuccess = (f, timeout = 500) => {
     try {
         f();
     }
     catch (error) {
         console.log("Failed, waiting for timeout...", error === null || error === void 0 ? void 0 : error.message);
-        setTimeout(() => tryUntilFailure(f, timeout), timeout);
+        setTimeout(() => tryUntilSuccess(f, timeout), timeout);
     }
 };
+const downloadFile = (filename, mimeType, contents) => {
+    const a = document.createElement("a");
+    a.style.display = "none";
+    document.body.appendChild(a);
+    a.href = `data:${mimeType};charset=utf-8,${encodeURIComponent(contents)}`;
+    a.download = filename;
+    a.click();
+    document.body.removeChild(a);
+};
 
 const useLocalStorage = ({ key, defaultValue, }) => {
     const [value, setValue] = useState(getLocalStorage(key, defaultValue !== null && defaultValue !== void 0 ? defaultValue : null));
@@ -2499,6 +2510,8 @@ const RunSimulationBlock = () => {
         remaining = Math.max(...Object.values(runningNoUIN));
     }
     const run = () => {
+        // @ts-ignore
+        window._isSimulationFromFile = false;
         navigate(`/simulation/${map.replaceAll(" ", "-")}/${playerBots.join("-")}`);
     };
     const startRunNoUI = () => {
@@ -2581,7 +2594,31 @@ const RunSimulationBlock = () => {
         remaining !== 0 && (React.createElement("p", { style: { textAlign: "center", marginTop: 10 } },
             "Remaining Simulations: ",
             remaining)),
-        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" })));
+        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" }),
+        React.createElement(Dropzone, { mt: "xs", multiple: false, onDrop: (files) => __awaiter(void 0, void 0, void 0, function* () {
+                if (files.length !== 1) {
+                    return;
+                }
+                const file = files[0];
+                const text = yield file.text();
+                // @ts-ignore
+                window._navigate = navigate;
+                // @ts-ignore
+                window._isSimulationFromFile = true;
+                tryUntilSuccess(() => {
+                    // @ts-ignore
+                    window._startSimulationFromFile(text);
+                });
+            }), style: {
+                textAlign: "center",
+                paddingTop: 20,
+                paddingBottom: 20,
+                paddingLeft: 10,
+                paddingRight: 10,
+            } },
+            React.createElement("span", null,
+                React.createElement("i", { className: "fa-solid fa-file-code", style: { marginRight: 10 } }),
+                "Drag a simulation file here or click to select a file to run a simulation from a file"))));
 };
 
 const TournamentBlock = ({ pointModifier, inline, title }) => {
@@ -15900,12 +15937,17 @@ const Simulation = () => {
     let { map, playerapis } = useParams();
     const location = useLocation();
     const [winner, setWinner] = useState();
+    const [downloadBytes, setDownloadBytes] = useState(false);
     const navigate = useNavigate();
     const colorScheme = useColorScheme();
     const showcaseMode = location.search.includes("showcase=true");
     useEffect(() => {
         n((engine) => __awaiter(void 0, void 0, void 0, function* () { return yield loadFull(engine); }));
         // @ts-ignore
+        window.showDownload = () => {
+            setDownloadBytes(true);
+        };
+        // @ts-ignore
         window.showWinner = (winner, verbose) => {
             if (admin) {
                 setWinner(winner);
@@ -15935,8 +15977,12 @@ const Simulation = () => {
     const playerNames = (_a = playerapis === null || playerapis === void 0 ? void 0 : playerapis.split("-")) !== null && _a !== void 0 ? _a : [];
     const players = playerNames.map((api) => (api === "None" ? "" : apis[api]));
     useEffect(() => {
-        if (!loading && players && playerapis) {
-            tryUntilFailure(() => 
+        if (!loading &&
+            players &&
+            playerapis &&
+            // @ts-ignore
+            window._isSimulationFromFile !== true) {
+            tryUntilSuccess(() => 
             // @ts-ignore
             window._startSimulation(map, players, playerNames, false, !showcaseMode, true));
         }
@@ -16018,9 +16064,14 @@ const Simulation = () => {
                 !location.search.includes("background=true") && (React.createElement(React.Fragment, null,
                     React.createElement("div", { style: { textAlign: "center", flexGrow: 1 } },
                         showcaseMode || (React.createElement(React.Fragment, null,
+                            React.createElement("span", { id: "render-status", style: { marginRight: 10 } }),
                             React.createElement(NumberInput, { id: "breakpoint", label: "Breakpoint", min: 0, leftSection: React.createElement("i", { className: "fa-solid fa-stopwatch" }), display: "inline-block", maw: "35%", mr: "xs" }),
                             React.createElement(Button, { style: { flex: "none" }, my: "xs", w: 100, leftSection: React.createElement("i", { className: "fa-solid fa-wand-magic" }), color: "grape", id: "step", mr: "xs", radius: "20px" }, "Step"))),
-                        React.createElement(PlayPauseButton, null)),
+                        React.createElement(PlayPauseButton, null),
+                        downloadBytes && (React.createElement(Button, { ml: "xs", radius: "20px", leftSection: React.createElement("i", { className: "fa-solid fa-download" }), color: "blue", onClick: () => downloadFile(`${playerNames.join("-")}.btl`, "text/plain", 
+                            // @ts-ignore
+                            window.simulationToDownload) }, "Download Simulation"))),
+                    showcaseMode && React.createElement("span", { id: "render-status" }),
                     React.createElement("p", { style: { margin: 0 } }, "Playback Speed"),
                     React.createElement(Slider, { style: { flex: "none" }, mb: 30, w: 500, maw: "85%", min: -2, defaultValue: 0, marks: [
                             { value: -2, label: "1/4" },

package/dist/esm/types/index.d.ts

@@ -2,6 +2,7 @@ import "@fortawesome/fontawesome-free/css/all.css";
 import "@mantine/core/styles.css";
 import "@mantine/dates/styles.css";
 import "@mantine/notifications/styles.css";
+import "@mantine/dropzone/styles.css";
 import "prismjs/plugins/line-numbers/prism-line-numbers.css";
 import "prismjs/themes/prism.css";
 import "./index.css";

package/dist/esm/types/utilities.d.ts

@@ -11,4 +11,5 @@ export declare const updatePointModifier: () => void;
 export declare const toPlacing: (n: number) => string;
 export declare const zeroPad: (s: string, l: number) => string;
 export declare const runNoUI: (map: string, apis: Record<string, any>, playerBots: string[], verbose: boolean) => void;
-export declare const tryUntilFailure: (f: () => void, timeout?: number) => void;
+export declare const tryUntilSuccess: (f: () => void, timeout?: number) => void;
+export declare const downloadFile: (filename: string, mimeType: string, contents: string) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-battles",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "A library for building interactive competitive coding battles",
   "repository": "https://github.com/noamzaks/code-battles",
   "homepage": "https://code-battles.readthedocs.org",
@@ -38,11 +38,12 @@
     "tsparticles": "^3.5.0"
   },
   "peerDependencies": {
-    "@mantine/core": "^7.13.3",
-    "@mantine/dates": "^7.13.3",
-    "@mantine/hooks": "^7.13.3",
-    "@mantine/notifications": "^7.13.3",
-    "firebase": "^10.14.1",
+    "@mantine/core": "^7.13.4",
+    "@mantine/dates": "^7.13.4",
+    "@mantine/dropzone": "^7.13.4",
+    "@mantine/hooks": "^7.13.4",
+    "@mantine/notifications": "^7.13.4",
+    "firebase": "^11.0.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router-dom": "^6.27.0"
@@ -52,16 +53,16 @@
     "@rollup/plugin-commonjs": "^26.0.3",
     "@rollup/plugin-node-resolve": "^15.3.0",
     "@rollup/plugin-typescript": "^11.1.6",
-    "@types/prismjs": "^1.26.4",
-    "@types/react": "^18.3.11",
+    "@types/prismjs": "^1.26.5",
+    "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
     "chokidar-cli": "^3.0.0",
-    "rollup": "^4.24.0",
+    "rollup": "^4.24.4",
     "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-dts": "^6.1.1",
-    "rollup-plugin-import-css": "^3.5.5",
+    "rollup-plugin-import-css": "^3.5.6",
     "rollup-plugin-peer-deps-external": "^2.2.4",
-    "tslib": "^2.8.0",
+    "tslib": "^2.8.1",
     "typescript": "^5.6.3"
   },
   "prettier": {