@pecot/visual-mcp 0.0.0-stage → 1.1.0

package/cli/dist/domain/slidev-to-pptx/slide-url.js

@@ -0,0 +1,64 @@
+// スライドステップの URL 形式。Slidev の routerMode（`history` / `hash`）で
+// スライド番号と clicks の載る位置が変わるため、組み立てと解析をここに一本化する。
+//
+//   history: `http://localhost:3000/4?clicks=1`
+//   hash:    `http://localhost:3000/#/4?clicks=1`
+//
+// hash では `?clicks=N` はフラグメント内の query であり、`URL.searchParams` からは引けない。
+// この差を吸収しないと、全ステップが `{ slideNumber: 1, clickStep: null }` にまとめられる。
+// すると stepIndex が衝突して、全スライドが同一 PPTX を上書きする。
+//
+// hash デッキではページを使い回した goto が same-document navigation になり、load 系の待機イベントが発火しない。
+// そのため、ステップごとにページを新規作成する前提を変えないこと。
+/**
+スライド 1 ステップの URL を組み立てる。`clicks` 未指定はクリック前の状態。
+*/
+export function buildSlideUrl(baseUrl, slide, options) {
+    // 末尾スラッシュ付きの baseUrl でも `//#/5` のような二重スラッシュを作らない。
+    const root = baseUrl.replace(/\/+$/, '');
+    const base = options.hash
+        ? `${root}/#/${slide.toString()}`
+        : `${root}/${slide.toString()}`;
+    return options.clicks === undefined ? base : `${base}?clicks=${options.clicks.toString()}`;
+}
+/**
+全スライドを 1 ページに並べる print ルートの URL（1 パス方式が開く）。`print=clicks` で各スライドの
+クリック段もコンテナに展開される。
+
+  history: `http://localhost:3000/print?print=clicks`
+  hash:    `http://localhost:3000/?print=clicks#/print`
+
+hash では `?print=clicks` を、フラグメントの前（document の query）に置く。
+Slidev の `isPrintMode` は document の query を見るため、`/#/print?print=clicks` ではクリック段が展開されない（計測）。
+`range` クエリは build 済み SPA では無視され、全スライドが描かれるため付けない。
+新しいページへ 1 回 goto するだけなので、上記の same-document navigation の注意は当たらない。
+*/
+export function buildPrintUrl(baseUrl, options) {
+    const root = baseUrl.replace(/\/+$/, '');
+    return options.hash ? `${root}/?print=clicks#/print` : `${root}/print?print=clicks`;
+}
+/**
+URL からスライド番号と clicks ステップを解析する。hash ルータの URL は
+フラグメントを 1 本の URL とみなして再解析する。
+*/
+export function parseSlideUrl(url) {
+    const urlObject = new URL(url);
+    const target = urlObject.hash.startsWith('#/')
+        ? new URL(urlObject.hash.slice(1), urlObject.origin)
+        : urlObject;
+    const parts = target.pathname.split('/').filter(Boolean);
+    if (parts.length === 0) {
+        // eslint-disable-next-line unicorn/no-null -- SlideStep.clickStep は未指定を null で表す
+        return { slideNumber: 1, clickStep: null, url };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- parts.length > 0 を上の if で保証している
+    const slideNumber = Math.trunc(Number(parts[0])) || 1;
+    const clicksParameter = target.searchParams.get('clicks');
+    // `?clicks=abc` / `?clicks=` は解析不能。
+    // NaN を通すと stepIndex が NaN になり `slide-NaN.pptx` を書き出すため、clicks 未指定と同じ null に倒す。
+    const clicks = clicksParameter === null || clicksParameter === '' ? NaN : Math.trunc(Number(clicksParameter));
+    // eslint-disable-next-line unicorn/no-null -- 同上
+    const clickStep = Number.isNaN(clicks) ? null : clicks;
+    return { slideNumber, clickStep, url };
+}
+//# sourceMappingURL=slide-url.js.map

package/cli/dist/domain/slidev-to-pptx/slides-title.d.ts

@@ -0,0 +1,15 @@
+/**
+slides.md 全体テキストの frontmatter から title を抽出する。
+次のいずれかの場合は undefined を返す。
+frontmatter が無い、閉じ `---` が無い、title キーが無い、値が空 (空白のみを含む)。
+`unicorn/no-null` が error のため、null は使わない。
+*/
+export declare function parseSlidesTitle(content: string): string | undefined;
+/**
+title を、ファイル名として安全な文字列へ変換する。
+禁止文字 `[/\\<>:"|?*]` を `_` に置換し、前後空白を trim し、UTF-8 で {@link FILENAME_MAX_BYTES} バイトに切り詰める。
+切り詰めでは code point 境界を跨がない。
+空 / undefined と、整形後に空文字列となるものは、`'merged'` へフォールバックする。
+*/
+export declare function sanitizeFilename(title: string | undefined): string;
+//# sourceMappingURL=slides-title.d.ts.map

package/cli/dist/domain/slidev-to-pptx/slides-title.js

@@ -0,0 +1,73 @@
+// slides.md の frontmatter から title を抽出し、ファイル名として安全な文字列へ整える純粋関数。
+// convert コマンドの既定の出力名の決定と、pipeline の debug ログ (infra/dom-converter の
+// readSlidesTitle 経由) の双方から再利用する。
+// frontmatter 抽出は、domain/slidev-project/slides-md.ts と同じ、文字列分割の方式を用いる。
+// 方式は `'---\n'` デリミタ + indexOf。
+// `[\s\S]*?` 系の regex への移設は、regexp/no-super-linear-backtracking に抵触するため行わない。
+// CRLF は先に LF へ正規化する。
+const FRONTMATTER_DELIMITER = '---\n';
+// title 行のみを抽出する。
+// 空白と値を別々の量指定子で受けると (`[ \t]+(.+)`) 文字を交換でき、regexp/no-super-linear-backtracking に触れる。
+// そのため値は `(.*)` 一括で取り、trim 側で整形する。
+const TITLE_KEY_REGEX = /^title:(.*)$/m;
+const QUOTE_TRIM_REGEX = /^['"]|['"]$/g;
+const FILENAME_FORBIDDEN_REGEX = /[/\\<>:"|?*]/g;
+// 多くの filesystem の NAME_MAX は 255 バイト。呼び出し側が末尾に `.pptx` (5 バイト) を付ける
+// ため、その分を差し引いた 250 バイトを stem 上限とする (合計で 255 バイト以内に収める)。
+const FILENAME_MAX_BYTES = 250;
+/**
+slides.md 全体テキストの frontmatter から title を抽出する。
+次のいずれかの場合は undefined を返す。
+frontmatter が無い、閉じ `---` が無い、title キーが無い、値が空 (空白のみを含む)。
+`unicorn/no-null` が error のため、null は使わない。
+*/
+export function parseSlidesTitle(content) {
+    const normalized = content.replaceAll('\r\n', '\n');
+    if (!normalized.startsWith(FRONTMATTER_DELIMITER))
+        return undefined;
+    const remainder = normalized.slice(FRONTMATTER_DELIMITER.length);
+    // 閉じフェンスは `\n---\n`。末尾に番兵 `\n` を足すことで、末尾が改行無しの `---` で
+    // 終わる frontmatter も検出できる (開きはあるが閉じが無い場合は -1 → undefined)。
+    const closeIndex = `${remainder}\n`.indexOf(`\n${FRONTMATTER_DELIMITER}`);
+    if (closeIndex === -1)
+        return undefined;
+    const frontmatter = remainder.slice(0, closeIndex);
+    const titleMatch = TITLE_KEY_REGEX.exec(frontmatter);
+    if (titleMatch?.[1] === undefined)
+        return undefined;
+    const title = titleMatch[1].trim().replaceAll(QUOTE_TRIM_REGEX, '');
+    return title.length > 0 ? title : undefined;
+}
+/**
+文字列を UTF-8 バイト長基準で maxBytes 以内に切り詰める。
+`for...of` は code point 単位で反復するため、サロゲートペア (絵文字等) を分断しない。
+UTF-16 code unit 数の `slice` では日本語 title が NAME_MAX (255 バイト) を超え得るため、
+バイト長で数える。
+*/
+function truncateToBytes(value, maxBytes) {
+    if (Buffer.byteLength(value, 'utf8') <= maxBytes)
+        return value;
+    let result = '';
+    let bytes = 0;
+    for (const char of value) {
+        const charBytes = Buffer.byteLength(char, 'utf8');
+        if (bytes + charBytes > maxBytes)
+            break;
+        result += char;
+        bytes += charBytes;
+    }
+    return result;
+}
+/**
+title を、ファイル名として安全な文字列へ変換する。
+禁止文字 `[/\\<>:"|?*]` を `_` に置換し、前後空白を trim し、UTF-8 で {@link FILENAME_MAX_BYTES} バイトに切り詰める。
+切り詰めでは code point 境界を跨がない。
+空 / undefined と、整形後に空文字列となるものは、`'merged'` へフォールバックする。
+*/
+export function sanitizeFilename(title) {
+    if (title === undefined || title.length === 0)
+        return 'merged';
+    const sanitized = title.replaceAll(FILENAME_FORBIDDEN_REGEX, '_').trim();
+    return sanitized.length > 0 ? truncateToBytes(sanitized, FILENAME_MAX_BYTES) : 'merged';
+}
+//# sourceMappingURL=slides-title.js.map

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

@@ -0,0 +1,12 @@
+import type { SlideStep } from './types.js';
+/**
+ステップの整数 ID。出力ファイル名（`slide-<stepIndex>.pptx` / `prerender-slide<stepIndex>-*`）と
+キャッシュ manifest のキーがこの値で対応する。
+*/
+export declare function stepIndexOf(step: Readonly<SlideStep>): number;
+/**
+人間向け・JSON 双方で使うステップ表記（`"5"` / `"5/2"`）。clickStep の 0 と null は
+別のステップなので、stepIndex からは復元できない（0 と null がどちらも `N*100` になる）。
+*/
+export declare function stepKeyOf(step: Readonly<SlideStep>): string;
+//# sourceMappingURL=step-index.d.ts.map

package/cli/dist/domain/slidev-to-pptx/step-index.js

@@ -0,0 +1,21 @@
+// スライドステップの同定子。変換ワーカー（出力ファイル名）とパイプライン（キャッシュキー・
+// timing の集計）が同じ値を使う必要があるため、算出式をここに一本化する。
+/**
+ステップの整数 ID。出力ファイル名（`slide-<stepIndex>.pptx` / `prerender-slide<stepIndex>-*`）と
+キャッシュ manifest のキーがこの値で対応する。
+*/
+export function stepIndexOf(step) {
+    return step.clickStep === null
+        ? step.slideNumber * 100
+        : step.slideNumber * 100 + step.clickStep;
+}
+/**
+人間向け・JSON 双方で使うステップ表記（`"5"` / `"5/2"`）。clickStep の 0 と null は
+別のステップなので、stepIndex からは復元できない（0 と null がどちらも `N*100` になる）。
+*/
+export function stepKeyOf(step) {
+    return step.clickStep === null
+        ? step.slideNumber.toString()
+        : `${step.slideNumber.toString()}/${step.clickStep.toString()}`;
+}
+//# sourceMappingURL=step-index.js.map

package/cli/dist/domain/slidev-to-pptx/types.d.ts

@@ -0,0 +1,174 @@
+export interface SlideStep {
+    readonly slideNumber: number;
+    readonly clickStep: number | null;
+    readonly url: string;
+}
+export interface PipelineError {
+    readonly level: string;
+    readonly slideNumber?: number;
+    readonly selector?: string;
+    readonly message: string;
+}
+/**
+1 ステップの変換の工程別所要（ms）。
+現行方式はステップごとにページを開くため、全キーが計測値になる。
+1 パス方式ではページの用意（newPage〜inject）を全体で 1 回だけ行うため、それらは 0 になる。
+全体分は `PipelineTiming.singlePass` に載る。
+prerender は、1 パス方式では「撮影・差し替え」だけの時間。
+1 パス方式の run でも、現行の worker へ回したステップ（`SinglePassTiming.fallbackSteps`）は、
+newPage〜inject に計測値が入る。
+そのため同じ run の中で、0 のステップと計測値のステップが混在する。
+*/
+export interface SlidePhases {
+    readonly newPage: number;
+    readonly goto: number;
+    readonly visible: number;
+    readonly cssSettle: number;
+    readonly iframeLoad: number;
+    readonly inject: number;
+    readonly prerender: number;
+    readonly convert: number;
+    readonly restore: number;
+}
+/**
+1 パス方式の 1 グループ（print ページ A / B の 1 ペア）の所要（ms）。
+*/
+export interface SinglePassGroupTiming {
+    /**
+    このグループが扱うスライド番号（昇順）
+    */
+    readonly slides: readonly number[];
+    /**
+    このグループのステップ数（= コンテナ数）
+    */
+    readonly steps: number;
+    /**
+    変換ページ。用意の途中で退避したグループでは undefined
+    */
+    readonly pageA?: Readonly<{
+        goto: number;
+        visible: number;
+        cssSettle: number;
+        iframeLoad: number;
+        inject: number;
+    }>;
+    /**
+    prerender 用の高解像度ページ。prerender 対象が無いグループでは開かないため undefined
+    */
+    readonly pageB?: Readonly<{
+        goto: number;
+        wait: number;
+        scrollWarmup: number;
+    }>;
+    /**
+    グループごと現行の worker に回したときの理由
+    */
+    readonly fallback?: string;
+    /**
+    用意の時点では prerender 対象を検出できず、ステップ処理中に高解像度ページを開いた
+    */
+    readonly lazyPageB?: boolean;
+}
+/**
+1 パス方式で変換した run の所要。スライド番号で分けたグループごとにページ A / B を 1 ペアずつ持つ。
+*/
+export interface SinglePassGroupsTiming {
+    /**
+    判別子。1 パス方式で変換した run
+    */
+    readonly kind: 'converted';
+    readonly groups: readonly SinglePassGroupTiming[];
+    /**
+    現行の worker に回したステップ（グループ単位の退避とステップ単位の失敗の両方。timing.perSlide と同じ表記）
+    */
+    readonly fallbackSteps: readonly string[];
+}
+/**
+print ルートが build に無いと判定し、run 全体を現行方式（ステップ単位の並列）へ退避した run の所要。
+全ステップは現行方式で変換され、perSlidePhases は現行方式の計測値になる。
+*/
+export interface SinglePassFallbackTiming {
+    /**
+    判別子。print ルートが無く run 全体を現行方式へ退避した run
+    */
+    readonly kind: 'printRouteMissing';
+    /**
+    退避の理由。グループは並列に判定し、最初に不在を返したグループの理由を載せる
+    */
+    readonly fallback: string;
+    /**
+    1 パス方式を始めてから全グループの判定が終わる（各グループがページを開き・読み込み・判定し・
+    閉じる）までの経過時間（ms）。グループは並列に動くため、グループごとの所要の合計ではない
+    */
+    readonly detectMs: number;
+}
+/**
+1 パス方式を試みた run の所要。変換した run はグループ別、run 全体を退避した run は理由と判定時間。
+`kind` で判別する（`slide convert --json` の `timings.singlePass` にもそのまま載る）。
+*/
+export type SinglePassTiming = SinglePassGroupsTiming | SinglePassFallbackTiming;
+export interface PipelineTiming {
+    readonly total: number;
+    readonly scan: number;
+    readonly phase1: number;
+    readonly phase2: number;
+    readonly perSlide: Readonly<Record<string, number>>;
+    /**
+    変換したステップの工程別所要（キーは perSlide と同じ表記）。キャッシュ hit のステップは載らない
+    */
+    readonly perSlidePhases?: Readonly<Record<string, SlidePhases>>;
+    /**
+    1 パス方式を試みた run だけ載る（print ルートが無く run 全体を退避した run を含む）
+    */
+    readonly singlePass?: SinglePassTiming;
+}
+/**
+既存キャッシュエントリの無効化の種別。新規スライドの miss は無効化に数えない
+(末尾追加は `none`)。contracts/cache-interface.md §2 の `cache.invalidated` と同値。
+
+`all:key` はキー算出失敗（slides.md が読めない等）による全変換フォールバック。
+`enabled: false` と併記される。
+#898 の `--no-cache` は同じく `enabled: false` だが `invalidated: 'none'` なので、JSON 上で区別できる。
+
+`all:error` はキャッシュ層の予期しない例外（cache-store の I/O 失敗等）による全変換フォールバック。
+同じく `enabled: false` と併記される。
+`--no-cache` および `all:key`（想定内のキー算出失敗）とは、JSON 上で区別できる。
+*/
+export type CacheInvalidation = 'none' | 'all:env' | 'all:manifest' | 'all:key' | 'all:error' | 'partial';
+export interface PipelineCacheStep {
+    readonly stepIndex: number;
+    /**
+    timing.perSlide と同じステップ表記 (`"5"` / `"5/2"`)。stepIndex からは復元できない
+    */
+    readonly key: string;
+    readonly cache: 'hit' | 'miss';
+}
+export interface PipelineCacheSummary {
+    /**
+    キャッシュを実際に使ったか。キー算出に失敗して全変換へ退避した run は false
+    */
+    readonly enabled: boolean;
+    readonly hits: number;
+    readonly misses: number;
+    readonly invalidated: CacheInvalidation;
+    readonly perStep: readonly PipelineCacheStep[];
+}
+export interface PipelineResult {
+    readonly success: boolean;
+    readonly slideCount: number;
+    /**
+    Phase 1 の単スライド PPTX 群が書き出された slides ディレクトリの絶対パス
+    (`<outputDir>/slides/`)。merge 後の最終 PPTX path は cli 側
+    (`commands/slidev-to-pptx/convert.ts`) の `--out` 値が真値であり、本フィールドではない。
+    */
+    readonly slidesDirectory: string;
+    readonly errors: readonly PipelineError[];
+    readonly warnings: readonly string[];
+    readonly timing: PipelineTiming;
+    /**
+    pptx 差分キャッシュの判定結果。キャッシュを扱わなかった run
+    (config.cache 未指定 / onlySlide / onlySteps の部分実行) では undefined。
+    */
+    readonly cache?: PipelineCacheSummary;
+}
+//# sourceMappingURL=types.d.ts.map

package/cli/dist/domain/slidev-to-pptx/types.js

@@ -0,0 +1,3 @@
+// Slidev → PPTX pipeline が返す結果型。infra/slidev-to-pptx/ の実装とテストが共通参照する。
+export {};
+//# sourceMappingURL=types.js.map

package/cli/dist/domain/slidev-to-pptx/visibility.d.ts

@@ -0,0 +1,4 @@
+export declare const slideVisibleFunctionSource = "(el) => {\n  const s = getComputedStyle(el);\n  return s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0' && el.children.length > 0;\n}";
+export declare const slidevReadyFunctionSource = "() => {\n  const pages = document.querySelectorAll('.slidev-page');\n  if (pages.length === 0) return false;\n  for (const p of pages) {\n    const s = getComputedStyle(p);\n    if (s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0' && p.children.length > 0) return true;\n  }\n  return false;\n}";
+export declare const readSlidevHasNextFn = "() => {\n  const app = document.getElementById('app');\n  const provides = app && app.__vue_app__ && app.__vue_app__._context\n    ? app.__vue_app__._context.provides\n    : null;\n  const context = provides ? provides['$$slidev-context'] : null;\n  const nav = context ? context.nav : null;\n  if (!nav || typeof nav.hasNext !== 'boolean') return null;\n  return nav.hasNext;\n}";
+//# sourceMappingURL=visibility.d.ts.map

package/cli/dist/domain/slidev-to-pptx/visibility.js

@@ -0,0 +1,33 @@
+// page.evaluate の中で、`new Function('return ' + fn)()` 経由で使う browser-injected JS の文字列定数。
+// infra/slidev-to-pptx/ の Playwright 触り部分から参照される。
+/* eslint-disable unicorn/name-replacements -- 旧 sub-package と同名で外部からの参照名を維持 */
+export const slideVisibleFunctionSource = `(el) => {
+  const s = getComputedStyle(el);
+  return s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0' && el.children.length > 0;
+}`;
+export const slidevReadyFunctionSource = `() => {
+  const pages = document.querySelectorAll('.slidev-page');
+  if (pages.length === 0) return false;
+  for (const p of pages) {
+    const s = getComputedStyle(p);
+    if (s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0' && p.children.length > 0) return true;
+  }
+  return false;
+}`;
+// build 済み Slidev アプリの nav 状態を読む。
+// Vue 3 は production build でも `app.__vue_app__` を無条件に代入する。
+// そのため `$$slidev-context` の provide 経由で `nav.hasNext` に届く（`window.__slidev__` は `__DEV__` 限定で使えない）。
+// 最終ステップで false になるので、scanner はこれを見て ArrowRight を押さずに終われる。
+// context に届かない場合は null を返し、呼び出し側を従来の終端判定へ倒す。
+export const readSlidevHasNextFn = `() => {
+  const app = document.getElementById('app');
+  const provides = app && app.__vue_app__ && app.__vue_app__._context
+    ? app.__vue_app__._context.provides
+    : null;
+  const context = provides ? provides['$$slidev-context'] : null;
+  const nav = context ? context.nav : null;
+  if (!nav || typeof nav.hasNext !== 'boolean') return null;
+  return nav.hasNext;
+}`;
+/* eslint-enable unicorn/name-replacements */
+//# sourceMappingURL=visibility.js.map

package/cli/dist/infra/_shared/dependency-root.d.ts

@@ -0,0 +1,149 @@
+/**
+データ置き場。作らずに値を返す。
+有効な HOME と有効な XDG_DATA_HOME がどちらも無いときは undefined。
+
+bin/_lib.sh の plugin_data_dir_resolve と同じ解決順で、同じ入力なら同じ結果になる。
+この対応は tests/unit/infra/dependency-root.test.ts が固定する。
+順序は CLAUDE_PLUGIN_DATA、PLUGIN_DATA、XDG_DATA_HOME、HOME の順。
+XDG_DATA_HOME の下は `pecot/pecot-visual`、HOME の下は `.local/share/pecot/pecot-visual`。
+XDG_DATA_HOME が絶対パスでなければ未設定として扱う。
+HOME が使えるのは絶対パスのときだけ。
+*/
+export declare function dataDirectory(): string | undefined;
+/**
+永続層のルート（`${データ置き場}/mcp-dist`）。配下の `node_modules` が単体配布の依存ルートになる。
+
+作らずに値を返すだけで、作成は installRuntimeDependencies が行う。
+プラグインの `runtime/` とは別のディレクトリなので、bin/pecotv の世代削除とは干渉しない。
+置き場を決められない環境では undefined。
+*/
+export declare function runtimeDependencyRoot(): string | undefined;
+/**
+テーマの置き場（`${データ置き場}/themes`）。置き場を決められなければ undefined。
+
+プラグイン配布と単体配布で、データ置き場の解決（dataDirectory）が同じなので、置き場も同じ場所になる。
+作らずに値を返すだけで、作成は取得（infra/slidev-theme/store.ts）が行う。
+*/
+export declare function themeStoreRoot(): string | undefined;
+/**
+環境変数の値。未設定・空白のみは undefined。
+*/
+export declare function trimmedEnvironment(name: string): string | undefined;
+/**
+プラグイン配布の依存ルート。
+
+`PECOTV_DEPENDENCY_ROOT`（bin/pecotv が渡す実行用ミラー）を優先し、無ければ従来どおり
+`CLAUDE_PLUGIN_ROOT`。同梱アセットの起点はここではなく resolvePluginRoot()。
+*/
+export declare function pluginDependencyRoot(): string | undefined;
+/**
+Chromium 取得のロックと OS ライブラリ確認の印を置くディレクトリ（`${データ置き場}/runtime`）。
+
+bin/pecotv と同じ場所にする。
+依存ルートの node_modules に置くと、ミラーのハードリンク複製で別世代と inode を共有する。
+bin と cli の置き場が食い違うと、確認が毎回実行され、二重取得も起きる。
+求め方は、bin/pecotv が渡す `PECOTV_RUNTIME_DIR`（`runtime/<hash>`）の親。
+undefined を返すのは、`PECOTV_RUNTIME_DIR` の欠落、相対パス、親の不在のとき。
+
+呼び出し側は、従来の依存ルートの node_modules を使う。
+実在しない親では、flock(1) がロックファイルを作れず exit 66 で終わり、印も書けない。
+*/
+export declare function runtimeStateDirectory(): string | undefined;
+/**
+Chromium 取得のロックと OS ライブラリ確認の印を置くディレクトリ。
+
+`${データ置き場}/runtime`（runtimeStateDirectory）を優先する。
+実行用ミラーを使わない場合（開発・単体配布）は、従来どおり依存ルートの node_modules。
+どこにも無ければ undefined。
+*/
+export declare function stateFileDirectory(): string | undefined;
+/**
+実行中のミラー（`PECOTV_RUNTIME_DIR`。bin/pecotv が渡す `runtime/<hash>`）。無ければ undefined。
+
+lint のテンプレートなど、cli 自身と同じ版で揃えたいものの起点に使う。`PECOTV_DEPENDENCY_ROOT`
+（`runtime/current`）は別セッションが切り替えた新版を指すので使わない。
+*/
+export declare function runningMirrorDirectory(): string | undefined;
+/**
+依存を探すルートを優先順に返す。プラグイン配布 → 永続層の順。
+
+返すのは `node_modules` を持つ側のディレクトリで、`node_modules` は付けない。
+`createRequire` の基準点にも npm の `--prefix` にも、この形で渡すため。
+プラグイン配布を先に見るのは、永続層が併存していても、従来どおり同梱の依存を使うため。
+*/
+export declare function dependencyRoots(): readonly string[];
+/**
+実在する依存ルートの `node_modules`（env 由来のプラグインルート → 永続層の順）。
+*/
+export declare function existingDependencyNodeModules(): string | undefined;
+/**
+talk-dir から張る `node_modules` symlink の実体を解決する。
+
+依存ルートは env ではなく引数で受ける。
+create / sync は deps 経由で依存ルートを受け取っており、その値と食い違わせないため。
+依存ルートは PECOTV_DEPENDENCY_ROOT で、無ければプラグインルート。
+
+判定は `node_modules` の実在ではなく、代表パッケージ（RUNTIME_DEPENDENCY_PROBES）が
+その `node_modules` 配下から引けるかで行う。
+areRuntimeDependenciesInstalled と基準を揃え、次の食い違いを避ける。
+npm が版衝突で `<配布パッケージ>/node_modules` を掘った場合に、
+symlink は依存を含まないツリーを指すのに、setup は永続層へ install する状態になる。
+*/
+export declare function resolveTalkDirectoryNodeModules(dependencyRoot: string): string | undefined;
+/**
+`specifier` を依存ルート起点で解決する。解決できなければ undefined。
+
+`fromUrl`（呼び出し元モジュールの `import.meta.url`）を先に試す。
+プラグイン配布と開発時の hoist 構成で、従来どおりの解決結果を保つため。
+そこで見つからないときだけ依存ルートへ降りる。
+*/
+export declare function resolveDependency(specifier: string, fromUrl?: string): string | undefined;
+/**
+実行時依存が引けないときに利用者へ示す回復手段。
+
+配布形態ごとに手段が違うため、両方を並べる。
+呼び出し元は、自分がどちらの配布形態かを判定しない。
+判定できるのは依存ルートの実在だけで、配布形態そのものではない。
+*/
+export declare const DEPENDENCY_RECOVERY_HINT: string;
+/**
+実行時依存が揃っているかの判定に使う specifier。
+
+`package.json` を引くのは、exports を経由せずにパッケージの実在だけを見るため。
+`@slidev/cli` は bin を exports に載せていない。
+
+`@slidev/client` を含めるのは、talk-dir の symlink 先としての妥当性も同じ集合で見るため
+（resolveTalkDirectoryNodeModules）。
+slidev build はこの `node_modules` から client を引くので、client を欠くツリーは依存ルートとして使えない。
+*/
+export declare const RUNTIME_DEPENDENCY_PROBES: readonly string[];
+/**
+永続層の install stamp のパス。場所を決められなければ undefined。
+*/
+export declare function runtimeInstallStampPath(): string | undefined;
+/**
+実行時依存が解決できる状態か。
+
+同梱依存（プラグイン配布）を先に見る。
+本モジュール自身の位置も基準に含めるのは、CLAUDE_PLUGIN_ROOT が立っていなくても、同梱の node_modules から引けるため。
+env の有無で「未取得」と誤判定して、`setup` が 600MB の npm install を始めるのを防ぐ。
+単体配布では、本モジュールは `_npx/<hash>/node_modules/<pkg>/cli/dist/infra/_shared/` にある。
+隣の node_modules には起動層しか無いので、この基準では解決できず永続層へ降りる。
+
+永続層は版を持たない固定パス（`${データ置き場}/mcp-dist`）なので、解決可否だけでは、
+「前の版で取得したツリーが残っているだけ」を取得済みと誤判定する。
+`expectedStamp`（install 対象の内容から導く印）を渡すと、永続層に記録された stamp と一致するときだけ取得済みとみなす。
+同梱依存はプラグイン本体と一緒に版が動くため、stamp を見ない。
+*/
+export declare function areRuntimeDependenciesInstalled(expectedStamp?: string): boolean;
+/**
+同梱依存（プラグイン配布）から実行時依存が全て引けるか。
+*/
+export declare function areBundledDependenciesResolvable(): boolean;
+/**
+永続層に、期待する内容で取得した実体が揃っているか。
+
+`expectedStamp` を省略すると解決可否だけを見る（版の同一性は問わない）。
+*/
+export declare function isRuntimeLayerInstalled(expectedStamp?: string): boolean;
+//# sourceMappingURL=dependency-root.d.ts.map