@termfleet/terminal 0.1.1 → 0.1.2

package/dist/tmux-stream.d.ts

@@ -13,6 +13,7 @@ export type TmuxTerminalSocketOptions<TAuthorization = void> = {
     cwd?: string;
     errorLabel?: string;
     onInput?: (data: string, authorization: TAuthorization | undefined) => Promise<void> | void;
+    readOnly?: boolean;
     rows?: number;
     socket: WebSocket;
     terminalId: string;

package/dist/tmux-stream.js

@@ -1,6 +1,6 @@
 import pty from "@homebridge/node-pty-prebuilt-multiarch";
 import fs from "node:fs";
-import { assertSession, getWindowSize } from "./tmux.js";
+import { assertSession, getStatusLineCount, getWindowSize } from "./tmux.js";
 export class TmuxTerminalAttachError extends Error {
     phase;
     constructor(phase, cause) {
@@ -25,8 +25,13 @@ export function attachTmuxTerminalSocket(options) {
     catch (error) {
         throw new TmuxTerminalAttachError("resolve", error);
     }
-    const cols = options.cols ?? tmuxSize.width;
-    const rows = options.rows ?? tmuxSize.height;
+    // Observers inherit the durable pane dimensions exactly. Even an ignore-size tmux client can
+    // become the size source when it is the only attached client, so accepting the browser viewport
+    // here would silently reflow someone else's terminal merely by opening a read-only mirror.
+    const cols = options.readOnly ? tmuxSize.width : options.cols ?? tmuxSize.width;
+    const rows = options.readOnly
+        ? tmuxSize.height + getStatusLineCount(options.terminalId, options.tmuxSocket)
+        : options.rows ?? tmuxSize.height;
     let reconciledPty;
     try {
         reconciledPty = spawnReconciledPty("tmux", [
@@ -34,6 +39,7 @@ export function attachTmuxTerminalSocket(options) {
             "-T",
             "RGB",
             "attach-session",
+            ...(options.readOnly ? ["-r"] : []),
             "-t",
             options.terminalId
         ], {

package/dist/tmux.d.ts

@@ -97,6 +97,7 @@ export declare function getWindowSize({ name, socket, window }: {
     window?: number;
     socket?: string;
 }): TmuxWindowSize;
+export declare function getStatusLineCount(name: string, socket?: string): number;
 export declare function listWindowSizesAsync(socket?: string): Promise<Map<string, TmuxWindowSize>>;
 export declare function setPaneStyle(target: string, style: string, socket?: string): Promise<void>;
 export declare function clearPaneStyle(target: string, socket?: string): Promise<void>;

package/dist/tmux.js

@@ -514,6 +514,19 @@ export function getWindowSize({ name, socket, window = 0 }) {
     }
     return { height, width };
 }
+export function getStatusLineCount(name, socket) {
+    assertSession(name, socket);
+    const value = run("tmux", tmuxArgs(socket, ["show-options", "-Aqv", "-t", name, "status"])).trim();
+    if (value === "off")
+        return 0;
+    if (value === "on")
+        return 1;
+    const lines = Number(value);
+    if (!Number.isInteger(lines) || lines < 0 || lines > 5) {
+        throw new Error(`Could not determine tmux status height for ${name}.`);
+    }
+    return lines;
+}
 // Every window-0 size in ONE async exec, keyed by session. The observe loop uses
 // this to size windows off the event loop instead of a synchronous getWindowSize
 // per window — that per-window fan-out blocked the provider loop under a large fleet

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termfleet/terminal",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Framework-neutral terminal transport and durable tmux session substrate extracted from Termfleet.",
   "keywords": [
     "pty",