split-exec 0.0.1

package/.gitlab-ci.yml

@@ -0,0 +1,16 @@
+
+stages:
+  - publish
+
+publish:
+  stage: publish
+  image: node:18-alpine
+  only:
+    - main
+  script:
+    - npm publish
+  id_tokens:
+    NPM_ID_TOKEN:
+      aud: "npm:registry.npmjs.org"
+    SIGSTORE_ID_TOKEN:
+      aud: sigstore

package/README.md

@@ -0,0 +1,65 @@
+# [split-exec](https://gitlab.com/GCSBOSS/split-exec)
+
+A lightweight Node.js TUI (Text User Interface) to run multiple commands side-by-side in a split terminal view.
+
+**Features:**
+- 🖥️ **Split Screen:** Automatically divides terminal width for 2, 3, 4+ commands.
+- 📜 **Smart Scrolling:** Auto-scrolls to bottom, but pauses if you scroll up to read history.
+- 🔄 **Restart:** Press `r` to instantly kill and restart any specific command.
+- 🖱️ **Interactive:** Supports Mouse wheel, clicking, and keyboard navigation.
+
+## Installation
+
+```bash
+npm install split-exec
+# or globally
+npm install -g split-exec
+
+```
+
+## Usage
+
+### 1. CLI Usage
+
+Run commands directly from your terminal. Great for on-the-fly monitoring.
+
+```bash
+# Run 3 commands side by side
+npx split-exec "ping google.com" "ping 1.1.1.1" "ls -R /"
+
+```
+
+### 2. Programmatic Usage
+
+Create a dashboard file (e.g., `dev-dashboard.js`) for your project.
+
+```javascript
+const { splitExec } = require('split-exec');
+
+splitExec([
+  // Simple string
+  'npm run server',
+  
+  // Object for more control
+  {
+    title: 'Jest Tests',
+    cmd: 'npm',
+    args: ['test', '--', '--watch']
+  }
+]);
+
+```
+
+## Controls
+
+| Key | Action |
+| --- | --- |
+| **Tab / Right** | Focus next column |
+| **Shift+Tab / Left** | Focus previous column |
+| **Up / Down** | Scroll history |
+| **r** | **Restart** the focused command |
+| **q / Esc** | Quit |
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+const lib = require('../src/index.js');
+const args = process.argv.slice(2);
+
+if (args.length === 0) {
+  console.log('Usage: split-exec "command 1" "command 2" ...');
+  process.exit(1);
+}
+
+lib.splitExec(args);

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "split-exec",
+  "version": "0.0.1",
+  "description": "Run multiple commands in parallel with a split-screen TUI dashboard.",
+  "main": "src/index.js",
+  "bin": {
+    "split-exec": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "dashboard",
+    "parallel",
+    "terminal",
+    "split-screen",
+    "blessed"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "dependencies": {
+    "blessed": "^0.1.81",
+    "iconv-lite": "^0.6.3"
+  }
+}

package/src/index.js

