web-a2e 1.0.0

package/src/js/utils/basic-tokens.js

@@ -0,0 +1,117 @@
+/*
+ * basic-tokens.js - Applesoft BASIC token definitions
+ *
+ * Written by
+ *  Mike Daley <michael_daley@icloud.com>
+ */
+
+// Applesoft BASIC tokens - array index = token value - 0x80
+export const APPLESOFT_TOKENS = [
+  "END",      // $80
+  "FOR",      // $81
+  "NEXT",     // $82
+  "DATA",     // $83
+  "INPUT",    // $84
+  "DEL",      // $85
+  "DIM",      // $86
+  "READ",     // $87
+  "GR",       // $88
+  "TEXT",     // $89
+  "PR#",      // $8A
+  "IN#",      // $8B
+  "CALL",     // $8C
+  "PLOT",     // $8D
+  "HLIN",     // $8E
+  "VLIN",     // $8F
+  "HGR2",     // $90
+  "HGR",      // $91
+  "HCOLOR=",  // $92
+  "HPLOT",    // $93
+  "DRAW",     // $94
+  "XDRAW",    // $95
+  "HTAB",     // $96
+  "HOME",     // $97
+  "ROT=",     // $98
+  "SCALE=",   // $99
+  "SHLOAD",   // $9A
+  "TRACE",    // $9B
+  "NOTRACE",  // $9C
+  "NORMAL",   // $9D
+  "INVERSE",  // $9E
+  "FLASH",    // $9F
+  "COLOR=",   // $A0
+  "POP",      // $A1
+  "VTAB",     // $A2
+  "HIMEM:",   // $A3
+  "LOMEM:",   // $A4
+  "ONERR",    // $A5
+  "RESUME",   // $A6
+  "RECALL",   // $A7
+  "STORE",    // $A8
+  "SPEED=",   // $A9
+  "LET",      // $AA
+  "GOTO",     // $AB
+  "RUN",      // $AC
+  "IF",       // $AD
+  "RESTORE",  // $AE
+  "&",        // $AF - Ampersand (machine language hook)
+  "GOSUB",    // $B0
+  "RETURN",   // $B1
+  "REM",      // $B2
+  "STOP",     // $B3
+  "ON",       // $B4
+  "WAIT",     // $B5
+  "LOAD",     // $B6
+  "SAVE",     // $B7
+  "DEF",      // $B8
+  "POKE",     // $B9
+  "PRINT",    // $BA
+  "CONT",     // $BB
+  "LIST",     // $BC
+  "CLEAR",    // $BD
+  "GET",      // $BE
+  "NEW",      // $BF
+  "TAB(",     // $C0
+  "TO",       // $C1
+  "FN",       // $C2
+  "SPC(",     // $C3
+  "THEN",     // $C4
+  "AT",       // $C5
+  "NOT",      // $C6
+  "STEP",     // $C7
+  "+",        // $C8
+  "-",        // $C9
+  "*",        // $CA
+  "/",        // $CB
+  "^",        // $CC
+  "AND",      // $CD
+  "OR",       // $CE
+  ">",        // $CF
+  "=",        // $D0
+  "<",        // $D1
+  "SGN",      // $D2
+  "INT",      // $D3
+  "ABS",      // $D4
+  "USR",      // $D5
+  "FRE",      // $D6
+  "SCRN(",    // $D7
+  "PDL",      // $D8
+  "POS",      // $D9
+  "SQR",      // $DA
+  "RND",      // $DB
+  "LOG",      // $DC
+  "EXP",      // $DD
+  "COS",      // $DE
+  "SIN",      // $DF
+  "TAN",      // $E0
+  "ATN",      // $E1
+  "PEEK",     // $E2
+  "LEN",      // $E3
+  "STR$",     // $E4
+  "VAL",      // $E5
+  "ASC",      // $E6
+  "CHR$",     // $E7
+  "LEFT$",    // $E8
+  "RIGHT$",   // $E9
+  "MID$",     // $EA
+];

package/src/js/utils/constants.js

@@ -0,0 +1,28 @@
+/*
+ * constants.js - Shared constants
+ *
+ * Written by
+ *  Mike Daley <michael_daley@icloud.com>
+ */
+
+// localStorage key constants
+export const STORAGE_KEYS = {
+  VOLUME: "a2e-volume",
+  DISPLAY_SETTINGS: "a2e-display-settings",
+  SCREEN_WIDTH: "a2e-screen-width",
+  SHOW_DRIVES: "a2e-show-drives",
+  DRIVE_SOUNDS: "a2e-drive-sounds",
+  CHARSET: "a2e-charset",
+  DEBUG_WINDOWS: "a2e-debug-windows",
+  ZP_CUSTOM_WATCHES: "zp-custom-watches",
+  THEME: "a2e-theme",
+};
+
+// Canvas/display dimension constants
+export const DIMENSIONS = {
+  MIN_CANVAS_WIDTH: 280,
+  MIN_CANVAS_HEIGHT: 200,
+  BEZEL_PADDING_X: 88,
+  BEZEL_PADDING_Y: 104,
+  DEFAULT_PADDING: 32,
+};

package/src/js/utils/indexeddb-helper.js

