@sanohiro/casty 0.5.4 → 0.5.6

package/README.ja.md

@@ -1,47 +1,33 @@
 # casty
 
-Kitty graphics protocol を使った TTY Web ブラウザ。
+ターミナルで本物の Chrome ブラウザを動かす。
 
 **[English](README.md)**
 
-ヘッドレス Chrome のレンダリングを Kitty 対応ターミナルに表示し、ターミナル上で完全な Web ブラウジングを実現します。
+casty は w3m や lynx のようなテキストブラウザではありません。ヘッドレス Chrome を起動し、CDP でレンダリング結果を取得して、Kitty graphics protocol でターミナルに描画します。Chrome のリモートデスクトップがターミナルに収まった感じです。
 
-<video src="https://github.com/user-attachments/assets/330bf0c3-dd08-44a5-b627-b90c200d57fe" autoplay loop muted playsinline></video>
+<video src="https://github.com/user-attachments/assets/552f1972-bb53-481e-9516-c36b7e5085d8" autoplay loop muted playsinline></video>
+
+## 仕組み
 
 ```
-Chrome (Headless Shell)     casty              Terminal
-┌─────────────────┐      ┌─────────────────┐  ┌─────────────────┐
-│  Web レンダリング │ ───→ │  高解像度       │ ─→│  Kitty graphics │
-│  JS 実行         │      │  キャプチャ     │  │  画面表示       │
-│  フルブラウザ     │ ←─── │  入力ブリッジ    │ ←─│  マウス/キーボード│
-└─────────────────┘      └─────────────────┘  └─────────────────┘
+ターミナル（あなた）     casty               Chrome（ヘッドレス）
+┌──────────────┐      ┌──────────────┐      ┌──────────────┐
+│  Kitty       │ ←──  │  Screencast  │ ←──  │  完全な Web   │
+│  graphics    │      │  + 高解像度   │      │  レンダリング  │
+│  画面表示     │      │  キャプチャ   │      │  JS, CSS,    │
+│              │ ──→  │  入力        │ ──→  │  Canvas,     │
+│  マウス/KB    │      │  ブリッジ     │      │  WebGL       │
+└──────────────┘      └──────────────┘      └──────────────┘
 ```
 
-## 機能
-
-- ヘッドレス Chrome によるフル Web レンダリング (生 CDP、Playwright 不使用)
-- ボット検出回避のステルスパッチ (Google ログイン可能)
-- Kitty graphics protocol による画像表示
-- マウス操作 (クリック、スクロール、ドラッグ)
-- キーボード入力を Chrome にパススルー
-- Vimium 風ヒントモード (Alt+F) でキーボードナビゲーション
-- アドレスバー + 検索 (Alt+L)
-- ブックマーク (アドレスバーで `/b` 検索)
-- テキスト選択コピー / クリップボードペースト
-- ターミナルのフォントサイズに基づく自動ズーム
-- 動的リサイズ (SIGWINCH)
-- キーバインド設定 (`~/.casty/keys.json`)
-- 各種設定 (`~/.casty/config.json`)
-- ファイルダウンロード (`~/Downloads/` に保存)
-- ローディングインジケーター
-- プロファイル自動クリーンアップによる高速起動
-
-## 必要環境
-
-- **Kitty graphics protocol** 対応ターミナル
-- Node.js >= 18
+レンダリングはすべて Chrome がやります。casty はフレームをターミナルに流して入力を返すだけのブリッジ（約1200行）。Playwright も puppeteer も使わず、WebSocket で生 CDP を叩いています。
 
-動作確認済み: **bcon**, **Ghostty**, **kitty**
+本物の Chrome なので JavaScript, CSS, Canvas, WebGL 全部動きます。ステルスパッチで Google ログインも通ります。マウスのクリック、スクロール、ドラッグ、キーボード入力 — 普通のブラウザと同じ操作ができます。
+
+## どういうときに使う？
+
+SSH でヘッドレスサーバーに入っていて Web ページを確認したいとき、普通は `curl` か `lynx` か X11 転送しかない。casty ならターミナルを離れずに本物のブラウザが使えます。X11 も VNC も Wayland もいらない。Kitty 対応ターミナルさえあれば OK。
 
 ## インストール
 
