@pecot/visual-mcp 0.0.0-stage → 1.0.0

package/cli/dist/infra/slidev-to-pptx/dom-converter.js

@@ -0,0 +1,294 @@
+// 旧 lib 由来の Playwright 処理を踏襲するため、次の規則を本ファイル内で無効化する。
+/* eslint-disable unicorn/name-replacements, unicorn/no-null, unicorn/import-style */
+/* eslint-disable unicorn/no-typeof-undefined, unicorn/prefer-code-point, no-restricted-syntax */
+/* eslint-disable security/detect-non-literal-fs-filename, security/detect-object-injection */
+/* eslint-disable @typescript-eslint/prefer-readonly-parameter-types */
+/* eslint-disable @typescript-eslint/prefer-optional-chain */
+/* eslint-disable @typescript-eslint/no-unnecessary-condition */
+/* eslint-disable unicorn/dom-node-dataset -- 走査対象は dataset を持たない Element */
+import { writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { timeouts } from '../../domain/slidev-to-pptx/config.js';
+import { errorMessage } from '../../domain/slidev-to-pptx/error-utils.js';
+import { slideVisibleFunctionSource } from '../../domain/slidev-to-pptx/visibility.js';
+import { readSlidesTitleFromFile } from './slides-title-reader.js';
+/**
+dom-to-pptx がクラス名から認識する既知アニメーション名の一覧（entrance 17 件 + exit 16 件）。
+
+出典は、dom-to-pptx 2.1.1 の `src/animations/css-parser.js` の `ENTRANCE_NAMES` / `EXIT_NAMES`。
+配布物では、`dist/dom-to-pptx.mjs.map` の sourcesContent から読める。
+同ライブラリ同梱の `skills/dom-to-pptx-skill/reference/ANIMATIONS_WHITELIST.md` が文書化している、
+利用者向けの指定方法も、このクラス名。
+
+dom-to-pptx の版を上げるときは、上記 2 定数と比較し、差分をここへ反映する。
+反映抜けは、利用者の明示指定を通知なしに落とす退行を招く。
+*/
+const knownAnimationNames = [
+    // ENTRANCE_NAMES
+    'fade-in',
+    'appear',
+    'zoom-in',
+    'fly-in',
+    'wipe-in',
+    'split-in',
+    'wheel',
+    'bounce-in',
+    'checkerboard-in',
+    'random-bars-in',
+    'rise-up',
+    'swivel-in',
+    'drop-in',
+    'fly-in-left',
+    'fly-in-right',
+    'fly-in-top',
+    'fly-in-bottom',
+    // EXIT_NAMES
+    'fade-out',
+    'disappear',
+    'zoom-out',
+    'fly-out',
+    'wipe-out',
+    'split-out',
+    'wheel-out',
+    'bounce-out',
+    'checkerboard-out',
+    'random-bars-out',
+    'swivel-out',
+    'drop-out',
+    'fly-out-left',
+    'fly-out-right',
+    'fly-out-top',
+    'fly-out-bottom',
+];
+/**
+slides.md の frontmatter から title を読み取る。取得できない場合は null。
+ファイル読取 + title 抽出は、共通ヘルパー readSlidesTitleFromFile に委譲する。
+ここでは、読取失敗時の warn と自契約 (undefined → null 写像) のみを担う。
+*/
+export async function readSlidesTitle(distDir, logger) {
+    const slidesPath = join(dirname(distDir), 'slides.md');
+    const title = await readSlidesTitleFromFile(slidesPath, (error) => {
+        (logger ?? console).warn(`slides.md の読み取りをスキップ (${slidesPath}): ${errorMessage(error)}`);
+    });
+    return title ?? null;
+}
+/**
+dom-to-pptx ライブラリをページに注入する。
+addScriptTag は script の実行まで待つため、定義の確認は直後の 1 回で足りる。
+注入と確認の全体を、Node 側で `timeouts.domToPptxInject` に収める。
+ページが応答しないと addScriptTag / evaluate が返らないため、Playwright の待ちに上限を委ねない。
+*/
+export async function injectDomToPptx(page, libPath) {
+    let timer;
+    const timedOut = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            reject(new Error(`dom-to-pptx の注入が ${(timeouts.domToPptxInject / 1000).toString()} 秒以内に終わりません`));
+        }, timeouts.domToPptxInject);
+    });
+    const isDomToPptxInjected = async () => {
+        await page.addScriptTag({ path: libPath });
+        return page.evaluate(() => typeof globalThis.window.domToPptx !== 'undefined');
+    };
+    try {
+        const isDefined = await Promise.race([isDomToPptxInjected(), timedOut]);
+        if (!isDefined) {
+            throw new Error('dom-to-pptx を注入しましたが window.domToPptx が定義されません（script 内の例外か AMD の define に登録された可能性）');
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function convertSlide(page, slideNum, slidePrefix, slidesDir, logger, exportOptions, options = {}) {
+    logger.debug(`  DOM→PPTX変換開始: slideNum=${slideNum.toString()}`);
+    const targetSelector = options.targetSelector ?? null;
+    const { pptxData, letterSpacingMap, hasExplicitAnimation } = await page.evaluate(async ({ slideNum: slideNumInner, prefix, visibleFn, exportOptions: exportOptionsInner, knownNames, targetSel }) => {
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval, @typescript-eslint/no-unsafe-call
+        const isVisible = new Function('return ' + visibleFn)();
+        let slide = null;
+        if (targetSel === null) {
+            for (const s of globalThis.document.querySelectorAll('.slidev-page')) {
+                if (isVisible(s)) {
+                    slide = s;
+                    break;
+                }
+            }
+        }
+        else {
+            slide = globalThis.document.querySelector(targetSel);
+        }
+        if (!slide) {
+            throw new Error(targetSel === null
+                ? `スライド #${slideNumInner.toString()}: 表示中のスライドが見つかりません`
+                : `スライド #${slideNumInner.toString()}: 対象のスライドが見つかりません (${targetSel})`);
+        }
+        const letterSpacingMap = {};
+        // NodeFilter.SHOW_TEXT。ブラウザ側のグローバル NodeFilter は isolated-functions に未定義と判定されるため値で書く。
+        const SHOW_TEXT = 4;
+        const walker = globalThis.document.createTreeWalker(slide, SHOW_TEXT);
+        let node;
+        while ((node = walker.nextNode())) {
+            const text = (node.textContent ?? '').trim();
+            if (!text)
+                continue;
+            const parent = node.parentElement;
+            if (!parent)
+                continue;
+            const style = globalThis.getComputedStyle(parent);
+            const letterSpacing = style.letterSpacing;
+            const fontSize = style.fontSize;
+            if (letterSpacing !== 'normal' && letterSpacing !== '0px') {
+                letterSpacingMap[text] = { letterSpacing, fontSize };
+            }
+        }
+        // 当該スライドが「明示指定のアニメーション」を持つかを判定する（#1070）。この値が真の
+        // スライドだけ pptx の `p:timing` を残す。方針の本文（何を消し何を残すか・粒度・
+        // 要素単位にしない理由）は commands/slidev-to-pptx/convert.ts の除去箇所に置く。
+        //
+        // 判定は上流 `parseAnimation`（css-parser.js）の名前解決をそのままなぞり、装飾由来の分岐だけを外す。
+        // 上流の優先順位は次のとおり。
+        //   1. `data-pptx-animation` → `data-pptx-animation-type` 属性。
+        //   2. 1 が空のときだけ、カスタムプロパティ `--pptx-animation-name` → `--pptx-animation`。
+        //   3. 2 までが空か `none` のとき、computed の `animation-name`。
+        //   4. なお空なら、classList を既知アニメーション名と比較する。
+        // このうち 3 だけを除外する。
+        // Slidev のテーマや装飾クラスの与えるアニメーションが、ここに乗る。
+        // すると、装飾しか無いスライドが明示ありに倒れるため。
+        // 4 のクラス名の分岐は残す。
+        // ライブラリ同梱の ANIMATIONS_WHITELIST.md が、利用者向けに文書化している指定方法だからだ。
+        // 落とすと、文書どおりに書かれた明示指定が全て消える。
+        // クラスが書かれた時点で作者の意図は明示なので、computed `animation-name` の値に関わらず明示と扱う。
+        // 次のユーティリティクラスは名前を与えないので、単独のマーカーにはしない。
+        // `animate-duration-*` / `animate-delay-*` / `animate-trigger-*` / `animate-build-*`。
+        // 名前を別途与えたうえでの尺・遅延・発火順の指定としては、従来どおりライブラリ側で働く。
+        //
+        // 1 と 2 は先勝ち。上流は `||` の OR チェーンで名前を解決する。
+        // そのため `data-pptx-animation="none"` は truthy として採用され、カスタムプロパティは参照されない。
+        // この先勝ちを写すことで、属性で打ち消した要素が、カスタムプロパティで明示ありに戻らない。
+        //
+        // カスタムプロパティは CSS のデフォルトで継承される。
+        // スライド外の祖先（`:root` / `body` 等）に `--pptx-animation-name` を置くと、全スライドが明示ありになる。
+        // その状況では、上流の parseAnimation も同じ優先順位 2 で全要素を拾い、実際にアニメーションを生成する。
+        // よって全スライドの timing を残すのは、上流の挙動と一致した、意図どおりの結果。
+        //
+        // 判定は属性・クラスの有無だけを見る。
+        // そのため `display:none` の要素や図形化されない要素にマーカーがあっても、そのスライドは明示ありになる。
+        // 上流はそれらに効果を生成しないため、残るのは装飾由来の timing だけ。
+        // 明示指定を誤って消す側には倒れない。
+        //
+        // v-click と併用したスライドは、クリック段階ごとに別スライドへ変換される。
+        // そのため明示アニメーションは、各段階のスライドに重複して載る。
+        const attributeSelector = '[data-pptx-animation], [data-pptx-animation-type]';
+        const attributeName = (element) => {
+            const direct = (element.getAttribute('data-pptx-animation') ?? '').trim().toLowerCase();
+            return direct === '' ? (element.getAttribute('data-pptx-animation-type') ?? '').trim().toLowerCase() : direct;
+        };
+        // 属性の分岐とクラスの分岐は、querySelector で安価に判定できるので先に済ませる。
+        // computed style の全要素走査はカスタムプロパティの分岐だけに絞り、マーカー無しの既定ケースの費用を下げる。
+        const attributeElements = [
+            ...(slide.matches(attributeSelector) ? [slide] : []),
+            ...slide.querySelectorAll(attributeSelector),
+        ];
+        let hasExplicitAnimation = attributeElements.some((element) => {
+            const name = attributeName(element);
+            return name !== '' && name !== 'none';
+        });
+        if (!hasExplicitAnimation) {
+            const classSelector = knownNames.map(name => `.${name}`).join(', ');
+            hasExplicitAnimation = slide.matches(classSelector) || slide.querySelector(classSelector) !== null;
+        }
+        if (!hasExplicitAnimation) {
+            for (const element of [slide, ...slide.querySelectorAll('*')]) {
+                // ここに到達する時点で属性値があれば `none`。上流はその要素のカスタムプロパティを見ない
+                if (attributeName(element) !== '')
+                    continue;
+                const elementStyle = globalThis.getComputedStyle(element);
+                const customName = [
+                    elementStyle.getPropertyValue('--pptx-animation-name'),
+                    elementStyle.getPropertyValue('--pptx-animation'),
+                ].map(value => value.trim().toLowerCase()).find(value => value !== '') ?? '';
+                if (customName !== '' && customName !== 'none') {
+                    hasExplicitAnimation = true;
+                    break;
+                }
+            }
+        }
+        const blob = await globalThis.window.domToPptx.exportToPptx(slide, {
+            // spread を先頭に置き、呼び出しごとに決まる fileName / skipDownload を後勝ちで固定する。
+            // excess property check は変数経由の代入に働かない。
+            // そのため exportOptions に skipDownload が紛れ込むと、ページ側でダウンロードが動く。
+            ...exportOptionsInner,
+            fileName: `${prefix}${slideNumInner.toString()}.pptx`,
+            skipDownload: true,
+        });
+        const arrayBuffer = await blob.arrayBuffer();
+        const bytes = new Uint8Array(arrayBuffer);
+        let binary = '';
+        for (const byte of bytes) {
+            binary += String.fromCharCode(byte);
+        }
+        return {
+            pptxData: btoa(binary),
+            letterSpacingMap,
+            hasExplicitAnimation,
+        };
+    }, { slideNum, prefix: slidePrefix, visibleFn: slideVisibleFunctionSource, exportOptions, knownNames: knownAnimationNames, targetSel: targetSelector });
+    const hrefMap = await page.evaluate(({ visibleFn, targetSel }) => {
+        const map = {};
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval, @typescript-eslint/no-unsafe-call
+        const isVisible = new Function('return ' + visibleFn)();
+        let slideElement = null;
+        if (targetSel === null) {
+            for (const s of globalThis.document.querySelectorAll('.slidev-page')) {
+                if (isVisible(s)) {
+                    slideElement = s;
+                    break;
+                }
+            }
+        }
+        else {
+            slideElement = globalThis.document.querySelector(targetSel);
+        }
+        if (!slideElement)
+            return map;
+        for (const a of slideElement.querySelectorAll('a[href]')) {
+            const text = (a.textContent ?? '').trim();
+            const href = a.getAttribute('href');
+            if (text && href && href.startsWith('http')) {
+                map[text] = href;
+            }
+        }
+        return map;
+    }, { visibleFn: slideVisibleFunctionSource, targetSel: targetSelector });
+    const buffer = Buffer.from(pptxData, 'base64');
+    logger.debug(`  PPTXデータ: ${(buffer.length / 1024).toFixed(0)} KB (base64: ${pptxData.length.toString()} chars)`);
+    const slidePath = join(slidesDir, `${slidePrefix}${slideNum.toString()}.pptx`);
+    await writeFile(slidePath, buffer);
+    logger.verbose(`  slides/${slidePrefix}${slideNum.toString()}.pptx (${(buffer.length / 1024).toFixed(2)} KB)`);
+    const spacingCount = Object.keys(letterSpacingMap).length;
+    if (spacingCount > 0) {
+        logger.verbose(`  letter-spacing: ${spacingCount.toString()}件`);
+        const entries = Object.entries(letterSpacingMap);
+        const preview = entries.slice(0, 5);
+        logger.debug(`  letter-spacing詳細: ${JSON.stringify(Object.fromEntries(preview))}${entries.length > 5 ? ` ... (${entries.length.toString()}件中5件)` : ''}`);
+    }
+    const hrefCount = Object.keys(hrefMap).length;
+    if (hrefCount > 0) {
+        logger.verbose(`  href-map: ${hrefCount.toString()}件`);
+        const hrefEntries = Object.entries(hrefMap);
+        const hrefPreview = hrefEntries.slice(0, 5);
+        logger.debug(`  href-map詳細: ${JSON.stringify(Object.fromEntries(hrefPreview))}${hrefEntries.length > 5 ? ` ... (${hrefEntries.length.toString()}件中5件)` : ''}`);
+    }
+    if (hasExplicitAnimation) {
+        logger.verbose('  明示指定のアニメーション: あり（このスライドの p:timing は残す）');
+    }
+    return { pptxPath: slidePath, letterSpacingMap, hrefMap, hasExplicitAnimation };
+}
+/* eslint-enable unicorn/name-replacements, unicorn/no-null, unicorn/import-style */
+/* eslint-enable unicorn/no-typeof-undefined, unicorn/prefer-code-point, no-restricted-syntax */
+/* eslint-enable security/detect-non-literal-fs-filename, security/detect-object-injection */
+/* eslint-enable @typescript-eslint/prefer-readonly-parameter-types */
+/* eslint-enable @typescript-eslint/prefer-optional-chain */
+/* eslint-enable @typescript-eslint/no-unnecessary-condition */
+/* eslint-enable unicorn/dom-node-dataset */
+//# sourceMappingURL=dom-converter.js.map

package/cli/dist/infra/slidev-to-pptx/index.d.ts

@@ -0,0 +1,19 @@
+import type { SlidevPptxConvertArguments, SlidevPptxPipeline } from '../../domain/_shared/ports.js';
+import { type PipelineConfig } from '../../domain/slidev-to-pptx/config.js';
+import type { PipelineResult } from '../../domain/slidev-to-pptx/types.js';
+import { type PipelineDependencies } from './pipeline.js';
+export type { PipelineDependencies } from './pipeline.js';
+/**
+`convertToPptx` を呼び出す関数の差し替え用 port。test では mock を渡し、
+本番では default の `convertToPptx` 実装が使われる。
+*/
+export type ConvertToPptxRunner = (config: Readonly<PipelineConfig>, dependencies: PipelineDependencies) => Promise<PipelineResult>;
+export interface InProcessSlidevPptxPipelineDependencies {
+    readonly convertToPptxRunner?: ConvertToPptxRunner;
+}
+export declare class InProcessSlidevPptxPipeline implements SlidevPptxPipeline {
+    private readonly runner;
+    constructor(dependencies?: Readonly<InProcessSlidevPptxPipelineDependencies>);
+    convert(arguments_: Readonly<SlidevPptxConvertArguments>): Promise<PipelineResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/cli/dist/infra/slidev-to-pptx/index.js

@@ -0,0 +1,127 @@
+// in-process Slidev → PPTX pipeline 実装。旧 ChildProcessPptxConverter を rename + 刷新し、
+// Playwright 起動・dom-to-pptx 注入・slide 並列実行を本プロセス内で行う。
+//
+// timeout 制御は AbortController で行う。
+// 上限は「進捗が無い時間」(idleTimeoutMs) で、pipeline.ts が deps.onProgress で進捗を報告するたびに計時をやり直す。
+// 合計時間の上限は持たない (枚数が多いだけの正常な変換を打ち切らない)。
+// pipeline.ts は signal を受け取り、要所で cooperative cancel を実施する。
+// ただし Playwright 内部の `browser.close()` 完了待ちは、Playwright 側の接続解除に依存する。
+// そのため、即座には終わらないことがある。
+import path from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { DEFAULT_SLIDE_PREFIX } from '../../domain/slidev-to-pptx/config.js';
+import { errorMessage } from '../../domain/slidev-to-pptx/error-utils.js';
+import { PipelineRuntimeError, PipelineTimeoutError, } from '../../domain/slidev-to-pptx/errors.js';
+import { createLogger } from './console-logger.js';
+import { convertToPptx } from './pipeline.js';
+// 0 = ephemeral port。OS が空きポートを採番するため、複数 worktree のテスト・変換が並行しても、
+// dist 配信サーバ同士が衝突しない。
+// 固定 3002 時代は、EADDRINUSE が握り潰されて無限ハングしていた。
+const DEFAULT_PORT = 0;
+const DEFAULT_CONCURRENCY = 4;
+const DEFAULT_LOG_LEVEL = 'normal';
+/**
+1 パス方式のグループ数を env の値から読む（#1141）。1 以上の整数だけを採り、未設定・不正値は
+キーを置かない（pipeline が concurrency を使う）。
+*/
+function singlePassConcurrencyFromEnvironment(value) {
+    if (value === undefined || !/^\d+$/.test(value))
+        return {};
+    const parsed = Math.trunc(Number(value));
+    return parsed >= 1 ? { singlePassConcurrency: parsed } : {};
+}
+export class InProcessSlidevPptxPipeline {
+    runner;
+    constructor(dependencies = {}) {
+        this.runner = dependencies.convertToPptxRunner ?? convertToPptx;
+    }
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types -- stream は mutable 型
+    async convert(arguments_) {
+        const config = {
+            presDir: path.resolve(arguments_.presDirectory),
+            templatePath: path.resolve(arguments_.targetDirectory),
+            outputDir: path.resolve(arguments_.outputDirectory),
+            slidePrefix: DEFAULT_SLIDE_PREFIX,
+            port: arguments_.port ?? DEFAULT_PORT,
+            // eslint-disable-next-line unicorn/no-null -- PipelineConfig.onlySlide は null 既定 (旧 lib 仕様)
+            onlySlide: null,
+            concurrency: arguments_.concurrency ?? DEFAULT_CONCURRENCY,
+            logLevel: arguments_.logLevel ?? DEFAULT_LOG_LEVEL,
+            skipPostprocess: arguments_.skipPostprocess === true,
+            // 1 パス方式（#1141 で試作、#1147 で既定 on）。
+            // env の解釈の基準はここで、pipeline は config だけを見る。
+            // `slide convert --no-single-pass`（arguments_.singlePass === false）なら off。
+            // env `PECOTV_SINGLE_PASS=0` でも off。env が `0` 以外の値、または未設定なら on。
+            singlePass: arguments_.singlePass !== false && process.env['PECOTV_SINGLE_PASS'] !== '0',
+            ...singlePassConcurrencyFromEnvironment(process.env['PECOTV_SINGLE_PASS_CONCURRENCY']),
+            // exactOptionalPropertyTypes: true のため、未指定は「キー自体を置かない」で伝搬する。
+            ...(arguments_.cachePluginVersion !== undefined && {
+                cache: {
+                    pluginVersion: arguments_.cachePluginVersion,
+                    // eslint-disable-next-line unicorn/no-null -- PipelineConfig.cache.theme は未指定 null 既定 (旧 lib 仕様踏襲)
+                    theme: arguments_.theme ?? null,
+                    skipRead: arguments_.cacheSkipRead === true,
+                },
+            }),
+        };
+        // stdout は呼び出し元が明示したときだけ使う。
+        // `slide convert --json` は stdout を JSON 行だけにするため、stdout を渡さない。
+        // そのため人間可読ログは stderr 側へ寄せる。process.stdout へフォールバックすると JSON イベントと混在する。
+        const stderr = arguments_.stderr ?? process.stderr;
+        const sink = {
+            stdout: arguments_.stdout ?? stderr,
+            stderr,
+        };
+        const logger = createLogger(config.logLevel, sink);
+        const controller = new AbortController();
+        const startedAt = performance.now();
+        let lastProgress;
+        // abort 時刻そのもの (elapsedMs の基準)。catch 節に来るまでの間に Phase 1 の後始末
+        // (browser.close 等) が挟まると観測時刻が遅れるため、abort 発火の瞬間に確定させる。
+        let abortedAt;
+        const abort = () => {
+            abortedAt = performance.now();
+            controller.abort();
+        };
+        let timeoutHandle = setTimeout(abort, arguments_.idleTimeoutMs);
+        // 進捗のたびに計時をやり直す。abort 後の遅れた報告でタイマーを蘇らせない。
+        const onProgress = (label) => {
+            if (controller.signal.aborted)
+                return;
+            lastProgress = label;
+            clearTimeout(timeoutHandle);
+            timeoutHandle = setTimeout(abort, arguments_.idleTimeoutMs);
+        };
+        try {
+            return await this.runner(config, {
+                logger,
+                // 外部のキャンセルは無進捗タイムアウトと合成する。タイムアウト判定は controller だけを見るため、
+                // キャンセルで打ち切った run は PipelineTimeoutError ではなく通常の失敗として扱われる。
+                signal: arguments_.signal === undefined ? controller.signal : AbortSignal.any([controller.signal, arguments_.signal]),
+                onProgress,
+                ...(arguments_.onStepProgress !== undefined && { onStepProgress: arguments_.onStepProgress }),
+            });
+        }
+        catch (error) {
+            if (controller.signal.aborted) {
+                // timeout で打ち切った run でも、pipeline が積んだ警告とエラーは commands 層まで届ける。
+                const warnings = error instanceof PipelineRuntimeError ? error.warnings : undefined;
+                const errors = error instanceof PipelineRuntimeError ? error.errors : undefined;
+                throw new PipelineTimeoutError(arguments_.idleTimeoutMs, {
+                    elapsedMs: Math.round((abortedAt ?? performance.now()) - startedAt),
+                    ...(lastProgress !== undefined && { lastProgress }),
+                    ...(warnings !== undefined && { warnings }),
+                    ...(errors !== undefined && { errors }),
+                });
+            }
+            // 二重 wrap 防止: pipeline 内部で既に PipelineRuntimeError 化されたものはそのまま rethrow
+            if (error instanceof PipelineRuntimeError)
+                throw error;
+            throw new PipelineRuntimeError(errorMessage(error), { cause: error });
+        }
+        finally {
+            clearTimeout(timeoutHandle);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/cli/dist/infra/slidev-to-pptx/pipeline.d.ts

@@ -0,0 +1,73 @@
+import type { Server } from 'node:http';
+import { type Browser } from 'playwright';
+import { type PipelineConfig } from '../../domain/slidev-to-pptx/config.js';
+import type { Logger } from '../../domain/slidev-to-pptx/logger.js';
+import type { PipelineResult } from '../../domain/slidev-to-pptx/types.js';
+import { computeDeckCacheKeys, materializeCacheEntry } from './cache-store.js';
+import { type SinglePassRunner } from './single-pass-worker.js';
+import { type SlideWorkerRunner } from './slide-worker.js';
+/**
+convertToPptx の依存注入。test 時に Browser / Server / dom-to-pptx の解決方法を差し替える。
+既定値は本物の chromium / startServer / 依存ルート経由の dom-to-pptx 解決。
+*/
+export interface PipelineDependencies {
+    readonly logger?: Logger;
+    readonly createBrowser?: () => Promise<Browser>;
+    readonly createServer?: (distDir: string, port: number) => Promise<Server>;
+    /**
+    dom-to-pptx.bundle.js の絶対パスを返す関数。省略時は依存ルート経由で解決
+    */
+    readonly resolveDomToPptx?: () => string;
+    /**
+    convertSingleSlideWithRetry の差し替え (orchestration test 分離用)
+    */
+    readonly slideWorkerRunner?: SlideWorkerRunner;
+    /**
+    1 パス変換（config.singlePass）の差し替え (orchestration test 分離用)
+    */
+    readonly singlePassRunner?: SinglePassRunner;
+    /**
+    上位 (InProcessSlidevPptxPipeline) からの cooperative cancel signal。
+    要所で `signal.aborted` を観測し、true なら早期 throw する。
+    要所は Phase 1 scan の前後、Phase 1 worker の並列実行前、merge/output の直前。
+    Playwright `browser.close()` 自体は try-finally で必ず呼ばれる。
+    ただし内部の close 完了待ちは、Playwright の接続解除に依存する。
+    */
+    readonly signal?: AbortSignal;
+    /**
+    進捗の報告先 (省略可)。
+    スキャンで 1 ステップ検出するごとと、スライド 1 ステップの変換が終わる (成功・失敗とも) ごとに呼ぶ。
+    上位 (InProcessSlidevPptxPipeline) はこれで idle timeout の計時をやり直す。
+    label は打ち切り時のメッセージに「最終進捗」として載る。
+    */
+    readonly onProgress?: (label: string) => void;
+    /**
+    ステップ単位の進み具合の報告先 (省略可)。
+    スキャンでステップ総数が決まった時点で、completed=0 を 1 回呼ぶ。
+    以降は、ステップが 1 つ終わる (キャッシュ復元・変換の成功/失敗) ごとに呼ぶ。
+    completed は終わったステップの重複なしの数で、別の変換方式へ退避してやり直しても二重に数えない。
+    */
+    readonly onStepProgress?: (completed: number, total: number) => void;
+    /**
+    cache-store 関数の差し替え (test 専用)。省略時は cache-store.js の実装をそのまま使う。
+  
+    実 fs I/O のエラー注入なしに、2 つの分岐を決定論的にテストするための DI 口。
+    - `computeDeckCacheKeys` の予期しない throw は、SC-004 の最終防波堤になる。外側 catch で警告し、全変換にフォールバックする。
+    - `materializeCacheEntry` の throw は、当該ステップを miss に降格する。
+    */
+    readonly cacheStore?: Readonly<{
+        readonly computeDeckCacheKeys?: typeof computeDeckCacheKeys;
+        readonly materializeCacheEntry?: typeof materializeCacheEntry;
+    }>;
+}
+/**
+1 パス変換を使わなかった（一部を現行方式へ回した場合を含む）ときの warning の接頭辞。E2E も参照する
+*/
+export declare const SINGLE_PASS_FALLBACK_PREFIX = "1 \u30D1\u30B9\u5909\u63DB\u3092\u4F7F\u308F\u305A\u73FE\u884C\u65B9\u5F0F\u3067\u5909\u63DB\u3057\u307E\u3059";
+/**
+Slidev → PPTX 変換パイプライン (並列実行モード)。
+Phase 2+3 (旧 Python pptx-postprocess による merge) は cli 側で実施する。
+そのため本実装は、常に Phase 1 (DOM → 単スライド PPTX) のみを実行する。
+*/
+export declare function convertToPptx(config: Readonly<PipelineConfig>, deps?: PipelineDependencies): Promise<PipelineResult>;
+//# sourceMappingURL=pipeline.d.ts.map