@hirokisakabe/pom-cli 0.3.2 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @hirokisakabe/pom-cli
 
-CLI tool for [pom](https://github.com/hirokisakabe/pom) — preview and build presentations from pom XML / Markdown.
+CLI tool for [pom](https://github.com/hirokisakabe/pom) — preview, build, and render presentations from pom XML / Markdown.
 
 ## Installation
 
@@ -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):
 
@@ -67,9 +83,38 @@ To print per-step timing on stderr:
 pom build slides.pom.xml -o output.pptx --verbose
 ```
 
+### Render
+
+Renders each slide to a PNG (default) or SVG image — no LibreOffice or other external tools required.
+
+```bash
+pom render slides.pom.xml -o ./images
+pom render slides.pom.md -o ./images
+```
+
+The images are written to the output directory as `slide-01.png`, `slide-02.png`, ... The directory is created if it does not exist. The rendering pipeline is the same as the preview server, so the images match what you see in `pom preview`.
+
+To output SVG instead of PNG:
+
+```bash
+pom render slides.pom.xml -o ./images --format svg
+```
+
+To render only specific slides (1-based, comma-separated) — useful when re-checking just the slides you edited:
+
+```bash
+pom render slides.pom.xml -o ./images --slides 2,5
+```
+
+To print per-step timing on stderr:
+
+```bash
+pom render slides.pom.xml -o ./images --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.
+This package bundles Carlito and Noto Sans CJK JP fonts for image rendering. These fonts are used when converting slides to SVG in the preview server and to PNG / SVG in `pom render`. System fonts are not scanned.
 
 ## License
 

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,CA0Cf;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

@@ -1,7 +1,8 @@
 import fs from "fs";
 import path from "path";
 import { buildPptx, DiagnosticsError } from "@hirokisakabe/pom";
-import { parseMd } from "@hirokisakabe/pom-md";
+import { loadInput } from "./input.js";
+import { watchInputFile } from "./watch.js";
 function makeLog(verbose) {
     if (!verbose)
         return (_msg) => { };
@@ -17,37 +18,7 @@ export async function runBuild(inputFile, outputFile, options = {}) {
         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;
-    let slideWidth = 1280;
-    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 {
-                masterPptxData = new Uint8Array(fs.readFileSync(masterPath));
-            }
-            catch (e) {
-                if (e instanceof Error && "code" in e && e.code === "ENOENT") {
-                    console.warn(`Warning: masterPptx not found: ${masterPath}`);
-                }
-                else {
-                    throw e;
-                }
-            }
-        }
-    }
-    else {
-        xml = content;
-    }
+    const { xml, slideWidth, slideHeight, masterPptxData } = loadInput(absInput, log);
     const t1 = Date.now();
     const { pptx } = await buildPptx(xml, { w: slideWidth, h: slideHeight }, {
         ...(masterPptxData ? { masterPptx: masterPptxData } : {}),
@@ -110,13 +81,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

@@ -4,12 +4,25 @@ import { Command } from "commander";
 import { DiagnosticsError } from "@hirokisakabe/pom";
 import { runBuild, runBuildWatch } from "./build.js";
 import { runPreview } from "./preview.js";
+import { runRender } from "./render.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const program = new Command();
+function printBuildError(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));
+    }
+}
 program
     .name("pom")
-    .description("CLI tool for pom — preview and build presentations")
+    .description("CLI tool for pom — preview, build, and render presentations")
     .version(version);
 program
     .command("preview")
@@ -17,6 +30,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 +41,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));
@@ -50,18 +67,41 @@ program
     }
     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));
-            }
+            printBuildError(err);
             process.exit(1);
         });
     }
 });
+program
+    .command("render")
+    .description("Render each slide to a PNG or SVG image")
+    .argument("<input>", "Input file (.pom.xml or .pom.md)")
+    .requiredOption("-o <dir>", "Output directory for rendered images")
+    .option("--format <format>", "Output format: png or svg", "png")
+    .option("--slides <numbers>", "Comma-separated slide numbers to render (e.g. 2,5)")
+    .option("--verbose", "Show build step timing on stderr")
+    .action((input, options) => {
+    if (options.format !== "png" && options.format !== "svg") {
+        console.error(`Invalid format: ${options.format} (expected "png" or "svg")`);
+        process.exit(1);
+    }
+    const format = options.format;
+    let slides;
+    if (options.slides !== undefined) {
+        slides = options.slides.split(",").map((s) => Number(s.trim()));
+        if (slides.length === 0 ||
+            slides.some((n) => !Number.isInteger(n) || n <= 0)) {
+            console.error(`Invalid slides: ${options.slides} (expected comma-separated slide numbers, e.g. 2,5)`);
+            process.exit(1);
+        }
+    }
+    runRender(input, options.o, {
+        format,
+        slides,
+        verbose: options.verbose,
+    }).catch((err) => {
+        printBuildError(err);
+        process.exit(1);
+    });
+});
 program.parse();

