linecraft 0.1.0

package/lib/native.js

@@ -0,0 +1,65 @@
+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);
+    },
+};
+//# sourceMappingURL=native.js.map

package/lib/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/ts/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+CAA+C;AAC/C,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,EAAE,oCAAoC,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,iCAAiC;AACjC,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,EAAE,EAAE;IACpC,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnE,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7D,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1C,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC3B,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACjD,CAAC,CAAC;AAaH,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,YAAY,EAAE,CAAC,CAAS,EAAE,CAAS,EAAE,KAAa,EAAE,MAAc,EAAU,EAAE;QAC5E,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,aAAa,EAAE,CAAC,MAAc,EAAQ,EAAE;QACtC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,CAAC,MAAc,EAAE,UAAkB,EAAE,OAAe,EAAQ,EAAE;QACrE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzC,6CAA6C;QAC7C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,GAAG,EAAE,CAAC,MAAc,EAAE,OAAe,EAAQ,EAAE;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzC,6CAA6C;QAC7C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,SAAS,EAAE,CAAC,MAAc,EAAE,UAAkB,EAAQ,EAAE;QACtD,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,WAAW,EAAE,CAAC,MAAc,EAAQ,EAAE;QACpC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,EAAE,CAAC,MAAc,EAAQ,EAAE;QAC9B,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,cAAc,EAAE,CAAC,MAAc,EAAE,GAAW,EAAQ,EAAE;QACpD,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC"}

package/lib/region.d.ts