@@ -50,128 +36,122 @@ npm install -g @sanohiro/casty
 casty
 ```
 
-ソースからインストールする場合:
+ソースから:
 
 ```bash
 git clone https://github.com/sanohiro/casty.git
-cd casty
-npm install
+cd casty && npm install
 ./bin/casty
 ```
 
-初回起動時に Chrome Headless Shell が `~/.casty/browsers/` に自動インストールされます。以降の起動時にバックグラウンドで更新チェックし、常に一世代だけ保持します。
+初回起動時に Chrome Headless Shell が `~/.casty/browsers/` に自動インストールされます。
+
+### 必要環境
+
+- **Kitty graphics protocol** 対応ターミナル（動作確認済み: Ghostty, kitty, bcon）
+- Node.js >= 18
+- `unzip`（Chrome 自動インストールに必要）
 
 ## 使い方
 
 ```bash
 casty https://google.com
 casty https://youtube.com
-casty   # ホームページを開く (デフォルト: casty GitHub ページ)
+casty   # ホームページを開く
 ```
 
 ### キーバインド
 
 | キー | アクション |
 |------|-----------|
-| Alt+L | アドレスバーを開く |
-| Alt+F | ヒントモード (Vimium 風リンク/ボタン選択) |
-| Alt+Left | 戻る |
-| Alt+Right | 進む |
+| Alt+L | アドレスバー |
+| Alt+F | ヒントモード（Vimium 風） |
+| Alt+Left / Right | 戻る / 進む |
 | Alt+C | 選択テキストをコピー |
-| Ctrl+V | クリップボードからペースト |
+| Ctrl+V | ペースト |
 | Ctrl+Q | 終了 |
-| Ctrl+C | 終了 (フォールバック) |
-
-`~/.casty/keys.json` でカスタマイズ可能 (ファイルは自動生成されません):
-
-```json
-{
-  "ctrl+q": "quit",
-  "alt+left": "back",
-  "alt+right": "forward",
-  "alt+l": "url_bar",
-  "alt+f": "hints",
-  "alt+c": "copy",
-  "ctrl+v": "paste"
-}
-```
 
-### アドレスバー
-
-- **Alt+L** または1行目クリックでフォーカス — URL が全選択状態になる
-- **Enter** で移動 (URL) または検索 (Google)
-- **`/b クエリ`** でブックマーク検索
-- **Escape** でキャンセル
-- **Ctrl+A** 全選択、**Ctrl+U** 全消去、**Ctrl+W** 単語削除
+`~/.casty/keys.json` でカスタマイズ可能。
 
 ### ヒントモード
 
-**Alt+F** でクリック可能/フォーカス可能な要素にラベルを表示。ラベルの文字を入力するとリンク/ボタンのクリックや入力欄へのフォーカスができます。**Escape** でキャンセル。
+**Alt+F** でクリック可能な要素にラベルを表示。ラベルを入力してクリック。ホームロウキー (`a s d f j k l`) を使用。
 
-ラベルはホームロウキー (`a`, `s`, `d`, `f`, `j`, `k`, `l`) を使用 — 7個以下なら1文字、それ以上は2文字 (最大49個)。
+### アドレスバー
+
+**Alt+L** で開く。URL または検索クエリを入力。`/b クエリ` でブックマーク検索。
 
 ### ブックマーク
 
-`~/.casty/bookmarks.json` を手動で作成:
+`~/.casty/bookmarks.json` を作成:
 
 ```json
 {
   "GitHub": "https://github.com",
-  "Google": "https://google.com",
   "YouTube": "https://youtube.com"
 }
 ```
 
-アドレスバーで `/b クエリ` と入力して検索 (名前・URL の部分一致、大文字小文字無視)。
-
 ### 設定
 
-`~/.casty/config.json` でカスタマイズ可能 (ファイルは自動生成されません):
+`~/.casty/config.json`:
 
 ```json
 {
   "homeUrl": "https://github.com/sanohiro/casty",
   "searchUrl": "https://www.google.com/search?q=",
   "transport": "auto",
-  "format": "auto"
+  "format": "auto",
+  "mouseMode": 1002
 }
 ```
 
 | キー | 説明 | デフォルト |
 |------|------|-----------|
-| `homeUrl` | URL 未指定時に開くページ | `https://github.com/sanohiro/casty` |
-| `searchUrl` | 検索エンジン URL (クエリが末尾に付加される) | `https://www.google.com/search?q=` |
-| `transport` | Kitty 画像転送方式: `auto`, `file`, `inline` | `auto` (bcon→file、他→inline) |
-| `format` | スクリーンショット形式: `auto`, `png`, `jpeg` | `auto` (file→jpeg、inline→png) |
-
-## アーキテクチャ
+| `homeUrl` | スタートページ | `https://github.com/sanohiro/casty` |
+| `searchUrl` | 検索エンジン URL | `https://www.google.com/search?q=` |
+| `transport` | 画像転送方式: `auto`, `file`, `inline` | `auto` (bcon/kitty→file、他→inline) |
+| `format` | キャプチャ形式: `auto`, `png`, `jpeg` | `auto` (file→jpeg adaptive、inline→png) |
+| `mouseMode` | `1002` (ボタンイベント) or `1003` (全イベント) | 自動 (Ghostty→1003、他→1002) |
+
+## 比較
+
+| | casty | Browsh | w3m/lynx |
+|---|---|---|---|
+| エンジン | Chrome | Firefox | 独自パーサー |
+| 描画 | ピクセルそのまま | テキスト近似 | テキストのみ |
+| JavaScript | 動く | 動く | 動かない |
+| 表示方式 | Kitty graphics | 文字セル | 文字セル |
+| 依存 | Node.js + Chrome | Go + Firefox | 単体 |
+
+<details>
+<summary>技術詳細</summary>
+
+全体で約1200行の JavaScript です。中でやっていること:
+
+- chrome-headless-shell を起動して生 CDP WebSocket で通信
+- `Runtime.enable` は絶対に送らない（Google ログインが壊れる。これは苦労して発見した）
+- ステルスパッチは `Page.addScriptToEvaluateOnNewDocument` でページロード前に注入
+- フレーム取得はハイブリッド方式: 低解像度 Screencast で変更を検知して、`Page.captureScreenshot` で DPR 対応の高解像度フレームを取得
+- ファイル転送モードでは JPEG→PNG のアダプティブ切替: スクロール中や動画再生中は高速な JPEG、止まったら鮮明な PNG
+- CSI 14t でターミナルのピクセルサイズを取得して自動ズーム
 
 ```
-bin/
-  casty          # シェルラッパー (Chrome インストール/更新)
-  casty.js       # エントリポイント (ターミナル検出、ズーム、リサイズ)
-lib/
-  browser.js     # CDP ブラウザ制御 (起動、Screencast、キャプチャ)
-  cdp.js         # 軽量 CDP WebSocket クライアント
-  chrome.js      # Chrome バイナリ検出、起動、プロファイルクリーンアップ
-  kitty.js       # Kitty graphics protocol 出力 (file/inline)
-  input.js       # マウス/キーボード処理、アクション
-  hints.js       # Vimium 風ヒントモード
-  urlbar.js      # アドレス/検索バー
-  bookmarks.js   # ブックマーク検索
-  keys.js        # キーバインド設定
-  config.js      # ユーザー設定
+bin/casty          シェルラッパー（Chrome インストール/更新）
+bin/casty.js       エントリポイント（ターミナル、ズーム、リサイズ）
+lib/browser.js     CDP ブラウザ制御、フレームキャプチャ
+lib/cdp.js         軽量 CDP WebSocket クライアント
+lib/chrome.js      Chrome 検出、起動、プロファイルクリーンアップ
+lib/kitty.js       Kitty graphics protocol（file/inline）
+lib/input.js       マウス/キーボード処理
+lib/hints.js       Vimium 風ヒントモード
+lib/urlbar.js      アドレス/検索バー
+lib/config.js      ユーザー設定
+lib/keys.js        キーバインド設定
+lib/bookmarks.js   ブックマーク検索
 ```
 
