@pecot/visual-mcp 0.0.0-stage → 1.0.0

package/cli/dist/infra/slidev-project/eslint-runner.js

@@ -0,0 +1,144 @@
+// 本体の assets/slidev が持つ eslint を子プロセスで起動する EslintRunner 実装。
+//
+// standalone talk-dir には lint 資材を同梱しない方針のため、eslint 本体と flat config は本体の `assets/slidev` から借りる。
+// テーマの宣言の解釈結果（`slide theme` の lint）は、環境変数 PECOTV_DECK_LINT に JSON で渡す。
+// PostToolUse hook (`hooks/lib/post-tool-use/eslint-check.sh`) と同じ供給機構。
+//
+// cwd は必ず talk-dir にする。
+// flat config の files / ignores パターンは、`--config` 指定時でも cwd 基準で解決される。
+// そのため chdir を怠ると、1 ファイルも lint せず exit 0 になる。
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { isRecord } from '../../domain/_shared/json.js';
+import { doesRangeAllowMajor } from '../../domain/_shared/version-range.js';
+import { SlideLintRuntimeError } from '../../domain/slidev-project/lint.js';
+import { spawnPromise } from '../_shared/process.js';
+const ESLINT_TIMEOUT_MS = 60_000;
+/**
+デッキ用の flat config。`eslint.config.*` の名前にしないのは、ESLint 10 が対象ファイルに最も近い
+`eslint.config.*` を上方探索で使うため。`--config` で渡すので探索には拾われない。
+*/
+/**
+lint 対象。`pages/_references/*.yaml` の validate-references は対象外。
+*/
+const LINT_TARGETS = ['pages/**/*.md', 'slides.md'];
+/**
+`assets/slidev` が使う eslint bin (`bin/eslint.js`) の絶対パスを解決する。
+
+eslint の `exports` は `./bin/eslint.js` を公開していないため直接 resolve できない。
+`assets/slidev/package.json` 基準の `createRequire` で `eslint/package.json` を引く。
+`bin.eslint` は package root からの相対で解決する（`infra/slidev-to-pptx/runner.ts` の `resolveSlidevBin` と同じ流儀）。
+
+assert の目的は、「`assets/slidev` が想定していない eslint で lint 結果が変わる」ことの防止。
+判定材料は、解決した eslint のメジャー版が `assets/slidev/package.json` の `devDependencies.eslint` の range に収まるか。
+解決先パスでは見ない。単体配布形態では eslint がプラグインルートの兄弟（`_npx/<hash>/node_modules/eslint`）に置かれ、
+パス前置判定では必ず失敗するため。
+
+`devDependencies.eslint` が無ければ throw する（fail-closed）。
+そのまま通すと「どのメジャーでもよい」ことになるため。
+*/
+export function resolveEslintBin(assetsDirectory) {
+    const assetsRoot = path.resolve(assetsDirectory);
+    const requireFromAssets = createRequire(path.join(assetsRoot, 'package.json'));
+    let packageJsonPath;
+    try {
+        packageJsonPath = requireFromAssets.resolve('eslint/package.json');
+    }
+    catch (error) {
+        throw new SlideLintRuntimeError(`'${assetsRoot}' から eslint を解決できませんでした`
+            + `（本体の依存が未 install の可能性があります）: ${formatError(error)}`, 'eslint-not-launched');
+    }
+    // eslint-disable-next-line no-restricted-syntax -- require 戻り値 (any) の narrowing
+    const packageJson = requireFromAssets(packageJsonPath);
+    const binEntry = packageJson.bin;
+    /* c8 ignore next 3 -- eslint の package.json は常に `bin.eslint` を持つ。他形式は防御網 */
+    const relativeBin = typeof binEntry === 'string'
+        ? binEntry
+        : binEntry?.['eslint'] ?? 'bin/eslint.js';
+    const binPath = path.resolve(path.dirname(packageJsonPath), relativeBin);
+    assertEslintMatchesAssets({
+        assetsRoot,
+        binPath,
+        resolvedVersion: packageJson.version ?? '',
+        wantRange: assetsEslintRange(requireFromAssets, assetsRoot),
+    });
+    return binPath;
+}
+/**
+`assets/slidev/package.json` が宣言する eslint の range。宣言が無ければ空文字。
+
+package.json 自体が読めない（欠落・不正 JSON）ときは、上流の eslint 解決と同じく
+`SlideLintRuntimeError` へ畳む。生の例外を伝播させると reason 付きの失敗にならない。
+*/
+function assetsEslintRange(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types -- Require は mutable 型
+requireFromAssets, assetsRoot) {
+    let manifest;
+    try {
+        manifest = requireFromAssets(path.join(assetsRoot, 'package.json'));
+    }
+    catch (error) {
+        throw new SlideLintRuntimeError(`'${assetsRoot}' の package.json を読めませんでした`
+            + `（どの eslint で lint すべきか決められないため中止します）: ${formatError(error)}`, 'eslint-not-launched');
+    }
+    /* c8 ignore next -- object 以外の package.json は、手前の require.resolve が node の package 検証で弾くため到達不能 */
+    const devDependencies = isRecord(manifest) ? manifest['devDependencies'] : undefined;
+    const range = isRecord(devDependencies) ? devDependencies['eslint'] : undefined;
+    return typeof range === 'string' ? range : '';
+}
+function assertEslintMatchesAssets(context) {
+    if (context.wantRange === '') {
+        throw new SlideLintRuntimeError(`'${context.assetsRoot}' の package.json が devDependencies.eslint を宣言していません。`
+            + ' どの eslint で lint すべきか決められないため中止します。', 'eslint-not-launched');
+    }
+    /* c8 ignore next -- split の先頭要素は常に文字列で、空文字への代替の右辺は到達不能 */
+    const majorText = context.resolvedVersion.split('.', 1)[0] ?? '';
+    const resolvedMajor = majorText === '' ? NaN : Number(majorText);
+    if (Number.isNaN(resolvedMajor) || !doesRangeAllowMajor(context.wantRange, resolvedMajor)) {
+        throw new SlideLintRuntimeError(`eslint bin '${context.binPath}' のバージョン '${context.resolvedVersion}' が`
+            + ` assets/slidev の要求 '${context.wantRange}' とメジャー違いです。`
+            + ' 本体が想定する eslint 以外では lint 結果が保証できないため中止します。', 'eslint-not-launched');
+    }
+}
+export class ChildProcessEslintRunner {
+    resolveBin;
+    constructor(resolver = resolveEslintBin) {
+        this.resolveBin = resolver;
+    }
+    /**
+    `node <eslint-bin>` を、talk-dir を cwd にして起動する。
+    引数は `--no-fix --config <本体の deck-lint.env.config.js> --format json` の 3 組。
+    環境変数 `PECOTV_DECK_LINT` に、`slide theme` が解釈した lint の 4 項目を JSON で渡す。
+    さらに `--no-error-on-unmatched-pattern` と、対象 glob の `pages/**\/*.md slides.md` を渡す。
+  
+    - `--no-fix`: 対象ルールは全て `meta.fixable` 未宣言で、`--fix` は no-op。
+    - `--no-error-on-unmatched-pattern`: `pages/*.md` が 0 件のとき eslint は exit 2 で異常終了する。
+      違反と紛れないよう、フラグで抑止する。
+    - glob は `shell: false` 起動のためシェル展開されず、eslint 自身の globSearch が解釈する。
+    */
+    async run(arguments_) {
+        const eslintBin = this.resolveBin(arguments_.assetsDirectory);
+        const spawnArguments = [
+            eslintBin,
+            '--no-fix',
+            '--config',
+            arguments_.deckLintConfig,
+            '--format',
+            'json',
+            '--no-error-on-unmatched-pattern',
+            ...LINT_TARGETS,
+        ];
+        return spawnPromise(process.execPath, spawnArguments, {
+            cwd: arguments_.talkDirectory,
+            // deck lint の設定は、宣言を読まずこの JSON を受ける。create / sync の自動 lint も同じ設定で動く。
+            env: { ...process.env, PECOTV_DECK_LINT: JSON.stringify(arguments_.lint) },
+            timeoutMs: ESLINT_TIMEOUT_MS,
+        });
+    }
+}
+/* c8 ignore start -- 非 Error 例外 (string throw 等) は本実装範囲では未発生、防御網のみ */
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/* c8 ignore stop */
+//# sourceMappingURL=eslint-runner.js.map

