@hirokisakabe/pom-cli 0.3.1 → 0.4.0

package/README.md

@@ -8,6 +8,16 @@ CLI tool for [pom](https://github.com/hirokisakabe/pom) — preview and build pr
 npm install -g @hirokisakabe/pom-cli
 ```
 
+## Quick Start
+
+One command is all it takes — no global install required:
+
+```bash
+npx @hirokisakabe/pom-cli preview slides.pom.xml
+```
+
+This starts a local preview server, opens your browser automatically, and live-reloads the preview every time the file is saved. This also works well when invoked from agent skills or scripts.
+
 ## Usage
 
 ### Preview
@@ -19,7 +29,13 @@ pom preview slides.pom.xml
 pom preview slides.pom.md
 ```
 
-Open http://localhost:3000 in your browser. The page updates automatically when the file is saved.
+The browser opens http://localhost:3000 automatically. The page updates whenever the file is saved — including atomic saves performed by editors like Vim.
+
+To suppress the automatic browser open (e.g. in CI or headless environments):
+
+```bash
+pom preview slides.pom.xml --no-open
+```
 
 To use a different port (e.g. when 3000 is already in use):
 

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAUA,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACpD,OAAO,CAAC,IAAI,CAAC,CAwEf;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CA2Df"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAWA,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACpD,OAAO,CAAC,IAAI,CAAC,CAwEf;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/dist/build.js

@@ -2,6 +2,7 @@ import fs from "fs";
 import path from "path";
 import { buildPptx, DiagnosticsError } from "@hirokisakabe/pom";
 import { parseMd } from "@hirokisakabe/pom-md";
+import { watchInputFile } from "./watch.js";
 function makeLog(verbose) {
     if (!verbose)
         return (_msg) => { };
@@ -110,13 +111,8 @@ export async function runBuildWatch(inputFile, outputFile, options = {}) {
         }
     }
     await doBuild();
-    let debounceTimer = null;
-    fs.watch(absInput, () => {
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(() => {
-            watchLog("File changed, rebuilding...");
-            void doBuild();
-        }, 100);
+    watchInputFile(absInput, () => {
+        watchLog("File changed, rebuilding...");
+        void doBuild();
     });
 }

package/dist/cli.js

@@ -17,6 +17,7 @@ program
     .argument("<input>", "Input file (.pom.xml or .pom.md)")
     .option("--port <number>", "Port to listen on")
     .option("--verbose", "Show build step timing on stderr")
+    .option("--no-open", "Do not open the browser automatically")
     .action((input, options) => {
     let port;
     if (options.port !== undefined) {
@@ -27,7 +28,10 @@ program
         }
     }
     try {
-        runPreview(input, port, { verbose: options.verbose });
+        runPreview(input, port, {
+            verbose: options.verbose,
+            open: options.open,
+        });
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : String(err));

package/dist/preview.d.ts

@@ -1,4 +1,5 @@
 export declare function runPreview(inputFile: string, port?: number, options?: {
     verbose?: boolean;
+    open?: boolean;
 }): void;
 //# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AA8XA,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAqB,EAC3B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,IAAI,CAkHN"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAqZA,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAqB,EAC3B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,IAAI,CAmIN"}

package/dist/preview.js

@@ -1,3 +1,4 @@
+import { spawn } from "child_process";
 import fs from "fs";
 import http from "http";
 import { fileURLToPath } from "url";
@@ -5,6 +6,7 @@ import path from "path";
 import { buildPptx } from "@hirokisakabe/pom";
 import { parseMd } from "@hirokisakabe/pom-md";
 import { convertPptxToSvg } from "pptx-glimpse";
+import { watchInputFile } from "./watch.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const DEFAULT_PORT = 3000;
 function makeLog(verbose) {
@@ -12,6 +14,28 @@ function makeLog(verbose) {
         return (_msg) => { };
     return (msg) => process.stderr.write(`[pom] ${msg}\n`);
 }
+function openBrowser(url) {
+    let cmd;
+    let args;
+    if (process.platform === "darwin") {
+        cmd = "open";
+        args = [url];
+    }
+    else if (process.platform === "win32") {
+        // 空文字はウィンドウタイトル。省略すると URL がタイトル扱いされる
+        cmd = "cmd";
+        args = ["/c", "start", "", url];
+    }
+    else {
+        cmd = "xdg-open";
+        args = [url];
+    }
+    const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+    child.on("error", () => {
+        console.log(`Could not open browser automatically. Open ${url} manually.`);
+    });
+    child.unref();
+}
 const EXTRA_FONT_MAPPING = {
     "游ゴシック Light": "Noto Sans CJK JP",
     "Yu Gothic Light": "Noto Sans CJK JP",
@@ -371,7 +395,15 @@ export function runPreview(inputFile, port = DEFAULT_PORT, options = {}) {
             client.write(`event: update\ndata: ${data}\n\n`);
         }
     }
+    let isBuilding = false;
+    let pendingRefresh = false;
     function refresh() {
+        if (isBuilding) {
+            pendingRefresh = true;
+            return;
+        }
+        isBuilding = true;
+        pendingRefresh = false;
         const totalStart = Date.now();
         log("File changed, rebuilding...");
         broadcastBuilding();
@@ -385,29 +417,34 @@ export function runPreview(inputFile, port = DEFAULT_PORT, options = {}) {
                 type: "error",
                 message: err instanceof Error ? err.message : String(err),
             });
+        })
+            .finally(() => {
+            isBuilding = false;
+            if (pendingRefresh)
+                refresh();
         });
     }
+    isBuilding = true;
     const initialStart = Date.now();
     generateSvgs(absInput, verbose)
         .then((result) => {
         currentResult = result;
-        initialBuildDone = true;
         log(`Initial build done (total: ${Date.now() - initialStart}ms)`);
         broadcast(result);
     })
         .catch((err) => {
-        initialBuildDone = true;
         broadcast({
             type: "error",
             message: err instanceof Error ? err.message : String(err),
         });
+    })
+        .finally(() => {
+        initialBuildDone = true;
+        isBuilding = false;
+        if (pendingRefresh)
+            refresh();
     });
-    let debounceTimer = null;
-    fs.watch(absInput, () => {
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(refresh, 100);
-    });
+    watchInputFile(absInput, refresh);
     const html = buildPreviewHtml(path.basename(absInput));
     const server = http.createServer((req, res) => {
         if (req.url === "/_sse") {
@@ -446,8 +483,12 @@ export function runPreview(inputFile, port = DEFAULT_PORT, options = {}) {
         process.exit(1);
     });
     server.listen(port, () => {
-        console.log(`Preview server: http://localhost:${port}`);
+        const url = `http://localhost:${port}`;
+        console.log(`Preview server: ${url}`);
         console.log(`Watching: ${absInput}`);
         console.log("Press Ctrl+C to stop");
+        if (options.open ?? true) {
+            openBrowser(url);
+        }
     });
 }

package/dist/watch.d.ts

@@ -0,0 +1,3 @@
+import fs from "fs";
+export declare function watchInputFile(absPath: string, onChange: () => void): fs.FSWatcher;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAOpB,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,IAAI,GACnB,EAAE,CAAC,SAAS,CA4Bd"}

package/dist/watch.js

@@ -0,0 +1,37 @@
+import fs from "fs";
+import path from "path";
+const DEBOUNCE_MS = 100;
+// Watches the parent directory instead of the file itself so the watcher
+// survives atomic saves (rename + replace) performed by editors like Vim.
+export function watchInputFile(absPath, onChange) {
+    const dir = path.dirname(absPath);
+    const base = path.basename(absPath);
+    let debounceTimer = null;
+    let lastMtimeMs = -1;
+    try {
+        lastMtimeMs = fs.statSync(absPath).mtimeMs;
+    }
+    catch {
+        // 監視開始時点でファイルが無くても、作成され次第のイベントで拾う
+    }
+    return fs.watch(dir, (_eventType, filename) => {
+        // filename can be null on some platforms; treat it as a potential match
+        if (filename !== null && filename !== base)
+            return;
+        // 同一ディレクトリの別ファイル変更 (filename が null の環境) や
+        // 自前の出力ファイル書き込みで発火しないよう、mtime の実変化を確認する
+        let mtimeMs;
+        try {
+            mtimeMs = fs.statSync(absPath).mtimeMs;
+        }
+        catch {
+            return;
+        }
+        if (mtimeMs === lastMtimeMs)
+            return;
+        lastMtimeMs = mtimeMs;
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(onChange, DEBOUNCE_MS);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirokisakabe/pom-cli",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "CLI tool for pom — preview and build presentations",
   "type": "module",
   "bin": {
@@ -30,14 +30,14 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@hirokisakabe/pom": "^8.2.0",
+    "@hirokisakabe/pom": "^8.3.0",
     "@hirokisakabe/pom-md": "^3.0.0",
     "commander": "^15.0.0",
-    "pptx-glimpse": "^0.11.2"
+    "pptx-glimpse": "^1.0.1"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
-    "typescript-eslint": "^8.59.4"
+    "@types/node": "^25.9.2",
+    "typescript-eslint": "^8.60.1"
   },
   "scripts": {
     "build": "tsc && node -e \"require('fs').chmodSync('dist/cli.js', '755')\"",