@aitty/browser 0.1.2 → 0.2.0

package/README.md

@@ -0,0 +1,84 @@
+# @aitty/browser
+
+Browser-side DOM terminal renderer for aitty sessions.
+
+Use this package inside your web UI to mount a PTY-backed agent session created
+by `@aitty/server`.
+
+## Install
+
+```bash
+npm i @aitty/browser
+```
+
+Import the stylesheet once:
+
+```ts
+import "@aitty/browser/style.css";
+```
+
+## Usage
+
+```ts
+import { mountAitty } from "@aitty/browser";
+import "@aitty/browser/style.css";
+
+const terminal = await mountAitty("#terminal", {
+  src: sessionUrl,
+  config: {
+    appearance: {
+      fontSize: 16,
+      lineHeight: 1.5,
+      theme: "light",
+      themeTarget: "container"
+    }
+  },
+  onStatusChange(status) {
+    console.log(status.connection, status.sessionState, status.message);
+  }
+});
+
+terminal.updateConfig({
+  appearance: {
+    theme: "dark"
+  }
+});
+```
+
+```html
+<div id="terminal" style="height: 100dvh"></div>
+```
+
+If the page is served directly from an aitty session URL, `src` can be omitted.
+When embedding aitty inside an existing app route, pass `src`.
+
+By default, `@aitty/browser` scopes theme writes to the mounted container and
+does not install the reference shell controls. That keeps host apps in control
+of their own header, fullscreen UI, theme switcher, status indicator, and page
+theme. The reference CLI shell opts into document-level theme and shell controls
+explicitly through its own `data-aitty-*` attributes.
+
+`themeTarget` is a mount-time ownership setting. Keep it at `"container"` for
+embedded apps; use `"document"` only for full-page shells.
+
+## Main Exports
+
+- `mountAitty()` mounts the terminal into a selector or element and connects to a session.
+- `defineAittyTerminalElement()` registers the web component wrapper.
+- `mountTerminalApp()` mounts with explicit elements and dependencies for advanced integrations.
+- `createBufferedTerminalWriter()` buffers terminal writes until the renderer is ready.
+- `BrowserTerminalRenderer` exposes the DOM renderer used by aitty.
+- `normalizeTerminalConfig()`, `mergeTerminalConfig()`, and `cloneTerminalConfig()` help host apps manage settings state.
+- `installShellControls()` wires the optional reference shell buttons used by the CLI page.
+- `installTerminalInputPolicies()` wires keyboard, IME, paste, and shortcut handling.
+
+## Integration Hooks
+
+- Use `onStatusChange` to render your own header, badge, or connection state UI.
+- Use `config.appearance` and `terminal.updateConfig()` to keep host UI and terminal state aligned.
+- Use `scrollAdapter` when integrating custom scrollbar libraries such as OverlayScrollbars.
+- Use `config.behavior.input.resolveKey` for agent-specific shortcuts while leaving browser-reserved shortcuts to the browser.
+
+## License
+
+Apache-2.0

package/dist/browser.d.ts

