@gba-kit/arm-emulator 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ARM7TDMI Thumb Emulator - Memory System
+ *
+ * Implements the GBA memory map with region dispatch, dirty tracking,
+ * and MMIO write recording. Uses ArrayBuffer + DataView for each region.
+ */
+import type { MemoryBus, MemoryWrite } from './types.js';
+/**
+ * GBA Memory Map implementation.
+ *
+ * Each region is backed by an ArrayBuffer. Reads and writes are dispatched
+ * by the top byte of the address. All writes are logged for comparison.
+ * MMIO writes are recorded separately (order-sensitive).
+ */
+export declare class GbaMemory implements MemoryBus {
+    #private;
+    readonly ewram: ArrayBuffer;
+    readonly iwram: ArrayBuffer;
+    readonly mmio: ArrayBuffer;
+    readonly palette: ArrayBuffer;
+    readonly vram: ArrayBuffer;
+    readonly oam: ArrayBuffer;
+    readonly rom: ArrayBuffer;
+    constructor();
+    read8(address: number): number;
+    read16(address: number): number;
+    read32(address: number): number;
+    write8(address: number, value: number): void;
+    write16(address: number, value: number): void;
+    write32(address: number, value: number): void;
+    /** Load a block of bytes into memory at a given address */
+    loadBytes(baseAddress: number, data: Uint8Array): void;
+    /** Get all memory writes since last reset */
+    getWriteLog(): MemoryWrite[];
+    /** Get MMIO writes only (order-sensitive) */
+    getMmioWriteLog(): MemoryWrite[];
+    /** Reset write logs (but keep memory contents) */
+    resetWriteLog(): void;
+    /** Zero all writable memory regions and reset logs */
+    reset(): void;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAazD;;;;;;GAMG;AACH,qBAAa,SAAU,YAAW,SAAS;;IAEzC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;;IA+D1B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAY9B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAmB/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAoB/B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAc5C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAe7C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAwB7C,2DAA2D;IAC3D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAYtD,6CAA6C;IAC7C,WAAW,IAAI,WAAW,EAAE;IAI5B,6CAA6C;IAC7C,eAAe,IAAI,WAAW,EAAE;IAIhC,kDAAkD;IAClD,aAAa,IAAI,IAAI;IAKrB,sDAAsD;IACtD,KAAK,IAAI,IAAI;CAWd"}

package/dist/memory.js

@@ -0,0 +1,218 @@
+/** GBA memory region definitions */
+const REGIONS = {
+    EWRAM: { base: 0x02000000, size: 0x40000 }, // 256KB
+    IWRAM: { base: 0x03000000, size: 0x8000 }, //  32KB
+    MMIO: { base: 0x04000000, size: 0x400 }, //   1KB
+    PALETTE: { base: 0x05000000, size: 0x400 }, //   1KB
+    VRAM: { base: 0x06000000, size: 0x18000 }, //  96KB
+    OAM: { base: 0x07000000, size: 0x400 }, //   1KB
+    ROM: { base: 0x08000000, size: 0x2000000 }, //  32MB
+};
+/**
+ * GBA Memory Map implementation.
+ *
+ * Each region is backed by an ArrayBuffer. Reads and writes are dispatched
+ * by the top byte of the address. All writes are logged for comparison.
+ * MMIO writes are recorded separately (order-sensitive).
+ */
+export class GbaMemory {
+    // Region backing stores
+    ewram;
+    iwram;
+    mmio;
+    palette;
+    vram;
+    oam;
+    rom;
+    // DataViews for typed access
+    #ewramView;
+    #iwramView;
+    #mmioView;
+    #paletteView;
+    #vramView;
+    #oamView;
+    #romView;
+    // Write tracking
+    #writeLog = [];
+    #mmioWriteLog = [];
+    constructor() {
+        this.ewram = new ArrayBuffer(REGIONS.EWRAM.size);
+        this.iwram = new ArrayBuffer(REGIONS.IWRAM.size);
+        this.mmio = new ArrayBuffer(REGIONS.MMIO.size);
+        this.palette = new ArrayBuffer(REGIONS.PALETTE.size);
+        this.vram = new ArrayBuffer(REGIONS.VRAM.size);
+        this.oam = new ArrayBuffer(REGIONS.OAM.size);
+        this.rom = new ArrayBuffer(REGIONS.ROM.size);
+        this.#ewramView = new DataView(this.ewram);
+        this.#iwramView = new DataView(this.iwram);
+        this.#mmioView = new DataView(this.mmio);
+        this.#paletteView = new DataView(this.palette);
+        this.#vramView = new DataView(this.vram);
+        this.#oamView = new DataView(this.oam);
+        this.#romView = new DataView(this.rom);
+    }
+    /** Resolve an address to a [DataView, offset] pair */
+    #resolve(address) {
+        const region = (address >>> 24) & 0xff;
+        switch (region) {
+            case 0x02:
+                return [this.#ewramView, (address & 0x3ffff) % REGIONS.EWRAM.size];
+            case 0x03:
+                return [this.#iwramView, (address & 0x7fff) % REGIONS.IWRAM.size];
+            case 0x04:
+                return [this.#mmioView, address & 0x3ff];
+            case 0x05:
+                return [this.#paletteView, address & 0x3ff];
+            case 0x06: {
+                let offset = address & 0x1ffff;
+                // VRAM mirror: 0x10000-0x17FFF mirrors to 0x10000-0x17FFF, above mirrors back
+                if (offset >= REGIONS.VRAM.size) {
+                    offset -= 0x8000;
+                }
+                return [this.#vramView, offset];
+            }
+            case 0x07:
+                return [this.#oamView, address & 0x3ff];
+            case 0x08:
+            case 0x09:
+                return [this.#romView, address - REGIONS.ROM.base];
+            default:
+                return null;
+        }
+    }
+    read8(address) {
+        const resolved = this.#resolve(address);
+        if (!resolved) {
+            return 0; // Open bus
+        }
+        const [view, offset] = resolved;
+        if (offset >= view.byteLength) {
+            return 0;
+        }
+        return view.getUint8(offset);
+    }
+    read16(address) {
+        // ARM7TDMI: halfword reads are aligned, unaligned rotates
+        const aligned = address & ~1;
+        const resolved = this.#resolve(aligned);
+        if (!resolved) {
+            return 0;
+        }
+        const [view, offset] = resolved;
+        if (offset + 1 >= view.byteLength) {
+            return 0;
+        }
+        const value = view.getUint16(offset, true); // little-endian
+        // Rotate for unaligned access on ARMv4T
+        if (address & 1) {
+            return ((value >>> 8) | (value << 24)) >>> 0;
+        }
+        return value;
+    }
+    read32(address) {
+        // ARM7TDMI: word reads are force-aligned, unaligned rotates
+        const aligned = address & ~3;
+        const resolved = this.#resolve(aligned);
+        if (!resolved) {
+            return 0;
+        }
+        const [view, offset] = resolved;
+        if (offset + 3 >= view.byteLength) {
+            return 0;
+        }
+        const value = view.getUint32(offset, true); // little-endian
+        // Rotate for unaligned access
+        const rot = (address & 3) * 8;
+        if (rot !== 0) {
+            return ((value >>> rot) | (value << (32 - rot))) >>> 0;
+        }
+        return value;
+    }
+    write8(address, value) {
+        const resolved = this.#resolve(address);
+        if (!resolved) {
+            return;
+        }
+        const [view, offset] = resolved;
+        if (offset >= view.byteLength) {
+            return;
+        }
+        value = value & 0xff;
+        view.setUint8(offset, value);
+        this.#recordWrite(address, 1, value);
+    }
+    write16(address, value) {
+        const aligned = address & ~1;
+        const resolved = this.#resolve(aligned);
+        if (!resolved) {
+            return;
+        }
+        const [view, offset] = resolved;
+        if (offset + 1 >= view.byteLength) {
+            return;
+        }
+        value = value & 0xffff;
+        view.setUint16(offset, value, true);
+        this.#recordWrite(aligned, 2, value);
+    }
+    write32(address, value) {
+        const aligned = address & ~3;
+        const resolved = this.#resolve(aligned);
+        if (!resolved) {
+            return;
+        }
+        const [view, offset] = resolved;
+        if (offset + 3 >= view.byteLength) {
+            return;
+        }
+        value = value >>> 0;
+        view.setUint32(offset, value, true);
+        this.#recordWrite(aligned, 4, value);
+    }
+    #recordWrite(address, size, value) {
+        const entry = { address, size, value };
+        this.#writeLog.push(entry);
+        // Also record MMIO writes separately (order-sensitive)
+        if (((address >>> 24) & 0xff) === 0x04) {
+            this.#mmioWriteLog.push(entry);
+        }
+    }
+    /** Load a block of bytes into memory at a given address */
+    loadBytes(baseAddress, data) {
+        for (let i = 0; i < data.length; i++) {
+            const resolved = this.#resolve(baseAddress + i);
+            if (resolved) {
+                const [view, offset] = resolved;
+                if (offset < view.byteLength) {
+                    view.setUint8(offset, data[i]);
+                }
+            }
+        }
+    }
+    /** Get all memory writes since last reset */
+    getWriteLog() {
+        return this.#writeLog;
+    }
+    /** Get MMIO writes only (order-sensitive) */
+    getMmioWriteLog() {
+        return this.#mmioWriteLog;
+    }
+    /** Reset write logs (but keep memory contents) */
+    resetWriteLog() {
+        this.#writeLog = [];
+        this.#mmioWriteLog = [];
+    }
+    /** Zero all writable memory regions and reset logs */
+    reset() {
+        new Uint8Array(this.ewram).fill(0);
+        new Uint8Array(this.iwram).fill(0);
+        new Uint8Array(this.mmio).fill(0);
+        new Uint8Array(this.palette).fill(0);
+        new Uint8Array(this.vram).fill(0);
+        new Uint8Array(this.oam).fill(0);
+        // ROM is not zeroed — it's loaded once
+        this.#writeLog = [];
+        this.#mmioWriteLog = [];
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * ARM7TDMI Emulator - Core Types
+ */
+/** ARM register indices */
+export declare const SP = 13;
+export declare const LR = 14;
+export declare const PC = 15;
+/** Sentinel address — execution halts when PC reaches this */
+export declare const SENTINEL_ADDR = 3735928558;
+/**
+ * Abstract memory bus that the CPU reads/writes through.
+ *
+ * The full GBA emulator injects GbaSystemBus (dispatches to PPU, APU, etc.).
+ */
+export interface MemoryBus {
+    read8(address: number): number;
+    read16(address: number): number;
+    read32(address: number): number;
+    write8(address: number, value: number): void;
+    write16(address: number, value: number): void;
+    write32(address: number, value: number): void;
+}
+/** Action the debugger can take after a hook fires */
+export type DebugAction = 'continue' | 'break';
+/**
+ * Optional hooks for debugging instrumentation.
+ *
+ * When attached to a CPU, these are called during execution.
+ * When absent, no overhead — the CPU takes a fast path.
+ */
+export interface DebugHooks {
+    /** Called before executing an instruction. Return 'break' to pause. */
+    onInstructionPre?(address: number, instruction: number): DebugAction;
+    /** Called after executing an instruction. */
+    onInstructionPost?(address: number, instruction: number): void;
+    /** Called on every memory read (for memory watchpoints). */
+    onMemoryRead?(address: number, size: 1 | 2 | 4, value: number): void;
+    /** Called on every memory write (for memory watchpoints). */
+    onMemoryWrite?(address: number, size: 1 | 2 | 4, value: number): void;
+}
+/** CPSR condition flags */
+export interface CpsrFlags {
+    n: boolean;
+    z: boolean;
+    c: boolean;
+    v: boolean;
+}
+/** Result of an arithmetic/logic operation with flags */
+export interface AluResult {
+    value: number;
+    n: boolean;
+    z: boolean;
+    c: boolean;
+    v: boolean;
+}
+/** A recorded memory write during execution */
+export interface MemoryWrite {
+    address: number;
+    size: 1 | 2 | 4;
+    value: number;
+}
+/** A recorded external function call (bl to an unresolved symbol) */
+export interface ExternalCall {
+    /** Address of the bl instruction */
+    callSite: number;
+    /** Resolved target address (from relocation) */
+    targetAddress: number;
+    /** Symbol name from relocation table */
+    symbolName: string;
+    /** Argument registers at time of call */
+    r0: number;
+    r1: number;
+    r2: number;
+    r3: number;
+}
+/** Full execution trace from running a function */
+export interface ExecutionResult {
+    /** Final register values (r0-r15) */
+    registers: Uint32Array;
+    /** Final CPSR flags */
+    cpsr: CpsrFlags;
+    /** All memory writes performed during execution */
+    memoryWrites: MemoryWrite[];
+    /** All external function calls made during execution */
+    externalCalls: ExternalCall[];
+    /** Number of instructions executed */
+    instructionsExecuted: number;
+    /** Whether execution completed normally (returned) vs hit instruction limit */
+    completed: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * ARM7TDMI Emulator - Core Types
+ */
+/** ARM register indices */
+export const SP = 13;
+export const LR = 14;
+export const PC = 15;
+/** Sentinel address — execution halts when PC reaches this */
+export const SENTINEL_ADDR = 0xdeadbeee;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;AACrB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;AACrB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;AAErB,8DAA8D;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ARM7TDMI Thumb Emulator - Bit manipulation and ALU utilities
+ *
+ * Key TypeScript/JS numeric patterns for 32-bit ARM emulation:
+ * - `| 0` truncates to signed 32-bit (like C's int32_t)
+ * - `>>> 0` reinterprets as unsigned 32-bit
+ * - `Math.imul(a, b)` for correct 32-bit multiply (regular * loses precision above 2^53)
+ * - `>>` is arithmetic right shift (sign-extending), `>>>` is logical right shift
+ */
+import type { AluResult } from './types.js';
+/** Extract bits [hi:lo] from a value (inclusive) */
+export declare function bits(value: number, hi: number, lo: number): number;
+/** Extract a single bit */
+export declare function bit(value: number, pos: number): number;
+/** Sign-extend a value from `bitWidth` bits to 32 bits */
+export declare function signExtend(value: number, bitWidth: number): number;
+/** Check if bit 31 is set (negative in signed interpretation) */
+export declare function isNegative(value: number): boolean;
+/**
+ * Add two 32-bit values with full flag computation.
+ * Returns the result and NZCV flags.
+ */
+export declare function addWithFlags(a: number, b: number, carryIn?: number): AluResult;
+/**
+ * Subtract two 32-bit values with full flag computation.
+ * Computes a - b (with optional borrow).
+ *
+ * ARM subtraction uses inverted carry: C=1 means no borrow.
+ * SUB is implemented as ADD(a, ~b, 1).
+ */
+export declare function subWithFlags(a: number, b: number, carryIn?: number): AluResult;
+/**
+ * Logical shift left. Returns [result, carryOut].
+ * If amount is 0, carry is unchanged (returns oldCarry).
+ */
+export declare function lsl(value: number, amount: number, oldCarry: boolean): [number, boolean];
+/**
+ * Logical shift right. Returns [result, carryOut].
+ * amount=0 encodes LSR #32 in Thumb Format 1.
+ */
+export declare function lsr(value: number, amount: number, oldCarry: boolean, immZeroMeans32?: boolean): [number, boolean];
+/**
+ * Arithmetic shift right. Returns [result, carryOut].
+ * amount=0 encodes ASR #32 in Thumb Format 1.
+ */
+export declare function asr(value: number, amount: number, oldCarry: boolean, immZeroMeans32?: boolean): [number, boolean];
+/**
+ * Rotate right. Returns [result, carryOut].
+ */
+export declare function ror(value: number, amount: number, oldCarry: boolean): [number, boolean];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,oDAAoD;AACpD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,2BAA2B;AAC3B,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,GAAG,SAAS,CAwBjF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,GAAG,SAAS,CAMjF;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CASvF;AAED;;;GAGG;AACH,wBAAgB,GAAG,CACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,OAAe,GAC9B,CAAC,MAAM,EAAE,OAAO,CAAC,CAanB;AAED;;;GAGG;AACH,wBAAgB,GAAG,CACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,OAAe,GAC9B,CAAC,MAAM,EAAE,OAAO,CAAC,CAenB;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAYvF"}

package/dist/utils.js

@@ -0,0 +1,126 @@
+/** Extract bits [hi:lo] from a value (inclusive) */
+export function bits(value, hi, lo) {
+    return (value >>> lo) & ((1 << (hi - lo + 1)) - 1);
+}
+/** Extract a single bit */
+export function bit(value, pos) {
+    return (value >>> pos) & 1;
+}
+/** Sign-extend a value from `bitWidth` bits to 32 bits */
+export function signExtend(value, bitWidth) {
+    const shift = 32 - bitWidth;
+    return (value << shift) >> shift;
+}
+/** Check if bit 31 is set (negative in signed interpretation) */
+export function isNegative(value) {
+    return (value & 0x80000000) !== 0;
+}
+/**
+ * Add two 32-bit values with full flag computation.
+ * Returns the result and NZCV flags.
+ */
+export function addWithFlags(a, b, carryIn = 0) {
+    // Use unsigned interpretation for carry detection
+    const ua = a >>> 0;
+    const ub = b >>> 0;
+    const result = (ua + ub + carryIn) | 0;
+    const uresult = result >>> 0;
+    // Carry: unsigned overflow
+    // We need to detect if ua + ub + carryIn > 0xFFFFFFFF
+    // Since JS numbers have enough precision for this sum:
+    const fullSum = ua + ub + carryIn;
+    const c = fullSum > 0xffffffff;
+    // Overflow: signed overflow
+    // Positive + Positive = Negative, or Negative + Negative = Positive
+    const v = ((a ^ result) & (b ^ result) & 0x80000000) !== 0;
+    return {
+        value: result,
+        n: (uresult & 0x80000000) !== 0,
+        z: uresult === 0,
+        c,
+        v,
+    };
+}
+/**
+ * Subtract two 32-bit values with full flag computation.
+ * Computes a - b (with optional borrow).
+ *
+ * ARM subtraction uses inverted carry: C=1 means no borrow.
+ * SUB is implemented as ADD(a, ~b, 1).
+ */
+export function subWithFlags(a, b, carryIn = 1) {
+    // SUB a, b = ADD a, NOT(b), carry
+    // For plain SUB: carry = 1 (no borrow)
+    // For SBC: carry = CPSR.C (borrow flag)
+    const notB = ~b;
+    return addWithFlags(a, notB, carryIn);
+}
+/**
+ * Logical shift left. Returns [result, carryOut].
+ * If amount is 0, carry is unchanged (returns oldCarry).
+ */
+export function lsl(value, amount, oldCarry) {
+    if (amount === 0) {
+        return [value, oldCarry];
+    }
+    if (amount >= 32) {
+        return [0, amount === 32 ? (value & 1) !== 0 : false];
+    }
+    const carry = ((value >>> (32 - amount)) & 1) !== 0;
+    return [(value << amount) | 0, carry];
+}
+/**
+ * Logical shift right. Returns [result, carryOut].
+ * amount=0 encodes LSR #32 in Thumb Format 1.
+ */
+export function lsr(value, amount, oldCarry, immZeroMeans32 = false) {
+    if (amount === 0) {
+        if (immZeroMeans32) {
+            // LSR #0 in format 1 means LSR #32
+            return [0, isNegative(value)];
+        }
+        return [value, oldCarry];
+    }
+    if (amount >= 32) {
+        return [0, amount === 32 ? isNegative(value) : false];
+    }
+    const carry = ((value >>> (amount - 1)) & 1) !== 0;
+    return [value >>> amount, carry];
+}
+/**
+ * Arithmetic shift right. Returns [result, carryOut].
+ * amount=0 encodes ASR #32 in Thumb Format 1.
+ */
+export function asr(value, amount, oldCarry, immZeroMeans32 = false) {
+    if (amount === 0) {
+        if (immZeroMeans32) {
+            // ASR #0 in format 1 means ASR #32
+            const carry = isNegative(value);
+            return [carry ? 0xffffffff : 0, carry];
+        }
+        return [value, oldCarry];
+    }
+    if (amount >= 32) {
+        const carry = isNegative(value);
+        return [carry ? 0xffffffff : 0, carry];
+    }
+    const carry = ((value >> (amount - 1)) & 1) !== 0;
+    return [value >> amount, carry];
+}
+/**
+ * Rotate right. Returns [result, carryOut].
+ */
+export function ror(value, amount, oldCarry) {
+    if (amount === 0) {
+        return [value, oldCarry];
+    }
+    const effectiveAmount = amount & 31;
+    if (effectiveAmount === 0) {
+        // Rotate by 32 = no-op, but carry = bit 31
+        return [value, isNegative(value)];
+    }
+    const result = (value >>> effectiveAmount) | (value << (32 - effectiveAmount)) | 0;
+    const carry = ((result >>> 31) & 1) !== 0;
+    return [result, carry];
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@gba-kit/arm-emulator",
+  "version": "0.1.0",
+  "description": "ARM7TDMI CPU emulator supporting Thumb and ARM instruction sets",
+  "author": "macabeus",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./arm-cpu": {
+      "types": "./dist/arm-cpu.d.ts",
+      "import": "./dist/arm-cpu.js"
+    },
+    "./disassembler": {
+      "types": "./dist/disassembler.d.ts",
+      "import": "./dist/disassembler.js"
+    },
+    "./cpu-snapshot": {
+      "types": "./dist/cpu-snapshot.d.ts",
+      "import": "./dist/cpu-snapshot.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/macabeus/gba-kit",
+    "directory": "packages/arm-emulator"
+  },
+  "homepage": "https://github.com/macabeus/gba-kit",
+  "bugs": "https://github.com/macabeus/gba-kit/issues",
+  "keywords": [
+    "gba",
+    "gameboy-advance",
+    "emulator",
+    "arm7tdmi",
+    "typescript"
+  ],
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "vitest": "^4.1.1",
+    "typescript": "^6.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint src/"
+  }
+}