@hirokisakabe/pom-cli 0.4.0 → 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
 
@@ -83,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":"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"}
+{"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,7 @@
 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)
@@ -18,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 } : {}),

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")
@@ -54,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.map

@@ -1 +1 @@
-{"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"}
+{"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,13 +1,12 @@
 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";
+import { EXTRA_FONT_MAPPING, resolveBundledFontsDir } from "./glimpse.js";
+import { loadInput } from "./input.js";
 import { watchInputFile } from "./watch.js";
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const DEFAULT_PORT = 3000;
 function makeLog(verbose) {
     if (!verbose)
@@ -36,43 +35,9 @@ function openBrowser(url) {
     });
     child.unref();
 }
-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;
-                }
-            }
-        }
-    }
-    else {
-        xml = content;
-    }
+    const { xml, slideWidth, slideHeight, masterPptxData } = loadInput(inputFile, log);
     if (!xml.trim()) {
         return { type: "empty" };
     }
@@ -86,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,

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hirokisakabe/pom-cli",
-  "version": "0.4.0",
-  "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"