@@ -1,6 +1,8 @@
-import { BrowserTerminalBridge, BrowserTerminalRenderer, BrowserTerminalStyleOverride, BrowserTerminalStyleTracker } from "./frontend/browser-terminal-renderer.js";
-import { TerminalInputCallbacks, TerminalKeyResolver, installTerminalInputPolicies, isBrowserSafeShortcut, isCompositionKeyDown, isContainedTerminalNavigationKey } from "./frontend/terminal-input-policies.js";
-import { BinaryWriteTarget, BufferedTerminalWriter, FrameScheduler, MountAittyContainerOptions, MountAittyOptions, MountTerminalDependencies, MountTerminalElements, MountedTerminalApp, TerminalConnectionState, TerminalLoadingPresentation, TerminalOutputState, TerminalScrollAdapter, TerminalScrollAdapterContext, TerminalScrollAdapterFactory, TerminalScrollMetrics, TerminalScrollOptions, TerminalSessionPresentationState, TerminalStatusListener, TerminalStatusSnapshot, TerminalTheme, TerminalTransport, TransportCloseEvent, TransportHandlers, createBufferedTerminalWriter, defineAittyTerminalElement, mountAitty, mountTerminalApp } from "./frontend/terminal-app.js";
+import { BrowserTerminalBridge, BrowserTerminalRenderer } from "./frontend/browser-terminal-renderer.js";
+import { TerminalInputCallbacks, TerminalKeyResolver, TerminalPasteShortcut, TerminalPasteShortcutResult, installTerminalInputPolicies, isBrowserSafeShortcut, isCompositionKeyDown, isContainedTerminalNavigationKey } from "./frontend/terminal-input-policies.js";
+import { TerminalAppearanceConfig, TerminalBehaviorConfig, TerminalConfig, TerminalConfigListener, TerminalConfigPatch, TerminalFontSizeRange, TerminalResolvedAppearanceConfig, TerminalResolvedBehaviorConfig, TerminalResolvedConfig, TerminalTheme, TerminalThemeTarget, cloneTerminalConfig, mergeTerminalConfig, normalizeTerminalConfig } from "./frontend/terminal-config.js";
+import { BinaryWriteTarget, BufferedTerminalWriter, FrameScheduler, MountAittyContainerOptions, MountAittyOptions, MountTerminalDependencies, MountTerminalElements, MountedTerminalApp, TerminalConnectionState, TerminalLoadingPresentation, TerminalOutputState, TerminalScrollAdapter, TerminalScrollAdapterContext, TerminalScrollAdapterFactory, TerminalScrollMetrics, TerminalScrollOptions, TerminalSessionPresentationState, TerminalStatusListener, TerminalStatusSnapshot, TerminalTransport, TransportCloseEvent, TransportHandlers, createBufferedTerminalWriter, defineAittyTerminalElement, mountAitty, mountTerminalApp } from "./frontend/terminal-app.js";
 import { AittyTheme, AittyThemeSource, AittyThemeSubscription } from "./theme-source.js";
 import { AnsiStyleTracker, createAnsiStyleTracker } from "./frontend/ansi-style-tracker.js";
-export { type AittyTheme, type AittyThemeSource, type AittyThemeSubscription, type AnsiStyleTracker, type BinaryWriteTarget, type BrowserTerminalBridge, BrowserTerminalRenderer, type BrowserTerminalStyleOverride, type BrowserTerminalStyleTracker, type BufferedTerminalWriter, type FrameScheduler, type MountAittyContainerOptions, type MountAittyOptions, type MountTerminalDependencies, type MountTerminalElements, type MountedTerminalApp, type TerminalConnectionState, type TerminalInputCallbacks, type TerminalKeyResolver, type TerminalLoadingPresentation, type TerminalOutputState, type TerminalScrollAdapter, type TerminalScrollAdapterContext, type TerminalScrollAdapterFactory, type TerminalScrollMetrics, type TerminalScrollOptions, type TerminalSessionPresentationState, type TerminalStatusListener, type TerminalStatusSnapshot, type TerminalTheme, type TerminalTransport, type TransportCloseEvent, type TransportHandlers, createAnsiStyleTracker, createBufferedTerminalWriter, defineAittyTerminalElement, installTerminalInputPolicies, isBrowserSafeShortcut, isCompositionKeyDown, isContainedTerminalNavigationKey, mountAitty, mountTerminalApp };
+import { ShellControlOptions, ShellControlScrollAnchor, installShellControls } from "./frontend/shell-controls.js";
+export { type AittyTheme, type AittyThemeSource, type AittyThemeSubscription, type AnsiStyleTracker, type BinaryWriteTarget, type BrowserTerminalBridge, BrowserTerminalRenderer, type BufferedTerminalWriter, type FrameScheduler, type MountAittyContainerOptions, type MountAittyOptions, type MountTerminalDependencies, type MountTerminalElements, type MountedTerminalApp, type ShellControlOptions, type ShellControlScrollAnchor, type TerminalAppearanceConfig, type TerminalBehaviorConfig, type TerminalConfig, type TerminalConfigListener, type TerminalConfigPatch, type TerminalConnectionState, type TerminalFontSizeRange, type TerminalInputCallbacks, type TerminalKeyResolver, type TerminalLoadingPresentation, type TerminalOutputState, type TerminalPasteShortcut, type TerminalPasteShortcutResult, type TerminalResolvedAppearanceConfig, type TerminalResolvedBehaviorConfig, type TerminalResolvedConfig, type TerminalScrollAdapter, type TerminalScrollAdapterContext, type TerminalScrollAdapterFactory, type TerminalScrollMetrics, type TerminalScrollOptions, type TerminalSessionPresentationState, type TerminalStatusListener, type TerminalStatusSnapshot, type TerminalTheme, type TerminalThemeTarget, type TerminalTransport, type TransportCloseEvent, type TransportHandlers, cloneTerminalConfig, createAnsiStyleTracker, createBufferedTerminalWriter, defineAittyTerminalElement, installShellControls, installTerminalInputPolicies, isBrowserSafeShortcut, isCompositionKeyDown, isContainedTerminalNavigationKey, mergeTerminalConfig, mountAitty, mountTerminalApp, normalizeTerminalConfig };