@@ -0,0 +1,225 @@
+/*
+ * indexeddb-helper.js - IndexedDB helper utilities
+ *
+ * Written by
+ *  Mike Daley <michael_daley@icloud.com>
+ */
+
+/**
+ * Creates a database manager for a specific IndexedDB database.
+ * Handles connection caching, database opening, and provides
+ * Promise-based wrappers for common operations.
+ *
+ * @param {Object} config - Database configuration
+ * @param {string} config.dbName - The database name
+ * @param {number} config.version - The database version
+ * @param {function} config.onUpgrade - Upgrade handler (event) => void
+ * @returns {Object} Database manager with helper methods
+ */
+export function createDatabaseManager({ dbName, version, onUpgrade }) {
+  let cachedDb = null;
+
+  /**
+   * Open the database, using cached connection if available
+   * @returns {Promise<IDBDatabase>}
+   */
+  async function open() {
+    if (cachedDb) {
+      return cachedDb;
+    }
+
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open(dbName, version);
+
+      request.onerror = () => {
+        console.error(`Failed to open database ${dbName}:`, request.error);
+        reject(request.error);
+      };
+
+      request.onsuccess = () => {
+        cachedDb = request.result;
+        resolve(cachedDb);
+      };
+
+      request.onupgradeneeded = onUpgrade;
+    });
+  }
+
+  /**
+   * Get a record by key from a store
+   * @param {string} storeName - The object store name
+   * @param {*} key - The key to look up
+   * @returns {Promise<*>} The record or undefined
+   */
+  async function get(storeName, key) {
+    const db = await open();
+    const transaction = db.transaction(storeName, "readonly");
+    const store = transaction.objectStore(storeName);
+
+    return new Promise((resolve, reject) => {
+      const request = store.get(key);
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  /**
+   * Put (insert or update) a record in a store
+   * @param {string} storeName - The object store name
+   * @param {*} record - The record to store
+   * @returns {Promise<*>} The key of the stored record
+   */
+  async function put(storeName, record) {
+    const db = await open();
+    const transaction = db.transaction(storeName, "readwrite");
+    const store = transaction.objectStore(storeName);
+
+    return new Promise((resolve, reject) => {
+      const request = store.put(record);
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  /**
+   * Add a new record to a store (fails if key exists)
+   * @param {string} storeName - The object store name
+   * @param {*} record - The record to add
+   * @returns {Promise<*>} The key of the added record
+   */
+  async function add(storeName, record) {
+    const db = await open();
+    const transaction = db.transaction(storeName, "readwrite");
+    const store = transaction.objectStore(storeName);
+
+    return new Promise((resolve, reject) => {
+      const request = store.add(record);
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  /**
+   * Delete a record by key from a store
+   * @param {string} storeName - The object store name
+   * @param {*} key - The key to delete
+   * @returns {Promise<void>}
+   */
+  async function remove(storeName, key) {
+    const db = await open();
+    const transaction = db.transaction(storeName, "readwrite");
+    const store = transaction.objectStore(storeName);
+
+    return new Promise((resolve, reject) => {
+      const request = store.delete(key);
+      request.onsuccess = () => resolve();
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  /**
+   * Count records in a store
+   * @param {string} storeName - The object store name
+   * @returns {Promise<number>}
+   */
+  async function count(storeName) {
+    const db = await open();
+    const transaction = db.transaction(storeName, "readonly");
+    const store = transaction.objectStore(storeName);
+
+    return new Promise((resolve, reject) => {
+      const request = store.count();
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  /**
+   * Iterate over records using a cursor
+   * @param {string} storeName - The object store name
+   * @param {Object} options - Cursor options
+   * @param {string} [options.indexName] - Optional index name to use
+   * @param {IDBKeyRange} [options.range] - Optional key range
+   * @param {string} [options.direction] - Cursor direction ('next', 'prev', etc.)
+   * @param {function} callback - Called for each record: (value, cursor) => void
+   *                              Return false to stop iteration
+   * @returns {Promise<void>}
+   */
+  async function iterate(storeName, options, callback) {
+    const db = await open();
+    const transaction = db.transaction(storeName, "readonly");
+    const store = transaction.objectStore(storeName);
+    const source = options.indexName ? store.index(options.indexName) : store;
+
+    return new Promise((resolve, reject) => {
+      const request = source.openCursor(options.range || null, options.direction || "next");
+
+      request.onsuccess = (event) => {
+        const cursor = event.target.result;
+        if (cursor) {
+          const result = callback(cursor.value, cursor);
+          if (result !== false) {
+            cursor.continue();
+          } else {
+            resolve();
+          }
+        } else {
+          resolve();
+        }
+      };
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  /**
+   * Iterate over records with write access (for deletion during iteration)
+   * @param {string} storeName - The object store name
+   * @param {Object} options - Cursor options
+   * @param {string} [options.indexName] - Optional index name to use
+   * @param {IDBKeyRange} [options.range] - Optional key range
+   * @param {string} [options.direction] - Cursor direction ('next', 'prev', etc.)
+   * @param {function} callback - Called for each record: (value, cursor, store) => void
+   * @returns {Promise<void>}
+   */
+  async function iterateWithWrite(storeName, options, callback) {
+    const db = await open();
+    const transaction = db.transaction(storeName, "readwrite");
+    const store = transaction.objectStore(storeName);
+    const source = options.indexName ? store.index(options.indexName) : store;
+
+    return new Promise((resolve, reject) => {
+      const request = source.openCursor(options.range || null, options.direction || "next");
+
+      request.onsuccess = (event) => {
+        const cursor = event.target.result;
+        if (cursor) {
+          callback(cursor.value, cursor, store);
+          cursor.continue();
+        } else {
+          resolve();
+        }
+      };
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  /**
+   * Get raw database reference for complex operations
+   * @returns {Promise<IDBDatabase>}
+   */
+  async function getDatabase() {
+    return open();
+  }
+
+  return {
+    open,
+    get,
+    put,
+    add,
+    remove,
+    count,
+    iterate,
+    iterateWithWrite,
+    getDatabase,
+  };
+}