@sanohiro/casty 1.0.0 → 1.1.0

package/README.ja.md

@@ -21,7 +21,7 @@ casty は w3m や lynx のようなテキストブラウザではありません
 └──────────────┘      └──────────────┘      └──────────────┘
 ```
 
-レンダリングはすべて Chrome がやります。casty はフレームをターミナルに流して入力を返すだけのブリッジ（約1200行）。Playwright も puppeteer も使わず、WebSocket で生 CDP を叩いています。
+レンダリングはすべて Chrome がやります。casty はフレームをターミナルに流して入力を返すだけのブリッジ（約2300行）。Playwright も puppeteer も使わず、WebSocket で生 CDP を叩いています。
 
 本物の Chrome なので JavaScript, CSS, Canvas, WebGL 全部動きます。ステルスパッチで Google ログインも通ります。マウスのクリック、スクロール、ドラッグ、キーボード入力 — 普通のブラウザと同じ操作ができます。
 
@@ -52,6 +52,15 @@ cd casty && npm install
 - Node.js >= 18
 - `unzip`（Chrome 自動インストールに必要）
 
+### tmux
+
+tmux 内で casty を使う場合は、Kitty graphics のエスケープシーケンスを
+ターミナルまで通すために passthrough を有効にしてください:
+
+```tmux
+set -g allow-passthrough on
+```
+
 ## 使い方
 
 ```bash
@@ -127,7 +136,7 @@ casty   # ホームページを開く
 <details>
 <summary>技術詳細</summary>
 
-全体で約1200行の JavaScript です。中でやっていること:
+全体で約2300行の JavaScript です。中でやっていること:
 
 - chrome-headless-shell を起動して生 CDP WebSocket で通信
 - `Runtime.enable` は絶対に送らない（Google ログインが壊れる。これは苦労して発見した）

package/README.md

@@ -21,7 +21,7 @@ Terminal (you)          casty               Chrome (headless)
 └──────────────┘      └──────────────┘      └──────────────┘
 ```
 
-Chrome does all the rendering. casty is just a bridge (~1200 lines) that streams frames to your terminal and sends input back. No Playwright, no puppeteer — raw CDP over WebSocket.
+Chrome does all the rendering. casty is just a bridge (~2300 lines) that streams frames to your terminal and sends input back. No Playwright, no puppeteer — raw CDP over WebSocket.
 
 Since it's real Chrome, JavaScript, CSS, Canvas, and WebGL all work. Google login works too (stealth patches bypass bot detection). Mouse clicks, scrolling, dragging, typing — everything you'd expect.
 
@@ -52,6 +52,15 @@ Chrome Headless Shell is auto-installed to `~/.casty/browsers/` on first run.
 - Node.js >= 18
 - `unzip` (for Chrome auto-install)
 
+### tmux
+
+If you run casty inside tmux, enable passthrough so Kitty graphics escape
+sequences can reach your terminal:
+
+```tmux
+set -g allow-passthrough on
+```
+
 ## Usage
 
 ```bash

package/lib/kitty.js

@@ -62,9 +62,16 @@ export function cursorHome() {
   process.stdout.write(CURSOR_HOME);
 }
 
+// tmux only forwards kitty graphics if they are wrapped in a DCS passthrough
+// envelope. Regular cursor/control sequences must stay outside that wrapper.
+function wrapKitty(seq) {
+  if (!process.env.TMUX) return seq;
+  return `\x1bPtmux;${seq.replaceAll('\x1b', '\x1b\x1b')}\x1b\\`;
+}
+
 // Clear screen (also delete all Kitty images)
 export function clearScreen() {
-  process.stdout.write('\x1b_Ga=d,d=A,q=2;\x1b\\\x1b[2J\x1b[H');
+  process.stdout.write(`${wrapKitty('\x1b_Ga=d,d=A,q=2;\x1b\\')}\x1b[2J\x1b[H`);
 }
 
 // Hide cursor
@@ -103,7 +110,8 @@ function sendFrameFile(base64Data) {
   lastFrameData = base64Data;
   writeFileSync(tmpFile, Buffer.from(base64Data, 'base64'));
   const crFile = _cols && _rows ? `,c=${_cols},r=${_rows}` : '';
-  process.stdout.write(`${CURSOR_HOME}\x1b_Ga=T,f=100,t=f,q=2,C=1,i=1${crFile};${tmpPathB64}\x1b\\`);
+  const seq = `\x1b_Ga=T,f=100,t=f,q=2,C=1,i=1${crFile};${tmpPathB64}\x1b\\`;
+  process.stdout.write(`${CURSOR_HOME}${wrapKitty(seq)}`);
 }
 
 // Inline mode (4096B chunked, PNG only)
@@ -116,10 +124,11 @@ function sendFrameInline(pngBase64) {
   const CHUNK = 4096;
   const crInline = _cols && _rows ? `,c=${_cols},r=${_rows}` : '';
   if (pngBase64.length <= CHUNK) {
-    process.stdout.write(`${CURSOR_HOME}\x1b_Ga=T,f=100,q=2,C=1,i=1${crInline};${pngBase64}\x1b\\`);
+    const seq = `\x1b_Ga=T,f=100,q=2,C=1,i=1${crInline};${pngBase64}\x1b\\`;
+    process.stdout.write(`${CURSOR_HOME}${wrapKitty(seq)}`);
     return;
   }
-  const parts = [CURSOR_HOME];
+  const parts = [];
   let i = 0;
   while (i < pngBase64.length) {
     const chunk = pngBase64.slice(i, i + CHUNK);
@@ -131,7 +140,7 @@ function sendFrameInline(pngBase64) {
     }
     i += CHUNK;
   }
-  process.stdout.write(parts.join(''));
+  process.stdout.write(`${CURSOR_HOME}${wrapKitty(parts.join(''))}`);
 }
 
 // Reset dedup state (e.g. after resize)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanohiro/casty",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TTY web browser using raw CDP and Kitty graphics protocol",
   "main": "bin/casty.js",
   "bin": {
@@ -13,6 +13,7 @@
   ],
   "scripts": {
     "start": "./bin/casty",
+    "test": "node --test",
     "postinstall": "echo 'Run casty to auto-install Chrome Headless Shell to ~/.casty/browsers/'"
   },
   "keywords": [