@pecot/visual-mcp 0.0.0-stage → 1.1.0

package/cli/dist/commands/drawio/export.js

@@ -0,0 +1,346 @@
+// `pecotv drawio export <input.drawio> [--icons <dir>] [--output <path>] [--print-hash] [--json]`
+// の実装。commands/drawio/url.ts と同形の DI / 二段例外 / writeErr フックを採用する。
+//
+// 公開ビルドの draw.io 図を CDN 非依存にするため、パイプライン（公開フック）が
+// 呼ぶ自動化の一部。生 XML をそのまま export すると `icon://` 参照が全滅する。
+// そのため icon 解決 → export → color-scheme 固定 → 合成ハッシュ埋め込み の順で処理する。
+//
+// 標準で SVG の兄弟ファイル（拡張子を .pdf に置換）として PDF も書き出す。PDF の失敗は
+// SVG を書いたうえで warning に落とす（exit 3）。`--no-pdf` で抑止する。`-o` に `.pdf` は
+// `--no-pdf` の有無に関係なく指定できない（中身が SVG の `.pdf` を書かないため）。
+//
+// `--print-hash` は export を伴わず合成ハッシュだけを出す。公開フックが「既存 SVG が
+// 現在の入力と対応しているか」を判定するためのルート。
+// ハッシュの組み立て規則をフック側の bash に複製しないよう、CLI 側へ寄せている。
+//
+// exit code 規約を次に示す。
+//   0 = success。
+//   1 = RuntimeError (input/output IO failure・icon 未解決・export 失敗)。
+//   2 = UsageError (invalid option)。
+//   3 = warnings present (PDF 生成失敗)。
+// input/output は CLI 引数として受理する想定で、信頼境界外ではあるが open API 仕様。
+/* eslint-disable security/detect-non-literal-fs-filename */
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Command } from 'commander';
+import { collectIconReferences, computeSourceHash, embedSourceHash, forceLightColorScheme, resolveIconsForExport, siblingPath } from '../../domain/drawio/export.js';
+import { createIconResolver } from '../../infra/drawio/icons.js';
+import { exportPdf } from '../../infra/drawio/pdf.js';
+import { exportViaEmbed } from '../../infra/drawio/screenshot.js';
+/**
+`--output` 省略時に付与する拡張子。`<xmlSrc>.svg` という公開物の命名規約と揃える。
+*/
+const OUTPUT_SUFFIX = '.svg';
+/**
+兄弟 PDF の拡張子。
+*/
+const PDF_EXTENSION = '.pdf';
+/**
+警告が 1 件以上あるときの exit code。drawio url の「警告あり」と揃える。
+*/
+const WARNING_EXIT_CODE = 3;
+export class DrawioExportUsageError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'DrawioExportUsageError';
+    }
+}
+export class DrawioExportRuntimeError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'DrawioExportRuntimeError';
+    }
+}
+/**
+`-o` の拡張子を確認する。`.pdf` は `--no-pdf` の有無に関係なく拒否する。
+PDF 同時出力時は兄弟 PDF が SVG 自身を上書きし、`--no-pdf` 時は中身が SVG の `.pdf` が書かれるため。
+`--print-hash` は何も書かないため確認しない。
+
+入力の読み込みや Chromium の確認より先に呼べるよう、IO を伴わない純粋関数にしてある
+（MCP の drawio_export も Chromium 確認の前にこれを呼ぶ）。
+*/
+export function assertOutputExtension(output, options) {
+    if (output === undefined || output === '' || options.printHash || (path.extname(output).toLowerCase() !== PDF_EXTENSION))
+        return;
+    throw new DrawioExportUsageError(`-o に拡張子 ${PDF_EXTENSION} は使えません (got: ${path.resolve(output)})。出力は SVG のため ${OUTPUT_SUFFIX} 等の拡張子を指定してください`, 'invalid-output-extension');
+}
+export async function runDrawioExport(inputFile, options, 
+// DI 経由の write は mutate メソッド。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies) {
+    const absoluteInput = path.resolve(inputFile);
+    const absoluteOutput = options.output === undefined || options.output === ''
+        ? `${absoluteInput}${OUTPUT_SUFFIX}`
+        : path.resolve(options.output);
+    // 入力の読み込みより先に確認して、UsageError のルートでは成果物を残さない。
+    assertOutputExtension(options.output, options);
+    // 兄弟 PDF は SVG の拡張子を `.pdf` に置換して置く。`-o .svg` のように拡張子だけの
+    // ファイル名では置換でなく付加となり、`.svg.pdf` ができる（規則は siblingPath に集約）。
+    const pdfPath = siblingPath(absoluteOutput, PDF_EXTENSION);
+    let xml;
+    try {
+        xml = await dependencies.readFile(absoluteInput);
+    }
+    catch (error) {
+        throw new DrawioExportRuntimeError(`入力ファイルが読めません: ${absoluteInput} (${formatError(error)})`, 'input-not-found');
+    }
+    const iconRoot = path.resolve(options.icons);
+    const resolveIcon = createIconResolver(iconRoot);
+    // 陳腐化検知の基準は「生 XML + 参照 icon の内容」。XML 単体だと icon カタログの
+    // 差し替えを検知できず、古い図をそのまま流用し続ける。
+    const sourceSha256 = computeSourceHash(xml, resolveIcon);
+    const iconCount = collectIconReferences(xml).length;
+    if (options.printHash) {
+        return {
+            inputFile: absoluteInput,
+            outputFile: absoluteOutput,
+            sourceSha256,
+            iconCount,
+            written: false,
+            pdfFile: undefined,
+            pdfFailed: false,
+            warningCount: 0,
+        };
+    }
+    const resolved = resolveIconsForExport(xml, resolveIcon);
+    if (resolved.unresolved.length > 0) {
+        throw new DrawioExportRuntimeError(`icon:// 参照を解決できません (icons root: ${iconRoot}): ${resolved.unresolved.join(', ')}`, 'icon-unresolved');
+    }
+    let svg;
+    try {
+        svg = await dependencies.exportSvg(resolved.xml);
+    }
+    catch (error) {
+        throw new DrawioExportRuntimeError(`SVG export に失敗しました: ${formatError(error)}`, 'export-failed');
+    }
+    const baked = embedSourceHash(forceLightColorScheme(svg), sourceSha256);
+    try {
+        await dependencies.writeFile(absoluteOutput, baked);
+    }
+    catch (error) {
+        throw new DrawioExportRuntimeError(`出力ファイルに書き込めません: ${absoluteOutput} (${formatError(error)})`, 'output-write-failed');
+    }
+    const pdfResult = options.pdf
+        ? await writeSiblingPdf(baked, pdfPath, dependencies)
+        : { pdfFile: undefined, pdfFailed: false };
+    return {
+        inputFile: absoluteInput,
+        outputFile: absoluteOutput,
+        sourceSha256,
+        iconCount,
+        written: true,
+        ...pdfResult,
+        warningCount: pdfResult.pdfFailed ? 1 : 0,
+    };
+}
+/**
+公開物と同じ baked SVG（color-scheme 固定・ハッシュ埋め込み済）から兄弟 PDF を作る。
+失敗は warning に落とし、前回の PDF が残っていれば消す（`pdf: null` の隣に古い PDF が
+残ると、今回の出力と区別できない）。
+*/
+async function writeSiblingPdf(baked, pdfPath, 
+// DI 経由の write は mutate メソッド。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies) {
+    try {
+        await dependencies.exportPdf(baked, pdfPath);
+        return { pdfFile: pdfPath, pdfFailed: false };
+    }
+    catch (error) {
+        dependencies.stderr.write(`[warn] PDF 生成失敗: ${formatError(error)}\n`);
+        // 古い PDF の削除失敗は独立した警告として数えない。今回の PDF 失敗 1 件（pdfFailed /
+        // warnings: 1 / exit 3）に集約し、JSON と exit code には出さず stderr の行だけで知らせる。
+        // 呼び出し側は `pdf: null` を見て隣の PDF を今回の出力として扱わない前提にする。
+        try {
+            await dependencies.removeFile(pdfPath);
+        }
+        catch (removeError) {
+            dependencies.stderr.write(`[warn] 前回の PDF を削除できません: ${pdfPath} (${formatError(removeError)})\n`);
+        }
+        return { pdfFile: undefined, pdfFailed: true };
+    }
+}
+/**
+export（または `--print-hash` のハッシュ算出）を実行し、`--json` の data 同形を組み立てる。
+
+呼び出し元（commander action / MCP ツール）に残るのは「どう見せるか」だけにする。
+*/
+export async function executeDrawioExport(inputFile, options, 
+// DI 経由の write は mutate メソッド。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies) {
+    const summary = await runDrawioExport(inputFile, options, dependencies);
+    if (!summary.written) {
+        return {
+            data: {
+                event: 'drawio.export.hash',
+                file: summary.inputFile,
+                sourceSha256: summary.sourceSha256,
+                icons: summary.iconCount,
+            },
+            artifacts: [],
+            sourceSha256: summary.sourceSha256,
+            outputFile: undefined,
+            pdfFile: undefined,
+            warningCount: 0,
+            exitCode: 0,
+        };
+    }
+    return {
+        data: {
+            event: 'drawio.export.done',
+            file: summary.outputFile,
+            sourceSha256: summary.sourceSha256,
+            icons: summary.iconCount,
+            // eslint-disable-next-line unicorn/no-null -- PDF を出していないときに `pdf: null` を返すことが JSON の契約
+            pdf: summary.pdfFile ?? null,
+            pdfFailed: summary.pdfFailed,
+            warnings: summary.warningCount,
+        },
+        artifacts: summary.pdfFile === undefined ? [summary.outputFile] : [summary.outputFile, summary.pdfFile],
+        sourceSha256: summary.sourceSha256,
+        outputFile: summary.outputFile,
+        pdfFile: summary.pdfFile,
+        warningCount: summary.warningCount,
+        exitCode: summary.warningCount > 0 ? WARNING_EXIT_CODE : 0,
+    };
+}
+/* c8 ignore start -- 非 Error 例外 (string throw 等) は本実装範囲では未発生、防御網のみ */
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/* c8 ignore stop */
+/* c8 ignore start -- 上記 2 種以外の throw は実装内に存在しない、防御網のみ */
+export function errorToReason(error) {
+    if (error instanceof DrawioExportUsageError)
+        return error.reason;
+    if (error instanceof DrawioExportRuntimeError)
+        return error.reason;
+    return 'unknown';
+}
+/* c8 ignore stop */
+/**
+例外を exit code 規約へ写す（2 = UsageError、1 = それ以外）。
+
+CLI の action と MCP ツールが同じ対応表を使うための共有点。
+*/
+export function toExitCode(error) {
+    return error instanceof DrawioExportUsageError ? 2 : 1;
+}
+function doesArgvWantJson(argv) {
+    return argv.includes('--json');
+}
+// --icons は requiredOption のため未指定は commander が弾く。空文字だけがここに到達する。
+function parseIcons(raw) {
+    const value = String(raw);
+    if (value === '') {
+        throw new DrawioExportUsageError('option --icons に icon:// の解決 root ディレクトリを指定してください', 'missing-icons-root');
+    }
+    return value;
+}
+export function createDrawioExportCommand(buildDependencies) {
+    const command = new Command('export')
+        .description('drawio XML を静的 SVG と兄弟の PDF に export する')
+        .argument('<input>', '入力 .drawio ファイルパス')
+        // CLI 側は required に据え置く（既定を持つのは MCP の drawio_export だけ）。
+        // 呼び出し側が talk-dir 相対の public/assets/icons など、解決の root を明示して渡す。
+        // プラグイン同梱カタログを既定にすると、誤った root で通知なしに解決されうる。
+        .requiredOption('--icons <dir>', 'icon:// を解決する root ディレクトリ')
+        .option('-o, --output <path>', `出力 SVG パス (既定: <input>${OUTPUT_SUFFIX})`)
+        .option('--no-pdf', 'SVG の兄弟ファイル (拡張子を .pdf に置換) として PDF を同時出力しない')
+        .option('--print-hash', 'export せず、陳腐化判定用の合成ハッシュのみを stdout に出す', false)
+        .option('--json', 'machine-readable な JSON を stdout に出す', false)
+        .exitOverride()
+        .configureOutput({
+        writeErr: (string_) => {
+            const dependencies = buildDependencies();
+            if (doesArgvWantJson(process.argv)) {
+                dependencies.stdout.write(`${JSON.stringify({
+                    event: 'drawio.export.error',
+                    reason: 'invalid-option',
+                    detail: string_.replace(/^error:[ \t]*/i, '').trim(),
+                })}\n`);
+            }
+            else {
+                dependencies.stderr.write(string_);
+            }
+        },
+    })
+        .action(async (input, raw) => {
+        const dependencies = buildDependencies();
+        const isJson = raw['json'] === true;
+        let options;
+        try {
+            options = {
+                icons: parseIcons(raw['icons']),
+                output: typeof raw['output'] === 'string' ? raw['output'] : undefined,
+                printHash: raw['printHash'] === true,
+                pdf: raw['pdf'] !== false,
+            };
+        }
+        catch (error) {
+            writeFailure(dependencies, isJson, errorToReason(error), formatError(error));
+            process.exitCode = 2;
+            return;
+        }
+        try {
+            const execution = await executeDrawioExport(input, options, dependencies);
+            if (isJson) {
+                dependencies.stdout.write(`${JSON.stringify(execution.data)}\n`);
+            }
+            else if (execution.outputFile === undefined) {
+                // 呼び出し側（公開フック）が値をそのまま変数に取れるよう、素の出力は
+                // ハッシュ 1 行だけにする。
+                dependencies.stdout.write(`${execution.sourceSha256}\n`);
+            }
+            else {
+                dependencies.stderr.write(`wrote SVG to ${execution.outputFile}\n`);
+                if (execution.pdfFile !== undefined) {
+                    dependencies.stderr.write(`wrote PDF to ${execution.pdfFile}\n`);
+                }
+            }
+            if (execution.exitCode !== 0) {
+                process.exitCode = execution.exitCode;
+            }
+        }
+        catch (error) {
+            writeFailure(dependencies, isJson, errorToReason(error), formatError(error));
+            process.exitCode = toExitCode(error);
+        }
+    });
+    return command;
+}
+function writeFailure(
+// DI 経由の write は mutate メソッド。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies, isJson, reason, detail) {
+    if (isJson) {
+        dependencies.stdout.write(`${JSON.stringify({ event: 'drawio.export.error', reason, detail })}\n`);
+    }
+    else {
+        dependencies.stderr.write(`pecotv drawio export: ${detail}\n`);
+    }
+}
+export function drawioExportDefaultDependencies() {
+    return {
+        stdout: process.stdout,
+        stderr: process.stderr,
+        readFile: (filePath) => readFile(filePath, 'utf8'),
+        writeFile: async (filePath, content) => {
+            await mkdir(path.dirname(filePath), { recursive: true });
+            await writeFile(filePath, content, 'utf8');
+        },
+        exportSvg: async (xmlString) => {
+            const buffer = await exportViaEmbed(xmlString, { format: 'svg' });
+            return buffer.toString('utf8');
+        },
+        exportPdf,
+        removeFile: (filePath) => rm(filePath, { force: true }),
+    };
+}
+/* eslint-enable security/detect-non-literal-fs-filename */
+//# sourceMappingURL=export.js.map

