@pecot/visual-mcp 0.0.0-stage → 1.1.0

package/cli/dist/domain/slidev-project/lint.js

@@ -0,0 +1,160 @@
+// `pecotv slide lint` の domain ロジック。talk-dir 全体 (`pages/**/*.md` + `slides.md`) を
+// 本体の assets/slidev の eslint で lint し、結果を集計する。
+//
+// PostToolUse hook (`hooks/lib/post-tool-use/eslint-check.sh`) は、編集された 1 ファイルしか見ない。
+// そのため、既存 talk-dir に蓄積した違反は検出できない。
+// 本 domain は、その抜けを埋めるデッキ全体 lint を担う。
+//
+// 役割は次の 3 つ。
+// - `assertTalkDirectory`: 絶対パスチェック + dir 存在 + slides.md 存在を、usage / runtime error に振り分ける。
+//   振り分け方針は domain/slidev-project/sync.ts と同じ。
+// - `EslintRunner` port が返す SpawnResult を、「違反」と「実行失敗」に分岐する。
+// - eslint の `--format json` 出力を `SlideLintSummary` へ整形する。
+import path from 'node:path';
+export class SlideLintUsageError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'SlideLintUsageError';
+    }
+}
+export class SlideLintRuntimeError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'SlideLintRuntimeError';
+    }
+}
+/**
+talk-dir マーカー検証。振り分けは domain/slidev-project/sync.ts の
+`assertTalkDirectory` と同一方針（例外型のみ Lint 系）。
+- 絶対パスでない: `relative-dir` (usage error / exit 2)。
+- 存在しない: `dir-not-found` (runtime error / exit 1)。
+- ディレクトリでない: `not-a-directory` (runtime error / exit 1)。
+- `slides.md` を含まない: `not-talk-dir` (runtime error / exit 1)。
+*/
+export async function assertTalkDirectory(directory, fs) {
+    if (!path.isAbsolute(directory)) {
+        throw new SlideLintUsageError(`--dir には絶対パスを指定してください (受け取った値: '${directory}')`, 'relative-dir');
+    }
+    const info = await fs.talkDirectoryExists(directory);
+    if (!info.exists) {
+        throw new SlideLintRuntimeError(`'${directory}' はディレクトリとして存在しません`, 'dir-not-found');
+    }
+    if (!info.isDirectory) {
+        throw new SlideLintRuntimeError(`'${directory}' はディレクトリではありません`, 'not-a-directory');
+    }
+    const hasSlidesMd = await fs.doesSlidesMdExist(directory);
+    if (!hasSlidesMd) {
+        throw new SlideLintRuntimeError(`'${directory}' に slides.md が無いため talk-dir として扱えません。`
+            + ' pecotv slide create で作成された talk-dir を指定してください。', 'not-talk-dir');
+    }
+}
+/**
+talk-dir 全体を lint し、集計結果を返す。
+
+eslint の exit code は 0=違反なし / 1=違反あり / 2=設定エラー・内部エラー。
+2 は CLI の usage error (exit 2) と衝突させないため `SlideLintRuntimeError` に変換する。
+起動失敗 (`exitCode: null`) と timeout (`timedOut: true`) は SpawnResult の契約上
+reject されないので、ここで明示的に分岐する。
+*/
+export async function runSlideLint(options, dependencies) {
+    await assertTalkDirectory(options.directory, dependencies.fs);
+    const lint = await dependencies.readLint(options.directory);
+    const result = await dependencies.eslint.run({
+        talkDirectory: options.directory,
+        assetsDirectory: dependencies.assetsDirectory,
+        deckLintConfig: dependencies.deckLintConfig,
+        lint,
+    });
+    // timedOut 時も SIGTERM で exitCode は null になるため、起動失敗より先に判定する。
+    if (result.timedOut) {
+        throw new SlideLintRuntimeError(`eslint が時間内に終了しませんでした: ${summarizeStderr(result.stderr)}`, 'eslint-timeout');
+    }
+    if (result.exitCode === null) {
+        throw new SlideLintRuntimeError(`eslint の起動に失敗しました: ${summarizeStderr(result.stderr)}`, 'eslint-not-launched');
+    }
+    if (result.exitCode !== 0 && result.exitCode !== 1) {
+        throw new SlideLintRuntimeError(`eslint が異常終了しました (exit ${String(result.exitCode)}): ${summarizeStderr(result.stderr)}`, 'eslint-failed');
+    }
+    // eslint が辿れなかった symlink dir の検出は lint 結果と独立。走査失敗以外で
+    // outcome / exit code を動かさないため、集計の外側で合流させる。
+    const skippedSymlinkDirectories = await dependencies.fs.listSkippedSymlinkPageDirectories(options.directory);
+    return summarizeReport(options.directory, parseEslintReport(result.stdout), skippedSymlinkDirectories);
+}
+function parseEslintReport(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch (error) {
+        throw new SlideLintRuntimeError(`eslint の JSON 出力を解析できませんでした: ${formatError(error)}`, 'invalid-report');
+    }
+    if (!Array.isArray(parsed)) {
+        throw new SlideLintRuntimeError('eslint の JSON 出力が配列ではありません', 'invalid-report');
+    }
+    // eslint-disable-next-line no-restricted-syntax -- JSON.parse 戻り値の narrowing
+    return parsed;
+}
+function summarizeReport(directory, report, skippedSymlinkDirectories) {
+    const violations = [];
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const file of report) {
+        errorCount += file.errorCount ?? 0;
+        warningCount += file.warningCount ?? 0;
+        const relative = toRelativePath(directory, file.filePath ?? '');
+        const messages = file.messages ?? [];
+        for (const message of messages) {
+            violations.push({
+                file: relative,
+                line: message.line ?? 0,
+                column: message.column ?? 0,
+                rule: message.ruleId ?? '(unknown rule)',
+                message: message.message ?? '',
+            });
+        }
+    }
+    return {
+        directory,
+        lintedFileCount: report.length,
+        errorCount,
+        warningCount,
+        violations,
+        outcome: resolveOutcome(report.length, violations.length),
+        skippedSymlinkDirectories,
+    };
+}
+function resolveOutcome(lintedFileCount, violationCount) {
+    if (lintedFileCount === 0)
+        return 'no-target';
+    return violationCount > 0 ? 'violations' : 'clean';
+}
+/**
+eslint が返す `filePath` は realpath 解決済みのため、bind mount / symlink 経由では
+talk-dir の論理パスからの相対化が `../` に化ける。talk-dir 外を指す結果になった場合は
+絶対パスのまま返し、誤解を招く相対パスを出さない。
+*/
+export function toRelativePath(directory, filePath) {
+    if (filePath === '')
+        return '';
+    const relative = path.relative(directory, filePath);
+    return relative === '' || relative.startsWith('..') || path.isAbsolute(relative) ? filePath : relative;
+}
+const STDERR_EXCERPT_LIMIT = 400;
+function summarizeStderr(stderr) {
+    const trimmed = stderr.trim();
+    if (trimmed === '')
+        return '(stderr なし)';
+    if (trimmed.length <= STDERR_EXCERPT_LIMIT)
+        return trimmed;
+    return `${trimmed.slice(0, STDERR_EXCERPT_LIMIT)}...`;
+}
+/* c8 ignore start -- 非 Error 例外 (string throw 等) は本実装範囲では未発生、防御網のみ */
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/* c8 ignore stop */
+//# sourceMappingURL=lint.js.map