-## 仕組み
-
-1. 生 CDP で Chrome Headless Shell を起動 (Playwright 不使用、`Runtime.enable` も送信しない)
-2. ページロード前にステルスパッチを注入してボット検出を回避
-3. ハイブリッドフレーム取得: 低解像度 Screencast を変更検知トリガーとして使い、`Page.captureScreenshot` で高解像度フレームを取得
-4. Kitty graphics protocol でフレームをターミナルに描画
-5. ターミナル入力 (raw mode) をキャプチャし、CDP 経由で Chrome に送信
-6. CSI 14t でターミナルのピクセルサイズを自動検出し、ズームを計算
-7. 起動時にプロファイルをクリーンアップ (Cookie/LocalStorage を保持、キャッシュ類を削除) して高速起動を維持
+</details>
 
 ## ライセンス
 

package/README.md

@@ -1,47 +1,33 @@
 # casty
 
-A TTY web browser powered by Kitty graphics protocol.
+Run a real Chrome browser inside your terminal.
 
-**[日本語](README.ja.md)**
+**[Japanese](README.ja.md)**
 
-casty renders full web pages in your terminal using Chrome's headless rendering, bridging the gap between a headless browser and your Kitty-compatible terminal.
+casty is not a text-mode browser like w3m or lynx. It launches headless Chrome, grabs the rendered frames over CDP, and draws them in your terminal via Kitty graphics protocol. Think of it as a remote desktop for Chrome that fits in a terminal window.
 
