linecraft 0.2.1 → 0.2.2

package/lib/native/ansi.js

@@ -104,6 +104,15 @@ export const DISABLE_AUTO_WRAP = '\x1b[?7l';
  * This is the default terminal state. Use this to restore after DISABLE_AUTO_WRAP.
  */
 export const ENABLE_AUTO_WRAP = '\x1b[?7h';
+/**
+ * Switch to the terminal's alternate screen buffer.
+ * Commonly used by fullscreen TUIs so the main screen is restored on exit.
+ */
+export const ENTER_ALTERNATE_SCREEN = '\x1b[?1049h';
+/**
+ * Return to the main screen buffer from the alternate buffer.
+ */
+export const EXIT_ALTERNATE_SCREEN = '\x1b[?1049l';
 /**
  * Query cursor position (DSR - Device Status Report)
  * Format: \x1b[6n

package/lib/native/ansi.js.map

@@ -1 +1 @@
-{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/native/ansi.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,0CAA0C;AAE1C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,kDAAkD;IAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AACvC,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC"}
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/native/ansi.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,0CAA0C;AAE1C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,kDAAkD;IAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AACvC,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC"}

package/lib/native/diff.d.ts

@@ -14,7 +14,11 @@ export type DiffOp = {
 };
 /**
  * Diff two frames to generate minimal update operations.
- * This minimizes the number of writes to stdout by only updating changed lines.
+ *
+ * Strategy:
+ * - If only a small continuous region of a line changes, use partial update
+ * - If multiple regions change or changes are scattered, redraw the whole line
+ * - When lines are deleted, all lines below need to be redrawn (reflow)
  */
 export declare function diffFrames(prev: string[], curr: string[]): DiffOp[];
 //# sourceMappingURL=diff.d.ts.map

package/lib/native/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/native/diff.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAyBnE"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/native/diff.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAG3D;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsCnE"}

package/lib/native/diff.js

