ac6502 1.3.0 → 1.4.1

package/dist/components/IO/Attachments/KeyboardMatrixAttachment.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyboardMatrixAttachment = void 0;
+const Attachment_1 = require("./Attachment");
+/**
+ * USB HID Keycode to ASCII mapping table
+ * Maps USB HID usage IDs to ASCII characters
+ */
+const USB_HID_TO_ASCII = {
+    0x04: 0x61, // a
+    0x05: 0x62, // b
+    0x06: 0x63, // c
+    0x07: 0x64, // d
+    0x08: 0x65, // e
+    0x09: 0x66, // f
+    0x0A: 0x67, // g
+    0x0B: 0x68, // h
+    0x0C: 0x69, // i
+    0x0D: 0x6A, // j
+    0x0E: 0x6B, // k
+    0x0F: 0x6C, // l
+    0x10: 0x6D, // m
+    0x11: 0x6E, // n
+    0x12: 0x6F, // o
+    0x13: 0x70, // p
+    0x14: 0x71, // q
+    0x15: 0x72, // r
+    0x16: 0x73, // s
+    0x17: 0x74, // t
+    0x18: 0x75, // u
+    0x19: 0x76, // v
+    0x1A: 0x77, // w
+    0x1B: 0x78, // x
+    0x1C: 0x79, // y
+    0x1D: 0x7A, // z
+    0x1E: 0x31, // 1
+    0x1F: 0x32, // 2
+    0x20: 0x33, // 3
+    0x21: 0x34, // 4
+    0x22: 0x35, // 5
+    0x23: 0x36, // 6
+    0x24: 0x37, // 7
+    0x25: 0x38, // 8
+    0x26: 0x39, // 9
+    0x27: 0x30, // 0
+    0x28: 0x0D, // Enter
+    0x29: 0x1B, // Escape
+    0x2A: 0x08, // Backspace
+    0x2B: 0x09, // Tab
+    0x2C: 0x20, // Space
+    0x2D: 0x2D, // -
+    0x2E: 0x3D, // =
+    0x2F: 0x5B, // [
+    0x30: 0x5D, // ]
+    0x31: 0x5C, // backslash
+    0x33: 0x3B, // ;
+    0x34: 0x27, // '
+    0x35: 0x60, // `
+    0x36: 0x2C, // ,
+    0x37: 0x2E, // .
+    0x38: 0x2F, // /
+    0x4C: 0x7F, // Delete
+    0x4F: 0x1D, // Right Arrow
+    0x50: 0x1C, // Left Arrow
+    0x51: 0x1F, // Down Arrow
+    0x52: 0x1E, // Up Arrow
+    0x49: 0x1A, // Insert
+};
+/**
+ * KeyboardMatrixAttachment - Emulates a keyboard matrix connected to GPIO ports
+ *
+ * The keyboard matrix uses:
+ * - Port A (PA0-PA7): Rows (8 rows)
+ * - Port B (PB0-PB7): Columns (8 columns)
+ *
+ * Keys are active-low: when a key is pressed, the corresponding row/column intersection
+ * pulls the row line low when the column is selected (low).
+ */
+class KeyboardMatrixAttachment extends Attachment_1.AttachmentBase {
+    constructor(priority = 0) {
+        super(priority, false, false, false, false);
+        // Keyboard matrix state - 8 rows, each storing which columns have keys pressed (bit mask)
+        this.keyboardMatrix = [0, 0, 0, 0, 0, 0, 0, 0];
+        // Currently selected columns from Port B write
+        this.selectedColumns = 0xFF;
+        this.reset();
+    }
+    reset() {
+        super.reset();
+        for (let i = 0; i < 8; i++) {
+            this.keyboardMatrix[i] = 0x00;
+        }
+        this.selectedColumns = 0xFF;
+    }
+    readPortA(ddr, or) {
+        let rowStates = 0xFF; // All rows high (not pressed) by default
+        // Check keyboard matrix based on selected columns
+        for (let row = 0; row < 8; row++) {
+            for (let col = 0; col < 8; col++) {
+                // If column is selected (low) and key is pressed in matrix
+                if (!(this.selectedColumns & (1 << col)) && (this.keyboardMatrix[row] & (1 << col))) {
+                    rowStates &= ~(1 << row); // Pull row low (active-low)
+                }
+            }
+        }
+        return rowStates & 0xFF;
+    }
+    readPortB(ddr, or) {
+        return 0xFF; // Don't interfere with Port B reads
+    }
+    writePortB(value, ddr) {
+        // Store the column selection for matrix scanning
+        this.selectedColumns = value & 0xFF;
+    }
+    /**
+     * Update a key state based on USB HID keycode
+     * @param usbHidKeycode - USB HID usage ID for the key
+     * @param pressed - true if key is pressed, false if released
+     */
+    updateKey(usbHidKeycode, pressed) {
+        let targetRow = -1;
+        let targetCol = -1;
+        // Direct USB HID keycode to matrix position mapping for special/modifier keys
+        switch (usbHidKeycode) {
+            // Modifier keys
+            case 0xE0: // Left Ctrl
+            case 0xE4: // Right Ctrl
+                targetRow = 7;
+                targetCol = 0; // PA7, PB0 (CTRL)
+                break;
+            case 0xE1: // Left Shift
+            case 0xE5: // Right Shift
+                targetRow = 5;
+                targetCol = 4; // PA5, PB4 (SHIFT)
+                break;
+            case 0xE2: // Left Alt
+            case 0xE6: // Right Alt
+                targetRow = 7;
+                targetCol = 2; // PA7, PB2 (ALT)
+                break;
+            case 0xE3: // Left GUI (Windows/Command)
+            case 0xE7: // Right GUI
+                targetRow = 7;
+                targetCol = 1; // PA7, PB1 (META/GUI)
+                break;
+            // Special keys
+            case 0x39: // Caps Lock
+                targetRow = 3;
+                targetCol = 6; // PA3, PB6 (CAPS LOCK)
+                break;
+            // Function keys (F1-F10) - map to FN + number combination
+            case 0x3A: // F1
+            case 0x3B: // F2
+            case 0x3C: // F3
+            case 0x3D: // F4
+            case 0x3E: // F5
+            case 0x3F: // F6
+            case 0x40: // F7
+            case 0x41: // F8
+            case 0x42: // F9
+            case 0x43: // F10
+                {
+                    // Always set the FN key (PA7, PB4)
+                    if (pressed) {
+                        this.keyboardMatrix[7] |= (1 << 4);
+                    }
+                    else {
+                        this.keyboardMatrix[7] &= ~(1 << 4);
+                    }
+                    // Map to corresponding number key
+                    let numberKey;
+                    if (usbHidKeycode >= 0x3A && usbHidKeycode <= 0x42) {
+                        // F1-F9 map to '1'-'9'
+                        numberKey = 0x31 + (usbHidKeycode - 0x3A); // '1' = 0x31
+                    }
+                    else {
+                        // F10 maps to '0'
+                        numberKey = 0x30; // '0' = 0x30
+                    }
+                    // Find and set the number key in the matrix
+                    for (let row = 0; row < 8; row++) {
+                        for (let col = 0; col < 8; col++) {
+                            if (KeyboardMatrixAttachment.KEYBOARD_LAYOUT[row][col] === numberKey) {
+                                if (pressed) {
+                                    this.keyboardMatrix[row] |= (1 << col);
+                                }
+                                else {
+                                    this.keyboardMatrix[row] &= ~(1 << col);
+                                }
+                                return; // Done processing
+                            }
+                        }
+                    }
+                    return; // If number key not found, still return
+                }
+            default:
+                {
+                    // For all other keys, try ASCII mapping
+                    const asciiKey = USB_HID_TO_ASCII[usbHidKeycode];
+                    // If no ASCII mapping, ignore the key
+                    if (asciiKey === undefined || asciiKey === 0x00) {
+                        return;
+                    }
+                    // Find the ASCII key in the keyboard layout
+                    for (let row = 0; row < 8; row++) {
+                        for (let col = 0; col < 8; col++) {
+                            if (KeyboardMatrixAttachment.KEYBOARD_LAYOUT[row][col] === asciiKey) {
+                                targetRow = row;
+                                targetCol = col;
+                                break;
+                            }
+                        }
+                        if (targetRow !== -1)
+                            break;
+                    }
+                }
+                break;
+        }
+        // Update the keyboard matrix if we found a valid position
+        if (targetRow !== -1 && targetCol !== -1) {
+            if (pressed) {
+                this.keyboardMatrix[targetRow] |= (1 << targetCol); // Set bit (key pressed)
+            }
+            else {
+                this.keyboardMatrix[targetRow] &= ~(1 << targetCol); // Clear bit (key released)
+            }
+        }
+    }
+    /**
+     * Update a specific matrix position directly
+     * @param row - Row index (0-7)
+     * @param col - Column index (0-7)
+     * @param pressed - true if key is pressed, false if released
+     */
+    updateMatrixPosition(row, col, pressed) {
+        if (row < 8 && col < 8) {
+            if (pressed) {
+                this.keyboardMatrix[row] |= (1 << col);
+            }
+            else {
+                this.keyboardMatrix[row] &= ~(1 << col);
+            }
+        }
+    }
+    /**
+     * Get the current state of the keyboard matrix
+     * @returns Array of 8 bytes representing the matrix state
+     */
+    getMatrixState() {
+        return [...this.keyboardMatrix];
+    }
+    /**
+     * Get the currently selected columns
+     * @returns Byte representing selected columns
+     */
+    getSelectedColumns() {
+        return this.selectedColumns;
+    }
+}
+exports.KeyboardMatrixAttachment = KeyboardMatrixAttachment;
+// Keyboard matrix layout mapping
+// Rows are PA0-PA7, Columns are PB0-PB7
+KeyboardMatrixAttachment.KEYBOARD_LAYOUT = [
+    // PB0    PB1    PB2    PB3    PB4    PB5    PB6    PB7
+    [0x60, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37], // PA0: ` 1 2 3 4 5 6 7
+    [0x38, 0x39, 0x30, 0x2D, 0x3D, 0x08, 0x1B, 0x09], // PA1: 8 9 0 - = BS ESC TAB
+    [0x71, 0x77, 0x65, 0x72, 0x74, 0x79, 0x75, 0x69], // PA2: q w e r t y u i
+    [0x6F, 0x70, 0x5B, 0x5D, 0x5C, 0x1A, 0x00, 0x61], // PA3: o p [ ] \ INS CAPS a
+    [0x73, 0x64, 0x66, 0x67, 0x68, 0x6A, 0x6B, 0x6C], // PA4: s d f g h j k l
+    [0x3B, 0x27, 0x0D, 0x7F, 0x00, 0x7A, 0x78, 0x63], // PA5: ; ' ENTER DEL SHIFT z x c
+    [0x76, 0x62, 0x6E, 0x6D, 0x2C, 0x2E, 0x2F, 0x1E], // PA6: v b n m , . / UP
+    [0x00, 0x00, 0x00, 0x20, 0x00, 0x1C, 0x1F, 0x1D], // PA7: CTRL META ALT SPACE FN LEFT DOWN RIGHT
+];
+//# sourceMappingURL=KeyboardMatrixAttachment.js.map

