pdf-presenter 1.0.0 → 1.2.0

package/README-zhtw.md

@@ -1,6 +1,28 @@
 # pdf-presenter
 
-> 輕量級 CLI 工具，用瀏覽器播放 PDF 投影片，並提供完整的主講者模式 —— 包含講者備註、下一張預覽、計時器。不需要轉換 Markdown，也不需要原生相依套件。指向 PDF，就能開始。
+<p align="center">
+  <a href="https://www.npmjs.com/package/pdf-presenter"><img alt="npm version" src="https://img.shields.io/npm/v/pdf-presenter?color=cb3837&logo=npm&logoColor=white&label=npm"></a>
+  <a href="https://www.npmjs.com/package/pdf-presenter"><img alt="npm downloads" src="https://img.shields.io/npm/dm/pdf-presenter?color=cb3837&logo=npm&logoColor=white"></a>
+  <a href="https://github.com/htlin222/pdf-presenter/blob/main/LICENSE"><img alt="license" src="https://img.shields.io/npm/l/pdf-presenter?color=blue"></a>
+  <a href="https://nodejs.org"><img alt="node" src="https://img.shields.io/node/v/pdf-presenter?color=5fa04e&logo=node.js&logoColor=white"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/htlin222/pdf-presenter/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/htlin222/pdf-presenter/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/htlin222/pdf-presenter/actions/workflows/publish.yml"><img alt="Publish" src="https://github.com/htlin222/pdf-presenter/actions/workflows/publish.yml/badge.svg"></a>
+  <a href="https://github.com/htlin222/pdf-presenter/releases"><img alt="release" src="https://img.shields.io/github/v/release/htlin222/pdf-presenter?color=6f42c1&logo=github&logoColor=white"></a>
+  <a href="https://www.npmjs.com/package/pdf-presenter"><img alt="provenance" src="https://img.shields.io/badge/npm-provenance%20verified-2ea44f?logo=npm&logoColor=white"></a>
+</p>
+
+<p align="center">
+  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript&logoColor=white">
+  <img alt="pnpm" src="https://img.shields.io/badge/pnpm-10-f69220?logo=pnpm&logoColor=white">
+  <img alt="tsup" src="https://img.shields.io/badge/bundler-tsup-ff4f64">
+  <img alt="pdf.js" src="https://img.shields.io/badge/pdf.js-4.x-e31e24">
+  <a href="https://github.com/htlin222/pdf-presenter/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/htlin222/pdf-presenter?style=social"></a>
+</p>
+
+> 輕量級 CLI 工具，用瀏覽器播放 PDF 投影片，並提供完整的主講者模式 —— 包含講者備註、下一張預覽、可暫停的計時器、帶有逐張時間軸的錄音，以及可調整的面板。不需要轉換 Markdown，也不需要原生相依套件。指向 PDF，就能開始。
 
 [English version →](./README.md)
 

package/README.md

@@ -1,6 +1,32 @@
 # pdf-presenter
 