package/cli/dist/commands/drawio/theme.d.ts

@@ -0,0 +1,46 @@
+import type { ThemeFontSizes, ThemeFonts } from '../../domain/drawio/url.js';
+import type { ThemeFiles } from '../../domain/slidev-theme/ports.js';
+import { fetchTheme } from '../../infra/slidev-theme/store.js';
+export type DrawioThemeSource = 'talk-dir' | 'option' | 'default';
+/**
+図の確認に使うテーマ。`fontSizes` はサイズを確かめるときだけ持つ。
+*/
+export interface DrawioTheme {
+    readonly source: DrawioThemeSource;
+    /**
+    テーマのパッケージ名。既定値では undefined。
+    */
+    readonly name: string | undefined;
+    readonly fonts: ThemeFonts;
+    readonly fontSizes: ThemeFontSizes | undefined;
+}
+export interface DrawioThemeDependencies {
+    /**
+    同梱アセットの起点。dependencyRoot を省いたときの依存ルートにもなる。
+    */
+    readonly pluginRoot: string;
+    readonly dependencyRoot?: string;
+    readonly files?: ThemeFiles;
+    readonly fetchTheme?: typeof fetchTheme;
+    readonly themeStoreRoot?: () => string | undefined;
+    /**
+    `--theme` の相対パスを絶対化する基準。省略時はカレント。
+    */
+    readonly currentDirectory?: string;
+    readonly signal?: AbortSignal;
+}
+/**
+`--json` と MCP の data に載せる `theme`。
+*/
+export declare function themeData(theme: Readonly<DrawioTheme>): Readonly<Record<string, unknown>>;
+/**
+PNG 撮影のページが読み込む書体名。本文の書体に和文の書体を足す。
+*/
+export declare function themeFontNames(theme: Readonly<DrawioTheme>): readonly string[];
+/**
+図の確認に使うテーマを決める。
+`--theme`・図の祖先の talk-dir・既定値の順。解けないテーマは例外で止める（古い値で確かめ続けない）。
+info は取得や宣言の警告と、移行前の案内の出力先。
+*/
+export declare function resolveDrawioTheme(diagramPath: string, themeOption: string | undefined, dependencies: Readonly<DrawioThemeDependencies>, info: (message: string) => void): Promise<DrawioTheme>;
+//# sourceMappingURL=theme.d.ts.map