package/dist/glimpse.d.ts

@@ -0,0 +1,3 @@
+export declare const EXTRA_FONT_MAPPING: Record<string, string>;
+export declare function resolveBundledFontsDir(): string;
+//# sourceMappingURL=glimpse.d.ts.map

package/dist/glimpse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glimpse.d.ts","sourceRoot":"","sources":["../src/glimpse.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAEF,wBAAgB,sBAAsB,IAAI,MAAM,CAQ/C"}

package/dist/glimpse.js

@@ -0,0 +1,15 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export const EXTRA_FONT_MAPPING = {
+    "游ゴシック Light": "Noto Sans CJK JP",
+    "Yu Gothic Light": "Noto Sans CJK JP",
+};
+export function resolveBundledFontsDir() {
+    const fontsDir = path.resolve(__dirname, "../fonts");
+    if (!fs.existsSync(fontsDir)) {
+        throw new Error(`Bundled fonts directory not found: ${fontsDir}. The package may be corrupted.`);
+    }
+    return fontsDir;
+}

package/dist/input.d.ts

@@ -0,0 +1,8 @@
+export interface LoadedInput {
+    xml: string;
+    slideWidth: number;
+    slideHeight: number;
+    masterPptxData?: Uint8Array;
+}
+export declare function loadInput(absInput: string, log?: (msg: string) => void): LoadedInput;
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAe,GACpC,WAAW,CAqCb"}

package/dist/input.js

