pindeck 3.1.0-beta.1 → 3.2.0

package/lib/pdf.mjs

@@ -25,8 +25,24 @@ export const PDF_HEAD_TAG = `<script>window.requestAnimationFrame = function (cb
 export const PDF_PAGE_TAG = `<style>@media print { * { -webkit-print-color-adjust: exact !important; print-color-adjust: exact !important; } }</style>
 </body>`;
 
+// Chrome refuses to run as root with its sandbox (containers, some servers); it says so, and needs --no-sandbox.
+// Without --disable-field-trial-config a headless Chrome can wait forever for its field-trial setup (seen
+// behind a proxy); PinDeck needs none of those experiments.
+export const ROOT_ARGS = ["--disable-field-trial-config", ...(process.getuid?.() === 0 ? ["--no-sandbox"] : [])];
 const BASE = ["--headless=new", "--disable-gpu", "--no-first-run", "--no-default-browser-check",
-  "--disable-extensions", "--mute-audio", "--hide-scrollbars"];
+  "--disable-extensions", "--mute-audio", "--hide-scrollbars", ...ROOT_ARGS];
+
+/* Why Chrome stopped, from what it printed: its last error line (such as "Running as root without
+   --no-sandbox is not supported"), without the log prefix. "" if it said nothing useful. */
+export function chromeReason(stderr) {
+  // Chrome logs much that is harmless (display links, D-Bus, GPU, fonts): a fatal line first, then a plain reason
+  const noise = /CVDisplayLink|dbus|gcm|fontconfig|gpu|viz|gles|egl|vaapi|sandbox_linux|ssl_client_socket/i;
+  const lines = String(stderr).split("\n").filter((l) => l.trim() && !noise.test(l)).reverse();
+  const clean = (l) => l.replace(/^\[[^\]]*\]\s*/, "").trim().slice(0, 300);
+  const fatal = lines.find((l) => /:FATAL:/.test(l)), plain = lines.find((l) => /not supported|cannot|denied|no such|error/i.test(l));
+  return fatal ? clean(fatal) : plain ? clean(plain) : "";
+}
+const exited = (what, err) => new Error(`${what}${chromeReason(err) ? `: ${chromeReason(err)}` : "."}`);
 
 /* Runs Chrome with args, stops it once done(stdout, stderr) is true (Chrome often lingers). */
 function chromeRun(chrome, args, profile, done, timeout) {
@@ -47,7 +63,7 @@ function chromeRun(chrome, args, profile, done, timeout) {
     proc.stderr.on("data", (d) => { err += d; check(); });
     proc.on("error", (e) => finish(e));
     // "close", not "exit": at exit Chrome's last output (the line saying the file is written) may still be unread
-    proc.on("close", () => (done(out, err) ? finish(null, out) : finish(new Error("Chrome exited early."))));
+    proc.on("close", () => (done(out, err) ? finish(null, out) : finish(exited("Chrome exited early", err))));
   });
 }
 

package/lib/platform-notice.mjs

@@ -4,8 +4,8 @@ export function createPlatformNoticeServer(platform) {
   const windows = platform === 'win32';
   const heading = windows ? 'Windows support is on the roadmap' : 'PinDeck runs on macOS and Linux';
   const explanation = windows
-    ? 'PinDeck runs on macOS and, as a beta, on Linux. Windows support is planned for a future version; there is no release date yet.'
-    : 'This version of PinDeck runs on macOS and, as a beta, on Linux. This operating system is not supported.';
+    ? 'PinDeck runs on macOS and Linux. Windows support is planned for a future version; there is no release date yet.'
+    : 'This version of PinDeck runs on macOS and Linux. This operating system is not supported.';
   const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>PinDeck · system not supported</title><style>
   :root{font-family:system-ui,sans-serif;color:#243348;background:#f4f6f8;color-scheme:light}*{box-sizing:border-box}body{margin:0;min-height:100vh;display:grid;place-items:center;padding:24px}main{width:min(100%,620px);padding:40px;background:white;border:1px solid #dde3ea;border-radius:18px;box-shadow:0 12px 40px #20334d0a}.brand{font-weight:700;color:#c36516;margin:0 0 32px}h1{font-size:clamp(26px,5vw,36px);line-height:1.2;margin:0 0 20px}p{line-height:1.65}a{color:#945012}footer{margin-top:28px;font-size:14px;color:#596577}
   </style></head><body><main><p class="brand">PinDeck</p><h1>${heading}</h1><p>${explanation}</p><p>Your deck has not been opened or changed, and no AI backend has been started.</p><p>You can run PinDeck on a Mac or a Linux machine (and use it from this browser through an SSH tunnel), or follow updates on <a href="https://github.com/ehabets/PinDeck">GitHub</a>.</p><footer>Close this tab and press Ctrl+C in the terminal to stop this notice.</footer></main></body></html>`;

