linecraft 0.1.0 → 0.2.0

package/lib/utils/text.js

@@ -0,0 +1,82 @@
+// Text utilities for handling overflow, ellipsis, etc.
+/**
+ * Truncate text with ellipsis at the end
+ */
+export function truncateEnd(text, maxWidth) {
+    if (text.length <= maxWidth) {
+        return text;
+    }
+    if (maxWidth <= 3) {
+        return '.'.repeat(maxWidth);
+    }
+    return text.slice(0, maxWidth - 3) + '...';
+}
+/**
+ * Truncate text with ellipsis at the beginning
+ */
+export function truncateStart(text, maxWidth) {
+    if (text.length <= maxWidth) {
+        return text;
+    }
+    if (maxWidth <= 3) {
+        return '.'.repeat(maxWidth);
+    }
+    return '...' + text.slice(text.length - (maxWidth - 3));
+}
+/**
+ * Truncate text with ellipsis in the middle
+ */
+export function truncateMiddle(text, maxWidth) {
+    if (text.length <= maxWidth) {
+        return text;
+    }
+    if (maxWidth <= 3) {
+        return '.'.repeat(maxWidth);
+    }
+    const start = Math.floor((maxWidth - 3) / 2);
+    const end = text.length - (maxWidth - 3 - start);
+    return text.slice(0, start) + '...' + text.slice(end);
+}
+/**
+ * Wrap text to fit within a width, breaking on spaces
+ */
+export function wrapText(text, width) {
+    const lines = [];
+    const words = text.split(/\s+/);
+    let currentLine = '';
+    for (const word of words) {
+        if (currentLine.length + word.length + 1 <= width) {
+            currentLine += (currentLine ? ' ' : '') + word;
+        }
+        else {
+            if (currentLine) {
+                lines.push(currentLine);
+            }
+            // If word is longer than width, break it
+            if (word.length > width) {
+                let remaining = word;
+                while (remaining.length > width) {
+                    lines.push(remaining.slice(0, width));
+                    remaining = remaining.slice(width);
+                }
+                currentLine = remaining;
+            }
+            else {
+                currentLine = word;
+            }
+        }
+    }
+    if (currentLine) {
+        lines.push(currentLine);
+    }
+    return lines.length > 0 ? lines : [''];
+}
+/**
+ * Get the visual width of text (accounting for ANSI codes)
+ */
+export function getTextWidth(text) {
+    // Remove ANSI escape codes
+    const ansiRegex = /\x1b\[[0-9;]*m/g;
+    return text.replace(ansiRegex, '').length;
+}
+//# sourceMappingURL=text.js.map

package/lib/utils/text.js.map

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

package/lib/utils/wait-for-spacebar.d.ts

@@ -0,0 +1,10 @@
+import type { TerminalRegion } from '../region';
+/**
+ * Wait for spacebar press before continuing
+ * Useful for testing examples interactively
+ *
+ * Adds the prompt as part of the region by expanding it, ensuring everything
+ * is managed by the region and avoiding scrolling/positioning issues.
+ */
+export declare function waitForSpacebar(region: TerminalRegion, message?: string): Promise<void>;
+//# sourceMappingURL=wait-for-spacebar.d.ts.map

package/lib/utils/wait-for-spacebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-spacebar.d.ts","sourceRoot":"","sources":["../../src/utils/wait-for-spacebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,MAAwC,GAChD,OAAO,CAAC,IAAI,CAAC,CAmEf"}

package/lib/utils/wait-for-spacebar.js

@@ -0,0 +1,71 @@
+import { logToFile } from './debug-log';
+/**
+ * Wait for spacebar press before continuing
+ * Useful for testing examples interactively
+ *
+ * Adds the prompt as part of the region by expanding it, ensuring everything
+ * is managed by the region and avoiding scrolling/positioning issues.
+ */
+export function waitForSpacebar(region, message = 'Press SPACEBAR to continue...') {
+    return new Promise((resolve) => {
+        // DEBUG: Log when waitForSpacebar is called
+        logToFile(`[waitForSpacebar] CALLED, isTTY=${process.stdin.isTTY}, isRaw=${process.stdin.isRaw}`);
+        // CRITICAL: Use add() to properly append the prompt to the region
+        // This ensures the cursor is positioned at the end of the region correctly
+        // and all rendering/positioning is handled properly
+        region.add(['', message]);
+        // Set stdin to raw mode to capture individual keypresses
+        if (!process.stdin.isTTY) {
+            // If not a TTY, just resolve immediately
+            logToFile(`[waitForSpacebar] Not a TTY, resolving immediately`);
+            resolve();
+            return;
+        }
+        // Try to set raw mode, but handle errors gracefully
+        try {
+            process.stdin.setRawMode(true);
+            logToFile(`[waitForSpacebar] Set raw mode successfully`);
+        }
+        catch (err) {
+            // If setRawMode fails (e.g., stdin is closed or not available), just resolve
+            logToFile(`[waitForSpacebar] setRawMode FAILED: ${err instanceof Error ? err.message : String(err)}, resolving immediately`);
+            resolve();
+            return;
+        }
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const onKeyPress = (key) => {
+            // Spacebar or 'q' to exit
+            if (key === ' ' || key === 'q') {
+                cleanup();
+                resolve();
+            }
+            else if (key === '\u0003') { // \u0003 is Ctrl+C
+                // Ctrl+C should exit immediately and restore terminal state
+                cleanup();
+                process.exit(130); // Standard exit code for SIGINT
+            }
+        };
+        const onSIGINT = () => {
+            cleanup();
+            resolve();
+        };
+        const cleanup = () => {
+            try {
+                process.stdin.setRawMode(false);
+            }
+            catch (err) {
+                // Ignore errors when restoring raw mode
+            }
+            process.stdin.pause();
+            process.stdin.removeListener('data', onKeyPress);
+            // CRITICAL: Remove SIGINT listener to prevent memory leak
+            // Each call to waitForSpacebar adds a SIGINT listener, so we must remove it
+            process.removeListener('SIGINT', onSIGINT);
+        };
+        // Handle Ctrl+C explicitly
+        process.on('SIGINT', onSIGINT);
+        process.stdin.on('data', onKeyPress);
+    });
+}
+//# sourceMappingURL=wait-for-spacebar.js.map

package/lib/utils/wait-for-spacebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-spacebar.js","sourceRoot":"","sources":["../../src/utils/wait-for-spacebar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,UAAkB,+BAA+B;IAEjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,4CAA4C;QAC5C,SAAS,CAAC,mCAAmC,OAAO,CAAC,KAAK,CAAC,KAAK,WAAW,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAElG,kEAAkE;QAClE,2EAA2E;QAC3E,oDAAoD;QACpD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QAE1B,yDAAyD;QACzD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,yCAAyC;YACzC,SAAS,CAAC,oDAAoD,CAAC,CAAC;YAChE,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,oDAAoD;QACpD,IAAI,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,SAAS,CAAC,6CAA6C,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,6EAA6E;YAC7E,SAAS,CAAC,wCAAwC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;YAC7H,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE;YACjC,0BAA0B;YAC1B,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAC/B,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC,CAAC,mBAAmB;gBAChD,4DAA4D;gBAC5D,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,gCAAgC;YACrD,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,wCAAwC;YAC1C,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACjD,0DAA0D;YAC1D,4EAA4E;YAC5E,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,2BAA2B;QAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAE/B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,38 +1,31 @@
 {
   "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"
+  "version": "0.2.0",
+  "description": "High-performance terminal UI library for Node.js",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./components": {
+      "types": "./lib/components/index.d.ts",
+      "import": "./lib/components/index.js"
+    }
   },
+  "files": [
+    "lib/**/*"
+  ],
+  "license": "MIT",
   "keywords": [
     "terminal",
     "tui",
     "progress",
     "spinner",
-    "ansi",
-    "zig"
+    "ansi"
   ],
-  "dependencies": {
-    "ffi-napi": "^4.0.3",
-    "ref-napi": "^3.0.3"
-  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsx": "^4.7.0",
@@ -41,6 +34,16 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build:ts": "tsc -p tsconfig.build.json",
+    "build": "pnpm build:ts",
+    "dev": "pnpm build:ts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:ts": "vitest",
+    "example": "node scripts/run-example.js",
+    "record": "vhs",
+    "record:all": "node scripts/record-all.js"
   }
-}
-
+}