jaitus 0.3.12 → 0.3.14

package/src/tui/clipboard.js

@@ -1,161 +1,172 @@
-// ─── Reading the system clipboard ───────────────────────────────────────────────
-//
-// The app takes the mouse, so a terminal's own right-click paste never happens — the
-// click is reported to the app instead, and it used to be thrown away: "paste does not
-// work". Ctrl+V is the terminal's in some terminals and the app's in others. So the app
-// reads the clipboard itself for right-click and Ctrl+V, and for Alt+V (an image, which
-// no terminal can type in).
-//
-// Asynchronous on purpose: PowerShell takes a few hundred milliseconds to start, and a
-// synchronous read froze the whole interface for that long.
-
-import { spawn } from 'node:child_process';
-
-function capture(cmd, args, { timeout = 4000, binary = false } = {}) {
-  return new Promise((resolve) => {
-    let child;
-    try { child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true }); } catch { resolve(null); return; }
-    const chunks = [];
-    const timer = setTimeout(() => { try { child.kill(); } catch { /* gone */ } resolve(null); }, timeout);
-    timer.unref?.();
-    child.stdout.on('data', (d) => chunks.push(d));
-    child.on('error', () => { clearTimeout(timer); resolve(null); });
-    child.on('close', (code) => {
-      clearTimeout(timer);
-      if (code !== 0) return resolve(null);
-      const buf = Buffer.concat(chunks);
-      resolve(binary ? buf : buf.toString('utf8'));
-    });
-  });
-}
-
-// A stand-in clipboard for the terminal tests: when JAITUS_CLIPBOARD_DIR names a folder,
-// text comes from text.txt and an image from image.png in it, and the system clipboard
-// is never read. Tests drive the real app in a real terminal, and they must not read or
-// overwrite whatever the person running them has copied.
-async function standIn(kind) {
-  const dir = process.env.JAITUS_CLIPBOARD_DIR;
-  if (!dir) return undefined;
-  const fs = await import('node:fs');
-  const path = await import('node:path');
-  try {
-    if (kind === 'text') return fs.readFileSync(path.join(dir, 'text.txt'), 'utf8') || null;
-    const bytes = fs.readFileSync(path.join(dir, 'image.png'));
-    return bytes.length ? { bytes, mime: 'image/png', ext: '.png' } : null;
-  } catch { return null; }
-}
-
-/** Plain text on the clipboard, or null (empty, not text, or no clipboard tool). */
-export async function readClipboardText({ platform = process.platform, run = capture } = {}) {
-  const fake = await standIn('text');
-  if (fake !== undefined) return fake;
-  let text = null;
-  if (platform === 'win32') {
-    // UTF-8 out, or anything outside the console code page (quotes, dashes, non-Latin
-    // text) arrives as '?'. -Raw keeps line breaks as they were copied.
-    text = await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
-      '[Console]::OutputEncoding=[Text.Encoding]::UTF8; $t = Get-Clipboard -Raw; if ($null -ne $t) { [Console]::Out.Write($t) }']);
-  } else if (platform === 'darwin') {
-    text = await run('pbpaste', []);
-  } else {
-    for (const [cmd, args] of [['wl-paste', ['--no-newline']], ['xclip', ['-selection', 'clipboard', '-o']], ['xsel', ['--clipboard', '--output']]]) {
-      text = await run(cmd, args);
-      if (text != null) break;
-    }
-  }
-  return text ? text : null;
-}
-
-// The largest image the gateway path takes comfortably (see imageBlock in tools.js).
-export const IMAGE_MAX_BYTES = 3_500_000;
-// Vision models downscale anything larger than about this themselves; sending more
-// pixels only costs tokens and upload time.
-const MAX_SIDE = 2048;
-
-// PowerShell: scale an image down to MAX_SIDE on its long side, then PNG if that fits
-// the limit (text in screenshots stays crisp), JPEG otherwise. Writes base64 to stdout.
-const PS_ENCODE = `
-function Emit($img) {
-  $w = $img.Width; $h = $img.Height; $s = [Math]::Min(1.0, ${MAX_SIDE} / [Math]::Max($w, $h))
-  if ($s -lt 1.0) {
-    $b = New-Object Drawing.Bitmap ([int]($w * $s)), ([int]($h * $s))
-    $g = [Drawing.Graphics]::FromImage($b); $g.InterpolationMode = 'HighQualityBicubic'
-    $g.DrawImage($img, 0, 0, $b.Width, $b.Height); $g.Dispose(); $img = $b
-  }
-  $m = New-Object IO.MemoryStream; $img.Save($m, [Drawing.Imaging.ImageFormat]::Png)
-  if ($m.Length -gt ${IMAGE_MAX_BYTES}) {
-    $m = New-Object IO.MemoryStream
-    $enc = [Drawing.Imaging.ImageCodecInfo]::GetImageEncoders() | Where-Object { $_.MimeType -eq 'image/jpeg' }
-    $p = New-Object Drawing.Imaging.EncoderParameters 1
-    $p.Param[0] = New-Object Drawing.Imaging.EncoderParameter ([Drawing.Imaging.Encoder]::Quality), 85L
-    $img.Save($m, $enc, $p); [Console]::Out.Write('jpeg:')
-  } else { [Console]::Out.Write('png:') }
-  [Console]::Out.Write([Convert]::ToBase64String($m.ToArray()))
-}`;
-
-const decodeEmitted = (out) => {
-  const m = /^(png|jpeg):([A-Za-z0-9+/=\s]+)$/.exec(String(out || '').trim());
-  return m ? { bytes: Buffer.from(m[2].replace(/\s/g, ''), 'base64'), mime: `image/${m[1]}`, ext: m[1] === 'png' ? '.png' : '.jpg' } : null;
-};
-
-/**
- * An image file ready to attach: itself when it is already within the limit, otherwise a
- * smaller copy in the temp folder (null if it cannot be made small enough). Dragging a
- * 4K screenshot onto the terminal is the common case — rejecting those would make
- * attaching screenshots fail most of the time.
- */
-export async function shrinkImageFile(file, { platform = process.platform, run = capture } = {}) {
-  const fs = await import('node:fs');
-  const os = await import('node:os');
-  const path = await import('node:path');
-  let size = 0;
-  try { size = fs.statSync(file).size; } catch { return null; }
-  if (size <= IMAGE_MAX_BYTES) return file;
-  const out = path.join(os.tmpdir(), `jaitus-img-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`);
-  if (platform === 'win32') {
-    const lit = file.replace(/'/g, "''");
-    const r = decodeEmitted(await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
-      `Add-Type -AssemblyName System.Drawing; ${PS_ENCODE}; $i = [Drawing.Image]::FromFile('${lit}'); Emit $i; $i.Dispose()`], { timeout: 20000 }));
-    if (!r) return null;
-    fs.writeFileSync(out + r.ext, r.bytes);
-    return r.bytes.length <= IMAGE_MAX_BYTES ? out + r.ext : null;
-  }
-  if (platform === 'darwin') {
-    const ok = await run('sips', ['-Z', String(MAX_SIDE), '-s', 'format', 'jpeg', '-s', 'formatOptions', '85', file, '--out', `${out}.jpg`], { timeout: 20000 });
-    return ok != null && fs.existsSync(`${out}.jpg`) && fs.statSync(`${out}.jpg`).size <= IMAGE_MAX_BYTES ? `${out}.jpg` : null;
-  }
-  for (const cmd of ['magick', 'convert']) {
-    const ok = await run(cmd, [file, '-resize', `${MAX_SIDE}x${MAX_SIDE}>`, '-quality', '85', `${out}.jpg`], { timeout: 20000 });
-    if (ok != null && fs.existsSync(`${out}.jpg`)) return fs.statSync(`${out}.jpg`).size <= IMAGE_MAX_BYTES ? `${out}.jpg` : null;
-  }
-  return null;
-}
-
-/** An image on the clipboard as { bytes, mime, ext }, already sized to attach, or null. */
-export async function readClipboardImage({ platform = process.platform, run = capture } = {}) {
-  const fake = await standIn('image');
-  if (fake !== undefined) return fake;
-  if (platform === 'win32') {
-    return decodeEmitted(await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
-      `Add-Type -AssemblyName System.Windows.Forms,System.Drawing; ${PS_ENCODE}; $i = [Windows.Forms.Clipboard]::GetImage(); if (!$i) { exit 1 }; Emit $i`],
-    { timeout: 12000 }));
-  }
-  // Elsewhere the raw PNG; the caller writes it out and shrinks it with shrinkImageFile.
-  if (platform === 'darwin') {
-    // pngpaste is not built in; osascript is, and can write the clipboard's PNG itself.
-    const bytes = await run('pngpaste', ['-'], { timeout: 8000, binary: true });
-    if (bytes?.length) return { bytes, mime: 'image/png', ext: '.png' };
-    const os = await import('node:os');
-    const fs = await import('node:fs');
-    const path = await import('node:path');
-    const out = path.join(os.tmpdir(), `jaitus-clip-${Date.now()}.png`);
-    const ok = await run('osascript', ['-e', `set f to open for access POSIX file "${out}" with write permission`, '-e', 'write (the clipboard as «class PNGf») to f', '-e', 'close access f'], { timeout: 8000 });
-    if (ok != null && fs.existsSync(out) && fs.statSync(out).size > 0) return { bytes: fs.readFileSync(out), mime: 'image/png', ext: '.png' };
-    return null;
-  }
-  for (const [cmd, args] of [['wl-paste', ['--type', 'image/png']], ['xclip', ['-selection', 'clipboard', '-t', 'image/png', '-o']]]) {
-    const bytes = await run(cmd, args, { timeout: 8000, binary: true });
-    if (bytes?.length) return { bytes, mime: 'image/png', ext: '.png' };
-  }
-  return null;
-}
+// ─── Reading the system clipboard ───────────────────────────────────────────────
+//
+// The app takes the mouse, so a terminal's own right-click paste never happens — the
+// click is reported to the app instead, and it used to be thrown away: "paste does not
+// work". Ctrl+V is the terminal's in some terminals and the app's in others. So the app
+// reads the clipboard itself for right-click and Ctrl+V, and for Alt+V (an image, which
+// no terminal can type in).
+//
+// Asynchronous on purpose: PowerShell takes a few hundred milliseconds to start, and a
+// synchronous read froze the whole interface for that long.
+
+import { spawn } from 'node:child_process';
+
+/**
+ * The bytes to hand a clipboard tool for `text`. Windows' clip.exe decodes what it is
+ * piped with the console's old OEM code page unless the bytes are UTF-16: fed UTF-8,
+ * every non-ASCII character came out as mojibake — "▌ ✗ │" pasted as "Γûî Γ£ù Γöé".
+ * UTF-16LE with no byte-order mark lands exactly (with one, the mark is pasted too).
+ * Every other tool takes UTF-8.
+ */
+export function clipboardBytes(cmd, text) {
+  return cmd === 'clip' ? Buffer.from(String(text), 'utf16le') : Buffer.from(String(text), 'utf8');
+}
+
+function capture(cmd, args, { timeout = 4000, binary = false } = {}) {
+  return new Promise((resolve) => {
+    let child;
+    try { child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true }); } catch { resolve(null); return; }
+    const chunks = [];
+    const timer = setTimeout(() => { try { child.kill(); } catch { /* gone */ } resolve(null); }, timeout);
+    timer.unref?.();
+    child.stdout.on('data', (d) => chunks.push(d));
+    child.on('error', () => { clearTimeout(timer); resolve(null); });
+    child.on('close', (code) => {
+      clearTimeout(timer);
+      if (code !== 0) return resolve(null);
+      const buf = Buffer.concat(chunks);
+      resolve(binary ? buf : buf.toString('utf8'));
+    });
+  });
+}
+
+// A stand-in clipboard for the terminal tests: when JAITUS_CLIPBOARD_DIR names a folder,
+// text comes from text.txt and an image from image.png in it, and the system clipboard
+// is never read. Tests drive the real app in a real terminal, and they must not read or
+// overwrite whatever the person running them has copied.
+async function standIn(kind) {
+  const dir = process.env.JAITUS_CLIPBOARD_DIR;
+  if (!dir) return undefined;
+  const fs = await import('node:fs');
+  const path = await import('node:path');
+  try {
+    if (kind === 'text') return fs.readFileSync(path.join(dir, 'text.txt'), 'utf8') || null;
+    const bytes = fs.readFileSync(path.join(dir, 'image.png'));
+    return bytes.length ? { bytes, mime: 'image/png', ext: '.png' } : null;
+  } catch { return null; }
+}
+
+/** Plain text on the clipboard, or null (empty, not text, or no clipboard tool). */
+export async function readClipboardText({ platform = process.platform, run = capture } = {}) {
+  const fake = await standIn('text');
+  if (fake !== undefined) return fake;
+  let text = null;
+  if (platform === 'win32') {
+    // UTF-8 out, or anything outside the console code page (quotes, dashes, non-Latin
+    // text) arrives as '?'. -Raw keeps line breaks as they were copied.
+    text = await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+      '[Console]::OutputEncoding=[Text.Encoding]::UTF8; $t = Get-Clipboard -Raw; if ($null -ne $t) { [Console]::Out.Write($t) }']);
+  } else if (platform === 'darwin') {
+    text = await run('pbpaste', []);
+  } else {
+    for (const [cmd, args] of [['wl-paste', ['--no-newline']], ['xclip', ['-selection', 'clipboard', '-o']], ['xsel', ['--clipboard', '--output']]]) {
+      text = await run(cmd, args);
+      if (text != null) break;
+    }
+  }
+  return text ? text : null;
+}
+
+// The largest image the gateway path takes comfortably (see imageBlock in tools.js).
+export const IMAGE_MAX_BYTES = 3_500_000;
+// Vision models downscale anything larger than about this themselves; sending more
+// pixels only costs tokens and upload time.
+const MAX_SIDE = 2048;
+
+// PowerShell: scale an image down to MAX_SIDE on its long side, then PNG if that fits
+// the limit (text in screenshots stays crisp), JPEG otherwise. Writes base64 to stdout.
+const PS_ENCODE = `
+function Emit($img) {
+  $w = $img.Width; $h = $img.Height; $s = [Math]::Min(1.0, ${MAX_SIDE} / [Math]::Max($w, $h))
+  if ($s -lt 1.0) {
+    $b = New-Object Drawing.Bitmap ([int]($w * $s)), ([int]($h * $s))
+    $g = [Drawing.Graphics]::FromImage($b); $g.InterpolationMode = 'HighQualityBicubic'
+    $g.DrawImage($img, 0, 0, $b.Width, $b.Height); $g.Dispose(); $img = $b
+  }
+  $m = New-Object IO.MemoryStream; $img.Save($m, [Drawing.Imaging.ImageFormat]::Png)
+  if ($m.Length -gt ${IMAGE_MAX_BYTES}) {
+    $m = New-Object IO.MemoryStream
+    $enc = [Drawing.Imaging.ImageCodecInfo]::GetImageEncoders() | Where-Object { $_.MimeType -eq 'image/jpeg' }
+    $p = New-Object Drawing.Imaging.EncoderParameters 1
+    $p.Param[0] = New-Object Drawing.Imaging.EncoderParameter ([Drawing.Imaging.Encoder]::Quality), 85L
+    $img.Save($m, $enc, $p); [Console]::Out.Write('jpeg:')
+  } else { [Console]::Out.Write('png:') }
+  [Console]::Out.Write([Convert]::ToBase64String($m.ToArray()))
+}`;
+
+const decodeEmitted = (out) => {
+  const m = /^(png|jpeg):([A-Za-z0-9+/=\s]+)$/.exec(String(out || '').trim());
+  return m ? { bytes: Buffer.from(m[2].replace(/\s/g, ''), 'base64'), mime: `image/${m[1]}`, ext: m[1] === 'png' ? '.png' : '.jpg' } : null;
+};
+
+/**
+ * An image file ready to attach: itself when it is already within the limit, otherwise a
+ * smaller copy in the temp folder (null if it cannot be made small enough). Dragging a
+ * 4K screenshot onto the terminal is the common case — rejecting those would make
+ * attaching screenshots fail most of the time.
+ */
+export async function shrinkImageFile(file, { platform = process.platform, run = capture } = {}) {
+  const fs = await import('node:fs');
+  const os = await import('node:os');
+  const path = await import('node:path');
+  let size = 0;
+  try { size = fs.statSync(file).size; } catch { return null; }
+  if (size <= IMAGE_MAX_BYTES) return file;
+  const out = path.join(os.tmpdir(), `jaitus-img-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`);
+  if (platform === 'win32') {
+    const lit = file.replace(/'/g, "''");
+    const r = decodeEmitted(await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+      `Add-Type -AssemblyName System.Drawing; ${PS_ENCODE}; $i = [Drawing.Image]::FromFile('${lit}'); Emit $i; $i.Dispose()`], { timeout: 20000 }));
+    if (!r) return null;
+    fs.writeFileSync(out + r.ext, r.bytes);
+    return r.bytes.length <= IMAGE_MAX_BYTES ? out + r.ext : null;
+  }
+  if (platform === 'darwin') {
+    const ok = await run('sips', ['-Z', String(MAX_SIDE), '-s', 'format', 'jpeg', '-s', 'formatOptions', '85', file, '--out', `${out}.jpg`], { timeout: 20000 });
+    return ok != null && fs.existsSync(`${out}.jpg`) && fs.statSync(`${out}.jpg`).size <= IMAGE_MAX_BYTES ? `${out}.jpg` : null;
+  }
+  for (const cmd of ['magick', 'convert']) {
+    const ok = await run(cmd, [file, '-resize', `${MAX_SIDE}x${MAX_SIDE}>`, '-quality', '85', `${out}.jpg`], { timeout: 20000 });
+    if (ok != null && fs.existsSync(`${out}.jpg`)) return fs.statSync(`${out}.jpg`).size <= IMAGE_MAX_BYTES ? `${out}.jpg` : null;
+  }
+  return null;
+}
+
+/** An image on the clipboard as { bytes, mime, ext }, already sized to attach, or null. */
+export async function readClipboardImage({ platform = process.platform, run = capture } = {}) {
+  const fake = await standIn('image');
+  if (fake !== undefined) return fake;
+  if (platform === 'win32') {
+    return decodeEmitted(await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+      `Add-Type -AssemblyName System.Windows.Forms,System.Drawing; ${PS_ENCODE}; $i = [Windows.Forms.Clipboard]::GetImage(); if (!$i) { exit 1 }; Emit $i`],
+    { timeout: 12000 }));
+  }
+  // Elsewhere the raw PNG; the caller writes it out and shrinks it with shrinkImageFile.
+  if (platform === 'darwin') {
+    // pngpaste is not built in; osascript is, and can write the clipboard's PNG itself.
+    const bytes = await run('pngpaste', ['-'], { timeout: 8000, binary: true });
+    if (bytes?.length) return { bytes, mime: 'image/png', ext: '.png' };
+    const os = await import('node:os');
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const out = path.join(os.tmpdir(), `jaitus-clip-${Date.now()}.png`);
+    const ok = await run('osascript', ['-e', `set f to open for access POSIX file "${out}" with write permission`, '-e', 'write (the clipboard as «class PNGf») to f', '-e', 'close access f'], { timeout: 8000 });
+    if (ok != null && fs.existsSync(out) && fs.statSync(out).size > 0) return { bytes: fs.readFileSync(out), mime: 'image/png', ext: '.png' };
+    return null;
+  }
+  for (const [cmd, args] of [['wl-paste', ['--type', 'image/png']], ['xclip', ['-selection', 'clipboard', '-t', 'image/png', '-o']]]) {
+    const bytes = await run(cmd, args, { timeout: 8000, binary: true });
+    if (bytes?.length) return { bytes, mime: 'image/png', ext: '.png' };
+  }
+  return null;
+}