linecraft 0.1.0 → 0.2.0

package/lib/native/region.test.js

@@ -0,0 +1,248 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { RegionRenderer } from './region-renderer';
+describe('RegionRenderer', () => {
+    let mockStdout;
+    let writeSyncSpy;
+    beforeEach(() => {
+        writeSyncSpy = vi.fn();
+        const writeSpy = vi.fn();
+        const eventHandlers = new Map();
+        mockStdout = {
+            writeSync: writeSyncSpy,
+            write: writeSpy,
+            isTTY: true,
+            columns: 80,
+            rows: 24,
+            on: (event, handler) => {
+                if (!eventHandlers.has(event)) {
+                    eventHandlers.set(event, new Set());
+                }
+                eventHandlers.get(event).add(handler);
+                return mockStdout;
+            },
+            off: (event, handler) => {
+                eventHandlers.get(event)?.delete(handler);
+                return mockStdout;
+            },
+            removeListener: (event, handler) => {
+                eventHandlers.get(event)?.delete(handler);
+                return mockStdout;
+            },
+        };
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('initialization', () => {
+        it('should create region with correct dimensions', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 5,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            expect(region.getWidth()).toBe(80);
+            expect(region.getHeight()).toBe(5);
+        });
+        it('should use default values', () => {
+            const region = new RegionRenderer({
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            expect(region.getWidth()).toBeGreaterThan(0);
+            expect(region.getHeight()).toBe(1);
+        });
+    });
+    describe('setLine', () => {
+        it('should expand automatically when needed', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 1,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.setLine(1, 'line1');
+            expect(region.getHeight()).toBe(1);
+            region.setLine(5, 'line5');
+            expect(region.getHeight()).toBeGreaterThanOrEqual(5);
+        });
+        it('should reject line 0', () => {
+            const region = new RegionRenderer({
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            expect(() => region.setLine(0, 'invalid')).toThrow('Line numbers start at 1');
+        });
+        it('should handle empty string', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 2,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.setLine(1, 'test');
+            region.setLine(1, '');
+            // Should not throw and should clear the line
+            expect(region.getHeight()).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('set', () => {
+        it('should split content by newlines correctly', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 1,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.set('line1\nline2\nline3');
+            expect(region.getHeight()).toBeGreaterThanOrEqual(3);
+        });
+        it('should handle empty content', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 1,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.set('');
+            expect(region.getHeight()).toBeGreaterThanOrEqual(1);
+        });
+        it('should handle single line (no newline)', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 1,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.set('single line');
+            expect(region.getHeight()).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('clearLine', () => {
+        it('should clear individual lines', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 3,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.setLine(2, 'test');
+            region.clearLine(2);
+            // Should not throw
+            expect(region.getHeight()).toBeGreaterThanOrEqual(2);
+        });
+        it('should reject line 0', () => {
+            const region = new RegionRenderer({
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            expect(() => region.clearLine(0)).toThrow('Line numbers start at 1');
+        });
+    });
+    describe('clear', () => {
+        it('should clear all lines', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 3,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.setLine(1, 'line1');
+            region.setLine(2, 'line2');
+            region.setLine(3, 'line3');
+            region.clear();
+            // Should not throw
+            expect(region.getHeight()).toBeGreaterThanOrEqual(3);
+        });
+    });
+    describe('setThrottleFps', () => {
+        it('should set FPS correctly', () => {
+            const region = new RegionRenderer({
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            // setThrottleFps doesn't exist on native region - throttle is managed internally
+            // The high-level TerminalRegion has setThrottle() which is a no-op for now
+            // Just verify the region exists
+            expect(region).toBeDefined();
+        });
+    });
+    describe('multiple setLine calls', () => {
+        it('should handle multiple updates', () => {
+            const region = new RegionRenderer({
+                width: 80,
+                height: 1,
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.setLine(1, 'line1');
+            region.setLine(2, 'line2');
+            region.setLine(3, 'line3');
+            expect(region.getHeight()).toBeGreaterThanOrEqual(3);
+        });
+    });
+    describe('destroy', () => {
+        it('should clean up resources', () => {
+            const region = new RegionRenderer({
+                stdout: mockStdout,
+                disableRendering: true,
+            });
+            region.setLine(1, 'test');
+            region.destroy();
+            // Should not throw
+            expect(region).toBeDefined();
+        });
+        it('should automatically call destroy on process exit', () => {
+            // Track process.once calls to capture exit handlers
+            const exitHandlers = [];
+            const sigintHandlers = [];
+            const sigtermHandlers = [];
+            const originalOnce = process.once.bind(process);
+            const onceSpy = vi.spyOn(process, 'once').mockImplementation((event, handler) => {
+                const eventStr = String(event);
+                if (eventStr === 'exit') {
+                    exitHandlers.push(handler);
+                }
+                else if (eventStr === 'SIGINT') {
+                    sigintHandlers.push(handler);
+                }
+                else if (eventStr === 'SIGTERM') {
+                    sigtermHandlers.push(handler);
+                }
+                // Call original to actually register the handler
+                return originalOnce(event, handler);
+            });
+            // Create a region (this will set up exit handlers)
+            const region = new RegionRenderer({
+                stdout: mockStdout,
+                disableRendering: false, // Need rendering enabled to set up exit handlers
+            });
+            // Spy on destroy method
+            const destroySpy = vi.spyOn(region, 'destroy');
+            // Verify exit handlers were registered
+            expect(exitHandlers.length).toBeGreaterThan(0);
+            expect(sigintHandlers.length).toBeGreaterThan(0);
+            expect(sigtermHandlers.length).toBeGreaterThan(0);
+            // Manually trigger exit handler (simulating process exit)
+            exitHandlers.forEach(handler => handler());
+            // Verify destroy was called
+            expect(destroySpy).toHaveBeenCalled();
+            // Clean up
+            onceSpy.mockRestore();
+            destroySpy.mockRestore();
+        });
+        it('should not set up exit handlers when disableRendering is true', () => {
+            const onceSpy = vi.spyOn(process, 'once');
+            const region = new RegionRenderer({
+                stdout: mockStdout,
+                disableRendering: true, // Exit handlers should NOT be set up
+            });
+            // Verify exit handlers were NOT registered
+            // (once should not have been called with 'exit', 'SIGINT', or 'SIGTERM')
+            const exitCalls = onceSpy.mock.calls.filter(call => call[0] === 'exit' || call[0] === 'SIGINT' || call[0] === 'SIGTERM');
+            expect(exitCalls.length).toBe(0);
+            onceSpy.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=region.test.js.map

package/lib/native/region.test.js.map

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

package/lib/native/throttle.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Throttle class for limiting render frequency.
+ * Uses high-resolution time (hrtime) for accurate throttling.
+ */
+export declare class Throttle {
+    private lastFrameTime;
+    private minFrameInterval;
+    private fps;
+    constructor(fps?: number);
+    /**
+     * Update the target FPS
+     */
+    setFps(fps: number): void;
+    /**
+     * Check if we should render now based on throttle settings.
+     * Returns true if enough time has passed since last render.
+     */
+    shouldRender(): boolean;
+    /**
+     * Get time remaining until next frame can be rendered (in milliseconds).
+     * Useful for scheduling the next render.
+     */
+    timeUntilNextFrame(): number;
+    /**
+     * Reset the throttle (useful for testing or after long pauses)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=throttle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/native/throttle.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,GAAE,MAAW;IAM5B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB;;;OAGG;IACH,YAAY,IAAI,OAAO;IAYvB;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAa5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/lib/native/throttle.js

@@ -0,0 +1,57 @@
+// Throttling for frame rate limiting - TypeScript implementation
+// Optimized for Node.js high-resolution timing
+/**
+ * Throttle class for limiting render frequency.
+ * Uses high-resolution time (hrtime) for accurate throttling.
+ */
+export class Throttle {
+    lastFrameTime = 0n;
+    minFrameInterval; // nanoseconds
+    fps;
+    constructor(fps = 60) {
+        this.fps = fps;
+        // Calculate interval in nanoseconds: 1 second / fps
+        this.minFrameInterval = BigInt(Math.floor(1_000_000_000 / fps));
+    }
+    /**
+     * Update the target FPS
+     */
+    setFps(fps) {
+        this.fps = fps;
+        this.minFrameInterval = BigInt(Math.floor(1_000_000_000 / fps));
+    }
+    /**
+     * Check if we should render now based on throttle settings.
+     * Returns true if enough time has passed since last render.
+     */
+    shouldRender() {
+        const now = process.hrtime.bigint();
+        const elapsed = now - this.lastFrameTime;
+        if (elapsed >= this.minFrameInterval) {
+            this.lastFrameTime = now;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get time remaining until next frame can be rendered (in milliseconds).
+     * Useful for scheduling the next render.
+     */
+    timeUntilNextFrame() {
+        const now = process.hrtime.bigint();
+        const elapsed = now - this.lastFrameTime;
+        const remaining = this.minFrameInterval - elapsed;
+        if (remaining <= 0) {
+            return 0;
+        }
+        // Convert nanoseconds to milliseconds
+        return Number(remaining) / 1_000_000;
+    }
+    /**
+     * Reset the throttle (useful for testing or after long pauses)
+     */
+    reset() {
+        this.lastFrameTime = 0n;
+    }
+}
+//# sourceMappingURL=throttle.js.map

package/lib/native/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/native/throttle.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,+CAA+C;AAE/C;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACX,aAAa,GAAW,EAAE,CAAC;IAC3B,gBAAgB,CAAS,CAAC,cAAc;IACxC,GAAG,CAAS;IAEpB,YAAY,MAAc,EAAE;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,oDAAoD;QACpD,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;QAEzC,IAAI,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAElD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,sCAAsC;QACtC,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/lib/native/throttle.test.d.ts

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

package/lib/native/throttle.test.d.ts.map

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

package/lib/native/throttle.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect } from 'vitest';
+import { Throttle } from './throttle';
+describe('Throttle', () => {
+    describe('initialization', () => {
+        it('should initialize with correct FPS', () => {
+            const throttle = new Throttle(60);
+            expect(throttle['fps']).toBe(60);
+            expect(throttle['minFrameInterval']).toBeGreaterThan(0n);
+        });
+        it('should calculate correct interval for 60 FPS', () => {
+            const throttle = new Throttle(60);
+            // 1 second / 60 = ~16.67ms = ~16,666,667 nanoseconds
+            const expectedInterval = BigInt(Math.floor(1_000_000_000 / 60));
+            expect(throttle['minFrameInterval']).toBe(expectedInterval);
+        });
+    });
+    describe('setFps', () => {
+        it('should change FPS correctly', () => {
+            const throttle = new Throttle(30);
+            throttle.setFps(120);
+            expect(throttle['fps']).toBe(120);
+            const expectedInterval = BigInt(Math.floor(1_000_000_000 / 120));
+            expect(throttle['minFrameInterval']).toBe(expectedInterval);
+        });
+    });
+    describe('shouldRender', () => {
+        it('should allow first frame', () => {
+            const throttle = new Throttle(60);
+            const should = throttle.shouldRender();
+            expect(should).toBe(true);
+        });
+        it('should respect interval and block immediate second frame', () => {
+            const throttle = new Throttle(1000); // 1 FPS = 1 second interval
+            throttle.shouldRender(); // First frame
+            // Immediately after, should not render (hrtime has nanosecond precision)
+            const should = throttle.shouldRender();
+            expect(should).toBe(false);
+        });
+        it('should allow render after interval passes', async () => {
+            const throttle = new Throttle(10); // 10 FPS = 100ms interval
+            throttle.shouldRender(); // First frame
+            // Wait for interval to pass
+            await new Promise(resolve => setTimeout(resolve, 110));
+            const should = throttle.shouldRender();
+            expect(should).toBe(true);
+        });
+    });
+    describe('timeUntilNextFrame', () => {
+        it('should calculate remaining time correctly', () => {
+            const throttle = new Throttle(10); // 10 FPS = 100ms interval
+            throttle.shouldRender();
+            const remaining = throttle.timeUntilNextFrame();
+            expect(remaining).toBeGreaterThan(0);
+            expect(remaining).toBeLessThanOrEqual(100); // Should be <= 100ms
+        });
+        it('should return 0 if interval has passed', async () => {
+            const throttle = new Throttle(10);
+            throttle.shouldRender();
+            await new Promise(resolve => setTimeout(resolve, 110));
+            const remaining = throttle.timeUntilNextFrame();
+            expect(remaining).toBe(0);
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle very high FPS', () => {
+            const throttle = new Throttle(1000); // 1000 FPS
+            expect(throttle['fps']).toBe(1000);
+            expect(throttle['minFrameInterval']).toBeGreaterThan(0n);
+        });
+        it('should handle very low FPS', () => {
+            const throttle = new Throttle(1); // 1 FPS
+            expect(throttle['fps']).toBe(1);
+            const expectedInterval = BigInt(1_000_000_000); // 1 second
+            expect(throttle['minFrameInterval']).toBe(expectedInterval);
+        });
+    });
+    describe('reset', () => {
+        it('should reset the throttle', () => {
+            const throttle = new Throttle(60);
+            throttle.shouldRender();
+            throttle.reset();
+            expect(throttle['lastFrameTime']).toBe(0n);
+        });
+    });
+});
+//# sourceMappingURL=throttle.test.js.map

package/lib/native/throttle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.test.js","sourceRoot":"","sources":["../../src/native/throttle.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,qDAAqD;YACrD,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC;YAChE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAElC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC;YACjE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,4BAA4B;YACjE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,cAAc;YAEvC,yEAAyE;YACzE,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;YAC7D,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,cAAc;YAEvC,4BAA4B;YAC5B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAEvD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;YAC7D,QAAQ,CAAC,YAAY,EAAE,CAAC;YAExB,MAAM,SAAS,GAAG,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YAChD,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAExB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YAChD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW;YAChD,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;YAC1C,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW;YAC3D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAExB,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/native.d.ts

@@ -1,12 +1,6 @@
-export interface NativeRegion {
-    createRegion(x: number, y: number, width: number, height: number): number;
-    destroyRegion(handle: number): void;
-    setLine(handle: number, lineNumber: number, content: string): void;
-    set(handle: number, content: string): void;
-    clearLine(handle: number, lineNumber: number): void;
-    clearRegion(handle: number): void;
-    flush(handle: number): void;
-    setThrottleFps(handle: number, fps: number): void;
-}
-export declare const native: NativeRegion;
+export { RegionRenderer as NativeRegion } from './native/region-renderer';
+export * from './native/diff';
+export * from './native/ansi';
+export * from './native/buffer';
+export * from './native/throttle';
 //# sourceMappingURL=native.d.ts.map

package/lib/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/ts/native.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1E,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACnE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD;AAED,eAAO,MAAM,MAAM,EAAE,YAwCpB,CAAC"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC1E,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/lib/native.js

@@ -1,65 +1,9 @@
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import { Library } from 'ffi-napi';
-import ref from 'ref-napi';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// Determine the library path based on platform
-function getLibraryPath() {
-    const platform = process.platform;
-    if (platform === 'darwin') {
-        return join(__dirname, '../../zig-out/lib/libechokit.dylib');
-    }
-    else if (platform === 'win32') {
-        return join(__dirname, '../../zig-out/lib/echokit.dll');
-    }
-    else {
-        return join(__dirname, '../../zig-out/lib/libechokit.so');
-    }
-}
-// Load the Zig library using FFI
-const lib = Library(getLibraryPath(), {
-    create_region: ['uint64', ['uint32', 'uint32', 'uint32', 'uint32']],
-    destroy_region: ['void', ['uint64']],
-    set_line: ['void', ['uint64', 'uint32', 'pointer', 'size_t']],
-    set: ['void', ['uint64', 'pointer', 'size_t']],
-    clear_line: ['void', ['uint64', 'uint32']],
-    clear_region: ['void', ['uint64']],
-    flush: ['void', ['uint64']],
-    set_throttle_fps: ['void', ['uint64', 'uint32']],
-});
-export const native = {
-    createRegion: (x, y, width, height) => {
-        return Number(lib.create_region(x, y, width, height));
-    },
-    destroyRegion: (handle) => {
-        lib.destroy_region(BigInt(handle));
-    },
-    setLine: (handle, lineNumber, content) => {
-        const buf = Buffer.from(content, 'utf8');
-        // Allocate a buffer and copy the string data
-        const ptr = ref.alloc(buf.length);
-        buf.copy(ptr);
-        lib.set_line(BigInt(handle), lineNumber, ptr, buf.length);
-    },
-    set: (handle, content) => {
-        const buf = Buffer.from(content, 'utf8');
-        // Allocate a buffer and copy the string data
-        const ptr = ref.alloc(buf.length);
-        buf.copy(ptr);
-        lib.set(BigInt(handle), ptr, buf.length);
-    },
-    clearLine: (handle, lineNumber) => {
-        lib.clear_line(BigInt(handle), lineNumber);
-    },
-    clearRegion: (handle) => {
-        lib.clear_region(BigInt(handle));
-    },
-    flush: (handle) => {
-        lib.flush(BigInt(handle));
-    },
-    setThrottleFps: (handle, fps) => {
-        lib.set_throttle_fps(BigInt(handle), fps);
-    },
-};
+// Pure TypeScript implementation - no FFI dependencies
+// This file is kept for backward compatibility but now just re-exports
+// the native TypeScript implementation
+export { RegionRenderer as NativeRegion } from './native/region-renderer';
+export * from './native/diff';
+export * from './native/ansi';
+export * from './native/buffer';
+export * from './native/throttle';
 //# sourceMappingURL=native.js.map

package/lib/native.js.map

@@ -1 +1 @@
-{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/ts/native.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,uEAAuE;AACvE,uCAAuC;AAEvC,OAAO,EAAE,cAAc,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC1E,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/lib/region.d.ts

@@ -1,17 +1,60 @@
-import type { RegionOptions, LineContent } from './types.js';
+import type { RegionOptions, LineContent } from './types';
+/**
+ * TerminalRegion - High-level API for terminal region management
+ *
+ * This is the public API that wraps the low-level RegionRenderer.
+ * It adds component orchestration, grid layout, and styling support.
+ */
 export declare class TerminalRegion {
-    private handle;
+    private renderer;
     private _width;
     private _height;
+    private allComponentDescriptors;
+    private regionLines;
+    private isReRendering;
     constructor(options?: RegionOptions);
     get width(): number;
     get height(): number;
+    getLine(lineNumber: number): string;
+    /**
+     * Set a single line (1-based line numbers)
+     *
+     * Note: With auto-wrap disabled globally, we manage all wrapping ourselves.
+     * This method sets a single line - if content needs to wrap, it should
+     * be handled by the component layer (grid, style, etc.) before calling this.
+     * Content that exceeds the region width will be truncated by the terminal.
+     *
+     * The region will automatically expand if lineNumber exceeds current height.
+     */
     setLine(lineNumber: number, content: string | LineContent): void;
-    set(content: string | LineContent[]): void;
+    /**
+     * Set content in the region, replacing all existing content.
+     * This always does a full replace - if the new content is the same length,
+     * it will overwrite the existing lines. If it's a different length, it will
+     * resize the region accordingly.
+     */
+    set(content: string | LineContent[] | any, ...additionalLines: any[]): void;
+    /**
+     * Add content to the region, appending it after existing content.
+     * This is useful for adding multiple sections without overwriting previous content.
+     */
+    add(content: string | LineContent[] | any, ...additionalLines: any[]): void;
     clearLine(lineNumber: number): void;
     clear(): void;
-    flush(): void;
+    flush(): Promise<void>;
+    /**
+     * Re-render the last content that was set
+     * This re-renders all components (grid) with the current width
+     * Used by resize handler and keep-alive to prevent auto-reflow
+     * The region orchestrates this - components don't manage their own re-rendering
+     *
+     * CRITICAL: Re-renders the entire region, including:
+     * - Component lines (grid)
+     * - Static lines (waitForSpacebar, whitespace)
+     * This ensures everything is in the correct position
+     */
+    reRenderLastContent(): void;
     setThrottle(fps: number): void;
-    destroy(): void;
+    destroy(clearFirst?: boolean): Promise<void>;
 }
 //# sourceMappingURL=region.d.ts.map

package/lib/region.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../src/ts/region.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAa,MAAM,YAAY,CAAC;AAExE,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,aAAkB;IAQvC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAuBhE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI;IAgB1C,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOnC,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;IAKb,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../src/region.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI1D;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IAGxB,OAAO,CAAC,uBAAuB,CAAa;IAG5C,OAAO,CAAC,WAAW,CAAkF;IAErG,OAAO,CAAC,aAAa,CAAkB;gBAE3B,OAAO,GAAE,aAAkB;IAwBvC,IAAI,KAAK,IAAI,MAAM,CAIlB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAInC;;;;;;;;;OASG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAgChE;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,EAAE,GAAG,IAAI;IAqJ3E;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,EAAE,GAAG,IAAI;IAuL3E,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOnC,KAAK,IAAI,IAAI;IAIP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;;;;;;OAUG;IACH,mBAAmB,IAAI,IAAI;IAiI3B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxB,OAAO,CAAC,UAAU,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1D"}