package/cli/dist/domain/slidev-project/package-json.d.ts

@@ -0,0 +1,20 @@
+export interface TalkPackageJsonInput {
+    /**
+    talk-dir の名前。
+    */
+    readonly name: string;
+    /**
+    テーマのパッケージ名。`dependencies` のキーになる。
+    */
+    readonly themeName: string;
+    /**
+    テーマの取得元。`dependencies` の値になる（git URL とタグ、または `file:` のパス）。
+    */
+    readonly themeSpec: string;
+}
+/**
+slide create が生成する package.json の全文を返す。
+依存はテーマ 1 つだけで、そのほかの依存は実行用ミラーの node_modules から張る。
+*/
+export declare function talkPackageJsonSource(input: Readonly<TalkPackageJsonInput>): string;
+//# sourceMappingURL=package-json.d.ts.map

package/cli/dist/domain/slidev-project/package-json.js

@@ -0,0 +1,17 @@
+// talk-dir の package.json を生成する。
+// テーマを 1 つ参照する package.json を作る（slide create と、slide sync のテーマへの移行）。
+/**
+slide create が生成する package.json の全文を返す。
+依存はテーマ 1 つだけで、そのほかの依存は実行用ミラーの node_modules から張る。
+*/
+export function talkPackageJsonSource(input) {
+    const data = {
+        name: input.name,
+        version: '0.0.0',
+        private: true,
+        type: 'module',
+        dependencies: { [input.themeName]: input.themeSpec },
+    };
+    return `${JSON.stringify(data, undefined, 2)}\n`;
+}
+//# sourceMappingURL=package-json.js.map