package/lib/servers.mjs

@@ -0,0 +1,91 @@
+/* The PinDecks running for this user, and which one serves a deck: shared by the front, the deck server,
+   `pindeck login` and cli.mjs.
+
+   Each PinDeck process (a front, a deck server on its own, or one behind a front) keeps a file of its own in
+   ~/.pindeck-v3/servers/<pid>.json (0600, in a 0700 folder) with its address and token. Several fronts and
+   servers can run side by side (another --port, another PINDECK_HOME user, a server started on its own) and
+   none overwrites another's file; a file whose process is gone is removed when it is read. */
+
+import fs from "node:fs";
+import path from "node:path";
+
+const dirOf = (home) => path.join(home, "servers");
+export const alive = (pid) => { try { process.kill(pid, 0); return true; } catch (e) { return e.code === "EPERM"; } };
+
+/* info: { url, token, front?, key?, deckDir?, behindFront? }. Returns the function that removes the file again
+   (only if it is still ours). */
+export function registerServer(home, info) {
+  const dir = dirOf(home);
+  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+  // written whole and private from the start: a reader (pindeck login, cli.mjs) never sees half of it
+  const file = path.join(dir, `${process.pid}.json`), tmp = path.join(dir, `.${process.pid}.json.tmp`);
+  fs.writeFileSync(tmp, JSON.stringify({ ...info, pid: process.pid }, null, 2), { mode: 0o600 });
+  fs.chmodSync(tmp, 0o600);
+  fs.renameSync(tmp, file);
+  return () => { try { if (JSON.parse(fs.readFileSync(file, "utf8")).token === info.token) fs.rmSync(file, { force: true }); } catch {} };
+}
+
+/* The running ones, the newest first */
+export function runningServers(home) {
+  let names = [];
+  try { names = fs.readdirSync(dirOf(home)).filter((f) => /^\d+\.json$/.test(f)); } catch {}
+  const out = [];
+  for (const name of names) {
+    const file = path.join(dirOf(home), name);
+    try {
+      const info = JSON.parse(fs.readFileSync(file, "utf8"));
+      if (alive(info.pid)) { out.push({ ...info, since: fs.statSync(file).mtimeMs }); continue; }
+    } catch {}
+    try { fs.rmSync(file, { force: true }); } catch {}
+  }
+  return out.sort((a, b) => b.since - a.since);
+}
+
+const ask = async (s, p) => {
+  const res = await fetch(`${s.url}${p}`, { headers: { "x-editor-token": s.token }, signal: AbortSignal.timeout(5000) });
+  if (!res.ok) throw new Error(String(res.status));
+  return res.json();
+};
+
+const real = (p) => { try { return fs.realpathSync(p); } catch { return path.resolve(p); } };
+
+/* Who serves a deck (a deckTarget): { front, key } a front whose deck list has it (open or not), under that
+   front's key for it, and/or { own } its deck server if one runs (on its own, or behind a front). Decks are
+   compared by real path: the same folder can be named through a symlink (on macOS a terminal in /var/... is
+   in /private/var/...). null: no running PinDeck serves it. */
+export async function serverFor(home, deck) {
+  const all = runningServers(home), file = real(path.join(deck.dir, deck.file));
+  const own = all.find((s) => !s.front && (s.key === deck.key || real(path.join(s.deckDir, s.deckFile || "index.html")) === file)) || null;
+  for (const f of all.filter((s) => s.front)) {
+    try {
+      const { decks } = await ask(f, "/api/decks");
+      const d = decks.find((x) => !x.problem && (x.key === deck.key || real(path.join(x.root, x.rel)) === file));
+      if (d) return { front: f, key: d.key, own };
+    } catch {}
+  }
+  return own ? { front: null, key: own.key, own } : null;
+}
+
+/* pindeck login [deck]: a new one-time login link, from the PinDeck that serves the deck (the link then opens
+   it), or from each PinDeck running when no deck is named. Prints and exits. */
+export async function printLogin(home, deck) {
+  let targets;
+  if (deck) {
+    const found = await serverFor(home, deck);
+    const shown = path.join(deck.dir, deck.file);
+    if (!found || (!found.front && found.own.behindFront)) {
+      console.error(`No running PinDeck serves ${shown}.` + (runningServers(home).length ? " Open it from a running PinDeck's deck menu, or start PinDeck for it." : ""));
+      process.exit(1);
+    }
+    targets = [found.front ? { s: found.front, next: `/d/${found.key}/`, label: shown } : { s: found.own, next: "/", label: shown }];
+  } else {
+    targets = runningServers(home).filter((s) => !s.behindFront).map((s) => ({ s, next: "/", label: s.deckDir }));
+    if (!targets.length) { console.error("No PinDeck is running."); process.exit(1); }
+  }
+  let ok = true;
+  for (const { s, next, label } of targets) {
+    try { console.log(`PinDeck (${label}): ${(await ask(s, "/api/login-link?" + new URLSearchParams({ next }))).url}`); }
+    catch { ok = false; console.error(`The PinDeck at ${s.url} (${label}) does not answer. Is it still running?`); }
+  }
+  process.exit(ok ? 0 : 1);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pindeck",
-  "version": "3.1.0-beta.1",
-  "description": "PinDeck: an editor for HTML slide decks on macOS, and on Linux (beta) through an SSH tunnel. Pin elements, describe the change, and Claude Code or OpenAI Codex edits the slides.",
+  "version": "3.2.0",
+  "description": "PinDeck: an editor for HTML slide decks on macOS, and on Linux through an SSH tunnel. Pin elements, describe the change, and Claude Code or OpenAI Codex edits the slides.",
   "keywords": [
     "slides",
     "presentation",

package/public/bridge.js

@@ -19,7 +19,17 @@
   const SLIDE_SEL = deckMeta("slides") || null;
   const SLIDE = SLIDE_SEL ? `:is(${SLIDE_SEL})` : ".reveal .slides section";   // in CSS and closest()
   const SLIDE_OF = SLIDE_SEL || "section";   // the slide an element is on
-  const host = () => (window.parent !== window ? window.parent.__editorHost : null);
+  /* The editor, reached by messages: the deck runs sandboxed in an origin of its own (see VIEW in server.mjs),
+     so it cannot touch the editor page. Every call answers with a promise of the editor's return value. */
+  const PARENT = window.parent !== window ? window.parent : null;
+  let callSeq = 0;
+  const answers = new Map();   // id -> resolve
+  const hostCalls = new Proxy({}, { get: (_, method) => method === "then" ? undefined : (...args) => new Promise((resolve) => {
+    const id = ++callSeq;
+    answers.set(id, resolve);
+    PARENT.postMessage({ pindeck: "host", id, method, args }, "*");
+  }) });
+  const host = () => (PARENT ? hostCalls : null);
   let W = 1280, H = 720, deck = null;   // deck: reveal.js or a selector deck (see "Decks" below)
 
   /* ---- Styles for editor-only overlays ---------------------------------------- */
@@ -128,7 +138,8 @@
       hasFooter: !!sec.querySelector(".slide-foot"), hidden };
   }
   function info() {
-    return { slides: slides().map((s, i) => slideInfo(s, i)), current: indexOf(deck.current()) };
+    // hash: the slide's address in the deck opened on its own (Present), where hidden slides are left out
+    return { slides: slides().map((s, i) => ({ ...slideInfo(s, i), hash: deck.hash(i) })), current: indexOf(deck.current()) };
   }
 
   /* ---- Layout measurement ------------------------------------------------------------- */