@@ -0,0 +1,150 @@
+const blessed = require('blessed');
+const { spawn, execSync } = require('child_process');
+const iconv = require('iconv-lite');
+
+// 1. Detect System Encoding (Robust Version)
+function getSystemEncoding() {
+  // Mac/Linux are almost always UTF-8
+  if (process.platform !== 'win32') return 'utf8';
+
+  try {
+    // Run 'chcp' to find active code page
+    // output example: "Página de código ativa: 850"
+    const output = execSync('chcp').toString();
+    
+    // Regex: Find ALL sequences of digits
+    const matches = output.match(/\d+/g);
+    
+    if (matches && matches.length > 0) {
+      // The code page is invariably the last number in the string
+      const pageId = matches[matches.length - 1];
+      const encoding = 'cp' + pageId; // e.g. 'cp850'
+      
+      // Ensure iconv supports it, otherwise fallback
+      if (iconv.encodingExists(encoding)) {
+        return encoding;
+      }
+    }
+  } catch (e) {
+    // Ignore error
+  }
+
+  // CRITICAL FALLBACK for Portuguese/Western Europe Windows
+  // If we couldn't detect it, assume CP850 (Standard OEM), NOT UTF-8.
+  return 'cp850';
+}
+
+const SYSTEM_ENCODING = getSystemEncoding();
+
+function start(commands) {
+  const screen = blessed.screen({
+    smartCSR: true,
+    title: `split-exec`, 
+    dockBorders: true,
+    mouse: true
+  });
+
+  const configs = commands.map((item, index) => {
+    if (typeof item === 'string') {
+      return { cmd: item, args: [], title: item };
+    }
+    return {
+      cmd: item.cmd,
+      args: item.args || [],
+      title: item.title || `Command ${index + 1}`
+    };
+  });
+
+  const boxes = [];
+
+  configs.forEach((config, i) => {
+    const widthPercent = Math.floor(100 / configs.length);
+    
+    const box = blessed.box({
+      top: 0,
+      left: `${i * widthPercent}%`,
+      width: `${widthPercent}%`,
+      height: '100%',
+      label: ` ${config.title} `,
+      tags: true,
+      keys: true,
+      mouse: true,
+      border: { type: 'line' },
+      style: { fg: 'white', border: { fg: '#f0f0f0' }, focus: { border: { fg: 'green' } } },
+      scrollable: true,
+      alwaysScroll: true,
+      scrollbar: { ch: ' ', bg: 'blue' }
+    });
+
+    boxes.push(box);
+    screen.append(box);
+
+    box.key('r', () => spawnInBox(box, config, screen));
+    spawnInBox(box, config, screen);
+  });
+
+  if (boxes.length > 0) boxes[0].focus();
+
+  screen.key(['tab', 'right'], () => { screen.focusNext(); screen.render(); });
+  screen.key(['S-tab', 'left'], () => { screen.focusPrevious(); screen.render(); });
+  screen.key(['escape', 'q', 'C-c'], () => process.exit(0));
+
+  const tip = blessed.box({
+    bottom: 0, right: 0, height: 1, width: 'shrink',
+    content: ` [TAB] Nav | [r] Restart | [q] Quit | Enc: ${SYSTEM_ENCODING} `,
+    style: { bg: 'blue', fg: 'white' }
+  });
+  screen.append(tip);
+
+  screen.render();
+}
+
+function spawnInBox(box, config, screen) {
+  if (box.activeProcess) {
+    try { box.activeProcess.kill(); } catch (e) {}
+    box.pushLine(`{yellow-fg}--- RESTARTING ---{/}`);
+  } else {
+    box.setContent('');
+  }
+  
+  box.border.fg = 'green';
+  screen.render();
+
+  const write = (msg) => {
+    const isAtBottom = (box.childBase + box.height) >= box.getScrollHeight();
+    box.pushLine(msg);
+    if (isAtBottom) box.setScrollPerc(100);
+  };
+
+  try {
+    // Spawn with shell:true to support standard windows commands
+    const child = spawn(config.cmd, config.args, { shell: true });
+    
+    box.activeProcess = child;
+
+    // IMPORTANT: Treat output as raw buffer
+    child.stdout.on('data', d => { 
+      // Decode Buffer -> String using detected encoding
+      const cleanStr = iconv.decode(d, SYSTEM_ENCODING);
+      write(cleanStr.trim()); 
+      screen.render(); 
+    });
+    
+    child.stderr.on('data', d => { 
+      const cleanStr = iconv.decode(d, SYSTEM_ENCODING);
+      write(`{red-fg}${cleanStr.trim()}{/}`); 
+      screen.render(); 
+    });
+
+    child.on('close', (code) => {
+      box.activeProcess = null;
+      box.border.fg = '#f0f0f0';
+      write(code === 0 ? `{green-fg}Done (0){/}` : `{red-fg}Exit (${code}){/}`);
+      screen.render();
+    });
+  } catch (e) {
+    write(`{red-fg}Error: ${e.message}{/}`);
+  }
+}
+
+module.exports = { splitExec: start };