-<video src="https://github.com/user-attachments/assets/330bf0c3-dd08-44a5-b627-b90c200d57fe" autoplay loop muted playsinline></video>
+<video src="https://github.com/user-attachments/assets/552f1972-bb53-481e-9516-c36b7e5085d8" autoplay loop muted playsinline></video>
+
+## How It Works
 
 ```
-Chrome (Headless Shell)     casty              Terminal
-┌─────────────────┐      ┌─────────────────┐  ┌─────────────────┐
-│  Web rendering  │ ───→ │  High-res       │ ─→│  Kitty graphics │
-│  JS execution   │      │  capture        │  │  display        │
-│  Full browser   │ ←─── │  Input bridge   │ ←─│  Mouse/Keyboard │
-└─────────────────┘      └─────────────────┘  └─────────────────┘
+Terminal (you)          casty               Chrome (headless)
+┌──────────────┐      ┌──────────────┐      ┌──────────────┐
+│  Kitty       │ ←──  │  Screencast  │ ←──  │  Full web    │
+│  graphics    │      │  + hi-res    │      │  rendering   │
+│  display     │      │  capture     │      │  JS, CSS,    │
+│              │ ──→  │  Input       │ ──→  │  Canvas,     │
+│  Mouse/KB    │      │  bridge      │      │  WebGL       │
+└──────────────┘      └──────────────┘      └──────────────┘
 ```
 
-## Features
-
-- Full web rendering via headless Chrome (raw CDP, no Playwright)
-- Stealth patches to avoid bot detection (Google login works)
-- Kitty graphics protocol for image display
-- Mouse support (click, scroll, drag)
-- Keyboard passthrough to Chrome
-- Vimium-style hint mode (Alt+F) for keyboard navigation
-- Address bar with search (Alt+L)
-- Bookmarks (`/b` search in address bar)
-- Copy selected text / paste from clipboard
-- Auto-zoom based on terminal font size
-- Dynamic resize (SIGWINCH)
-- Configurable keybindings (`~/.casty/keys.json`)
-- Configurable settings (`~/.casty/config.json`)
-- File downloads to `~/Downloads/`
-- Loading indicator
-- Fast startup with automatic profile cleanup
-
-## Requirements
-
-- **Kitty graphics protocol** compatible terminal
-- Node.js >= 18
+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.
 
-Tested on: **bcon**, **Ghostty**, **kitty**
+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.
+
+## Why use this?
+
+If you're working over SSH on a headless server and need to check a web page, your options are usually `curl`, `lynx`, or forwarding X11. casty gives you an actual browser without leaving the terminal. No X11, no VNC, no Wayland — just a Kitty-compatible terminal.
 
 ## Installation
 
