@simon_he/vue-tui 1.0.1 → 1.1.1

package/dist/core.js

@@ -1,10 +1,10 @@
-import { TERMINAL_RENDER_PLANES, createTerminal } from "./create-terminal-C2oiWFJU.js";
-import { charCellWidth, isSafeRelativeHref, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-Bn02UXJb.js";
-import { parseAnsiSgr } from "./sgr-BmzxEjAO.js";
+import { TERMINAL_RENDER_PLANES, createTerminal } from "./create-terminal-DXuZ2fci.js";
+import { charCellWidth } from "./width-GqllnV8C.js";
+import { isSafeRelativeHref, parseAnsiSgr, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-B35-O-cW.js";
 import { ansiColorRgb } from "./ansi-palette-CNXqFciC.js";
-import { firstNonEmptyEnv } from "./env-Cl8qmNFN.js";
-import { normalizeNewlines } from "./path-mnSgEpCm.js";
-import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-BNqcuE3-.js";
+import { firstNonEmptyEnv } from "./env-DNCzvX8b.js";
+import { normalizeNewlines } from "./path-BI9W15Zt.js";
+import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-fPzRsgPv.js";
 
 //#region src/core/ansi/colors.ts
 const ANSI8_COLOR_NAMES = Object.freeze([

package/dist/{create-terminal-C2oiWFJU.js → create-terminal-DXuZ2fci.js}

@@ -1,5 +1,5 @@
-import { charCellWidth, segmentedGraphemes } from "./hyperlink-Bn02UXJb.js";
-import { parseAnsiSgr } from "./sgr-BmzxEjAO.js";
+import { charCellWidth, segmentedGraphemes } from "./width-GqllnV8C.js";
+import { parseAnsiSgr } from "./hyperlink-B35-O-cW.js";
 
 //#region src/core/render-plane.ts
 const TERMINAL_RENDER_PLANES = [
@@ -106,14 +106,14 @@ function clamp(n, min, max) {
 	return Math.max(min, Math.min(max, n));
 }
 /**
-* Register a fingerprint function on the buffer. This enables SoA fingerprint
+* Register or clear a fingerprint function on the buffer. This enables SoA fingerprint
 * pre-computation: cell writes will update fingerprints inline, and the renderer
 * can read them via getRowFingerprints() instead of per-cell hash computation.
 */
 function setFingerprintFn(buffer, fn) {
 	buffer.fingerprintFn = fn;
 	const len = buffer.rows * buffer.cols;
-	if (!len) {
+	if (!fn || !len) {
 		buffer.soaFingerprints = null;
 		return;
 	}
@@ -134,7 +134,10 @@ function setFingerprintFn(buffer, fn) {
 */
 function getRowFingerprints(buffer, y) {
 	if (!buffer.soaFingerprints) return null;
-	const physY = physicalRowIndex(buffer, y);
+	if (buffer.rows <= 0 || buffer.cols <= 0) return null;
+	const yy = Math.floor(y);
+	if (!Number.isFinite(yy) || yy < 0 || yy >= buffer.rows) return null;
+	const physY = physicalRowIndex(buffer, yy);
 	const base = physY * buffer.cols;
 	return buffer.soaFingerprints.subarray(base, base + buffer.cols);
 }
@@ -424,9 +427,12 @@ function resizeBuffer(buffer, cols, rows) {
 	const nextCols = Math.max(0, Math.floor(cols));
 	const nextRows = Math.max(0, Math.floor(rows));
 	if (nextCols === buffer.cols && nextRows === buffer.rows) return;
+	const prevRows = buffer.rows;
+	const prevDirtyAll = buffer.dirtyAll;
+	const prevDirtyBits = buffer.dirtyBits;
 	const blank = createBlankCell();
 	const nextGrid = Array.from({ length: nextRows }, () => Array.from({ length: nextCols }, () => blank));
-	const copyRows = Math.min(buffer.rows, nextRows);
+	const copyRows = Math.min(prevRows, nextRows);
 	const copyCols = Math.min(buffer.cols, nextCols);
 	for (let y = 0; y < copyRows; y++) {
 		const src = getBufferRow(buffer, y);
@@ -450,10 +456,21 @@ function resizeBuffer(buffer, cols, rows) {
 	buffer.cols = nextCols;
 	buffer.rows = nextRows;
 	buffer.dirtyBits = new Uint8Array(nextRows);
-	buffer.dirtyCount = nextRows || 0;
-	buffer.dirtyMin = nextRows ? 0 : Number.POSITIVE_INFINITY;
-	buffer.dirtyMax = nextRows ? nextRows - 1 : -1;
-	buffer.dirtyAll = nextRows > 0;
+	buffer.dirtyCount = 0;
+	buffer.dirtyMin = Number.POSITIVE_INFINITY;
+	buffer.dirtyMax = -1;
+	buffer.dirtyAll = prevDirtyAll && nextRows > 0;
+	if (buffer.dirtyAll) {
+		buffer.dirtyCount = nextRows;
+		buffer.dirtyMin = 0;
+		buffer.dirtyMax = nextRows - 1;
+	} else for (let y = 0; y < copyRows; y++) {
+		if (prevDirtyBits[y] !== 1) continue;
+		buffer.dirtyBits[y] = 1;
+		buffer.dirtyCount++;
+		if (y < buffer.dirtyMin) buffer.dirtyMin = y;
+		if (y > buffer.dirtyMax) buffer.dirtyMax = y;
+	}
 	buffer.cursorX = clamp(buffer.cursorX, 0, Math.max(0, nextCols));
 	buffer.cursorY = clamp(buffer.cursorY, 0, Math.max(0, nextRows - 1));
 	if (buffer.fingerprintFn) {
@@ -526,6 +543,10 @@ function mergePlanes(prev, next) {
 	return Array.from(merged);
 }
 const TERMINAL_PLANE_INTERNALS = Symbol.for("@simon_he/vue-tui:v1:terminal-plane-internals");
+const TERMINAL_ROOT = Symbol.for("@simon_he/vue-tui:v1:terminal-root");
+function getRootTerminal(terminal) {
+	return terminal[TERMINAL_ROOT] ?? terminal;
+}
 function createCoverage(cols, rows) {
 	return Array.from({ length: rows }, () => new Uint8Array(cols));
 }
@@ -609,6 +630,8 @@ function markPlaneCoverageRange(state, x0, y0, x1, y1, value) {
 	}
 }
 function markPlaneCoverageForPut(state, x, y, ch, prevCell) {
+	if (!Number.isSafeInteger(x) || !Number.isSafeInteger(y)) return;
+	if (x < 0 || x >= state.buffer.cols || y < 0 || y >= state.buffer.rows) return;
 	const row = state.coverage[y];
 	if (!row) return;
 	if (prevCell?.continuation && x > 0) row[x - 1] = 1;
@@ -724,10 +747,14 @@ function createTerminal(opts) {
 	}
 	function putForPlane(plane, x, y, ch, style) {
 		const state = getPlaneState(plane);
-		if (y < 0 || y >= state.buffer.rows || x < 0 || x >= state.buffer.cols) return;
-		const prevCell = getBufferCell(state.buffer, x, y);
-		putCell(state.buffer, x, y, ch, style);
-		markPlaneCoverageForPut(state, x, y, ch, prevCell);
+		if (typeof x !== "number" || typeof y !== "number") return;
+		const cellX = Math.floor(x);
+		const cellY = Math.floor(y);
+		if (!Number.isFinite(cellX) || !Number.isFinite(cellY)) return;
+		if (cellY < 0 || cellY >= state.buffer.rows || cellX < 0 || cellX >= state.buffer.cols) return;
+		const prevCell = getBufferCell(state.buffer, cellX, cellY);
+		putCell(state.buffer, cellX, cellY, ch, style);
+		markPlaneCoverageForPut(state, cellX, cellY, ch, prevCell);
 	}
 	function writeAtForPlane(plane, text, x, y, style) {
 		const state = getPlaneState(plane);
@@ -1219,13 +1246,18 @@ function createTerminal(opts) {
 			},
 			setFingerprintFn(fn) {
 				assertNotDisposed();
-				base.setFingerprintFn(fn);
+				const state = getPlaneState(plane);
+				setFingerprintFn(state.buffer, fn);
 			},
 			getRowFingerprints(y) {
 				assertNotDisposed();
-				return base.getRowFingerprints(y);
+				const yy = Math.floor(y);
+				const state = getPlaneState(plane);
+				if (!Number.isFinite(yy) || yy < 0 || yy >= state.buffer.rows) throw new RangeError("Row out of bounds");
+				return getRowFingerprints(state.buffer, yy);
 			}
 		};
+		api[TERMINAL_ROOT] = base;
 		planeTerminals.set(plane, api);
 		return api;
 	}
@@ -1307,7 +1339,7 @@ function createTerminal(opts) {
 				const rows = collectAndClearDirtyRows(state.buffer);
 				if (rows === null) {
 					composeAllRows = true;
-					break;
+					continue;
 				}
 				for (const y of rows) dirtyRows.add(y);
 			}
@@ -1397,7 +1429,9 @@ function createTerminal(opts) {
 		},
 		getRowFingerprints(y) {
 			assertNotDisposed();
-			return getRowFingerprints(compositeBuffer, y);
+			const yy = Math.floor(y);
+			if (!Number.isFinite(yy) || yy < 0 || yy >= compositeBuffer.rows) throw new RangeError("Row out of bounds");
+			return getRowFingerprints(compositeBuffer, yy);
 		}
 	};
 	base[TERMINAL_PLANE_INTERNALS] = {
@@ -1427,8 +1461,9 @@ function createTerminal(opts) {
 			scrollRowsForPlane(plane, startY, endY, lines);
 		}
 	};
+	base[TERMINAL_ROOT] = base;
 	return base;
 }
 
 //#endregion
-export { TERMINAL_RENDER_PLANES, createTerminal, getPlaneTerminal, resetPlaneRowsForRender, scrollPlaneRows };
+export { TERMINAL_RENDER_PLANES, createTerminal, getPlaneTerminal, getRootTerminal, resetPlaneRowsForRender, scrollPlaneRows };

package/dist/debug-logger-ChY_PXVk.js

@@ -0,0 +1,74 @@
+import { envFlag, envString } from "./env-DNCzvX8b.js";
+
+//#region src/core/debug-logger.ts
+const DEFAULT_LOG_FILE = "vue-tui-debug.log";
+let debugFileWriter = null;
+let debugLogDefaultPath = DEFAULT_LOG_FILE;
+const initializedDebugLogPaths = new Set();
+function getFileWriter() {
+	const writer = globalThis.__VT_DEBUG_FILE_WRITER__;
+	if (writer && typeof writer === "object") return writer;
+	return debugFileWriter;
+}
+function resolveDebugLogPath(env, fallback = DEFAULT_LOG_FILE) {
+	return envString(env, "VUE_TUI_DEBUG_LOG_PATH", "DIMCODE_DEBUG_LOG_PATH", fallback);
+}
+function debugLogPath() {
+	const env = globalThis.process?.env;
+	return resolveDebugLogPath(env, debugLogDefaultPath);
+}
+function safeJson(value) {
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return "[unserializable]";
+	}
+}
+function createDebugLogger(enable = false) {
+	const enabled = enable;
+	const ensureHeader = () => {
+		if (!enabled) return;
+		const writer = getFileWriter();
+		if (!writer?.writeFileSync) return;
+		const path = debugLogPath();
+		if (initializedDebugLogPaths.has(path)) return;
+		try {
+			const data = `=== Vue TUI Debug Log Started at ${new Date().toISOString()} ===\n\n`;
+			writer.writeFileSync(path, data);
+			initializedDebugLogPaths.add(path);
+		} catch {}
+	};
+	const write = (data) => {
+		if (!enabled) return;
+		ensureHeader();
+		try {
+			getFileWriter()?.appendFileSync?.(debugLogPath(), data);
+		} catch {}
+	};
+	const log = (category, message) => {
+		if (!enabled) return;
+		const timestamp = new Date().toISOString().split("T")[1].slice(0, -1);
+		write(`[${timestamp}] ${category} ${message}\n`);
+	};
+	ensureHeader();
+	return {
+		render: (message) => log("[RENDER]", message),
+		stream: (message) => log("[STREAM]", message),
+		error: (message, ...args) => {
+			if (!enabled) return;
+			const timestamp = new Date().toISOString().split("T")[1].slice(0, -1);
+			const fullMessage = `[${timestamp}] [ERROR] ${message}${args.length ? ` ${safeJson(args)}` : ""}`;
+			write(`${fullMessage}\n`);
+		}
+	};
+}
+/**
+* Check if debug logging is enabled via environment variable
+*/
+function isDebugEnabled() {
+	const env = globalThis.process?.env;
+	return envFlag(env, "VUE_TUI_DEBUG", "DIMCODE_DEBUG") || env?.DEBUG === "1";
+}
+
+//#endregion
+export { createDebugLogger, isDebugEnabled };

package/dist/{dom-renderer-BqGijQID.js → dom-renderer-DNzmg2As.js}

@@ -1,5 +1,5 @@
-import { TERMINAL_RENDER_PLANES, getPlaneTerminal } from "./create-terminal-C2oiWFJU.js";
-import { sanitizeDomHref } from "./hyperlink-Bn02UXJb.js";
+import { TERMINAL_RENDER_PLANES, getPlaneTerminal } from "./create-terminal-DXuZ2fci.js";
+import { sanitizeDomHref } from "./hyperlink-B35-O-cW.js";
 import { ansiColorHex, ansiCssVar, installAnsiPaletteCssVars, isAnsiColorName } from "./ansi-palette-CNXqFciC.js";
 
 //#region src/renderer/capabilities.ts