@pecot/visual-mcp 0.0.0-stage → 1.1.0

package/cli/dist/domain/pptx-ooxml/post-process.js

@@ -0,0 +1,266 @@
+// PPTX 後処理の純粋関数群。Python 版 postprocess.py の 3 つの transform を
+// XmlDocument / XmlNode ポート経由で実装する。XmlEngine.parse / serialize は
+// 呼ばない（commands 層の責務）。
+import { doesContainJapanese, calculateSpcValue } from './font-policy.js';
+import { escapeXmlAttribute } from './xml-escape.js';
+import { NS_DRAWINGML, NS_MARKUP_COMPATIBILITY, NS_OFFICE_RELATIONSHIPS, NS_PACKAGE_RELATIONSHIPS, NS_POWERPOINT_2010, NS_POWERPOINT_2015_09, NS_PRESENTATIONML, REL_TYPE_HYPERLINK } from '../_shared/ooxml-uris.js';
+// Python 版 postprocess.py:29-48 と一致する OOXML 名前空間 URI。
+export const NAMESPACES = {
+    a: NS_DRAWINGML,
+    p: NS_PRESENTATIONML,
+    r: NS_OFFICE_RELATIONSHIPS,
+    mc: NS_MARKUP_COMPATIBILITY,
+    p14: NS_POWERPOINT_2010,
+    p159: NS_POWERPOINT_2015_09,
+};
+const REL_NS = { rel: NS_PACKAGE_RELATIONSHIPS };
+const URL_PATTERN = /^https?:\/\//;
+/**
+Python 版 postprocess.py:83 `_fix_japanese_fonts_in_tree` を直訳。
+
+Python と等価な sibling 順序を保つため、`<a:rPr>` 直下に `<a:latin>` が
+存在すればその直後に `<a:ea>` を sibling 挿入する。`<a:latin>` が無い場合のみ
+`rPr` 末尾に append する。Python 旧方式の `rpr.insert(latin_index + 1, ea_elem)`
+と等価なノード並びを再現する。
+
+`policy.ea` が無ければ東アジア書体は書かない。`letterSpacingMap` の `spc` の書き込みは続ける。
+*/
+export function applyJapaneseFontFix(slide, policy, letterSpacingMap) {
+    const { ea } = policy;
+    let fontFixed = 0;
+    let spacingFixed = 0;
+    for (const run of slide.selectNodes('//a:r', NAMESPACES)) {
+        const [textElement] = run.selectNodes('.//a:t', NAMESPACES);
+        if (textElement === undefined)
+            continue;
+        const textContent = textElement.text();
+        if (textContent === '')
+            continue;
+        const [rpr] = run.selectNodes('.//a:rPr', NAMESPACES);
+        if (rpr === undefined)
+            continue;
+        if (ea !== undefined && doesContainJapanese(textContent)) {
+            const [eaElement] = rpr.selectNodes('./a:ea', NAMESPACES);
+            if (eaElement === undefined) {
+                insertEaAfterLatin(rpr, ea);
+            }
+            else {
+                eaElement.setAttr('typeface', ea);
+            }
+            fontFixed += 1;
+        }
+        const spacingInfo = letterSpacingMap.get(textContent);
+        if (spacingInfo === undefined)
+            continue;
+        const spcValue = calculateSpcValue(spacingInfo.letterSpacing);
+        rpr.setAttr('spc', String(spcValue));
+        spacingFixed += 1;
+    }
+    // endParaRPr 処理。段落末尾プロパティに対して、段落内テキスト連結が
+    // 日本語を含む場合に typeface を ea に固定する。Python 版は parent から
+    // `.//a:t/text()` で再帰的にテキストを集約しているため、`../descendant::a:t` で揃える。
+    // ea が無ければ書体を書かないので、この処理ごと行わない。
+    if (ea !== undefined) {
+        for (const endParaRpr of slide.selectNodes('//a:endParaRPr', NAMESPACES)) {
+            const textParts = endParaRpr.selectNodes('../descendant::a:t', NAMESPACES);
+            const paragraphText = textParts.map(node => node.text()).join('');
+            if (!doesContainJapanese(paragraphText))
+                continue;
+            const [eaElement] = endParaRpr.selectNodes('./a:ea', NAMESPACES);
+            if (eaElement === undefined) {
+                insertEaAfterLatin(endParaRpr, ea);
+            }
+            else {
+                eaElement.setAttr('typeface', ea);
+            }
+        }
+    }
+    return { fontFixed, spacingFixed };
+}
+function insertEaAfterLatin(rpr, eaTypeface) {
+    const [latin] = rpr.selectNodes('./a:latin', NAMESPACES);
+    if (latin === undefined) {
+        rpr.appendChildXml(eaElementXml(eaTypeface));
+    }
+    else {
+        latin.addNextSiblingXml(eaElementXml(eaTypeface));
+    }
+}
+/**
+次の CSS 専用キーワードは PowerPoint が解釈できない。
+システム系は `-apple-system` / `BlinkMacSystemFont` / `system-ui`。
+総称系は `sans-serif` / `serif` / `monospace` / `cursive` / `fantasy`。
+CSS の値は `inherit` / `initial` / `unset`。
+そのため `<a:latin>` / `<a:ea>` / `<a:cs>` の typeface 属性が該当 token に一致する場合は、当該要素を削除する。
+これにより fallback が働く。
+fallback 先は slide layout / theme1.xml の `<a:fontScheme>` (theme font)。
+具体的には `+mj-lt` / `+mn-lt` / `+mj-ea` / `+mn-ea` を指す。
+視覚的な fallback の質が改善する。
+dom-to-pptx は CSS の `font-family: -apple-system, ...` をそのまま typeface 属性に書き出してしまう。
+その挙動を補正する。
+*/
+const CSS_ONLY_TYPEFACE_PATTERN = /^(?:-apple-system|BlinkMacSystemFont|system-ui|-?webkit-system[a-z-]*|sans-serif|serif|monospace|cursive|fantasy|inherit|initial|unset)$/;
+export function sanitizeCssOnlyTypefaces(slide) {
+    let removed = 0;
+    for (const xpath of ['//a:latin', '//a:ea', '//a:cs']) {
+        for (const element of slide.selectNodes(xpath, NAMESPACES)) {
+            const typeface = element.getAttr('typeface') ?? '';
+            if (!CSS_ONLY_TYPEFACE_PATTERN.test(typeface)) {
+                continue;
+            }
+            element.remove();
+            removed += 1;
+        }
+    }
+    return { removed };
+}
+/**
+スライドから出現アニメーションを取り除く（#1070）。
+
+`/p:sld/p:timing` を要素ごと削除する。
+効果の時間木 `p:tnLst` と段階表示の宣言 `p:bldLst` は、その配下にあるため、まとめて外れる。
+図形側に掃除すべき痕跡は残らない。
+計測では、timing を外したスライドの要素構成が、アニメーションを持たないスライドと一致した。
+`//p:timing` は使わず、`/p:sld/p:timing` だけを対象とする。
+将来 `p:extLst` 配下で同名要素が現れても、巻き込まないため。
+
+どのスライドに対して呼ぶかの判断（方針の本文）は commands/slidev-to-pptx/convert.ts が持つ。
+*/
+export function removeAnimationTiming(slide) {
+    let removed = 0;
+    for (const timing of slide.selectNodes('/p:sld/p:timing', NAMESPACES)) {
+        timing.remove();
+        removed += 1;
+    }
+    return { removed };
+}
+/**
+Python 版 postprocess.py:204 `_fix_hyperlinks_in_tree` を直訳。
+
+引数 `relsDocument` は、呼び出し元で必ず Document 化された状態にしておくこと。
+Python 版の `if rels_tree is None: rels_tree = etree.Element(...)` 相当の新規生成は、
+infra 層 / commands 層の責務。
+*/
+export function applyHyperlinkFix(slide, rels, hrefMap, linkColor) {
+    // リンク色の宣言が無いテーマでは、どの run がリンクかを決められない。置換しない。
+    if (linkColor === undefined)
+        return { converted: 0 };
+    let converted = 0;
+    const linkColorUpper = linkColor.toUpperCase();
+    let nextRid = computeNextRid(rels);
+    for (const run of slide.selectNodes('//a:r', NAMESPACES)) {
+        const [textElement] = run.selectNodes('./a:t', NAMESPACES);
+        if (textElement === undefined)
+            continue;
+        const text = textElement.text().trim();
+        if (text === '')
+            continue;
+        const [rpr] = run.selectNodes('./a:rPr', NAMESPACES);
+        if (rpr === undefined)
+            continue;
+        const [srgbClr] = rpr.selectNodes('./a:solidFill/a:srgbClr', NAMESPACES);
+        if (srgbClr === undefined)
+            continue;
+        const colorValue = srgbClr.getAttr('val') ?? '';
+        if (colorValue.toUpperCase() !== linkColorUpper)
+            continue;
+        const [existingHlink] = rpr.selectNodes('./a:hlinkClick', NAMESPACES);
+        if (existingHlink !== undefined)
+            continue;
+        const url = hrefMap.get(text) ?? (URL_PATTERN.test(text) ? text : undefined);
+        if (url === undefined)
+            continue;
+        const newRid = `rId${String(nextRid)}`;
+        nextRid += 1;
+        const relsXml = `<rel:Relationship xmlns:rel="${NS_PACKAGE_RELATIONSHIPS}"`
+            + ` Id="${escapeXmlAttribute(newRid)}"`
+            + ` Type="${escapeXmlAttribute(REL_TYPE_HYPERLINK)}"`
+            + ` Target="${escapeXmlAttribute(url)}"`
+            + ` TargetMode="External"/>`;
+        rels.appendChildXml(relsXml);
+        const hlinkXml = `<a:hlinkClick xmlns:a="${NS_DRAWINGML}" xmlns:r="${NS_OFFICE_RELATIONSHIPS}"`
+            + ` r:id="${escapeXmlAttribute(newRid)}"/>`;
+        rpr.appendChildXml(hlinkXml);
+        converted += 1;
+    }
+    return { converted };
+}
+function computeNextRid(rels) {
+    let max = 0;
+    for (const relationship of rels.selectNodes('//rel:Relationship', REL_NS)) {
+        const id = relationship.getAttr('Id') ?? '';
+        if (!id.startsWith('rId'))
+            continue;
+        const tail = id.slice(3);
+        const n = Math.trunc(Number(tail));
+        if (Number.isFinite(n) && n > max)
+            max = n;
+    }
+    return max + 1;
+}
+/**
+Python 版 postprocess.py:309 `_add_transition_to_tree` を直訳。
+
+既存 `<p:transition>` および `<mc:AlternateContent>` 内の transition を削除した上で
+指定タイプのトランジションを挿入する。
+
+挿入位置は、ECMA-376 (CT_Slide) が定める slide 直下の要素順序 `cSld → clrMapOvr → transition → timing` に合わせる。
+具体的には clrMapOvr（無ければ cSld）の直後に置く。
+root 末尾へ append すると、`<p:timing>` を持つ slide で transition が timing の後ろに回り、順序が崩れる。
+*/
+export function applyTransition(slide, type, durationMs, options = {}) {
+    for (const existing of slide.selectNodes('/*/p:transition', NAMESPACES)) {
+        existing.remove();
+    }
+    for (const ac of slide.selectNodes('/*/mc:AlternateContent', NAMESPACES)) {
+        const inner = ac.selectNodes('.//p:transition', NAMESPACES);
+        if (inner.length > 0)
+            ac.remove();
+    }
+    const morphOption = options.morphOption ?? 'byObject';
+    const xml = type === 'morph'
+        ? buildMorphTransitionXml(durationMs, morphOption)
+        : buildFadeTransitionXml(durationMs);
+    const anchor = slide.selectNodes('/*/p:clrMapOvr', NAMESPACES).at(-1)
+        ?? slide.selectNodes('/*/p:cSld', NAMESPACES).at(-1);
+    if (anchor === undefined) {
+        // cSld を欠く slide は schema 上あり得ないが、位置決めできない場合の防御として末尾へ置く。
+        slide.appendChildXml(xml);
+    }
+    else {
+        anchor.addNextSiblingXml(xml);
+    }
+    return { added: 1 };
+}
+function eaElementXml(typeface) {
+    return `<a:ea xmlns:a="${NS_DRAWINGML}" typeface="${escapeXmlAttribute(typeface)}"/>`;
+}
+function buildMorphTransitionXml(durationMs, morphOption) {
+    return `<mc:AlternateContent xmlns:mc="${NS_MARKUP_COMPATIBILITY}">`
+        + `<mc:Choice xmlns:p159="${NS_POWERPOINT_2015_09}" Requires="p159">`
+        + `<p:transition xmlns:p="${NS_PRESENTATIONML}" xmlns:p14="${NS_POWERPOINT_2010}" p14:dur="${String(durationMs)}">`
+        + `<p159:morph option="${escapeXmlAttribute(morphOption)}"/>`
+        + '</p:transition>'
+        + '</mc:Choice>'
+        + '<mc:Fallback>'
+        + `<p:transition xmlns:p="${NS_PRESENTATIONML}">`
+        + '<p:fade/>'
+        + '</p:transition>'
+        + '</mc:Fallback>'
+        + '</mc:AlternateContent>';
+}
+function buildFadeTransitionXml(durationMs) {
+    return `<mc:AlternateContent xmlns:mc="${NS_MARKUP_COMPATIBILITY}">`
+        + `<mc:Choice xmlns:p14="${NS_POWERPOINT_2010}" Requires="p14">`
+        + `<p:transition xmlns:p="${NS_PRESENTATIONML}" p14:dur="${String(durationMs)}">`
+        + '<p:fade/>'
+        + '</p:transition>'
+        + '</mc:Choice>'
+        + '<mc:Fallback>'
+        + `<p:transition xmlns:p="${NS_PRESENTATIONML}">`
+        + '<p:fade/>'
+        + '</p:transition>'
+        + '</mc:Fallback>'
+        + '</mc:AlternateContent>';
+}
+//# sourceMappingURL=post-process.js.map

