ac6502 1.0.0

package/dist/tests/ROM.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ROM_1 = require("../components/ROM");
+describe('ROM', () => {
+    let rom;
+    beforeEach(() => {
+        rom = new ROM_1.ROM();
+    });
+    describe('Initialization', () => {
+        test('can initialize', () => {
+            expect(rom).not.toBeNull();
+            expect(rom).toBeInstanceOf(ROM_1.ROM);
+        });
+        test('initializes with correct size', () => {
+            expect(rom.data.length).toBe(ROM_1.ROM.SIZE);
+            expect(rom.data.length).toBe(0x8000); // 32KB
+        });
+        test('initializes all memory to zero', () => {
+            for (let i = 0; i < ROM_1.ROM.SIZE; i++) {
+                expect(rom.data[i]).toBe(0x00);
+            }
+        });
+    });
+    describe('Static Properties', () => {
+        test('START is 0x8000', () => {
+            expect(ROM_1.ROM.START).toBe(0x8000);
+        });
+        test('END is 0xFFFF', () => {
+            expect(ROM_1.ROM.END).toBe(0xFFFF);
+        });
+        test('CODE is 0xA000', () => {
+            expect(ROM_1.ROM.CODE).toBe(0xA000);
+        });
+        test('SIZE is calculated correctly', () => {
+            expect(ROM_1.ROM.SIZE).toBe(0x8000);
+            expect(ROM_1.ROM.SIZE).toBe(ROM_1.ROM.END - ROM_1.ROM.START + 1);
+        });
+    });
+    describe('read()', () => {
+        test('reads zero from uninitialized address', () => {
+            expect(rom.read(0x0000)).toBe(0x00);
+            expect(rom.read(0x4000)).toBe(0x00);
+            expect(rom.read(0x7FFF)).toBe(0x00);
+        });
+        test('reads data from address', () => {
+            rom.data[0x1234] = 0x42;
+            expect(rom.read(0x1234)).toBe(0x42);
+        });
+        test('reads from start address', () => {
+            rom.data[0x0000] = 0xFF;
+            expect(rom.read(0x0000)).toBe(0xFF);
+        });
+        test('reads from end address', () => {
+            rom.data[0x7FFF] = 0xAB;
+            expect(rom.read(0x7FFF)).toBe(0xAB);
+        });
+        test('reads different values from different addresses', () => {
+            rom.data[0x0100] = 0x11;
+            rom.data[0x0200] = 0x22;
+            rom.data[0x0300] = 0x33;
+            expect(rom.read(0x0100)).toBe(0x11);
+            expect(rom.read(0x0200)).toBe(0x22);
+            expect(rom.read(0x0300)).toBe(0x33);
+        });
+    });
+    describe('load()', () => {
+        test('loads data of correct size', () => {
+            const testData = new Array(ROM_1.ROM.SIZE).fill(0x00);
+            testData[0x0000] = 0xAA;
+            testData[0x1234] = 0xBB;
+            testData[0x7FFF] = 0xCC;
+            rom.load(testData);
+            expect(rom.data[0x0000]).toBe(0xAA);
+            expect(rom.data[0x1234]).toBe(0xBB);
+            expect(rom.data[0x7FFF]).toBe(0xCC);
+        });
+        test('does not load data of incorrect size (too small)', () => {
+            const originalData = [...rom.data];
+            const testData = new Array(ROM_1.ROM.SIZE - 1).fill(0xFF);
+            rom.load(testData);
+            expect(rom.data).toEqual(originalData);
+        });
+        test('does not load data of incorrect size (too large)', () => {
+            const originalData = [...rom.data];
+            const testData = new Array(ROM_1.ROM.SIZE + 1).fill(0xFF);
+            rom.load(testData);
+            expect(rom.data).toEqual(originalData);
+        });
+        test('loaded data can be read back', () => {
+            const testData = new Array(ROM_1.ROM.SIZE).fill(0x00);
+            testData[0x1000] = 0x42;
+            testData[0x2000] = 0x84;
+            testData[0x3000] = 0xC6;
+            rom.load(testData);
+            expect(rom.read(0x1000)).toBe(0x42);
+            expect(rom.read(0x2000)).toBe(0x84);
+            expect(rom.read(0x3000)).toBe(0xC6);
+        });
+        test('load replaces existing data', () => {
+            // Set some initial data
+            rom.data[0x0100] = 0xAA;
+            rom.data[0x0200] = 0xBB;
+            // Load new data
+            const testData = new Array(ROM_1.ROM.SIZE).fill(0x00);
+            testData[0x0100] = 0x11;
+            testData[0x0300] = 0x22;
+            rom.load(testData);
+            expect(rom.read(0x0100)).toBe(0x11);
+            expect(rom.read(0x0200)).toBe(0x00); // Old data replaced
+            expect(rom.read(0x0300)).toBe(0x22);
+        });
+        test('load with all different values', () => {
+            const testData = new Array(ROM_1.ROM.SIZE).fill(0).map((_, i) => i % 256);
+            rom.load(testData);
+            expect(rom.read(0x0000)).toBe(0);
+            expect(rom.read(0x0001)).toBe(1);
+            expect(rom.read(0x00FF)).toBe(255);
+            expect(rom.read(0x0100)).toBe(0);
+            expect(rom.read(0x0101)).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=ROM.test.js.map

package/dist/tests/ROM.test.js.map

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

package/jest.config.cjs

@@ -0,0 +1,9 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  clearMocks: true,
+  collectCoverage: true,
+  collectCoverageFrom: ['src/**/*.ts', '!src/index.ts']
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "ac6502",
+  "version": "1.0.0",
+  "description": "Emulator for the A.C. Wright 6502 project",
+  "main": "index.js",
+  "bin": {
+    "ac6502": "dist/index.js"
+  },
+  "scripts": {
+    "build": "npx tsc",
+    "start": "node ./dist/index.js",
+    "test": "NODE_OPTIONS='--no-experimental-webstorage' jest",
+    "test:watch": "NODE_OPTIONS='--no-experimental-webstorage' jest --watch",
+    "test:coverage": "NODE_OPTIONS='--no-experimental-webstorage' jest --coverage --coverageReporters=text-summary --coverageReporters=lcov"
+  },
+  "keywords": [
+    "6502",
+    "emulator",
+    "8-bit",
+    "sdl",
+    "binary",
+    "assembly",
+    "typescript"
+  ],
+  "author": "A.C. Wright",
+  "license": "MIT",
+  "repository": "https://github.com/acwright/6502-Emulator",
+  "homepage": "https://github.com/acwright/6502-Emulator/README.md",
+  "type": "commonjs",
+  "dependencies": {
+    "@kmamal/sdl": "^0.11.13",
+    "commander": "^14.0.3",
+    "figlet": "^1.10.0",
+    "serialport": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.3.3",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  }
+}