@@ -0,0 +1,17 @@
+import type { RegionOptions, LineContent } from './types.js';
+export declare class TerminalRegion {
+    private handle;
+    private _width;
+    private _height;
+    constructor(options?: RegionOptions);
+    get width(): number;
+    get height(): number;
+    setLine(lineNumber: number, content: string | LineContent): void;
+    set(content: string | LineContent[]): void;
+    clearLine(lineNumber: number): void;
+    clear(): void;
+    flush(): void;
+    setThrottle(fps: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=region.d.ts.map

package/lib/region.d.ts.map

@@ -0,0 +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"}

package/lib/region.js

@@ -0,0 +1,74 @@
+import { native } from './native.js';
+import { applyStyle } from './utils/colors.js';
+export class TerminalRegion {
+    handle;
+    _width;
+    _height; // Current height (may expand)
+    constructor(options = {}) {
+        const x = options.x ?? 0;
+        const y = options.y ?? 0;
+        this._width = options.width ?? (process.stdout.columns ?? 80);
+        this._height = options.height ?? 1; // Default to 1 line, expands as needed
+        this.handle = native.createRegion(x, y, this._width, this._height);
+    }
+    get width() {
+        return this._width;
+    }
+    get height() {
+        return this._height;
+    }
+    setLine(lineNumber, content) {
+        if (lineNumber < 1) {
+            throw new Error('Line numbers start at 1');
+        }
+        // Zig handles batching and expansion automatically
+        const text = typeof content === 'string' ? content : content.text;
+        // Apply styling if provided
+        const styled = applyStyle(text, typeof content === 'object' ? content.style : undefined);
+        native.setLine(this.handle, lineNumber, styled);
+        // Zig will:
+        //   - Convert to 0-based internally
+        //   - Expand region if lineNumber > current height
+        //   - Buffer this update in pending_frame
+        //   - Check throttle
+        //   - Schedule render if needed (or render immediately if throttle allows)
+        // Update our height tracking if Zig expanded
+        if (lineNumber > this._height) {
+            this._height = lineNumber;
+        }
+    }
+    set(content) {
+        if (typeof content === 'string') {
+            // Single string with \n line breaks
+            native.set(this.handle, content);
+            // Update height based on line count
+            this._height = content.split('\n').length;
+        }
+        else {
+            // Array of LineContent
+            const lines = content.map(c => applyStyle(c.text, c.style)).join('\n');
+            native.set(this.handle, lines);
+            this._height = content.length;
+        }
+    }
+    clearLine(lineNumber) {
+        if (lineNumber < 1) {
+            throw new Error('Line numbers start at 1');
+        }
+        native.clearLine(this.handle, lineNumber);
+    }
+    clear() {
+        native.clearRegion(this.handle);
+    }
+    flush() {
+        // Force immediate render of any pending updates (bypasses throttle)
+        native.flush(this.handle);
+    }
+    setThrottle(fps) {
+        native.setThrottleFps(this.handle, fps);
+    }
+    destroy() {
+        native.destroyRegion(this.handle);
+    }
+}
+//# sourceMappingURL=region.js.map

package/lib/region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.js","sourceRoot":"","sources":["../src/ts/region.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,OAAO,cAAc;IACjB,MAAM,CAAS;IACf,MAAM,CAAS;IACf,OAAO,CAAS,CAAC,8BAA8B;IAEvD,YAAY,UAAyB,EAAE;QACrC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,uCAAuC;QAC3E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,UAAkB,EAAE,OAA6B;QACvD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,mDAAmD;QACnD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAClE,4BAA4B;QAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACzF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,YAAY;QACZ,oCAAoC;QACpC,mDAAmD;QACnD,0CAA0C;QAC1C,qBAAqB;QACrB,2EAA2E;QAE3E,6CAA6C;QAC7C,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,GAAG,CAAC,OAA+B;QACjC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,oCAAoC;YACpC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjC,oCAAoC;YACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,uBAAuB;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC5B,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAChC,CAAC;IACH,CAAC;IAED,SAAS,CAAC,UAAkB;QAC1B,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACH,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,oEAAoE;QACpE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;CACF"}

package/lib/types.d.ts

@@ -0,0 +1,32 @@
+export type Color = 'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'brightBlack' | 'brightRed' | 'brightGreen' | 'brightYellow' | 'brightBlue' | 'brightMagenta' | 'brightCyan' | 'brightWhite';
+export interface TextStyle {
+    color?: Color;
+    backgroundColor?: Color;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+}
+export interface LineContent {
+    text: string;
+    style?: TextStyle;
+}
+export interface RegionOptions {
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+}
+export interface ProgressBarOptions {
+    label?: string;
+    width?: number;
+    style?: {
+        complete?: string;
+        incomplete?: string;
+        brackets?: [string, string];
+    };
+}
+export interface SpinnerOptions {
+    frames?: string[];
+    interval?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/ts/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GACb,OAAO,GACP,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,OAAO,GACP,aAAa,GACb,WAAW,GACX,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/ts/types.ts"],"names":[],"mappings":""}

package/lib/utils/colors.d.ts

@@ -0,0 +1,3 @@
+import { TextStyle } from '../types.js';
+export declare function applyStyle(text: string, style?: TextStyle): string;
+//# sourceMappingURL=colors.d.ts.map

package/lib/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/ts/utils/colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,SAAS,EAAE,MAAM,aAAa,CAAC;AAwC/C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CA8BlE"}

package/lib/utils/colors.js

@@ -0,0 +1,61 @@
+const ANSI_COLORS = {
+    black: '30',
+    red: '31',
+    green: '32',
+    yellow: '33',
+    blue: '34',
+    magenta: '35',
+    cyan: '36',
+    white: '37',
+    brightBlack: '90',
+    brightRed: '91',
+    brightGreen: '92',
+    brightYellow: '93',
+    brightBlue: '94',
+    brightMagenta: '95',
+    brightCyan: '96',
+    brightWhite: '97',
+};
+const ANSI_BG_COLORS = {
+    black: '40',
+    red: '41',
+    green: '42',
+    yellow: '43',
+    blue: '44',
+    magenta: '45',
+    cyan: '46',
+    white: '47',
+    brightBlack: '100',
+    brightRed: '101',
+    brightGreen: '102',
+    brightYellow: '103',
+    brightBlue: '104',
+    brightMagenta: '105',
+    brightCyan: '106',
+    brightWhite: '107',
+};
+export function applyStyle(text, style) {
+    if (!style)
+        return text;
+    const codes = [];
+    if (style.color) {
+        codes.push(ANSI_COLORS[style.color]);
+    }
+    if (style.backgroundColor) {
+        codes.push(ANSI_BG_COLORS[style.backgroundColor]);
+    }
+    if (style.bold) {
+        codes.push('1');
+    }
+    if (style.italic) {
+        codes.push('3');
+    }
+    if (style.underline) {
+        codes.push('4');
+    }
+    if (codes.length === 0) {
+        return text;
+    }
+    return `\x1b[${codes.join(';')}m${text}\x1b[0m`;
+}
+//# sourceMappingURL=colors.js.map

package/lib/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/ts/utils/colors.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAA0B;IACzC,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF,MAAM,cAAc,GAA0B;IAC5C,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,KAAK;IAClB,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAiB;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,QAAQ,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "linecraft",
+  "version": "0.1.0",
+  "description": "High-performance terminal UI library for Node.js with Zig backend",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "license": "MIT",
+  "scripts": {
+    "build:zig": "zig build",
+    "build:ts": "tsc",
+    "build": "pnpm build:zig && pnpm build:ts",
+    "dev": "pnpm build:zig && pnpm build:ts --watch",
+    "test": "zig build test",
+    "test:ansi": "zig build test:ansi",
+    "test:throttle": "zig build test:throttle",
+    "test:buffer": "zig build test:buffer",
+    "test:diff": "zig build test:diff",
+    "test:region": "zig build test:region",
+    "test:ts": "vitest",
+    "example:progress": "tsx examples/basic-progress.ts",
+    "example:spinner": "tsx examples/spinner.ts",
+    "example:multi": "tsx examples/multi-lane.ts"
+  },
+  "keywords": [
+    "terminal",
+    "tui",
+    "progress",
+    "spinner",
+    "ansi",
+    "zig"
+  ],
+  "dependencies": {
+    "ffi-napi": "^4.0.3",
+    "ref-napi": "^3.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}
+

package/src/ts/components/progress-bar.ts

@@ -0,0 +1,53 @@
+import { TerminalRegion } from '../region.js';
+import type { ProgressBarOptions } from '../types.js';
+
+export class ProgressBar {
+  private region: TerminalRegion;
+  private lineNumber: number; // 1-based
+  private current: number = 0;
+  private total: number = 100;
+  private label: string;
+  private width: number;
+  private completeChar: string;
+  private incompleteChar: string;
+  private brackets: [string, string];
+
+  constructor(region: TerminalRegion, lineNumber: number, options: ProgressBarOptions = {}) {
+    this.region = region;
+    this.lineNumber = lineNumber;
+    this.label = options.label || '';
+    this.width = options.width ?? 40;
+    this.completeChar = options.style?.complete ?? '█';
+    this.incompleteChar = options.style?.incomplete ?? '░';
+    this.brackets = options.style?.brackets ?? ['[', ']'];
+  }
+
+  update(current: number, total: number): void {
+    this.current = current;
+    this.total = total;
+    this.render();
+  }
+
+  setLabel(label: string): void {
+    this.label = label;
+    this.render();
+  }
+
+  private render(): void {
+    const percentage = Math.min(100, Math.max(0, (this.current / this.total) * 100));
+    const filled = Math.floor((percentage / 100) * this.width);
+    const empty = this.width - filled;
+
+    const bar = this.completeChar.repeat(filled) + this.incompleteChar.repeat(empty);
+    const text = `${this.label} ${this.brackets[0]}${bar}${this.brackets[1]} ${percentage.toFixed(1)}%`;
+
+    // Just update the line - Zig handles batching and rendering
+    this.region.setLine(this.lineNumber, text);
+    // Optional: call flush() if you need immediate rendering
+  }
+
+  finish(): void {
+    this.update(this.total, this.total);
+  }
+}
+

package/src/ts/components/spinner.ts

@@ -0,0 +1,56 @@
+import { TerminalRegion } from '../region.js';
+import type { SpinnerOptions } from '../types.js';
+
+const DEFAULT_SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+
+export class Spinner {
+  private region: TerminalRegion;
+  private lineNumber: number; // 1-based
+  private frameIndex: number = 0;
+  private text: string = '';
+  private interval?: NodeJS.Timeout;
+  private isRunning: boolean = false;
+  private frames: string[];
+  private intervalMs: number;
+
+  constructor(region: TerminalRegion, lineNumber: number, options: SpinnerOptions = {}) {
+    this.region = region;
+    this.lineNumber = lineNumber;
+    this.frames = options.frames ?? DEFAULT_SPINNER_FRAMES;
+    this.intervalMs = options.interval ?? 100;
+  }
+
+  start(): void {
+    if (this.isRunning) return;
+    this.isRunning = true;
+    this.interval = setInterval(() => {
+      this.render();
+      this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+    }, this.intervalMs);
+  }
+
+  stop(): void {
+    if (!this.isRunning) return;
+    this.isRunning = false;
+    if (this.interval) {
+      clearInterval(this.interval);
+    }
+    // Clear the spinner line
+    this.region.setLine(this.lineNumber, '');
+  }
+
+  setText(text: string): void {
+    this.text = text;
+    this.render();
+  }
+
+  private render(): void {
+    const frame = this.frames[this.frameIndex];
+    const line = `${frame} ${this.text}`;
+
+    // Just update the line - Zig handles batching and rendering
+    this.region.setLine(this.lineNumber, line);
+    // Spinner updates frequently, so Zig's throttling will handle smooth animation
+  }
+}
+

package/src/ts/index.ts

@@ -0,0 +1,37 @@
+export { TerminalRegion } from './region.js';
+export { ProgressBar } from './components/progress-bar.js';
+export { Spinner } from './components/spinner.js';
+export type {
+  RegionOptions,
+  LineContent,
+  TextStyle,
+  Color,
+  ProgressBarOptions,
+  SpinnerOptions,
+} from './types.js';
+
+import { TerminalRegion } from './region.js';
+import { ProgressBar } from './components/progress-bar.js';
+import { Spinner } from './components/spinner.js';
+import type { RegionOptions, ProgressBarOptions, SpinnerOptions } from './types.js';
+
+export function createRegion(options?: RegionOptions): TerminalRegion {
+  return new TerminalRegion(options);
+}
+
+export function createProgressBar(
+  region: TerminalRegion,
+  lineNumber: number,
+  options?: ProgressBarOptions
+): ProgressBar {
+  return new ProgressBar(region, lineNumber, options);
+}
+
+export function createSpinner(
+  region: TerminalRegion,
+  lineNumber: number,
+  options?: SpinnerOptions
+): Spinner {
+  return new Spinner(region, lineNumber, options);
+}
+

package/src/ts/native.ts

@@ -0,0 +1,86 @@
+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(): string {
+  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 interface NativeRegion {
+  createRegion(x: number, y: number, width: number, height: number): number;
+  destroyRegion(handle: number): void;
+  setLine(handle: number, lineNumber: number, content: string): void; // 1-based
+  set(handle: number, content: string): void;
+  clearLine(handle: number, lineNumber: number): void; // 1-based
+  clearRegion(handle: number): void;
+  flush(handle: number): void;
+  setThrottleFps(handle: number, fps: number): void;
+}
+
+export const native: NativeRegion = {
+  createRegion: (x: number, y: number, width: number, height: number): number => {
+    return Number(lib.create_region(x, y, width, height));
+  },
+  
+  destroyRegion: (handle: number): void => {
+    lib.destroy_region(BigInt(handle));
+  },
+  
+  setLine: (handle: number, lineNumber: number, content: string): void => {
+    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: number, content: string): void => {
+    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: number, lineNumber: number): void => {
+    lib.clear_line(BigInt(handle), lineNumber);
+  },
+  
+  clearRegion: (handle: number): void => {
+    lib.clear_region(BigInt(handle));
+  },
+  
+  flush: (handle: number): void => {
+    lib.flush(BigInt(handle));
+  },
+  
+  setThrottleFps: (handle: number, fps: number): void => {
+    lib.set_throttle_fps(BigInt(handle), fps);
+  },
+};
+

package/src/ts/region.ts

@@ -0,0 +1,89 @@
+import { native } from './native.js';
+import { applyStyle } from './utils/colors.js';
+import type { RegionOptions, LineContent, TextStyle } from './types.js';
+
+export class TerminalRegion {
+  private handle: number;
+  private _width: number;
+  private _height: number; // Current height (may expand)
+
+  constructor(options: RegionOptions = {}) {
+    const x = options.x ?? 0;
+    const y = options.y ?? 0;
+    this._width = options.width ?? (process.stdout.columns ?? 80);
+    this._height = options.height ?? 1; // Default to 1 line, expands as needed
+    this.handle = native.createRegion(x, y, this._width, this._height);
+  }
+
+  get width(): number {
+    return this._width;
+  }
+
+  get height(): number {
+    return this._height;
+  }
+
+  setLine(lineNumber: number, content: string | LineContent): void {
+    if (lineNumber < 1) {
+      throw new Error('Line numbers start at 1');
+    }
+
+    // Zig handles batching and expansion automatically
+    const text = typeof content === 'string' ? content : content.text;
+    // Apply styling if provided
+    const styled = applyStyle(text, typeof content === 'object' ? content.style : undefined);
+    native.setLine(this.handle, lineNumber, styled);
+    // Zig will:
+    //   - Convert to 0-based internally
+    //   - Expand region if lineNumber > current height
+    //   - Buffer this update in pending_frame
+    //   - Check throttle
+    //   - Schedule render if needed (or render immediately if throttle allows)
+
+    // Update our height tracking if Zig expanded
+    if (lineNumber > this._height) {
+      this._height = lineNumber;
+    }
+  }
+
+  set(content: string | LineContent[]): void {
+    if (typeof content === 'string') {
+      // Single string with \n line breaks
+      native.set(this.handle, content);
+      // Update height based on line count
+      this._height = content.split('\n').length;
+    } else {
+      // Array of LineContent
+      const lines = content.map(c => 
+        applyStyle(c.text, c.style)
+      ).join('\n');
+      native.set(this.handle, lines);
+      this._height = content.length;
+    }
+  }
+
+  clearLine(lineNumber: number): void {
+    if (lineNumber < 1) {
+      throw new Error('Line numbers start at 1');
+    }
+    native.clearLine(this.handle, lineNumber);
+  }
+
+  clear(): void {
+    native.clearRegion(this.handle);
+  }
+
+  flush(): void {
+    // Force immediate render of any pending updates (bypasses throttle)
+    native.flush(this.handle);
+  }
+
+  setThrottle(fps: number): void {
+    native.setThrottleFps(this.handle, fps);
+  }
+
+  destroy(): void {
+    native.destroyRegion(this.handle);
+  }
+}
+