vterm.js 0.7.0 → 0.8.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 //#region src/screen.ts
 /** Default retained payload bound for one APC/DCS sequence (16 MiB of ASCII/base64). */
-const DEFAULT_MAX_STRING_SEQUENCE_LENGTH = 16 * 1024 * 1024;
+const DEFAULT_MAX_STRING_SEQUENCE_LENGTH = 16777216;
 /** Frozen sentinel for unwritten cells — never mutate, copy-on-write in writeChar(). */
 const EMPTY_CELL = Object.freeze({
 	char: "",
@@ -58,7 +58,7 @@ const F_HIDDEN$1 = 64;
 const F_BLINK$1 = 128;
 const F_WIDE$1 = 256;
 const UL_SHIFT$1 = 9;
-const UL_MASK$1 = 7 << UL_SHIFT$1;
+const UL_MASK$1 = 3584;
 const F_HAS_FG = 4096;
 const F_HAS_BG = 8192;
 const F_HAS_UL = 16384;
@@ -79,6 +79,17 @@ function underlineToBits(u) {
 function bitsToUnderline(meta) {
 	return UL_STYLES[(meta & UL_MASK$1) >> UL_SHIFT$1] ?? "none";
 }
+/** Require an invariant-owned value and fail where the impossible state is first observed. */
+function required(value, subject) {
+	if (value === null || value === void 0) throw new Error(`Missing ${subject}`);
+	return value;
+}
+/** Read a dense indexed value and fail at the violated invariant instead of propagating `undefined`. */
+function itemAt(items, index, subject) {
+	const value = items[index];
+	if (value === void 0) throw new RangeError(`${subject}[${index}] is outside its ${items.length}-item range`);
+	return value;
+}
 /** Pack a color's 8-bit channels into a 24-bit `0xRRGGBB` word. */
 function packRgb(c) {
 	return ((c.r & 255) << 16 | (c.g & 255) << 8 | c.b & 255) >>> 0;
@@ -110,7 +121,7 @@ function makePackedRow(width) {
 	let ulIdx = null;
 	let urlMap = null;
 	function setFg(col, c) {
-		if (fgRgb === null) {
+		if (fgRgb === null || fgIdx === null) {
 			fgRgb = new Uint32Array(width);
 			fgIdx = new Int16Array(width);
 		}
@@ -118,7 +129,7 @@ function makePackedRow(width) {
 		fgIdx[col] = c.index ?? -1;
 	}
 	function setBg(col, c) {
-		if (bgRgb === null) {
+		if (bgRgb === null || bgIdx === null) {
 			bgRgb = new Uint32Array(width);
 			bgIdx = new Int16Array(width);
 		}
@@ -126,7 +137,7 @@ function makePackedRow(width) {
 		bgIdx[col] = c.index ?? -1;
 	}
 	function setUl(col, c) {
-		if (ulRgb === null) {
+		if (ulRgb === null || ulIdx === null) {
 			ulRgb = new Uint32Array(width);
 			ulIdx = new Int16Array(width);
 		}
@@ -211,27 +222,27 @@ function makePackedRow(width) {
 			} else meta[col] = 0;
 		},
 		widen(col) {
-			meta[col] = (meta[col] | F_WIDE$1) >>> 0;
+			meta[col] = (itemAt(meta, col, "packed row metadata") | F_WIDE$1) >>> 0;
 			if (col + 1 < width) row.setEmpty(col + 1);
 		},
 		appendChar(col, ch) {
-			chars[col] = chars[col] + ch;
+			chars[col] = itemAt(chars, col, "packed row characters") + ch;
 		},
 		copyCellFrom(col, src, srcCol) {
 			row.setCellRaw(col, src.getCellRaw(srcCol));
 		},
 		getCellRaw(col) {
-			const m = meta[col];
+			const m = itemAt(meta, col, "packed row metadata");
 			if (m === 0 && chars[col] === "") return emptyCell();
 			return {
-				char: chars[col],
-				fg: m & F_HAS_FG ? unpackColor(fgRgb[col], fgIdx[col]) : null,
-				bg: m & F_HAS_BG ? unpackColor(bgRgb[col], bgIdx[col]) : null,
+				char: itemAt(chars, col, "packed row characters"),
+				fg: m & F_HAS_FG ? unpackColor(itemAt(required(fgRgb, "foreground color plane"), col, "foreground color plane"), itemAt(required(fgIdx, "foreground color index plane"), col, "foreground color index plane")) : null,
+				bg: m & F_HAS_BG ? unpackColor(itemAt(required(bgRgb, "background color plane"), col, "background color plane"), itemAt(required(bgIdx, "background color index plane"), col, "background color index plane")) : null,
 				bold: (m & F_BOLD$1) !== 0,
 				faint: (m & F_FAINT$1) !== 0,
 				italic: (m & F_ITALIC$1) !== 0,
 				underline: bitsToUnderline(m),
-				underlineColor: m & F_HAS_UL ? unpackColor(ulRgb[col], ulIdx[col]) : null,
+				underlineColor: m & F_HAS_UL ? unpackColor(itemAt(required(ulRgb, "underline color plane"), col, "underline color plane"), itemAt(required(ulIdx, "underline color index plane"), col, "underline color index plane")) : null,
 				overline: (m & F_OVERLINE$1) !== 0,
 				strikethrough: (m & F_STRIKE$1) !== 0,
 				inverse: (m & F_INVERSE$1) !== 0,
@@ -239,7 +250,7 @@ function makePackedRow(width) {
 				blink: (m & F_BLINK$1) !== 0,
 				protected: (m & F_PROTECTED$1) !== 0,
 				wide: (m & F_WIDE$1) !== 0,
-				url: m & F_HAS_URL ? urlMap.get(col) ?? null : null
+				url: m & F_HAS_URL ? required(urlMap, "packed row URL map").get(col) ?? null : null
 			};
 		},
 		toCells() {
@@ -254,10 +265,10 @@ function makePackedRow(width) {
 			return meta[col] === 0 && chars[col] === "";
 		},
 		getChar(col) {
-			return chars[col];
+			return itemAt(chars, col, "packed row characters");
 		},
 		isWide(col) {
-			return (meta[col] & F_WIDE$1) !== 0;
+			return (itemAt(meta, col, "packed row metadata") & F_WIDE$1) !== 0;
 		}
 	};
 	return row;
@@ -361,9 +372,9 @@ function buildPalette256() {
 		255
 	];
 	for (let r = 0; r < 6; r++) for (let g = 0; g < 6; g++) for (let b = 0; b < 6; b++) palette.push({
-		r: levels[r],
-		g: levels[g],
-		b: levels[b]
+		r: itemAt(levels, r, "ANSI cube red levels"),
+		g: itemAt(levels, g, "ANSI cube green levels"),
+		b: itemAt(levels, b, "ANSI cube blue levels")
 	});
 	for (let i = 0; i < 24; i++) {
 		const v = 8 + i * 10;
@@ -389,14 +400,14 @@ function parseColorSpec(spec) {
 			return Math.round(v * 255 / max);
 		};
 		return {
-			r: scale(rgbMatch[1]),
-			g: scale(rgbMatch[2]),
-			b: scale(rgbMatch[3])
+			r: scale(itemAt(rgbMatch, 1, "X11 red capture")),
+			g: scale(itemAt(rgbMatch, 2, "X11 green capture")),
+			b: scale(itemAt(rgbMatch, 3, "X11 blue capture"))
 		};
 	}
 	const hex6 = /^#([0-9a-fA-F]{6})$/.exec(s);
 	if (hex6) {
-		const v = hex6[1];
+		const v = itemAt(hex6, 1, "six-digit hex capture");
 		return {
 			r: parseInt(v.substring(0, 2), 16),
 			g: parseInt(v.substring(2, 4), 16),
@@ -405,12 +416,12 @@ function parseColorSpec(spec) {
 	}
 	const hex3 = /^#([0-9a-fA-F]{3})$/.exec(s);
 	if (hex3) {
-		const v = hex3[1];
+		const v = itemAt(hex3, 1, "three-digit hex capture");
 		const expand = (ch) => parseInt(ch + ch, 16);
 		return {
-			r: expand(v[0]),
-			g: expand(v[1]),
-			b: expand(v[2])
+			r: expand(itemAt(v, 0, "short hex red channel")),
+			g: expand(itemAt(v, 1, "short hex green channel")),
+			b: expand(itemAt(v, 2, "short hex blue channel"))
 		};
 	}
 	return null;
@@ -467,6 +478,7 @@ function createScreen(options = {}) {
 	let rows = options.rows ?? 24;
 	let scrollbackLimit = options.scrollbackLimit ?? 1e3;
 	const onResponse = options.onResponse;
+	const kittyGraphicsImages = options.kittyGraphicsImages ?? false;
 	const maxStringSequenceLength = options.maxStringSequenceLength ?? 16777216;
 	if (!Number.isSafeInteger(maxStringSequenceLength) || maxStringSequenceLength < 0) throw new RangeError("maxStringSequenceLength must be a non-negative safe integer");
 	let mainGrid = makeGrid(cols, rows);
@@ -484,12 +496,15 @@ function createScreen(options = {}) {
 		attrs: resetAttrs(),
 		originMode: false,
 		autoWrap: true,
-		charsetG0: false
+		charsetG0: false,
+		charsetG1: false,
+		activeG1: false
 	};
 	let savedCurX = 0;
 	let savedCurY = 0;
 	let attrs = resetAttrs();
 	let title = "";
+	let iconLabel = "";
 	let useAltScreen = false;
 	let bracketedPaste = false;
 	let applicationCursor = false;
@@ -506,7 +521,6 @@ function createScreen(options = {}) {
 	let syncOutput = false;
 	let kittyKeyboardFlags = 0;
 	let kittyKeyboardStack = [];
-	let hasKittyGraphics = false;
 	let scrollTop = 0;
 	let scrollBottom = rows - 1;
 	let leftRightMarginMode = false;
@@ -663,6 +677,8 @@ function createScreen(options = {}) {
 		assertBoolean("savedState.originMode", saved.originMode);
 		assertBoolean("savedState.autoWrap", saved.autoWrap);
 		assertBoolean("savedState.charsetG0", saved.charsetG0);
+		if (Object.hasOwn(saved, "charsetG1")) assertBoolean("savedState.charsetG1", saved.charsetG1);
+		if (Object.hasOwn(saved, "activeG1")) assertBoolean("savedState.activeG1", saved.activeG1);
 		assertRecord("attrs", value.attrs);
 		const modes = value.modes;
 		assertRecord("modes", modes);
@@ -701,6 +717,7 @@ function createScreen(options = {}) {
 		if (!Array.isArray(value.tabStops)) throw new TypeError("Invalid vterm snapshot tabStops");
 		for (const stop of value.tabStops) assertInteger("tabStops", stop);
 		assertString("title", value.title);
+		if (Object.hasOwn(value, "iconLabel")) assertString("iconLabel", value.iconLabel);
 		assertString("clipboard", value.clipboard);
 		assertString("cwd", value.cwd);
 		if (!Array.isArray(value.notifications) || value.notifications.some((entry) => typeof entry !== "string")) throw new TypeError("Invalid vterm snapshot notifications");
@@ -745,6 +762,8 @@ function createScreen(options = {}) {
 		const unicode = value.unicode;
 		assertRecord("unicode", unicode);
 		assertBoolean("unicode.charsetG0", unicode.charsetG0);
+		if (Object.hasOwn(unicode, "charsetG1")) assertBoolean("unicode.charsetG1", unicode.charsetG1);
+		if (Object.hasOwn(unicode, "activeG1")) assertBoolean("unicode.activeG1", unicode.activeG1);
 		assertString("unicode.lastChar", unicode.lastChar);
 		if (unicode.pendingRegionalIndicator !== null) assertString("unicode.pendingRegionalIndicator", unicode.pendingRegionalIndicator);
 		assertBoolean("unicode.afterZWJ", unicode.afterZWJ);
@@ -765,15 +784,14 @@ function createScreen(options = {}) {
 		return 0;
 	}
 	let textScale = 1;
-	const CELL_W_PX = 8;
-	const CELL_H_PX = 17;
-	const FONT_ASCENT_PX = 14;
 	let fontSize = 12;
 	let fontWindowSize = 12;
 	let locale = "en_US.UTF-8";
 	let advancedClipboard = "";
 	let viewportOffset = 0;
 	let charsetG0 = false;
+	let charsetG1 = false;
+	let activeG1 = false;
 	let clipboard = "";
 	let cwd = "";
 	let notifications = [];
@@ -939,13 +957,12 @@ function createScreen(options = {}) {
 		if (bytes.length === 0) return 0;
 		let continuationCount = 0;
 		let leadIndex = bytes.length - 1;
-		while (leadIndex >= 0 && (bytes[leadIndex] & 192) === 128 && continuationCount < 3) {
+		while (leadIndex >= 0 && (itemAt(bytes, leadIndex, "UTF-8 pending bytes") & 192) === 128 && continuationCount < 3) {
 			continuationCount++;
 			leadIndex--;
 		}
 		if (leadIndex < 0) return bytes.length;
-		const lead = bytes[leadIndex];
-		const expectedLength = utf8SequenceLength(lead);
+		const expectedLength = utf8SequenceLength(itemAt(bytes, leadIndex, "UTF-8 lead byte"));
 		if (expectedLength === 0) return bytes.length;
 		return expectedLength > bytes.length - leadIndex ? leadIndex : bytes.length;
 	}
@@ -1051,11 +1068,11 @@ function createScreen(options = {}) {
 			const lm = leftMargin;
 			const rm = rightMargin;
 			for (let r = top; r < bottom; r++) {
-				const srcRow = grid[r + 1];
-				const dstRow = grid[r];
+				const srcRow = itemAt(grid, r + 1, "scroll source rows");
+				const dstRow = itemAt(grid, r, "scroll destination rows");
 				for (let c = lm; c <= rm && c < cols; c++) dstRow.copyCellFrom(c, srcRow, c);
 			}
-			const bottomRow = grid[bottom];
+			const bottomRow = itemAt(grid, bottom, "scroll bottom row");
 			for (let c = lm; c <= rm && c < cols; c++) bottomRow.setEmpty(c);
 			markScreenRowsDirty(top, bottom);
 		} else {
@@ -1098,16 +1115,16 @@ function createScreen(options = {}) {
 			const lm = leftMargin;
 			const rm = rightMargin;
 			for (let r = bottom; r > top; r--) {
-				const srcRow = grid[r - 1];
-				const dstRow = grid[r];
+				const srcRow = itemAt(grid, r - 1, "reverse-scroll source rows");
+				const dstRow = itemAt(grid, r, "reverse-scroll destination rows");
 				for (let c = lm; c <= rm && c < cols; c++) dstRow.copyCellFrom(c, srcRow, c);
 			}
-			const topRow = grid[top];
+			const topRow = itemAt(grid, top, "reverse-scroll top row");
 			for (let c = lm; c <= rm && c < cols; c++) topRow.setEmpty(c);
 		} else {
 			for (let i = bottom; i > top; i--) {
-				grid[i] = grid[i - 1];
-				softWrapped[i] = softWrapped[i - 1];
+				grid[i] = itemAt(grid, i - 1, "reverse-scroll source rows");
+				softWrapped[i] = itemAt(softWrapped, i - 1, "reverse-scroll source wrap flags");
 			}
 			grid[top] = makeRow(cols);
 			softWrapped[top] = false;
@@ -1132,7 +1149,7 @@ function createScreen(options = {}) {
 			if (prevRow < 0) return null;
 			prevCol = cols - 1;
 		}
-		const row = grid[prevRow];
+		const row = itemAt(grid, prevRow, "previous-cell rows");
 		if (prevCol > 0 && row.getChar(prevCol) === "" && row.isWide(prevCol - 1)) prevCol--;
 		if (row.isEmpty(prevCol)) return null;
 		return {
@@ -1146,7 +1163,7 @@ function createScreen(options = {}) {
 		row.widen(col);
 	}
 	function writeChar(ch) {
-		if (charsetG0 && ch.length === 1) {
+		if ((activeG1 ? charsetG1 : charsetG0) && ch.length === 1) {
 			const mapped = DEC_SPECIAL_GRAPHICS[ch];
 			if (mapped) ch = mapped;
 		}
@@ -1196,14 +1213,16 @@ function createScreen(options = {}) {
 				return;
 			}
 		}
-		if (isRegionalIndicator(codePoint)) if (pendingRegionalIndicator !== null) {
-			const flag = pendingRegionalIndicator + ch;
-			pendingRegionalIndicator = null;
-			writeCharCore(flag, true);
-			return;
-		} else {
-			pendingRegionalIndicator = ch;
-			return;
+		if (isRegionalIndicator(codePoint)) {
+			if (pendingRegionalIndicator !== null) {
+				const flag = pendingRegionalIndicator + ch;
+				pendingRegionalIndicator = null;
+				writeCharCore(flag, true);
+				return;
+			} else {
+				pendingRegionalIndicator = ch;
+				return;
+			}
 		}
 		if (pendingRegionalIndicator !== null) {
 			const ri = pendingRegionalIndicator;
@@ -1218,18 +1237,20 @@ function createScreen(options = {}) {
 		const charWidth = wide ? 2 : 1;
 		const wrapBoundary = leftRightMarginMode ? rightMargin + 1 : rowCols(curY);
 		const wrapReturn = leftRightMarginMode ? leftMargin : 0;
-		if (curX + charWidth > wrapBoundary) if (autoWrap) {
-			softWrapped[curY] = true;
-			curX = wrapReturn;
-			curY++;
-			if (curY > scrollBottom) {
-				curY = scrollBottom;
-				scrollUp(scrollTop, scrollBottom);
-			}
-		} else curX = wrapBoundary - charWidth;
+		if (curX + charWidth > wrapBoundary) {
+			if (autoWrap) {
+				softWrapped[curY] = true;
+				curX = wrapReturn;
+				curY++;
+				if (curY > scrollBottom) {
+					curY = scrollBottom;
+					scrollUp(scrollTop, scrollBottom);
+				}
+			} else curX = wrapBoundary - charWidth;
+		}
 		if (insertMode) {
 			const insertEnd = leftRightMarginMode ? rightMargin + 1 : cols;
-			mutateRowAsCells(grid[curY], (cells) => {
+			mutateRowAsCells(itemAt(grid, curY, "cursor row"), (cells) => {
 				for (let i = 0; i < charWidth; i++) {
 					cells.splice(insertEnd - 1, 1);
 					cells.splice(curX, 0, emptyCell());
@@ -1272,7 +1293,6 @@ function createScreen(options = {}) {
 				case 6:
 					cursorShape = "bar";
 					cursorBlinking = false;
-					break;
 			}
 			else if (finalByte === "@") handleShiftLeft(Math.max(parts[0] ?? 1, 1));
 			else if (finalByte === "A") handleShiftRight(Math.max(parts[0] ?? 1, 1));
@@ -1301,7 +1321,7 @@ function createScreen(options = {}) {
 				const { t, l, b, r } = normalizeRect(parts[1] ?? 1, parts[2] ?? 1, parts[3] ?? rows, parts[4] ?? cols);
 				const fillChar = String.fromCharCode(charCode);
 				for (let row = t; row <= b && row < rows; row++) {
-					const gr = grid[row];
+					const gr = itemAt(grid, row, "rectangular erase rows");
 					for (let col = l; col <= r && col < cols; col++) {
 						const cell = emptyCell();
 						cell.char = fillChar;
@@ -1312,7 +1332,7 @@ function createScreen(options = {}) {
 			} else if (finalByte === "z" || finalByte === "{") {
 				const { t, l, b, r } = normalizeRect(parts[0] ?? 1, parts[1] ?? 1, parts[2] ?? rows, parts[3] ?? cols);
 				for (let row = t; row <= b && row < rows; row++) {
-					const gr = grid[row];
+					const gr = itemAt(grid, row, "rectangular fill rows");
 					for (let col = l; col <= r && col < cols; col++) gr.setEmpty(col);
 				}
 				markScreenRowsDirty(t, Math.min(b, rows - 1));
@@ -1332,11 +1352,11 @@ function createScreen(options = {}) {
 				for (let row = 0; row < h; row++) {
 					const dr = dstTop + row;
 					if (dr < 0 || dr >= rows) continue;
-					const dstRow = grid[dr];
+					const dstRow = itemAt(grid, dr, "rectangular copy destination rows");
 					for (let col = 0; col < w; col++) {
 						const dc = dstLeft + col;
 						if (dc < 0 || dc >= cols) continue;
-						dstRow.setCellRaw(dc, snapshot[row][col]);
+						dstRow.setCellRaw(dc, itemAt(itemAt(snapshot, row, "rectangular copy rows"), col, "rectangular copy cells"));
 					}
 				}
 				markScreenRowsDirty(Math.max(0, dstTop), Math.min(dstTop + h - 1, rows - 1));
@@ -1345,7 +1365,7 @@ function createScreen(options = {}) {
 				const sgrParts = parts.slice(4);
 				const reverse = finalByte === "t";
 				for (let row = t; row <= b && row < rows; row++) {
-					const gr = grid[row];
+					const gr = itemAt(grid, row, "rectangular attribute rows");
 					for (let col = l; col <= r && col < cols; col++) {
 						const cell = gr.getCellRaw(col);
 						applyRectAttrs(cell, sgrParts, reverse);
@@ -1444,24 +1464,20 @@ function createScreen(options = {}) {
 			case "t": {
 				const op = parts[0] ?? 0;
 				if (!onResponse) break;
-				const CELL_H = 16;
-				const CELL_W = 8;
 				switch (op) {
 					case 14:
-						onResponse(`\x1b[4;${rows * CELL_H};${cols * CELL_W}t`);
+						onResponse("\x1B[4;0;0t");
 						break;
 					case 16:
-						onResponse(`\x1b[6;${CELL_H};${CELL_W}t`);
+						onResponse("\x1B[6;0;0t");
 						break;
 					case 18:
 						onResponse(`\x1b[8;${rows};${cols}t`);
 						break;
 					case 20:
-						onResponse(`\x1b]L${title}\x1b\\`);
-						break;
-					case 21:
-						onResponse(`\x1b]l${title}\x1b\\`);
+						onResponse(`\x1b]L${iconLabel}\x1b\\`);
 						break;
+					case 21: onResponse(`\x1b]l${title}\x1b\\`);
 				}
 				break;
 			}
@@ -1580,8 +1596,6 @@ function createScreen(options = {}) {
 				curX = savedCurX;
 				curY = savedCurY;
 				clampCursor();
-				break;
-			default: break;
 		}
 	}
 	function handleCSIGt(params, _intermediates, finalByte) {
@@ -1688,9 +1702,7 @@ function createScreen(options = {}) {
 					case 1007:
 						value = altScrollMode ? 1 : 2;
 						break;
-					case 1048:
-						value = 2;
-						break;
+					case 1048: value = 2;
 				}
 				onResponse(`\x1b[?${mode};${value}$y`);
 			}
@@ -1819,16 +1831,14 @@ function createScreen(options = {}) {
 			case 1007:
 				altScrollMode = set;
 				break;
-			case 1048:
-				if (set) {
-					savedCurX = curX;
-					savedCurY = curY;
-				} else {
-					curX = savedCurX;
-					curY = savedCurY;
-					clampCursor();
-				}
-				break;
+			case 1048: if (set) {
+				savedCurX = curX;
+				savedCurY = curY;
+			} else {
+				curX = savedCurX;
+				curY = savedCurY;
+				clampCursor();
+			}
 		}
 	}
 	function handleEraseDisplay(mode, selective = false) {
@@ -1846,7 +1856,6 @@ function createScreen(options = {}) {
 				for (let row = 0; row < rows; row++) eraseCells(row, 0, row, cols - 1, selective);
 				if (mode === 3) clearScrollback();
 				markAllDirty();
-				break;
 		}
 	}
 	function handleEraseLine(mode, selective = false) {
@@ -1859,9 +1868,7 @@ function createScreen(options = {}) {
 			case 1:
 				eraseCells(curY, eraseLeft, curY, curX, selective);
 				break;
-			case 2:
-				eraseCells(curY, eraseLeft, curY, eraseRight, selective);
-				break;
+			case 2: eraseCells(curY, eraseLeft, curY, eraseRight, selective);
 		}
 	}
 	function eraseCells(row, startCol, _endRow, endCol, selective = false) {
@@ -2014,9 +2021,7 @@ function createScreen(options = {}) {
 			case 25:
 				cell.blink = false;
 				break;
-			case 27:
-				cell.inverse = false;
-				break;
+			case 27: cell.inverse = false;
 		}
 	}
 	function handleSGR(rawParams) {
@@ -2026,7 +2031,7 @@ function createScreen(options = {}) {
 		for (const seg of segments) if (seg.includes(":")) {
 			const subs = seg.split(":").map((s) => s === "" ? 0 : parseInt(s, 10));
 			subParams.set(params.length, subs);
-			params.push(subs[0]);
+			params.push(itemAt(subs, 0, "SGR sub-parameters"));
 		} else params.push(seg === "" ? 0 : parseInt(seg, 10));
 		if (params.length === 0 || params.length === 1 && params[0] === 0) {
 			attrs = resetSgrAttrs();
@@ -2034,7 +2039,7 @@ function createScreen(options = {}) {
 		}
 		let i = 0;
 		while (i < params.length) {
-			const code = params[i];
+			const code = itemAt(params, i, "SGR parameters");
 			switch (code) {
 				case 0:
 					attrs = resetSgrAttrs();
@@ -2050,7 +2055,7 @@ function createScreen(options = {}) {
 					break;
 				case 4: {
 					const subs = subParams.get(i);
-					if (subs && subs.length > 1) switch (subs[1]) {
+					if (subs && subs.length > 1) switch (itemAt(subs, 1, "underline style sub-parameters")) {
 						case 0:
 							attrs.underline = "none";
 							break;
@@ -2069,9 +2074,7 @@ function createScreen(options = {}) {
 						case 5:
 							attrs.underline = "dashed";
 							break;
-						default:
-							attrs.underline = "single";
-							break;
+						default: attrs.underline = "single";
 					}
 					else attrs.underline = "single";
 					break;
@@ -2125,7 +2128,7 @@ function createScreen(options = {}) {
 				case 36:
 				case 37:
 					attrs.fg = {
-						...palette256[code - 30],
+						...itemAt(palette256, code - 30, "basic foreground palette"),
 						index: code - 30
 					};
 					break;
@@ -2155,7 +2158,7 @@ function createScreen(options = {}) {
 				case 46:
 				case 47:
 					attrs.bg = {
-						...palette256[code - 40],
+						...itemAt(palette256, code - 40, "basic background palette"),
 						index: code - 40
 					};
 					break;
@@ -2208,7 +2211,7 @@ function createScreen(options = {}) {
 				case 96:
 				case 97:
 					attrs.fg = {
-						...palette256[code - 90 + 8],
+						...itemAt(palette256, code - 90 + 8, "bright foreground palette"),
 						index: code - 90 + 8
 					};
 					break;
@@ -2219,12 +2222,10 @@ function createScreen(options = {}) {
 				case 104:
 				case 105:
 				case 106:
-				case 107:
-					attrs.bg = {
-						...palette256[code - 100 + 8],
-						index: code - 100 + 8
-					};
-					break;
+				case 107: attrs.bg = {
+					...itemAt(palette256, code - 100 + 8, "bright background palette"),
+					index: code - 100 + 8
+				};
 			}
 			i++;
 		}
@@ -2233,7 +2234,7 @@ function createScreen(options = {}) {
 		if (startIndex + 1 >= params.length) return null;
 		const type = params[startIndex + 1];
 		if (type === 5 && startIndex + 2 < params.length) {
-			const idx = params[startIndex + 2];
+			const idx = itemAt(params, startIndex + 2, "indexed color parameters");
 			const entry = palette256[idx];
 			return {
 				color: entry ? {
@@ -2248,9 +2249,9 @@ function createScreen(options = {}) {
 			};
 		} else if (type === 2 && startIndex + 4 < params.length) return {
 			color: {
-				r: params[startIndex + 2],
-				g: params[startIndex + 3],
-				b: params[startIndex + 4]
+				r: itemAt(params, startIndex + 2, "truecolor red parameter"),
+				g: itemAt(params, startIndex + 3, "truecolor green parameter"),
+				b: itemAt(params, startIndex + 4, "truecolor blue parameter")
 			},
 			nextIndex: startIndex + 5
 		};
@@ -2261,7 +2262,7 @@ function createScreen(options = {}) {
 		if (subs.length < 3) return null;
 		const type = subs[1];
 		if (type === 5 && subs.length >= 3) {
-			const idx = subs[2];
+			const idx = itemAt(subs, 2, "indexed color sub-parameters");
 			const entry = palette256[idx];
 			return entry ? {
 				...entry,
@@ -2274,18 +2275,18 @@ function createScreen(options = {}) {
 		} else if (type === 2) {
 			if (subs.length >= 5) {
 				if (subs.length >= 6) return {
-					r: subs[3],
-					g: subs[4],
-					b: subs[5]
+					r: itemAt(subs, 3, "colorspace red sub-parameter"),
+					g: itemAt(subs, 4, "colorspace green sub-parameter"),
+					b: itemAt(subs, 5, "colorspace blue sub-parameter")
 				};
 				return {
-					r: subs[2],
-					g: subs[3],
-					b: subs[4]
+					r: itemAt(subs, 2, "truecolor red sub-parameter"),
+					g: itemAt(subs, 3, "truecolor green sub-parameter"),
+					b: itemAt(subs, 4, "truecolor blue sub-parameter")
 				};
 			} else if (subs.length >= 4) return {
-				r: subs[2],
-				g: subs[3],
+				r: itemAt(subs, 2, "partial truecolor red sub-parameter"),
+				g: itemAt(subs, 3, "partial truecolor green sub-parameter"),
 				b: 0
 			};
 		}
@@ -2298,6 +2299,9 @@ function createScreen(options = {}) {
 		const value = semicolonIdx === -1 ? "" : oscString.substring(semicolonIdx + 1);
 		switch (code) {
 			case 0:
+				iconLabel = value;
+				title = value;
+				break;
 			case 2:
 				title = value;
 				break;
@@ -2317,17 +2321,16 @@ function createScreen(options = {}) {
 							startCol: curX
 						});
 						break;
-					case "C":
-						semanticZones.push({
-							type: "output",
-							startRow: curY,
-							startCol: curX
-						});
-						break;
-					case "D": break;
+					case "C": semanticZones.push({
+						type: "output",
+						startRow: curY,
+						startCol: curX
+					});
 				}
 				break;
-			case 1: break;
+			case 1:
+				iconLabel = value;
+				break;
 			case 7:
 				cwd = value;
 				break;
@@ -2342,8 +2345,8 @@ function createScreen(options = {}) {
 			case 4: {
 				const fields = value.split(";");
 				for (let fi = 0; fi + 1 < fields.length; fi += 2) {
-					const idx = parseInt(fields[fi], 10);
-					const spec = fields[fi + 1];
+					const idx = parseInt(itemAt(fields, fi, "OSC 4 palette fields"), 10);
+					const spec = itemAt(fields, fi + 1, "OSC 4 palette fields");
 					if (isNaN(idx) || idx < 0 || idx > 255) continue;
 					if (spec === "?") {
 						const c = palette256[idx];
@@ -2358,8 +2361,8 @@ function createScreen(options = {}) {
 			case 5: {
 				const fields = value.split(";");
 				for (let fi = 0; fi + 1 < fields.length; fi += 2) {
-					const idx = parseInt(fields[fi], 10);
-					const spec = fields[fi + 1];
+					const idx = parseInt(itemAt(fields, fi, "OSC 5 special-color fields"), 10);
+					const spec = itemAt(fields, fi + 1, "OSC 5 special-color fields");
 					if (isNaN(idx) || idx < 0 || idx > 4) continue;
 					if (spec === "?") {
 						const c = specialColors.get(idx);
@@ -2469,70 +2472,76 @@ function createScreen(options = {}) {
 					const isQuery = val === "?";
 					const paletteMatch = /^color(\d+)$/.exec(key);
 					if (paletteMatch) {
-						const idx = parseInt(paletteMatch[1], 10);
+						const idx = parseInt(itemAt(paletteMatch, 1, "OSC 104 palette capture"), 10);
 						if (idx < 0 || idx > 255) continue;
 						if (isQuery) {
 							const c = palette256[idx];
 							if (c) response.push(`${key}=${formatColorResponse(c)}`);
 						} else if (val === "") {
 							const fresh = buildPalette256();
-							palette256[idx] = fresh[idx];
+							palette256[idx] = itemAt(fresh, idx, "fresh ANSI palette");
 						} else {
 							const c = parseColorSpec(val);
 							if (c) palette256[idx] = c;
 						}
-					} else if (key === "foreground") if (isQuery) {
-						const c = defaultFgColor ?? {
-							r: 255,
-							g: 255,
-							b: 255
-						};
-						response.push(`${key}=${formatColorResponse(c)}`);
-					} else if (val === "") defaultFgColor = null;
-					else {
-						const c = parseColorSpec(val);
-						if (c) defaultFgColor = c;
-					}
-					else if (key === "background") if (isQuery) {
-						const c = defaultBgColor ?? {
-							r: 0,
-							g: 0,
-							b: 0
-						};
-						response.push(`${key}=${formatColorResponse(c)}`);
-					} else if (val === "") defaultBgColor = null;
-					else {
-						const c = parseColorSpec(val);
-						if (c) defaultBgColor = c;
-					}
-					else if (key === "cursor") if (isQuery) {
-						const c = cursorColor ?? defaultFgColor ?? {
-							r: 255,
-							g: 255,
-							b: 255
-						};
-						response.push(`${key}=${formatColorResponse(c)}`);
-					} else if (val === "") cursorColor = null;
-					else {
-						const c = parseColorSpec(val);
-						if (c) cursorColor = c;
+					} else if (key === "foreground") {
+						if (isQuery) {
+							const c = defaultFgColor ?? {
+								r: 255,
+								g: 255,
+								b: 255
+							};
+							response.push(`${key}=${formatColorResponse(c)}`);
+						} else if (val === "") defaultFgColor = null;
+						else {
+							const c = parseColorSpec(val);
+							if (c) defaultFgColor = c;
+						}
+					} else if (key === "background") {
+						if (isQuery) {
+							const c = defaultBgColor ?? {
+								r: 0,
+								g: 0,
+								b: 0
+							};
+							response.push(`${key}=${formatColorResponse(c)}`);
+						} else if (val === "") defaultBgColor = null;
+						else {
+							const c = parseColorSpec(val);
+							if (c) defaultBgColor = c;
+						}
+					} else if (key === "cursor") {
+						if (isQuery) {
+							const c = cursorColor ?? defaultFgColor ?? {
+								r: 255,
+								g: 255,
+								b: 255
+							};
+							response.push(`${key}=${formatColorResponse(c)}`);
+						} else if (val === "") cursorColor = null;
+						else {
+							const c = parseColorSpec(val);
+							if (c) cursorColor = c;
+						}
+					} else if (key === "selection_background") {
+						if (isQuery) {
+							const c = highlightBgColor ?? defaultFgColor ?? {
+								r: 255,
+								g: 255,
+								b: 255
+							};
+							response.push(`${key}=${formatColorResponse(c)}`);
+						} else highlightBgColor = val === "" ? null : parseColorSpec(val);
+					} else if (key === "selection_foreground") {
+						if (isQuery) {
+							const c = highlightFgColor ?? defaultBgColor ?? {
+								r: 0,
+								g: 0,
+								b: 0
+							};
+							response.push(`${key}=${formatColorResponse(c)}`);
+						} else highlightFgColor = val === "" ? null : parseColorSpec(val);
 					}
-					else if (key === "selection_background") if (isQuery) {
-						const c = highlightBgColor ?? defaultFgColor ?? {
-							r: 255,
-							g: 255,
-							b: 255
-						};
-						response.push(`${key}=${formatColorResponse(c)}`);
-					} else highlightBgColor = val === "" ? null : parseColorSpec(val);
-					else if (key === "selection_foreground") if (isQuery) {
-						const c = highlightFgColor ?? defaultBgColor ?? {
-							r: 0,
-							g: 0,
-							b: 0
-						};
-						response.push(`${key}=${formatColorResponse(c)}`);
-					} else highlightFgColor = val === "" ? null : parseColorSpec(val);
 				}
 				if (response.length > 0 && onResponse) onResponse(`\x1b]21;${response.join(";")}\x1b\\`);
 				break;
@@ -2543,7 +2552,7 @@ function createScreen(options = {}) {
 					const fresh = buildPalette256();
 					for (const tok of value.split(";")) {
 						const idx = parseInt(tok, 10);
-						if (!isNaN(idx) && idx >= 0 && idx < 256) palette256[idx] = fresh[idx];
+						if (!isNaN(idx) && idx >= 0 && idx < 256) palette256[idx] = itemAt(fresh, idx, "fresh ANSI palette");
 					}
 				}
 				break;
@@ -2614,14 +2623,11 @@ function createScreen(options = {}) {
 							startCol: curX
 						});
 						break;
-					case "C":
-						semanticZones.push({
-							type: "output",
-							startRow: curY,
-							startCol: curX
-						});
-						break;
-					case "D": break;
+					case "C": semanticZones.push({
+						type: "output",
+						startRow: curY,
+						startCol: curX
+					});
 				}
 				break;
 			case 66:
@@ -2656,7 +2662,7 @@ function createScreen(options = {}) {
 				break;
 			}
 			case 776:
-				if (onResponse) onResponse(`\x1b]776;${CELL_W_PX};${CELL_H_PX};${FONT_ASCENT_PX}\x1b\\`);
+				if (onResponse) onResponse("\x1B]776;0;0;0\x1B\\");
 				break;
 			case 7770:
 				if (value === "?") {
@@ -2694,10 +2700,8 @@ function createScreen(options = {}) {
 					advancedClipboard = "";
 				}
 				break;
-			case 1337:
-				if (value === "ReportCellSize" && onResponse) onResponse("\x1B]1337;ReportCellSize=16;8\x1B\\");
-				else if (value === "RequestCapabilities" && onResponse) onResponse("\x1B]1337;Capabilities=\x1B\\");
-				break;
+			case 1337: if (value === "ReportCellSize" && onResponse) onResponse("\x1B]1337;ReportCellSize=0;0\x1B\\");
+			else if (value === "RequestCapabilities" && onResponse) onResponse("\x1B]1337;Capabilities=\x1B\\");
 		}
 	}
 	function handleDCS(data) {
@@ -2705,7 +2709,7 @@ function createScreen(options = {}) {
 		if (match) {
 			hasSixel = true;
 			sixelImages.push({
-				data: match[2],
+				data: itemAt(match, 2, "sixel payload capture"),
 				row: dcsStartRow,
 				col: dcsStartCol
 			});
@@ -2726,7 +2730,6 @@ function createScreen(options = {}) {
 	}
 	function handleAPC(data) {
 		if (!data.startsWith("G")) return;
-		hasKittyGraphics = true;
 		const semicolonIdx = data.indexOf(";");
 		const kvPart = semicolonIdx >= 0 ? data.substring(1, semicolonIdx) : data.substring(1);
 		const params = {};
@@ -2734,7 +2737,11 @@ function createScreen(options = {}) {
 			const eqIdx = pair.indexOf("=");
 			if (eqIdx >= 0) params[pair.substring(0, eqIdx)] = pair.substring(eqIdx + 1);
 		}
-		if (params.a === "q" && onResponse) onResponse(`\x1b_Gi=${params.i ?? "0"};OK\x1b\\`);
+		if (params.a === "q" && onResponse) {
+			if (kittyGraphicsImages) {
+				if (params.q !== "1" && params.q !== "2") onResponse(`\x1b_Gi=${params.i ?? "0"};OK\x1b\\`);
+			} else if (params.q !== "2") onResponse(`\x1b_Gi=${params.i ?? "0"};ENOTSUP\x1b\\`);
+		}
 	}
 	function softReset() {
 		insertMode = false;
@@ -2759,6 +2766,8 @@ function createScreen(options = {}) {
 		rightMargin = cols - 1;
 		attrs = resetAttrs();
 		charsetG0 = false;
+		charsetG1 = false;
+		activeG1 = false;
 		curX = 0;
 		curY = 0;
 	}
@@ -2781,10 +2790,13 @@ function createScreen(options = {}) {
 			attrs: resetAttrs(),
 			originMode: false,
 			autoWrap: true,
-			charsetG0: false
+			charsetG0: false,
+			charsetG1: false,
+			activeG1: false
 		};
 		attrs = resetAttrs();
 		title = "";
+		iconLabel = "";
 		useAltScreen = false;
 		bracketedPaste = false;
 		applicationCursor = false;
@@ -2801,7 +2813,6 @@ function createScreen(options = {}) {
 		syncOutput = false;
 		kittyKeyboardFlags = 0;
 		kittyKeyboardStack = [];
-		hasKittyGraphics = false;
 		hasSixel = false;
 		sixelImages = [];
 		scrollTop = 0;
@@ -2820,6 +2831,8 @@ function createScreen(options = {}) {
 		advancedClipboard = "";
 		viewportOffset = 0;
 		charsetG0 = false;
+		charsetG1 = false;
+		activeG1 = false;
 		clipboard = "";
 		cwd = "";
 		notifications = [];
@@ -3015,6 +3028,12 @@ function createScreen(options = {}) {
 					} else if (code === 13) {
 						curX = 0;
 						emitExecute(13);
+					} else if (code === 14) {
+						activeG1 = true;
+						emitExecute(14);
+					} else if (code === 15) {
+						activeG1 = false;
+						emitExecute(15);
 					} else if (code >= 32) {
 						let char = ch;
 						if (code >= 55296 && code <= 56319 && i + 1 < text.length) {
@@ -3067,7 +3086,9 @@ function createScreen(options = {}) {
 							},
 							originMode,
 							autoWrap,
-							charsetG0
+							charsetG0,
+							charsetG1,
+							activeG1
 						};
 						parserState = "ground";
 						emitEsc("7", "");
@@ -3083,6 +3104,8 @@ function createScreen(options = {}) {
 						originMode = savedState.originMode;
 						autoWrap = savedState.autoWrap;
 						charsetG0 = savedState.charsetG0;
+						charsetG1 = savedState.charsetG1;
+						activeG1 = savedState.activeG1;
 						clampCursor();
 						parserState = "ground";
 						emitEsc("8", "");
@@ -3104,9 +3127,11 @@ function createScreen(options = {}) {
 						parserState = "escape_hash";
 					} else if (ch === "(") {
 						escIntermediate = "(";
+						escBuf = "(";
 						parserState = "escape_charset";
 					} else if (ch === ")") {
 						escIntermediate = ")";
+						escBuf = ")";
 						parserState = "escape_charset";
 					} else if (ch === "=") {
 						applicationKeypad = true;
@@ -3126,17 +3151,19 @@ function createScreen(options = {}) {
 					} else parserState = "ground";
 					break;
 				case "escape_charset":
-					if (ch === "0") charsetG0 = true;
-					else charsetG0 = false;
+					const designator = escBuf === ")" ? ")" : "(";
+					if (designator === ")") charsetG1 = ch === "0";
+					else charsetG0 = ch === "0";
+					escBuf = "";
 					parserState = "ground";
-					emitEsc(ch, escIntermediate);
+					emitEsc(ch, designator);
 					break;
 				case "escape_hash":
 					if (ch === "8") {
 						const alignCell = emptyCell();
 						alignCell.char = "E";
 						for (let r = 0; r < rows; r++) {
-							const row = grid[r];
+							const row = itemAt(grid, r, "selective erase rows");
 							for (let c = 0; c < cols; c++) row.setCellRaw(c, alignCell);
 							softWrapped[r] = false;
 						}
@@ -3223,7 +3250,6 @@ function createScreen(options = {}) {
 						apcOverflow = false;
 					}
 					parserState = "ground";
-					break;
 			}
 		}
 		flushPrintRun();
@@ -3283,10 +3309,10 @@ function createScreen(options = {}) {
 		const outLine = [];
 		let tracked = null;
 		for (let li = 0; li < logicalLines.length; li++) {
-			const line = logicalLines[li];
+			const line = itemAt(logicalLines, li, "reflow logical lines");
 			let lineLen = line.length;
 			while (lineLen > 0) {
-				const cell = line[lineLen - 1];
+				const cell = itemAt(line, lineLen - 1, "reflow logical-line cells");
 				if (cell.char === "" && !cell.wide) lineLen--;
 				else break;
 			}
@@ -3305,7 +3331,7 @@ function createScreen(options = {}) {
 				const row = makeRow(newCols);
 				let col = 0;
 				while (col < newCols && pos < lineLen) {
-					const cell = line[pos];
+					const cell = itemAt(line, pos, "reflow logical-line cells");
 					if (cell.wide && col + 2 > newCols) break;
 					if (track?.line === li && pos === track.offset) tracked = {
 						row: outRows.length,
@@ -3351,14 +3377,11 @@ function createScreen(options = {}) {
 	*/
 	function trimTrailingEmptyRows(result) {
 		const floor = result.tracked == null ? 1 : Math.max(1, result.tracked.row + 1);
-		while (result.rows.length > floor) {
-			const lastRow = result.rows[result.rows.length - 1];
-			if (packedRowIsBlank(lastRow) && !result.wrapped[result.rows.length - 2]) {
-				result.rows.pop();
-				result.wrapped.pop();
-				result.lineIndex?.pop();
-			} else break;
-		}
+		while (result.rows.length > floor) if (packedRowIsBlank(itemAt(result.rows, result.rows.length - 1, "reflow result rows")) && !result.wrapped[result.rows.length - 2]) {
+			result.rows.pop();
+			result.wrapped.pop();
+			result.lineIndex?.pop();
+		} else break;
 	}
 	function resize(newCols, newRows) {
 		if (newCols === cols && newRows === rows) return;
@@ -3388,7 +3411,7 @@ function createScreen(options = {}) {
 		if (restoredRows.length > 0) {
 			let completed = 0;
 			for (const wrapped of restoredWrapped) if (!wrapped) completed++;
-			if (cursorTrack.line === 0 && restoredWrapped[restoredWrapped.length - 1] === true) for (let i = restoredWrapped.length - 1; i >= 0 && restoredWrapped[i]; i--) cursorTrack.offset += restoredRows[i].length;
+			if (cursorTrack.line === 0 && restoredWrapped[restoredWrapped.length - 1] === true) for (let i = restoredWrapped.length - 1; i >= 0 && restoredWrapped[i]; i--) cursorTrack.offset += itemAt(restoredRows, i, "restored rows").length;
 			cursorTrack.line += completed;
 		}
 		const mainSrc = restoredRows.length > 0 ? [...restoredRows, ...mainGrid] : mainGrid;
@@ -3410,8 +3433,8 @@ function createScreen(options = {}) {
 			if (overflow !== void 0) bankScrollbackRow(overflow, mainResult.wrapped[r] ?? false, mainLogicalAttrs[mainResult.lineIndex[r] ?? 0] ?? 0);
 		}
 		for (let r = 0; r < newRows && mainStartRow + r < mainResult.rows.length; r++) {
-			newMain[r] = mainResult.rows[mainStartRow + r];
-			newMainWrapped[r] = mainResult.wrapped[mainStartRow + r];
+			newMain[r] = itemAt(mainResult.rows, mainStartRow + r, "resized main rows");
+			newMainWrapped[r] = itemAt(mainResult.wrapped, mainStartRow + r, "resized main wrap flags");
 			newMainAttrs[r] = mainLogicalAttrs[mainResult.lineIndex[mainStartRow + r] ?? 0] ?? 0;
 		}
 		const newAlt = makeGrid(newCols, newRows);
@@ -3419,8 +3442,8 @@ function createScreen(options = {}) {
 		const newAltAttrs = new Array(newRows).fill(0);
 		const altStartRow = Math.max(0, altResult.rows.length - newRows);
 		for (let r = 0; r < newRows && altStartRow + r < altResult.rows.length; r++) {
-			newAlt[r] = altResult.rows[altStartRow + r];
-			newAltWrapped[r] = altResult.wrapped[altStartRow + r];
+			newAlt[r] = itemAt(altResult.rows, altStartRow + r, "resized alternate rows");
+			newAltWrapped[r] = itemAt(altResult.wrapped, altStartRow + r, "resized alternate wrap flags");
 			newAltAttrs[r] = altLogicalAttrs[altResult.lineIndex[altStartRow + r] ?? 0] ?? 0;
 		}
 		const activeResult = useAltScreen ? altResult : mainResult;
@@ -3492,7 +3515,9 @@ function createScreen(options = {}) {
 				attrs: cloneAttrsSnapshot(savedState.attrs),
 				originMode: savedState.originMode,
 				autoWrap: savedState.autoWrap,
-				charsetG0: savedState.charsetG0
+				charsetG0: savedState.charsetG0,
+				charsetG1: savedState.charsetG1,
+				activeG1: savedState.activeG1
 			},
 			attrs: cloneAttrsSnapshot(attrs),
 			modes: {
@@ -3511,7 +3536,7 @@ function createScreen(options = {}) {
 				syncOutput,
 				kittyKeyboardFlags,
 				kittyKeyboardStack: [...kittyKeyboardStack],
-				kittyGraphics: hasKittyGraphics,
+				kittyGraphics: kittyGraphicsImages,
 				colorSchemeReporting,
 				decColumn: decColumnMode,
 				altScroll: altScrollMode,
@@ -3530,6 +3555,7 @@ function createScreen(options = {}) {
 			},
 			tabStops: [...tabStops].sort((a, b) => a - b),
 			title,
+			iconLabel,
 			clipboard,
 			cwd,
 			notifications: [...notifications],
@@ -3556,6 +3582,8 @@ function createScreen(options = {}) {
 			},
 			unicode: {
 				charsetG0,
+				charsetG1,
+				activeG1,
 				lastChar,
 				pendingRegionalIndicator,
 				afterZWJ
@@ -3593,7 +3621,9 @@ function createScreen(options = {}) {
 			attrs: cloneAttrsSnapshot(snapshotValue.savedState.attrs),
 			originMode: snapshotValue.savedState.originMode,
 			autoWrap: snapshotValue.savedState.autoWrap,
-			charsetG0: snapshotValue.savedState.charsetG0
+			charsetG0: snapshotValue.savedState.charsetG0,
+			charsetG1: snapshotValue.savedState.charsetG1 ?? false,
+			activeG1: snapshotValue.savedState.activeG1 ?? false
 		};
 		attrs = cloneAttrsSnapshot(snapshotValue.attrs);
 		bracketedPaste = snapshotValue.modes.bracketedPaste;
@@ -3611,7 +3641,6 @@ function createScreen(options = {}) {
 		syncOutput = snapshotValue.modes.syncOutput;
 		kittyKeyboardFlags = snapshotValue.modes.kittyKeyboardFlags;
 		kittyKeyboardStack = [...snapshotValue.modes.kittyKeyboardStack];
-		hasKittyGraphics = snapshotValue.modes.kittyGraphics;
 		colorSchemeReporting = snapshotValue.modes.colorSchemeReporting;
 		decColumnMode = snapshotValue.modes.decColumn;
 		altScrollMode = snapshotValue.modes.altScroll;
@@ -3626,6 +3655,7 @@ function createScreen(options = {}) {
 		colorStack.push(...snapshotValue.colors.stack.map(cloneColorStateSnapshot));
 		tabStops = new Set(snapshotValue.tabStops);
 		title = snapshotValue.title;
+		iconLabel = Object.hasOwn(snapshotValue, "iconLabel") ? snapshotValue.iconLabel : snapshotValue.title;
 		clipboard = snapshotValue.clipboard;
 		cwd = snapshotValue.cwd;
 		notifications = [...snapshotValue.notifications];
@@ -3645,6 +3675,8 @@ function createScreen(options = {}) {
 		apcOverflow = snapshotValue.parser.apcOverflow ?? false;
 		utf8PendingBytes = [...snapshotValue.parser.utf8PendingBytes];
 		charsetG0 = snapshotValue.unicode.charsetG0;
+		charsetG1 = snapshotValue.unicode.charsetG1 ?? false;
+		activeG1 = snapshotValue.unicode.activeG1 ?? false;
 		lastChar = snapshotValue.unicode.lastChar;
 		pendingRegionalIndicator = snapshotValue.unicode.pendingRegionalIndicator;
 		afterZWJ = snapshotValue.unicode.afterZWJ;
@@ -3678,7 +3710,7 @@ function createScreen(options = {}) {
 	}
 	function getText() {
 		const lines = [];
-		for (let r = 0; r < rows; r++) lines.push(rowToString(grid[r]));
+		for (let r = 0; r < rows; r++) lines.push(rowToString(itemAt(grid, r, "screen text rows")));
 		return lines.join("\n");
 	}
 	function getScrollbackText() {
@@ -3697,7 +3729,7 @@ function createScreen(options = {}) {
 	}
 	function getRowAbsolute(row) {
 		if (row < 0 || row >= scrollback.length + rows) return makeRow(cols).toCells();
-		return (row < scrollback.length ? scrollback[row] : grid[row - scrollback.length]).toCells().map(stripCellColorIndex);
+		return (row < scrollback.length ? itemAt(scrollback, row, "scrollback rows") : itemAt(grid, row - scrollback.length, "screen rows")).toCells().map(stripCellColorIndex);
 	}
 	function firstRetainedRow() {
 		return trimmedRowCount;
@@ -3772,7 +3804,7 @@ function createScreen(options = {}) {
 			case "leftRightMargin": return leftRightMarginMode;
 			case "colorSchemeReporting": return colorSchemeReporting;
 			case "kittyKeyboard": return kittyKeyboardFlags > 0;
-			case "kittyGraphics": return hasKittyGraphics;
+			case "kittyGraphics": return kittyGraphicsImages;
 			case "sixel": return hasSixel;
 			default: return false;
 		}
@@ -3850,7 +3882,7 @@ function createScreen(options = {}) {
 			leftRightMargin: leftRightMarginMode,
 			colorSchemeReporting,
 			kittyKeyboard: kittyKeyboardFlags > 0,
-			kittyGraphics: hasKittyGraphics,
+			kittyGraphics: kittyGraphicsImages,
 			sixel: hasSixel
 		};
 	}
@@ -4267,7 +4299,7 @@ function serializeSnapshot(snapshot, options = {}) {
 		const wraps = snapshot.scrollbackSoftWrapped;
 		const last = snapshot.scrollback.length - 1;
 		for (let i = 0; i < snapshot.scrollback.length; i++) {
-			const row = snapshot.scrollback[i];
+			const row = itemAt(snapshot.scrollback, i, "snapshot scrollback rows");
 			if (wraps?.[i] === true && i < last) out.push(serializeEncodeRow(row, hyperlinks, snapshot.cols), "\x1B[0m");
 			else out.push(serializeEncodeRow(row, hyperlinks), "\x1B[0m\r\n");
 		}
@@ -4295,7 +4327,7 @@ function serializeSnapshot(snapshot, options = {}) {
 		const def = SERIALIZE_DEFAULT_PALETTE[i];
 		if (cur !== void 0 && def !== void 0 && !serializeColorEq(cur, def)) out.push(`\x1b]4;${String(i)};${serializeColorSpec(cur)}\x1b\\`);
 	}
-	if (options.includeTitle === true && snapshot.title.length > 0) out.push(`\x1b]0;${snapshot.title}\x1b\\`);
+	if (options.includeTitle === true && snapshot.title.length > 0) out.push(`\x1b]2;${snapshot.title}\x1b\\`);
 	out.push("\x1B[?7l", "\x1B[H\x1B[2J");
 	const grid = snapshot.activeBuffer === "alt" ? snapshot.alt.grid : snapshot.main.grid;
 	for (let r = 0; r < rows; r++) {
@@ -4306,6 +4338,8 @@ function serializeSnapshot(snapshot, options = {}) {
 	out.push(m.autoWrap ? "\x1B[?7h" : "\x1B[?7l");
 	if (snapshot.cursor.shape !== "block" || !snapshot.cursor.blinking) out.push(`\x1b[${String(serializeCursorStyleCode(snapshot.cursor.shape, snapshot.cursor.blinking))} q`);
 	if (snapshot.unicode.charsetG0) out.push("\x1B(0");
+	if (snapshot.unicode.charsetG1) out.push("\x1B)0");
+	if (snapshot.unicode.activeG1) out.push("");
 	if (m.insert && !excluded.has("insert")) out.push("\x1B[4h");
 	if (!serializeTabStopsAreDefault(snapshot.tabStops, snapshot.cols)) {
 		out.push("\x1B[3g");
@@ -4791,6 +4825,7 @@ function readGridSection(r, softWrapNullable, expected, strings, colors, styles)
 * deterministic for identical input and decodes back to a deep-equal snapshot.
 */
 function encodeScreenSnapshotBinary(snapshot) {
+	if (Object.hasOwn(snapshot, "iconLabel") && typeof snapshot.iconLabel !== "string") throw new TypeError("vterm snapshot codec: invalid iconLabel");
 	const w = createWriter();
 	w.u8(VERSION);
 	const header = {
@@ -4807,6 +4842,7 @@ function encodeScreenSnapshotBinary(snapshot) {
 		colors: snapshot.colors,
 		tabStops: snapshot.tabStops,
 		title: snapshot.title,
+		...Object.hasOwn(snapshot, "iconLabel") ? { iconLabel: snapshot.iconLabel } : {},
 		clipboard: snapshot.clipboard,
 		cwd: snapshot.cwd,
 		notifications: snapshot.notifications,
@@ -4840,6 +4876,7 @@ function decodeScreenSnapshotBinary(bytes) {
 	if (version !== VERSION) throw new Error(`vterm snapshot codec: unsupported version byte ${version} (expected ${VERSION})`);
 	const headerLen = r.varint();
 	const header = JSON.parse(decoder.decode(r.take(headerLen)));
+	if (Object.hasOwn(header, "iconLabel") && typeof header.iconLabel !== "string") throw new TypeError("vterm snapshot codec: invalid iconLabel");
 	const strings = readStringTable(r);
 	const colors = readColorTable(r);
 	const styles = readStyleTable(r);
@@ -4875,6 +4912,7 @@ function decodeScreenSnapshotBinary(bytes) {
 		colors: header.colors,
 		tabStops: header.tabStops,
 		title: header.title,
+		...Object.hasOwn(header, "iconLabel") ? { iconLabel: header.iconLabel } : {},
 		clipboard: header.clipboard,
 		cwd: header.cwd,
 		notifications: header.notifications,