@hirokisakabe/pom-cli 0.6.6 → 0.8.0

package/README.md

@@ -15,13 +15,14 @@
 - **Live Preview Server** — `pom preview` opens a browser, watches the source file, and rebuilds + reloads on every save (handles editor atomic writes like Vim).
 - **PPTX Build** — `pom build` converts `.pom.xml` / `.pom.md` to a `.pptx` file, with optional `--watch` mode for incremental rebuilds.
 - **PNG / SVG Render** — `pom render` rasterizes each slide to PNG (default) or SVG without LibreOffice, useful for slide-image previews in docs.
+- **Theme Extraction** — `pom theme extract` reads an existing `.pptx` and prints its theme colors as pom `ThemeTokens` JSON, for onboarding brand assets.
 - **Diagnostic Surfacing** — Layout, image, master, and auto-fit diagnostics from `buildPptx` fail the run on stderr with a non-zero exit (`pom build` / `pom render`), while `pom preview` keeps updating so issues can be fixed interactively.
 - **Bundled Fonts** — Carlito and Noto Sans CJK JP are bundled for SVG / PNG rendering, so output looks the same on machines without those fonts installed.
 - **Configurable Output** — Choose port, target slides, output format, text rendering mode (`path` outlines vs native `<text>`), and verbose per-step timing.
 
 ## Installation
 
-> Requires Node.js 18+
+> Requires Node.js 22+
 
 ```bash
 npm install -g @hirokisakabe/pom-cli
@@ -113,6 +114,8 @@ 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`.
 
+> **LibreOffice fallback caveat:** Current `pom render` uses `pptx-glimpse` directly and does not require LibreOffice. If you are using an older `pom-cli` / `pptx-glimpse` version or a fallback workflow that converts PPTX through LibreOffice before PNG output, pure numeric text with leading zeros (for example `01` / `001`) may be displayed without those zeros in the PNG (`01` -> `1`). The generated PPTX keeps the original text (`<a:t>01</a:t>`), so it displays as intended when opened in PowerPoint. For decorative numbering that must survive both paths, mix in one non-numeric character such as `01.` or `#01`.
+
 To output SVG instead of PNG:
 
 ```bash
@@ -137,6 +140,16 @@ To print per-step timing on stderr:
 pom render slides.pom.xml -o ./images --verbose
 ```
 
+### Theme Extract
+
+Extracts PowerPoint theme colors from an existing `.pptx` as pom `ThemeTokens` JSON — useful for onboarding brand assets (e.g. the `pom-theme` agent skill).
+
+```bash
+pom theme extract brand-master.pptx
+```
+
+Prints a JSON array to stdout with one entry per visible slide layout (`text` / `background` / `primary` / `secondary` / `accent3`–`accent6`, all 6-digit uppercase hex prefixed with `#`), preserving the source master/layout order.
+
 ## Diagnostics
 
 `pom build` and `pom render` invoke `buildPptx` with `strict: true`, so any diagnostic collected during the build — layout problems (`NODE_OUT_OF_BOUNDS`, `NODE_OVERLAP`, `ARROW_REF_NOT_FOUND`, `PER_SIDE_BORDER_WITH_RADIUS`), image / master issues (`IMAGE_MEASURE_FAILED`, `IMAGE_NOT_PREFETCHED`, `MASTER_PPTX_PARSE_FAILED`), or `AUTOFIT_OVERFLOW` — fails the run with a non-zero exit code and prints the diagnostic codes / messages to stderr. Fix the offending XML or input and re-run to proceed. The `pom preview` server continues to update even when diagnostics are emitted, so you can iterate on the file interactively.

package/dist/cli.js

@@ -5,6 +5,7 @@ import { DiagnosticsError } from "@hirokisakabe/pom";
 import { runBuild, runBuildWatch } from "./build.js";
 import { runPreview } from "./preview.js";
 import { runRender } from "./render.js";
+import { runThemeExtract } from "./theme.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const program = new Command();
@@ -117,4 +118,15 @@ program
         process.exit(1);
     });
 });
+const theme = program.command("theme").description("Theme-related utilities");
+theme
+    .command("extract")
+    .description("Extract PowerPoint theme colors as pom ThemeTokens JSON (one entry per visible slide layout)")
+    .argument("<pptx>", "Input PPTX file")
+    .action((pptx) => {
+    runThemeExtract(pptx).catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+});
 program.parse();

package/dist/preview.js

@@ -55,7 +55,7 @@ async function generateSvgs(inputFile, verbose = false) {
     const t2 = Date.now();
     // インライン SVG なのでネイティブ <text> + サブセットフォント埋め込みが使える。
     // ブラウザのテキスト描画 (ヒンティング等) が効き、テキスト選択も可能になる
-    const slides = await convertPptxToSvg(buffer, {
+    const { slides } = await convertPptxToSvg(buffer, {
         width: slideWidth,
         fontDirs,
         fontMapping: EXTRA_FONT_MAPPING,

package/dist/render.js

@@ -42,14 +42,14 @@ export async function runRender(inputFile, outputDir, options = {}) {
     const t2 = Date.now();
     let outputs;
     if (format === "svg") {
-        const slides = await convertPptxToSvg(buffer, {
+        const { slides } = await convertPptxToSvg(buffer, {
             ...convertOptions,
             ...(options.textOutput ? { textOutput: options.textOutput } : {}),
         });
         outputs = slides.map((s) => ({ slideNumber: s.slideNumber, data: s.svg }));
     }
     else {
-        const slides = await convertPptxToPng(buffer, convertOptions);
+        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)`);

package/dist/theme.d.ts

@@ -0,0 +1,2 @@
+export declare function runThemeExtract(inputFile: string): Promise<void>;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAIA,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE"}

package/dist/theme.js

@@ -0,0 +1,12 @@
+import fs from "fs";
+import path from "path";
+import { extractThemeTokensFromPptx } from "@hirokisakabe/pom";
+export async function runThemeExtract(inputFile) {
+    const absInput = path.resolve(inputFile);
+    if (!fs.existsSync(absInput)) {
+        throw new Error(`Input file not found: ${absInput}`);
+    }
+    const buffer = fs.readFileSync(absInput);
+    const tokens = await extractThemeTokensFromPptx(buffer);
+    console.log(JSON.stringify(tokens, null, 2));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirokisakabe/pom-cli",
-  "version": "0.6.6",
+  "version": "0.8.0",
   "description": "CLI tool for pom — preview, build, and render presentations",
   "type": "module",
   "bin": {
@@ -27,16 +27,16 @@
   "license": "MIT",
   "author": "Hiroki Sakabe",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "dependencies": {
-    "@hirokisakabe/pom": "^8.9.0",
-    "@hirokisakabe/pom-md": "^3.0.0",
+    "@hirokisakabe/pom": "^9.1.0",
+    "@hirokisakabe/pom-md": "^4.0.0",
     "commander": "^15.0.0",
-    "pptx-glimpse": "^1.1.1"
+    "pptx-glimpse": "^2.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.9.3"
+    "@types/node": "^26.1.0"
   },
   "scripts": {
     "build": "tsc && node -e \"require('fs').chmodSync('dist/cli.js', '755')\"",