@pecot/visual-mcp 0.0.0-stage → 1.1.0

package/cli/dist/commands/slidev-project/create.js

@@ -0,0 +1,296 @@
+// `pecotv slide create --theme <theme-spec>` の実装。テンプレートはコピーしない。
+// 次の順に実行する。
+// テーマの指定の解釈 → テーマの取得 → 宣言の読み取り → レイアウトの参照と分類の読み取り。
+// 続けて、生成先の確認 → slides.md と package.json の生成 → 初期ページ → public/slides。
+// その後、vite.config.ts と start.mjs の生成 → node_modules の組み立て（実ディレクトリと項目ごとの相対 symlink）。
+// 組み立ては同じ親の下の一時 dir で行い、最後に入れ替える。失敗したら一時 dir を消す。
+/* eslint-disable security/detect-non-literal-fs-filename */
+import { randomBytes } from 'node:crypto';
+import { performance } from 'node:perf_hooks';
+import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Command } from 'commander';
+import { SlideCreateRuntimeError, SlideCreateUsageError } from '../../domain/slidev-project/errors.js';
+import { buildInitialPages, nameToTitle } from '../../domain/slidev-project/initial-pages.js';
+import { talkPackageJsonSource } from '../../domain/slidev-project/package-json.js';
+import { slidesMdSource } from '../../domain/slidev-project/slides-md.js';
+import { LINK_COLOR_OMITTED_WARNING } from '../../domain/slidev-project/warnings.js';
+import { readThemeDeclaration } from '../../domain/slidev-theme/declaration.js';
+import { themeErrorReason } from '../../domain/slidev-theme/error-reason.js';
+import { buildLayoutCatalog, readLayoutCategories, resolveLayoutReferences, } from '../../domain/slidev-theme/references.js';
+import { ThemeSpecError, parseThemeSpec } from '../../domain/slidev-theme/theme-spec.js';
+import { pluginDependencyRoot, themeStoreRoot } from '../../infra/_shared/dependency-root.js';
+import { assertDependencyRootAvailable, linkNodeModules, setupPublicSlides, talkDirectoryExists, writeGeneratedFiles, } from '../../infra/slidev-project/fs.js';
+import { NodeThemeFiles } from '../../infra/slidev-theme/fs.js';
+import { fetchTheme } from '../../infra/slidev-theme/store.js';
+import { autoDeckLintJsonField, runAutoDeckLint, writeAutoDeckLintReport, } from './lint.js';
+import { absoluteSpec, packageSpec } from './theme-source.js';
+export { SlideCreateUsageError } from '../../domain/slidev-project/errors.js';
+/**
+テーマを取得し、talk-dir を生成する。
+
+生成は生成先と同じ親の下の一時 dir で組み立て、最後に入れ替える。
+`--force` で既存の生成先があっても、取得・生成のどこで失敗しても、既存は消えない。
+失敗したら一時 dir を消す。取得中の警告は、失敗の前に出たものも stderr へ流す。
+*/
+export async function runSlideCreate(projectDirectory, options, 
+// DI 経由の write は mutate メソッド。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies) {
+    const warnings = [];
+    try {
+        return await generateTalk(projectDirectory, options, dependencies, warnings);
+    }
+    catch (error) {
+        // 成功したときの警告は executeSlideCreate が流す。失敗したときは、ここで流さないと捨てられる。
+        for (const warning of warnings)
+            dependencies.stderr.write(`[warn] ${warning}\n`);
+        throw error;
+    }
+}
+async function generateTalk(projectDirectory, options, 
+// DI 経由の write は mutate メソッド。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies, 
+// 警告の蓄積先。呼び出し元の配列へ積む。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+warnings) {
+    const projectAbsolute = path.resolve(projectDirectory);
+    const start = dependencies.now();
+    const files = dependencies.files ?? new NodeThemeFiles();
+    const currentDirectory = dependencies.currentDirectory ?? process.cwd();
+    const spec = absoluteSpec(parseThemeSpec(options.theme), currentDirectory);
+    // 生成先には、取得の後まで触れない。生成先の存在と依存ルートの実体は、取得の前に確かめる。
+    const destination = await talkDirectoryExists(projectAbsolute);
+    if (!options.force && destination.exists) {
+        throw new SlideCreateUsageError(`dest dir '${projectAbsolute}' は既に存在します (--force 未指定)`, 'dest-exists');
+    }
+    const dependencyRoot = dependencies.dependencyRoot ?? dependencies.pluginRoot;
+    assertDependencyRootAvailable(dependencyRoot);
+    const storeRoot = (dependencies.themeStoreRoot ?? themeStoreRoot)();
+    if (storeRoot === undefined) {
+        throw new SlideCreateRuntimeError('テーマの置き場を決められません。データ置き場（CLAUDE_PLUGIN_DATA）を確認してください', 'theme-unknown');
+    }
+    const fetched = await (dependencies.fetchTheme ?? fetchTheme)(spec, {
+        storeRoot,
+        baseDirectory: currentDirectory,
+        dependencyRoot,
+        warn: (message) => { warnings.push(message); },
+    });
+    const { declaration, warnings: declarationWarnings } = await readThemeDeclaration(files, fetched.directory);
+    const references = await resolveLayoutReferences(files, {
+        themeRoot: fetched.directory,
+        talkDirectory: projectAbsolute,
+        referencesDirectory: declaration.layouts.references,
+    });
+    const vocabulary = await readLayoutCategories(files, references.directories);
+    const catalog = buildLayoutCatalog(references, vocabulary.categories);
+    const initial = await buildInitialPages(references.entries, files);
+    warnings.push(...declarationWarnings, ...vocabulary.warnings, ...catalog.warnings, ...initial.warnings);
+    if (declaration.pptx.linkColor === undefined)
+        warnings.push(LINK_COLOR_OMITTED_WARNING);
+    const specInPackage = packageSpec(options.theme, spec, projectAbsolute);
+    const pageNames = initial.pages.map(page => page.filename.replace(/\.md$/u, ''));
+    const title = nameToTitle(path.basename(projectAbsolute));
+    const parent = path.dirname(projectAbsolute);
+    const staging = path.join(parent, `.${path.basename(projectAbsolute)}.creating-${randomBytes(4).toString('hex')}`);
+    try {
+        await mkdir(staging, { recursive: true });
+        await writeFile(path.join(staging, 'slides.md'), slidesMdSource({ title, theme: fetched.name, pages: pageNames }), 'utf8');
+        await writeFile(path.join(staging, 'package.json'), talkPackageJsonSource({ name: path.basename(projectAbsolute), themeName: fetched.name, themeSpec: specInPackage }), 'utf8');
+        const pagesDirectory = path.join(staging, 'pages');
+        await mkdir(pagesDirectory, { recursive: true });
+        for (const page of initial.pages) {
+            await writeFile(path.join(pagesDirectory, page.filename), page.content, 'utf8');
+        }
+        await setupPublicSlides(staging);
+        await writeGeneratedFiles(staging, { themeName: fetched.name });
+        // node_modules の相対 symlink は親ごと同じ位置に入れ替わるため、入れ替え後も同じ先を指す。
+        await linkNodeModules(staging, dependencyRoot, [{ name: fetched.name, directory: fetched.directory }]);
+        // 組み立てが済んでから、既存の生成先 (--force) を外して入れ替える。
+        if (destination.exists)
+            await rm(projectAbsolute, { recursive: true, force: true });
+        await rename(staging, projectAbsolute);
+    }
+    catch (error) {
+        await rm(staging, { recursive: true, force: true });
+        throw error;
+    }
+    return {
+        projectDirectory: projectAbsolute,
+        theme: { name: fetched.name, spec: specInPackage },
+        durationMs: dependencies.now() - start,
+        catalog,
+        warnings,
+    };
+}
+/**
+`slide create` の実処理と機械可読な結果組み立て。CLI action と MCP ツールの双方がここを通る。
+
+@param onCreated 生成完了時点（deck lint より前）に呼ばれる。CLI は人間向けの成否行を
+  ここで書き、違反一覧より先に出す。MCP ツールは渡さない。
+*/
+export async function executeSlideCreate(projectDirectory, options, 
+// DI 経由の write は mutate メソッド。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies, onCreated) {
+    const { catalog, warnings, ...summary } = await runSlideCreate(projectDirectory, options, dependencies);
+    for (const warning of warnings)
+        dependencies.stderr.write(`[warn] ${warning}\n`);
+    if (options.emitCatalog)
+        emitLayoutCatalog(catalog, dependencies.stdout);
+    onCreated?.(summary);
+    // 生成直後のデッキ全体 lint。違反があっても create の成否は変えない。
+    const lint = await runAutoDeckLint(summary.projectDirectory, dependencies);
+    return {
+        summary,
+        lint,
+        data: {
+            event: 'slide.create.done',
+            projectDir: summary.projectDirectory,
+            theme: summary.theme,
+            categories: catalog.categories,
+            layouts: catalog.layouts,
+            warnings,
+            lint: autoDeckLintJsonField(lint),
+        },
+    };
+}
+/**
+収集済みのレイアウトの一覧を人間向けに stdout へ書き出す。分類ごとに群化し、deprecated は群内で
+`[deprecated]` 接頭辞を付ける（選ばない対象だが、分類から外して別枠にすると、その分類に
+何が属するかが読めなくなる）。レイアウトが 0 件の分類も見出しを出して不足を見せる。
+*/
+export function emitLayoutCatalog(catalog, 
+// WritableStream の write は mutate。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+stdout) {
+    const { categories, layouts } = catalog;
+    stdout.write(`${'='.repeat(60)}\n`);
+    stdout.write('Layout Catalog (Step 2 のプランモード前に必ず読み切ること)\n');
+    stdout.write(`${'='.repeat(60)}\n\n`);
+    for (const category of categories) {
+        stdout.write(`--- ${category.label}: ${category.question} ---\n\n`);
+        const members = layouts.filter(entry => entry.category === category.id);
+        if (members.length === 0) {
+            stdout.write('(該当レイアウトなし)\n\n');
+            continue;
+        }
+        for (const { layout, description, deprecated } of members) {
+            stdout.write(`- ${deprecated ? '[deprecated] ' : ''}${layout}: ${description}\n`);
+        }
+        stdout.write('\n');
+    }
+}
+/* c8 ignore start -- 非 Error 例外 (string throw 等) は本実装範囲では未発生、防御網のみ */
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/* c8 ignore stop */
+/**
+失敗の reason。テーマの取得・宣言・指定の失敗は `theme-<reason>`（`themeErrorReason`）にする。
+*/
+export function errorToReason(error) {
+    if (error instanceof SlideCreateUsageError)
+        return error.reason;
+    if (error instanceof SlideCreateRuntimeError)
+        return error.reason;
+    return themeErrorReason(error) ?? 'unknown';
+}
+/**
+失敗時の exit code。usage error（引数の誤り、テーマの指定の誤り）= 2、それ以外の実行失敗 = 1。
+*/
+export function toExitCode(error) {
+    return error instanceof SlideCreateUsageError || error instanceof ThemeSpecError ? 2 : 1;
+}
+function doesArgvWantJson(argv) {
+    return argv.includes('--json');
+}
+export function createSlideCreateCommand(buildDependencies) {
+    const command = new Command('create')
+        .description('テーマを参照する Slidev プレゼンテーションを生成する')
+        .argument('<project-dir>', '生成先ディレクトリ')
+        .requiredOption('--theme <spec>', 'テーマの指定 (git+https://<host>/<owner>/<repo>.git#<tag> か file:<path>)')
+        .option('--force', '既存ディレクトリを上書きする', 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: 'slide.create.error',
+                    reason: 'invalid-option',
+                    detail: string_.replace(/^error:[ \t]*/i, '').trim(),
+                })}\n`);
+            }
+            else {
+                dependencies.stderr.write(string_);
+            }
+        },
+    })
+        .action(async (projectDirectory, raw) => {
+        const dependencies = buildDependencies();
+        const isWantsJson = raw['json'] === true;
+        const options = {
+            theme: requireString(raw, 'theme'),
+            force: raw['force'] === true,
+            emitCatalog: !isWantsJson,
+        };
+        try {
+            const execution = await executeSlideCreate(projectDirectory, options, dependencies, (summary) => {
+                if (isWantsJson)
+                    return;
+                dependencies.stdout.write(`slide create: 成功 (${summary.projectDirectory})\n`);
+                dependencies.stdout.write(`  theme=${summary.theme.name}, ${String(Math.round(summary.durationMs))}ms\n`);
+            });
+            if (isWantsJson) {
+                dependencies.stdout.write(`${JSON.stringify(execution.data)}\n`);
+            }
+            else {
+                writeAutoDeckLintReport(execution.lint, execution.summary.projectDirectory, dependencies);
+            }
+        }
+        catch (error) {
+            const reason = errorToReason(error);
+            const detail = formatError(error);
+            if (isWantsJson) {
+                dependencies.stdout.write(`${JSON.stringify({
+                    event: 'slide.create.error',
+                    reason,
+                    detail,
+                })}\n`);
+            }
+            else {
+                dependencies.stderr.write(`pecotv slide create 失敗: ${detail}\n`);
+            }
+            process.exitCode = toExitCode(error);
+        }
+    });
+    return command;
+}
+function requireString(raw, key) {
+    // eslint-disable-next-line security/detect-object-injection -- key は本ファイル内固定文字列
+    const value = raw[key];
+    /* c8 ignore next 3 -- commander の requiredOption で必ず string が入るため到達不能 */
+    if (typeof value !== 'string') {
+        throw new SlideCreateUsageError(`option --${key} is required`, 'missing-option');
+    }
+    return value;
+}
+export function slideCreateDefaultDependencies() {
+    const pluginRoot = process.env['CLAUDE_PLUGIN_ROOT'];
+    /* c8 ignore next 3 -- bin/pecotv が CLAUDE_PLUGIN_ROOT を必ず export するため未設定ルートは実運用で発生しない */
+    if (pluginRoot === undefined || pluginRoot === '') {
+        throw new SlideCreateRuntimeError('CLAUDE_PLUGIN_ROOT が未設定です', 'unknown');
+    }
+    const dependencyRoot = pluginDependencyRoot();
+    return {
+        pluginRoot,
+        ...(dependencyRoot !== undefined && { dependencyRoot }),
+        stdout: process.stdout,
+        stderr: process.stderr,
+        now: () => performance.now(),
+    };
+}
+//# sourceMappingURL=create.js.map

package/cli/dist/commands/slidev-project/linked-theme.d.ts

@@ -0,0 +1,70 @@
+import type { ThemeFiles } from '../../domain/slidev-theme/ports.js';
+import type { LinkedTheme } from '../../domain/slidev-project/sync.js';
+import { isNodeModulesLinkCurrent, linkNodeModules, syncGeneratedFiles } from '../../infra/slidev-project/fs.js';
+import { fetchTheme } from '../../infra/slidev-theme/store.js';
+/**
+テーマの取得に渡す、呼び出しごとの文脈。キャンセルと警告の出力先。
+*/
+export interface ThemeLinkContext {
+    readonly signal?: AbortSignal | undefined;
+    readonly warn?: ((message: string) => void) | undefined;
+}
+export interface LinkedThemeDependencies {
+    readonly files: ThemeFiles;
+    /**
+    node_modules の項目の元になる依存ルート。
+    */
+    readonly dependencyRoot: string;
+    /**
+    テーマの置き場。決められないときは undefined。
+    */
+    readonly storeRoot: () => string | undefined;
+    readonly fetchTheme: typeof fetchTheme;
+    readonly isLinkCurrent: typeof isNodeModulesLinkCurrent;
+    readonly linkNodeModules: typeof linkNodeModules;
+    /**
+    本体の生成ファイルを今の内容にそろえる。書いたファイル名を返す。
+    */
+    readonly syncGeneratedFiles: typeof syncGeneratedFiles;
+    /**
+    取得中の警告の出力先。
+    */
+    readonly warn?: (message: string) => void;
+    readonly signal?: AbortSignal;
+}
+export interface EnsureThemeLinkedResult {
+    /**
+    今回 node_modules を張り直したか。
+    */
+    readonly relinked: boolean;
+    /**
+    今回、本体の生成ファイルを書き直したか。
+    */
+    readonly regenerated: boolean;
+    /**
+    張る対象のテーマ。`theme:` が none か未指定（テーマを参照しない talk-dir）は undefined。
+    */
+    readonly theme: LinkedTheme | undefined;
+    /**
+    張り直したときの、依存ルートの node_modules。張り直さなければ undefined。
+    */
+    readonly nodeModulesTarget: string | undefined;
+}
+export interface EnsureThemeLinkedOptions {
+    /**
+    テーマを参照しない talk-dir を、`theme-none` で止めるか。
+    dev・convert は止める（移行前の形は描画しない）。`sync --node-modules-only` は止めず、テーマ無しで張り直す。
+    */
+    readonly requireTheme?: boolean;
+}
+/**
+talk-dir のテーマが node_modules に今の値で張られていることを保証する。
+*/
+export declare function ensureTalkThemeLinked(talkDirectory: string, dependencies: Readonly<LinkedThemeDependencies>, options?: Readonly<EnsureThemeLinkedOptions>): Promise<EnsureThemeLinkedResult>;
+/**
+実ファイル・実 git・実 pnpm で動く既定の依存。
+@param dependencyRoot node_modules の項目の元になる依存ルート
+@param context 取得中の警告の出力先と、キャンセルの signal
+*/
+export declare function linkedThemeDefaultDependencies(dependencyRoot: string, context?: Readonly<ThemeLinkContext>): LinkedThemeDependencies;
+//# sourceMappingURL=linked-theme.d.ts.map

package/cli/dist/commands/slidev-project/linked-theme.js

@@ -0,0 +1,124 @@
+// talk-dir の node_modules にテーマが今の値で張られているかを確かめ、違えば張り直す。
+// あわせて、本体の生成ファイル（`vite.config.ts`・`start.mjs`）を本体の今の内容にそろえる。
+// dev・convert・`sync --node-modules-only` と、移行済みの talk-dir の通常の `sync` が呼ぶ。
+//
+// 順は次のとおり。
+// `package.json` の spec を読み、`fetchTheme` を通してから、生成ファイルをそろえる。
+// そのあと印と比べ、違えば `linkNodeModules` を呼ぶ。
+// 生成ファイルは、張り直しが要らない普段の起動でも、今の内容と違えば書き直す。
+// 書かないのは、テーマを参照しない talk-dir、pecotv が取得しない指定（registry の版など）。
+// 取得済みの置き場は stamp を比べるだけで、ネットワークには出ない。
+// 比べるのは、印の依存ルート（実行用ミラーの世代）と、テーマの directory。
+// 実行用ミラーの世代交代や、テーマの置き場の変更に、手で sync を打たなくても追従できる。
+//
+// 取得や宣言の失敗はそのまま投げる。古い node_modules で描画を続けない。
+// 原因ごとの文言は、取得側の例外が持つ。reason は `themeErrorReason` で `theme-<reason>` にする。
+import { SlideCreateRuntimeError } from '../../domain/slidev-project/errors.js';
+import { ThemeFetchError } from '../../domain/slidev-theme/store-layout.js';
+import { ThemeResolveError, findTalkThemeDependency, resolveTalkTheme, themeNoneError } from '../../domain/slidev-theme/talk-theme.js';
+import { ThemeSpecError, parseThemeSpec } from '../../domain/slidev-theme/theme-spec.js';
+import { themeStoreRoot } from '../../infra/_shared/dependency-root.js';
+import { isNodeModulesLinkCurrent, linkNodeModules, syncGeneratedFiles } from '../../infra/slidev-project/fs.js';
+import { NodeThemeFiles } from '../../infra/slidev-theme/fs.js';
+import { fetchTheme } from '../../infra/slidev-theme/store.js';
+/**
+pecotv が取得する指定 (git / file:) ならその ThemeSpec を返す。解釈できない形 (unsupported-spec) は undefined。
+タグ無しなど、取得の指定として誤っているものは ThemeSpecError のまま投げる。
+*/
+function parseSpecIfManaged(text) {
+    try {
+        return parseThemeSpec(text);
+    }
+    catch (error) {
+        if (error instanceof ThemeSpecError && error.reason === 'unsupported-spec')
+            return undefined;
+        throw error;
+    }
+}
+/**
+取得せず、張り直さないテーマ。解決できれば、その root を返す (上位の node_modules に置かれたテーマを含む)。
+解決できないときは、`requireTheme` なら `theme-unlinked` で止め、そうでなければ theme を持たない。
+*/
+async function unmanagedTheme(talkDirectory, files, options) {
+    try {
+        const resolved = await resolveTalkTheme(files, talkDirectory);
+        return { relinked: false, regenerated: false, theme: { name: resolved.name, spec: resolved.spec, directory: resolved.directory }, nodeModulesTarget: undefined };
+    }
+    catch (error) {
+        // ここへ来た時点で theme: は依存を指しているので、起こりうるのは theme-unlinked だけ。
+        // dev・convert はそのまま Slidev を起こすと一般の起動失敗になり、案内が出ない。案内つきで止める。
+        // sync の --node-modules-only は止めず、テーマ無しで張り直す。
+        if (error instanceof ThemeResolveError && options.requireTheme !== true) {
+            return { relinked: false, regenerated: false, theme: undefined, nodeModulesTarget: undefined };
+        }
+        throw error;
+    }
+}
+/**
+talk-dir のテーマが node_modules に今の値で張られていることを保証する。
+*/
+export async function ensureTalkThemeLinked(talkDirectory, 
+// port に AbortSignal と関数を持つため readonly にできない。
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+dependencies, options = {}) {
+    const reference = await findTalkThemeDependency(dependencies.files, talkDirectory);
+    if (reference === undefined) {
+        if (options.requireTheme !== true)
+            return { relinked: false, regenerated: false, theme: undefined, nodeModulesTarget: undefined };
+        // テーマを参照しない talk-dir は theme-none で止める。
+        throw await themeNoneError(dependencies.files, talkDirectory);
+    }
+    // git でも file: でもない指定 (registry の版など) は、pecotv が作った talk-dir ではない。
+    // 依存の管理は利用者に任せ、取得せず、張り直さない。宣言が無ければ既定値で進む。
+    const spec = parseSpecIfManaged(reference.spec);
+    if (spec === undefined)
+        return await unmanagedTheme(talkDirectory, dependencies.files, options);
+    const storeRoot = dependencies.storeRoot();
+    if (storeRoot === undefined) {
+        throw new ThemeFetchError('テーマの置き場を決められません。データ置き場（CLAUDE_PLUGIN_DATA）を確認してください', 'unknown');
+    }
+    const fetched = await dependencies.fetchTheme(spec, {
+        storeRoot,
+        baseDirectory: talkDirectory,
+        dependencyRoot: dependencies.dependencyRoot,
+        warn: dependencies.warn,
+        signal: dependencies.signal,
+    });
+    if (fetched.name !== reference.name) {
+        throw new SlideCreateRuntimeError(`package.json の dependencies には ${reference.name} と書かれていますが、取得したテーマの name は ${fetched.name} です。`
+            + 'dependencies のキーをテーマの name に合わせてください', 'theme-name-mismatch');
+    }
+    // 張り直しが要らない普段の起動でも、生成ファイルは本体の今の内容にそろえる。
+    const regeneratedFiles = await dependencies.syncGeneratedFiles(talkDirectory, { themeName: fetched.name });
+    const isRegenerated = regeneratedFiles.length > 0;
+    if (isRegenerated) {
+        dependencies.warn?.(`本体の今の内容に合わせて ${regeneratedFiles.join('・')} を書き直しました。`
+            + '本体が生成するファイルなので、手での編集は残りません。Vite の追加設定は setup/vite-plugins.ts に置いてください');
+    }
+    const link = { name: fetched.name, directory: fetched.directory };
+    const theme = { ...link, spec: reference.spec };
+    if (await dependencies.isLinkCurrent(talkDirectory, dependencies.dependencyRoot, [link])) {
+        return { relinked: false, regenerated: isRegenerated, theme, nodeModulesTarget: undefined };
+    }
+    const linked = await dependencies.linkNodeModules(talkDirectory, dependencies.dependencyRoot, [link]);
+    return { relinked: true, regenerated: isRegenerated, theme, nodeModulesTarget: linked.nodeModulesTarget };
+}
+/**
+実ファイル・実 git・実 pnpm で動く既定の依存。
+@param dependencyRoot node_modules の項目の元になる依存ルート
+@param context 取得中の警告の出力先と、キャンセルの signal
+*/
+export function linkedThemeDefaultDependencies(dependencyRoot, context = {}) {
+    return {
+        files: new NodeThemeFiles(),
+        dependencyRoot,
+        storeRoot: themeStoreRoot,
+        fetchTheme,
+        isLinkCurrent: isNodeModulesLinkCurrent,
+        linkNodeModules,
+        syncGeneratedFiles,
+        ...(context.warn !== undefined && { warn: context.warn }),
+        ...(context.signal !== undefined && { signal: context.signal }),
+    };
+}
+//# sourceMappingURL=linked-theme.js.map

package/cli/dist/commands/slidev-project/lint.d.ts

@@ -0,0 +1,88 @@
+import { Command } from 'commander';
+import type { EslintRunner, SlideLintSummary } from '../../domain/slidev-project/lint.js';
+export interface SlideLintOptions {
+    readonly dir: string;
+}
+export interface SlideLintDependencies {
+    /**
+    同梱アセットの起点。CLAUDE_PLUGIN_ROOT。
+    */
+    readonly pluginRoot: string;
+    /**
+    lint 用の設定（deck-lint.env.config.js）・eslint 本体・ルールの dist を取る実行用ミラー。
+    PECOTV_RUNTIME_DIR（実行中の cli と同じ版のミラー）。省略時は pluginRoot（開発・テスト）。
+    `runtime/current` は別セッションが切り替えた新版を指すので使わない。
+    */
+    readonly runtimeDirectory?: string;
+    readonly stdout: NodeJS.WritableStream;
+    readonly stderr: NodeJS.WritableStream;
+    /**
+    eslint 起動の port。省略時は assets/slidev の eslint の子プロセス起動を使う。
+    子プロセスを起こさずに lint 結果の分岐を観測したいテストがここを差し替える。
+    */
+    readonly eslint?: EslintRunner;
+}
+export type SlideLintResultSummary = SlideLintSummary;
+/**
+commander コマンドファクトリ。コマンド名は `lint`、`slide` グループ配下に登録する想定。
+
+受け付ける options:
+- `--dir <path>` (必須): talk-dir 絶対パス
+- `--json`: machine-readable な JSON を stdout に出す
+
+exit code: 違反あり = 1 / 実行失敗 = 1 / usage error = 2（commander 専用）。
+eslint 自身の exit 2（設定エラー）は domain で `SlideLintRuntimeError` に変換済みで、
+ここで 2 に化けることはない。
+*/
+export declare function createSlideLintCommand(buildDependencies: () => SlideLintDependencies): Command;
+export interface SlideLintExecution {
+    readonly summary: SlideLintResultSummary;
+    /**
+    `--json` の payload。MCP ツールの構造化データもこれをそのまま返す。
+    event 名は outcome で変わる（違反ありは `slide.lint.violations`）。
+    */
+    readonly data: Readonly<Record<string, unknown>>;
+}
+/**
+`slide lint` の実処理と機械可読な結果組み立て。CLI action と MCP ツールの双方がここを通る。
+*/
+export declare function executeSlideLint(options: Readonly<SlideLintOptions>, dependencies: SlideLintDependencies): Promise<SlideLintExecution>;
+export interface AutoDeckLintReport {
+    /**
+    lint が実行できた場合の集計。実行自体に失敗した場合は undefined。
+    */
+    readonly summary: SlideLintSummary | undefined;
+    /**
+    lint 実行に失敗した場合の理由（テーマの未解決、eslint 未 install 等）。
+    */
+    readonly failure: string | undefined;
+}
+/**
+`slide create` / `slide sync` 末尾で実行するデッキ全体 lint。
+
+違反と実行失敗は、呼び出し元の exit code に影響させない。
+そのため例外は投げず、`AutoDeckLintReport` に畳んで返す。
+*/
+export declare function runAutoDeckLint(talkDirectory: string, dependencies: SlideLintDependencies): Promise<AutoDeckLintReport>;
+/**
+`runAutoDeckLint` の結果を人間向けに書き出す。違反は一覧表示のみで、呼び出し元の
+成否には影響しない旨と再確認コマンドを添える。
+*/
+export declare function writeAutoDeckLintReport(report: Readonly<AutoDeckLintReport>, talkDirectory: string, dependencies: SlideLintDependencies): void;
+/**
+`--json` 出力の `slide.create.done` / `slide.sync.done` に載せる lint 要約フィールド。
+*/
+export declare function autoDeckLintJsonField(report: Readonly<AutoDeckLintReport>): Readonly<Record<string, unknown>>;
+export declare function errorToReason(error: unknown): string;
+export declare function isUsageError(error: unknown): boolean;
+/**
+失敗時の exit code。usage error = 2、それ以外の実行失敗 = 1（違反ありの 1 は成功ルート）。
+*/
+export declare function toExitCode(error: unknown): number;
+export declare function slideLintDefaultDependencies(): SlideLintDependencies;
+/**
+テスト用の薄いファサード。commander を介さず domain `runSlideLint` を
+production と同じ infra 組み立てで呼ぶための shortcut。
+*/
+export declare function runSlideLintFromCli(directory: string, dependencies: SlideLintDependencies): Promise<SlideLintResultSummary>;
+//# sourceMappingURL=lint.d.ts.map