package/dist/browser.js

@@ -1,5 +1,7 @@
 import { createAnsiStyleTracker } from "./frontend/ansi-style-tracker.js";
 import { BrowserTerminalRenderer } from "./frontend/browser-terminal-renderer.js";
+import { cloneTerminalConfig, mergeTerminalConfig, normalizeTerminalConfig } from "./frontend/terminal-config.js";
+import { installShellControls } from "./frontend/shell-controls.js";
 import { installTerminalInputPolicies, isBrowserSafeShortcut, isCompositionKeyDown, isContainedTerminalNavigationKey } from "./frontend/terminal-input-policies.js";
 import { createBufferedTerminalWriter, defineAittyTerminalElement, mountAitty, mountTerminalApp } from "./frontend/terminal-app.js";
-export { BrowserTerminalRenderer, createAnsiStyleTracker, createBufferedTerminalWriter, defineAittyTerminalElement, installTerminalInputPolicies, isBrowserSafeShortcut, isCompositionKeyDown, isContainedTerminalNavigationKey, mountAitty, mountTerminalApp };
+export { BrowserTerminalRenderer, cloneTerminalConfig, createAnsiStyleTracker, createBufferedTerminalWriter, defineAittyTerminalElement, installShellControls, installTerminalInputPolicies, isBrowserSafeShortcut, isCompositionKeyDown, isContainedTerminalNavigationKey, mergeTerminalConfig, mountAitty, mountTerminalApp, normalizeTerminalConfig };

package/dist/frontend/aitty-sw.js

@@ -0,0 +1,43 @@
+self.addEventListener("push", (event) => {
+  let payload = {};
+
+  try {
+    payload = event.data ? event.data.json() : {};
+  } catch {
+    payload = {};
+  }
+
+  const title = typeof payload.title === "string" && payload.title ? payload.title : "aitty";
+  const options = {
+    body: typeof payload.body === "string" ? payload.body : "Terminal session needs your attention.",
+    data: {
+      requestId: typeof payload.requestId === "string" ? payload.requestId : "",
+      url: typeof payload.url === "string" && payload.url ? payload.url : "/"
+    },
+    tag: typeof payload.tag === "string" && payload.tag ? payload.tag : "aitty-notification"
+  };
+
+  event.waitUntil(self.registration.showNotification(title, options));
+});
+
+self.addEventListener("notificationclick", (event) => {
+  event.notification.close();
+
+  const targetUrl = new URL(event.notification.data?.url || "/", self.location.origin).toString();
+
+  event.waitUntil((async () => {
+    const windows = await self.clients.matchAll({
+      includeUncontrolled: true,
+      type: "window"
+    });
+
+    for (const client of windows) {
+      if (client.url === targetUrl || new URL(client.url).pathname === new URL(targetUrl).pathname) {
+        await client.focus();
+        return;
+      }
+    }
+
+    await self.clients.openWindow(targetUrl);
+  })());
+});

