@ggterm/core 0.2.20 → 0.3.1

package/dist/cli-plot.js

@@ -3708,7 +3708,7 @@ function renderGeomVolcano(data, geom, aes, scales, canvas) {
   }
   if (nLabels > 0 && aes.label) {
     const significantPoints = points.filter((p) => p.status !== "ns" && p.label).sort((a, b) => b.significance - a.significance).slice(0, nLabels);
-    const labelColor = { r: 50, g: 50, b: 50, a: 1 };
+    const labelColor = { r: 255, g: 255, b: 255, a: 1 };
     for (const point of significantPoints) {
       const cx = Math.round(scales.x.map(point.x));
       const cy = Math.round(scales.y.map(point.y));
@@ -4486,6 +4486,16 @@ function renderGeomForest(data, geom, aes, scales, canvas) {
     canvas.drawChar(x2, y, "┤", ciColor);
     const px = Math.round(mapX(row.estimate));
     canvas.drawChar(px, y, pointChar, pointColor);
+    const label = row.study;
+    const labelColor = { r: 200, g: 200, b: 200, a: 1 };
+    const labelEnd = plotLeft - 1;
+    const labelStart = labelEnd - label.length;
+    for (let c = 0;c < label.length; c++) {
+      const charX = labelStart + c;
+      if (charX >= 0) {
+        canvas.drawChar(charX, y, label[c], labelColor);
+      }
+    }
   }
 }
 function renderGeomRoc(data, geom, aes, scales, canvas) {
@@ -7907,11 +7917,23 @@ function calculateLayout(spec, options) {
   } else if (hasY2) {
     rightMargin = 8 + (hasY2Label ? 2 : 0);
   }
+  let forestLabelWidth = 0;
+  const isForestPlot = spec.geoms.some((g) => g.type === "forest");
+  if (isForestPlot && Array.isArray(spec.data) && spec.data.length > 0) {
+    const yField = typeof spec.aes.y === "string" ? spec.aes.y : "study";
+    for (const row of spec.data) {
+      const label = String(row[yField] ?? "");
+      if (label.length > forestLabelWidth)
+        forestLabelWidth = label.length;
+    }
+  }
+  const defaultLeft = 8 + (hasYLabel ? 2 : 0);
+  const neededLeft = forestLabelWidth > 0 ? forestLabelWidth + 2 : defaultLeft;
   const margins = {
     top: hasTitle ? 2 : 1,
     right: rightMargin,
     bottom: 2 + (hasXLabel ? 1 : 0) + (hasLegend && legendPosition === "bottom" ? 2 : 0),
-    left: 8 + (hasYLabel ? 2 : 0)
+    left: Math.max(defaultLeft, neededLeft)
   };
   const plotArea = {
     x: margins.left,
@@ -8125,7 +8147,9 @@ function renderToCanvas(spec, options) {
     renderTitle(canvas, spec.labels.title, layout.width, spec.theme);
   }
   renderGridLines(canvas, scales, layout.plotArea, spec.theme);
-  renderAxes(canvas, scales, layout.plotArea, spec.labels, spec.theme);
+  const isForest = spec.geoms.some((g) => g.type === "forest");
+  const axisLabels = isForest ? { ...spec.labels, y: undefined } : spec.labels;
+  renderAxes(canvas, scales, layout.plotArea, axisLabels, spec.theme);
   for (const geom of spec.geoms) {
     let geomData;
     let geomAes = spec.aes;
@@ -14412,11 +14436,6 @@ var init_src = __esm(() => {
   init_export();
 });
 
-// src/cli-plot.ts
-init_src();
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join3 } from "path";
-
 // src/history/index.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync, readdirSync } from "fs";
 import { join } from "path";
@@ -14573,6 +14592,652 @@ function getLatestPlotId() {
   }
   return history[history.length - 1].id;
 }
+var init_history = () => {};
+
+// src/serve.ts
+var exports_serve = {};
+__export(exports_serve, {
+  handleServe: () => handleServe
+});
+import { watch, writeFileSync as writeFileSync3, unlinkSync } from "fs";
+import { join as join3 } from "path";
+import { createServer } from "http";
+import { createHash } from "crypto";
+import { spawn } from "child_process";
+function plotToVegaLite(plot) {
+  const geomTypes = plot._provenance.geomTypes;
+  const hasCompositeMark = geomTypes.some((t) => COMPOSITE_MARKS.has(t));
+  const spec = plotSpecToVegaLite(plot.spec, { interactive: !hasCompositeMark });
+  return { spec, provenance: plot._provenance };
+}
+function getLatestPayload() {
+  const id = getLatestPlotId();
+  if (!id)
+    return null;
+  const plot = loadPlotFromHistory(id);
+  if (!plot)
+    return null;
+  const { spec, provenance } = plotToVegaLite(plot);
+  return JSON.stringify({ type: "plot", spec, provenance });
+}
+function encodeWebSocketFrame(data) {
+  const payload = Buffer.from(data, "utf-8");
+  const len = payload.length;
+  let header;
+  if (len < 126) {
+    header = Buffer.alloc(2);
+    header[0] = 129;
+    header[1] = len;
+  } else if (len < 65536) {
+    header = Buffer.alloc(4);
+    header[0] = 129;
+    header[1] = 126;
+    header.writeUInt16BE(len, 2);
+  } else {
+    header = Buffer.alloc(10);
+    header[0] = 129;
+    header[1] = 127;
+    header.writeBigUInt64BE(BigInt(len), 2);
+  }
+  return Buffer.concat([header, payload]);
+}
+function jsonResponse(res, data, status = 200) {
+  const body = JSON.stringify(data);
+  res.writeHead(status, { "content-type": "application/json" });
+  res.end(body);
+}
+function handleServe(port) {
+  const p = port || 4242;
+  ensureHistoryDirs();
+  const clients = new Set;
+  let debounceTimer = null;
+  const plotsDir = getPlotsDir();
+  watch(plotsDir, (_event, filename) => {
+    if (!filename || !filename.endsWith(".json"))
+      return;
+    if (debounceTimer)
+      clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(() => {
+      const payload = getLatestPayload();
+      if (!payload)
+        return;
+      const frame = encodeWebSocketFrame(payload);
+      for (const client of clients) {
+        try {
+          client.write(frame);
+        } catch {
+          clients.delete(client);
+        }
+      }
+    }, 150);
+  });
+  const server = createServer((req, res) => {
+    const url = new URL(req.url || "/", `http://localhost:${p}`);
+    if (url.pathname === "/api/latest") {
+      const payload = getLatestPayload();
+      if (!payload)
+        return jsonResponse(res, { type: "empty" });
+      res.writeHead(200, { "content-type": "application/json" });
+      res.end(payload);
+      return;
+    }
+    if (url.pathname === "/api/history") {
+      const entries = getHistory().slice(-50);
+      jsonResponse(res, entries);
+      return;
+    }
+    if (url.pathname.startsWith("/api/plot/")) {
+      const id = url.pathname.slice("/api/plot/".length);
+      const plot = loadPlotFromHistory(id);
+      if (!plot)
+        return jsonResponse(res, { error: "not found" }, 404);
+      const { spec, provenance } = plotToVegaLite(plot);
+      jsonResponse(res, { type: "plot", spec, provenance });
+      return;
+    }
+    res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+    res.end(CLIENT_HTML);
+  });
+  server.on("upgrade", (req, socket, _head) => {
+    const url = new URL(req.url || "/", `http://localhost:${p}`);
+    if (url.pathname !== "/ws") {
+      socket.destroy();
+      return;
+    }
+    const key = req.headers["sec-websocket-key"];
+    if (!key) {
+      socket.destroy();
+      return;
+    }
+    const accept = createHash("sha1").update(key + "258EAFA5-E914-47DA-95CA-5AB5DC85B7A8").digest("base64");
+    socket.write(`HTTP/1.1 101 Switching Protocols\r
+` + `Upgrade: websocket\r
+` + `Connection: Upgrade\r
+` + `Sec-WebSocket-Accept: ${accept}\r
+` + `\r
+`);
+    clients.add(socket);
+    const payload = getLatestPayload();
+    if (payload)
+      socket.write(encodeWebSocketFrame(payload));
+    socket.on("close", () => clients.delete(socket));
+    socket.on("error", () => clients.delete(socket));
+    socket.on("data", (data) => {
+      if (data.length < 2)
+        return;
+      const opcode = data[0] & 15;
+      if (opcode === 8) {
+        const closeFrame = Buffer.alloc(2);
+        closeFrame[0] = 136;
+        closeFrame[1] = 0;
+        try {
+          socket.write(closeFrame);
+        } catch {}
+        socket.end();
+        clients.delete(socket);
+        return;
+      }
+      if (opcode === 9) {
+        const pong = Buffer.from(data);
+        pong[0] = pong[0] & 240 | 10;
+        try {
+          socket.write(pong);
+        } catch {}
+      }
+    });
+  });
+  server.listen(p, () => {
+    const url = `http://localhost:${p}`;
+    console.log(`ggterm live viewer running at ${url}`);
+    const markerPath = join3(getGGTermDir(), "serve.json");
+    writeFileSync3(markerPath, JSON.stringify({ port: p, pid: process.pid }));
+    const cleanup = () => {
+      try {
+        unlinkSync(markerPath);
+      } catch {}
+    };
+    process.on("SIGINT", () => {
+      cleanup();
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      cleanup();
+      process.exit(0);
+    });
+    process.on("exit", cleanup);
+    if (process.env.TERM_PROGRAM === "waveterm") {
+      spawn("wsh", ["web", "open", url], { stdio: "ignore", detached: true }).unref();
+      console.log(`Opened Wave panel`);
+    } else {
+      console.log(`Open in browser or Wave panel: wsh web open ${url}`);
+    }
+    console.log(`Watching ${plotsDir} for new plots...`);
+    console.log(`Press Ctrl+C to stop`);
+  });
+}
+var COMPOSITE_MARKS, CLIENT_HTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>ggterm</title>
+<script src="https://cdn.jsdelivr.net/npm/vega@5"></script>
+<script src="https://cdn.jsdelivr.net/npm/vega-lite@5"></script>
+<script src="https://cdn.jsdelivr.net/npm/vega-embed@6"></script>
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, 'SF Mono', Menlo, monospace;
+    background: #0d1117;
+    color: #c9d1d9;
+    height: 100vh;
+    display: flex;
+    overflow: hidden;
+  }
+  #sidebar {
+    width: 260px;
+    background: #161b22;
+    border-right: 1px solid #30363d;
+    display: flex;
+    flex-direction: column;
+    flex-shrink: 0;
+    transform: translateX(-260px);
+    transition: transform 0.2s ease;
+    position: absolute;
+    top: 0;
+    left: 0;
+    bottom: 0;
+    z-index: 10;
+  }
+  #sidebar.open { transform: translateX(0); }
+  #sidebar-header {
+    padding: 12px;
+    border-bottom: 1px solid #30363d;
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    font-size: 12px;
+    font-weight: 600;
+    color: #c9d1d9;
+  }
+  #sidebar-header button {
+    background: none;
+    border: none;
+    color: #8b949e;
+    cursor: pointer;
+    font-size: 14px;
+    padding: 2px 6px;
+  }
+  #sidebar-header button:hover { color: #c9d1d9; }
+  #history-list {
+    flex: 1;
+    overflow-y: auto;
+    padding: 4px 0;
+  }
+  #history-list::-webkit-scrollbar { width: 6px; }
+  #history-list::-webkit-scrollbar-track { background: transparent; }
+  #history-list::-webkit-scrollbar-thumb { background: #30363d; border-radius: 3px; }
+  .history-item {
+    padding: 8px 12px;
+    cursor: pointer;
+    border-left: 2px solid transparent;
+    transition: background 0.1s;
+  }
+  .history-item:hover { background: #21262d; }
+  .history-item.active { background: #1c2128; border-left-color: #58a6ff; }
+  .history-item .hi-id { font-size: 11px; color: #58a6ff; font-weight: 600; }
+  .history-item .hi-desc { font-size: 11px; color: #8b949e; margin-top: 2px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  .history-item .hi-meta { font-size: 10px; color: #484f58; margin-top: 2px; display: flex; gap: 8px; }
+  .history-item .hi-geom {
+    background: #21262d;
+    border: 1px solid #30363d;
+    border-radius: 3px;
+    padding: 0 4px;
+    font-size: 10px;
+    color: #8b949e;
+  }
+  #main {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    min-width: 0;
+  }
+  #vis {
+    flex: 1;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: 16px;
+  }
+  #vis .vega-embed { width: 100%; }
+  #vis .vega-embed canvas,
+  #vis .vega-embed svg {
+    max-width: 100%;
+    max-height: calc(100vh - 80px);
+  }
+  #bar {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 8px 16px;
+    background: #161b22;
+    border-top: 1px solid #30363d;
+    font-size: 12px;
+    gap: 12px;
+    min-height: 40px;
+  }
+  #meta { display: flex; gap: 16px; align-items: center; flex: 1; min-width: 0; }
+  #plot-id { color: #58a6ff; font-weight: 600; }
+  #plot-desc { color: #8b949e; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  #plot-time { color: #484f58; }
+  #nav { display: flex; gap: 4px; align-items: center; }
+  .bar-btn {
+    background: #21262d;
+    border: 1px solid #30363d;
+    color: #c9d1d9;
+    border-radius: 4px;
+    padding: 4px 10px;
+    cursor: pointer;
+    font-size: 12px;
+    font-family: inherit;
+  }
+  .bar-btn:hover { background: #30363d; }
+  .bar-btn:disabled { opacity: 0.3; cursor: default; }
+  .bar-btn:disabled:hover { background: #21262d; }
+  .bar-btn.active { background: #30363d; border-color: #58a6ff; }
+  #actions { display: flex; gap: 4px; align-items: center; }
+  #actions button {
+    background: none;
+    border: 1px solid #30363d;
+    color: #8b949e;
+    border-radius: 4px;
+    padding: 4px 8px;
+    cursor: pointer;
+    font-size: 11px;
+    font-family: inherit;
+  }
+  #actions button:hover { color: #c9d1d9; border-color: #58a6ff; }
+  #status {
+    width: 8px; height: 8px;
+    border-radius: 50%;
+    background: #f85149;
+    flex-shrink: 0;
+  }
+  #status.connected { background: #3fb950; }
+  .waiting {
+    color: #484f58;
+    font-size: 14px;
+    text-align: center;
+  }
+  .waiting .hint { font-size: 12px; margin-top: 8px; color: #30363d; }
+  #shortcuts {
+    display: none;
+    position: fixed;
+    top: 50%;
+    left: 50%;
+    transform: translate(-50%, -50%);
+    background: #161b22;
+    border: 1px solid #30363d;
+    border-radius: 8px;
+    padding: 20px 24px;
+    z-index: 20;
+    font-size: 12px;
+    min-width: 220px;
+  }
+  #shortcuts.open { display: block; }
+  #shortcuts h3 { font-size: 13px; margin-bottom: 12px; color: #c9d1d9; }
+  .shortcut-row { display: flex; justify-content: space-between; padding: 4px 0; }
+  .shortcut-row kbd {
+    background: #21262d;
+    border: 1px solid #30363d;
+    border-radius: 3px;
+    padding: 1px 6px;
+    font-family: inherit;
+    font-size: 11px;
+    color: #c9d1d9;
+  }
+  .shortcut-row span { color: #8b949e; }
+  #overlay {
+    display: none;
+    position: fixed;
+    inset: 0;
+    background: rgba(0,0,0,0.5);
+    z-index: 15;
+  }
+  #overlay.open { display: block; }
+</style>
+</head>
+<body>
+<div id="sidebar">
+  <div id="sidebar-header">
+    <span>History</span>
+    <button onclick="toggleHistory()">&times;</button>
+  </div>
+  <div id="history-list"></div>
+</div>
+<div id="main">
+  <div id="vis">
+    <div class="waiting">
+      <div>waiting for plots...</div>
+      <div class="hint">create a plot in ggterm and it will appear here</div>
+    </div>
+  </div>
+  <div id="bar">
+    <div id="status"></div>
+    <div id="meta">
+      <span id="plot-id"></span>
+      <span id="plot-desc"></span>
+      <span id="plot-time"></span>
+    </div>
+    <div id="nav">
+      <button id="hist-btn" class="bar-btn" onclick="toggleHistory()" title="History (h)">H</button>
+      <button id="prev" class="bar-btn" disabled title="Previous plot (&larr;)">&larr;</button>
+      <button id="next" class="bar-btn" disabled title="Next plot (&rarr;)">&rarr;</button>
+    </div>
+    <div id="actions">
+      <button onclick="downloadSVG()" title="Download SVG (s)">SVG</button>
+      <button onclick="downloadPNG()" title="Download PNG (p)">PNG</button>
+      <button onclick="toggleShortcuts()" title="Keyboard shortcuts (?)">?</button>
+    </div>
+  </div>
+</div>
+<div id="overlay" onclick="closeOverlays()"></div>
+<div id="shortcuts">
+  <h3>Keyboard Shortcuts</h3>
+  <div class="shortcut-row"><span>Previous plot</span><kbd>&larr;</kbd></div>
+  <div class="shortcut-row"><span>Next plot</span><kbd>&rarr;</kbd></div>
+  <div class="shortcut-row"><span>Latest plot</span><kbd>End</kbd></div>
+  <div class="shortcut-row"><span>First plot</span><kbd>Home</kbd></div>
+  <div class="shortcut-row"><span>Toggle history</span><kbd>h</kbd></div>
+  <div class="shortcut-row"><span>Download SVG</span><kbd>s</kbd></div>
+  <div class="shortcut-row"><span>Download PNG</span><kbd>p</kbd></div>
+  <div class="shortcut-row"><span>Fullscreen</span><kbd>f</kbd></div>
+  <div class="shortcut-row"><span>Show shortcuts</span><kbd>?</kbd></div>
+  <div class="shortcut-row"><span>Close panel</span><kbd>Esc</kbd></div>
+</div>
+<script>
+const vis = document.getElementById('vis');
+const main = document.getElementById('main');
+const statusEl = document.getElementById('status');
+const idEl = document.getElementById('plot-id');
+const descEl = document.getElementById('plot-desc');
+const timeEl = document.getElementById('plot-time');
+const prevBtn = document.getElementById('prev');
+const nextBtn = document.getElementById('next');
+const histBtn = document.getElementById('hist-btn');
+const sidebar = document.getElementById('sidebar');
+const historyList = document.getElementById('history-list');
+const shortcutsEl = document.getElementById('shortcuts');
+const overlayEl = document.getElementById('overlay');
+
+let history = [];
+let historyIndex = {};
+let currentIdx = -1;
+let view = null;
+let ws = null;
+
+function updateMeta(prov) {
+  if (!prov) return;
+  idEl.textContent = prov.id;
+  descEl.textContent = prov.description || '';
+  timeEl.textContent = prov.timestamp ? new Date(prov.timestamp).toLocaleTimeString() : '';
+}
+
+function updateNav() {
+  prevBtn.disabled = currentIdx <= 0;
+  nextBtn.disabled = currentIdx >= history.length - 1;
+}
+
+function updateHistoryHighlight() {
+  historyList.querySelectorAll('.history-item').forEach((el, i) => {
+    el.classList.toggle('active', i === currentIdx);
+  });
+  const active = historyList.querySelector('.active');
+  if (active) active.scrollIntoView({ block: 'nearest' });
+}
+
+function addHistoryItem(data, idx) {
+  const prov = data.provenance;
+  if (!prov) return;
+  const div = document.createElement('div');
+  div.className = 'history-item' + (idx === currentIdx ? ' active' : '');
+  div.innerHTML =
+    '<div class="hi-id">' + prov.id + '</div>' +
+    '<div class="hi-desc">' + (prov.description || '') + '</div>' +
+    '<div class="hi-meta">' +
+      '<span class="hi-geom">' + (prov.geomTypes ? prov.geomTypes.join('+') : '') + '</span>' +
+      '<span>' + (prov.timestamp ? new Date(prov.timestamp).toLocaleTimeString() : '') + '</span>' +
+    '</div>';
+  div.onclick = () => navigate(idx);
+  historyList.appendChild(div);
+}
+
+function rebuildHistoryList() {
+  historyList.innerHTML = '';
+  history.forEach((data, i) => addHistoryItem(data, i));
+}
+
+const embedOpts = {
+  actions: false,
+  theme: 'dark',
+  renderer: 'svg',
+  config: {
+    background: '#0d1117',
+    axis: { domainColor: '#30363d', gridColor: '#21262d', tickColor: '#30363d', labelColor: '#8b949e', titleColor: '#c9d1d9' },
+    legend: { labelColor: '#c9d1d9', titleColor: '#c9d1d9' },
+    title: { color: '#c9d1d9', subtitleColor: '#8b949e' },
+    view: { stroke: null }
+  }
+};
+
+async function renderSpec(spec) {
+  vis.innerHTML = '';
+  const vegaSpec = { ...spec, width: 'container', height: 'container', autosize: { type: 'fit', contains: 'padding' } };
+  try {
+    const result = await vegaEmbed(vis, vegaSpec, embedOpts);
+    view = result.view;
+  } catch (e) {
+    // Retry without interactive params (composite marks like boxplot don't support selections)
+    console.warn('Render failed, retrying without params:', e.message);
+    const { params, ...cleanSpec } = vegaSpec;
+    const result = await vegaEmbed(vis, cleanSpec, embedOpts);
+    view = result.view;
+  }
+}
+
+async function showPlot(data) {
+  await renderSpec(data.spec);
+  updateMeta(data.provenance);
+}
+
+function navigate(idx) {
+  if (idx < 0 || idx >= history.length) return;
+  currentIdx = idx;
+  const data = history[idx];
+  if (data.spec) {
+    showPlot(data);
+  } else {
+    // Lazy-load full spec from server
+    fetch('/api/plot/' + data.provenance.id)
+      .then(r => r.json())
+      .then(full => {
+        history[idx] = full;
+        showPlot(full);
+      });
+  }
+  updateNav();
+  updateHistoryHighlight();
+}
+
+prevBtn.onclick = () => navigate(currentIdx - 1);
+nextBtn.onclick = () => navigate(currentIdx + 1);
+
+function toggleHistory() {
+  const open = sidebar.classList.toggle('open');
+  histBtn.classList.toggle('active', open);
+}
+
+function toggleShortcuts() {
+  const open = shortcutsEl.classList.toggle('open');
+  overlayEl.classList.toggle('open', open);
+}
+
+function closeOverlays() {
+  shortcutsEl.classList.remove('open');
+  overlayEl.classList.remove('open');
+}
+
+document.addEventListener('keydown', (e) => {
+  // Ignore when typing in an input
+  if (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA') return;
+
+  switch (e.key) {
+    case 'ArrowLeft': navigate(currentIdx - 1); break;
+    case 'ArrowRight': navigate(currentIdx + 1); break;
+    case 'Home': e.preventDefault(); navigate(0); break;
+    case 'End': e.preventDefault(); navigate(history.length - 1); break;
+    case 'h': toggleHistory(); break;
+    case 's': downloadSVG(); break;
+    case 'p': downloadPNG(); break;
+    case 'f':
+      if (!document.fullscreenElement) {
+        document.documentElement.requestFullscreen();
+      } else {
+        document.exitFullscreen();
+      }
+      break;
+    case '?': toggleShortcuts(); break;
+    case 'Escape': closeOverlays(); if (sidebar.classList.contains('open')) toggleHistory(); break;
+  }
+});
+
+function downloadSVG() {
+  if (!view) return;
+  view.toSVG().then(svg => {
+    const a = document.createElement('a');
+    a.href = URL.createObjectURL(new Blob([svg], { type: 'image/svg+xml' }));
+    a.download = (idEl.textContent || 'plot') + '.svg';
+    a.click();
+  });
+}
+
+function downloadPNG() {
+  if (!view) return;
+  view.toCanvas(2).then(canvas => {
+    const a = document.createElement('a');
+    a.href = canvas.toDataURL('image/png');
+    a.download = (idEl.textContent || 'plot') + '.png';
+    a.click();
+  });
+}
+
+function connect() {
+  const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
+  ws = new WebSocket(proto + '//' + location.host + '/ws');
+
+  ws.onopen = () => { statusEl.classList.add('connected'); };
+  ws.onclose = () => {
+    statusEl.classList.remove('connected');
+    setTimeout(connect, 2000);
+  };
+  ws.onerror = () => ws.close();
+
+  ws.onmessage = (e) => {
+    const data = JSON.parse(e.data);
+    if (data.type === 'plot') {
+      history.push(data);
+      currentIdx = history.length - 1;
+      addHistoryItem(data, history.length - 1);
+      showPlot(data);
+      updateNav();
+      updateHistoryHighlight();
+    }
+  };
+}
+
+// Load initial history then connect
+fetch('/api/history')
+  .then(r => r.json())
+  .then(entries => {
+    // Populate history with provenance-only stubs (lazy-load specs on navigate)
+    history = entries.map(e => ({ provenance: e, spec: null }));
+    rebuildHistoryList();
+  })
+  .then(() => connect());
+</script>
+</body>
+</html>`;
+var init_serve = __esm(() => {
+  init_history();
+  init_export();
+  COMPOSITE_MARKS = new Set(["boxplot", "violin", "errorband", "errorbar"]);
+});
+
+// src/cli-plot.ts
+init_src();
+init_history();
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync4, existsSync as existsSync3 } from "fs";
+import { join as join4 } from "path";
 
 // src/init.ts
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, readFileSync as readFileSync2, existsSync as existsSync2, readdirSync as readdirSync2, statSync } from "fs";
@@ -15194,6 +15859,18 @@ function handleInit() {
 }
 
 // src/cli-plot.ts
+function isServeRunning() {
+  const markerPath = join4(getGGTermDir(), "serve.json");
+  if (!existsSync3(markerPath))
+    return false;
+  try {
+    const info = JSON.parse(readFileSync3(markerPath, "utf-8"));
+    process.kill(info.pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
 var GEOM_TYPES = [
   "point",
   "line",
@@ -16043,15 +16720,22 @@ If you want a univariate plot, try: histogram, density, bar, qq, or freqpoly`);
   if (facetVar && facetVar !== "-") {
     plot = plot.facet(facet_wrap(facetVar));
   }
-  console.log(plot.render({ width: 70, height: 20, colorMode: "truecolor" }));
+  const serveActive = isServeRunning();
+  if (!serveActive) {
+    console.log(plot.render({ width: 70, height: 20, colorMode: "truecolor" }));
+  }
   const spec = plot.spec();
   const commandStr = `cli-plot.ts ${args.join(" ")}`;
   const plotId = savePlotToHistory(spec, {
     dataFile,
     command: commandStr
   });
-  console.log(`
+  if (serveActive) {
+    console.log(`[${plotId}] → live viewer`);
+  } else {
+    console.log(`
 [Saved as ${plotId}]`);
+  }
 }
 function handleHistory(searchQuery) {
   const entries = searchQuery ? searchHistory(searchQuery) : getHistory();
@@ -16130,7 +16814,7 @@ function handleExport(idOrFile, outputFile) {
   const spec = plotSpecToVegaLite2(plotSpec, {
     interactive: true
   });
-  writeFileSync3(join3(getGGTermDir(), "last-plot-vegalite.json"), JSON.stringify(spec, null, 2));
+  writeFileSync4(join4(getGGTermDir(), "last-plot-vegalite.json"), JSON.stringify(spec, null, 2));
   const title = typeof spec.title === "string" ? spec.title : spec.title?.text || "Plot";
   const output = outputFile || `${plotId}.html`;
   const html = `<!DOCTYPE html>
@@ -16187,7 +16871,7 @@ function handleExport(idOrFile, outputFile) {
   </script>
 </body>
 </html>`;
-  writeFileSync3(output, html);
+  writeFileSync4(output, html);
   console.log(`Created ${output} - open in browser to view and export`);
 }
 function printUsage() {
@@ -16201,6 +16885,7 @@ Commands:
   history [search]                            List all plots (optionally filter by search)
   show <id>                                   Re-render a plot from history
   export [id] [output.html]                   Export plot to HTML (latest or by ID)
+  serve [port]                                Start live plot viewer (default: 4242)
   <file> <x> <y> [color] [title] [geom] [facet]   Create a plot
 
 Supported formats: CSV, JSON, JSONL (auto-detected by extension)
@@ -16225,6 +16910,8 @@ Examples:
   ggterm-plot history
   ggterm-plot show 2024-01-26-001
   ggterm-plot export 2024-01-26-001 figure.html
+  ggterm-plot serve                           # Start live plot viewer
+  ggterm-plot serve 8080                      # Custom port
 `);
 }
 var args = process.argv.slice(2);
@@ -16257,6 +16944,10 @@ if (command === "init") {
   handleShow(args[1]);
 } else if (command === "export") {
   handleExport(args[1], args[2]);
+} else if (command === "serve") {
+  Promise.resolve().then(() => (init_serve(), exports_serve)).then(({ handleServe: handleServe2 }) => {
+    handleServe2(args[1] ? parseInt(args[1]) : undefined);
+  });
 } else if (command === "help" || command === "--help" || command === "-h") {
   printUsage();
 } else {

package/dist/cli.js

@@ -3708,7 +3708,7 @@ function renderGeomVolcano(data, geom, aes, scales, canvas) {
   }
   if (nLabels > 0 && aes.label) {
     const significantPoints = points.filter((p) => p.status !== "ns" && p.label).sort((a, b) => b.significance - a.significance).slice(0, nLabels);
-    const labelColor = { r: 50, g: 50, b: 50, a: 1 };
+    const labelColor = { r: 255, g: 255, b: 255, a: 1 };
     for (const point of significantPoints) {
       const cx = Math.round(scales.x.map(point.x));
       const cy = Math.round(scales.y.map(point.y));
@@ -4486,6 +4486,16 @@ function renderGeomForest(data, geom, aes, scales, canvas) {
     canvas.drawChar(x2, y, "┤", ciColor);
     const px = Math.round(mapX(row.estimate));
     canvas.drawChar(px, y, pointChar, pointColor);
+    const label = row.study;
+    const labelColor = { r: 200, g: 200, b: 200, a: 1 };
+    const labelEnd = plotLeft - 1;
+    const labelStart = labelEnd - label.length;
+    for (let c = 0;c < label.length; c++) {
+      const charX = labelStart + c;
+      if (charX >= 0) {
+        canvas.drawChar(charX, y, label[c], labelColor);
+      }
+    }
   }
 }
 function renderGeomRoc(data, geom, aes, scales, canvas) {
@@ -7907,11 +7917,23 @@ function calculateLayout(spec, options) {
   } else if (hasY2) {
     rightMargin = 8 + (hasY2Label ? 2 : 0);
   }
+  let forestLabelWidth = 0;
+  const isForestPlot = spec.geoms.some((g) => g.type === "forest");
+  if (isForestPlot && Array.isArray(spec.data) && spec.data.length > 0) {
+    const yField = typeof spec.aes.y === "string" ? spec.aes.y : "study";
+    for (const row of spec.data) {
+      const label = String(row[yField] ?? "");
+      if (label.length > forestLabelWidth)
+        forestLabelWidth = label.length;
+    }
+  }
+  const defaultLeft = 8 + (hasYLabel ? 2 : 0);
+  const neededLeft = forestLabelWidth > 0 ? forestLabelWidth + 2 : defaultLeft;
   const margins = {
     top: hasTitle ? 2 : 1,
     right: rightMargin,
     bottom: 2 + (hasXLabel ? 1 : 0) + (hasLegend && legendPosition === "bottom" ? 2 : 0),
-    left: 8 + (hasYLabel ? 2 : 0)
+    left: Math.max(defaultLeft, neededLeft)
   };
   const plotArea = {
     x: margins.left,
@@ -8125,7 +8147,9 @@ function renderToCanvas(spec, options) {
     renderTitle(canvas, spec.labels.title, layout.width, spec.theme);
   }
   renderGridLines(canvas, scales, layout.plotArea, spec.theme);
-  renderAxes(canvas, scales, layout.plotArea, spec.labels, spec.theme);
+  const isForest = spec.geoms.some((g) => g.type === "forest");
+  const axisLabels = isForest ? { ...spec.labels, y: undefined } : spec.labels;
+  renderAxes(canvas, scales, layout.plotArea, axisLabels, spec.theme);
   for (const geom of spec.geoms) {
     let geomData;
     let geomAes = spec.aes;

package/dist/index.js

@@ -3707,7 +3707,7 @@ function renderGeomVolcano(data, geom, aes, scales, canvas) {
   }
   if (nLabels > 0 && aes.label) {
     const significantPoints = points.filter((p) => p.status !== "ns" && p.label).sort((a, b) => b.significance - a.significance).slice(0, nLabels);
-    const labelColor = { r: 50, g: 50, b: 50, a: 1 };
+    const labelColor = { r: 255, g: 255, b: 255, a: 1 };
     for (const point of significantPoints) {
       const cx = Math.round(scales.x.map(point.x));
       const cy = Math.round(scales.y.map(point.y));
@@ -4485,6 +4485,16 @@ function renderGeomForest(data, geom, aes, scales, canvas) {
     canvas.drawChar(x2, y, "┤", ciColor);
     const px = Math.round(mapX(row.estimate));
     canvas.drawChar(px, y, pointChar, pointColor);
+    const label = row.study;
+    const labelColor = { r: 200, g: 200, b: 200, a: 1 };
+    const labelEnd = plotLeft - 1;
+    const labelStart = labelEnd - label.length;
+    for (let c = 0;c < label.length; c++) {
+      const charX = labelStart + c;
+      if (charX >= 0) {
+        canvas.drawChar(charX, y, label[c], labelColor);
+      }
+    }
   }
 }
 function renderGeomRoc(data, geom, aes, scales, canvas) {
@@ -7906,11 +7916,23 @@ function calculateLayout(spec, options) {
   } else if (hasY2) {
     rightMargin = 8 + (hasY2Label ? 2 : 0);
   }
+  let forestLabelWidth = 0;
+  const isForestPlot = spec.geoms.some((g) => g.type === "forest");
+  if (isForestPlot && Array.isArray(spec.data) && spec.data.length > 0) {
+    const yField = typeof spec.aes.y === "string" ? spec.aes.y : "study";
+    for (const row of spec.data) {
+      const label = String(row[yField] ?? "");
+      if (label.length > forestLabelWidth)
+        forestLabelWidth = label.length;
+    }
+  }
+  const defaultLeft = 8 + (hasYLabel ? 2 : 0);
+  const neededLeft = forestLabelWidth > 0 ? forestLabelWidth + 2 : defaultLeft;
   const margins = {
     top: hasTitle ? 2 : 1,
     right: rightMargin,
     bottom: 2 + (hasXLabel ? 1 : 0) + (hasLegend && legendPosition === "bottom" ? 2 : 0),
-    left: 8 + (hasYLabel ? 2 : 0)
+    left: Math.max(defaultLeft, neededLeft)
   };
   const plotArea = {
     x: margins.left,
@@ -8124,7 +8146,9 @@ function renderToCanvas(spec, options) {
     renderTitle(canvas, spec.labels.title, layout.width, spec.theme);
   }
   renderGridLines(canvas, scales, layout.plotArea, spec.theme);
-  renderAxes(canvas, scales, layout.plotArea, spec.labels, spec.theme);
+  const isForest = spec.geoms.some((g) => g.type === "forest");
+  const axisLabels = isForest ? { ...spec.labels, y: undefined } : spec.labels;
+  renderAxes(canvas, scales, layout.plotArea, axisLabels, spec.theme);
   for (const geom of spec.geoms) {
     let geomData;
     let geomAes = spec.aes;

package/dist/pipeline/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA6C,QAAQ,EAAE,aAAa,EAAQ,MAAM,UAAU,CAAA;AACxG,OAAO,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAA;AAmB/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,QAAQ,EAAE;QACR,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,UAAU,CAAC,EAAE;QACX,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,UAAU,CAgEZ;AAwJD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,cAAc,CA+MhB;AAwcD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,MAAM,CASR"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA6C,QAAQ,EAAE,aAAa,EAAQ,MAAM,UAAU,CAAA;AACxG,OAAO,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAA;AAmB/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,QAAQ,EAAE;QACR,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,UAAU,CAAC,EAAE;QACX,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,UAAU,CA8EZ;AAwJD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,cAAc,CAmNhB;AAwcD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,MAAM,CASR"}

package/dist/pipeline/render-geoms.d.ts.map

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

package/dist/serve.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Live plot viewer server
+ *
+ * Watches .ggterm/plots/ for new plots and pushes them to connected
+ * browsers via WebSocket. Renders interactive Vega-Lite in a dark-themed page.
+ *
+ * Uses node:http and a minimal WebSocket implementation for Node.js compatibility.
+ */
+export declare function handleServe(port?: number): void;
+//# sourceMappingURL=serve.d.ts.map

package/dist/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6gBH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CA2I/C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggterm/core",
-  "version": "0.2.20",
+  "version": "0.3.1",
   "description": "Grammar of Graphics engine for terminals",
   "type": "module",
   "main": "./dist/index.js",