@@ -50,128 +36,122 @@ npm install -g @sanohiro/casty
 casty
 ```
 
-Or install from source:
+Or from source:
 
 ```bash
 git clone https://github.com/sanohiro/casty.git
-cd casty
-npm install
+cd casty && npm install
 ./bin/casty
 ```
 
-Chrome Headless Shell is automatically installed to `~/.casty/browsers/` on first run and kept up to date on subsequent launches. Only one version is kept at a time.
+Chrome Headless Shell is auto-installed to `~/.casty/browsers/` on first run.
+
+### Requirements
+
+- A terminal with **Kitty graphics protocol** support (tested on Ghostty, kitty, bcon)
+- Node.js >= 18
+- `unzip` (for Chrome auto-install)
 
 ## Usage
 
 ```bash
 casty https://google.com
 casty https://youtube.com
-casty   # opens home page (default: casty GitHub page)
+casty   # opens home page
 ```
 
 ### Keybindings
 
 | Key | Action |
 |-----|--------|
-| Alt+L | Open address bar |
-| Alt+F | Hint mode (Vimium-style link/button selection) |
-| Alt+Left | Back |
-| Alt+Right | Forward |
+| Alt+L | Address bar |
+| Alt+F | Hint mode (Vimium-style) |
+| Alt+Left / Right | Back / Forward |
 | Alt+C | Copy selected text |
-| Ctrl+V | Paste from clipboard |
+| Ctrl+V | Paste |
 | Ctrl+Q | Quit |
-| Ctrl+C | Quit (fallback) |
-
-Customize via `~/.casty/keys.json` (file is not created automatically):
-
-```json
-{
-  "ctrl+q": "quit",
-  "alt+left": "back",
-  "alt+right": "forward",
-  "alt+l": "url_bar",
-  "alt+f": "hints",
-  "alt+c": "copy",
-  "ctrl+v": "paste"
-}
-```
 
-### Address Bar
-
-- **Alt+L** or click row 1 to focus — URL is selected, type to replace
-- **Enter** to navigate (URLs) or search (Google)
-- **`/b query`** to search bookmarks
-- **Escape** to cancel
-- **Ctrl+A** select all, **Ctrl+U** clear, **Ctrl+W** delete word
+Customizable via `~/.casty/keys.json`.
 
 ### Hint Mode
 
-Press **Alt+F** to show labels on clickable and focusable elements. Type the label characters to click a link/button or focus an input field. Press **Escape** to cancel.
+**Alt+F** shows labels on clickable elements. Type the label to click. Labels use home-row keys (`a s d f j k l`).
 
-Labels use home-row keys (`a`, `s`, `d`, `f`, `j`, `k`, `l`) — single character for ≤7 elements, two characters for more (up to 49).
+### Address Bar
+
+**Alt+L** to open. Type a URL or search query. `/b query` searches bookmarks.
 
 ### Bookmarks
 
-Create `~/.casty/bookmarks.json` manually:
+Create `~/.casty/bookmarks.json`:
 
 ```json
 {
   "GitHub": "https://github.com",
-  "Google": "https://google.com",
   "YouTube": "https://youtube.com"
 }
 ```
 
-Search from the address bar with `/b query` (matches name or URL, case-insensitive).
-
 ### Configuration
 
-Customize via `~/.casty/config.json` (file is not created automatically):
+`~/.casty/config.json`:
 
 ```json
 {
   "homeUrl": "https://github.com/sanohiro/casty",
   "searchUrl": "https://www.google.com/search?q=",
   "transport": "auto",
-  "format": "auto"
+  "format": "auto",
+  "mouseMode": 1002
 }
 ```
 
 | Key | Description | Default |
 |-----|-------------|---------|
-| `homeUrl` | Page opened when no URL is given | `https://github.com/sanohiro/casty` |
-| `searchUrl` | Search engine URL (query appended) | `https://www.google.com/search?q=` |
-| `transport` | Kitty image transfer: `auto`, `file`, or `inline` | `auto` (bcon→file, others→inline) |
-| `format` | Screenshot format: `auto`, `png`, or `jpeg` | `auto` (file→jpeg, inline→png) |
-
-## Architecture
+| `homeUrl` | Start page | `https://github.com/sanohiro/casty` |
+| `searchUrl` | Search engine URL | `https://www.google.com/search?q=` |
+| `transport` | Image transfer: `auto`, `file`, `inline` | `auto` (bcon/kitty→file, others→inline) |
+| `format` | Capture format: `auto`, `png`, `jpeg` | `auto` (file→jpeg adaptive, inline→png) |
+| `mouseMode` | `1002` (button-event) or `1003` (any-event) | Auto (Ghostty→1003, others→1002) |
+
+## Comparison
+
+| | casty | Browsh | w3m/lynx |
+|---|---|---|---|
+| Engine | Chrome | Firefox | Custom parser |
+| Rendering | Pixel-perfect | Text approximation | Text only |
+| JavaScript | Yes | Yes | No |
+| Display | Kitty graphics | Character cells | Character cells |
+| Dependencies | Node.js + Chrome | Go + Firefox | Standalone |
+
+<details>
+<summary>Technical Details</summary>
+
+The whole thing is about 1200 lines of JavaScript. Here's what's going on under the hood:
+
+- Launches chrome-headless-shell and talks to it via raw CDP WebSocket
+- `Runtime.enable` is never sent (it breaks Google login — discovered the hard way)
+- Stealth patches are injected via `Page.addScriptToEvaluateOnNewDocument` before any page loads
+- Frame capture is hybrid: low-res Screencast triggers change detection, then `Page.captureScreenshot` grabs hi-res frames with proper DPR
+- File transfer mode uses adaptive JPEG→PNG: fast JPEG during scrolling/video, crisp PNG after things settle
+- Terminal pixel size is detected via CSI 14t for auto-zoom
 
 ```
-bin/
-  casty          # Shell wrapper (Chrome install/update)
-  casty.js       # Entry point (terminal detection, zoom, resize)
-lib/
-  browser.js     # CDP browser control (launch, screencast, capture)
-  cdp.js         # Lightweight CDP WebSocket client
-  chrome.js      # Chrome binary detection, launch, profile cleanup
-  kitty.js       # Kitty graphics protocol output (file/inline)
-  input.js       # Mouse/keyboard handling, actions
-  hints.js       # Vimium-style hint mode
-  urlbar.js      # Address/search bar
-  bookmarks.js   # Bookmark search
-  keys.js        # Configurable keybindings
-  config.js      # User configuration
+bin/casty          Shell wrapper (Chrome install/update)
+bin/casty.js       Entry point (terminal, zoom, resize)
+lib/browser.js     CDP browser control, frame capture
+lib/cdp.js         Lightweight CDP WebSocket client
+lib/chrome.js      Chrome detection, launch, profile cleanup
+lib/kitty.js       Kitty graphics protocol (file/inline)
+lib/input.js       Mouse/keyboard handling
+lib/hints.js       Vimium-style hint mode
+lib/urlbar.js      Address/search bar
+lib/config.js      User configuration
+lib/keys.js        Keybinding config
+lib/bookmarks.js   Bookmark search
 ```
 