package/dist/components/IO/Attachments/KeyboardMatrixAttachment.js.map

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

package/dist/components/IO/Attachments/KeypadAttachment.d.ts

@@ -0,0 +1,47 @@
+import { AttachmentBase } from './Attachment';
+/**
+ * KeypadAttachment - Emulates a 4×6 matrix keypad with a built-in hardware encoder
+ *
+ * The encoder converts a key press into a 5-bit code (PA0–PA4) that appears on the GPIO
+ * port.  Bits 5–7 are never driven by the keypad and always read as 0 when data is present.
+ *
+ * Behaviour mirrors a typical 74C922-style encoder:
+ * - On key press  → the 5-bit keypad code is latched and a CA1/CB1 interrupt is asserted
+ * - On port read  → the latched code is returned on bits 0–4 (bits 5–7 = 0)
+ * - clearInterrupts → clears the interrupt and the data-ready latch
+ * - Key releases  → ignored (encoder only reports on the falling edge of a keypress)
+ *
+ * The attachment may be wired to either Port A or Port B via the constructor parameter.
+ * CA1/CB1 is the DA (Data Available) interrupt line from the 74C922.
+ * CA2/CB2 is connected to the 74C922 OE (Output Enable) pin; data is only driven onto the
+ * bus when OE is asserted LOW by the 6522.
+ */
+export declare class KeypadAttachment extends AttachmentBase {
+    private keypadValue;
+    private dataReady;
+    private interruptPending;
+    private readonly attachedToPortA;
+    private oeState;
+    constructor(attachToPortA?: boolean, priority?: number);
+    reset(): void;
+    updateControlLines(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    readPortA(ddr: number, or: number): number;
+    readPortB(ddr: number, or: number): number;
+    hasCA1Interrupt(): boolean;
+    hasCB1Interrupt(): boolean;
+    clearInterrupts(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    /**
+     * Notify the attachment of a USB HID key event.
+     * Key releases are ignored; only presses generate output on the GPIO port.
+     *
+     * @param usbHidKeycode - USB HID usage ID for the key
+     * @param pressed       - true for key-down, false for key-up
+     */
+    updateKey(usbHidKeycode: number, pressed: boolean): void;
+    /**
+     * Returns the current latched keypad code (bits 0–4) or 0xFF if no data is ready.
+     */
+    getCurrentKey(): number;
+    /** Returns true when a key has been pressed and the latch has not yet been cleared. */
+    hasDataReady(): boolean;
+}

package/dist/components/IO/Attachments/KeypadAttachment.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeypadAttachment = void 0;
+const Attachment_1 = require("./Attachment");
+/**
+ * USB HID keycode to keypad value mapping
+ * Maps USB HID usage IDs to the 5-bit keypad codes ($00-$17) per the 6502 Keypad Mapping table
+ *
+ * Keypad layout (4 columns × 6 rows = 24 keys):
+ *   $00 = ◄  $01=1  $02=2  $03=3
+ *   $04 = 4  $05=5  $06=6  $07=7
+ *   $08 = 8  $09=9  $0A=0  $0B=►
+ *   $0C = F  $0D=E  $0E=D  $0F=C
+ *   $10 = ESC  $11=INS  $12=PGUP  $13=A
+ *   $14 = ▲/Enter  $15=DEL  $16=PGDN  $17=B
+ */
+const USB_HID_TO_KEYPAD = {
+    0x50: 0x00, // Left Arrow → ◄
+    0x1E: 0x01, // 1
+    0x1F: 0x02, // 2
+    0x20: 0x03, // 3
+    0x21: 0x04, // 4
+    0x22: 0x05, // 5
+    0x23: 0x06, // 6
+    0x24: 0x07, // 7
+    0x25: 0x08, // 8
+    0x26: 0x09, // 9
+    0x27: 0x0A, // 0
+    0x4F: 0x0B, // Right Arrow → ►
+    0x09: 0x0C, // f → F
+    0x08: 0x0D, // e → E
+    0x07: 0x0E, // d → D
+    0x06: 0x0F, // c → C
+    0x29: 0x10, // Escape → ESC
+    0x49: 0x11, // Insert → INS
+    0x4B: 0x12, // Page Up → PGUP
+    0x04: 0x13, // a → A
+    0x52: 0x14, // Up Arrow → ▲
+    0x28: 0x14, // Enter → ▲
+    0x4C: 0x15, // Delete → DEL
+    0x4E: 0x16, // Page Down → PGDN
+    0x05: 0x17, // b → B
+};
+/**
+ * KeypadAttachment - Emulates a 4×6 matrix keypad with a built-in hardware encoder
+ *
+ * The encoder converts a key press into a 5-bit code (PA0–PA4) that appears on the GPIO
+ * port.  Bits 5–7 are never driven by the keypad and always read as 0 when data is present.
+ *
+ * Behaviour mirrors a typical 74C922-style encoder:
+ * - On key press  → the 5-bit keypad code is latched and a CA1/CB1 interrupt is asserted
+ * - On port read  → the latched code is returned on bits 0–4 (bits 5–7 = 0)
+ * - clearInterrupts → clears the interrupt and the data-ready latch
+ * - Key releases  → ignored (encoder only reports on the falling edge of a keypress)
+ *
+ * The attachment may be wired to either Port A or Port B via the constructor parameter.
+ * CA1/CB1 is the DA (Data Available) interrupt line from the 74C922.
+ * CA2/CB2 is connected to the 74C922 OE (Output Enable) pin; data is only driven onto the
+ * bus when OE is asserted LOW by the 6522.
+ */
+class KeypadAttachment extends Attachment_1.AttachmentBase {
+    constructor(attachToPortA = true, priority = 0) {
+        super(priority, false, false, false, false);
+        this.keypadValue = 0x00;
+        this.dataReady = false;
+        this.interruptPending = false;
+        // OE state: CA2 for Port A, CB2 for Port B.  HIGH = output disabled (default).
+        this.oeState = true;
+        this.attachedToPortA = attachToPortA;
+        this.reset();
+    }
+    reset() {
+        super.reset();
+        this.keypadValue = 0x00;
+        this.dataReady = false;
+        this.interruptPending = false;
+        this.oeState = true; // OE disabled until explicitly asserted by the 6522
+    }
+    updateControlLines(ca1, ca2, cb1, cb2) {
+        // CA2 controls OE for Port A; CB2 controls OE for Port B.
+        // 74C922 OE is active-LOW, so a LOW signal enables the output.
+        this.oeState = this.attachedToPortA ? ca2 : cb2;
+    }
+    readPortA(ddr, or) {
+        // Only drive the bus when attached to Port A, OE is asserted (LOW), and data is latched
+        if (this.attachedToPortA && !this.oeState && this.dataReady) {
+            return this.keypadValue & 0x1F; // bits 0–4 only; bits 5–7 = 0
+        }
+        return 0xFF; // not driving the bus
+    }
+    readPortB(ddr, or) {
+        // Only drive the bus when attached to Port B, OE is asserted (LOW), and data is latched
+        if (!this.attachedToPortA && !this.oeState && this.dataReady) {
+            return this.keypadValue & 0x1F; // bits 0–4 only; bits 5–7 = 0
+        }
+        return 0xFF; // not driving the bus
+    }
+    hasCA1Interrupt() {
+        return this.attachedToPortA && this.interruptPending;
+    }
+    hasCB1Interrupt() {
+        return !this.attachedToPortA && this.interruptPending;
+    }
+    clearInterrupts(ca1, ca2, cb1, cb2) {
+        if ((this.attachedToPortA && ca1) || (!this.attachedToPortA && cb1)) {
+            this.interruptPending = false;
+            this.dataReady = false;
+        }
+    }
+    /**
+     * Notify the attachment of a USB HID key event.
+     * Key releases are ignored; only presses generate output on the GPIO port.
+     *
+     * @param usbHidKeycode - USB HID usage ID for the key
+     * @param pressed       - true for key-down, false for key-up
+     */
+    updateKey(usbHidKeycode, pressed) {
+        if (!pressed) {
+            return;
+        }
+        const keypadCode = USB_HID_TO_KEYPAD[usbHidKeycode];
+        if (keypadCode === undefined) {
+            return; // key is not present on this keypad
+        }
+        this.keypadValue = keypadCode;
+        this.dataReady = true;
+        this.interruptPending = true;
+    }
+    /**
+     * Returns the current latched keypad code (bits 0–4) or 0xFF if no data is ready.
+     */
+    getCurrentKey() {
+        return this.dataReady ? (this.keypadValue & 0x1F) : 0xFF;
+    }
+    /** Returns true when a key has been pressed and the latch has not yet been cleared. */
+    hasDataReady() {
+        return this.dataReady;
+    }
+}
+exports.KeypadAttachment = KeypadAttachment;
+//# sourceMappingURL=KeypadAttachment.js.map

package/dist/components/IO/Attachments/KeypadAttachment.js.map

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

package/dist/components/IO/Attachments/LCDAttachment.d.ts

@@ -0,0 +1,110 @@
+import { AttachmentBase } from './Attachment';
+/**
+ * HD44780 LCD Controller Emulation — GPIO Attachment
+ *
+ * Emulates a 16×2 (or configurable) character LCD with HD44780 controller
+ * connected via 8-bit parallel interface on a 65C22 VIA.
+ *
+ * Pin mapping (accent on VIA ports):
+ *   Port B (D0–D7): 8-bit data bus
+ *   Port A bit 5:   RS  (Register Select — 0 = command, 1 = data)
+ *   Port A bit 6:   RW  (Read/Write — 0 = write, 1 = read)
+ *   Port A bit 7:   E   (Enable — active-high strobe, latched on falling edge)
+ *
+ * Display modes:
+ *   Standard character display with 5×8 pixel characters
+ *   Supports CGRAM for up to 8 user-defined characters
+ *
+ * Output: pixel buffer (cols*(5+1)-1) × (rows*(8+1)-1) with values:
+ *   -1 = no pixel (inter-character gap)
+ *    0 = pixel off
+ *    1 = pixel on
+ *
+ * Reference: vrEmuLcd by Troy Schrapel
+ * https://github.com/visrealm/vrEmuLcd
+ */
+export declare const LCD_CMD_CLEAR = 1;
+export declare const LCD_CMD_HOME = 2;
+export declare const LCD_CMD_ENTRY_MODE = 4;
+export declare const LCD_CMD_ENTRY_MODE_INCREMENT = 2;
+export declare const LCD_CMD_ENTRY_MODE_SHIFT = 1;
+export declare const LCD_CMD_DISPLAY = 8;
+export declare const LCD_CMD_DISPLAY_ON = 4;
+export declare const LCD_CMD_DISPLAY_CURSOR = 2;
+export declare const LCD_CMD_DISPLAY_CURSOR_BLINK = 1;
+export declare const LCD_CMD_SHIFT = 16;
+export declare const LCD_CMD_SHIFT_DISPLAY = 8;
+export declare const LCD_CMD_SHIFT_RIGHT = 4;
+export declare const LCD_CMD_FUNCTION = 32;
+export declare const LCD_CMD_FUNCTION_LCD_2LINE = 8;
+export declare const LCD_CMD_SET_CGRAM_ADDR = 64;
+export declare const LCD_CMD_SET_DRAM_ADDR = 128;
+export declare class LCDAttachment extends AttachmentBase {
+    readonly cols: number;
+    readonly rows: number;
+    private entryModeFlags;
+    private displayFlags;
+    private scrollOffset;
+    /** 128-byte Display Data RAM */
+    private ddRam;
+    /** Current DDRAM pointer offset */
+    private ddPtr;
+    private dataWidthCols;
+    /** Character Generator RAM — 16 characters × 8 rows, stored column-major
+     *  as 16 × CHAR_WIDTH_PX bytes (matching vrEmuLcd cgRam layout) */
+    private cgRam;
+    /** Current CGRAM pointer (null when not in CGRAM mode) */
+    private cgPtr;
+    /** Pixel buffer: each byte is -1 (gap), 0 (off) or 1 (on) */
+    buffer: Int8Array;
+    readonly pixelsWidth: number;
+    readonly pixelsHeight: number;
+    private blinkAccumulator;
+    private blinkState;
+    private static readonly BLINK_PERIOD_MS;
+    private lastPortA;
+    private lastE;
+    constructor(cols?: number, rows?: number, priority?: number);
+    reset(): void;
+    tick(cpuFrequency: number): void;
+    /**
+     * Port A carries the control signals.
+     * We detect E falling edge to latch the bus.
+     */
+    writePortA(value: number, ddr: number): void;
+    readPortA(ddr: number, or: number): number;
+    readPortB(ddr: number, or: number): number;
+    private latchBus;
+    private lastPortBValue;
+    writePortB(value: number, ddr: number): void;
+    sendCommand(command: number): void;
+    writeByte(data: number): void;
+    private readByte;
+    readAddress(): number;
+    private incrementDdPtr;
+    private decrementDdPtr;
+    private doShift;
+    /**
+     * Get the 5-column font data for a character.
+     * Characters 0–15 come from CGRAM; 16–255 from ROM.
+     */
+    private charBits;
+    private getDataOffset;
+    updatePixels(): void;
+    /** Get the raw DDRAM contents */
+    getDDRam(): Uint8Array;
+    /** Get the current DDRAM address pointer */
+    getDDPtr(): number;
+    /** Get the display flags */
+    getDisplayFlags(): number;
+    /** Get the entry mode flags */
+    getEntryModeFlags(): number;
+    /** Get scroll offset */
+    getScrollOffset(): number;
+    /** Get CGRAM pointer (null if not in CGRAM mode) */
+    getCGPtr(): number | null;
+    /** Read the text content of a specific display row */
+    getRowText(row: number): string;
+    /** Pixel state at a given coordinate: -1 (gap), 0 (off), 1 (on) */
+    pixelState(x: number, y: number): number;
+}