package/cli/dist/commands/drawio/theme.js

@@ -0,0 +1,165 @@
+// drawio url が書体と文字サイズを確かめるときの、テーマの宣言の決め方。
+//
+// 優先順は、`--theme`、図の祖先の talk-dir、本体の既定値。
+// - `--theme git+...#tag`: 置き場から取得する（fetchTheme）。
+// - `--theme file:<path>`: pecot-theme.json を直接読む。install は要らない。
+// - `--theme <path>`: talk-dir かテーマ root。slides.md か pecot-theme.json が無ければ invalid-theme。
+// - talk-dir: 祖先 D が slides.md を持ち、図が D/public/ の下にあるときだけ。
+// 書体は常に確かめる。5 段のサイズは、talk-dir の中か `--theme` 指定のときだけ確かめる。
+// 移行前の talk-dir（theme-none）は既定値で続ける。解けないテーマ（theme-unlinked・取得や宣言の失敗）は止める。
+// 宣言の欠落や schema の違いの警告は、図の作者には直せない。[info] で出し、exit 3 の件数に数えない。
+import path from 'node:path';
+import { isRecord } from '../../domain/_shared/json.js';
+import { THEME_DECLARATION_FILE_NAME, readThemeDeclaration } from '../../domain/slidev-theme/declaration.js';
+import { DEFAULT_THEME_DECLARATION } from '../../domain/slidev-theme/defaults.js';
+import { findDiagramTalkDirectory } from '../../domain/slidev-theme/diagram-talk-directory.js';
+import { MIGRATE_ADVICE, ThemeResolveError, resolveTalkTheme } from '../../domain/slidev-theme/talk-theme.js';
+import { parseThemeSpec } from '../../domain/slidev-theme/theme-spec.js';
+import { themeStoreRoot } from '../../infra/_shared/dependency-root.js';
+import { NodeThemeFiles } from '../../infra/slidev-theme/fs.js';
+import { fetchTheme } from '../../infra/slidev-theme/store.js';
+import { DrawioUrlRuntimeError, DrawioUrlUsageError } from './errors.js';
+const GIT_PREFIX = 'git+';
+const FILE_PREFIX = 'file:';
+const SLIDES_FILE_NAME = 'slides.md';
+const FALLBACK_THEME = {
+    source: 'default',
+    name: undefined,
+    fonts: { body: DEFAULT_THEME_DECLARATION.fonts.body, eastAsian: DEFAULT_THEME_DECLARATION.fonts.eastAsian },
+    fontSizes: undefined,
+};
+/**
+`--json` と MCP の data に載せる `theme`。
+*/
+export function themeData(theme) {
+    return {
+        source: theme.source,
+        ...(theme.name !== undefined && { name: theme.name }),
+        fonts: {
+            body: [...theme.fonts.body],
+            ...(theme.fonts.eastAsian !== undefined && { eastAsian: theme.fonts.eastAsian }),
+        },
+        ...(theme.fontSizes !== undefined && { fontSizes: { ...theme.fontSizes } }),
+    };
+}
+/**
+PNG 撮影のページが読み込む書体名。本文の書体に和文の書体を足す。
+*/
+export function themeFontNames(theme) {
+    return [...theme.fonts.body, ...(theme.fonts.eastAsian === undefined ? [] : [theme.fonts.eastAsian])];
+}
+/**
+テーマ root の宣言を読み、図の確認で使う形へ変える。宣言の警告は info で出す。
+*/
+async function themeFromRoot(files, source, name, directory, info) {
+    const { declaration, warnings } = await readThemeDeclaration(files, directory);
+    for (const warning of warnings)
+        info(warning);
+    return {
+        source,
+        name,
+        fonts: { body: declaration.fonts.body, eastAsian: declaration.fonts.eastAsian },
+        fontSizes: declaration.fontSizes,
+    };
+}
+/**
+テーマ root の package.json の name。読めなければディレクトリ名。
+*/
+async function packageNameOf(files, directory) {
+    const text = await files.readText(path.join(directory, 'package.json'));
+    if (text !== undefined) {
+        try {
+            const parsed = JSON.parse(text);
+            const name = isRecord(parsed) ? parsed['name'] : undefined;
+            if (typeof name === 'string' && name !== '')
+                return name;
+        }
+        catch {
+            // 読めない package.json はディレクトリ名で代える
+        }
+    }
+    return path.basename(directory);
+}
+async function hasTheme(files, directory, names) {
+    for (const name of names) {
+        if ((await files.readText(path.join(directory, name))) !== undefined)
+            return true;
+    }
+    return false;
+}
+function invalidTheme(option, detail) {
+    return new DrawioUrlUsageError(`option --theme '${option}' ${detail}`, 'invalid-theme');
+}
+async function themeFromOption(option, 
+// DI の port（関数と AbortSignal）を持つため readonly 化できない。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies, files, currentDirectory, info) {
+    if (option.startsWith(GIT_PREFIX)) {
+        const spec = parseThemeSpec(option);
+        const storeRoot = (dependencies.themeStoreRoot ?? themeStoreRoot)();
+        if (storeRoot === undefined) {
+            throw new DrawioUrlRuntimeError('テーマの置き場を決められません。データ置き場（CLAUDE_PLUGIN_DATA）を確認してください', 'theme-unknown');
+        }
+        const fetched = await (dependencies.fetchTheme ?? fetchTheme)(spec, {
+            storeRoot,
+            baseDirectory: currentDirectory,
+            dependencyRoot: dependencies.dependencyRoot ?? dependencies.pluginRoot,
+            signal: dependencies.signal,
+            warn: info,
+        });
+        return await themeFromRoot(files, 'option', fetched.name, fetched.directory, info);
+    }
+    if (option.startsWith(FILE_PREFIX)) {
+        const spec = parseThemeSpec(option);
+        /* c8 ignore next 3 -- FILE_PREFIX で始まる指定は parseThemeSpec が必ず file kind にする */
+        if (spec.kind !== 'file')
+            throw invalidTheme(option, 'を解釈できません');
+        const directory = path.resolve(currentDirectory, spec.path);
+        if (!(await hasTheme(files, directory, [THEME_DECLARATION_FILE_NAME, 'package.json']))) {
+            throw invalidTheme(option, `のテーマ ${directory} に ${THEME_DECLARATION_FILE_NAME} も package.json もありません`);
+        }
+        return await themeFromRoot(files, 'option', await packageNameOf(files, directory), directory, info);
+    }
+    const directory = path.resolve(currentDirectory, option);
+    if (!(await hasTheme(files, directory, [SLIDES_FILE_NAME]))) {
+        // slides.md が無い dir は、テーマ root として宣言を直接読む（talk-dir を経由しない）。
+        if (await hasTheme(files, directory, [THEME_DECLARATION_FILE_NAME])) {
+            return await themeFromRoot(files, 'option', await packageNameOf(files, directory), directory, info);
+        }
+        throw invalidTheme(option, `は talk-dir とテーマ root のどちらでもありません（${directory} に ${SLIDES_FILE_NAME} と ${THEME_DECLARATION_FILE_NAME} が無い）。`
+            + 'git+https://<host>/<owner>/<repo>.git#<tag>・file:<path>・talk-dir のパスのどれかで指定してください');
+    }
+    const resolved = await resolveTalkTheme(files, directory);
+    return await themeFromRoot(files, 'option', resolved.name, resolved.directory, info);
+}
+/**
+図の確認に使うテーマを決める。
+`--theme`・図の祖先の talk-dir・既定値の順。解けないテーマは例外で止める（古い値で確かめ続けない）。
+info は取得や宣言の警告と、移行前の案内の出力先。
+*/
+export async function resolveDrawioTheme(diagramPath, themeOption, 
+// DI の port（関数と AbortSignal）を持つため readonly 化できない。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies, info) {
+    const files = dependencies.files ?? new NodeThemeFiles();
+    const currentDirectory = dependencies.currentDirectory ?? process.cwd();
+    if (themeOption !== undefined && themeOption !== '') {
+        return await themeFromOption(themeOption, dependencies, files, currentDirectory, info);
+    }
+    const talk = await findDiagramTalkDirectory(files, diagramPath);
+    if (talk === undefined)
+        return FALLBACK_THEME;
+    try {
+        const resolved = await resolveTalkTheme(files, talk);
+        return await themeFromRoot(files, 'talk-dir', resolved.name, resolved.directory, info);
+    }
+    catch (error) {
+        // 移行前の talk-dir は、今は動いている図の作成を止めず、既定値で続ける。
+        if (error instanceof ThemeResolveError && error.reason === 'theme-none') {
+            info(`${talk} はテーマを参照していないため、本体の既定の書体で確かめます。${MIGRATE_ADVICE}`);
+            return FALLBACK_THEME;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=theme.js.map