jsbeeb 1.17.0 → 1.18.0

package/src/main.js

@@ -10,9 +10,9 @@ import { Debugger } from "./web/debug.js";
 import { Cpu6502, AtomCpu6502 } from "./6502.js";
 import * as utils_atom from "./utils_atom.js";
 import { LoadSD } from "./mmc.js";
-import { Cmos } from "./cmos.js";
+import { Cmos, localStoragePersistence } from "./cmos.js";
 import { StairwayToHell } from "./sth.js";
-import { BbcDiscArchive, describe as describeHfe } from "./bbcdiscs.js";
+import { BbcDiscArchive, Provenance, describe as describeHfe, matches, provenancesIn } from "./bbcdiscs.js";
 import { GamePad } from "./gamepads.js";
 import * as disc from "./fdc.js";
 import { loadTapeFromData } from "./tapes.js";
@@ -31,6 +31,7 @@ import { GamepadSource } from "./gamepad-source.js";
 import { toast } from "./web/toast.js";
 import { MicrophoneInput } from "./microphone-input.js";
 import { SpeechOutput } from "./speech-output.js";
+import { Printer } from "./printer.js";
 import { MouseJoystickSource } from "./mouse-joystick-source.js";
 import { calculateMouseCoordinates } from "./mouse-coordinates.js";
 import { getFilterForMode } from "./canvas.js";
@@ -208,19 +209,16 @@ if (parsedQuery.audiofilterq !== undefined) audioFilterQ = parsedQuery.audiofilt
 if (parsedQuery.stationId !== undefined) stationId = parsedQuery.stationId;
 if (parsedQuery.frameSkip !== undefined) frameSkip = parsedQuery.frameSkip;
 