@@ -801,12 +812,22 @@
     tail.setStart(r.startContainer, r.startOffset);
     const subList = [...el.children].find((c) => c.tagName === "UL" || c.tagName === "OL");
     if (subList) tail.setEndBefore(subList); else tail.setEnd(el, el.childNodes.length);
+    // the elements the caret is in (an equation, a <strong>): the split cuts each in two, and extractContents
+    // copies them, attributes and all, into the new bullet
+    const cut = [];
+    for (let n = r.startContainer; n && n !== el; n = n.parentNode) if (n.nodeType === 1) cut.unshift(n);
     const frag = tail.extractContents();
     const li = document.createElement("li");
     const cls = [...el.classList].filter((c) => !c.startsWith("__") && c !== "visible" && c !== "current-fragment").join(" ");
     if (cls) li.className = cls;
     li.appendChild(frag);
     el.after(li);
+    // their copies: no id of their own (the server gives new ones), and gone where the split left them
+    // empty, on either side (no empty <strong> or equation line left behind)
+    const copies = [];
+    for (let n = li.firstChild, i = 0; i < cut.length && n?.nodeType === 1 && n.tagName === cut[i].tagName; n = n.firstChild, i++) copies.push(n);
+    for (const n of copies) n.removeAttribute("data-eid");
+    for (const n of [...cut, ...copies].reverse()) if (n.isConnected && isBlank(n)) n.remove();
     // no stray spaces at the split
     const trim = (node, end) => {
       const w = document.createTreeWalker(node, NodeFilter.SHOW_TEXT);
@@ -825,8 +846,10 @@
     teardownEdit(ed);
     host()?.editingChanged(false);
     chainDirty = true;
-    host()?.commitSplit({ eid: ed.eid, html, newHtml, newEid, cls, text: textOf(el).slice(0, 200) },
-      (real) => { if (real && real !== newEid) li.dataset.eid = real; });
+    // whole: the bullet's text as typed, offered to copy if the save is refused
+    host()?.commitSplit({ eid: ed.eid, html, newHtml, newEid, cls, text: textOf(el).slice(0, 200),
+      whole: [textOf(el), textOf(li)].filter((t) => t.trim()).join(" ") })
+      .then((real) => { if (real && real !== newEid) li.dataset.eid = real; });
     startEdit({ el: li, sec: ed.sec, eid: newEid, path: [], isNew: true }, null, null, { src: newHtml, caret: "start" });
   }
 