-## How It Works
-
-1. Launches Chrome Headless Shell via raw CDP (no Playwright, no `Runtime.enable`)
-2. Injects stealth patches before page load to avoid bot detection
-3. Uses hybrid frame capture: low-res Screencast as change detection trigger, `Page.captureScreenshot` for high-res frames
-4. Renders frames to terminal via Kitty graphics protocol
-5. Captures terminal input (raw mode) and dispatches to Chrome via CDP
-6. Auto-detects terminal pixel size (CSI 14t) for zoom calculation
-7. Cleans up profile on startup (keeps cookies/storage, removes caches) for fast launch
+</details>
 
 ## License
 

package/bin/casty

@@ -163,6 +163,12 @@ has_system_chrome() {
 }
 
 if ! has_chrome; then
+  # unzip が必要 (Chrome for Testing は zip 配布)
+  if ! is_arm64_linux && ! command -v unzip >/dev/null 2>&1; then
+    echo "casty: 'unzip' is required to install Chrome Headless Shell." >&2
+    echo "casty: Install with: sudo apt install unzip" >&2
+    exit 1
+  fi
   if is_arm64_linux; then
     # ARM64 Linux: Chrome for Testing にバイナリがないので Playwright 経由でインストール
     install_chromium_playwright

package/bin/casty.js