@@ -0,0 +1,37 @@
+import fs from "fs";
+import path from "path";
+import { parseMd } from "@hirokisakabe/pom-md";
+export function loadInput(absInput, log = () => { }) {
+    const content = fs.readFileSync(absInput, "utf-8");
+    const ext = path.extname(absInput);
+    let xml;
+    let slideWidth = 1280;
+    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 {
+                masterPptxData = new Uint8Array(fs.readFileSync(masterPath));
+            }
+            catch (e) {
+                if (e instanceof Error && "code" in e && e.code === "ENOENT") {
+                    console.warn(`Warning: masterPptx not found: ${masterPath}`);
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+    }
+    else {
+        xml = content;
+    }
+    return { xml, slideWidth, slideHeight, masterPptxData };
+}

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":"AAyWA,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,54 +1,43 @@
+import { spawn } from "child_process";
 import fs from "fs";
 import http from "http";
-import { fileURLToPath } from "url";
 import path from "path";
 import { buildPptx } from "@hirokisakabe/pom";
-import { parseMd } from "@hirokisakabe/pom-md";
 import { convertPptxToSvg } from "pptx-glimpse";
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
+import { EXTRA_FONT_MAPPING, resolveBundledFontsDir } from "./glimpse.js";
+import { loadInput } from "./input.js";
+import { watchInputFile } from "./watch.js";
 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, verbose = false) {
-    const log = makeLog(verbose);
-    const content = fs.readFileSync(inputFile, "utf-8");
-    const ext = path.extname(inputFile);
-    let xml;
-    let slideWidth = 1280;
-    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 {
-                masterPptxData = new Uint8Array(fs.readFileSync(masterPath));
-            }
-            catch (e) {
-                if (e instanceof Error && "code" in e && e.code === "ENOENT") {
-                    process.stderr.write(`Warning: masterPptx not found: ${masterPath}\n`);
-                }
-                else {
-                    throw e;
-                }
-            }
-        }
+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 {
-        xml = content;
+        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();
+}
+async function generateSvgs(inputFile, verbose = false) {
+    const log = makeLog(verbose);
+    const { xml, slideWidth, slideHeight, masterPptxData } = loadInput(inputFile, log);
     if (!xml.trim()) {
         return { type: "empty" };
     }
@@ -62,11 +51,7 @@ async function generateSvgs(inputFile, verbose = false) {
     if (!(buffer instanceof Uint8Array)) {
         throw new Error("Unexpected output type from pptx.write");
     }
-    const fontsDir = path.resolve(__dirname, "../fonts");
-    if (!fs.existsSync(fontsDir)) {
-        throw new Error(`Bundled fonts directory not found: ${fontsDir}. The package may be corrupted.`);
-    }
-    const fontDirs = [fontsDir];
+    const fontDirs = [resolveBundledFontsDir()];
     const t2 = Date.now();
     const slides = await convertPptxToSvg(buffer, {
         width: slideWidth,
@@ -371,7 +356,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 +378,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 +444,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/render.d.ts

@@ -0,0 +1,7 @@
+export type RenderFormat = "png" | "svg";
+export declare function runRender(inputFile: string, outputDir: string, options?: {
+    format?: RenderFormat;
+    slides?: number[];
+    verbose?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAOzC,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,GACL,OAAO,CAAC,IAAI,CAAC,CAoFf"}

package/dist/render.js

@@ -0,0 +1,71 @@
+import fs from "fs";
+import path from "path";
+import { buildPptx } from "@hirokisakabe/pom";
+import { convertPptxToPng, convertPptxToSvg } from "pptx-glimpse";
+import { EXTRA_FONT_MAPPING, resolveBundledFontsDir } from "./glimpse.js";
+import { loadInput } from "./input.js";
+function makeLog(verbose) {
+    if (!verbose)
+        return (_msg) => { };
+    return (msg) => process.stderr.write(`[pom] ${msg}\n`);
+}
+export async function runRender(inputFile, outputDir, options = {}) {
+    const verbose = options.verbose ?? false;
+    const format = options.format ?? "png";
+    const log = makeLog(verbose);
+    const totalStart = Date.now();
+    const absInput = path.resolve(inputFile);
+    const absOutputDir = path.resolve(outputDir);
+    if (!fs.existsSync(absInput)) {
+        throw new Error(`Input file not found: ${absInput}`);
+    }
+    log(`Reading file: ${absInput}`);
+    const { xml, slideWidth, slideHeight, masterPptxData } = loadInput(absInput, log);
+    const t1 = Date.now();
+    const { pptx } = await buildPptx(xml, { w: slideWidth, h: slideHeight }, {
+        textMeasurement: "fallback",
+        ...(masterPptxData ? { masterPptx: masterPptxData } : {}),
+        strict: true,
+    });
+    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");
+    }
+    const convertOptions = {
+        width: slideWidth,
+        fontDirs: [resolveBundledFontsDir()],
+        fontMapping: EXTRA_FONT_MAPPING,
+        skipSystemFonts: true,
+        ...(options.slides ? { slides: options.slides } : {}),
+    };
+    const t2 = Date.now();
+    let outputs;
+    if (format === "svg") {
+        const slides = await convertPptxToSvg(buffer, convertOptions);
+        outputs = slides.map((s) => ({ slideNumber: s.slideNumber, data: s.svg }));
+    }
+    else {
+        const slides = await convertPptxToPng(buffer, convertOptions);
+        outputs = slides.map((s) => ({ slideNumber: s.slideNumber, data: s.png }));
+    }
+    log(`Rendering ${format.toUpperCase()}... done (${Date.now() - t2}ms)`);
+    if (options.slides) {
+        const rendered = new Set(outputs.map((o) => o.slideNumber));
+        const missing = options.slides.filter((n) => !rendered.has(n));
+        if (missing.length > 0) {
+            console.warn(`Warning: slide ${missing.join(", ")} not found in the presentation`);
+        }
+    }
+    if (outputs.length === 0) {
+        throw new Error("No slides were rendered");
+    }
+    fs.mkdirSync(absOutputDir, { recursive: true });
+    const padWidth = Math.max(2, ...outputs.map((o) => String(o.slideNumber).length));
+    for (const { slideNumber, data } of outputs) {
+        const file = path.join(absOutputDir, `slide-${String(slideNumber).padStart(padWidth, "0")}.${format}`);
+        fs.writeFileSync(file, data);
+        console.log(`Saved: ${file}`);
+    }
+    log(`Total: ${Date.now() - totalStart}ms`);
+}

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,7 +1,7 @@
 {
   "name": "@hirokisakabe/pom-cli",
-  "version": "0.3.2",
-  "description": "CLI tool for pom — preview and build presentations",
+  "version": "0.5.0",
+  "description": "CLI tool for pom — preview, build, and render presentations",
   "type": "module",
   "bin": {
     "pom": "./dist/cli.js"
@@ -30,14 +30,14 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@hirokisakabe/pom": "^8.2.1",
+    "@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')\"",