package/dist/frontend/ansi-sequences.d.ts

@@ -1,5 +1,10 @@
-//#region src/frontend/ansi-sequences.d.ts
+//#region packages/browser/src/frontend/ansi-sequences.d.ts
 declare function parseCsiParams(paramBuffer: string): number[];
 declare function nextAltScreenState(currentState: boolean, privateMarker: string, paramBuffer: string, finalByte: string): boolean;
+type FocusReportingParser = {
+  append(chunk: string | Uint8Array): boolean | null;
+  reset(): void;
+};
+declare function createFocusReportingParser(): FocusReportingParser;
 //#endregion
-export { nextAltScreenState, parseCsiParams };
+export { FocusReportingParser, createFocusReportingParser, nextAltScreenState, parseCsiParams };

package/dist/frontend/ansi-sequences.js

@@ -1,9 +1,10 @@
-//#region src/frontend/ansi-sequences.ts
+//#region packages/browser/src/frontend/ansi-sequences.ts
 const ALT_SCREEN_PARAMS = new Set([
 	47,
 	1047,
 	1049
 ]);
+const FOCUS_REPORTING_PARAM = 1004;
 function parseCsiParams(paramBuffer) {
 	if (!paramBuffer) return [];
 	return paramBuffer.split(/[;:]/).map((value) => Number(value)).filter((value) => !Number.isNaN(value));
@@ -13,5 +14,67 @@ function nextAltScreenState(currentState, privateMarker, paramBuffer, finalByte)
 	if (!parseCsiParams(paramBuffer).some((value) => ALT_SCREEN_PARAMS.has(value))) return currentState;
 	return finalByte === "h";
 }
+function createFocusReportingParser() {
+	const decoder = new TextDecoder();
+	let parserState = "text";
+	let csiPrivate = "";
+	let csiParams = "";
+	const resetCsi = () => {
+		csiPrivate = "";
+		csiParams = "";
+	};
+	const reset = () => {
+		parserState = "text";
+		resetCsi();
+	};
+	const finishCsi = (finalByte) => {
+		const nextState = nextFocusReportingState(null, csiPrivate, csiParams, finalByte);
+		reset();
+		return nextState;
+	};
+	return {
+		append(chunk) {
+			const text = typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true });
+			let latestState = null;
+			for (const character of text) {
+				if (parserState === "escape") {
+					if (character === "[") {
+						parserState = "csi";
+						resetCsi();
+						continue;
+					}
+					if (character === "c") latestState = false;
+					parserState = "text";
+					continue;
+				}
+				if (parserState === "csi") {
+					if (character === "?") {
+						csiPrivate = "?";
+						continue;
+					}
+					if (character >= "0" && character <= "9" || character === ";" || character === ":") {
+						csiParams += character;
+						continue;
+					}
+					if (character >= "@" && character <= "~") {
+						const nextState = finishCsi(character);
+						if (nextState !== null) latestState = nextState;
+						continue;
+					}
+					reset();
+					continue;
+				}
+				if (character === "\x1B") parserState = "escape";
+			}
+			return latestState;
+		},
+		reset
+	};
+}
+function nextFocusReportingState(currentState, privateMarker, paramBuffer, finalByte) {
+	if (privateMarker !== "?" || finalByte !== "h" && finalByte !== "l") return currentState;
+	if (!parseCsiParams(paramBuffer).includes(FOCUS_REPORTING_PARAM)) return currentState;
+	return finalByte === "h";
+}
 //#endregion
-export { nextAltScreenState, parseCsiParams };
+export { createFocusReportingParser, nextAltScreenState, parseCsiParams };