-> Lightweight CLI that serves a PDF as browser slides with a full presenter mode — speaker notes, next-slide preview, and a timer. No markdown conversion, no native dependencies. Point it at a PDF and go.
+<p align="center">
+  <a href="https://www.npmjs.com/package/pdf-presenter"><img alt="npm version" src="https://img.shields.io/npm/v/pdf-presenter?color=cb3837&logo=npm&logoColor=white&label=npm"></a>
+  <a href="https://www.npmjs.com/package/pdf-presenter"><img alt="npm downloads" src="https://img.shields.io/npm/dm/pdf-presenter?color=cb3837&logo=npm&logoColor=white"></a>
+  <a href="https://github.com/htlin222/pdf-presenter/blob/main/LICENSE"><img alt="license" src="https://img.shields.io/npm/l/pdf-presenter?color=blue"></a>
+  <a href="https://nodejs.org"><img alt="node" src="https://img.shields.io/node/v/pdf-presenter?color=5fa04e&logo=node.js&logoColor=white"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/htlin222/pdf-presenter/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/htlin222/pdf-presenter/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/htlin222/pdf-presenter/actions/workflows/publish.yml"><img alt="Publish" src="https://github.com/htlin222/pdf-presenter/actions/workflows/publish.yml/badge.svg"></a>
+  <a href="https://github.com/htlin222/pdf-presenter/releases"><img alt="release" src="https://img.shields.io/github/v/release/htlin222/pdf-presenter?color=6f42c1&logo=github&logoColor=white"></a>
+  <a href="https://www.npmjs.com/package/pdf-presenter"><img alt="provenance" src="https://img.shields.io/badge/npm-provenance%20verified-2ea44f?logo=npm&logoColor=white"></a>
+</p>
+
+<p align="center">
+  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript&logoColor=white">
+  <img alt="pnpm" src="https://img.shields.io/badge/pnpm-10-f69220?logo=pnpm&logoColor=white">
+  <img alt="tsup" src="https://img.shields.io/badge/bundler-tsup-ff4f64">
+  <img alt="pdf.js" src="https://img.shields.io/badge/pdf.js-4.x-e31e24">
+  <a href="https://github.com/htlin222/pdf-presenter/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/htlin222/pdf-presenter?style=social"></a>
+</p>
+
+> Lightweight CLI that serves a PDF as browser slides with a full presenter mode — speaker notes, next-slide preview, pause-able timer, audio recording with per-slide timeline metadata, and resizable panes. No markdown conversion, no native dependencies. Point it at a PDF and go.
+
+<p align="center">
+  <img src="assets/presenter-preview.png" alt="Presenter view — current slide, speaker notes, next slide preview, and timer" width="720" />
+</p>
 
 [繁體中文版 →](./README-zhtw.md)
 
@@ -8,6 +34,7 @@
 npx pdf-presenter slides.pdf           # serve & open browser
 npx pdf-presenter -gn slides.pdf       # generate a notes template
 npx pdf-presenter slides.pdf -t 20     # 20-minute countdown