package/cli/dist/domain/slidev-project/slides-md.d.ts

@@ -0,0 +1,22 @@
+export interface SlidesMdInput {
+    readonly title: string;
+    /**
+    frontmatter の `theme:` に書く値。テーマのパッケージ名。
+    */
+    readonly theme: string;
+    /**
+    `pages/<name>.md` の name を、スライドの順に並べる。
+    */
+    readonly pages: readonly string[];
+}
+/**
+slides.md の全文を返す。
+先頭ページは frontmatter の `src:`、2 ページ目以降は `---\nsrc: ...\n---` の列にする。
+*/
+export declare function slidesMdSource(input: Readonly<SlidesMdInput>): string;
+/**
+既存の slides.md の frontmatter の `theme:` の値だけを書き換える。
+行が無ければ frontmatter の先頭に足し、frontmatter が無ければ作る。改行は元の slides.md に合わせる。
+*/
+export declare function setSlidesTheme(source: string, theme: string): string;
+//# sourceMappingURL=slides-md.d.ts.map

package/cli/dist/domain/slidev-project/slides-md.js

@@ -0,0 +1,58 @@
+// slides.md を生成する。
+// theme・title と、pages/ のページを並べる `src:` の列だけを書く。
+// テンプレートの headmatter（canvasWidth など）は書かない。テーマが既定にしたい値は、テーマ側で持つ。
+// 英数字・空白・ハイフン・ドット・日本語の文字だけで、先頭が記号でない値は、そのまま YAML のスカラーになる。
+const PLAIN_SCALAR = /^[\p{L}\p{N}][\p{L}\p{N} _.-]*$/u;
+// YAML が数値・真偽値・null・日付と読む値。無引用で書くと文字列にならない。
+const NON_STRING_SCALARS = [
+    /^[-+]?[\d._]+$/u,
+    /^[-+]?[\d._]+e[-+]?\d+$/iu,
+    /^0x[\da-f]+$/iu,
+    /^0o[0-7]+$/iu,
+    /^\d{4}-\d{2}-\d{2}/u,
+    /^(?:true|false|null|yes|no|on|off|y|n)$/iu,
+    /^~$/u,
+];
+function yamlScalar(value) {
+    const isPlain = PLAIN_SCALAR.test(value) && NON_STRING_SCALARS.every(pattern => !pattern.test(value));
+    return isPlain ? value : JSON.stringify(value);
+}
+/**
+slides.md の全文を返す。
+先頭ページは frontmatter の `src:`、2 ページ目以降は `---\nsrc: ...\n---` の列にする。
+*/
+export function slidesMdSource(input) {
+    const [first, ...rest] = input.pages;
+    const frontmatter = [
+        '---',
+        `theme: ${yamlScalar(input.theme)}`,
+        `title: ${yamlScalar(input.title)}`,
+        ...(first === undefined ? [] : [`src: ./pages/${first}.md`]),
+        '---',
+        '<!-- markdownlint-disable -->',
+    ].join('\n');
+    const body = rest.map(name => `\n---\nsrc: ./pages/${name}.md\n---`).join('\n');
+    return `${frontmatter}\n${body === '' ? '' : `${body}\n`}`;
+}
+/**
+既存の slides.md の frontmatter の `theme:` の値だけを書き換える。
+行が無ければ frontmatter の先頭に足し、frontmatter が無ければ作る。改行は元の slides.md に合わせる。
+*/
+export function setSlidesTheme(source, theme) {
+    const eol = source.includes('\r\n') ? '\r\n' : '\n';
+    const themeLine = `theme: ${yamlScalar(theme)}`;
+    // 各行は、CRLF のとき末尾に `\r` を残したまま扱う。
+    const lines = source.split('\n');
+    const opening = lines.at(0) ?? '';
+    const closing = lines.findIndex((line, index) => index > 0 && line.trimEnd() === '---');
+    const hasFrontmatter = closing !== -1 && opening.trimEnd() === '---';
+    if (!hasFrontmatter)
+        return `---${eol}${themeLine}${eol}---${eol}${source}`;
+    const themeIndex = lines.findIndex((line, index) => index > 0 && index < closing && /^theme[ \t]*:/u.test(line));
+    const entry = `${themeLine}${opening.endsWith('\r') ? '\r' : ''}`;
+    const updated = themeIndex === -1
+        ? [opening, entry, ...lines.slice(1)]
+        : lines.map((line, index) => (index === themeIndex ? entry : line));
+    return updated.join('\n');
+}
+//# sourceMappingURL=slides-md.js.map

package/cli/dist/domain/slidev-project/sync.d.ts

@@ -0,0 +1,148 @@
+import { type TalkThemeKind } from '../slidev-theme/talk-theme.js';
+import type { ViteConfigOptions } from './generated-files.js';
+export type SlideSyncUsageReason = 'missing-option' | 'relative-dir' | 'theme-required' | 'theme-root' | 'theme-with-node-modules-only';
+export type SlideSyncRuntimeReason = 'dir-not-found' | 'not-a-directory' | 'not-talk-dir' | 'migrate-failed' | 'symlink-failed' | 'unknown';
+export declare class SlideSyncUsageError extends Error {
+    readonly reason: SlideSyncUsageReason;
+    constructor(message: string, reason: SlideSyncUsageReason);
+}
+export declare class SlideSyncRuntimeError extends Error {
+    readonly reason: SlideSyncRuntimeReason;
+    constructor(message: string, reason: SlideSyncRuntimeReason);
+}
+/**
+node_modules に張るテーマ。`name` の項目を `directory` へ張る。
+*/
+export interface NodeModulesThemeLink {
+    readonly name: string;
+    readonly directory: string;
+}
+/**
+取得して張ったテーマ。`spec` は package.json の指定。
+*/
+export interface LinkedTheme extends NodeModulesThemeLink {
+    readonly spec: string;
+}
+export interface NodeModulesLinkSummary {
+    readonly nodeModulesTarget: string;
+    readonly entries: number;
+}
+export interface SlideSyncFsAdapter {
+    readonly talkDirectoryExists: (directory: string) => Promise<{
+        readonly exists: boolean;
+        readonly isDirectory: boolean;
+    }>;
+    readonly doesSlidesMdExist: (directory: string) => Promise<boolean>;
+    readonly readSlidesMd: (talkDirectory: string) => Promise<string>;
+    readonly writeSlidesMd: (talkDirectory: string, content: string) => Promise<void>;
+    /**
+    テンプレート由来の名前を消し、消した名前（talk-dir からの相対パス）を返す。
+    */
+    readonly removeTemplateEntries: (talkDirectory: string) => Promise<readonly string[]>;
+    readonly writePackageJson: (talkDirectory: string, content: string) => Promise<void>;
+    readonly syncGeneratedFiles: (talkDirectory: string, options: Readonly<ViteConfigOptions>) => Promise<readonly string[]>;
+    readonly linkNodeModules: (talkDirectory: string, dependencyRoot: string, themes: readonly NodeModulesThemeLink[]) => Promise<NodeModulesLinkSummary>;
+}
+export interface SlideSyncDomainOptions {
+    readonly directory: string;
+    readonly nodeModulesOnly: boolean;
+    /**
+    移行先のテーマの指定（git の指定か `file:`）。移行前の talk-dir にだけ使う。
+    */
+    readonly theme?: string | undefined;
+}
+/**
+sync が行った処理。`migrate` は移行前の talk-dir をテーマを参照する形へ移したこと、
+`relink` はテーマの取得と node_modules の張り直しだけ。
+*/
+export type SlideSyncMode = 'migrate' | 'relink';
+export interface SlideSyncSummary {
+    readonly directory: string;
+    readonly nodeModulesTarget: string;
+    readonly nodeModulesOnly: boolean;
+    readonly mode: SlideSyncMode;
+    /**
+    張ったテーマ。`spec` は package.json に書いた指定。テーマを参照しない talk-dir の張り直しでは undefined。
+    */
+    readonly theme: LinkedTheme | undefined;
+    /**
+    移行で消した名前（talk-dir からの相対パス）。移行以外は空。
+    */
+    readonly removed: readonly string[];
+    /**
+    利用者に伝える警告。テーマの宣言の警告と、使わなかった `--theme`。
+    */
+    readonly warnings: readonly string[];
+}
+/**
+talk-dir マーカー検証。
+- 絶対パスでない: `relative-dir` (usage error / exit 2)。
+- 存在しない: `dir-not-found` (runtime error / exit 1)。
+- ディレクトリでない: `not-a-directory` (runtime error / exit 1)。
+- `slides.md` を含まない: `not-talk-dir` (runtime error / exit 1)。
+  誤って ~/Documents に sync を撒かないための marker check。
+*/
+export declare function assertTalkDirectory(directory: string, fs: Readonly<Pick<SlideSyncFsAdapter, 'talkDirectoryExists' | 'doesSlidesMdExist'>>): Promise<void>;
+/**
+張り直しだけを行う sync（`--node-modules-only` と移行済みの talk-dir）が、テーマの取得と張り直しを任せる港。
+`theme` は張る対象のテーマで、テーマを参照しない talk-dir（`theme: none`）は undefined。
+`relinked` が true なら、すでに張り直しを終えている（`nodeModulesTarget` を持つ）。
+`regenerated` が true なら、本体の生成ファイル（`vite.config.ts`・`start.mjs`）を書き直している。
+*/
+export type EnsureThemeLinkedPort = (talkDirectory: string) => Promise<{
+    readonly relinked: boolean;
+    readonly regenerated: boolean;
+    readonly theme: LinkedTheme | undefined;
+    readonly nodeModulesTarget: string | undefined;
+}>;
+/**
+取得して宣言を確かめた、移行先のテーマ。
+*/
+export interface PreparedTheme {
+    readonly name: string;
+    /**
+    テーマ root の絶対パス。
+    */
+    readonly directory: string;
+    /**
+    talk-dir の package.json の `dependencies` に書く指定。
+    */
+    readonly spec: string;
+    /**
+    宣言を読んだときの警告。
+    */
+    readonly warnings: readonly string[];
+}
+/**
+`--theme` の指定を解釈し、依存ルートを確かめ、テーマを取得し、宣言を読む。何も書き換えない。
+*/
+export type PrepareThemePort = (themeSpec: string, talkDirectory: string) => Promise<PreparedTheme>;
+export interface SlideSyncDependencies {
+    readonly dependencyRoot: string;
+    readonly fs: SlideSyncFsAdapter;
+    readonly ensureThemeLinked: EnsureThemeLinkedPort;
+    /**
+    talk-dir を移行済み・テーマの dir・移行前に分ける。
+    判定の失敗（package.json が読めないなど）は、何も書き換えずそのまま呼び出し元へ返す。
+    */
+    readonly classifyTalk: (talkDirectory: string) => Promise<TalkThemeKind>;
+    readonly prepareTheme: PrepareThemePort;
+}
+/**
+sync の工程。talk-dir を 3 通りに分けて進める。
+
+- `--node-modules-only`: 分けずに、テーマの取得と node_modules の張り直しだけを行う。
+  移行前の talk-dir は、テーマ無しで張り直す。`--theme` との同時指定は usage error。
+- 移行済み: 張り直しだけを行う。依存の版を書き換えてから打てば、その版のテーマで張り直す。
+  `--theme` を付けても使わず、警告に出す。
+- テーマの dir（`pecot-theme.json` を持つ）: 何も書き換えず usage error で止める。
+  移行前に入れると、layouts・components を消しうるため。
+- 移行前: `--theme` が必須（無ければ usage error）。次の順で移す。
+  1. `prepareTheme` が指定の解釈・依存ルートの確認・取得・宣言の読み取りを済ませる。
+  2. slides.md と package.json の新しい中身を組み立てる。
+  3. ここまでで失敗したら何も消さない。
+  4. テンプレート由来の名前を消し、slides.md の `theme:`・package.json・生成ファイルを書く。
+  5. テーマ付きで node_modules を張る。
+*/
+export declare function runSlideSync(options: Readonly<SlideSyncDomainOptions>, dependencies: Readonly<SlideSyncDependencies>): Promise<SlideSyncSummary>;
+//# sourceMappingURL=sync.d.ts.map