package/cli/dist/domain/pptx-ooxml/prerender-replace.d.ts

@@ -0,0 +1,37 @@
+import type { XmlDocument } from '../_shared/ports.js';
+export interface PrerenderMeta {
+    readonly width: number;
+    readonly height: number;
+    readonly left?: number;
+    readonly top?: number;
+    readonly selector?: string;
+}
+export interface PrerenderEntry {
+    readonly imagePath: string;
+    readonly metaPath: string;
+}
+export interface PicRecord {
+    readonly mediaPart: string;
+    readonly xEmu: number;
+    readonly yEmu: number;
+    readonly cxEmu: number;
+    readonly cyEmu: number;
+    readonly pngWidth: number;
+    readonly pngHeight: number;
+}
+export declare function getPngDimensions(buffer: Readonly<Buffer>): {
+    readonly width: number;
+    readonly height: number;
+} | undefined;
+export declare function buildPicMediaMap(slide: XmlDocument, rels: XmlDocument, partMap: ReadonlyMap<string, Buffer>): readonly PicRecord[];
+export declare function matchPrerenderToMedia(meta: PrerenderMeta, picMap: readonly PicRecord[], matched: ReadonlySet<string>): string | undefined;
+export declare function fallbackSizeMatch(meta: PrerenderMeta, picMap: readonly PicRecord[], matched: ReadonlySet<string>): string | undefined;
+export declare function findPrerenderImages(slidesDirectory: string, slideNumber: number, io: {
+    readonly exists: (path: string) => Promise<boolean>;
+}): Promise<readonly PrerenderEntry[]>;
+export declare function applyPrerenderImageReplace(slide: XmlDocument, rels: XmlDocument, partMap: Map<string, Buffer>, entries: readonly PrerenderEntry[], io: {
+    readonly readFile: (path: string) => Promise<Buffer>;
+}): Promise<{
+    readonly replaced: number;
+}>;
+//# sourceMappingURL=prerender-replace.d.ts.map

