vt100.js 0.2.3 → 0.3.1

package/README.md

@@ -6,15 +6,17 @@ Part of the [vterm](https://github.com/beorn/vterm) monorepo.
 
 ## Features
 
-- Full VT100/ANSI escape sequence parsing
-- SGR attributes (bold, italic, underline styles, colors, strikethrough, etc.)
-- 16-color, 256-color, and 24-bit truecolor support
-- Cursor movement, save/restore (DECSC/DECRC)
-- Screen modes (alternate screen, auto-wrap, origin mode, etc.)
+- Strict DEC VT100 (1978) emulation — monochrome display
+- SGR attributes: bold, underline (boolean), blink, inverse
+- Cursor movement (CUP, CUU, CUD, CUF, CUB, CHA, CNL, CPL, HVP, VPA)
+- Cursor save/restore (DECSC/DECRC)
+- Erase display/line (ED/EL)
 - Scroll regions (DECSTBM) with content preservation
+- Scroll up/down (SU/SD)
 - Scrollback buffer with configurable limit
-- Insert/delete characters and lines
-- Wide character support (CJK, emoji)
+- Screen modes (auto-wrap, origin mode, cursor visibility)
+- DEC special graphics charset
+- DA1/DSR/CPR device responses
 - Zero dependencies — works in Bun, Node.js, and browsers
 
 ## Install
@@ -70,16 +72,13 @@ console.log(screen.getCursorPosition()) // { x: 18, y: 0 }
 ```typescript
 interface ScreenCell {
   char: string
-  fg: CellColor | null // { r, g, b }
-  bg: CellColor | null
+  fg: CellColor | null // always null (VT100 is monochrome)
+  bg: CellColor | null // always null (VT100 is monochrome)
   bold: boolean
-  faint: boolean
-  italic: boolean
-  underline: "none" | "single" | "double" | "curly" | "dotted" | "dashed"
-  strikethrough: boolean
+  underline: boolean
+  blink: boolean
   inverse: boolean
   hidden: boolean
-  wide: boolean
 }
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vt100.js",
-  "version": "0.2.3",
-  "description": "Pure TypeScript VT100 terminal emulator. Zero dependencies, headless, fast.",
+  "version": "0.3.1",
+  "description": "VT100 terminal emulator — monochrome, cursor, scroll regions. Pure TypeScript, zero dependencies.",
   "keywords": [
     "ansi",
     "headless",
@@ -14,7 +14,7 @@
   "homepage": "https://github.com/beorn/vterm/tree/main/packages/vt100",
   "bugs": "https://github.com/beorn/vterm/issues",
   "license": "MIT",
-  "author": "Beorn",
+  "author": "Bjørn Stabell",
   "repository": {
     "type": "git",
     "url": "https://github.com/beorn/vterm.git",

package/src/screen.ts

@@ -1,14 +1,14 @@
 /**
- * Pure TypeScript VT100/VT220 terminal emulator.
+ * Pure TypeScript VT100 terminal emulator.
  *
- * Inspired by the Rust vt100 crate — parses a terminal byte stream and
- * maintains an in-memory screen representation with per-cell attributes,
- * cursor tracking, and mode state.
+ * Strict DEC VT100 (1978) implementation: monochrome display, cursor movement,
+ * scroll regions, auto-wrap, origin mode, DEC special graphics charset.
+ * SGR supports bold, underline, blink, and reverse — NO colors (VT100 is
+ * monochrome). No insert mode, no insert/delete chars/lines — those are
+ * VT102/VT220 features.
  *
- * Zero dependencies. Handles: SGR (8 standard colors, bold, underline, blink,
- * reverse, hidden), cursor movement, erase, scroll regions, modes, OSC title,
- * DA1/DSR responses, and more. No truecolor, no 256 colors, no wide chars —
- * those belong in vterm.js.
+ * Zero dependencies. For colors and VT220 features, use vt220.js.
+ * For truecolor, 256 colors, and wide chars, use vterm.js.
  */
 
 // ═══════════════════════════════════════════════════════
@@ -48,21 +48,6 @@ function emptyCell(): ScreenCell {
   return { ...EMPTY_CELL }
 }
 
-// ═══════════════════════════════════════════════════════
-// ANSI 8-color palette (standard VT100/VT220 colors)
-// ═══════════════════════════════════════════════════════
-
-const ANSI_8: readonly CellColor[] = [
-  { r: 0x00, g: 0x00, b: 0x00 }, // 0  Black
-  { r: 0x80, g: 0x00, b: 0x00 }, // 1  Red
-  { r: 0x00, g: 0x80, b: 0x00 }, // 2  Green
-  { r: 0x80, g: 0x80, b: 0x00 }, // 3  Yellow
-  { r: 0x00, g: 0x00, b: 0x80 }, // 4  Blue
-  { r: 0x80, g: 0x00, b: 0x80 }, // 5  Magenta
-  { r: 0x00, g: 0x80, b: 0x80 }, // 6  Cyan
-  { r: 0xc0, g: 0xc0, b: 0xc0 }, // 7  White
-]
-
 // ═══════════════════════════════════════════════════════
 // Screen
 // ═══════════════════════════════════════════════════════
@@ -110,7 +95,7 @@ export function createScreen(opts: ScreenOptions): Screen {
   const scrollbackLimit = opts.scrollbackLimit ?? 1000
   const onResponse = opts.onResponse
 
-  // Main screen buffer (no alternate screen in VT100/VT220)
+  // Main screen buffer (no alternate screen in VT100)
   let grid: ScreenCell[][] = makeGrid(cols, rows)
   let scrollback: ScreenCell[][] = []
 
@@ -146,7 +131,6 @@ export function createScreen(opts: ScreenOptions): Screen {
   let applicationKeypad = false
   let autoWrap = true
   let originMode = false
-  let insertMode = false
   let reverseVideo = false
 
   // Scroll region (inclusive, 0-based)
@@ -241,13 +225,6 @@ export function createScreen(opts: ScreenOptions): Screen {
       }
     }
 
-    // Insert mode: shift existing characters right before writing
-    if (insertMode) {
-      const row = grid[curY]!
-      row.splice(curX, 0, EMPTY_CELL)
-      row.pop()
-    }
-
     // Copy-on-write: if cell is the shared EMPTY_CELL sentinel, create a fresh object
     const row = grid[curY]!
     let cell = row[curX]!
@@ -315,21 +292,6 @@ export function createScreen(opts: ScreenOptions): Screen {
       case "K": // EL - Erase in Line
         handleEraseLine(parts[0] ?? 0)
         break
-      case "L": // IL - Insert Lines
-        handleInsertLines(Math.max(parts[0] ?? 1, 1))
-        break
-      case "M": // DL - Delete Lines
-        handleDeleteLines(Math.max(parts[0] ?? 1, 1))
-        break
-      case "P": // DCH - Delete Characters
-        handleDeleteChars(Math.max(parts[0] ?? 1, 1))
-        break
-      case "@": // ICH - Insert Characters
-        handleInsertChars(Math.max(parts[0] ?? 1, 1))
-        break
-      case "X": // ECH - Erase Characters
-        handleEraseChars(Math.max(parts[0] ?? 1, 1))
-        break
       case "S": // SU - Scroll Up
         for (let i = 0; i < Math.max(parts[0] ?? 1, 1); i++) {
           scrollUp(scrollTop, scrollBottom)
@@ -393,14 +355,6 @@ export function createScreen(opts: ScreenOptions): Screen {
     }
   }
 
-  function handleCSIWithIntermediate(_params: string, intermediate: string, finalByte: string): void {
-    if (intermediate === "!" && finalByte === "p") {
-      // DECSTR - Soft Terminal Reset
-      softReset()
-    }
-    // Unknown intermediate sequences — ignore
-  }
-
   function handleCSIPrivate(params: string, finalByte: string): void {
     const parts = params.split(";").map((s) => (s === "" ? 0 : parseInt(s, 10)))
     const set = finalByte === "h"
@@ -410,9 +364,6 @@ export function createScreen(opts: ScreenOptions): Screen {
         case 1: // DECCKM - Application Cursor
           applicationCursor = set
           break
-        case 4: // IRM - Insert Mode (via DEC private)
-          insertMode = set
-          break
         case 5: // DECSCNM - Reverse Video
           reverseVideo = set
           break
@@ -432,20 +383,6 @@ export function createScreen(opts: ScreenOptions): Screen {
     }
   }
 
-  // Also handle standard (non-private) set/reset modes: CSI Ps h / CSI Ps l
-  function handleSetResetMode(params: string, finalByte: string): void {
-    const parts = params.split(";").map((s) => (s === "" ? 0 : parseInt(s, 10)))
-    const set = finalByte === "h"
-
-    for (const code of parts) {
-      switch (code) {
-        case 4: // IRM - Insert/Replace Mode
-          insertMode = set
-          break
-      }
-    }
-  }
-
   function handleEraseDisplay(mode: number): void {
     switch (mode) {
       case 0: // Erase from cursor to end
@@ -494,49 +431,9 @@ export function createScreen(opts: ScreenOptions): Screen {
     }
   }
 
-  function handleInsertLines(count: number): void {
-    if (curY < scrollTop || curY > scrollBottom) return
-    for (let i = 0; i < count; i++) {
-      scrollDown(curY, scrollBottom)
-    }
-  }
-
-  function handleDeleteLines(count: number): void {
-    if (curY < scrollTop || curY > scrollBottom) return
-    for (let i = 0; i < count; i++) {
-      scrollUp(curY, scrollBottom)
-    }
-  }
-
-  function handleDeleteChars(count: number): void {
-    const row = grid[curY]
-    if (!row) return
-    for (let i = 0; i < count; i++) {
-      if (curX < cols) {
-        row.splice(curX, 1)
-        row.push(emptyCell())
-      }
-    }
-  }
-
-  function handleInsertChars(count: number): void {
-    const row = grid[curY]
-    if (!row) return
-    for (let i = 0; i < count; i++) {
-      row.splice(curX, 0, emptyCell())
-      row.pop()
-    }
-  }
-
-  function handleEraseChars(count: number): void {
-    const row = grid[curY]
-    if (!row) return
-    for (let i = 0; i < count && curX + i < cols; i++) {
-      row[curX + i] = emptyCell()
-    }
-  }
-
   // ── SGR (Select Graphic Rendition) ──
+  // VT100 is monochrome: only bold (1), underline (4), blink (5), reverse (7).
+  // Color codes are silently ignored for forward compatibility.
 
   function handleSGR(rawParams: string): void {
     const params = rawParams.split(";").map((s) => (s === "" ? 0 : parseInt(s, 10)))
@@ -565,9 +462,6 @@ export function createScreen(opts: ScreenOptions): Screen {
         case 7:
           attrs.inverse = true
           break
-        case 8: // Hidden/conceal
-          attrs.hidden = true
-          break
         case 22: // Normal intensity (turn off bold)
           attrs.bold = false
           break
@@ -580,38 +474,8 @@ export function createScreen(opts: ScreenOptions): Screen {
         case 27:
           attrs.inverse = false
           break
-        case 28: // Reveal (turn off hidden/conceal)
-          attrs.hidden = false
-          break
-        // Foreground colors 30-37
-        case 30:
-        case 31:
-        case 32:
-        case 33:
-        case 34:
-        case 35:
-        case 36:
-        case 37:
-          attrs.fg = { ...ANSI_8[code - 30]! }
-          break
-        case 39: // Default foreground
-          attrs.fg = null
-          break
-        // Background colors 40-47
-        case 40:
-        case 41:
-        case 42:
-        case 43:
-        case 44:
-        case 45:
-        case 46:
-        case 47:
-          attrs.bg = { ...ANSI_8[code - 40]! }
-          break
-        case 49: // Default background
-          attrs.bg = null
-          break
-        // Skip extended color sequences (not supported, but must consume params)
+        // Color codes silently ignored — VT100 is monochrome
+        // Skip extended color sequences to consume params correctly
         case 38:
         case 48:
           if (i + 1 < params.length && params[i + 1] === 2) {
@@ -620,6 +484,8 @@ export function createScreen(opts: ScreenOptions): Screen {
             i += 2 // skip 38;5;N or 48;5;N
           }
           break
+        // All other SGR codes (colors 30-37, 40-47, 39, 49, 8, 28, etc.)
+        // are silently ignored for forward compatibility
       }
       i++
     }
@@ -761,27 +627,8 @@ export function createScreen(opts: ScreenOptions): Screen {
             // Final byte — dispatch CSI
             if (escBuf.startsWith("?")) {
               handleCSIPrivate(escBuf.substring(1), ch)
-            } else if (ch === "h" || ch === "l") {
-              // Standard set/reset mode (non-private)
-              handleSetResetMode(escBuf, ch)
             } else {
-              // Check for intermediate bytes (0x20-0x2F range, e.g., "!" in CSI ! p)
-              // Find first intermediate byte in escBuf
-              let intermediateIdx = -1
-              for (let j = 0; j < escBuf.length; j++) {
-                const c = escBuf.charCodeAt(j)
-                if (c >= 0x20 && c <= 0x2f) {
-                  intermediateIdx = j
-                  break
-                }
-              }
-              if (intermediateIdx >= 0) {
-                const paramPart = escBuf.substring(0, intermediateIdx)
-                const intermediatePart = escBuf.substring(intermediateIdx)
-                handleCSIWithIntermediate(paramPart, intermediatePart, ch)
-              } else {
-                handleCSI(escBuf, ch)
-              }
+              handleCSI(escBuf, ch)
             }
             parserState = "ground"
           } else if (escBuf.length >= 256) {
@@ -843,7 +690,6 @@ export function createScreen(opts: ScreenOptions): Screen {
     applicationKeypad = false
     autoWrap = true
     originMode = false
-    insertMode = false
     reverseVideo = false
     scrollTop = 0
     scrollBottom = rows - 1
@@ -853,22 +699,6 @@ export function createScreen(opts: ScreenOptions): Screen {
     oscBuf = ""
   }
 
-  function softReset(): void {
-    attrs = resetAttrs()
-    applicationCursor = false
-    applicationKeypad = false
-    autoWrap = true
-    originMode = false
-    insertMode = false
-    reverseVideo = false
-    curVisible = true
-    scrollTop = 0
-    scrollBottom = rows - 1
-    savedState = { curX: 0, curY: 0, attrs: resetAttrs(), originMode: false, autoWrap: true }
-    savedCurX = 0
-    savedCurY = 0
-  }
-
   function resize(newCols: number, newRows: number): void {
     const newGrid = makeGrid(newCols, newRows)
 
@@ -969,8 +799,6 @@ export function createScreen(opts: ScreenOptions): Screen {
         return autoWrap
       case "originMode":
         return originMode
-      case "insertMode":
-        return insertMode
       case "reverseVideo":
         return reverseVideo
       default: