quicklook-pptx-renderer 0.3.1 → 0.3.2

package/README.md

@@ -165,6 +165,11 @@ for (const issue of result.issues) {
       // issue.fix.childCount = 5, issue.fix.containsPictures = false
       // Promote group children to slide-level drawables
       break;
+
+    case "strip-embedded-fonts":
+      // issue.fix.fonts = [{ name: "Montserrat", replacement: "Nunito Sans" }]
+      // Strip embedded font data and replace with cross-platform alternatives
+      break;
   }
 }
 ```
@@ -189,6 +194,7 @@ Every issue carries a typed `fix` object with machine-readable remediation data
 | `geometry-forces-pdf` | info | Non-rect geometry renders as PDF — opaque background may cover adjacent content | — |
 | `rotation-forces-pdf` | info | Rotated rect renders as PDF — enlarged bounding box may cover adjacent content | — |
 | `text-inscription-shift` | info | Text in non-rect shape uses geometry-inscribed bounds (text may shift) | `replace-geometry` (suggests `rect`) |
+| `embedded-font` | warn | Embedded fonts ignored by QuickLook — text renders with system substitutes | `strip-embedded-fonts` (includes per-font replacement when metrics available) |
 | `vertical-text` | info | Vertical text uses CSS writing-mode | — |
 
 ---

package/dist/lint.d.ts

@@ -9,7 +9,7 @@
  * re-detecting the problem.
  */
 export type Severity = "error" | "warn" | "info";
-export type RuleId = "unsupported-geometry" | "opaque-pdf-block" | "gradient-flattened" | "font-substitution" | "table-style-unresolved" | "group-as-pdf" | "chart-no-fallback" | "text-inscription-shift" | "rotation-forces-pdf" | "geometry-forces-pdf" | "vertical-text";
+export type RuleId = "unsupported-geometry" | "opaque-pdf-block" | "gradient-flattened" | "font-substitution" | "table-style-unresolved" | "group-as-pdf" | "chart-no-fallback" | "text-inscription-shift" | "rotation-forces-pdf" | "geometry-forces-pdf" | "vertical-text" | "embedded-font";
 /** Machine-readable remediation data — one variant per fix strategy. */
 export type LintFix = {
     action: "replace-geometry";
@@ -41,6 +41,12 @@ export type LintFix = {
     action: "ungroup";
     childCount: number;
     containsPictures: boolean;
+} | {
+    action: "strip-embedded-fonts";
+    fonts: Array<{
+        name: string;
+        replacement?: string;
+    }>;
 };
 export interface LintIssue {
     rule: RuleId;

package/dist/lint.js

@@ -105,6 +105,40 @@ export async function lint(pptxBuffer) {
     const pkg = await PptxPackage.open(pptxBuffer);
     const pres = await readPresentation(pkg);
     const issues = [];
+    // Presentation-level: detect embedded fonts (QuickLook ignores them)
+    const presXml = await pkg.getPartXml("ppt/presentation.xml");
+    const presNode = presXml?.Presentation ?? presXml?.presentation ?? presXml ?? {};
+    const embFontLst = presNode.embeddedFontLst?.embeddedFont;
+    if (embFontLst) {
+        const entries = Array.isArray(embFontLst) ? embFontLst : [embFontLst];
+        const safeCandidates = Object.keys(FONT_METRICS).filter(f => !FONT_SUBSTITUTIONS[f]);
+        const fonts = [];
+        for (const entry of entries) {
+            const name = entry.font?.["@_typeface"];
+            if (!name)
+                continue;
+            let replacement;
+            if (FONT_METRICS[name]) {
+                const matches = findClosestFont(name, { candidates: safeCandidates, sameCategory: true, limit: 1 });
+                if (matches.length > 0)
+                    replacement = matches[0].font;
+            }
+            fonts.push({ name, replacement });
+        }
+        if (fonts.length > 0) {
+            const details = fonts.map(f => f.replacement ? `${f.name} → ${f.replacement}` : f.name).join(", ");
+            issues.push({
+                rule: "embedded-font",
+                severity: "warn",
+                slide: 0,
+                message: `Embedded font${fonts.length > 1 ? "s" : ""}: ${details} — QuickLook ignores embedded fonts, text will render with system substitutes`,
+                suggestion: fonts.some(f => f.replacement)
+                    ? `Strip embedded data and replace with cross-platform alternatives`
+                    : `Remove embedded fonts to reduce file size; use cross-platform fonts instead`,
+                fix: { action: "strip-embedded-fonts", fonts },
+            });
+        }
+    }
     for (let i = 0; i < pres.slides.length; i++) {
         const slide = pres.slides[i];
         const slideNum = i + 1;
@@ -431,7 +465,7 @@ export function formatIssues(result) {
     for (const issue of result.issues) {
         if (issue.slide !== currentSlide) {
             currentSlide = issue.slide;
-            lines.push(`\nSlide ${currentSlide}:`);
+            lines.push(currentSlide === 0 ? `\nPresentation:` : `\nSlide ${currentSlide}:`);
         }
         const icon = SEVERITY_ICON[issue.severity];
         const elem = issue.element ? ` (${issue.element})` : "";

package/dist/package/package.js

@@ -8,7 +8,7 @@ const ARRAY_ELEMENTS = new Set([
     "AlternateContent",
     "p", "r", "br", "fld",
     "tr", "tc", "gridCol",
-    "gs", "gd", "font",
+    "gs", "gd", "font", "embeddedFont",
     "effectStyle",
     "Relationship", "Default", "Override",
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quicklook-pptx-renderer",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "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",