package/cli/dist/infra/slidev-project/fs.d.ts

@@ -0,0 +1,117 @@
+import type { ViteConfigOptions } from '../../domain/slidev-project/generated-files.js';
+import type { NodeModulesThemeLink } from '../../domain/slidev-project/sync.js';
+/**
+destinationDirectory 直下に `public/slides/{images,diagrams,html}` を作る。
+`public/assets` は作らない。テーマの assets は、テーマのパッケージから配る。
+*/
+export declare function setupPublicSlides(destinationDirectory: string): Promise<void>;
+/**
+依存ルートに node_modules の実体があることを確かめる。無ければ理由付きで中止する。
+生成先に触れる前の確認に使う。後ろに置くと、既存の生成先を外した後で失敗する。
+*/
+export declare function assertDependencyRootAvailable(dependencyRoot: string): void;
+/**
+`TEMPLATE_ENTRIES` のうち talk-dir にあるものを消し、消した名前を返す。
+入れ子の名前は、親が talk-dir の中の実ディレクトリのときだけ消す。
+親が symlink だと、talk-dir の外のファイルを消しかねない。
+名前そのものが symlink なら、リンクだけを消す。向き先は消さない。
+*/
+export declare function removeTemplateEntries(talkDirectory: string): Promise<readonly string[]>;
+/**
+`talkDirectory/vite.config.ts` と `start.mjs` を本体の生成物で書く。
+テンプレートからは複写しない（`GENERATED_FILES`）。create は組み立て中の dir に書く。
+移行済みの talk-dir は `syncGeneratedFiles` で、違うときだけ書き直す。
+`start.mjs` は、テンプレートのときと同じく実行権限を付ける。
+*/
+export declare function writeGeneratedFiles(talkDirectory: string, options: Readonly<ViteConfigOptions>): Promise<void>;
+/**
+`vite.config.ts` と `start.mjs` を本体の今の内容にそろえる。違うファイルだけを書き直し、書いたファイル名を返す。
+同じ内容なら書かない。Slidev は `vite.config.ts` の変更で dev サーバを再起動するため、無用な書き直しは再起動を起こす。
+比べる前に CRLF を LF にそろえる。書くときは一時ファイルに書いて rename し、読み手に書きかけを見せない。
+`start.mjs` には、書くたびに実行権限を付ける。
+*/
+export declare function syncGeneratedFiles(talkDirectory: string, options: Readonly<ViteConfigOptions>): Promise<readonly string[]>;
+export interface LinkedRuntime {
+    readonly kind: 'generation' | 'path';
+    readonly value: string;
+}
+export interface NodeModulesLinkResult {
+    /**
+    項目の張り元になった依存ルートの node_modules。`runtime/current` は解決せずに残す。
+    */
+    readonly nodeModulesTarget: string;
+    /**
+    talk-dir の node_modules 直下に並んだ項目の数。印のファイルは数えない。
+    */
+    readonly entries: number;
+}
+/**
+talkDirectory の node_modules を、実ディレクトリと項目ごとの相対 symlink で組み立てる。
+
+依存ルートの `node_modules` の各項目を、そのまま 1 本ずつ張る。
+`@scope` と `.bin` も 1 本で張る。
+`.` 始まりの項目は `.bin` だけ張る（`.pnpm`、`.modules.yaml`、`.vite` は張らない）。
+テーマは `name` の項目を `directory` へ張り、依存ルートの同名の項目より優先する。
+scope 付きの名前は、その scope だけ実ディレクトリにして、配下を 1 本ずつ張る。
+
+張り先は物理パス基準にする。
+依存ルートが `runtime/current` のときだけ、`current` を解決せずに残す（`physicalNodeModulesTarget`）。
+ハッシュ名まで解決すると、世代削除でリンクが切れる。
+絶対パスを埋め込むと、container 内パスが host 側では dangling になる。必ず相対パスで張る。
+
+既存の node_modules は、組み立てを終えてから入れ替える。
+組み立ては talk-dir 直下の `node_modules.tmp-<乱数>` で行い、印まで書く。
+入れ替えは、既存を `node_modules.old-<乱数>` へ移し、組み立てたものを `node_modules` へ移す順で行う。
+そのため、実行中の dev サーバから見て node_modules が無い時間は、移す 2 回の間だけになる。
+組み立てに失敗したら、組み立て中のものだけを消し、既存の node_modules を残す。
+入れ替えで外した旧い node_modules は、symlink なら張り先を消さずに外し、実ディレクトリなら中身ごと消す。
+前回の異常終了で残った `node_modules.tmp-*` と `node_modules.old-*` は、次の張り直しの最初に消す。
+旧形（symlink 1 本）からの移行にも、繰り返しの実行にも使える。
+*/
+export declare function linkNodeModules(talkDirectory: string, dependencyRoot: string, themes: readonly NodeModulesThemeLink[]): Promise<NodeModulesLinkResult>;
+/**
+talkDirectory の node_modules が、今の依存ルートとテーマで張られたままかを返す。
+
+印の `runtime`（依存ルートの世代、または物理パス）と `themes[].directory` を今の値と比べる。
+比較はどちらも realpath に正規化してから行う。
+印が無い・読めない・旧形の symlink 1 本・張り先が消えた symlink は「違う」とする。
+テーマの項目が node_modules から消えていたときも「違う」とする。
+読むだけで、何も書かない。
+*/
+export declare function isNodeModulesLinkCurrent(talkDirectory: string, dependencyRoot: string, themes: readonly NodeModulesThemeLink[]): Promise<boolean>;
+/**
+talk-dir 候補ディレクトリの存在 / type を返す。`assertTalkDirectory` 専用 helper。
+*/
+export declare function talkDirectoryExists(talkDirectory: string): Promise<{
+    readonly exists: boolean;
+    readonly isDirectory: boolean;
+}>;
+/**
+talk-dir マーカーである `slides.md` の存在判定。誤って ~/Documents 等に sync を撒かない
+よう、sync は slides.md の存在を必須とする。
+*/
+export declare function hasSlidesMd(talkDirectory: string): Promise<boolean>;
+/**
+`pages/` 配下で「symlink かつ解決先がディレクトリ」のエントリを talk-dir 相対パスで列挙する。
+
+eslint の glob walk は、dirent の `isDirectory()` で再帰先を決める。
+そのため symlink の dir は、物理パスで `--dir` を指定しても辿られない。
+配下の `*.md` が 1 件も lint されないまま、clean / exit 0 で通過する。
+この状況を警告するための、検出専用 helper。
+lint の成否（outcome / exit code）には関与しない。
+
+walk 中に出会った symlink dir の配下は辿らない。
+eslint も辿らないため、警告は symlink dir 1 件につき 1 行で足りる。
+glob の起点そのものが symlink の場合は eslint が辿るので、取りこぼしにならない。
+配下に md があるかは辿らないため判定できない。
+そこで symlink dir は、無条件で報告する保守側の選択を採る。
+空 dir、`pages/_references` のような md 非対象、解決先が talk-dir 内の物理領域で別の道筋から lint 済みのもの、のいずれでも報告される。
+
+symlink→ファイル（ページファイル自体が symlink）と dangling symlink は報告しない。
+前者は eslint が実際に lint する。これは回帰テストで固定している。
+後者は解決先が無く、lint 対象そのものが存在しない。
+そのため、いずれも取りこぼしにならない。
+`pages/` 不在時は空配列を返す。
+*/
+export declare function listSkippedSymlinkPageDirectories(talkDirectory: string): Promise<readonly string[]>;
+//# sourceMappingURL=fs.d.ts.map