+npx pdf-presenter ./slides/            # browse a directory of PDFs
 ```
 
 ---

package/dist/pdf-presenter.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync6, readFileSync } from "fs";
-import { basename as basename3, relative as relative2 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync2, statSync as statSync3 } from "fs";
+import { basename as basename4, relative as relative2, resolve as resolve5 } from "path";
 import { Command, Option } from "commander";
 import open from "open";
 
@@ -13,8 +13,8 @@ import { basename, relative } from "path";
 
 // src/utils.ts
 import { createServer } from "net";
-import { extname, resolve } from "path";
-import { existsSync, statSync } from "fs";
+import { extname, join, resolve } from "path";
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
 function resolvePdfPath(input) {
   const abs = resolve(input);
   if (!existsSync(abs)) {
@@ -31,6 +31,31 @@ function resolvePdfPath(input) {
 function notesPathFor(pdfPath) {
   return pdfPath.replace(/\.pdf$/i, ".notes.json");
 }
+function listPdfsInDirectory(dirPath) {
+  return readdirSync(dirPath).filter((f) => extname(f).toLowerCase() === ".pdf").sort((a, b) => a.localeCompare(b));
+}
+function getPdfNotesStatus(dirPath, pdfName) {
+  const notesPath = notesPathFor(join(dirPath, pdfName));
+  const result = {
+    pdfName,
+    hasNotes: false,
+    filledCount: 0,
+    totalSlides: 0
+  };
+  if (!existsSync(notesPath)) return result;
+  try {
+    const raw = JSON.parse(readFileSync(notesPath, "utf8"));
+    result.hasNotes = true;
+    result.totalSlides = raw.meta?.totalSlides ?? 0;
+    const notes = raw.notes ?? {};
+    result.filledCount = Object.values(notes).filter(
+      (n) => typeof n.note === "string" && n.note.trim().length > 0
+    ).length;
+  } catch {
+    result.hasNotes = true;
+  }
+  return result;
+}
 async function findAvailablePort(startPort, maxAttempts = 10) {
   for (let i = 0; i < maxAttempts; i++) {
     const port = startPort + i;
@@ -229,19 +254,21 @@ function resolvePdfjsDir(callerUrl) {
 
 // src/server/html-render.ts
 import { readFile as readFile2 } from "fs/promises";
-import { basename as basename2, join } from "path";
-async function renderHtml(uiDir, file, config) {
-  const raw = await readFile2(join(uiDir, file), "utf8");
-  const meta = {
+import { basename as basename2, join as join2 } from "path";
+async function renderHtml(uiDir, file, meta) {
+  const raw = await readFile2(join2(uiDir, file), "utf8");
+  return raw.replace(
+    "<!--PDF_PRESENTER_CONFIG-->",
+    `<script id="pdf-presenter-config" type="application/json">${JSON.stringify(meta)}</script>`
+  );
+}
+function singlePdfMeta(config) {
+  return {
     pdfUrl: "/slides.pdf",
     notesUrl: "/notes.json",
     pdfName: basename2(config.pdfPath),
     timerMinutes: config.timerMinutes ?? null
   };
-  return raw.replace(
-    "<!--PDF_PRESENTER_CONFIG-->",
-    `<script id="pdf-presenter-config" type="application/json">${JSON.stringify(meta)}</script>`
-  );
 }
 
 // src/server/notes-store.ts
@@ -400,7 +427,7 @@ async function handleNotesRoutes(req, res, url, deps) {
 
 // src/server/routes/recording.ts
 import { writeFile as writeFile3, mkdir } from "fs/promises";
-import { dirname as dirname2, join as join2 } from "path";
+import { dirname as dirname2, join as join3 } from "path";
 async function handleRecordingRoutes(req, res, url, deps) {
   const pathname = url.pathname;
   const method = req.method ?? "GET";
@@ -436,9 +463,9 @@ async function handleRecordingRoutes(req, res, url, deps) {
       );
       return "handled";
     }
-    const outDir = join2(dirname2(deps.pdfPath), "recordings");
+    const outDir = join3(dirname2(deps.pdfPath), "recordings");
     await mkdir(outDir, { recursive: true });
-    const outPath = join2(outDir, filenameParam);
+    const outPath = join3(outDir, filenameParam);
     const text = JSON.stringify(body, null, 2) + "\n";
     await writeFile3(outPath, text, "utf8");
     send(
@@ -485,9 +512,9 @@ async function handleRecordingRoutes(req, res, url, deps) {
       );
       return "handled";
     }
-    const outDir = join2(dirname2(deps.pdfPath), "recordings");
+    const outDir = join3(dirname2(deps.pdfPath), "recordings");
     await mkdir(outDir, { recursive: true });
-    const outPath = join2(outDir, filenameParam);
+    const outPath = join3(outDir, filenameParam);
     await writeFile3(outPath, bytes);
     send(
       res,
@@ -557,13 +584,135 @@ async function handleStaticRoutes(req, res, url, deps) {
   }
   return "pass";
 }
+async function handleSharedAssetRoutes(_req, res, url, deps) {
+  const pathname = url.pathname;
+  const method = _req.method ?? "GET";
+  if (method !== "GET" && method !== "HEAD") return "pass";
+  if (pathname.startsWith("/assets/pdfjs/")) {
+    const rel = pathname.slice("/assets/pdfjs/".length);
+    const safe = resolve3(deps.pdfjsDir, rel);
+    if (!safe.startsWith(deps.pdfjsDir + "/") && safe !== deps.pdfjsDir) {
+      send(res, 403, "Forbidden");
+      return "handled";
+    }
+    if (!existsSync5(safe)) {
+      notFound(res);
+      return "handled";
+    }
+    streamFile(res, safe, contentTypeFor(safe));
+    return "handled";
+  }
+  if (pathname.startsWith("/assets/")) {
+    const rel = pathname.slice("/assets/".length);
+    const safe = resolve3(deps.uiDir, rel);
+    if (!safe.startsWith(deps.uiDir + "/") && safe !== deps.uiDir) {
+      send(res, 403, "Forbidden");
+      return "handled";
+    }
+    if (!existsSync5(safe)) {
+      notFound(res);
+      return "handled";
+    }
+    streamFile(res, safe, contentTypeFor(safe));
+    return "handled";
+  }
+  return "pass";
+}
+
+// src/server/routes/listing.ts
+async function handleListingRoutes(req, res, url, deps) {
+  const pathname = url.pathname;
+  const method = req.method ?? "GET";
+  if (method !== "GET" && method !== "HEAD") return "pass";
+  if (pathname === "/" || pathname === "/list") {
+    send(res, 200, deps.listingHtml, MIME[".html"]);
+    return "handled";
+  }
+  if (pathname === "/api/listing") {
+    const pdfNames = listPdfsInDirectory(deps.dirPath);
+    const statuses = pdfNames.map(
+      (name) => getPdfNotesStatus(deps.dirPath, name)
+    );
+    send(res, 200, JSON.stringify(statuses), MIME[".json"]);
+    return "handled";
+  }
+  return "pass";
+}
+
+// src/server/routes/pdf-proxy.ts
+import { existsSync as existsSync6 } from "fs";
+import { basename as basename3, join as join4, resolve as resolve4 } from "path";
+var cache = /* @__PURE__ */ new Map();
+async function getOrCreateCache(pdfName, deps) {
+  let entry = cache.get(pdfName);
+  if (entry) return entry;
+  const pdfPath = join4(deps.dirPath, pdfName);
+  const notesPath = notesPathFor(pdfPath);
+  const prefix = `/pdf/${encodeURIComponent(pdfName)}`;
+  const meta = {
+    pdfUrl: `${prefix}/slides.pdf`,
+    notesUrl: `${prefix}/notes.json`,
+    pdfName: basename3(pdfPath),
+    timerMinutes: deps.timerMinutes ?? null,
+    listUrl: "/list"
+  };
+  const [audienceHtml, presenterHtml] = await Promise.all([
+    renderHtml(deps.uiDir, "audience.html", meta),
+    renderHtml(deps.uiDir, "presenter.html", meta)
+  ]);
+  entry = {
+    audienceHtml,
+    presenterHtml,
+    updateNotes: createNotesUpdater(notesPath)
+  };
+  cache.set(pdfName, entry);
+  return entry;
+}
+async function handlePdfProxyRoutes(req, res, url, deps) {
+  const match = url.pathname.match(/^\/pdf\/([^/]+)(\/.*)?$/);
+  if (!match) return "pass";
+  const pdfName = decodeURIComponent(match[1]);
+  const subPath = match[2] || "/";
+  if (!isSafeFilename(pdfName)) {
+    notFound(res);
+    return "handled";
+  }
+  const pdfPath = join4(deps.dirPath, pdfName);
+  const safePath = resolve4(deps.dirPath, pdfName);
+  if (!safePath.startsWith(deps.dirPath + "/") || !existsSync6(pdfPath)) {
+    notFound(res);
+    return "handled";
+  }
+  const notesPath = notesPathFor(pdfPath);
+  const perPdf = await getOrCreateCache(pdfName, deps);
+  const subUrl = new URL(subPath + url.search, `http://localhost`);
+  if (await handleRecordingRoutes(req, res, subUrl, { pdfPath }) === "handled")
+    return "handled";
+  if (await handleNotesRoutes(req, res, subUrl, {
+    notesPath,
+    updateNotes: perPdf.updateNotes
+  }) === "handled")
+    return "handled";
+  if (await handleStaticRoutes(req, res, subUrl, {
+    audienceHtml: perPdf.audienceHtml,
+    presenterHtml: perPdf.presenterHtml,
+    pdfPath,
+    notesPath,
+    uiDir: deps.uiDir,
+    pdfjsDir: deps.pdfjsDir
+  }) === "handled")
+    return "handled";
+  notFound(res);
+  return "handled";
+}
 
 // src/server.ts
 async function startServer(config) {
   const uiDir = resolveUiDir(import.meta.url);
   const pdfjsDir = resolvePdfjsDir(import.meta.url);
-  const audienceHtml = await renderHtml(uiDir, "audience.html", config);
-  const presenterHtml = await renderHtml(uiDir, "presenter.html", config);
+  const meta = singlePdfMeta(config);
+  const audienceHtml = await renderHtml(uiDir, "audience.html", meta);
+  const presenterHtml = await renderHtml(uiDir, "presenter.html", meta);
   const updateNotes = createNotesUpdater(config.notesPath);
   const handler = async (req, res) => {
     const url = new URL(req.url ?? "/", `http://localhost:${config.port}`);
@@ -616,19 +765,141 @@ async function startServer(config) {
     })
   };
 }