package/cli/dist/domain/slidev-project/sync.js

@@ -0,0 +1,193 @@
+// `pecotv slide sync` の domain ロジック。
+//
+// 役割は次の 2 つ。
+// - `assertTalkDirectory`: 絶対パスチェック + dir 存在 + slides.md 存在を、usage / runtime error に振り分ける。
+//   infra fs helper を呼ぶが、infra → domain の逆依存は作らない。
+// - `runSlideSync`: talk-dir を 3 通りに分けて、sync の工程をオーケストレーションする。
+//   移行前（テンプレートのコピーを持つ形）に `--theme` を付けると、テーマを参照する形へ移す。
+//   移行済みと `--node-modules-only` は、テーマの取得と node_modules の張り直しだけを行う。
+//   `pecot-theme.json` を持つテーマの dir は、移行前に入れず usage error で止める。
+import path from 'node:path';
+import { isThemeError } from '../slidev-theme/error-reason.js';
+import { themeRootMessage } from '../slidev-theme/talk-theme.js';
+import { SlideCreateRuntimeError } from './errors.js';
+import { talkPackageJsonSource } from './package-json.js';
+import { setSlidesTheme } from './slides-md.js';
+export class SlideSyncUsageError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'SlideSyncUsageError';
+    }
+}
+export class SlideSyncRuntimeError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'SlideSyncRuntimeError';
+    }
+}
+/**
+talk-dir マーカー検証。
+- 絶対パスでない: `relative-dir` (usage error / exit 2)。
+- 存在しない: `dir-not-found` (runtime error / exit 1)。
+- ディレクトリでない: `not-a-directory` (runtime error / exit 1)。
+- `slides.md` を含まない: `not-talk-dir` (runtime error / exit 1)。
+  誤って ~/Documents に sync を撒かないための marker check。
+*/
+export async function assertTalkDirectory(directory, fs) {
+    if (!path.isAbsolute(directory)) {
+        throw new SlideSyncUsageError(`--dir には絶対パスを指定してください (受け取った値: '${directory}')`, 'relative-dir');
+    }
+    const info = await fs.talkDirectoryExists(directory);
+    if (!info.exists) {
+        throw new SlideSyncRuntimeError(`'${directory}' はディレクトリとして存在しません`, 'dir-not-found');
+    }
+    if (!info.isDirectory) {
+        throw new SlideSyncRuntimeError(`'${directory}' はディレクトリではありません`, 'not-a-directory');
+    }
+    const hasSlidesMd = await fs.doesSlidesMdExist(directory);
+    if (!hasSlidesMd) {
+        throw new SlideSyncRuntimeError(`'${directory}' に slides.md が無いため talk-dir として扱えません。`
+            + ' pecotv slide create で作成された talk-dir を指定してください。', 'not-talk-dir');
+    }
+}
+function themeRequiredMessage(directory) {
+    return `${directory} はテーマを参照していない移行前の talk-dir です。移行するテーマを指定してください: `
+        + `slide sync --dir ${directory} --theme <theme-spec>`
+        + `（MCP では slide_sync の dir: ${directory}, theme: <theme-spec>）`;
+}
+const IGNORED_THEME_WARNING = '--theme は使いませんでした。この talk-dir はすでにテーマを参照しています。'
+    + 'テーマや版を替えるときは、package.json の依存を書き換えてから sync してください';
+/**
+sync の工程。talk-dir を 3 通りに分けて進める。
+
+- `--node-modules-only`: 分けずに、テーマの取得と node_modules の張り直しだけを行う。
+  移行前の talk-dir は、テーマ無しで張り直す。`--theme` との同時指定は usage error。
+- 移行済み: 張り直しだけを行う。依存の版を書き換えてから打てば、その版のテーマで張り直す。
+  `--theme` を付けても使わず、警告に出す。
+- テーマの dir（`pecot-theme.json` を持つ）: 何も書き換えず usage error で止める。
+  移行前に入れると、layouts・components を消しうるため。
+- 移行前: `--theme` が必須（無ければ usage error）。次の順で移す。
+  1. `prepareTheme` が指定の解釈・依存ルートの確認・取得・宣言の読み取りを済ませる。
+  2. slides.md と package.json の新しい中身を組み立てる。
+  3. ここまでで失敗したら何も消さない。
+  4. テンプレート由来の名前を消し、slides.md の `theme:`・package.json・生成ファイルを書く。
+  5. テーマ付きで node_modules を張る。
+*/
+export async function runSlideSync(options, dependencies) {
+    await assertTalkDirectory(options.directory, dependencies.fs);
+    if (options.nodeModulesOnly) {
+        if (options.theme !== undefined) {
+            throw new SlideSyncUsageError('--node-modules-only と --theme は同時に指定できません。'
+                + 'node_modules の張り直しだけなら --node-modules-only を、移行なら --theme を指定してください', 'theme-with-node-modules-only');
+        }
+        return await relink(options, dependencies, []);
+    }
+    // 判定の失敗は握らない。握って進むと、利用者の依存の行が失われる。
+    const kind = await dependencies.classifyTalk(options.directory);
+    if (kind === 'migrated') {
+        return await relink(options, dependencies, options.theme === undefined ? [] : [IGNORED_THEME_WARNING]);
+    }
+    if (kind === 'theme-root') {
+        throw new SlideSyncUsageError(themeRootMessage(options.directory), 'theme-root');
+    }
+    if (options.theme === undefined) {
+        throw new SlideSyncUsageError(themeRequiredMessage(options.directory), 'theme-required');
+    }
+    return await migrate(options.directory, options.theme, dependencies);
+}
+/**
+テーマの取得と node_modules の張り直しだけを行う。他のファイルは変えない。
+*/
+async function relink(options, dependencies, warnings) {
+    let nodeModulesTarget;
+    let theme;
+    try {
+        // テーマの失敗（取得・宣言・指定）は、原因ごとの文言のまま呼び出し元へ返す。
+        const ensured = await dependencies.ensureThemeLinked(options.directory);
+        theme = ensured.theme;
+        if (ensured.relinked && ensured.nodeModulesTarget !== undefined) {
+            nodeModulesTarget = ensured.nodeModulesTarget;
+        }
+        else {
+            // 取得済みで印が今の値と同じだったとき、またはテーマ無し。張り直しを求められているので、張り直す。
+            const themes = theme === undefined ? [] : [{ name: theme.name, directory: theme.directory }];
+            const linked = await dependencies.fs.linkNodeModules(options.directory, dependencies.dependencyRoot, themes);
+            nodeModulesTarget = linked.nodeModulesTarget;
+        }
+    }
+    catch (error) {
+        throw wrapLinkError(error);
+    }
+    return {
+        directory: options.directory,
+        nodeModulesTarget,
+        nodeModulesOnly: options.nodeModulesOnly,
+        mode: 'relink',
+        theme,
+        removed: [],
+        warnings,
+    };
+}
+async function migrate(directory, themeSpec, dependencies) {
+    // 取得まで済ませる。ここで失敗しても、何も書き換えていない。
+    const prepared = await dependencies.prepareTheme(themeSpec, directory);
+    const packageJson = talkPackageJsonSource({
+        name: path.basename(path.resolve(directory)),
+        themeName: prepared.name,
+        themeSpec: prepared.spec,
+    });
+    let removed;
+    try {
+        const slidesMd = setSlidesTheme(await dependencies.fs.readSlidesMd(directory), prepared.name);
+        removed = await dependencies.fs.removeTemplateEntries(directory);
+        await dependencies.fs.writeSlidesMd(directory, slidesMd);
+        await dependencies.fs.writePackageJson(directory, packageJson);
+        await dependencies.fs.syncGeneratedFiles(directory, { themeName: prepared.name });
+    }
+    catch (error) {
+        if (error instanceof SlideSyncRuntimeError || error instanceof SlideSyncUsageError)
+            throw error;
+        throw new SlideSyncRuntimeError(`移行に失敗しました: ${formatError(error)}`, 'migrate-failed');
+    }
+    let nodeModulesTarget;
+    try {
+        const link = { name: prepared.name, directory: prepared.directory };
+        const linked = await dependencies.fs.linkNodeModules(directory, dependencies.dependencyRoot, [link]);
+        nodeModulesTarget = linked.nodeModulesTarget;
+    }
+    catch (error) {
+        throw wrapLinkError(error);
+    }
+    return {
+        directory,
+        nodeModulesTarget,
+        nodeModulesOnly: false,
+        mode: 'migrate',
+        theme: { name: prepared.name, directory: prepared.directory, spec: prepared.spec },
+        removed,
+        warnings: prepared.warnings,
+    };
+}
+/**
+張り直しの失敗を、原因を持つ例外はそのまま、それ以外は symlink-failed に包んで返す。
+*/
+function wrapLinkError(error) {
+    if (error instanceof SlideSyncRuntimeError || error instanceof SlideSyncUsageError)
+        return error;
+    if (isThemeError(error))
+        return error;
+    // theme-name-mismatch など、原因の文言を持つ例外は包み直さない。
+    if (error instanceof SlideCreateRuntimeError)
+        return error;
+    return new SlideSyncRuntimeError(`node_modules の張り直しに失敗しました: ${formatError(error)}`, 'symlink-failed');
+}
+/* c8 ignore start -- 非 Error 例外 (string throw 等) は本実装範囲では未発生、防御網のみ */
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/* c8 ignore stop */
+//# sourceMappingURL=sync.js.map

package/cli/dist/domain/slidev-project/warnings.d.ts

@@ -0,0 +1,3 @@
+export declare const LINK_COLOR_OMITTED_WARNING: string;
+export declare const EAST_ASIAN_FONT_OMITTED_WARNING: string;
+//# sourceMappingURL=warnings.d.ts.map

package/cli/dist/domain/slidev-project/warnings.js

@@ -0,0 +1,6 @@
+// 利用者に伝える警告の文言。create・convert が同じ文言を使う。
+export const LINK_COLOR_OMITTED_WARNING = 'pptx.linkColor を省いたため、PPTX ではリンクは変換されません（ハイパーリンクが付きません）。'
+    + 'リンクを変換するには pecot-theme.json の pptx.linkColor に 6 桁の 16 進で書いてください';
+export const EAST_ASIAN_FONT_OMITTED_WARNING = 'pptx.eastAsianFont を省いたため、PPTX では東アジア書体を書き込みません。'
+    + '日本語の書体を揃えるには pecot-theme.json の pptx.eastAsianFont に書体名を書いてください';
+//# sourceMappingURL=warnings.js.map

package/cli/dist/domain/slidev-theme/deck-lint-input.d.ts

@@ -0,0 +1,11 @@
+import type { LintSeverity } from './declaration.js';
+export interface DeckLintInput {
+    readonly referencesDirectories: readonly string[];
+    readonly panels: Readonly<Record<string, {
+        readonly width: number;
+        readonly height: number;
+    }>>;
+    readonly markerLayouts: readonly string[];
+    readonly rules: Readonly<Record<string, LintSeverity>>;
+}
+//# sourceMappingURL=deck-lint-input.d.ts.map

package/cli/dist/domain/slidev-theme/deck-lint-input.js

@@ -0,0 +1,4 @@
+// デッキ lint（deck-lint.config.js）が受ける、テーマの宣言の解釈結果。
+// `slide theme --json` の lint と同じ形で、CLI が環境変数 PECOTV_DECK_LINT に JSON で渡す。
+export {};
+//# sourceMappingURL=deck-lint-input.js.map

package/cli/dist/domain/slidev-theme/deck-lint-rules.d.ts

@@ -0,0 +1,3 @@
+export declare const DECK_LINT_RULE_IDS: readonly string[];
+export declare const REFERENCE_FREE_RULE_IDS: readonly string[];
+//# sourceMappingURL=deck-lint-rules.d.ts.map