@@ -853,7 +876,19 @@
       slides: () => Reveal.getSlides(),
       current: () => Reveal.getCurrentSlide(),
       goto(index) { if (Reveal.getSlides()[index]) { const i = ix(index); Reveal.slide(i.h, i.v); } },
-      hash(index) { const i = ix(index); return `#/${i.h}${i.v ? "/" + i.v : ""}`; },
+      // counted without hidden slides, which the deck opened on its own leaves out (the editor shows them);
+      // a hidden slide opens at the next one shown
+      hash(index) {
+        const all = Reveal.getSlides(), shown = (s) => s.getAttribute("data-visibility") !== "hidden" &&
+          s.parentElement?.closest("section")?.getAttribute("data-visibility") !== "hidden";
+        const sec = [...all.slice(index), ...all.slice(0, index).reverse()].find(shown);
+        if (!sec) return "";
+        const stack = sec.parentElement.closest("section");
+        const sections = (el) => [...el.children].filter((c) => c.tagName === "SECTION" && shown(c));
+        const h = sections(Reveal.getSlidesElement()).indexOf(stack || sec);
+        const v = stack ? sections(stack).indexOf(sec) : 0;
+        return `#/${h}${v ? "/" + v : ""}`;
+      },
       size: () => ({ width: Reveal.getConfig().width, height: Reveal.getConfig().height }),
       scale: () => Reveal.getScale() || 1,
       on: (ev, fn) => Reveal.on(ev === "slide" ? "slidechanged" : ev, fn),
