tuimon 0.1.0

package/dist/server.js

@@ -0,0 +1,142 @@
+import { createServer } from 'node:http';
+import { readFileSync, existsSync } from 'node:fs';
+import { join, extname, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ─── Paths to bundled assets ────────────────────────────────────────────────
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const clientJsPath = join(__dirname, '..', 'client', 'tuimon-client.js');
+const confirmQuitPath = join(__dirname, '..', 'templates', 'internal', 'confirm-quit.html');
+// ─── MIME types ─────────────────────────────────────────────────────────────
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.svg': 'image/svg+xml',
+    '.woff2': 'font/woff2',
+};
+function mimeFor(filePath) {
+    return MIME_TYPES[extname(filePath).toLowerCase()] ?? 'application/octet-stream';
+}
+// ─── Script injection ───────────────────────────────────────────────────────
+const CLIENT_SCRIPT_TAG = '<script src="/tuimon/client.js"></script>';
+function injectClientScript(html) {
+    if (html.includes('tuimon/client.js'))
+        return html;
+    return html.replace('</head>', `${CLIENT_SCRIPT_TAG}</head>`);
+}
+// ─── Serve helpers ──────────────────────────────────────────────────────────
+function serveFile(res, filePath, transform) {
+    if (!existsSync(filePath)) {
+        res.writeHead(404, { 'Content-Type': 'text/plain', Connection: 'close' });
+        res.end('Not Found');
+        return;
+    }
+    const mime = mimeFor(filePath);
+    const raw = readFileSync(filePath);
+    if (transform && mime.startsWith('text/html')) {
+        const transformed = transform(raw.toString('utf-8'));
+        res.writeHead(200, { 'Content-Type': mime, Connection: 'close' });
+        res.end(transformed);
+    }
+    else {
+        res.writeHead(200, { 'Content-Type': mime, Connection: 'close' });
+        res.end(raw);
+    }
+}
+// ─── Request handler ────────────────────────────────────────────────────────
+function createHandler(rootDir) {
+    return (req, res) => {
+        const url = req.url ?? '/';
+        let pathname;
+        try {
+            pathname = decodeURIComponent(url.split('?')[0] ?? '/');
+        }
+        catch {
+            res.writeHead(400, { 'Content-Type': 'text/plain' });
+            res.end('Bad Request');
+            return;
+        }
+        // Internal tuimon routes
+        if (pathname === '/tuimon/client.js') {
+            serveFile(res, clientJsPath);
+            return;
+        }
+        if (pathname === '/tuimon/confirm-quit.html') {
+            serveFile(res, confirmQuitPath);
+            return;
+        }
+        // Serve from rootDir
+        const safePath = pathname.startsWith('/') ? pathname.slice(1) : pathname;
+        const filePath = resolve(rootDir, safePath);
+        // Prevent path traversal — ensure resolved path is within rootDir
+        const normalizedRoot = rootDir.endsWith(sep) ? rootDir : rootDir + sep;
+        if (!filePath.startsWith(normalizedRoot) && filePath !== rootDir) {
+            res.writeHead(403, { 'Content-Type': 'text/plain' });
+            res.end('Forbidden');
+            return;
+        }
+        serveFile(res, filePath, injectClientScript);
+    };
+}
+// ─── Server startup ─────────────────────────────────────────────────────────
+const START_PORT = 7337;
+const MAX_ATTEMPTS = 100;
+function tryListen(server, port) {
+    return new Promise((resolve, reject) => {
+        const onError = (err) => {
+            if (err.code === 'EADDRINUSE') {
+                if (port - START_PORT >= MAX_ATTEMPTS) {
+                    reject(new Error(`Could not find open port after ${MAX_ATTEMPTS} attempts`));
+                    return;
+                }
+                server.removeListener('error', onError);
+                tryListen(server, port + 1).then(resolve, reject);
+            }
+            else {
+                reject(err);
+            }
+        };
+        server.once('error', onError);
+        server.listen(port, 'localhost', () => {
+            server.removeListener('error', onError);
+            resolve(port);
+        });
+    });
+}
+export async function startServer({ rootDir }) {
+    const server = createServer(createHandler(rootDir));
+    // Track open sockets so close() can destroy them immediately
+    const sockets = new Set();
+    server.on('connection', (socket) => {
+        sockets.add(socket);
+        socket.once('close', () => sockets.delete(socket));
+    });
+    const port = await tryListen(server, START_PORT);
+    const url = `http://localhost:${port}`;
+    return {
+        url,
+        urlFor(htmlPath) {
+            return `${url}/${htmlPath}`;
+        },
+        close() {
+            return new Promise((resolve, reject) => {
+                // Destroy all open sockets so the server can close immediately
+                for (const socket of sockets) {
+                    socket.destroy();
+                }
+                sockets.clear();
+                server.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,108 @@
+export type FKey = 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12';
+/** Single lowercase letter a-z used as a panel/page shortcut */
+export type ShortcutKey = string;
+export interface KeyBinding {
+    label: string;
+    action: () => void | Promise<void>;
+}
+export type FKeyMap = Partial<Record<FKey, KeyBinding>>;
+export interface PageConfig {
+    /** Absolute or cwd-relative path to the HTML file for this page */
+    html: string;
+    /** If true, this is the starting page. Exactly one page must be default. */
+    default?: boolean;
+    /**
+     * Single lowercase letter shortcut to navigate to this page from the overview.
+     * Not valid on the default page.
+     * Cannot conflict with other page shortcuts.
+     * Cannot be 'y', 'n', or any reserved key.
+     */
+    shortcut?: ShortcutKey;
+    /** Human-readable label shown in panel borders and the F-key bar */
+    label?: string;
+    /**
+     * F-key bindings active when this page is displayed.
+     * ESC and Ctrl+C are always reserved — defining them here has no effect
+     * and TuiMon will log a warning at startup.
+     */
+    keys?: FKeyMap;
+}
+export type PageMap = Record<string, PageConfig>;
+export interface TuiMonOptions {
+    /** Page definitions. At least one page must have default: true. */
+    pages: PageMap;
+    /**
+     * Data function called before each render.
+     * Result is passed into the page via TuiMon.onUpdate().
+     */
+    data?: () => Record<string, unknown> | Promise<Record<string, unknown>>;
+    /**
+     * Auto-render interval in ms. Requires data to be set.
+     * Default: no auto-render — developer calls dash.render() manually.
+     */
+    refresh?: number;
+    /** Delay in ms after pushData() before screenshotting. Default: 50 */
+    renderDelay?: number;
+}
+export interface TuiMonDashboard {
+    /**
+     * Render the current page with new data.
+     * Caches data for use when navigating between pages.
+     */
+    render: (data: Record<string, unknown>) => Promise<void>;
+    /** Gracefully shut down — restores terminal state */
+    stop: () => Promise<void>;
+}
+export type PageState = {
+    type: 'overview';
+    pageId: string;
+} | {
+    type: 'detail';
+    pageId: string;
+} | {
+    type: 'confirm-quit';
+    returnTo: PageState;
+};
+export interface GraphicsSupport {
+    kitty: boolean;
+    sixel: boolean;
+    iterm2: boolean;
+    protocol: 'kitty' | 'sixel' | 'iterm2' | null;
+}
+export interface TerminalDimensions {
+    cols: number;
+    rows: number;
+    pixelWidth: number;
+    pixelHeight: number;
+}
+export interface ServerHandle {
+    /** Base URL the server is listening on */
+    url: string;
+    /** Returns the full URL for a given page html path */
+    urlFor: (htmlPath: string) => string;
+    close: () => Promise<void>;
+}
+export interface BrowserHandle {
+    screenshot: () => Promise<Buffer>;
+    pushData: (data: Record<string, unknown>) => Promise<void>;
+    navigate: (url: string) => Promise<void>;
+    resize: (width: number, height: number) => Promise<void>;
+    close: () => Promise<void>;
+}
+export interface FKeyBarHandle {
+    /** Replace the current key set and re-render the bar */
+    setKeys: (keys: FKeyMap) => void;
+    /** Show a temporary message in the bar for duration ms */
+    notify: (message: string, duration?: number) => void;
+    stop: () => void;
+}
+export interface KeyHandlerHandle {
+    stop: () => void;
+}
+export interface RouterHandle {
+    /** Process a raw key string from stdin */
+    handleKey: (key: string) => Promise<void>;
+    /** Current page state */
+    getState: () => PageState;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "tuimon",
+  "version": "0.1.0",
+  "description": "Render beautiful HTML dashboards directly in your terminal.",
+  "type": "module",
+  "bin": { "tuimon": "./dist/cli.js" },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": "./client/tuimon-client.js"
+  },
+  "engines": { "node": ">=20.0.0" },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write src",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "playwright": "^1.44.0",
+    "sharp": "^0.33.0",
+    "chokidar": "^3.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
+  }
+}

package/templates/internal/confirm-quit.html

@@ -0,0 +1,94 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Quit TuiMon?</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      width: 100vw;
+      height: 100vh;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      background: rgba(0, 0, 0, 0.85);
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+      color: #c9d1d9;
+    }
+    .card {
+      background: #1c2128;
+      border: 1px solid #30363d;
+      border-radius: 8px;
+      padding: 48px 64px;
+      text-align: center;
+      max-width: 480px;
+    }
+    h1 {
+      color: #ffffff;
+      font-size: 28px;
+      font-weight: 600;
+      margin-bottom: 12px;
+    }
+    .subtitle {
+      color: #8b949e;
+      font-size: 16px;
+      margin-bottom: 32px;
+    }
+    .keys {
+      display: flex;
+      gap: 24px;
+      justify-content: center;
+      margin-bottom: 20px;
+    }
+    .key {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      font-size: 18px;
+      font-weight: 500;
+    }
+    .key-badge {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      width: 36px;
+      height: 36px;
+      border-radius: 6px;
+      font-size: 18px;
+      font-weight: 700;
+      font-family: monospace;
+    }
+    .key-badge.yes {
+      background: #da3633;
+      color: #ffffff;
+    }
+    .key-badge.no {
+      background: #238636;
+      color: #ffffff;
+    }
+    .esc-note {
+      color: #484f58;
+      font-size: 13px;
+      margin-top: 4px;
+    }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <h1>Quit TuiMon?</h1>
+    <p class="subtitle">Press Y to confirm or N to cancel</p>
+    <div class="keys">
+      <div class="key">
+        <span class="key-badge yes">Y</span>
+        <span class="key-label">Confirm</span>
+      </div>
+      <div class="key">
+        <span class="key-badge no">N</span>
+        <span class="key-label">Cancel</span>
+      </div>
+    </div>
+    <p class="esc-note">ESC also cancels</p>
+  </div>
+</body>
+</html>

package/templates/starter/pages/cpu-detail.html

@@ -0,0 +1,176 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>TuiMon — CPU Detail</title>
+  <script src="https://cdn.jsdelivr.net/npm/chart.js@4"></script>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      background: #0d1117;
+      color: #c9d1d9;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, monospace;
+      padding: 12px;
+      overflow: hidden;
+      height: 100vh;
+      display: grid;
+      grid-template-columns: 1fr 280px;
+      grid-template-rows: auto 1fr;
+      gap: 12px;
+    }
+    .header {
+      grid-column: 1 / -1;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      padding-bottom: 8px;
+      border-bottom: 1px solid #21262d;
+    }
+    .header h1 { font-size: 16px; color: #58a6ff; font-weight: 600; }
+    .header .back { font-size: 12px; color: #484f58; }
+    .chart-panel {
+      background: #161b22;
+      border: 1px solid #21262d;
+      border-radius: 6px;
+      padding: 16px;
+      min-height: 0;
+    }
+    .chart-panel h3 {
+      font-size: 12px;
+      color: #8b949e;
+      text-transform: uppercase;
+      letter-spacing: 1px;
+      margin-bottom: 12px;
+    }
+    .chart-wrap { height: calc(100% - 32px); }
+    .sidebar {
+      display: flex;
+      flex-direction: column;
+      gap: 10px;
+    }
+    .info-card {
+      background: #161b22;
+      border: 1px solid #21262d;
+      border-radius: 6px;
+      padding: 14px;
+    }
+    .info-card h4 {
+      font-size: 11px;
+      color: #8b949e;
+      text-transform: uppercase;
+      letter-spacing: 1px;
+      margin-bottom: 10px;
+    }
+    .info-row {
+      display: flex;
+      justify-content: space-between;
+      font-size: 13px;
+      line-height: 1.8;
+    }
+    .info-row .label { color: #8b949e; }
+    .info-row .val { color: #58a6ff; font-weight: 600; }
+    .core-bar {
+      height: 8px;
+      background: #21262d;
+      border-radius: 4px;
+      margin-top: 4px;
+      overflow: hidden;
+    }
+    .core-bar-fill {
+      height: 100%;
+      background: #58a6ff;
+      border-radius: 4px;
+      transition: width 0.3s ease;
+    }
+    .core-entry { margin-bottom: 8px; }
+    .core-label { font-size: 11px; color: #8b949e; display: flex; justify-content: space-between; }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>CPU Detail</h1>
+    <span class="back">ESC to go back</span>
+  </div>
+
+  <div class="chart-panel">
+    <h3>CPU Usage — Last 5 Minutes</h3>
+    <div class="chart-wrap"><canvas id="cpuChart"></canvas></div>
+  </div>
+
+  <div class="sidebar">
+    <div class="info-card">
+      <h4>System Info</h4>
+      <div class="info-row"><span class="label">Cores</span><span class="val" id="cores">--</span></div>
+      <div class="info-row"><span class="label">Load 1m</span><span class="val" id="load1">--</span></div>
+      <div class="info-row"><span class="label">Load 5m</span><span class="val" id="load5">--</span></div>
+      <div class="info-row"><span class="label">Load 15m</span><span class="val" id="load15">--</span></div>
+      <div class="info-row"><span class="label">Current</span><span class="val" id="cpuPct">--</span></div>
+    </div>
+
+    <div class="info-card">
+      <h4>Per-Core Usage</h4>
+      <div id="coreList"></div>
+    </div>
+  </div>
+
+  <script>
+    const cpuHistory = []
+    const MAX_POINTS = 300
+
+    const chart = new Chart(document.getElementById('cpuChart'), {
+      type: 'line',
+      data: {
+        labels: [],
+        datasets: [{
+          data: cpuHistory,
+          borderColor: '#58a6ff',
+          backgroundColor: 'rgba(88,166,255,0.15)',
+          fill: true,
+          tension: 0.2,
+          pointRadius: 0,
+          borderWidth: 2,
+        }],
+      },
+      options: {
+        responsive: true,
+        maintainAspectRatio: false,
+        animation: false,
+        scales: {
+          y: { min: 0, max: 100, grid: { color: '#21262d' }, ticks: { color: '#484f58', callback: v => v + '%' } },
+          x: { display: false },
+        },
+        plugins: { legend: { display: false } },
+      },
+    })
+
+    TuiMon.onUpdate(function (data) {
+      TuiMon.set('#cpuPct', data.cpu + '%')
+      TuiMon.set('#cores', data.coreCount)
+
+      if (data.loadAvg) {
+        TuiMon.set('#load1', data.loadAvg[0] != null ? data.loadAvg[0].toFixed(2) : '--')
+        TuiMon.set('#load5', data.loadAvg[1] != null ? data.loadAvg[1].toFixed(2) : '--')
+        TuiMon.set('#load15', data.loadAvg[2] != null ? data.loadAvg[2].toFixed(2) : '--')
+      }
+
+      cpuHistory.push(data.cpu)
+      if (cpuHistory.length > MAX_POINTS) cpuHistory.shift()
+      chart.data.labels = cpuHistory.map((_, i) => i)
+      chart.update()
+
+      // Simulated per-core usage
+      var coreList = document.getElementById('coreList')
+      var html = ''
+      for (var i = 0; i < (data.coreCount || 4); i++) {
+        var usage = Math.max(5, Math.min(98, data.cpu + Math.round((Math.random() - 0.5) * 30)))
+        html += '<div class="core-entry">'
+          + '<div class="core-label"><span>Core ' + i + '</span><span>' + usage + '%</span></div>'
+          + '<div class="core-bar"><div class="core-bar-fill" style="width:' + usage + '%"></div></div>'
+          + '</div>'
+      }
+      coreList.innerHTML = html
+    })
+  </script>
+</body>
+</html>