@hirokisakabe/pom-cli 0.2.4 → 0.3.0

package/README.md

@@ -21,8 +21,20 @@ pom preview slides.pom.md
 
 Open http://localhost:3000 in your browser. The page updates automatically when the file is saved.
 
+To use a different port (e.g. when 3000 is already in use):
+
+```bash
+pom preview slides.pom.xml --port 3001
+```
+
 Use the zoom buttons in the toolbar or press `+` / `-` to zoom in and out. The current zoom level is saved across sessions.
 
+To print per-step timing on stderr when each rebuild completes:
+
+```bash
+pom preview slides.pom.xml --verbose
+```
+
 ### Build
 
 Converts a pom file to a PPTX file.
@@ -32,6 +44,29 @@ pom build slides.pom.xml -o output.pptx
 pom build slides.pom.md -o output.pptx
 ```
 
+To watch for file changes and rebuild automatically:
+
+```bash
+pom build slides.pom.xml -o output.pptx --watch
+```
+
+The process stays running and rebuilds every time the input file is saved. Build progress is printed to stderr:
+
+```
+[pom] Watching: slides.pom.xml
+[pom] Built: output.pptx (367ms)
+[pom] File changed, rebuilding...
+[pom] Built: output.pptx (342ms)
+```
+
+If a build fails, the error is printed but the process continues watching for the next change. Press `Ctrl+C` to stop.
+
+To print per-step timing on stderr:
+
+```bash
+pom build slides.pom.xml -o output.pptx --verbose
+```
+
 ## Fonts
 
 This package bundles Carlito and Noto Sans CJK JP fonts for SVG rendering. These fonts are used when converting slides to SVG in the preview server. System fonts are not scanned.

package/dist/build.d.ts

@@ -1,2 +1,8 @@
-export declare function runBuild(inputFile: string, outputFile: string): Promise<void>;
+export declare function runBuild(inputFile: string, outputFile: string, options?: {
+    verbose?: boolean;
+    silent?: boolean;
+}): Promise<void>;
+export declare function runBuildWatch(inputFile: string, outputFile: string, options?: {
+    verbose?: boolean;
+}): Promise<void>;
 //# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAKA,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAsDf"}
+{"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"}

package/dist/build.js

@@ -1,13 +1,22 @@
 import fs from "fs";
 import path from "path";
-import { buildPptx } from "@hirokisakabe/pom";
+import { buildPptx, DiagnosticsError } from "@hirokisakabe/pom";
 import { parseMd } from "@hirokisakabe/pom-md";
-export async function runBuild(inputFile, outputFile) {
+function makeLog(verbose) {
+    if (!verbose)
+        return (_msg) => { };
+    return (msg) => process.stderr.write(`[pom] ${msg}\n`);
+}
+export async function runBuild(inputFile, outputFile, options = {}) {
+    const verbose = options.verbose ?? false;
+    const log = makeLog(verbose);
+    const totalStart = Date.now();
     const absInput = path.resolve(inputFile);
     const absOutput = path.resolve(outputFile);
     if (!fs.existsSync(absInput)) {
         throw new Error(`Input file not found: ${absInput}`);
     }
+    log(`Reading file: ${absInput}`);
     const content = fs.readFileSync(absInput, "utf-8");
     const ext = path.extname(absInput);
     let xml;
@@ -15,10 +24,12 @@ export async function runBuild(inputFile, outputFile) {
     let slideHeight = 720;
     let masterPptxData;
     if (ext === ".md") {
+        const t = Date.now();
         const result = parseMd(content);
         xml = result.xml;
         slideWidth = result.meta.size.w;
         slideHeight = result.meta.size.h;
+        log(`Parsing Markdown... done (${Date.now() - t}ms)`);
         if (result.meta.masterPptx) {
             const masterPath = path.resolve(path.dirname(absInput), result.meta.masterPptx);
             try {
@@ -37,11 +48,75 @@ export async function runBuild(inputFile, outputFile) {
     else {
         xml = content;
     }
-    const { pptx } = await buildPptx(xml, { w: slideWidth, h: slideHeight }, masterPptxData ? { masterPptx: masterPptxData } : undefined);
+    const t1 = Date.now();
+    const { pptx } = await buildPptx(xml, { w: slideWidth, h: slideHeight }, {
+        ...(masterPptxData ? { masterPptx: masterPptxData } : {}),
+        strict: true,
+    });
+    log(`Building PPTX... done (${Date.now() - t1}ms)`);
+    const t2 = Date.now();
     const buffer = await pptx.write({ outputType: "uint8array" });
     if (!(buffer instanceof Uint8Array)) {
         throw new Error("Unexpected output type from pptx.write");
     }
     fs.writeFileSync(absOutput, buffer);
-    console.log(`PPTX saved: ${absOutput}`);
+    log(`Writing output... done (${Date.now() - t2}ms)`);
+    const total = Date.now() - totalStart;
+    log(`Total: ${total}ms`);
+    if (!options.silent) {
+        console.log(`PPTX saved: ${absOutput}`);
+    }
+}
+export async function runBuildWatch(inputFile, outputFile, options = {}) {
+    const absInput = path.resolve(inputFile);
+    const absOutput = path.resolve(outputFile);
+    if (!fs.existsSync(absInput)) {
+        throw new Error(`Input file not found: ${absInput}`);
+    }
+    const watchLog = (msg) => process.stderr.write(`[pom] ${msg}\n`);
+    watchLog(`Watching: ${path.basename(absInput)}`);
+    let isBuilding = false;
+    let pendingRebuild = false;
+    async function doBuild() {
+        if (isBuilding) {
+            pendingRebuild = true;
+            return;
+        }
+        isBuilding = true;
+        pendingRebuild = false;
+        const start = Date.now();
+        try {
+            await runBuild(inputFile, outputFile, { ...options, silent: true });
+            watchLog(`Built: ${path.basename(absOutput)} (${Date.now() - start}ms)`);
+        }
+        catch (err) {
+            if (err instanceof DiagnosticsError) {
+                const count = err.diagnostics.length;
+                process.stderr.write(`[pom] Build failed (${count} ${count === 1 ? "error" : "errors"})\n`);
+                for (const d of err.diagnostics) {
+                    process.stderr.write(`[pom]   [${d.code}] ${d.message}\n`);
+                }
+            }
+            else {
+                process.stderr.write(`[pom] Error: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+        finally {
+            isBuilding = false;
+            if (pendingRebuild) {
+                watchLog("File changed, rebuilding...");
+                void doBuild();
+            }
+        }
+    }
+    await doBuild();
+    let debounceTimer = null;
+    fs.watch(absInput, () => {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            watchLog("File changed, rebuilding...");
+            void doBuild();
+        }, 100);
+    });
 }