-const printerPort = {
-    outputStrobe: function (level, output) {
-        if (!printerTextArea) return;
-        if (!output || level) return;
-
-        const uservia = processor.uservia;
-        // Ack the character by pulsing CA1 low.
-        uservia.setca1(false);
-        uservia.setca1(true);
-        const newChar = String.fromCharCode(uservia.ora);
-        printerTextArea.value += newChar;
+const printer = new Printer({
+    onOutput: (char) => {
+        if (printerTextArea) printerTextArea.value += char;
     },
-};
+    onFirstOutput: () =>
+        toast("Printer output is being kept. Press Ctrl-B to open the printer window.", {
+            title: "Printer",
+            quietKey: "quietPrinterOutput",
+        }),
+});
 
 // Accessibility switch state — bits 0-7 correspond to switches 1-8.
 // Active low: 0xff = no switches pressed; clearing a bit = that switch is pressed.
@@ -335,7 +333,7 @@ const emulationConfig = {
     // before any the user asked for with ?rom=.
     extraRoms: [...config.extraRoms, ...extraRoms],
     userPort,
-    printerPort,
+    printerPort: printer,
     getGamepads: function () {
         // Gamepads are only available in secure contexts. If e.g. loading from http:// urls they aren't there.
         return navigator.getGamepads ? navigator.getGamepads() : [];
@@ -399,6 +397,24 @@ function showError(context, error) {
 
 const errorText = (error) => error?.message ?? `${error}`;
 
+function reportLoadFailure(description, error) {
+    console.error(`Error loading ${description}:`, error);
+    toast(`Could not load ${description}: ${errorText(error)}`, { title: "Loading" });
+}
+
+function reportIgnoredFiles(name, ignored) {
+    if (!ignored.length) return;
+    toast(`Loaded ${name}. The archive also holds ${ignored.join(", ")}, and only one file is loaded from it.`, {
+        title: "Archive",
+    });
+}
+
+async function unzipAndReport(data) {
+    const unzipped = await utils.unzipDiscImage(data);
+    reportIgnoredFiles(unzipped.name, unzipped.ignored);
+    return unzipped;
+}
+
 function showNotice(event) {
     const { message, title, quietKey } = event.detail;
     toast(message, { title, quietKey });
@@ -433,10 +449,25 @@ function putDiscIn(driveIndex, loadedDisc) {
     const was = drive.tracksPerStep;
     processor.fdc.loadDisc(driveIndex, loadedDisc, fixed);
     showDriveTracks(driveIndex);
+    noteUnsavedWrites(loadedDisc);
     // A switch the user fixed does not move, so anything it does is not news.
     if (fixed === undefined && drive.tracksPerStep !== was) noteDriveTracks(driveIndex, loadedDisc.name);
 }
 
+let saidWritesAreNotKept = false;
+
+function noteUnsavedWrites(loadedDisc) {
+    if (loadedDisc.savesChanges || saidWritesAreNotKept) return;
+    loadedDisc.notifyOnFirstTrackWrite(() => {
+        if (saidWritesAreNotKept) return;
+        saidWritesAreNotKept = true;
+        toast(`Changes to ${loadedDisc.name} are not saved. Use Discs, Download to keep a copy.`, {
+            title: "Disc",
+            quietKey: "quietDiscNotSaved",
+        });
+    });
+}
+
 const tracksPerStepFor = (tracks) => (tracks === "40" ? 2 : 1);
 
 function showDriveTracks(driveIndex) {
@@ -458,59 +489,57 @@ function noteDriveTracks(driveIndex, discName) {
     });
 }
 
-function createCanvasForFilter(filterClass) {
+// Test which filter is actually in use, not merely whether we got WebGL: a
+// filter can decline a context that works perfectly well for other modes, in
+// which case we are quietly left with an unfiltered display.
+function reportAnyFallback(displayCanvas, filterClass) {
+    if (displayCanvas.filterClass === filterClass) return;
+    const reason = displayCanvas.fallbackReason ? ` (${displayCanvas.fallbackReason})` : "";
+    const { name } = filterClass.getDisplayConfig();
+    toast(`${name} is not available on this device, so the standard display is in use${reason}.`, {
+        title: "Display",
+        quietKey: "quietDisplayFallback",
+    });
+}
+
+function sizeCanvasFor(filterClass) {
     // Not `config`: that is the emulator's live configuration object, declared
     // at module scope and used throughout this file.
     const displayConfig = filterClass.getDisplayConfig();
-    // Each mode says how many pixels it wants to draw into. Set this before
-    // creating the context, which fixes its initial viewport.
+    if (screenCanvas.width === displayConfig.canvasWidth && screenCanvas.height === displayConfig.canvasHeight) return;
     screenCanvas.width = displayConfig.canvasWidth;
     screenCanvas.height = displayConfig.canvasHeight;
+}
 
-    const newCanvas = tryGl ? canvasLib.bestCanvas(screenCanvas, filterClass) : new canvasLib.Canvas(screenCanvas);
-
-    // Test which filter was actually built, not merely whether we got WebGL: a
-    // filter can decline a context that works perfectly well for other modes,
-    // in which case bestCanvas quietly gives us an unfiltered GL canvas.
-    if (newCanvas.filterClass !== filterClass) {
-        const reason = newCanvas.fallbackReason ? ` (${newCanvas.fallbackReason})` : "";
-        toast(`${displayConfig.name} is not available on this device, so the standard display is in use${reason}.`, {
-            title: "Display",
-            quietKey: "quietDisplayFallback",
-        });
-    }
+function createCanvasForFilter(filterClass) {
+    // Each mode says how many pixels it wants to draw into. Set this before
+    // creating the context, which fixes its initial viewport.
+    sizeCanvasFor(filterClass);
 
+    const newCanvas = tryGl ? canvasLib.bestCanvas(screenCanvas, filterClass) : new canvasLib.Canvas(screenCanvas);
+    reportAnyFallback(newCanvas, filterClass);
     return newCanvas;
 }
 
 let displayModeFilter = canvasLib.getFilterForMode(parsedQuery.displayMode || "rgb");
 function swapCanvas(newFilterClass) {
-    const oldCanvas = canvas;
-    const newCanvas = createCanvasForFilter(newFilterClass);
-    // Carry the picture over; the buffers differ in height, so copy what fits.
-    newCanvas.fb32.set(oldCanvas.fb32.subarray(0, newCanvas.fb32.length));
-    // Only once the replacement exists, so a failure to build it leaves the
-    // display we already had. The two share a GL context but no GL objects.
-    oldCanvas.dispose();
-    video.fb32 = newCanvas.fb32;
-    video.paint_ext = function paint(minx, miny, maxx, maxy) {
-        frames++;
-        if (frames < frameSkip) return;
-        frames = 0;
-        newCanvas.paint(minx, miny, maxx, maxy, { frameCount: this.frameCount, lineGrid: this.lineGrid });
-    };
-    canvas = newCanvas;
+    // Everything but the filter is the same whatever the mode: the framebuffer
+    // texture, the vertex buffers and fb32 all carry over untouched.
+    canvasLib.useBestFilter(canvas, newFilterClass);
+    reportAnyFallback(canvas, newFilterClass);
     // Follow the filter we ended up with, not the one we asked for: everything
-    // downstream — the monitor picture, the canvas geometry, how large a
-    // drawing buffer to ask for — comes from its display config.
-    displayModeFilter = newCanvas.filterClass;
+    // downstream (the monitor picture, the canvas geometry, how large a drawing
+    // buffer to ask for) comes from its display config.
+    displayModeFilter = canvas.filterClass;
+    // Back to the mode's own size, undoing any scaling the last one asked for.
+    sizeCanvasFor(displayModeFilter);
     // Nothing else will redraw: the mode is changed from a modal, which stops
     // the emulator.
     video.paint();
     window.setTimeout(() => window.dispatchEvent(new Event("resize")), 1);
 }
 
-let canvas = createCanvasForFilter(displayModeFilter);
+const canvas = createCanvasForFilter(displayModeFilter);
 displayModeFilter = canvas.filterClass;
 
 video = new Video(
@@ -628,14 +657,19 @@ pastetext.addEventListener("dragover", function (event) {
 pastetext.addEventListener("drop", async function (event) {
     utils.noteEvent("local", "drop");
     const file = event.dataTransfer.files[0];
-    const arrayBuffer = await file.arrayBuffer();
-    if (isSnapshotFile(file.name, arrayBuffer)) {
-        await loadStateFromFile(file, arrayBuffer);
-    } else if (file.name.toLowerCase().endsWith(".uef")) {
-        // Regular UEF tape image (not a BeebEm save state)
-        setProcessorTape(await loadTapeFromData(file.name, new Uint8Array(arrayBuffer), model));
-    } else {
-        await loadHTMLFile(file);
+    if (!file) return;
+    try {
+        const arrayBuffer = await file.arrayBuffer();
+        if (isSnapshotFile(file.name, arrayBuffer)) {
+            await loadStateFromFile(file, arrayBuffer);
+        } else if (file.name.toLowerCase().endsWith(".uef")) {
+            // Regular UEF tape image (not a BeebEm save state)
+            setProcessorTape(await loadTapeFromData(file.name, new Uint8Array(arrayBuffer), model));
+        } else {
+            await loadHTMLFile(file);
+        }
+    } catch (error) {
+        reportLoadFailure(file.name, error);
     }
 });
 
@@ -725,17 +759,14 @@ if (config.hasEconet) {
 }
 
 const cmos = new Cmos(
-    {
-        load: function () {
-            if (window.localStorage.cmosRam) {
-                return JSON.parse(window.localStorage.cmosRam);
-            }
-            return null;
-        },
-        save: function (data) {
-            window.localStorage.cmosRam = JSON.stringify(data);
-        },
-    },
+    localStoragePersistence(
+        () => window.localStorage,
+        (error) =>
+            toast(
+                `Settings changed with *CONFIGURE will not be kept (${errorText(error)}). Check that this site is allowed to store data, and that its storage is not full.`,
+                { title: "Settings", quietKey: "quietCmosSave" },
+            ),
+    ),
     model.cmosOverride,
     econet,
 );
@@ -747,12 +778,17 @@ function checkPrinterWindow() {
     if (printerWindow && !printerWindow.closed) return;
 
     printerWindow = window.open("", "_blank", "height=300,width=400");
+    if (!printerWindow) {
+        toast("The printer output window was blocked. Allow pop-up windows for this site, then press Ctrl-B again.", {
+            title: "Printer",
+        });
+        return;
+    }
     printerWindow.document.write(
         '<textarea id="text" rows="15" cols="40" placeholder="Printer outputs here..."></textarea>',
     );
     printerTextArea = printerWindow.document.getElementById("text");
-
-    processor.uservia.setca1(true);
+    printerTextArea.value = printer.text;
 }
 
 const CpuClass = model.isAtom ? AtomCpu6502 : Cpu6502;
@@ -768,6 +804,8 @@ processor = new CpuClass(model, {
     econet,
 });
 
+printer.attach(processor.uservia);
+
 processor.teletextAdaptor?.addEventListener("notice", showNotice);
 
 // Create input sources
@@ -1178,13 +1216,13 @@ async function hfeClick(file) {
     const name = describeHfe(file).title;
     popupLoading("Loading " + name);
     try {
-        const disc = await loadDiscImage(parsedQuery.disc1);
-        processor.fdc.loadDisc(0, disc);
+        const loaded = await loadDiscImage(parsedQuery.disc1, layoutForDrive(0));
+        putDiscIn(0, loaded);
         loadingFinished();
         if (needsAutoboot) autoboot(name);
     } catch (err) {
         console.error("Error loading disc image:", err);
-        loadingFinished(err);
+        loadingFinished(`Unable to load ${name} from the HFE archive: ${errorText(err)}`);
     }
 }
 
@@ -1194,13 +1232,15 @@ function hfeOnCat(catalogue) {
     const list = document.getElementById("hfe-list");
     document.querySelector("#hfe .loading").style.display = "none";
     const template = list.querySelector(".template");
+    showProvenanceChoices(catalogue, onHfeFilter);
 
     const addSome = (remaining) => {
         if (ticket !== hfeRender) return;
         const MaxAtATime = 100;
         const Delay = 30;
-        // Read per batch: the filter can be typed into while this is still going.
+        // Read per batch: both can be changed while this is still going.
         const filter = document.getElementById("hfe-filter").value.toLowerCase();
+        const shown = shownProvenances();
         for (const file of remaining.slice(0, MaxAtATime)) {
             const { title, publisher, detail } = describeHfe(file);
             const row = template.cloneNode(true);
@@ -1208,6 +1248,8 @@ function hfeOnCat(catalogue) {
             row.querySelector(".name").textContent = title;
             row.querySelector(".publisher").textContent = publisher;
             row.querySelector(".detail").textContent = detail;
+            row.querySelector(".provenance").textContent =
+                file.provenance === Provenance.Reconstructed ? "reconstructed" : "";
             if (file.notes) row.title = file.notes;
             // The row is an anchor, and letting it navigate to "#" would push a
             // history entry of its own on top of the one updateUrl pushes.
@@ -1216,8 +1258,9 @@ function hfeOnCat(catalogue) {
                 hfeClick(file);
                 $hfeModal.hide();
             });
-            row.style.display = row.textContent.toLowerCase().includes(filter) ? "" : "none";
+            row.hfeFile = file;
             list.appendChild(row);
+            showHfeRow(row, file, filter, shown);
         }
         if (remaining.length > MaxAtATime) setTimeout(() => addSome(remaining.slice(MaxAtATime)), Delay);
     };
@@ -1231,7 +1274,53 @@ document.getElementById("hfe").addEventListener("shown.bs.modal", () => {
 document.getElementById("hfe").addEventListener("show.bs.modal", () => hfeArchive.populate());
 
 const hfeFilter = document.getElementById("hfe-filter");
-const onHfeFilter = () => filterArchiveList("hfe-list", hfeFilter.value);
+const hfeProvenance = document.getElementById("hfe-provenance");
+
+const HfeProvenanceLabels = {
+    [Provenance.Captured]: ["Captured", "Direct from disc"],
+    [Provenance.Reconstructed]: ["Reconstructed", "Rebuilt from a sector dump"],
+};
+
+/** Which provenances the picker is showing, or null when it is not offering the choice. */
+const shownProvenances = () => {
+    const boxes = [...hfeProvenance.querySelectorAll("input")];
+    return boxes.length ? new Set(boxes.filter((box) => box.checked).map((box) => box.value)) : null;
+};
+
+// Offer one tick per provenance the archive actually holds, rather than naming
+// them here: a source added later should appear without this having to change.
+function showProvenanceChoices(catalogue, onChange) {
+    const present = provenancesIn(catalogue);
+    // Nothing to choose between: no ticks, and shownProvenances says "all".
+    if (present.length < 2) {
+        hfeProvenance.replaceChildren();
+        return;
+    }
+    const wasShown = shownProvenances();
+    hfeProvenance.replaceChildren(
+        ...present.map((provenance) => {
+            const [text, why] = HfeProvenanceLabels[provenance] ?? [provenance, ""];
+            const label = document.createElement("label");
+            label.title = why;
+            const box = document.createElement("input");
+            box.type = "checkbox";
+            box.value = provenance;
+            box.checked = !wasShown || wasShown.has(provenance);
+            box.addEventListener("change", onChange);
+            label.append(box, text);
+            return label;
+        }),
+    );
+}
+
+const showHfeRow = (row, file, filter, shown) => (row.style.display = matches(file, filter, shown) ? "" : "none");
+
+const onHfeFilter = () => {
+    const filter = hfeFilter.value.toLowerCase();
+    const shown = shownProvenances();
+    for (const row of document.querySelectorAll("#hfe-list li:not(.template)"))
+        showHfeRow(row, row.hfeFile, filter, shown);
+};
 hfeFilter.addEventListener("change", onHfeFilter);
 hfeFilter.addEventListener("keyup", onHfeFilter);
 
@@ -1352,7 +1441,12 @@ async function loadDiscImage(discImage, layout = DiscLayout.auto) {
     discImage = split.image;
     const schema = split.schema;
     if (schema[0] === "!" || schema === "local") {
-        return disc.localDisc(processor.fdc, discImage, layout);
+        return disc.localDisc(processor.fdc, discImage, layout, (error) =>
+            toast(
+                `Browser storage would not take changes to ${discImage} (${errorText(error)}). Use Discs, Download to keep a copy.`,
+                { title: "Disc", quietKey: "quietLocalDiscSaveFailed" },
+            ),
+        );
     }
     // TODO: come up with a decent UX for passing an 'onChange' parameter to each of these.
     // Consider:
@@ -1363,12 +1457,13 @@ async function loadDiscImage(discImage, layout = DiscLayout.auto) {
     switch (schema) {
         case "|":
         case "sth": {
-            const { name, data } = await discSth.fetch(discImage);
+            const { name, data, ignored } = await discSth.fetch(discImage);
+            reportIgnoredFiles(name, ignored);
             return disc.discFor(processor.fdc, name, data, undefined, layout);
         }
 
         case "hfe":
-            return disc.discFor(processor.fdc, discImage, await hfeArchive.fetch(discImage));
+            return disc.discFor(processor.fdc, discImage, await hfeArchive.fetch(discImage), undefined, layout);
 
         case "gd": {
             const splat = discImage.match(/([^/]+)\/?(.*)/);
@@ -1384,7 +1479,7 @@ async function loadDiscImage(discImage, layout = DiscLayout.auto) {
 
         case "data": {
             const arr = Array.prototype.map.call(atob(discImage), (x) => x.charCodeAt(0));
-            const { name, data } = await utils.unzipDiscImage(arr);
+            const { name, data } = await unzipAndReport(arr);
             return disc.discFor(processor.fdc, name, data, undefined, layout);
         }
         case "http":
@@ -1395,7 +1490,7 @@ async function loadDiscImage(discImage, layout = DiscLayout.auto) {
             discImage = new URL(asUrl).pathname;
             let discData = await utils.loadData(asUrl);
             if (/\.zip/i.test(discImage)) {
-                const unzipped = await utils.unzipDiscImage(discData);
+                const unzipped = await unzipAndReport(discData);
                 discData = unzipped.data;
                 discImage = unzipped.name;
             }
@@ -1414,13 +1509,14 @@ async function loadTapeImage(tapeImage) {
     switch (schema) {
         case "|":
         case "sth": {
-            const { name, data } = await tapeSth.fetch(tapeImage);
+            const { name, data, ignored } = await tapeSth.fetch(tapeImage);
+            reportIgnoredFiles(name, ignored);
             return await loadTapeFromData(name, data, model);
         }
 
         case "data": {
             const arr = Array.prototype.map.call(atob(tapeImage), (x) => x.charCodeAt(0));
-            const { name, data } = await utils.unzipDiscImage(arr);
+            const { name, data } = await unzipAndReport(arr);
             return await loadTapeFromData(name, data, model);
         }
 
@@ -1432,7 +1528,7 @@ async function loadTapeImage(tapeImage) {
             tapeImage = new URL(asUrl).pathname;
             let tapeData = await utils.loadData(asUrl);
             if (/\.zip/i.test(tapeImage)) {
-                const unzipped = await utils.unzipDiscImage(tapeData);
+                const unzipped = await unzipAndReport(tapeData);
                 tapeData = unzipped.data;
                 tapeImage = unzipped.name;
             }
@@ -1444,7 +1540,7 @@ async function loadTapeImage(tapeImage) {
             let tapeData = await utils.loadData(tapePath);
             let tapeName = tapeImage;
             if (/\.zip/i.test(tapeName)) {
-                const unzipped = await utils.unzipDiscImage(tapeData);
+                const unzipped = await unzipAndReport(tapeData);
                 tapeData = unzipped.data;
                 tapeName = unzipped.name;
             }
@@ -1457,7 +1553,11 @@ document.getElementById("disc_load").addEventListener("change", async function (
     if (evt.target.files.length === 0) return;
     utils.noteEvent("local", "click"); // NB no filename here
     const file = evt.target.files[0];
-    await loadHTMLFile(file);
+    try {
+        await loadHTMLFile(file);
+    } catch (error) {
+        reportLoadFailure(file.name, error);
+    }
     evt.target.value = ""; // clear so if the user picks the same file again after a reset we get a "change"
 });
 
@@ -1465,7 +1565,11 @@ document.getElementById("fs_load").addEventListener("change", async function (ev
     if (evt.target.files.length === 0) return;
     utils.noteEvent("local", "click"); // NB no filename here
     const file = evt.target.files[0];
-    await loadSCSIFile(file);
+    try {
+        await loadSCSIFile(file);
+    } catch (error) {
+        reportLoadFailure(file.name, error);
+    }
     evt.target.value = ""; // clear so if the user picks the same file again after a reset we get a "change"
 });
 
@@ -1474,17 +1578,21 @@ document.getElementById("tape_load").addEventListener("change", async function (
     const file = evt.target.files[0];
     utils.noteEvent("local", "clickTape"); // NB no filename here
 
-    let tapeData = await readFileAsBinaryString(file);
-    let tapeName = file.name;
-    if (/\.zip/i.test(tapeName)) {
-        const unzipped = await utils.unzipDiscImage(utils.stringToUint8Array(tapeData));
-        tapeData = unzipped.data;
-        tapeName = unzipped.name;
+    try {
+        let tapeData = await readFileAsBinaryString(file);
+        let tapeName = file.name;
+        if (/\.zip/i.test(tapeName)) {
+            const unzipped = await unzipAndReport(utils.stringToUint8Array(tapeData));
+            tapeData = unzipped.data;
+            tapeName = unzipped.name;
+        }
+        setProcessorTape(await loadTapeFromData(tapeName, tapeData, model));
+        delete parsedQuery.tape;
+        updateUrl();
+        bootstrap.Modal.getInstance(document.getElementById("tapes"))?.hide();
+    } catch (error) {
+        reportLoadFailure(file.name, error);
     }
-    setProcessorTape(await loadTapeFromData(tapeName, tapeData, model));
-    delete parsedQuery.tape;
-    updateUrl();
-    bootstrap.Modal.getInstance(document.getElementById("tapes"))?.hide();
 
     evt.target.value = ""; // clear so if the user picks the same file again after a reset we get a "change"
 });
@@ -1578,10 +1686,14 @@ async function gdLoad(cat, layout) {
 
 for (const el of document.querySelectorAll(".if-drive-available")) el.style.display = "none";
 (async () => {
-    const available = await googleDrive.initialise();
-    if (available) {
-        for (const el of document.querySelectorAll(".if-drive-available")) el.style.display = "";
-        await gdAuth(true);
+    try {
+        const available = await googleDrive.initialise();
+        if (available) {
+            for (const el of document.querySelectorAll(".if-drive-available")) el.style.display = "";
+            await gdAuth(true);
+        }
+    } catch (error) {
+        console.log(`Google Drive is unavailable: ${errorText(error)}`);
     }
 })();
 const googleDriveModal = new bootstrap.Modal(googleDriveEl);
@@ -1597,7 +1709,14 @@ googleDriveEl.addEventListener("show.bs.modal", async function () {
     gdLoading.textContent = "Loading...";
     gdLoading.style.display = "";
     for (const el of googleDriveEl.querySelectorAll("li:not(.template)")) el.remove();
-    const cat = await googleDrive.listFiles();
+    let cat;
+    try {
+        cat = await googleDrive.listFiles();
+    } catch (error) {
+        console.error("Error listing Google Drive files:", error);
+        gdLoading.textContent = `Unable to list your Google Drive files: ${errorText(error)}`;
+        return;
+    }
     const dbList = googleDriveEl.querySelector(".list");
     gdLoading.style.display = "none";
     const template = dbList.querySelector(".template");
@@ -1627,7 +1746,11 @@ for (const image of availableImages) {
         utils.noteEvent("images", "click", image.file);
         setDisc1Image(image.file);
         $discsModal.hide();
-        putDiscIn(0, await loadDiscImage(parsedQuery.disc1, layoutForDrive(0)));
+        try {
+            putDiscIn(0, await loadDiscImage(parsedQuery.disc1, layoutForDrive(0)));
+        } catch (error) {
+            reportLoadFailure(`${image.name} (${image.file})`, error);
+        }
     });
 }
 
@@ -1920,8 +2043,7 @@ const startPromise = (async () => {
             try {
                 await load();
             } catch (error) {
-                console.error(`Error loading ${description}:`, error);
-                toast(`Could not load ${description}: ${error?.message ?? error}`, { title: "Loading" });
+                reportLoadFailure(description, error);
             }
         })();
         imageLoads.push(loading);

package/src/printer.js

@@ -0,0 +1,59 @@
+"use strict";
+
+/**
+ * Centronics printer attached to the user VIA: acknowledges each character and keeps the most
+ * recent output so it can be shown whenever a printer window is opened.
+ */
+
+export const MaxBufferedChars = 64 * 1024;
+
+export class Printer {
+    /**
+     * @param {object} [handlers]
+     * @param {function(string): void} [handlers.onOutput] called with each character as it is printed
+     * @param {function(): void} [handlers.onFirstOutput] called once, when the machine first prints
+     */
+    constructor({ onOutput = () => {}, onFirstOutput = () => {} } = {}) {
+        this._onOutput = onOutput;
+        this._onFirstOutput = onFirstOutput;
+        this._uservia = null;
+        this._olderText = "";
+        this._newerText = "";
+        this._hasPrinted = false;
+    }
+
+    outputStrobe(level, output) {
+        if (!output || level) return;
+
+        const uservia = this._uservia;
+        // Ack the character by pulsing CA1 low.
+        uservia.setca1(false);
+        uservia.setca1(true);
+        this._append(String.fromCharCode(uservia.ora));
+    }
+
+    attach(uservia) {
+        this._uservia = uservia;
+        // The ack line idles high, so that each ack is a falling edge.
+        uservia.setca1(true);
+    }
+
+    /** The most recent output, at most MaxBufferedChars of it. */
+    get text() {
+        return (this._olderText + this._newerText).slice(-MaxBufferedChars);
+    }
+
+    _append(char) {
+        // Two chunks so the bound costs a trim when the text is read, not one per character.
+        this._newerText += char;
+        if (this._newerText.length >= MaxBufferedChars) {
+            this._olderText = this._newerText;
+            this._newerText = "";
+        }
+        if (!this._hasPrinted) {
+            this._hasPrinted = true;
+            this._onFirstOutput();
+        }
+        this._onOutput(char);
+    }
+}