+async function startDirectoryServer(config) {
+  const { basename: basename5 } = await import("path");
+  const uiDir = resolveUiDir(import.meta.url);
+  const pdfjsDir = resolvePdfjsDir(import.meta.url);
+  const listingHtml = await renderHtml(uiDir, "listing.html", {
+    dirName: basename5(config.dirPath)
+  });
+  const handler = async (req, res) => {
+    const url = new URL(req.url ?? "/", `http://localhost:${config.port}`);
+    try {
+      if (await handleListingRoutes(req, res, url, {
+        dirPath: config.dirPath,
+        listingHtml
+      }) === "handled")
+        return;
+      if (await handlePdfProxyRoutes(req, res, url, {
+        dirPath: config.dirPath,
+        uiDir,
+        pdfjsDir,
+        timerMinutes: config.timerMinutes
+      }) === "handled")
+        return;
+      if (await handleSharedAssetRoutes(req, res, url, {
+        uiDir,
+        pdfjsDir
+      }) === "handled")
+        return;
+      notFound(res);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (!res.headersSent) send(res, 500, `Internal Server Error: ${msg}`);
+      else res.end();
+    }
+  };
+  const server = createServer2((req, res) => {
+    handler(req, res).catch((err) => {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (!res.headersSent) {
+        res.writeHead(500, { "Content-Type": "text/plain" });
+      }
+      res.end(`Internal Server Error: ${msg}`);
+    });
+  });
+  await new Promise((resolveP, rejectP) => {
+    server.once("error", rejectP);
+    server.listen(config.port, "127.0.0.1", () => {
+      server.off("error", rejectP);
+      resolveP();
+    });
+  });
+  return {
+    port: config.port,
+    stop: () => new Promise((resolveP, rejectP) => {
+      server.close((err) => err ? rejectP(err) : resolveP());
+    })
+  };
+}
+
+// package.json
+var package_default = {
+  name: "pdf-presenter",
+  version: "1.2.0",
+  description: "Lightweight CLI that serves PDF slides in the browser with a full presenter mode (speaker notes, next slide preview, timer, audio recording).",
+  type: "module",
+  bin: {
+    "pdf-presenter": "./dist/pdf-presenter.js"
+  },
+  files: [
+    "dist/",
+    "src/ui/",
+    "README.md",
+    "README-zhtw.md",
+    "LICENSE"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    typecheck: "tsc --noEmit",
+    prepublishOnly: "pnpm run typecheck && pnpm run build",
+    test: "vitest run",
+    "test:watch": "vitest"
+  },
+  keywords: [
+    "pdf",
+    "presenter",
+    "presentation",
+    "slides",
+    "slideshow",
+    "speaker-notes",
+    "cli"
+  ],
+  author: "Hsiehting Lin <hsieh.ting.lin@gmail.com>",
+  license: "MIT",
+  homepage: "https://github.com/htlin222/pdf-presenter#readme",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/htlin222/pdf-presenter.git"
+  },
+  bugs: {
+    url: "https://github.com/htlin222/pdf-presenter/issues"
+  },
+  engines: {
+    node: ">=18"
+  },
+  dependencies: {
+    commander: "^12.1.0",
+    "get-port": "^7.1.0",
+    open: "^10.1.0",
+    "pdfjs-dist": "^4.7.76"
+  },
+  devDependencies: {
+    "@types/node": "^22.7.0",
+    tsup: "^8.3.0",
+    typescript: "^5.6.0",
+    vitest: "^2.1.0"
+  }
+};
 
 // src/cli.ts
