Merge nm-kitty-meow (PR coder/ghostty-web#162): Upgrade to Ghostty 1.3

Brings in NimbleMarkets/ghostty-web@nm-kitty-meow: bump ghostty submodule to
upstream main, drop now-upstreamed WASM patches, rewire WASM bindings onto
upstream's C ABI, add kitty graphics support (PNG decode + placement
compositing), event-driven render scheduler, and the U+10EEEE Unicode
placeholder protocol.

Conflict resolution:
- lib/renderer.ts (dirty-rows union): include both cursorRows.has(y) from
  main and this.kittyDamagedRows.has(y) from the PR.
- lib/renderer.ts (block-element rendering): keep main's drawBoxOrBlock
  path. main's box-drawing system (U+2500..U+259F) is a superset of the
  PR's renderBlockElement (U+2580..U+259F) so the PR's narrower fast path
  is dropped to avoid the wider drawBoxOrBlock not running for blocks.
  renderBlockElement remains defined but unused; a follow-up can prune.
- lib/renderer.ts (kitty composite gate): replace the PR's anyLinesRendered
  flag (lost in main's collect-then-render refactor) with linesToRender.length > 0.
- lib/terminal.ts (handleFontChange/resize): keep main's removal of the
  canvas.width/style writes (renderer.resize now owns canvas sizing) while
  adopting the PR's updateWasmPixelSize() calls for kitty graphics size sync.
- patches/ghostty-wasm-api.patch: take the PR version (rewritten to match
  ghostty 1.3 upstream).

Author: sauyon

.github/actions/setup-zig/action.yml

@@ -9,7 +9,7 @@ runs:
   using: 'composite'
   steps:
     - name: Cache Zig
-      uses: actions/cache@v4
+      uses: actions/cache@v5
       id: cache-zig
       with:
         path: |

.github/workflows/ci.yml

@@ -11,9 +11,9 @@ jobs:
     name: fmt
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: oven-sh/setup-bun@v1
+      - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
 
@@ -27,9 +27,9 @@ jobs:
     name: lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: oven-sh/setup-bun@v1
+      - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
 
@@ -43,9 +43,9 @@ jobs:
     name: type check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: oven-sh/setup-bun@v1
+      - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
 
@@ -59,11 +59,11 @@ jobs:
     name: test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           submodules: recursive
 
-      - uses: oven-sh/setup-bun@v1
+      - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
 
@@ -84,11 +84,11 @@ jobs:
     name: build
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           submodules: recursive
 
-      - uses: oven-sh/setup-bun@v1
+      - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
 
@@ -103,8 +103,8 @@ jobs:
         run: |
           SIZE=$(stat -c%s ghostty-vt.wasm)
           echo "WASM size: $SIZE bytes"
-          if [ "$SIZE" -gt 524288 ]; then
-            echo "❌ Error: WASM exceeds 512 KB limit"
+          if [ "$SIZE" -gt 786432 ]; then
+            echo "❌ Error: WASM exceeds 768 KB limit"
             exit 1
           fi
 

.github/workflows/publish.yml

@@ -23,14 +23,14 @@ jobs:
     if: ${{ github.event.workflow_run.conclusion == 'success' || github.event_name == 'push' }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           ref: ${{ github.ref }}
           fetch-depth: 0 # Required for git describe to find tags
           submodules: recursive
 
       - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
+        uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
 
@@ -61,9 +61,9 @@ jobs:
         run: bun run build
 
       - name: Setup Node.js for npm
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '24'
           registry-url: 'https://registry.npmjs.org'
 
       # Ensure npm 11.5.1 or later for trusted publishing
@@ -159,15 +159,15 @@ jobs:
     if: ${{ github.event.workflow_run.conclusion == 'success' || github.event_name == 'push' }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           ref: ${{ github.ref }}
           fetch-depth: 0
 
       - name: Setup Node.js for npm
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '24'
           registry-url: 'https://registry.npmjs.org'
 
       - run: npm install -g npm@latest

bun.lock

@@ -13,8 +13,13 @@ import { homedir } from 'os';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
-// Node-pty for cross-platform PTY support
-import pty from '@lydell/node-pty';
+// Node-pty for cross-platform PTY support. The 1.2.0-beta.x line adds a
+// `pixelSize` argument to resize(), which sets ws_xpixel / ws_ypixel in
+// the slave PTY's winsize struct so kitty kittens (icat etc.) can detect
+// graphics support via TIOCGWINSZ instead of falling back to terminal
+// queries. Lydell's fork is based on 1.1.0-beta14 (pre-pixelSize), so we
+// use upstream's beta directly.
+import pty from 'node-pty';
 // WebSocket server
 import { WebSocketServer } from 'ws';
 
@@ -243,12 +248,32 @@ const HTML_TEMPLATE = `<!doctype html>
       const wsUrl = protocol + '//' + window.location.host + '/ws?cols=' + term.cols + '&rows=' + term.rows;
       let ws;
 
+      // Read total canvas pixel dims (CSS pixels). The server stuffs these
+      // into ws_xpixel / ws_ypixel via node-pty's resize(cols, rows, pixelSize)
+      // so kittens like icat see non-zero TIOCGWINSZ pixel fields.
+      function getPixelSize() {
+        const canvas = container.querySelector('canvas');
+        return canvas
+          ? { xpixel: canvas.clientWidth, ypixel: canvas.clientHeight }
+          : { xpixel: 0, ypixel: 0 };
+      }
+
       function connect() {
         setStatus('connecting', 'Connecting...');
         ws = new WebSocket(wsUrl);
 
         ws.onopen = () => {
           setStatus('connected', 'Connected');
+          // Push initial pixel dims so TIOCGWINSZ-gated tools see them
+          // before the first resize event.
+          const px = getPixelSize();
+          ws.send(JSON.stringify({
+            type: 'resize',
+            cols: term.cols,
+            rows: term.rows,
+            xpixel: px.xpixel,
+            ypixel: px.ypixel,
+          }));
         };
 
         ws.onmessage = (event) => {
@@ -278,7 +303,14 @@ const HTML_TEMPLATE = `<!doctype html>
       // Handle resize - notify PTY when terminal dimensions change
       term.onResize(({ cols, rows }) => {
         if (ws && ws.readyState === WebSocket.OPEN) {
-          ws.send(JSON.stringify({ type: 'resize', cols, rows }));
+          const px = getPixelSize();
+          ws.send(JSON.stringify({
+            type: 'resize',
+            cols,
+            rows,
+            xpixel: px.xpixel,
+            ypixel: px.ypixel,
+          }));
         }
       });
 
@@ -463,7 +495,18 @@ wss.on('connection', (ws, req) => {
       try {
         const msg = JSON.parse(message);
         if (msg.type === 'resize') {
-          ptyProcess.resize(msg.cols, msg.rows);
+          // node-pty 1.2.0+ accepts a third pixelSize arg that sets
+          // ws_xpixel / ws_ypixel in the PTY winsize struct. Without it,
+          // kitty kittens (icat, etc.) read zeros via TIOCGWINSZ and
+          // refuse to render images.
+          if (msg.xpixel > 0 && msg.ypixel > 0) {
+            ptyProcess.resize(msg.cols, msg.rows, {
+              width: msg.xpixel,
+              height: msg.ypixel,
+            });
+          } else {
+            ptyProcess.resize(msg.cols, msg.rows);
+          }
           return;
         }
       } catch (e) {

demo/bin/demo.js

@@ -138,6 +138,20 @@
       let ws;
       let fitAddon;
 
+      // Read total canvas pixel dimensions (CSS pixels). Used so the
+      // server can stuff ws_xpixel / ws_ypixel into the PTY winsize via
+      // node-pty's resize(cols, rows, pixelSize) — kitty kittens (icat
+      // etc.) read those fields from their stdin and bail "doesn't
+      // support reporting screen sizes in pixels" if they're zero.
+      // Module-scope so both initTerminal and connectWebSocket can call it.
+      function getPixelSize() {
+        const container = document.getElementById('terminal-container');
+        const canvas = container?.querySelector('canvas');
+        return canvas
+          ? { xpixel: canvas.clientWidth, ypixel: canvas.clientHeight }
+          : { xpixel: 0, ypixel: 0 };
+      }
+
       async function initTerminal() {
         // Initialize WASM
         await init();
@@ -168,8 +182,16 @@
         // Handle terminal resize
         term.onResize((size) => {
           if (ws && ws.readyState === WebSocket.OPEN) {
-            // Send resize as control sequence (server expects this format)
-            ws.send(JSON.stringify({ type: 'resize', cols: size.cols, rows: size.rows }));
+            const px = getPixelSize();
+            ws.send(
+              JSON.stringify({
+                type: 'resize',
+                cols: size.cols,
+                rows: size.rows,
+                xpixel: px.xpixel,
+                ypixel: px.ypixel,
+              })
+            );
           }
         });
 
@@ -200,6 +222,19 @@
         ws.onopen = () => {
           console.log('WebSocket connected');
           updateConnectionStatus(true);
+          // Push initial pixel dims into the PTY winsize so tools that
+          // gate on TIOCGWINSZ (e.g. kitten icat) can detect graphics
+          // support without falling back to terminal queries.
+          const px = getPixelSize();
+          ws.send(
+            JSON.stringify({
+              type: 'resize',
+              cols: term.cols,
+              rows: term.rows,
+              xpixel: px.xpixel,
+              ypixel: px.ypixel,
+            })
+          );
         };
 
         ws.onmessage = (event) => {

demo/bun.lock

@@ -11,7 +11,7 @@
     "dev": "node bin/demo.js --dev"
   },
   "dependencies": {
-    "@lydell/node-pty": "^1.0.1",
+    "node-pty": "1.2.0-beta.12",
     "ghostty-web": "latest",
     "ws": "^8.18.0"
   },