package/dist/cli.js

@@ -1,38 +1,67 @@
 #!/usr/bin/env node
-import { runBuild } from "./build.js";
+import { createRequire } from "node:module";
+import { Command } from "commander";
+import { DiagnosticsError } from "@hirokisakabe/pom";
+import { runBuild, runBuildWatch } from "./build.js";
 import { runPreview } from "./preview.js";
-const args = process.argv.slice(2);
-const command = args[0];
-if (command === "preview") {
-    const inputFile = args[1];
-    if (!inputFile) {
-        console.error("Usage: pom preview <input.pom.xml|input.pom.md>");
-        process.exit(1);
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+const program = new Command();
+program
+    .name("pom")
+    .description("CLI tool for pom — preview and build presentations")
+    .version(version);
+program
+    .command("preview")
+    .description("Start a live preview server for a presentation")
+    .argument("<input>", "Input file (.pom.xml or .pom.md)")
+    .option("--port <number>", "Port to listen on")
+    .option("--verbose", "Show build step timing on stderr")
+    .action((input, options) => {
+    let port;
+    if (options.port !== undefined) {
+        port = Number(options.port);
+        if (!Number.isInteger(port) || port <= 0 || port > 65535) {
+            console.error(`Invalid port: ${options.port}`);
+            process.exit(1);
+        }
     }
     try {
-        runPreview(inputFile);
+        runPreview(input, port, { verbose: options.verbose });
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : String(err));
         process.exit(1);
     }
-}
-else if (command === "build") {
-    const inputFile = args[1];
-    const outputIndex = args.indexOf("-o");
-    const outputFile = outputIndex !== -1 ? args[outputIndex + 1] : undefined;
-    if (!inputFile || !outputFile) {
-        console.error("Usage: pom build <input.pom.xml|input.pom.md> -o <output.pptx>");
-        process.exit(1);
+});
+program
+    .command("build")
+    .description("Build a presentation to PPTX")
+    .argument("<input>", "Input file (.pom.xml or .pom.md)")
+    .requiredOption("-o <output>", "Output PPTX file")
+    .option("--verbose", "Show build step timing on stderr")
+    .option("--watch", "Watch for file changes and rebuild automatically")
+    .action((input, options) => {
+    if (options.watch) {
+        runBuildWatch(input, options.o, { verbose: options.verbose }).catch((err) => {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        });
     }
-    runBuild(inputFile, outputFile).catch((err) => {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    });
-}
-else {
-    console.error("Usage:");
-    console.error("  pom preview <input.pom.xml|input.pom.md>");
-    console.error("  pom build <input.pom.xml|input.pom.md> -o <output.pptx>");
-    process.exit(1);
-}
+    else {
+        runBuild(input, options.o, { verbose: options.verbose }).catch((err) => {
+            if (err instanceof DiagnosticsError) {
+                const count = err.diagnostics.length;
+                console.error(`✗ Build failed (${count} ${count === 1 ? "error" : "errors"})\n`);
+                for (const d of err.diagnostics) {
+                    console.error(`  [${d.code}] ${d.message}`);
+                }
+            }
+            else {
+                console.error(err instanceof Error ? err.message : String(err));
+            }
+            process.exit(1);
+        });
+    }
+});
+program.parse();

package/dist/preview.d.ts

@@ -1,2 +1,4 @@
-export declare function runPreview(inputFile: string): void;
+export declare function runPreview(inputFile: string, port?: number, options?: {
+    verbose?: 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":"AA8WA,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAyGlD"}
+{"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"}

package/dist/preview.js

@@ -7,11 +7,17 @@ import { parseMd } from "@hirokisakabe/pom-md";
 import { convertPptxToSvg } from "pptx-glimpse";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const DEFAULT_PORT = 3000;
+function makeLog(verbose) {
+    if (!verbose)
+        return (_msg) => { };
+    return (msg) => process.stderr.write(`[pom] ${msg}\n`);
+}
 const EXTRA_FONT_MAPPING = {
     "游ゴシック Light": "Noto Sans CJK JP",
     "Yu Gothic Light": "Noto Sans CJK JP",
 };
-async function generateSvgs(inputFile) {
+async function generateSvgs(inputFile, verbose = false) {
+    const log = makeLog(verbose);
     const content = fs.readFileSync(inputFile, "utf-8");
     const ext = path.extname(inputFile);
     let xml;
@@ -19,10 +25,12 @@ async function generateSvgs(inputFile) {
     let slideHeight = 720;
     let masterPptxData;
     if (ext === ".md") {
+        const t = Date.now();
         const result = parseMd(content);
         xml = result.xml;
         slideWidth = result.meta.size.w;
         slideHeight = result.meta.size.h;
+        log(`Parsing Markdown... done (${Date.now() - t}ms)`);
         if (result.meta.masterPptx) {
             const masterPath = path.resolve(path.dirname(inputFile), result.meta.masterPptx);
             try {
@@ -44,10 +52,12 @@ async function generateSvgs(inputFile) {
     if (!xml.trim()) {
         return { type: "empty" };
     }
+    const t1 = Date.now();
     const { pptx } = await buildPptx(xml, { w: slideWidth, h: slideHeight }, {
         textMeasurement: "fallback",
         ...(masterPptxData ? { masterPptx: masterPptxData } : {}),
     });
+    log(`Building PPTX... done (${Date.now() - t1}ms)`);
     const buffer = await pptx.write({ outputType: "uint8array" });
     if (!(buffer instanceof Uint8Array)) {
         throw new Error("Unexpected output type from pptx.write");
@@ -57,12 +67,14 @@ async function generateSvgs(inputFile) {
         throw new Error(`Bundled fonts directory not found: ${fontsDir}. The package may be corrupted.`);
     }
     const fontDirs = [fontsDir];
+    const t2 = Date.now();
     const slides = await convertPptxToSvg(buffer, {
         width: slideWidth,
         fontDirs,
         fontMapping: EXTRA_FONT_MAPPING,
         skipSystemFonts: true,
     });
+    log(`Converting to SVG... done (${Date.now() - t2}ms)`);
     const svgs = slides.map((s) => s.svg);
     return { type: "success", svgs, slideWidth };
 }
@@ -336,7 +348,9 @@ function buildPreviewHtml(filename) {
 </body>
 </html>`;
 }
-export function runPreview(inputFile) {
+export function runPreview(inputFile, port = DEFAULT_PORT, options = {}) {
+    const verbose = options.verbose ?? false;
+    const log = makeLog(verbose);
     const absInput = path.resolve(inputFile);
     if (!fs.existsSync(absInput)) {
         throw new Error(`Input file not found: ${absInput}`);
@@ -358,9 +372,14 @@ export function runPreview(inputFile) {
         }
     }
     function refresh() {
+        const totalStart = Date.now();
+        log("File changed, rebuilding...");
         broadcastBuilding();
-        generateSvgs(absInput)
-            .then(broadcast)
+        generateSvgs(absInput, verbose)
+            .then((result) => {
+            log(`Done (total: ${Date.now() - totalStart}ms)`);
+            broadcast(result);
+        })
             .catch((err) => {
             broadcast({
                 type: "error",
@@ -368,10 +387,12 @@ export function runPreview(inputFile) {
             });
         });
     }
-    generateSvgs(absInput)
+    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) => {
@@ -417,15 +438,15 @@ export function runPreview(inputFile) {
     });
     server.on("error", (err) => {
         if (err.code === "EADDRINUSE") {
-            console.error(`Port ${DEFAULT_PORT} is already in use. Is another pom preview running?`);
+            console.error(`Port ${port} is already in use. Is another pom preview running?`);
         }
         else {
             console.error(`Server error: ${err.message}`);
         }
         process.exit(1);
     });
-    server.listen(DEFAULT_PORT, () => {
-        console.log(`Preview server: http://localhost:${DEFAULT_PORT}`);
+    server.listen(port, () => {
+        console.log(`Preview server: http://localhost:${port}`);
         console.log(`Watching: ${absInput}`);
         console.log("Press Ctrl+C to stop");
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirokisakabe/pom-cli",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "CLI tool for pom — preview and build presentations",
   "type": "module",
   "bin": {
@@ -30,9 +30,10 @@
     "node": ">=18"
   },
   "dependencies": {
-    "pptx-glimpse": "^0.11.0",
-    "@hirokisakabe/pom": "8.1.0",
-    "@hirokisakabe/pom-md": "3.0.0"
+    "@hirokisakabe/pom": "^8.2.0",
+    "@hirokisakabe/pom-md": "^3.0.0",
+    "commander": "^15.0.0",
+    "pptx-glimpse": "^0.11.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",