package/dist/frontend/ansi-style-tracker.d.ts

@@ -1,13 +1,9 @@
-//#region src/frontend/ansi-style-tracker.d.ts
+//#region packages/browser/src/frontend/ansi-style-tracker.d.ts
 type NullableStyle = {
   bg: string | null;
   fg: string | null;
 };
-type StyleCell = (NullableStyle & {
-  displayStart?: number;
-  hidden?: boolean;
-  width?: number;
-}) | null;
+type StyleCell = (NullableStyle & {}) | null;
 type CursorPosition = {
   col: number;
   row: number;

package/dist/frontend/ansi-style-tracker.js

@@ -1,6 +1,6 @@
 import { nextAltScreenState, parseCsiParams } from "./ansi-sequences.js";
 import { cellWidthForCodePoint } from "./cell-width.js";
-//#region src/frontend/ansi-style-tracker.ts
+//#region packages/browser/src/frontend/ansi-style-tracker.ts
 const ESC = "\x1B";
 function createBlankRow(cols) {
 	return Array.from({ length: cols }, () => null);
@@ -10,10 +10,7 @@ function cloneRow(row) {
 		if (!cell) return null;
 		return {
 			bg: cell.bg ?? null,
-			displayStart: cell.displayStart,
-			fg: cell.fg ?? null,
-			hidden: cell.hidden,
-			width: cell.width
+			fg: cell.fg ?? null
 		};
 	});
 }