-var VERSION = "1.0.0";
+var VERSION = package_default.version;
 async function runCli(argv) {
   const program = new Command();
   program.name("pdf-presenter").description(
     "Serve a PDF as browser slides with a full presenter mode (notes, next preview, timer)."
-  ).version(VERSION, "-v, --version").argument("<file>", "Path to the PDF file").addOption(new Option("-p, --port <port>", "Server port").default("3000")).option("--no-open", "Don't auto-open browser").option("--presenter", "Open directly in presenter mode", false).option("-n, --notes <path>", "Path to notes JSON file").option("-t, --timer <minutes>", "Countdown timer in minutes").option(
+  ).version(VERSION, "-v, --version").argument("<file>", "Path to a PDF file or a directory of PDFs").addOption(new Option("-p, --port <port>", "Server port").default("3000")).option("--no-open", "Don't auto-open browser").option("--presenter", "Open directly in presenter mode", false).option("-n, --notes <path>", "Path to notes JSON file").option("-t, --timer <minutes>", "Countdown timer in minutes").option(
     "-gn, --generate-presenter-note-template",
     "Generate a notes template JSON next to the PDF",
     false
   ).option("--force", "Overwrite existing notes file when used with -gn", false).action(async (file, options) => {
     try {
+      const abs = resolve5(file);
+      if (existsSync7(abs) && statSync3(abs).isDirectory()) {
+        await runDirectoryServe(abs, options);
+        return;
+      }
       const pdfPath = resolvePdfPath(file);
       if (options.generatePresenterNoteTemplate) {
         await runGenerate(pdfPath, { force: !!options.force });
@@ -649,13 +920,13 @@ Error: ${msg}
 async function runGenerate(pdfPath, opts) {
   try {
     const result = await generateNotesTemplate(pdfPath, opts);
-    const rel = relative2(process.cwd(), result.notesPath) || basename3(result.notesPath);
+    const rel = relative2(process.cwd(), result.notesPath) || basename4(result.notesPath);
     process.stdout.write(
       `
 \u2705 Generated ${rel} (${result.totalSlides} slides)
 
    Edit the "note" fields in the JSON file, then run:
-     pdf-presenter ${relative2(process.cwd(), pdfPath) || basename3(pdfPath)}
+     pdf-presenter ${relative2(process.cwd(), pdfPath) || basename4(pdfPath)}
 
 `
     );
@@ -697,7 +968,7 @@ async function runServe(pdfPath, options) {
    Audience:   ${url}
    Presenter:  ${presenterUrl}
 
-   PDF:   ${basename3(pdfPath)}
+   PDF:   ${basename4(pdfPath)}
    Notes: ${notesInfo}
 ` + (timerMinutes !== void 0 ? `   Timer: ${formatMinutes(timerMinutes)}
 ` : "") + `
@@ -723,24 +994,69 @@ Received ${signal}, shutting down...
   process.on("SIGINT", () => void shutdown("SIGINT"));
   process.on("SIGTERM", () => void shutdown("SIGTERM"));
 }
+async function runDirectoryServe(dirPath, options) {
+  const startPort = Number.parseInt(options.port, 10);
+  if (!Number.isFinite(startPort) || startPort <= 0) {
+    throw new Error(`Invalid --port value: ${options.port}`);
+  }
+  let timerMinutes;
+  if (options.timer !== void 0) {
+    const t = Number.parseFloat(options.timer);
+    if (!Number.isFinite(t) || t <= 0) {
+      throw new Error(`Invalid --timer value: ${options.timer}`);
+    }
+    timerMinutes = t;
+  }
+  const port = await findAvailablePort(startPort);
+  const server = await startDirectoryServer({ dirPath, port, timerMinutes });
+  const url = `http://localhost:${port}`;
+  process.stdout.write(
+    `
+\u{1F3AF} pdf-presenter v${VERSION} (directory mode)
+
+   Listing: ${url}/list
+
+   Directory: ${basename4(dirPath)}/
+
+   Press Ctrl+C to stop.
+
+`
+  );
+  if (options.open) {
+    open(`${url}/list`).catch(() => {
+    });
+  }
+  const shutdown = async (signal) => {
+    process.stdout.write(`
+Received ${signal}, shutting down...
+`);
+    try {
+      await server.stop();
+    } catch {
+    }
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown("SIGINT"));
+  process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}
 function resolveMaybeExisting(path) {
   return path;
 }
 function describeNotes(notesPath) {
-  if (!existsSync6(notesPath)) {
-    return `${basename3(notesPath)} (not found \u2014 using empty notes)`;
+  if (!existsSync7(notesPath)) {
+    return `${basename4(notesPath)} (not found \u2014 using empty notes)`;
   }
   try {
-    const raw = readFileSync(notesPath, "utf8");
+    const raw = readFileSync2(notesPath, "utf8");
     const parsed = JSON.parse(raw);
     const total = parsed.meta?.totalSlides ?? 0;
     const filled = Object.values(parsed.notes ?? {}).filter(
       (e) => typeof e.note === "string" && e.note.trim() !== ""
     ).length;
     const suffix = total > 0 ? ` (${filled}/${total} slides have notes)` : "";
-    return `${basename3(notesPath)}${suffix}`;
+    return `${basename4(notesPath)}${suffix}`;
   } catch {
-    return `${basename3(notesPath)} (invalid JSON \u2014 using empty notes)`;
+    return `${basename4(notesPath)} (invalid JSON \u2014 using empty notes)`;
   }
 }
 function formatMinutes(minutes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-presenter",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Lightweight CLI that serves PDF slides in the browser with a full presenter mode (speaker notes, next slide preview, timer, audio recording).",
   "type": "module",
   "bin": {

package/src/ui/audience.html

@@ -3,13 +3,15 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
-    <title>pdf-presenter — Audience</title>
+    <title>Audience</title>
+    <link rel="icon" type="image/svg+xml" href="/assets/favicon.svg" />
     <link rel="stylesheet" href="/assets/presenter.css" />
     <!--PDF_PRESENTER_CONFIG-->
   </head>
   <body class="audience">
     <div id="stage" class="stage">
       <canvas id="slide-canvas"></canvas>
+      <div id="laser-dot" class="laser-dot hidden" aria-hidden="true"></div>
       <div id="black-overlay" class="overlay hidden"></div>
       <div id="freeze-indicator" class="freeze-indicator hidden">FROZEN</div>
       <div id="status" class="status"></div>

package/src/ui/audience.js

@@ -13,6 +13,7 @@ export async function initAudience() {
   const pdf = await loadDocument(config.pdfUrl);
   const total = pdf.numPages;
   const canvas = document.getElementById("slide-canvas");
+  const laserDot = document.getElementById("laser-dot");
   const blackOverlay = document.getElementById("black-overlay");
   const freezeIndicator = document.getElementById("freeze-indicator");
   const status = document.getElementById("status");
@@ -44,6 +45,20 @@ export async function initAudience() {
     blackOverlay.classList.toggle("hidden", !on);
   }
 
+  function setCursor(msg) {
+    if (!laserDot) return;
+    if (msg.hidden) {
+      laserDot.classList.add("hidden");
+      return;
+    }
+    const rect = canvas.getBoundingClientRect();
+    const x = rect.left + msg.x * rect.width;
+    const y = rect.top + msg.y * rect.height;
+    laserDot.style.left = `${x}px`;
+    laserDot.style.top = `${y}px`;
+    laserDot.classList.remove("hidden");
+  }
+
   channel.addEventListener("message", (ev) => {
     const msg = ev.data;
     if (!msg || typeof msg !== "object") return;
@@ -57,6 +72,9 @@ export async function initAudience() {
       case "black":
         setBlack(!!msg.value);
         break;
+      case "cursor":
+        setCursor(msg);
+        break;
       case "hello":
         channel.postMessage({ type: "audience-ready" });
         break;

package/src/ui/favicon-presenter.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#f5a524" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M2 3h20"/><path d="M21 3v11a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V3"/><path d="m7 21 5-6 5 6"/><path d="M12 15v6"/></svg>

package/src/ui/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#7fd4a0" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M2 3h20"/><path d="M21 3v11a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V3"/><path d="m7 21 5-6 5 6"/><path d="M12 15v6"/></svg>