@sanohiro/casty 0.5.3 → 0.5.5

package/README.ja.md

@@ -6,7 +6,7 @@ Kitty graphics protocol を使った TTY Web ブラウザ。
 
 ヘッドレス Chrome のレンダリングを Kitty 対応ターミナルに表示し、ターミナル上で完全な Web ブラウジングを実現します。
 
-<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
@@ -40,6 +40,7 @@ Chrome (Headless Shell)     casty              Terminal
 
 - **Kitty graphics protocol** 対応ターミナル
 - Node.js >= 18
+- `unzip`（Chrome Headless Shell の自動インストールに必要）
 
 動作確認済み: **bcon**, **Ghostty**, **kitty**
 
@@ -133,7 +134,8 @@ casty   # ホームページを開く (デフォルト: casty GitHub ページ)
   "homeUrl": "https://github.com/sanohiro/casty",
   "searchUrl": "https://www.google.com/search?q=",
   "transport": "auto",
-  "format": "auto"
+  "format": "auto",
+  "mouseMode": 1002
 }
 ```
 
@@ -141,8 +143,9 @@ casty   # ホームページを開く (デフォルト: casty GitHub ページ)
 |------|------|-----------|
 | `homeUrl` | URL 未指定時に開くページ | `https://github.com/sanohiro/casty` |
 | `searchUrl` | 検索エンジン URL (クエリが末尾に付加される) | `https://www.google.com/search?q=` |
-| `transport` | Kitty 画像転送方式: `auto`, `file`, `inline` | `auto` (bcon→file、他→inline) |
+| `transport` | Kitty 画像転送方式: `auto`, `file`, `inline` | `auto` (bcon/kitty→file、他→inline) |
 | `format` | スクリーンショット形式: `auto`, `png`, `jpeg` | `auto` (file→jpeg、inline→png) |
+| `mouseMode` | マウストラッキングモード: `1002` (ボタンイベント) or `1003` (全イベント) | 自動 (Ghostty→1003、他→1002) |
 
 ## アーキテクチャ
 

package/README.md

@@ -6,7 +6,7 @@ A TTY web browser powered by Kitty graphics protocol.
 
 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.
 
-<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
@@ -40,6 +40,7 @@ Chrome (Headless Shell)     casty              Terminal
 
 - **Kitty graphics protocol** compatible terminal
 - Node.js >= 18
+- `unzip` (for auto-installing Chrome Headless Shell)
 
 Tested on: **bcon**, **Ghostty**, **kitty**
 
@@ -133,7 +134,8 @@ Customize via `~/.casty/config.json` (file is not created automatically):
   "homeUrl": "https://github.com/sanohiro/casty",
   "searchUrl": "https://www.google.com/search?q=",
   "transport": "auto",
-  "format": "auto"
+  "format": "auto",
+  "mouseMode": 1002
 }
 ```
 
@@ -141,8 +143,9 @@ Customize via `~/.casty/config.json` (file is not created automatically):
 |-----|-------------|---------|
 | `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) |
+| `transport` | Kitty image transfer: `auto`, `file`, or `inline` | `auto` (bcon/kitty→file, others→inline) |
 | `format` | Screenshot format: `auto`, `png`, or `jpeg` | `auto` (file→jpeg, inline→png) |
+| `mouseMode` | Mouse tracking mode: `1002` (button-event) or `1003` (any-event) | Auto (Ghostty→1003, others→1002) |
 
 ## Architecture
 

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
@@ -200,5 +206,6 @@ fi
 # When called from casty.js, CASTY_ENSURE_CHROME is set — just return
 # When called directly (./bin/casty), launch the app
 if [ -z "$CASTY_ENSURE_CHROME" ]; then
+  export CASTY_ENSURE_CHROME=1
   exec node "$CASTY_DIR/bin/casty.js" "$@"
 fi

package/bin/casty.js

@@ -5,16 +5,17 @@ import { execFileSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 
-// Ensure Chrome is installed (runs shell script that handles download/update)
-const __bin = dirname(fileURLToPath(import.meta.url));
-try {
-  execFileSync('bash', [join(__bin, 'casty')], {
-    stdio: 'inherit',
-    env: { ...process.env, CASTY_ENSURE_CHROME: '1' },
-  });
-} catch (err) {
-  // Shell script prints its own errors — exit if Chrome not available
-  if (err.status) process.exit(err.status);
+// Ensure Chrome is installed (skip if launched from bin/casty shell script)
+if (!process.env.CASTY_ENSURE_CHROME) {
+  const __bin = dirname(fileURLToPath(import.meta.url));
+  try {
+    execFileSync('bash', [join(__bin, 'casty')], {
+      stdio: ['ignore', 'inherit', 'inherit'],
+      env: { ...process.env, CASTY_ENSURE_CHROME: '1' },
+    });
+  } catch (err) {
+    if (err.status) process.exit(err.status);
+  }
 }
 
 import { startBrowser, setupPage, startScreencast, stopScreencast } from '../lib/browser.js';

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/lib/input.js

@@ -4,6 +4,7 @@
 import { toKeyName } from './keys.js';
 import { UrlBar } from './urlbar.js';
 import { HintMode } from './hints.js';
+import { loadConfig } from './config.js';
 
 // SGR 1006 mouse button codes
 const MOUSE_BTN_LEFT    = 0;
@@ -19,16 +20,29 @@ const CLIPBOARD_TIMEOUT = 1000; // ms
 // Status message display duration
 const STATUS_DISPLAY_MS = 2000;
 
+// Detect mouse tracking mode:
+//   1002 = button-event tracking (reports motion only while button held)
+//   1003 = any-event tracking (reports all motion — needed for hover on Ghostty)
+// Default: 1002 (compatible). Ghostty auto-upgrades to 1003.
+// Override via config.json: "mouseMode": 1002 or 1003
+function detectMouseMode() {
+  const config = loadConfig();
+  if (config.mouseMode) return config.mouseMode;
+  const termProg = (process.env.TERM_PROGRAM || '').toLowerCase();
+  if (termProg === 'ghostty') return 1003;
+  return 1002;
+}
+
+const MOUSE_MODE = detectMouseMode();
+
 // Enable mouse events (SGR 1006 format)
-// Mode 1003: any-event tracking (reports motion even without button press)
-// This ensures Chrome always knows cursor position for proper hover/click handling
 export function enableMouse() {
-  process.stdout.write('\x1b[?1000;1003;1006h');
+  process.stdout.write(`\x1b[?1000;${MOUSE_MODE};1006h`);
 }
 
 // Disable mouse events
 export function disableMouse() {
-  process.stdout.write('\x1b[?1000;1003;1006l');
+  process.stdout.write(`\x1b[?1000;${MOUSE_MODE};1006l`);
 }
 
 // Convert terminal cell coordinates to pixel coordinates

package/lib/kitty.js

@@ -37,10 +37,10 @@ function detectTransport() {
   if (setting === 'file') return 'file';
   if (setting === 'inline') return 'inline';
 
-  // auto: bcon supports t=f
+  // auto: file transfer (t=f) for terminals that support it
   const termProg = process.env.TERM_PROGRAM || '';
   if (/bcon/i.test(termProg)) return 'file';
-
+  if (/kitty/i.test(termProg)) return 'file';
   return 'inline';
 }
 

package/package.json

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