@@ -149,10 +149,11 @@ async function main() {
 
   // Frame callback for screencast / captureScreenshot
   // sendFrame includes cursor positioning (single write)
+  let urlBar = null;
   function onFrame(data) {
     if (renderPaused) return;
     sendFrame(data);
-    urlBar.renderIfDirty();
+    if (urlBar) urlBar.renderIfDirty();
   }
 
   // Phase 3: Start screencast
@@ -163,7 +164,7 @@ async function main() {
     onFrame,
   });
 
-  const urlBar = startInputHandling(client, cssCellW, cssCellH, bindings, pauseRender, forceCapture);
+  urlBar = startInputHandling(client, cssCellW, cssCellH, bindings, pauseRender, forceCapture);
   urlBar.render();
 
   // Force capture on page load events (debounced — multiple events fire close together)

package/lib/browser.js

@@ -11,10 +11,6 @@ const CHROME_VERSION = '145.0.7632.6';
 const USER_AGENT = `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${CHROME_VERSION} Safari/537.36`;
 const PROFILE_DIR = join(homedir(), '.casty', 'profile');
 
-// WEBGL_debug_renderer_info extension constants
-const GL_UNMASKED_VENDOR   = 0x9245; // UNMASKED_VENDOR_WEBGL
-const GL_UNMASKED_RENDERER = 0x9246; // UNMASKED_RENDERER_WEBGL
-
 // Screencast settings (low-res stream for change detection)
 const SCREENCAST_SCALE     = 4;    // Downscale factor (1/4 resolution)
 const SCREENCAST_NTH_FRAME = 1;    // Every frame (no decimation, faster change detection)
@@ -27,7 +23,6 @@ const CAPTURE_STUCK_RESET  = 5000; // Reset stuck capturing flag (ms)
 // lang: primary language (e.g. "ja", "en-US")
 function buildStealthScript(lang) {
   // Build Accept-Language style list: primary, then en-US/en fallbacks
-  const langBase = lang.split('-')[0]; // "ja", "en", "zh", etc.
   const languages = [lang];
   if (lang !== 'en-US' && lang !== 'en') {
     languages.push('en-US', 'en');
@@ -118,10 +113,11 @@ function buildAcceptLanguage(lang) {
 
 // HTTP GET → JSON (using global fetch)
 async function fetchJson(url) {
-  const res = await fetch(url);
-  if (!res.ok) return null;
-  try { return await res.json(); }
-  catch { return null; }
+  try {
+    const res = await fetch(url);
+    if (!res.ok) return null;
+    return await res.json();
+  } catch { return null; }
 }
 
 // Phase 1: Launch Chrome only (no terminal info needed, for parallel execution)

package/lib/hints.js

@@ -18,9 +18,13 @@ function makeCollectAndOverlayScript(hintChars, maxHints) {
     const elems = [];
     for (const el of all) {
       if (elems.length >= ${maxHints}) break;
-      if (el.offsetParent === null && getComputedStyle(el).position !== 'fixed') continue;
-      const rect = el.getBoundingClientRect();
-      if (rect.width === 0 || rect.height === 0) continue;
+      let rect = el.getBoundingClientRect();
+      // Handle display:contents — element has no box, use first child rect
+      if (rect.width === 0 || rect.height === 0) {
+        const child = el.firstElementChild;
+        if (child) rect = child.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0) continue;
+      }
       if (rect.bottom < 0 || rect.top > window.innerHeight) continue;
       if (rect.right < 0 || rect.left > window.innerWidth) continue;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanohiro/casty",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "TTY web browser using raw CDP and Kitty graphics protocol",
   "main": "bin/casty.js",
   "bin": {