@code-yeongyu/senpi-tui 2026.11.12 → 2026.11.13

package/dist/utils.js

@@ -883,8 +883,10 @@ export function flattenLines(lines) {
     for (const line of lines)
         Number(line);
 }
-export function wrapTextWithAnsi(text, width) {
+/** onLine receives each output line's consumed UTF-16 interval in the ANSI-stripped input. */
+export function wrapTextWithAnsi(text, width, onLine) {
     if (!text) {
+        onLine?.(0, 0);
         return [""];
     }
     // Handle newlines by processing each line separately
@@ -892,24 +894,31 @@ export function wrapTextWithAnsi(text, width) {
     const inputLines = text.split(/\r\n|\r|\n/);
     const result = [];
     const tracker = new AnsiCodeTracker();
-    for (const inputLine of inputLines) {
+    let sourceOffset = 0;
+    const separators = onLine ? (text.match(/\r\n|\r|\n/g) ?? []) : [];
+    for (let index = 0; index < inputLines.length; index++) {
+        const inputLine = inputLines[index];
         // Prepend active ANSI codes from previous lines (except for first line)
         const prefix = result.length > 0 ? tracker.getActiveCodes() : "";
-        const wrappedLines = wrapSingleLine(prefix + inputLine, width);
+        const wrappedLines = wrapSingleLine(prefix + inputLine, width, onLine && ((start, end) => onLine(sourceOffset + start, sourceOffset + end)));
         for (const wrappedLine of wrappedLines) {
             result.push(wrappedLine);
         }
         // Update tracker with codes from this line for next iteration
         updateTrackerFromText(inputLine, tracker);
+        if (onLine)
+            sourceOffset += stripTerminalSequences(inputLine).length + (separators[index]?.length ?? 0);
     }
     return result.length > 0 ? result : [""];
 }
-function wrapSingleLine(line, width) {
+function wrapSingleLine(line, width, onLine) {
     if (!line) {
+        onLine?.(0, 0);
         return [""];
     }
     const visibleLength = visibleWidth(line);
     if (visibleLength <= width) {
+        onLine?.(0, stripTerminalSequences(line).length);
         return [line];
     }
     const wrapped = [];
@@ -917,7 +926,15 @@ function wrapSingleLine(line, width) {
     const tokens = splitIntoTokensWithAnsi(line);
     let currentLine = "";
     let currentVisibleLength = 0;
+    let sourceOffset = 0;
+    let lineStart = 0;
+    const emit = (text) => {
+        onLine?.(lineStart, lineStart + stripTerminalSequences(text.trimEnd()).length);
+    };
     for (const token of tokens) {
+        const tokenStart = sourceOffset;
+        if (onLine)
+            sourceOffset += stripTerminalSequences(token).length;
         const tokenVisibleLength = visibleWidth(token);
         const isWhitespace = token.trim() === "";
         // Token itself is too long - break it character by character
@@ -929,11 +946,18 @@ function wrapSingleLine(line, width) {
                     currentLine += lineEndReset;
                 }
                 wrapped.push(currentLine);
+                emit(currentLine);
                 currentLine = "";
                 currentVisibleLength = 0;
             }
             // Break long token - breakLongWord handles its own resets
-            const broken = breakLongWord(token, width, tracker);
+            const broken = breakLongWord(token, width, tracker, onLine &&
+                ((start, end) => {
+                    onLine(tokenStart + start, tokenStart + end);
+                }));
+            // The final fragment remains in currentLine and is emitted with the next token.
+            if (onLine)
+                lineStart = sourceOffset - stripTerminalSequences(broken[broken.length - 1]).length;
             for (let i = 0; i < broken.length - 1; i++) {
                 wrapped.push(broken[i]);
             }
@@ -951,14 +975,17 @@ function wrapSingleLine(line, width) {
                 lineToWrap += lineEndReset;
             }
             wrapped.push(lineToWrap);
+            emit(lineToWrap);
             if (isWhitespace) {
                 // Don't start new line with whitespace
                 currentLine = tracker.getActiveCodes();
                 currentVisibleLength = 0;
+                lineStart = sourceOffset;
             }
             else {
                 currentLine = tracker.getActiveCodes() + token;
                 currentVisibleLength = tokenVisibleLength;
+                lineStart = tokenStart;
             }
         }
         else {
@@ -971,6 +998,7 @@ function wrapSingleLine(line, width) {
     if (currentLine) {
         // No reset at end of final line - let caller handle it
         wrapped.push(currentLine);
+        emit(currentLine);
     }
     // Trailing whitespace can cause lines to exceed the requested width
     return wrapped.length > 0 ? wrapped.map((line) => line.trimEnd()) : [""];
@@ -982,10 +1010,12 @@ export const PUNCTUATION_REGEX = /[(){}[\]<>.,;:'"!?+\-=*/\\|&%^$#@~`]/;
 export function isWhitespaceChar(char) {
     return /\s/.test(char);
 }
-function breakLongWord(word, width, tracker) {
+function breakLongWord(word, width, tracker, onLine) {
     const lines = [];
     let currentLine = tracker.getActiveCodes();
     let currentWidth = 0;
+    let sourceOffset = 0;
+    let lineStart = 0;
     // First, separate ANSI codes from visible content
     // We need to handle ANSI codes specially since they're not graphemes
     let i = 0;
@@ -1032,11 +1062,14 @@ function breakLongWord(word, width, tracker) {
                 currentLine += lineEndReset;
             }
             lines.push(currentLine);
+            onLine?.(lineStart, sourceOffset);
+            lineStart = sourceOffset;
             currentLine = tracker.getActiveCodes();
             currentWidth = 0;
         }
         currentLine += grapheme;
         currentWidth += graphemeWidth;
+        sourceOffset += grapheme.length;
     }
     if (currentLine) {
         // No reset at end of final segment - caller handles continuation

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-tui",
-	"version": "2026.11.12",
+	"version": "2026.11.13",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
 	"main": "dist/index.js",