✨ Add resize() method and fix process exit delays

- Add resize(cols, rows, options) method to x11 driver for dynamic terminal sizing
- Calculate actual char cell dimensions from window geometry for accurate pixel resizing
- Use unref() on spawned Xvfb and xterm processes so Node.js can exit promptly
- Make canvas dependency optional in package-lock.json

Author: Robdel12

package-lock.json

@@ -127,16 +127,27 @@ async function createSession(options) {
   let tmpDir = join(tmpdir(), `tui-driver-${sessionId}`)
   await mkdir(tmpDir, { recursive: true })
 
-  // Make Xvfb large enough for any terminal size
-  let xvfbWidth = 1920
-  let xvfbHeight = 1080
+  // Calculate character cell size based on font
+  // Approximate: each character cell is ~9px wide, ~18px tall at 14pt font
+  let charWidth = Math.ceil(font.size * 0.65)
+  let charHeight = Math.ceil(font.size * 1.3)
+
+  // Track current dimensions (can be resized later)
+  let currentCols = cols
+  let currentRows = rows
+
+  // Calculate Xvfb size based on terminal dimensions
+  // Add padding for window decorations and margins
+  let xvfbWidth = Math.max(1920, cols * charWidth + 100)
+  let xvfbHeight = Math.max(1080, rows * charHeight + 100)
 
   // Start Xvfb
   let xvfb = spawn(
     'Xvfb',
     [`:${display}`, '-screen', '0', `${xvfbWidth}x${xvfbHeight}x24`, '-ac', '-nolisten', 'tcp'],
-    { stdio: ['ignore', 'pipe', 'pipe'], detached: true }
+    { stdio: 'ignore', detached: true }
   )
+  xvfb.unref()
 
   await sleep(500)
   await waitForX(display)
@@ -163,9 +174,10 @@ async function createSession(options) {
       LANG: 'en_US.UTF-8',
       LC_ALL: 'en_US.UTF-8'
     },
-    stdio: ['ignore', 'pipe', 'pipe'],
+    stdio: 'ignore',
     detached: true
   })
+  xterm.unref()
 
   let windowId = await waitForWindow(display)
 
@@ -282,6 +294,53 @@ async function createSession(options) {
       throw new Error('waitForText is not supported by the x11 driver')
     },
 
+    async resize(newCols, newRows, options = {}) {
+      if (closed) throw new Error('Session is closed')
+      let { clear = true } = options
+
+      // Get current window geometry to calculate actual cell size
+      let { stdout } = await execAsync(`DISPLAY=:${display} xdotool getwindowgeometry ${windowId}`)
+      let match = stdout.match(/Geometry: (\d+)x(\d+)/)
+      if (!match) throw new Error('Could not get window geometry')
+
+      let currentPixelWidth = parseInt(match[1], 10)
+      let currentPixelHeight = parseInt(match[2], 10)
+
+      // Calculate actual character cell dimensions from current window
+      let actualCharWidth = currentPixelWidth / currentCols
+      let actualCharHeight = currentPixelHeight / currentRows
+
+      // Calculate new pixel dimensions
+      let pixelWidth = Math.round(newCols * actualCharWidth)
+      let pixelHeight = Math.round(newRows * actualCharHeight)
+
+      // Resize the Xvfb screen if needed
+      let newXvfbWidth = Math.max(xvfbWidth, pixelWidth + 100)
+      let newXvfbHeight = Math.max(xvfbHeight, pixelHeight + 100)
+
+      if (newXvfbWidth > xvfbWidth || newXvfbHeight > xvfbHeight) {
+        // xrandr can resize the virtual screen
+        await execAsync(`DISPLAY=:${display} xrandr --fb ${newXvfbWidth}x${newXvfbHeight}`).catch(() => {})
+        xvfbWidth = newXvfbWidth
+        xvfbHeight = newXvfbHeight
+      }
+
+      // Resize the xterm window
+      await execAsync(`DISPLAY=:${display} xdotool windowsize ${windowId} ${pixelWidth} ${pixelHeight}`)
+      await sleep(200)
+
+      // Update stored dimensions
+      currentCols = newCols
+      currentRows = newRows
+
+      // Clear the terminal for a fresh start
+      if (clear) {
+        await this.type('clear')
+        await this.press('Enter')
+        await sleep(100)
+      }
+    },
+
     async screenshot() {
       if (closed) throw new Error('Session is closed')
 

src/drivers/x11.js

@@ -71,6 +71,22 @@ class TerminalSession {
     })
   }
 
+  /**
+   * Resize the terminal
+   * @param {number} cols - Number of columns
+   * @param {number} rows - Number of rows
+   * @param {object} [options]
+   * @param {boolean} [options.clear=true] - Clear terminal after resize
+   */
+  async resize(cols, rows, options = {}) {
+    this.#assertOpen()
+    if (this.#driverSession.resize) {
+      await this.#driverSession.resize(cols, rows, options)
+    } else {
+      throw new Error('resize is not supported by this driver')
+    }
+  }
+
   /**
    * Capture a screenshot
    * @param {object} [options]