quicklook-pptx-renderer 0.2.1 → 0.2.3

package/README.md

@@ -51,7 +51,7 @@ Slide 4:
   [ERR ] "cloud" is not supported by OfficeImport — shape will be invisible (Shape 12)
          -> Use a supported preset or embed as an image
 
-0 errors, 3 warnings, 2 info across 18 slides
+0 errors, 5 warnings, 0 info across 18 slides
 ```
 
 ```bash
@@ -128,9 +128,9 @@ for (const issue of result.issues) {
 | `table-style-unresolved` | warn | Table style reference that OfficeImport won't resolve |
 | `text-inscription-shift` | warn | Text in non-rect shape uses geometry-inscribed bounds (text may shift) |
 | `font-substitution` | warn/info | Font will be substituted on macOS — includes width delta (warn if ≥10% reflow risk) |
-| `effect-forces-pdf` | info | Non-rect shape rendered as opaque PDF instead of CSS |
-| `rotation-forces-pdf` | info | Rotated rect rendered as opaque PDF instead of CSS |
-| `group-as-pdf` | info | Group rendered as single opaque PDF image |
+| `effect-forces-pdf` | warn | Non-rect shape rendered as opaque PDF instead of CSS |
+| `rotation-forces-pdf` | warn | Rotated rect rendered as opaque PDF instead of CSS |
+| `group-as-pdf` | warn | Group rendered as single opaque PDF image |
 | `vertical-text` | info | Vertical text uses CSS writing-mode |
 
 ---

package/dist/cli.js

@@ -19,7 +19,7 @@ function hasFlag(args, name) {
 function positional(args) {
     const out = [];
     for (let i = 0; i < args.length; i++) {
-        if (args[i].startsWith("--")) {
+        if (args[i].startsWith("--") || args[i] === "-o") {
             i++;
             continue;
         }
@@ -46,17 +46,18 @@ async function cmdRender(args) {
     const width = Number(getFlag(args, "--width") ?? 1920);
     const scale = Number(getFlag(args, "--scale") ?? 2);
     const slideNum = getFlag(args, "--slide");
-    const outPath = getFlag(args, "--out");
+    const outPath = getFlag(args, "--out") ?? getFlag(args, "-o");
     const all = hasFlag(args, "--all") || !slideNum;
     const pptxBuf = await readFile(resolve(input));
     const pkg = await PptxPackage.open(pptxBuf);
     const pres = await readPresentation(pkg);
     if (all) {
-        const outDir = outPath ? dirname(outPath) : ".";
+        const singleFile = outPath && pres.slides.length === 1;
+        const outDir = singleFile ? dirname(outPath) : (outPath ?? ".");
         await mkdir(outDir, { recursive: true });
         for (let i = 0; i < pres.slides.length; i++) {
             const png = await renderSlide(pres.slides[i], pres, { width, scale, pkg, slideIndex: i });
-            const dest = outPath && pres.slides.length === 1
+            const dest = singleFile
                 ? resolve(outPath)
                 : resolve(outDir, `slide-${i + 1}.png`);
             await writeFile(dest, png);
@@ -82,7 +83,7 @@ async function cmdHtml(args) {
         console.error(`Usage: ${BIN} html <input.pptx> [--out output.html]`);
         process.exit(1);
     }
-    const outPath = getFlag(args, "--out");
+    const outPath = getFlag(args, "--out") ?? getFlag(args, "-o") ?? pos[1];
     const pptxBuf = await readFile(resolve(input));
     const pkg = await PptxPackage.open(pptxBuf);
     const pres = await readPresentation(pkg);
@@ -155,7 +156,12 @@ async function cmdLint(args) {
         process.exit(1);
 }
 // ── Main ───────────────────────────────────────────────────────────
-const [command, ...args] = process.argv.slice(2);
+const allArgs = process.argv.slice(2);
+if (allArgs.includes("--version") || allArgs.includes("-v")) {
+    console.log("0.2.3");
+    process.exit(0);
+}
+const [command, ...args] = allArgs;
 switch (command) {
     case "render":
         await cmdRender(args);

package/dist/lint.js

@@ -121,17 +121,19 @@ function lintShape(shape, slide, issues) {
         else if (geom !== "rect") {
             issues.push({
                 rule: "effect-forces-pdf",
-                severity: "info",
+                severity: "warn",
                 slide, element: name,
                 message: `"${geom}" renders as PDF in QuickLook (only plain rect uses CSS)`,
+                suggestion: `Use rect geometry to keep CSS rendering, or accept PDF output`,
             });
         }
         if (hasRotation && geom === "rect") {
             issues.push({
                 rule: "rotation-forces-pdf",
-                severity: "info",
+                severity: "warn",
                 slide, element: name,
                 message: `Rotated rect renders as PDF instead of CSS div`,
+                suggestion: `Remove rotation or accept PDF rendering`,
             });
         }
     }
@@ -179,9 +181,10 @@ function lintGroup(group, slide, issues) {
     const name = group.name || `group #${group.id}`;
     issues.push({
         rule: "group-as-pdf",
-        severity: "info",
+        severity: "warn",
         slide, element: name,
         message: `Group renders as single PDF image in QuickLook — all children merged into one opaque block`,
+        suggestion: `Ungroup shapes for individual rendering, or accept merged PDF`,
     });
     // Still lint children for their own issues
     lintDrawables(group.children, slide, issues);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quicklook-pptx-renderer",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Open-source PPTX rendering engine that replicates Apple's macOS QuickLook and iOS preview — pixel for pixel. Test how PowerPoint files look on Mac/iPhone without a Mac.",
   "type": "module",
   "main": "dist/index.js",
@@ -12,8 +12,11 @@
     "pptx", "powerpoint", "quicklook", "macos", "ios", "officeimport",
     "pptx-to-html", "pptx-to-png", "ooxml", "office-open-xml",
     "presentation", "renderer", "preview", "apple", "webkit",
-    "python-pptx", "pptxgenjs", "document-viewer", "cross-platform",
-    "slides", "converter", "thumbnail", "lint", "compatibility"
+    "python-pptx", "pptxgenjs", "cross-platform", "lint", "compatibility",
+    "iphone", "ipad", "finder", "font-metrics", "font-fallback",
+    "table-borders", "shapes", "gradients", "rendering",
+    "google-slides", "canva", "libreoffice", "pandoc",
+    "pptx-linter", "pptx-validator", "slides"
   ],
   "exports": {
     ".": {