package/cli/dist/domain/pptx-ooxml/prerender-replace.js

@@ -0,0 +1,252 @@
+// Slidev prerender 高解像度画像を PPTX 内 `ppt/media/*.png` に差し替える純粋ロジック。
+// Python 旧実装 (`postprocess_and_merge.py:111-322` および呼び出し側 :474-540) と、
+// 厳密に等価な 3 段階フォールバックを再現する。
+// 3 段階は、座標+サイズ → サイズのみ → 全 PNG 走査。
+//
+// `null` は domain 規約 (`unicorn/no-null`) で禁止されているため、未マッチは
+// `undefined` で表現する (旧 Python の None と意味的に等価)。
+import path from 'node:path';
+import { NS_DRAWINGML, NS_OFFICE_RELATIONSHIPS, NS_PACKAGE_RELATIONSHIPS, NS_PRESENTATIONML } from '../_shared/ooxml-uris.js';
+const REL_NS = {
+    rel: NS_PACKAGE_RELATIONSHIPS,
+};
+const PIC_NS = {
+    a: NS_DRAWINGML,
+    p: NS_PRESENTATIONML,
+    r: NS_OFFICE_RELATIONSHIPS,
+};
+// EMU (English Metric Unit) → CSS px 換算 (1 inch = 914400 EMU, 1 inch = 96 CSS px)
+const EMU_PER_CSS_PX = 9525;
+// Python 旧実装の tolerance 値 (位置 / サイズ相対 / サイズ絶対)
+const POSITION_TOLERANCE_PX = 50;
+const SIZE_TOLERANCE_RATIO = 0.15;
+const FALLBACK_SIZE_TOLERANCE_PX = 50;
+// PNG signature 89 50 4E 47 0D 0A 1A 0A
+const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A]);
+const IHDR_MARKER = Buffer.from('IHDR', 'ascii');
+const PNG_HEADER_MIN_LENGTH = 24;
+export function getPngDimensions(buffer) {
+    if ((buffer.length < PNG_HEADER_MIN_LENGTH) || !buffer.subarray(0, 8).equals(PNG_MAGIC) || !buffer.subarray(12, 16).equals(IHDR_MARKER))
+        return undefined;
+    const width = buffer.readUInt32BE(16);
+    const height = buffer.readUInt32BE(20);
+    return { width, height };
+}
+export function buildPicMediaMap(slide, rels, partMap) {
+    const ridToMedia = new Map();
+    for (const relationship of rels.selectNodes('//rel:Relationship', REL_NS)) {
+        const rid = relationship.getAttr('Id');
+        if (rid === undefined)
+            continue;
+        const target = relationship.getAttr('Target');
+        if (target === undefined)
+            continue;
+        const markerIndex = target.indexOf('../media/');
+        if (markerIndex === -1)
+            continue;
+        const tail = target.slice(markerIndex + '../media/'.length);
+        ridToMedia.set(rid, `ppt/media/${tail}`);
+    }
+    const records = [];
+    for (const pic of slide.selectNodes('.//p:pic', PIC_NS)) {
+        const [blip] = pic.selectNodes('.//p:blipFill/a:blip', PIC_NS);
+        if (blip === undefined)
+            continue;
+        const rid = blip.getAttr('r:embed');
+        if (rid === undefined)
+            continue;
+        const mediaPart = ridToMedia.get(rid);
+        if (mediaPart === undefined)
+            continue;
+        const [off] = pic.selectNodes('.//p:spPr/a:xfrm/a:off', PIC_NS);
+        const [extension] = pic.selectNodes('.//p:spPr/a:xfrm/a:ext', PIC_NS);
+        if (off === undefined || extension === undefined)
+            continue;
+        const xEmu = parseEmu(off.getAttr('x'));
+        const yEmu = parseEmu(off.getAttr('y'));
+        const cxEmu = parseEmu(extension.getAttr('cx'));
+        const cyEmu = parseEmu(extension.getAttr('cy'));
+        const mediaBuffer = partMap.get(mediaPart);
+        const dims = mediaBuffer === undefined ? undefined : getPngDimensions(mediaBuffer);
+        records.push({
+            mediaPart,
+            xEmu,
+            yEmu,
+            cxEmu,
+            cyEmu,
+            pngWidth: dims?.width ?? 0,
+            pngHeight: dims?.height ?? 0,
+        });
+    }
+    return records.toSorted((a, b) => {
+        return a.yEmu === b.yEmu ? a.xEmu - b.xEmu : a.yEmu - b.yEmu;
+    });
+}
+export function matchPrerenderToMedia(meta, picMap, matched) {
+    if (meta.left === undefined || meta.top === undefined)
+        return undefined;
+    let bestMatch;
+    let bestDistance = Infinity;
+    for (const pic of picMap) {
+        if (matched.has(pic.mediaPart))
+            continue;
+        const picLeftPx = pic.xEmu / EMU_PER_CSS_PX;
+        const picTopPx = pic.yEmu / EMU_PER_CSS_PX;
+        const dx = meta.left - picLeftPx;
+        const dy = meta.top - picTopPx;
+        const distance = Math.hypot(dx, dy);
+        if ((distance > POSITION_TOLERANCE_PX) || !isValidPicSize(pic))
+            continue;
+        const wRatio = Math.abs(meta.width - pic.pngWidth) / Math.max(meta.width, 1);
+        const hRatio = Math.abs(meta.height - pic.pngHeight) / Math.max(meta.height, 1);
+        if (wRatio > SIZE_TOLERANCE_RATIO || hRatio > SIZE_TOLERANCE_RATIO || !(distance < bestDistance)) {
+            continue;
+        }
+        bestDistance = distance;
+        bestMatch = pic.mediaPart;
+    }
+    return bestMatch;
+}
+export function fallbackSizeMatch(meta, picMap, matched) {
+    for (const pic of picMap) {
+        if (matched.has(pic.mediaPart) || !isValidPicSize(pic))
+            continue;
+        const wRatio = Math.abs(meta.width - pic.pngWidth) / Math.max(meta.width, 1);
+        const hRatio = Math.abs(meta.height - pic.pngHeight) / Math.max(meta.height, 1);
+        if (wRatio <= SIZE_TOLERANCE_RATIO && hRatio <= SIZE_TOLERANCE_RATIO) {
+            return pic.mediaPart;
+        }
+    }
+    return undefined;
+}
+/**
+`buildPicMediaMap` で PNG dimensions が解決できなかった pic は、`pngWidth=0 || pngHeight=0` で記録される。
+解決できない理由は、破損しているか partMap に未収録のどちらか。
+そのため、サイズ判定をする全フェーズで一律スキップする。
+*/
+function isValidPicSize(pic) {
+    return pic.pngWidth !== 0 && pic.pngHeight !== 0;
+}
+export async function findPrerenderImages(slidesDirectory, slideNumber, io) {
+    const result = [];
+    let index = 0;
+    // 連番で .png + .meta.json をペア検索。.png が無いインデックスで停止する。
+    for (;;) {
+        const stem = `prerender-slide${String(slideNumber)}-${String(index)}`;
+        const imagePath = path.join(slidesDirectory, `${stem}.png`);
+        const isImageExists = await io.exists(imagePath);
+        if (!isImageExists)
+            break;
+        const metaPath = path.join(slidesDirectory, `${stem}.meta.json`);
+        result.push({ imagePath, metaPath });
+        index += 1;
+    }
+    return result;
+}
+export async function applyPrerenderImageReplace(slide, rels, partMap, entries, io) {
+    if (entries.length === 0)
+        return { replaced: 0 };
+    const picMap = buildPicMediaMap(slide, rels, partMap);
+    const matched = new Set();
+    let replaced = 0;
+    for (const entry of entries) {
+        const meta = await loadMeta(entry.metaPath, io);
+        if (meta === undefined)
+            continue;
+        // existence 確認後に削除されるレースや FS 一過性エラーで全体が落ちるのを防ぐ。
+        // loadMeta と非対称な堅牢性を揃え、失敗 entry は warn して skip する。
+        let highResolutionBuffer;
+        try {
+            highResolutionBuffer = await io.readFile(entry.imagePath);
+        }
+        catch (error) {
+            console.warn(`prerender image read failed: ${entry.imagePath}: ${String(error)}`);
+            continue;
+        }
+        // 1 段目: 座標 + サイズ。matchPrerenderToMedia は matched 済 mediaPart を
+        // 候補から除外するため、stage1 が undefined でない場合は必ず未マッチで採用する。
+        const stage1 = matchPrerenderToMedia(meta, picMap, matched);
+        if (stage1 !== undefined) {
+            partMap.set(stage1, Buffer.from(highResolutionBuffer));
+            matched.add(stage1);
+            replaced += 1;
+            continue;
+        }
+        // 2 段目: サイズのみ (1 段目が undefined の時のみ発動)
+        const stage2 = fallbackSizeMatch(meta, picMap, matched);
+        if (stage2 !== undefined) {
+            partMap.set(stage2, Buffer.from(highResolutionBuffer));
+            matched.add(stage2);
+            replaced += 1;
+            continue;
+        }
+        // 3 段目: pic_media_map が空のときのみ全 PNG 走査 (絶対差 50 px)
+        if (picMap.length === 0) {
+            replaced += applyAllPngFallback(partMap, highResolutionBuffer, meta, matched);
+        }
+    }
+    return { replaced };
+}
+function applyAllPngFallback(partMap, highResolutionBuffer, meta, matched) {
+    let count = 0;
+    // Map iteration safety: 既存 key の上書きのみ。新規 key 追加は無いので visit 順序は撹乱しない。
+    for (const [partName, partBuffer] of partMap) {
+        if (!partName.startsWith('ppt/media/') || !partName.endsWith('.png') || matched.has(partName))
+            continue;
+        const dims = getPngDimensions(partBuffer);
+        if (dims === undefined)
+            continue;
+        if (!(Math.abs(dims.width - meta.width) <= FALLBACK_SIZE_TOLERANCE_PX
+            && Math.abs(dims.height - meta.height) <= FALLBACK_SIZE_TOLERANCE_PX)) {
+            continue;
+        }
+        partMap.set(partName, Buffer.from(highResolutionBuffer));
+        matched.add(partName);
+        count += 1;
+    }
+    return count;
+}
+async function loadMeta(metaPath, io) {
+    let raw;
+    try {
+        raw = await io.readFile(metaPath);
+    }
+    catch {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw.toString('utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(parsed)) {
+        console.warn(`prerender meta unrecognized: ${metaPath} (not a JSON object)`);
+        return undefined;
+    }
+    const width = parsed['width'];
+    const height = parsed['height'];
+    if (typeof width !== 'number' || typeof height !== 'number') {
+        console.warn(`prerender meta unrecognized: ${metaPath} (width/height missing or non-numeric)`);
+        return undefined;
+    }
+    const meta = { width, height };
+    if (typeof parsed['left'] === 'number')
+        meta.left = parsed['left'];
+    if (typeof parsed['top'] === 'number')
+        meta.top = parsed['top'];
+    if (typeof parsed['selector'] === 'string')
+        meta.selector = parsed['selector'];
+    return meta;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function parseEmu(value) {
+    if (value === undefined)
+        return 0;
+    const n = Math.trunc(Number(value));
+    return Number.isFinite(n) ? n : 0;
+}
+//# sourceMappingURL=prerender-replace.js.map

package/cli/dist/domain/pptx-ooxml/preview-normalize.d.ts

@@ -0,0 +1,30 @@
+import type { XmlDocument } from '../_shared/ports.js';
+/**
+プレビュー差異の 1 件分の検知結果。`rule` は将来の差異ルール拡張に備えた
+discriminated key。`shapeName` は `p:cNvPr/@name` が解決できた場合のみ付与し、
+取れない場合は undefined で degrade する。
+*/
+export interface PreviewDivergenceFinding {
+    readonly rule: 'spautofit-wrap-none';
+    readonly shapeName?: string;
+}
+/**
+1 つの slide XML から、LibreOffice 描画差異を生む bodyPr を列挙する。
+
+全 `selectNodes` 呼び出しに NAMESPACES nsMap を渡す（渡さないと prefix 未解決で
+0 件になる）。slide 番号の付与は command 層が part 名から導出する。
+*/
+export declare function detectPreviewDivergence(slide: XmlDocument): readonly PreviewDivergenceFinding[];
+/**
+検知対象の bodyPr を `wrap="square"` + `<a:noAutofit/>` に正規化する。
+
+- `wrap` 属性を `square` に setAttr する（他属性は保存される）。
+- 子 `a:spAutoFit` を `<a:noAutofit xmlns:a="…"/>` に replaceWithXml する。
+  fragment parse 用に xmlns:a 宣言が必須。
+
+冪等。正規化済み（noAutofit + wrap=square）の bodyPr は XPath にヒットしないため、再適用されない。
+*/
+export declare function applyPreviewNormalization(slide: XmlDocument): {
+    readonly normalized: number;
+};
+//# sourceMappingURL=preview-normalize.d.ts.map

package/cli/dist/domain/pptx-ooxml/preview-normalize.js

@@ -0,0 +1,59 @@
+// プレビュー正規化の純粋関数群。
+// dom-to-pptx 2.1.1 は nowrap 要素に `wrap="none"` + `<a:spAutoFit/>` を出力する。
+// この組み合わせを LibreOffice が中心基準 auto-size で描画するため、
+// コンテナ内 PDF プレビューで左揃えテキストが中央寄せ化する。
+// 内包 pptxgenjs が 3.12.0 → 4.0.1 に上がっても、この組み合わせは維持される。
+// #1062 の計測では、51 枚のデッキの検知件数は 1.1.10 / 2.1.1 とも 175 件で同数だった。
+// 元 PPTX は変更せず、プレビュー専用コピーに対して `noAutofit` + `wrap="square"` へ置換する。
+// 実装は XmlDocument / XmlNode ポート経由で行い、parse / serialize は commands 層の責務とする。
+import { NAMESPACES } from './post-process.js';
+import { NS_DRAWINGML } from '../_shared/ooxml-uris.js';
+// `wrap="none"` かつ子に `a:spAutoFit` を持つ bodyPr のみを対象とする。
+// wrap=none と spAutoFit の片方だけを持つ要素は触らない。
+const DIVERGENT_BODYPR_XPATH = '//a:bodyPr[@wrap=\'none\'][a:spAutoFit]';
+/**
+1 つの slide XML から、LibreOffice 描画差異を生む bodyPr を列挙する。
+
+全 `selectNodes` 呼び出しに NAMESPACES nsMap を渡す（渡さないと prefix 未解決で
+0 件になる）。slide 番号の付与は command 層が part 名から導出する。
+*/
+export function detectPreviewDivergence(slide) {
+    const findings = [];
+    for (const bodyPr of slide.selectNodes(DIVERGENT_BODYPR_XPATH, NAMESPACES)) {
+        const shapeName = resolveShapeName(bodyPr);
+        findings.push(shapeName === undefined
+            ? { rule: 'spautofit-wrap-none' }
+            : { rule: 'spautofit-wrap-none', shapeName });
+    }
+    return findings;
+}
+/**
+検知対象の bodyPr を `wrap="square"` + `<a:noAutofit/>` に正規化する。
+
+- `wrap` 属性を `square` に setAttr する（他属性は保存される）。
+- 子 `a:spAutoFit` を `<a:noAutofit xmlns:a="…"/>` に replaceWithXml する。
+  fragment parse 用に xmlns:a 宣言が必須。
+
+冪等。正規化済み（noAutofit + wrap=square）の bodyPr は XPath にヒットしないため、再適用されない。
+*/
+export function applyPreviewNormalization(slide) {
+    let normalized = 0;
+    for (const bodyPr of slide.selectNodes(DIVERGENT_BODYPR_XPATH, NAMESPACES)) {
+        bodyPr.setAttr('wrap', 'square');
+        const [spAutoFit] = bodyPr.selectNodes('./a:spAutoFit', NAMESPACES);
+        /* c8 ignore next 3 -- XPath が a:spAutoFit を子に持つ bodyPr のみを返すため undefined の分岐は到達不能 */
+        if (spAutoFit === undefined)
+            continue;
+        spAutoFit.replaceWithXml(`<a:noAutofit xmlns:a="${NS_DRAWINGML}"/>`);
+        normalized += 1;
+    }
+    return { normalized };
+}
+function resolveShapeName(bodyPr) {
+    const [cNvPr] = bodyPr.selectNodes('ancestor::p:sp/p:nvSpPr/p:cNvPr', NAMESPACES);
+    if (cNvPr === undefined)
+        return undefined;
+    const name = cNvPr.getAttr('name');
+    return name === undefined || name === '' ? undefined : name;
+}
+//# sourceMappingURL=preview-normalize.js.map

package/cli/dist/domain/pptx-ooxml/transforms.d.ts

@@ -0,0 +1,16 @@
+import type { XmlNode } from '../_shared/ports.js';
+export type XmlMutation = {
+    readonly kind: 'set-attr';
+    readonly name: string;
+    readonly value: string;
+} | {
+    readonly kind: 'set-text';
+    readonly value: string;
+} | {
+    readonly kind: 'remove';
+} | {
+    readonly kind: 'replace-with-xml';
+    readonly xml: string;
+};
+export declare function applyMutation(node: XmlNode, mutation: XmlMutation): void;
+//# sourceMappingURL=transforms.d.ts.map