quicklook-pptx-renderer 0.1.0

package/dist/resolve/color-resolver.js

@@ -0,0 +1,321 @@
+// ── Public API ──────────────────────────────────────────────────────
+export function resolveColor(color, colorMap, colorScheme) {
+    let base;
+    switch (color.type) {
+        case "rgb":
+            base = { r: color.r, g: color.g, b: color.b, a: 1 };
+            break;
+        case "scRgb":
+            base = {
+                r: Math.round((color.r / 100000) * 255),
+                g: Math.round((color.g / 100000) * 255),
+                b: Math.round((color.b / 100000) * 255),
+                a: 1,
+            };
+            break;
+        case "hsl":
+            base = { ...hslToRgb(color.hue / 60000, color.sat / 100000, color.lum / 100000), a: 1 };
+            break;
+        case "preset":
+            base = { ...resolvePreset(color.val), a: 1 };
+            break;
+        case "system":
+            base = { ...resolveSystem(color.val, color.lastClr), a: 1 };
+            break;
+        case "scheme": {
+            const mapped = resolveSchemeToBase(color.val, colorMap, colorScheme);
+            base = resolveColor(mapped, colorMap, colorScheme);
+            break;
+        }
+    }
+    return applyTransforms(base, color.transforms);
+}
+// ── Scheme resolution ───────────────────────────────────────────────
+const COLOR_MAP_KEYS = new Set(["bg1", "tx1", "bg2", "tx2"]);
+function resolveSchemeToBase(val, colorMap, colorScheme) {
+    const schemeName = COLOR_MAP_KEYS.has(val)
+        ? colorMap.mappings[val]
+        : val;
+    return colorScheme.colors[schemeName] ?? { type: "rgb", r: 0, g: 0, b: 0 };
+}
+// ── System colors ───────────────────────────────────────────────────
+const SYSTEM_COLORS = {
+    windowText: { r: 0, g: 0, b: 0 },
+    window: { r: 255, g: 255, b: 255 },
+    highlightText: { r: 255, g: 255, b: 255 },
+    highlight: { r: 0, g: 120, b: 215 },
+    grayText: { r: 128, g: 128, b: 128 },
+    btnFace: { r: 240, g: 240, b: 240 },
+    btnText: { r: 0, g: 0, b: 0 },
+    captionText: { r: 0, g: 0, b: 0 },
+    menuText: { r: 0, g: 0, b: 0 },
+    infoText: { r: 0, g: 0, b: 0 },
+    infoBk: { r: 255, g: 255, b: 225 },
+    btnHighlight: { r: 255, g: 255, b: 255 },
+    "3dDkShadow": { r: 105, g: 105, b: 105 },
+    "3dLight": { r: 227, g: 227, b: 227 },
+    activeBorder: { r: 180, g: 180, b: 180 },
+    activeCaption: { r: 153, g: 180, b: 209 },
+    appWorkspace: { r: 171, g: 171, b: 171 },
+    background: { r: 0, g: 0, b: 0 },
+    btnShadow: { r: 160, g: 160, b: 160 },
+    inactiveCaption: { r: 191, g: 205, b: 219 },
+    inactiveBorder: { r: 244, g: 247, b: 252 },
+    inactiveCaptionText: { r: 0, g: 0, b: 0 },
+    menu: { r: 240, g: 240, b: 240 },
+    menuBar: { r: 240, g: 240, b: 240 },
+    menuHighlight: { r: 0, g: 120, b: 215 },
+    scrollBar: { r: 200, g: 200, b: 200 },
+    windowFrame: { r: 100, g: 100, b: 100 },
+};
+function parseHex(hex) {
+    const h = hex.replace(/^#/, "");
+    return {
+        r: parseInt(h.slice(0, 2), 16),
+        g: parseInt(h.slice(2, 4), 16),
+        b: parseInt(h.slice(4, 6), 16),
+    };
+}
+function resolveSystem(val, lastClr) {
+    return SYSTEM_COLORS[val] ?? (lastClr ? parseHex(lastClr) : { r: 0, g: 0, b: 0 });
+}
+// ── Preset colors ───────────────────────────────────────────────────
+const PRESET_COLORS = {
+    aliceBlue: { r: 240, g: 248, b: 255 }, antiqueWhite: { r: 250, g: 235, b: 215 },
+    aqua: { r: 0, g: 255, b: 255 }, aquamarine: { r: 127, g: 255, b: 212 },
+    azure: { r: 240, g: 255, b: 255 }, beige: { r: 245, g: 245, b: 220 },
+    bisque: { r: 255, g: 228, b: 196 }, black: { r: 0, g: 0, b: 0 },
+    blanchedAlmond: { r: 255, g: 235, b: 205 }, blue: { r: 0, g: 0, b: 255 },
+    blueViolet: { r: 138, g: 43, b: 226 }, brown: { r: 165, g: 42, b: 42 },
+    burlyWood: { r: 222, g: 184, b: 135 }, cadetBlue: { r: 95, g: 158, b: 160 },
+    chartreuse: { r: 127, g: 255, b: 0 }, chocolate: { r: 210, g: 105, b: 30 },
+    coral: { r: 255, g: 127, b: 80 }, cornflowerBlue: { r: 100, g: 149, b: 237 },
+    cornsilk: { r: 255, g: 248, b: 220 }, crimson: { r: 220, g: 20, b: 60 },
+    cyan: { r: 0, g: 255, b: 255 }, dkBlue: { r: 0, g: 0, b: 139 },
+    dkCyan: { r: 0, g: 139, b: 139 }, dkGoldenrod: { r: 184, g: 134, b: 11 },
+    dkGray: { r: 169, g: 169, b: 169 }, dkGreen: { r: 0, g: 100, b: 0 },
+    dkKhaki: { r: 189, g: 183, b: 107 }, dkMagenta: { r: 139, g: 0, b: 139 },
+    dkOliveGreen: { r: 85, g: 107, b: 47 }, dkOrange: { r: 255, g: 140, b: 0 },
+    dkOrchid: { r: 153, g: 50, b: 204 }, dkRed: { r: 139, g: 0, b: 0 },
+    dkSalmon: { r: 233, g: 150, b: 122 }, dkSeaGreen: { r: 143, g: 188, b: 143 },
+    dkSlateBlue: { r: 72, g: 61, b: 139 }, dkSlateGray: { r: 47, g: 79, b: 79 },
+    dkTurquoise: { r: 0, g: 206, b: 209 }, dkViolet: { r: 148, g: 0, b: 211 },
+    deepPink: { r: 255, g: 20, b: 147 }, deepSkyBlue: { r: 0, g: 191, b: 255 },
+    dimGray: { r: 105, g: 105, b: 105 }, dodgerBlue: { r: 30, g: 144, b: 255 },
+    firebrick: { r: 178, g: 34, b: 34 }, floralWhite: { r: 255, g: 250, b: 240 },
+    forestGreen: { r: 34, g: 139, b: 34 }, fuchsia: { r: 255, g: 0, b: 255 },
+    gainsboro: { r: 220, g: 220, b: 220 }, ghostWhite: { r: 248, g: 248, b: 255 },
+    gold: { r: 255, g: 215, b: 0 }, goldenrod: { r: 218, g: 165, b: 32 },
+    gray: { r: 128, g: 128, b: 128 }, green: { r: 0, g: 128, b: 0 },
+    greenYellow: { r: 173, g: 255, b: 47 }, honeydew: { r: 240, g: 255, b: 240 },
+    hotPink: { r: 255, g: 105, b: 180 }, indianRed: { r: 205, g: 92, b: 92 },
+    indigo: { r: 75, g: 0, b: 130 }, ivory: { r: 255, g: 255, b: 240 },
+    khaki: { r: 240, g: 230, b: 140 }, lavender: { r: 230, g: 230, b: 250 },
+    lavenderBlush: { r: 255, g: 240, b: 245 }, lawnGreen: { r: 124, g: 252, b: 0 },
+    lemonChiffon: { r: 255, g: 250, b: 205 }, ltBlue: { r: 173, g: 216, b: 230 },
+    ltCoral: { r: 240, g: 128, b: 128 }, ltCyan: { r: 224, g: 255, b: 255 },
+    ltGoldenrodYellow: { r: 250, g: 250, b: 210 }, ltGray: { r: 211, g: 211, b: 211 },
+    ltGreen: { r: 144, g: 238, b: 144 }, ltPink: { r: 255, g: 182, b: 193 },
+    ltSalmon: { r: 255, g: 160, b: 122 }, ltSeaGreen: { r: 32, g: 178, b: 170 },
+    ltSkyBlue: { r: 135, g: 206, b: 250 }, ltSlateGray: { r: 119, g: 136, b: 153 },
+    ltSteelBlue: { r: 176, g: 196, b: 222 }, ltYellow: { r: 255, g: 255, b: 224 },
+    lime: { r: 0, g: 255, b: 0 }, limeGreen: { r: 50, g: 205, b: 50 },
+    linen: { r: 250, g: 240, b: 230 }, magenta: { r: 255, g: 0, b: 255 },
+    maroon: { r: 128, g: 0, b: 0 }, medAquamarine: { r: 102, g: 205, b: 170 },
+    medBlue: { r: 0, g: 0, b: 205 }, medOrchid: { r: 186, g: 85, b: 211 },
+    medPurple: { r: 147, g: 112, b: 219 }, medSeaGreen: { r: 60, g: 179, b: 113 },
+    medSlateBlue: { r: 123, g: 104, b: 238 }, medSpringGreen: { r: 0, g: 250, b: 154 },
+    medTurquoise: { r: 72, g: 209, b: 204 }, medVioletRed: { r: 199, g: 21, b: 133 },
+    midnightBlue: { r: 25, g: 25, b: 112 }, mintCream: { r: 245, g: 255, b: 250 },
+    mistyRose: { r: 255, g: 228, b: 225 }, moccasin: { r: 255, g: 228, b: 181 },
+    navajoWhite: { r: 255, g: 222, b: 173 }, navy: { r: 0, g: 0, b: 128 },
+    oldLace: { r: 253, g: 245, b: 230 }, olive: { r: 128, g: 128, b: 0 },
+    oliveDrab: { r: 107, g: 142, b: 35 }, orange: { r: 255, g: 165, b: 0 },
+    orangeRed: { r: 255, g: 69, b: 0 }, orchid: { r: 218, g: 112, b: 214 },
+    paleGoldenrod: { r: 238, g: 232, b: 170 }, paleGreen: { r: 152, g: 251, b: 152 },
+    paleTurquoise: { r: 175, g: 238, b: 238 }, paleVioletRed: { r: 219, g: 112, b: 147 },
+    papayaWhip: { r: 255, g: 239, b: 213 }, peachPuff: { r: 255, g: 218, b: 185 },
+    peru: { r: 205, g: 133, b: 63 }, pink: { r: 255, g: 192, b: 203 },
+    plum: { r: 221, g: 160, b: 221 }, powderBlue: { r: 176, g: 224, b: 230 },
+    purple: { r: 128, g: 0, b: 128 }, red: { r: 255, g: 0, b: 0 },
+    rosyBrown: { r: 188, g: 143, b: 143 }, royalBlue: { r: 65, g: 105, b: 225 },
+    saddleBrown: { r: 139, g: 69, b: 19 }, salmon: { r: 250, g: 128, b: 114 },
+    sandyBrown: { r: 244, g: 164, b: 96 }, seaGreen: { r: 46, g: 139, b: 87 },
+    seaShell: { r: 255, g: 245, b: 238 }, sienna: { r: 160, g: 82, b: 45 },
+    silver: { r: 192, g: 192, b: 192 }, skyBlue: { r: 135, g: 206, b: 235 },
+    slateBlue: { r: 106, g: 90, b: 205 }, slateGray: { r: 112, g: 128, b: 144 },
+    snow: { r: 255, g: 250, b: 250 }, springGreen: { r: 0, g: 255, b: 127 },
+    steelBlue: { r: 70, g: 130, b: 180 }, tan: { r: 210, g: 180, b: 140 },
+    teal: { r: 0, g: 128, b: 128 }, thistle: { r: 216, g: 191, b: 216 },
+    tomato: { r: 255, g: 99, b: 71 }, turquoise: { r: 64, g: 224, b: 208 },
+    violet: { r: 238, g: 130, b: 238 }, wheat: { r: 245, g: 222, b: 179 },
+    white: { r: 255, g: 255, b: 255 }, whiteSmoke: { r: 245, g: 245, b: 245 },
+    yellow: { r: 255, g: 255, b: 0 }, yellowGreen: { r: 154, g: 205, b: 50 },
+};
+function resolvePreset(val) {
+    return PRESET_COLORS[val] ?? { r: 0, g: 0, b: 0 };
+}
+// ── Transform application ───────────────────────────────────────────
+function applyTransforms(rgba, transforms) {
+    if (!transforms)
+        return rgba;
+    let { r, g, b, a } = rgba;
+    for (const t of transforms) {
+        const v = (t.val ?? 0) / 100000;
+        switch (t.type) {
+            case "alpha":
+                a = v;
+                break;
+            case "alphaMod":
+                a *= v;
+                break;
+            case "alphaOff":
+                a += v;
+                break;
+            case "tint": {
+                r = r + (255 - r) * v;
+                g = g + (255 - g) * v;
+                b = b + (255 - b) * v;
+                break;
+            }
+            case "shade": {
+                r *= v;
+                g *= v;
+                b *= v;
+                break;
+            }
+            case "lumMod":
+            case "lumOff":
+            case "satMod":
+            case "satOff":
+            case "hueMod":
+            case "hueOff": {
+                const hsl = rgbToHsl(r, g, b);
+                if (t.type === "lumMod")
+                    hsl.l *= v;
+                else if (t.type === "lumOff")
+                    hsl.l += v;
+                else if (t.type === "satMod")
+                    hsl.s *= v;
+                else if (t.type === "satOff")
+                    hsl.s += v;
+                else if (t.type === "hueMod")
+                    hsl.h *= v;
+                else
+                    hsl.h += v * 360;
+                hsl.l = clamp01(hsl.l);
+                hsl.s = clamp01(hsl.s);
+                hsl.h = ((hsl.h % 360) + 360) % 360;
+                const c = hslToRgb(hsl.h, hsl.s, hsl.l);
+                r = c.r;
+                g = c.g;
+                b = c.b;
+                break;
+            }
+            case "comp":
+            case "inv":
+                r = 255 - r;
+                g = 255 - g;
+                b = 255 - b;
+                break;
+            case "gray": {
+                const avg = Math.round((r + g + b) / 3);
+                r = avg;
+                g = avg;
+                b = avg;
+                break;
+            }
+            // Channel-level transforms (rare but spec-defined)
+            case "red":
+                r = v * 255;
+                break;
+            case "redMod":
+                r *= v;
+                break;
+            case "redOff":
+                r += v * 255;
+                break;
+            case "green":
+                g = v * 255;
+                break;
+            case "greenMod":
+                g *= v;
+                break;
+            case "greenOff":
+                g += v * 255;
+                break;
+            case "blue":
+                b = v * 255;
+                break;
+            case "blueMod":
+                b *= v;
+                break;
+            case "blueOff":
+                b += v * 255;
+                break;
+            case "hue":
+            case "sat":
+            case "lum":
+                // Absolute set — rare; handled same as mod for safety
+                break;
+        }
+    }
+    return {
+        r: clamp255(Math.round(r)),
+        g: clamp255(Math.round(g)),
+        b: clamp255(Math.round(b)),
+        a: clamp01(a),
+    };
+}
+// ── RGB ↔ HSL helpers ───────────────────────────────────────────────
+function clamp01(v) { return Math.max(0, Math.min(1, v)); }
+function clamp255(v) { return Math.max(0, Math.min(255, v)); }
+export function rgbToHsl(r, g, b) {
+    r /= 255;
+    g /= 255;
+    b /= 255;
+    const max = Math.max(r, g, b), min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    if (max === min)
+        return { h: 0, s: 0, l };
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let h;
+    if (max === r)
+        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+    else if (max === g)
+        h = ((b - r) / d + 2) / 6;
+    else
+        h = ((r - g) / d + 4) / 6;
+    return { h: h * 360, s, l };
+}
+export function hslToRgb(h, s, l) {
+    h = ((h % 360) + 360) % 360;
+    s = clamp01(s);
+    l = clamp01(l);
+    if (s === 0) {
+        const v = Math.round(l * 255);
+        return { r: v, g: v, b: v };
+    }
+    const hue2rgb = (p, q, t) => {
+        if (t < 0)
+            t += 1;
+        if (t > 1)
+            t -= 1;
+        if (t < 1 / 6)
+            return p + (q - p) * 6 * t;
+        if (t < 1 / 2)
+            return q;
+        if (t < 2 / 3)
+            return p + (q - p) * (2 / 3 - t) * 6;
+        return p;
+    };
+    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+    const p = 2 * l - q;
+    const hn = h / 360;
+    return {
+        r: Math.round(hue2rgb(p, q, hn + 1 / 3) * 255),
+        g: Math.round(hue2rgb(p, q, hn) * 255),
+        b: Math.round(hue2rgb(p, q, hn - 1 / 3) * 255),
+    };
+}

package/dist/resolve/font-map.d.ts

@@ -0,0 +1,2 @@
+import type { FontScheme } from "../model/types.js";
+export declare function resolveFontFamily(family: string | undefined, fontScheme?: FontScheme): string;

package/dist/resolve/font-map.js

@@ -0,0 +1,66 @@
+// ── macOS font substitution (mirrors TCFontUtils from OfficeImport) ─
+const FONT_MAP = {
+    "Calibri": "Helvetica Neue",
+    "Calibri Light": "Helvetica Neue Light",
+    "Arial": "Helvetica",
+    "Arial Black": "Helvetica Neue",
+    "Arial Narrow": "Helvetica Neue",
+    "Cambria": "Georgia",
+    "Cambria Math": "Georgia",
+    "Consolas": "Menlo",
+    "Courier New": "Courier",
+    "Times New Roman": "Times",
+    "Tahoma": "Geneva",
+    "Verdana": "Verdana",
+    "Trebuchet MS": "Trebuchet MS",
+    "Segoe UI": "Helvetica Neue",
+    "Segoe UI Light": "Helvetica Neue Light",
+    "Segoe UI Semibold": "Helvetica Neue Medium",
+    "Lucida Console": "Monaco",
+    "Lucida Sans Unicode": "Lucida Grande",
+    "Palatino Linotype": "Palatino",
+    "Book Antiqua": "Palatino",
+    "Century Gothic": "Futura",
+    "Franklin Gothic Medium": "Avenir Next Medium",
+    "Garamond": "Garamond",
+    "Impact": "Impact",
+    "Corbel": "Avenir Next",
+    "Candara": "Avenir",
+    "Constantia": "Georgia",
+    "MS Gothic": "Hiragino Sans",
+    "MS Mincho": "Hiragino Mincho ProN",
+    "MS PGothic": "Hiragino Sans",
+    "MS PMincho": "Hiragino Mincho ProN",
+    "Yu Gothic": "Hiragino Sans",
+    "Yu Mincho": "Hiragino Mincho ProN",
+    "SimSun": "STSong",
+    "SimHei": "STHeiti",
+    "Microsoft YaHei": "PingFang SC",
+    "MingLiU": "LiSong Pro",
+    "PMingLiU": "LiSong Pro",
+    "Malgun Gothic": "Apple SD Gothic Neo",
+    "Batang": "AppleMyungjo",
+};
+const THEME_PREFIXES = {
+    "+mj-lt": { collection: "major", script: "latin" },
+    "+mj-ea": { collection: "major", script: "eastAsian" },
+    "+mj-cs": { collection: "major", script: "complexScript" },
+    "+mn-lt": { collection: "minor", script: "latin" },
+    "+mn-ea": { collection: "minor", script: "eastAsian" },
+    "+mn-cs": { collection: "minor", script: "complexScript" },
+};
+// ── Public API ──────────────────────────────────────────────────────
+export function resolveFontFamily(family, fontScheme) {
+    if (!family) {
+        // Default to theme minor latin font (raw OOXML name, e.g. "Calibri")
+        return fontScheme?.minorFont?.latin ?? "Calibri";
+    }
+    // Resolve theme font references (+mn-lt, +mj-lt, etc.)
+    const ref = THEME_PREFIXES[family];
+    if (ref && fontScheme) {
+        const collection = ref.collection === "major" ? fontScheme.majorFont : fontScheme.minorFont;
+        family = collection[ref.script];
+    }
+    // Emit raw OOXML font name — let WebKit handle fallback
+    return family;
+}

package/dist/resolve/inheritance.d.ts

@@ -0,0 +1,5 @@
+import type { CharacterProperties, Fill, Slide, ParagraphProperties } from "../model/types.js";
+import type { PlaceholderType } from "../model/enums.js";
+export declare function resolveSlideBackground(slide: Slide): Fill | undefined;
+export declare function resolveCharacterProperties(local: CharacterProperties | undefined, slide: Slide, level?: number, placeholderType?: PlaceholderType): CharacterProperties;
+export declare function resolveParagraphProperties(local: ParagraphProperties | undefined, slide: Slide, level?: number, placeholderType?: PlaceholderType): ParagraphProperties;

package/dist/resolve/inheritance.js

@@ -0,0 +1,106 @@
+// ── Background resolution ───────────────────────────────────────────
+export function resolveSlideBackground(slide) {
+    return slide.background?.fill
+        ?? slide.slideLayout.background?.fill
+        ?? slide.slideLayout.slideMaster.background?.fill;
+}
+// ── Character property inheritance ──────────────────────────────────
+export function resolveCharacterProperties(local, slide, level = 0, placeholderType) {
+    const chain = buildPropertyChain(slide, level, placeholderType);
+    if (local)
+        chain.unshift(local);
+    const result = {};
+    for (const props of chain) {
+        mergeIfUndefined(result, props);
+    }
+    return result;
+}
+// ── Paragraph property inheritance ──────────────────────────────────
+export function resolveParagraphProperties(local, slide, level = 0, placeholderType) {
+    const chain = buildParagraphChain(slide, level, placeholderType);
+    if (local)
+        chain.unshift(local);
+    const result = {};
+    for (const props of chain) {
+        mergeIfUndefined(result, props);
+    }
+    return result;
+}
+// ── Chain builders ──────────────────────────────────────────────────
+function buildPropertyChain(slide, level, phType) {
+    const chain = [];
+    const layout = slide.slideLayout;
+    const master = layout.slideMaster;
+    // Layout placeholder default run props
+    if (phType) {
+        const layoutPh = findPlaceholder(layout.drawables, phType);
+        pushLevelProps(chain, layoutPh, level);
+    }
+    // Master placeholder default run props
+    if (phType) {
+        const masterPh = findPlaceholder(master.drawables, phType);
+        pushLevelProps(chain, masterPh, level);
+    }
+    // Master text styles by placeholder type
+    const masterStyle = masterTextStyleForType(master, phType);
+    if (masterStyle)
+        pushTextListLevel(chain, masterStyle, level);
+    return chain;
+}
+function buildParagraphChain(slide, level, phType) {
+    const chain = [];
+    const layout = slide.slideLayout;
+    const master = layout.slideMaster;
+    if (phType) {
+        const layoutPh = findPlaceholder(layout.drawables, phType);
+        pushLevelProps(chain, layoutPh, level);
+    }
+    if (phType) {
+        const masterPh = findPlaceholder(master.drawables, phType);
+        pushLevelProps(chain, masterPh, level);
+    }
+    const masterStyle = masterTextStyleForType(master, phType);
+    if (masterStyle)
+        pushTextListLevel(chain, masterStyle, level);
+    return chain;
+}
+// ── Helpers ─────────────────────────────────────────────────────────
+function findPlaceholder(drawables, phType) {
+    for (const d of drawables) {
+        if (d.placeholder?.type === phType && "textBody" in d)
+            return d;
+    }
+    return undefined;
+}
+function pushLevelProps(chain, shape, level) {
+    const style = shape?.textBody?.listStyle;
+    if (style)
+        pushTextListLevel(chain, style, level);
+}
+function pushTextListLevel(chain, style, level) {
+    const props = style.levels[level];
+    if (props)
+        chain.push(props);
+    // Also fall through to level 0 as ultimate default
+    if (level > 0) {
+        const base = style.levels[0];
+        if (base)
+            chain.push(base);
+    }
+}
+function masterTextStyleForType(master, phType) {
+    if (!phType)
+        return master.otherTextStyle;
+    if (phType === "title" || phType === "ctrTitle")
+        return master.titleTextStyle;
+    if (phType === "body" || phType === "subTitle")
+        return master.bodyTextStyle;
+    return master.otherTextStyle;
+}
+function mergeIfUndefined(target, source) {
+    for (const key of Object.keys(source)) {
+        if (target[key] === undefined && source[key] !== undefined) {
+            target[key] = source[key];
+        }
+    }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "quicklook-pptx-renderer",
+  "version": "0.1.0",
+  "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",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "quicklook-pptx": "dist/cli.js"
+  },
+  "keywords": [
+    "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"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./lint": {
+      "types": "./dist/lint.d.ts",
+      "import": "./dist/lint.js"
+    },
+    "./reader": {
+      "types": "./dist/reader/presentation.d.ts",
+      "import": "./dist/reader/presentation.js"
+    },
+    "./model": {
+      "types": "./dist/model/types.d.ts",
+      "import": "./dist/model/types.js"
+    },
+    "./mapper": {
+      "types": "./dist/mapper/html-generator.d.ts",
+      "import": "./dist/mapper/html-generator.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/tools",
+    "!dist/types"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint:pptx": "node dist/cli.js lint"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Fornace/quicklook-pptx-renderer.git"
+  },
+  "dependencies": {
+    "fast-xml-parser": "^5.2.0",
+    "jszip": "^3.10.1"
+  },
+  "optionalDependencies": {
+    "@napi-rs/canvas": "^0.1.65"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pngjs": "^6.0.5",
+    "pixelmatch": "^6.0.0",
+    "playwright": "^1.59.1",
+    "pngjs": "^7.0.0",
+    "pptxgenjs": "^4.0.1",
+    "typescript": "^5.7.0"
+  }
+}