@@ -2,29 +2,47 @@
 // Optimized for Node.js performance
 /**
  * Diff two frames to generate minimal update operations.
- * This minimizes the number of writes to stdout by only updating changed lines.
+ *
+ * Strategy:
+ * - If only a small continuous region of a line changes, use partial update
+ * - If multiple regions change or changes are scattered, redraw the whole line
+ * - When lines are deleted, all lines below need to be redrawn (reflow)
  */
 export function diffFrames(prev, curr) {
     const ops = [];
     const maxLen = Math.max(prev.length, curr.length);
+    let needsReflow = false; // Track if we need to redraw lines below
     for (let i = 0; i < maxLen; i++) {
         const prevLine = i < prev.length ? prev[i] : null;
         const currLine = i < curr.length ? curr[i] : null;
         if (prevLine === null && currLine !== null) {
-            // Line inserted
+            // Line inserted - causes reflow
+            needsReflow = true;
             ops.push({ type: 'insert_line', line: i, content: currLine });
         }
         else if (prevLine !== null && currLine === null) {
-            // Line deleted
+            // Line deleted - causes reflow of everything below
+            needsReflow = true;
             ops.push({ type: 'delete_line', line: i });
         }
         else if (prevLine !== null && currLine !== null) {
-            // Check if line changed (use strict equality for fast comparison)
-            if (prevLine !== currLine) {
-                ops.push({ type: 'update_line', line: i, content: currLine });
+            if (prevLine === currLine) {
+                // No change, but if we had reflow above, we need to redraw
+                if (needsReflow) {
+                    ops.push({ type: 'update_line', line: i, content: currLine });
+                }
+                else {
+                    ops.push({ type: 'no_change' });
+                }
             }
             else {
-                ops.push({ type: 'no_change' });
+                // Line changed
+                // For now, we always redraw the whole line for simplicity
+                // Partial updates with ANSI codes are complex and error-prone
+                // The optimization would be: if change is small and continuous, update just that region
+                // But preserving ANSI codes at boundaries is tricky, so we redraw for correctness
+                needsReflow = true; // Any line change causes reflow below
+                ops.push({ type: 'update_line', line: i, content: currLine });
             }
         }
     }

package/lib/native/diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/native/diff.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,oCAAoC;AAQpC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,IAAc;IACvD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAElD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAElD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3C,gBAAgB;YAChB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAClD,eAAe;YACf,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAClD,kEAAkE;YAClE,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/native/diff.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,oCAAoC;AASpC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,IAAc;IACvD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,WAAW,GAAG,KAAK,CAAC,CAAC,yCAAyC;IAElE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAElD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3C,gCAAgC;YAChC,WAAW,GAAG,IAAI,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAClD,mDAAmD;YACnD,WAAW,GAAG,IAAI,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAClD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,2DAA2D;gBAC3D,IAAI,WAAW,EAAE,CAAC;oBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAChE,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,eAAe;gBACf,0DAA0D;gBAC1D,8DAA8D;gBAC9D,wFAAwF;gBACxF,kFAAkF;gBAClF,WAAW,GAAG,IAAI,CAAC,CAAC,sCAAsC;gBAC1D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/native/region-renderer-debug.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=region-renderer-debug.test.d.ts.map

package/lib/native/region-renderer-debug.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-renderer-debug.test.d.ts","sourceRoot":"","sources":["../../src/native/region-renderer-debug.test.ts"],"names":[],"mappings":""}

package/lib/native/region-renderer-debug.test.js

@@ -0,0 +1,45 @@
+// Debug test to understand viewport frame calculation during resize
+import { describe, it, expect } from 'vitest';
+import { RegionRenderer } from './region-renderer';
+describe('Viewport frame calculation during resize', () => {
+    it('should show correct lines when content height changes', () => {
+        const mockStdout = {
+            isTTY: true,
+            columns: 80,
+            rows: 24,
+            write: () => true,
+            on: () => { },
+            off: () => { },
+            removeListener: () => { },
+        };
+        const renderer = new RegionRenderer({
+            stdout: mockStdout,
+            disableRendering: true,
+        });
+        // Set initial content (10 lines)
+        const initialContent = Array.from({ length: 10 }, (_, i) => `Line ${i + 1}`);
+        renderer.pendingFrame = [...initialContent];
+        renderer.height = 10;
+        renderer.previousFrame = [...initialContent];
+        // Simulate viewport showing bottom 5 lines (lines 6-10)
+        renderer.viewportHeight = 5;
+        const frame1 = renderer.buildViewportFrame();
+        expect(frame1.length).toBe(5);
+        expect(frame1[0]).toBe('Line 6');
+        expect(frame1[4]).toBe('Line 10');
+        // Now content wraps to 15 lines (more lines)
+        const newContent = Array.from({ length: 15 }, (_, i) => `Line ${i + 1} (wrapped)`);
+        renderer.pendingFrame = [...newContent];
+        renderer.height = 15;
+        // Viewport frame should show bottom 5 lines (lines 11-15)
+        const frame2 = renderer.buildViewportFrame();
+        expect(frame2.length).toBe(5);
+        expect(frame2[0]).toBe('Line 11 (wrapped)');
+        expect(frame2[4]).toBe('Line 15 (wrapped)');
+        // The issue: previousViewportFrame has old content at old positions
+        // But new frame has new content at new positions
+        // Diff will compare frame1[0] ('Line 6') with frame2[0] ('Line 11 (wrapped)')
+        // This looks like a transposition, but it's actually just the viewport shifting
+    });
+});
+//# sourceMappingURL=region-renderer-debug.test.js.map

package/lib/native/region-renderer-debug.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-renderer-debug.test.js","sourceRoot":"","sources":["../../src/native/region-renderer-debug.test.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,UAAU,GAAG;YACjB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;YACjB,EAAE,EAAE,GAAG,EAAE,GAAE,CAAC;YACZ,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;YACb,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;SAClB,CAAC;QAET,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;YAClC,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;QAEH,iCAAiC;QACjC,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7E,QAAQ,CAAC,YAAY,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;QAC5C,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC;QACpB,QAAgB,CAAC,aAAa,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;QAEtD,wDAAwD;QACvD,QAAgB,CAAC,cAAc,GAAG,CAAC,CAAC;QACrC,MAAM,MAAM,GAAI,QAAgB,CAAC,kBAAkB,EAAE,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAElC,6CAA6C;QAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACnF,QAAQ,CAAC,YAAY,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;QACxC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC;QAErB,0DAA0D;QAC1D,MAAM,MAAM,GAAI,QAAgB,CAAC,kBAAkB,EAAE,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAE5C,oEAAoE;QACpE,iDAAiD;QACjD,8EAA8E;QAC9E,gFAAgF;IAClF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/native/region-renderer.d.ts

@@ -1,167 +1,76 @@
 export interface RegionRendererOptions {
-    width?: number;
-    height?: number;
     stdout?: NodeJS.WriteStream;
     disableRendering?: boolean;
     onKeepAlive?: () => void;
+    debugLog?: string;
 }
-/**
- * TerminalRegion manages a rectangular region of the terminal.
- *
- * The region reserves new lines at the bottom of the terminal and only
- * updates within those reserved lines. This prevents overwriting existing
- * terminal content.
- *
- * Performance optimizations:
- * - Frame diffing to minimize writes
- * - Throttling to limit render frequency
- * - Batched writes to stdout
- * - Efficient string operations
- * - Relative cursor movements (no absolute positioning)
- */
 export declare class RegionRenderer {
-    private width;
-    private height;
-    private pendingFrame;
-    private previousFrame;
-    private renderScheduled;
-    private throttle;
-    private renderBuffer;
-    private stdout;
-    private disableRendering;
+    width: number;
+    height: number;
+    pendingFrame: string[];
+    previousFrame: string[];
+    disableRendering: boolean;
+    lastRenderedHeight: number;
+    private readonly stdout;
+    private readonly throttle;
+    private readonly renderBuffer;
     private readonly permanentlyDisabled;
-    private isInitialized;
-    private initializationPromise;
-    private resizeCleanup?;
-    private widthExplicitlySet;
-    private savedCursorPosition;
+    private readonly onKeepAlive?;
+    private viewportWidth;
+    private viewportHeight;
+    private previousViewportFrame;
+    private effectiveWidth;
     private autoWrapDisabled;
-    private startRow;
-    private visibleRegionTopRow;
-    private lastRenderedHeight;
-    private hasRendered;
+    private inAlternateScreen;
     private isRendering;
-    private resizeJustHappened;
-    private queriedCursorPosition;
-    private static logFileCleared;
-    private onKeepAlive?;
+    private renderTimer;
+    private resizeCleanup?;
+    private destroyed;
+    private debugLogPath?;
+    private debugLogCleared;
+    private cursorVisible;
     private static exitHandlerSetup;
     private static activeRegions;
     constructor(options?: RegionRendererOptions);
-    /**
-     * Set up process exit handler to automatically clean up all regions
-     * Uses singleton pattern to prevent memory leak from multiple listeners
-     */
-    private static setupExitHandler;
-    /**
-     * Set up resize event handler to react to terminal size changes
-     */
-    private setupResizeHandler;
-    /**
-     * Initialize the region by reserving new lines at the bottom of the terminal.
-     * This appends new lines so the region doesn't overwrite existing content.
-     *
-     * Also disables terminal auto-wrap so we can manage all wrapping ourselves.
-     */
-    private initializeRegion;
-    /**
-     * Query cursor position after resize and store it for use in rendering
-     * This helps us position correctly when the saved cursor position is invalid
-     */
-    private queryCursorPositionAfterResize;
-    /**
-     * Poll cursor position multiple times after resize to understand if it's moving
-     * This helps debug cursor position inconsistencies on resize
-     */
-    private pollCursorPositionAfterResize;
-    private logToFile;
-    /**
-     * Strip ANSI escape codes from a string
-     */
-    private stripAnsi;
-    /**
-     * Get terminal height, with fallback
-     */
-    private getTerminalHeight;
-    /**
-     * Truncate content to maxWidth while preserving ANSI codes
-     * Only truncates if content is significantly longer (more than 2 chars) as a safety measure
-     */
-    private truncateContent;
-    /**
-     * Clear the current line and move to start
-     */
-    private clearCurrentLine;
-    /**
-     * Move to top-left of region and save cursor position
-     */
-    private moveToTopLeftAndSave;
-    /**
-     * Check if content has changed between previous and pending frames
-     */
-    private hasContentChanged;
-    /**
-     * Expand region to accommodate more lines
-     */
-    private expandTo;
-    /**
-     * Get a single line (1-based line numbers)
-     * Returns empty string if line doesn't exist
-     */
-    getLine(lineNumber: number): string;
-    /**
-     * Set a single line (1-based line numbers)
-     *
-     * Note: With auto-wrap disabled, we manage all wrapping ourselves.
-     * This method sets a single line - if content needs to wrap, it should
-     * be handled by the component layer (col, flex, etc.) before calling this.
-     */
+    getWidth(): number;
+    getHeight(): number;
+    getStartRow(): Promise<number | null>;
+    setThrottleFps(fps: number): void;
     setLine(lineNumber: number, content: string): void;
-    /**
-     * Set entire content (multiple lines with \n separators)
-     */
+    updateLines(updates: Array<{
+        lineNumber: number;
+        content: string;
+    }>): void;
     set(content: string): void;
-    /**
-     * Schedule a render (respects throttle)
-     */
-    private scheduleRender;
-    /**
-     * Copy pending frame to previous frame
-     */
-    private copyPendingToPrevious;
-    /**
-     * Render immediately (bypasses throttle)
-     * Uses relative cursor movements to update only within reserved lines
-     */
-    private renderNow;
-    /**
-     * Force immediate render of pending updates (bypasses throttle)
-     * Returns a promise that resolves when rendering is complete
-     */
-    flush(): Promise<void>;
-    /**
-     * Set throttle FPS
-     */
-    setThrottleFps(fps: number): void;
-    /**
-     * Clear a single line (1-based)
-     */
+    getLine(lineNumber: number): string;
     clearLine(lineNumber: number): void;
-    /**
-     * Clear entire region
-     */
     clear(): void;
-    /**
-     * Destroy the region (cleanup)
-     * Automatically deletes any blank lines from the terminal, but preserves content
-     *
-     * @param clearFirst - If true, clears the region before destroying (default: false)
-     *
-     * Note: This is automatically called on process exit, but you can also call it explicitly
-     * to clean up resources earlier (e.g., before continuing with other terminal output)
-     */
+    flush(): Promise<void>;
+    expandTo(newHeight: number): void;
+    setHeight(height: number): void;
+    shrinkFrame(startIndex: number, count: number): void;
     destroy(clearFirst?: boolean): Promise<void>;
-    getWidth(): number;
-    getHeight(): number;
+    logToFile(message: string): void;
+    private static registerRegion;
+    private static setupExitHandler;
+    ensureFrameSize(size: number): void;
+    private scheduleRender;
+    private renderNow;
+    private copyPendingToPrevious;
+    private buildViewportFrame;
+    private mapLineToViewportRow;
+    hideCursor(): void;
+    showCursorAt(lineNumber: number, column: number): void;
+    private getEffectiveFrame;
+    private applyDiff;
+    private truncateContent;
+    private initializeTerminalState;
+    private ensureTerminalState;
+    private leaveAlternateScreen;
+    private setupResizeHandler;
+    private updateViewportMetrics;
+    private readViewportWidth;
+    private readViewportHeight;
+    private resolveDebugLogPath;
 }
 //# sourceMappingURL=region-renderer.d.ts.map

package/lib/native/region-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"region-renderer.d.ts","sourceRoot":"","sources":["../../src/native/region-renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"region-renderer.d.ts","sourceRoot":"","sources":["../../src/native/region-renderer.ts"],"names":[],"mappings":"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"}