@@ -24,13 +21,11 @@ function createBuffer(cols, rows) {
 	return {
 		cursor: {
 			col: 0,
-			displayCol: 0,
 			row: 0
 		},
 		rows: Array.from({ length: rows }, () => createBlankRow(cols)),
 		savedCursor: {
 			col: 0,
-			displayCol: 0,
 			row: 0
 		},
 		scrollback: []
@@ -64,46 +59,20 @@ function createAnsiStyleTracker(options = {}) {
 	const clampCursor = (cursor) => {
 		cursor.row = clamp(cursor.row, 0, rows - 1);
 		cursor.col = clamp(cursor.col, 0, cols - 1);
-		cursor.displayCol = clamp(cursor.displayCol, 0, cols - 1);
 	};
-	const cellDisplayStart = (row, col) => row[col]?.displayStart ?? col;
-	const cellWidth = (row, col) => row[col]?.width ?? 1;
-	const makeCellState = (style, sourceCol, displayStart, width, hidden = false) => {
-		if (!hidden && style.fg === null && style.bg === null && displayStart === sourceCol && width === 1) return null;
+	const makeCellState = (style) => {
+		if (style.fg === null && style.bg === null) return null;
 		return {
 			bg: style.bg,
-			displayStart,
-			fg: style.fg,
-			hidden,
-			width
+			fg: style.fg
 		};
 	};
-	const markCellHidden = (row, col) => {
-		const cell = row[col];
-		row[col] = {
-			bg: cell?.bg ?? null,
-			displayStart: cellDisplayStart(row, col),
-			fg: cell?.fg ?? null,
-			hidden: true,
-			width: cellWidth(row, col)
-		};
-	};
-	const hideCellsCoveredByDisplayRange = (row, displayStart, width, sourceCol) => {
-		const displayEnd = displayStart + width;
-		for (let col = 0; col < cols; col += 1) {
-			if (col === sourceCol) continue;
-			const cellStart = cellDisplayStart(row, col);
-			const cellEnd = cellStart + cellWidth(row, col);
-			if (cellStart < displayEnd && cellEnd > displayStart) markCellHidden(row, col);
-		}
-	};
 	const storeCellAtCursor = (width) => {
 		const buffer = activeBuffer();
 		const row = buffer.rows[buffer.cursor.row];
 		if (!row) return;
-		const displayStart = buffer.cursor.displayCol;
-		hideCellsCoveredByDisplayRange(row, displayStart, width, buffer.cursor.col);
-		row[buffer.cursor.col] = makeCellState(currentStyle, buffer.cursor.col, displayStart, width);
+		row[buffer.cursor.col] = makeCellState(currentStyle);
+		if (width > 1 && buffer.cursor.col + 1 < cols) row[buffer.cursor.col + 1] = makeCellState(currentStyle);
 	};
 	const scrollActiveBuffer = () => {
 		const buffer = activeBuffer();
@@ -114,17 +83,15 @@ function createAnsiStyleTracker(options = {}) {
 	const moveCursorTo = (buffer, row, col) => {
 		buffer.cursor.row = clamp(row, 0, rows - 1);
 		buffer.cursor.col = clamp(col, 0, cols - 1);
-		buffer.cursor.displayCol = cellDisplayStart(buffer.rows[buffer.cursor.row] ?? [], buffer.cursor.col);
 	};
 	const advanceCursor = (width) => {
 		const buffer = activeBuffer();
-		if (buffer.cursor.col < cols - 1) {
-			buffer.cursor.col += 1;
-			buffer.cursor.displayCol = clamp(buffer.cursor.displayCol + width, 0, cols - 1);
+		const nextCol = buffer.cursor.col + width;
+		if (nextCol < cols) {
+			buffer.cursor.col = nextCol;
 			return;
 		}
 		buffer.cursor.col = 0;
-		buffer.cursor.displayCol = 0;
 		if (buffer.cursor.row < rows - 1) {
 			buffer.cursor.row += 1;
 			return;
@@ -170,9 +137,7 @@ function createAnsiStyleTracker(options = {}) {
 			return row.slice(0, nextCols);
 		});
 		buffer.cursor.col = clamp(buffer.cursor.col, 0, nextCols - 1);
-		buffer.cursor.displayCol = clamp(buffer.cursor.displayCol, 0, nextCols - 1);
 		buffer.savedCursor.col = clamp(buffer.savedCursor.col, 0, nextCols - 1);
-		buffer.savedCursor.displayCol = clamp(buffer.savedCursor.displayCol, 0, nextCols - 1);
 	};
 	const setAltBuffer = (nextState) => {
 		if (nextState === useAltBuffer) return;
@@ -312,11 +277,10 @@ function createAnsiStyleTracker(options = {}) {
 		}
 		if (character === "\r") {
 			buffer.cursor.col = 0;
-			buffer.cursor.displayCol = 0;
 			return;
 		}
 		if (character === "	") {
-			const nextTabStop = (Math.floor(buffer.cursor.displayCol / 8) + 1) * 8;
+			const nextTabStop = (Math.floor(buffer.cursor.col / 8) + 1) * 8;
 			moveCursorTo(buffer, buffer.cursor.row, nextTabStop);
 			return;
 		}

package/dist/frontend/browser-terminal-renderer.d.ts

@@ -1,9 +1,12 @@
-//#region src/frontend/browser-terminal-renderer.d.ts
+//#region packages/browser/src/frontend/browser-terminal-renderer.d.ts
 type TerminalCell = {
   bg: number;
+  bgRgb?: number;
   char: number;
   fg: number;
+  fgRgb?: number;
   flags: number;
+  width?: number;
 };
 type TerminalCursor = {
   col: number;
@@ -25,33 +28,35 @@ type BrowserTerminalBridge = {
   isDirtyRow(row: number): boolean;
   usingAltScreen(): boolean;
 };
-type BrowserTerminalStyleOverride = {
-  bg?: string | null;
-  fg?: string | null;
-  hidden?: boolean;
-} | null;
-type BrowserTerminalStyleTracker = {
-  getGridOverride(row: number, col: number): BrowserTerminalStyleOverride;
-  getScrollbackOverride(offset: number, col: number): BrowserTerminalStyleOverride;
-};
 type BrowserTerminalRenderOptions = {
   force?: boolean;
 };
+type BrowserTerminalRendererOptions = {
+  onScrollbackRowsDropped?: (rows: string[]) => void;
+  renderedScrollbackLimit?: number;
+};
 type SnapshotRow = {
   element: HTMLElement;
   text: string;
 };
 type GetCell = (col: number) => TerminalCell;
-type GetOverride = (col: number) => BrowserTerminalStyleOverride;
+declare function resolveTerminalCellColumnSpan(getCell: GetCell, col: number, _lineLength: number): 1 | 2;
+declare function serializeRowText(getCell: GetCell, lineLength: number): string;
 declare class BrowserTerminalRenderer {
   private _altScreenMeaningfulScrollbackCount;
   private _altScreenVisibleRowSnapshot;
   private _lastAltScreenState;
+  private _lastTotalScrollbackCount;
   private _renderedScrollbackCount;
+  private _renderedScrollbackTexts;
   private _restoreSnapshotCount;
+  private _rowSegmentKeys;
+  private _rowSegmentTexts;
   private _scrollbackRowEls;
   cols: number;
   container: HTMLElement;
+  renderedScrollbackLimit: number;
+  onScrollbackRowsDropped: (rows: string[]) => void;
   prevContainerBg: string;
   prevCursorCol: number;
   prevCursorRow: number;
@@ -59,13 +64,13 @@ declare class BrowserTerminalRenderer {
   prevRowBg: string[];
   rowEls: HTMLElement[];
   rows: number;
-  styleTracker: BrowserTerminalStyleTracker;
-  constructor(container: HTMLElement, styleTracker: BrowserTerminalStyleTracker);
+  constructor(container: HTMLElement, options?: BrowserTerminalRendererOptions);
   _resolveFirstLiveGridRow(): HTMLElement | null;
   _insertScrollbackFragment(fragment: DocumentFragment): void;
   setup(cols: number, rows: number): void;
-  _buildRowContent(rowEl: HTMLElement, getCell: GetCell, getOverride: GetOverride, lineLen: number, cursorCol: number, rowIndex: number): void;
+  _buildRowContent(rowEl: HTMLElement, getCell: GetCell, lineLen: number, cursorCol: number, rowIndex: number): void;
   _buildScrollbackRowEl(bridge: BrowserTerminalBridge, offset: number): HTMLElement;
+  _readScrollbackRowTexts(bridge: BrowserTerminalBridge, scrollbackCount?: number): string[];
   _captureVisibleRowSnapshot(): void;
   _clearAltScreenRestoreSnapshot(): void;
   _readGridRowText(bridge: BrowserTerminalBridge, row: number): string;
@@ -75,6 +80,9 @@ declare class BrowserTerminalRenderer {
     trimPadding?: boolean;
   }): string[];
   _readScrollbackRowText(bridge: BrowserTerminalBridge, offset: number): string;
+  _isShiftedScrollbackMatch(bridge: BrowserTerminalBridge, shiftCount: number, scrollbackCount: number): boolean;
+  _resolveShiftedScrollbackCount(bridge: BrowserTerminalBridge, scrollbackCount: number): number | null;
+  getRenderedScrollbackCount(): number;
   _readLiveTranscriptRows(bridge: BrowserTerminalBridge, currentVisibleRows: string[]): string[];
   _liveTranscriptContainsSnapshots(bridge: BrowserTerminalBridge, snapshots: SnapshotRow[], currentVisibleRows: string[]): boolean;
   _getRestoredScrollbackSnapshots(bridge: BrowserTerminalBridge): SnapshotRow[];
@@ -83,4 +91,4 @@ declare class BrowserTerminalRenderer {
   render(bridge: BrowserTerminalBridge, options?: BrowserTerminalRenderOptions): void;
 }
 //#endregion
-export { BrowserTerminalBridge, BrowserTerminalRenderOptions, BrowserTerminalRenderer, BrowserTerminalStyleOverride, BrowserTerminalStyleTracker };
+export { BrowserTerminalBridge, BrowserTerminalRenderOptions, BrowserTerminalRenderer, BrowserTerminalRendererOptions, resolveTerminalCellColumnSpan, serializeRowText };