@@ -1060,7 +1095,16 @@
         return measureSection(slides()[index]);
       },
     };
-    window.__editorBridge = api;
+    // the editor's calls: from the parent window only, answered with the result
+    if (PARENT) window.addEventListener("message", async (e) => {
+      const m = e.data;
+      if (e.source !== PARENT || !m || typeof m !== "object") return;
+      if (m.pindeck === "host-answer") { answers.get(m.id)?.(m.value); answers.delete(m.id); return; }
+      if (m.pindeck !== "bridge" || !Object.hasOwn(api, m.method)) return;
+      let value = null;
+      try { value = await api[m.method](...(m.args || [])); } catch (err) { console.error(err); }
+      PARENT.postMessage({ pindeck: "bridge-answer", id: m.id, value: value ?? null }, "*");
+    });
 
     if (MODE === "main") {
       document.addEventListener("pointerdown", onPointerDown, true);
@@ -1129,13 +1173,18 @@
       if (startAt) goto(startAt);
       deck.keys();
     }
-    host()?.bridgeReady(MODE, api, window);
+    host()?.bridgeReady(MODE, info());
   }
   if (SLIDE_SEL) {
     deck = selectorDeck();
     deck.ready(() => (MODE === "pdf" ? deck.print() : start()));
     return;
   }
+  if (typeof Reveal === "undefined" && (MODE === "main" || MODE === "measure")) {
+    // nothing to edit: the editor says why, instead of a blank stage (and stops waiting for measurements)
+    host()?.deckFailed(MODE, "reveal.js did not load: the deck's script tag for it points to a file or address that cannot be reached.");
+    return;
+  }
   if (typeof Reveal === "undefined" || MODE === "pdf") return;   // reveal.js lays out its own print view
   deck = revealDeck();
   deck.ready(start);

package/public/editor.css

@@ -60,12 +60,14 @@ code { font: 12.5px ui-monospace, SFMono-Regular, Menlo, monospace; background:
 .toolbar .group { display: flex; align-items: center; gap: 6px; min-width: 0; flex: none; }
 .toolbar .group:first-child { flex: 1 1 auto; }
 .toolbar .group:first-child > :not(.deck-wrap) { flex: none; }
+/* narrow: the deck's name is shortened, never hidden (it opens the deck menu) */
 @container (max-width: 640px) {
-  .toolbar kbd, .toolbar .deck-wrap { display: none; }
+  .toolbar kbd { display: none; }
+  .toolbar .deck-wrap { max-width: 9em; }
 }
 .pos { font-variant-numeric: tabular-nums; color: var(--muted); min-width: 52px; text-align: center; }
 /* the deck's name; behind the front (several decks on one port) it opens the deck menu */
-.deck-wrap { min-width: 0; margin-left: 2px; }
+.deck-wrap { min-width: 0; max-width: 12em; margin-left: 2px; }
 .deck-btn { display: flex; align-items: center; gap: 4px; max-width: 100%; min-width: 0; padding: 2px 6px;
   border: 0; background: none; color: inherit; font: inherit; }
 .deck-btn:hover { background: none; }
@@ -161,6 +163,10 @@ code { font: 12.5px ui-monospace, SFMono-Regular, Menlo, monospace; background:
 .stage iframe { position: absolute; inset: 0; width: 100%; height: 100%; border: 0; background: var(--stage); }
 .stage iframe.loading { visibility: hidden; }
 .stage iframe.measure { inset: auto; left: -20000px; top: 0; width: 1280px; height: 720px; visibility: hidden; }
+/* a deck page that does not start: why, over the empty stage */
+.stage-problem { position: absolute; inset: 0; z-index: 4; display: flex; flex-direction: column; justify-content: center; gap: 8px;
+  max-width: 34em; margin: auto; padding: 24px; color: var(--muted, #555); font-size: 14px; line-height: 1.45; text-align: center; }
+.stage-problem b { color: inherit; font-size: 15px; }
 
 /* ---- Speaker notes under the slide ---- */
 .notes-panel { position: relative; flex: none; display: flex; flex-direction: column; background: var(--panel); border-top: 1px solid var(--line); }