@apps-in-toss/devtools 3.0.2

package/dist/unplugin/index.d.cts

@@ -0,0 +1,140 @@
+//#region src/unplugin/index.d.ts
+/**
+ * @apps-in-toss/devtools unplugin
+ *
+ * 모든 주요 번들러를 지원하는 단일 플러그인.
+ * @apps-in-toss/web-framework → @apps-in-toss/devtools/mock 으로 alias 설정.
+ *
+ * Usage:
+ *   import aitDevtools from '@apps-in-toss/devtools/unplugin';
+ *
+ *   // Vite
+ *   export default { plugins: [aitDevtools.vite()] };
+ *
+ *   // Webpack / Next.js
+ *   config.plugins.push(aitDevtools.webpack());
+ *
+ *   // Rspack
+ *   config.plugins.push(aitDevtools.rspack());
+ *
+ *   // esbuild
+ *   { plugins: [aitDevtools.esbuild()] }
+ *
+ *   // Rollup
+ *   { plugins: [aitDevtools.rollup()] }
+ */
+type SdkVersionSelection = "auto" | "2" | "3";
+/** Resolve the consumer project's installed SDK major without importing it. */
+declare function detectInstalledSdkMajor(cwd?: string): "2" | "3" | null;
+interface AitDevtoolsOptions {
+  /**
+   * 패널 자동 주입 여부 (default: true)
+   * true이면 진입점에 floating panel import를 자동 추가한다.
+   */
+  panel?: boolean;
+  /** web-framework facade selection. Auto-detects the consumer SDK by default. */
+  sdkVersion?: SdkVersionSelection;
+  /**
+   * mock alias 활성화 여부. default: true (development), false (production)
+   */
+  mock?: boolean;
+  /**
+   * Vite dev server에 MCP state endpoint를 추가할지 여부 (default: false).
+   *
+   * `true`로 설정하면:
+   *  - GET  /api/ait-devtools/state  — 마지막으로 브라우저가 push한 mock state 스냅샷 반환
+   *  - POST /api/ait-devtools/state  — 브라우저 panel이 상태 변경 시 자동 push (panel 내부 처리)
+   *
+   * 이 endpoint는 이 패키지가 여는 producer 쪽이고, MCP 서버 등 외부 도구가
+   * GET으로 읽어 AI 에이전트에 mock state를 노출할 수 있다.
+   * Vite 전용: webpack/rspack/esbuild/rollup 환경에서는 무시된다.
+   */
+  mcp?: boolean;
+  /**
+   * 미니앱의 webViewType (`granite.config.ts`의 `webViewProps.type`)을 빌드 상수
+   * `__WEB_VIEW_TYPE__`로 주입한다 (#580). **Vite 전용** (다른 번들러는 무시).
+   *
+   * 미지정 시 `'partner'`(web-framework `webViewProps.type`의 `@default`)로 주입한다.
+   * `game`이면 게임 모드로 자동 진입한다. (granite.config.ts를 config 시점에
+   * 자동으로 읽는 것은 TS 모듈 로더가 필요해 보류 — 명시 옵션으로 신뢰성 확보, #580.)
+   */
+  webViewType?: "partner" | "game";
+  /**
+   * 미니앱의 `granite.config.ts` `navigationBar.transparentBackground` 값
+   * (SDK `@apps-in-toss/plugins@2.8.0` 신규 필드, #587). `true`이면 env-2 launcher
+   * deep-link에 `&navBarTransparent=1`을 주입해 launcher partner bar가 투명 배경으로
+   * 렌더된다. granite.config를 직접 읽지 않는다(version-agnostic, #580 원칙) —
+   * 소비자 vite.config가 `graniteConfig.navigationBar?.transparentBackground`를
+   * import해 이 옵션으로 넘긴다. 미지정 시 주입 안 함(URL 청정, back-compat).
+   */
+  navBarTransparent?: boolean;
+  /**
+   * 미니앱의 `granite.config.ts` `navigationBar.theme` 값
+   * (SDK `@apps-in-toss/plugins@2.8.0` 신규 필드, #587). `'light'` 또는 `'dark'`이면
+   * env-2 launcher deep-link에 `&navBarTheme=<v>`를 주입해 launcher partner bar가
+   * 해당 테마 글자/아이콘 색으로 렌더된다. granite.config를 직접 읽지 않는다
+   * (version-agnostic, #580 원칙). 미지정 시 주입 안 함(URL 청정, back-compat).
+   */
+  navBarTheme?: "light" | "dark";
+  /**
+   * Vite dev 서버를 Cloudflare quick tunnel(`*.trycloudflare.com`, 계정 불필요)로
+   * 외부 노출해 실제 폰에서 미리보기. **Vite dev 모드 전용** — production에서는
+   * 터널을 띄우지 않는다 (의도치 않은 노출 방지). 다른 번들러는
+   * 무시. `true`면 기본 동작, 객체로 세부 설정 가능.
+   */
+  tunnel?: boolean | {
+    /** 노출할 포트 (미지정 시 dev 서버가 실제 listen한 포트 자동 감지). */
+    port?: number;
+    /** 터미널 ASCII QR 출력 (default: true). */
+    qr?: boolean;
+  };
+}
+/**
+ * Resolves the effective tunnel option (#425).
+ *
+ * An explicit `tunnel` value (including `false`) always takes priority over
+ * env vars — the `??` operator means `undefined` (= omitted) falls through,
+ * but `false` / `true` / an object are preserved as-is (non-breaking).
+ *
+ * When the option is omitted:
+ * - `AIT_TUNNEL=1` enables the screen-preview tunnel.
+ * - Not set → `false` (disabled).
+ *
+ * Extracted as a pure function so it can be unit-tested without standing up
+ * a full Vite dev server.
+ *
+ * @param explicit - The `tunnel` option as passed by the consumer (or `undefined` when omitted).
+ * @param env - The process environment (injectable for testing).
+ */
+declare function resolveTunnelOption(explicit: AitDevtoolsOptions["tunnel"], env: Record<string, string | undefined>): AitDevtoolsOptions["tunnel"];
+declare const aitDevtoolsPlugin: import("unplugin").UnpluginInstance<AitDevtoolsOptions | undefined, boolean>;
+/**
+ * 번들러 플러그인 팩토리의 반환 타입을 의도적으로 any로 풀어놓아요.
+ *
+ * unplugin의 `UnpluginInstance`를 그대로 노출하면 vite/webpack의 Plugin 타입이
+ * 공개 표면에 실리는데, 소비자 프로젝트와 이 패키지가 서로 다른 vite 타입
+ * 인스턴스를 보는 환경(pnpm·Yarn PnP 모노레포의 가상 패키지)에서는 같은 모양의
+ * Plugin끼리 구조 비교가 일어나 `ts(2321) Excessive stack depth`로 터져요.
+ * 플러그인 핸들은 plugins 배열에 꽂는 용도라 반환 타입을 잃어도 손해가 없어요.
+ */
+type BundlerPluginFactory = (options?: AitDevtoolsOptions) => any;
+interface AitDevtoolsUnplugin {
+  vite: BundlerPluginFactory;
+  webpack: BundlerPluginFactory;
+  rollup: BundlerPluginFactory;
+  esbuild: BundlerPluginFactory;
+  rspack: BundlerPluginFactory;
+  /**
+   * 저수준 unplugin 팩토리예요. 소비자 번들러 설정에서는 쓸 일이 없고,
+   * 이 패키지의 테스트가 훅을 직접 검사할 때 써요.
+   */
+  raw: typeof aitDevtoolsPlugin.raw;
+}
+declare const vite: BundlerPluginFactory;
+declare const webpack: BundlerPluginFactory;
+declare const rollup: BundlerPluginFactory;
+declare const esbuild: BundlerPluginFactory;
+declare const rspack: BundlerPluginFactory;
+declare const aitDevtools: AitDevtoolsUnplugin;
+//#endregion
+export { AitDevtoolsOptions, SdkVersionSelection, aitDevtools as default, detectInstalledSdkMajor, esbuild, resolveTunnelOption, rollup, rspack, vite, webpack };

package/dist/unplugin/index.d.ts

@@ -0,0 +1,140 @@
+//#region src/unplugin/index.d.ts
+/**
+ * @apps-in-toss/devtools unplugin
+ *
+ * 모든 주요 번들러를 지원하는 단일 플러그인.
+ * @apps-in-toss/web-framework → @apps-in-toss/devtools/mock 으로 alias 설정.
+ *
+ * Usage:
+ *   import aitDevtools from '@apps-in-toss/devtools/unplugin';
+ *
+ *   // Vite
+ *   export default { plugins: [aitDevtools.vite()] };
+ *
+ *   // Webpack / Next.js
+ *   config.plugins.push(aitDevtools.webpack());
+ *
+ *   // Rspack
+ *   config.plugins.push(aitDevtools.rspack());
+ *
+ *   // esbuild
+ *   { plugins: [aitDevtools.esbuild()] }
+ *
+ *   // Rollup
+ *   { plugins: [aitDevtools.rollup()] }
+ */
+type SdkVersionSelection = "auto" | "2" | "3";
+/** Resolve the consumer project's installed SDK major without importing it. */
+declare function detectInstalledSdkMajor(cwd?: string): "2" | "3" | null;
+interface AitDevtoolsOptions {
+  /**
+   * 패널 자동 주입 여부 (default: true)
+   * true이면 진입점에 floating panel import를 자동 추가한다.
+   */
+  panel?: boolean;
+  /** web-framework facade selection. Auto-detects the consumer SDK by default. */
+  sdkVersion?: SdkVersionSelection;
+  /**
+   * mock alias 활성화 여부. default: true (development), false (production)
+   */
+  mock?: boolean;
+  /**
+   * Vite dev server에 MCP state endpoint를 추가할지 여부 (default: false).
+   *
+   * `true`로 설정하면:
+   *  - GET  /api/ait-devtools/state  — 마지막으로 브라우저가 push한 mock state 스냅샷 반환
+   *  - POST /api/ait-devtools/state  — 브라우저 panel이 상태 변경 시 자동 push (panel 내부 처리)
+   *
+   * 이 endpoint는 이 패키지가 여는 producer 쪽이고, MCP 서버 등 외부 도구가
+   * GET으로 읽어 AI 에이전트에 mock state를 노출할 수 있다.
+   * Vite 전용: webpack/rspack/esbuild/rollup 환경에서는 무시된다.
+   */
+  mcp?: boolean;
+  /**
+   * 미니앱의 webViewType (`granite.config.ts`의 `webViewProps.type`)을 빌드 상수
+   * `__WEB_VIEW_TYPE__`로 주입한다 (#580). **Vite 전용** (다른 번들러는 무시).
+   *
+   * 미지정 시 `'partner'`(web-framework `webViewProps.type`의 `@default`)로 주입한다.
+   * `game`이면 게임 모드로 자동 진입한다. (granite.config.ts를 config 시점에
+   * 자동으로 읽는 것은 TS 모듈 로더가 필요해 보류 — 명시 옵션으로 신뢰성 확보, #580.)
+   */
+  webViewType?: "partner" | "game";
+  /**
+   * 미니앱의 `granite.config.ts` `navigationBar.transparentBackground` 값
+   * (SDK `@apps-in-toss/plugins@2.8.0` 신규 필드, #587). `true`이면 env-2 launcher
+   * deep-link에 `&navBarTransparent=1`을 주입해 launcher partner bar가 투명 배경으로
+   * 렌더된다. granite.config를 직접 읽지 않는다(version-agnostic, #580 원칙) —
+   * 소비자 vite.config가 `graniteConfig.navigationBar?.transparentBackground`를
+   * import해 이 옵션으로 넘긴다. 미지정 시 주입 안 함(URL 청정, back-compat).
+   */
+  navBarTransparent?: boolean;
+  /**
+   * 미니앱의 `granite.config.ts` `navigationBar.theme` 값
+   * (SDK `@apps-in-toss/plugins@2.8.0` 신규 필드, #587). `'light'` 또는 `'dark'`이면
+   * env-2 launcher deep-link에 `&navBarTheme=<v>`를 주입해 launcher partner bar가
+   * 해당 테마 글자/아이콘 색으로 렌더된다. granite.config를 직접 읽지 않는다
+   * (version-agnostic, #580 원칙). 미지정 시 주입 안 함(URL 청정, back-compat).
+   */
+  navBarTheme?: "light" | "dark";
+  /**
+   * Vite dev 서버를 Cloudflare quick tunnel(`*.trycloudflare.com`, 계정 불필요)로
+   * 외부 노출해 실제 폰에서 미리보기. **Vite dev 모드 전용** — production에서는
+   * 터널을 띄우지 않는다 (의도치 않은 노출 방지). 다른 번들러는
+   * 무시. `true`면 기본 동작, 객체로 세부 설정 가능.
+   */
+  tunnel?: boolean | {
+    /** 노출할 포트 (미지정 시 dev 서버가 실제 listen한 포트 자동 감지). */
+    port?: number;
+    /** 터미널 ASCII QR 출력 (default: true). */
+    qr?: boolean;
+  };
+}
+/**
+ * Resolves the effective tunnel option (#425).
+ *
+ * An explicit `tunnel` value (including `false`) always takes priority over
+ * env vars — the `??` operator means `undefined` (= omitted) falls through,
+ * but `false` / `true` / an object are preserved as-is (non-breaking).
+ *
+ * When the option is omitted:
+ * - `AIT_TUNNEL=1` enables the screen-preview tunnel.
+ * - Not set → `false` (disabled).
+ *
+ * Extracted as a pure function so it can be unit-tested without standing up
+ * a full Vite dev server.
+ *
+ * @param explicit - The `tunnel` option as passed by the consumer (or `undefined` when omitted).
+ * @param env - The process environment (injectable for testing).
+ */
+declare function resolveTunnelOption(explicit: AitDevtoolsOptions["tunnel"], env: Record<string, string | undefined>): AitDevtoolsOptions["tunnel"];
+declare const aitDevtoolsPlugin: import("unplugin").UnpluginInstance<AitDevtoolsOptions | undefined, boolean>;
+/**
+ * 번들러 플러그인 팩토리의 반환 타입을 의도적으로 any로 풀어놓아요.
+ *
+ * unplugin의 `UnpluginInstance`를 그대로 노출하면 vite/webpack의 Plugin 타입이
+ * 공개 표면에 실리는데, 소비자 프로젝트와 이 패키지가 서로 다른 vite 타입
+ * 인스턴스를 보는 환경(pnpm·Yarn PnP 모노레포의 가상 패키지)에서는 같은 모양의
+ * Plugin끼리 구조 비교가 일어나 `ts(2321) Excessive stack depth`로 터져요.
+ * 플러그인 핸들은 plugins 배열에 꽂는 용도라 반환 타입을 잃어도 손해가 없어요.
+ */
+type BundlerPluginFactory = (options?: AitDevtoolsOptions) => any;
+interface AitDevtoolsUnplugin {
+  vite: BundlerPluginFactory;
+  webpack: BundlerPluginFactory;
+  rollup: BundlerPluginFactory;
+  esbuild: BundlerPluginFactory;
+  rspack: BundlerPluginFactory;
+  /**
+   * 저수준 unplugin 팩토리예요. 소비자 번들러 설정에서는 쓸 일이 없고,
+   * 이 패키지의 테스트가 훅을 직접 검사할 때 써요.
+   */
+  raw: typeof aitDevtoolsPlugin.raw;
+}
+declare const vite: BundlerPluginFactory;
+declare const webpack: BundlerPluginFactory;
+declare const rollup: BundlerPluginFactory;
+declare const esbuild: BundlerPluginFactory;
+declare const rspack: BundlerPluginFactory;
+declare const aitDevtools: AitDevtoolsUnplugin;
+//#endregion
+export { AitDevtoolsOptions, SdkVersionSelection, aitDevtools as default, detectInstalledSdkMajor, esbuild, resolveTunnelOption, rollup, rspack, vite, webpack };

package/dist/unplugin/index.js

@@ -0,0 +1,301 @@
+import { createRequire } from "node:module";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { createUnplugin } from "unplugin";
+//#region src/shared/parent-watcher.ts
+/**
+* Shared parent-PID watcher — used by both the MCP debug daemon and the
+* unplugin tunnel path to self-terminate when the parent process (e.g. Claude
+* Code, vite) has died or been reparented without sending SIGTERM/SIGHUP.
+*
+* Intentionally react-free and Node-stdlib-only so this module is safe to
+* import from the MCP daemon bundle (`dist/mcp/cli.js`) without violating the
+* install-graph invariant.
+*/
+/**
+* Returns `true` when the given PID refers to a running process.
+*
+* Uses `process.kill(pid, 0)` — a no-op signal that succeeds when the process
+* exists and we have permission to signal it; throws ESRCH when it doesn't exist.
+*/
+function isPidAlive(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (err) {
+		if (err.code === "EPERM") return true;
+		return false;
+	}
+}
+/**
+* Starts a periodic watcher that detects when the parent process (e.g. Claude
+* Code) has died without sending SIGTERM/SIGHUP, and calls `onOrphaned` so the
+* daemon can self-terminate rather than running as a zombie.
+*
+* Mirrors the `startAttachWatcher` pattern: `setInterval`-based, returns
+* `{ stop(): void }`, injectable deps for testability.
+*
+* @param onOrphaned - Called once when the parent is gone.
+* @param opts.intervalMs   - Poll interval in milliseconds (default 5 000).
+* @param opts.initialPpid  - Parent PID to watch (default `process.ppid`).
+* @param opts.isAlive      - Predicate to test if a PID is running (default `isPidAlive`).
+* @param opts.getPpid      - Supplier of current ppid (default `() => process.ppid`).
+*                            Detects ppid changes as well as death.
+* @param opts.log          - Logger (default `process.stderr.write`).
+*
+* @returns `stop` — call during shutdown to clear the interval.
+*/
+function startParentWatcher(onOrphaned, opts) {
+	const { intervalMs = 5e3, initialPpid = process.ppid, isAlive = isPidAlive, getPpid = () => process.ppid, log = (msg) => process.stderr.write(msg) } = opts ?? {};
+	if (initialPpid <= 1) {
+		log("[ait-debug] parent-pid watcher: no parent to watch (ppid<=1), skipping\n");
+		return { stop() {} };
+	}
+	let fired = false;
+	const handle = setInterval(() => {
+		if (fired) return;
+		const currentPpid = getPpid();
+		if (currentPpid !== initialPpid || !isAlive(initialPpid)) {
+			fired = true;
+			clearInterval(handle);
+			log(`[ait-debug] parent-pid watcher: parent PID ${initialPpid} is gone (currentPpid=${currentPpid}) — shutting down\n`);
+			onOrphaned();
+		}
+	}, intervalMs);
+	return { stop() {
+		clearInterval(handle);
+	} };
+}
+//#endregion
+//#region src/unplugin/index.ts
+/**
+* @apps-in-toss/devtools unplugin
+*
+* 모든 주요 번들러를 지원하는 단일 플러그인.
+* @apps-in-toss/web-framework → @apps-in-toss/devtools/mock 으로 alias 설정.
+*
+* Usage:
+*   import aitDevtools from '@apps-in-toss/devtools/unplugin';
+*
+*   // Vite
+*   export default { plugins: [aitDevtools.vite()] };
+*
+*   // Webpack / Next.js
+*   config.plugins.push(aitDevtools.webpack());
+*
+*   // Rspack
+*   config.plugins.push(aitDevtools.rspack());
+*
+*   // esbuild
+*   { plugins: [aitDevtools.esbuild()] }
+*
+*   // Rollup
+*   { plugins: [aitDevtools.rollup()] }
+*/
+/**
+* Resolve `@apps-in-toss/devtools/mock` to its real file path at plugin-load time.
+*
+* Returning the bare specifier from `resolveId` would stop the bundler from
+* walking node_modules for it — Vite 8+ treats such a non-null string as the
+* final resolved id and serves it via the virtual `/@id/` prefix, which 404s
+* because we don't provide a `load` hook. Resolving to an absolute path here
+* lets every supported bundler load the file the normal way.
+*/
+function resolveMockPath(specifier) {
+	try {
+		return createRequire(resolve(process.cwd(), "package.json")).resolve(specifier);
+	} catch {
+		return specifier;
+	}
+}
+const MOCK_PATH_2X = resolveMockPath("@apps-in-toss/devtools/mock/2x");
+const MOCK_PATH_3X = resolveMockPath("@apps-in-toss/devtools/mock/3x");
+/** Resolve the consumer project's installed SDK major without importing it. */
+function detectInstalledSdkMajor(cwd = process.cwd()) {
+	try {
+		const packageJsonPath = createRequire(resolve(cwd, "package.json")).resolve(`${FRAMEWORK_ID}/package.json`);
+		const version = JSON.parse(readFileSync(packageJsonPath, "utf8")).version;
+		if (version?.startsWith("2.")) return "2";
+		if (version?.startsWith("3.")) return "3";
+	} catch {}
+	return null;
+}
+const FRAMEWORK_ID = "@apps-in-toss/web-framework";
+const BRIDGE_ID = "@apps-in-toss/web-bridge";
+const ANALYTICS_ID = "@apps-in-toss/web-analytics";
+const WEBVIEW_BRIDGE_ID = "@apps-in-toss/webview-bridge";
+/** MCP state endpoint path — browser panel POSTs here, MCP server GETs here */
+const MCP_STATE_PATH = "/api/ait-devtools/state";
+/** Browser runtime opt-in consumed by the panel's state-sync helper. */
+const MCP_ENABLE_SNIPPET = "globalThis.__AIT_DEVTOOLS_MCP_ENABLED__ = true;";
+/**
+* Resolves the effective tunnel option (#425).
+*
+* An explicit `tunnel` value (including `false`) always takes priority over
+* env vars — the `??` operator means `undefined` (= omitted) falls through,
+* but `false` / `true` / an object are preserved as-is (non-breaking).
+*
+* When the option is omitted:
+* - `AIT_TUNNEL=1` enables the screen-preview tunnel.
+* - Not set → `false` (disabled).
+*
+* Extracted as a pure function so it can be unit-tested without standing up
+* a full Vite dev server.
+*
+* @param explicit - The `tunnel` option as passed by the consumer (or `undefined` when omitted).
+* @param env - The process environment (injectable for testing).
+*/
+function resolveTunnelOption(explicit, env) {
+	return explicit ?? !!env.AIT_TUNNEL;
+}
+const aitDevtoolsPlugin = createUnplugin((options) => {
+	const isDev = process.env.NODE_ENV !== "production";
+	const shouldEnable = isDev;
+	const shouldMock = shouldEnable && (options?.mock ?? isDev);
+	const sdkMajor = options?.sdkVersion === "2" || options?.sdkVersion === "3" ? options.sdkVersion : detectInstalledSdkMajor() ?? "3";
+	const shouldPanel = shouldEnable && (options?.panel ?? true);
+	const shouldMcp = shouldEnable && (options?.mcp ?? false);
+	let lastState = null;
+	const tunnelOpt = resolveTunnelOption(options?.tunnel, process.env);
+	const shouldTunnel = isDev && !!tunnelOpt;
+	const webViewType = options?.webViewType ?? "partner";
+	const navBarTransparent = options?.navBarTransparent;
+	const navBarTheme = options?.navBarTheme;
+	const tunnelConfig = typeof tunnelOpt === "object" ? tunnelOpt : {};
+	return {
+		name: "ait-co-devtools",
+		enforce: "pre",
+		resolveId(id) {
+			if (!shouldMock) return null;
+			if (id === FRAMEWORK_ID || id === WEBVIEW_BRIDGE_ID || id === BRIDGE_ID || id === ANALYTICS_ID) {
+				if (id === BRIDGE_ID || id === ANALYTICS_ID) return MOCK_PATH_2X;
+				if (id === WEBVIEW_BRIDGE_ID) return MOCK_PATH_3X;
+				return sdkMajor === "2" ? MOCK_PATH_2X : MOCK_PATH_3X;
+			}
+			return null;
+		},
+		transformInclude(id) {
+			if (!shouldPanel && !shouldMcp) return false;
+			return /\.(tsx?|jsx?)$/.test(id) && /\/(main|index|entry|app)\.[tj]sx?$/i.test(id) && !id.includes("node_modules");
+		},
+		transform(code) {
+			let result = code;
+			let changed = false;
+			if (shouldMcp && !code.includes("__AIT_DEVTOOLS_MCP_ENABLED__")) {
+				result = `${MCP_ENABLE_SNIPPET}\n${result}`;
+				changed = true;
+			}
+			if (shouldPanel && !code.includes("@apps-in-toss/devtools/panel")) {
+				result = `import '@apps-in-toss/devtools/panel';\n${result}`;
+				changed = true;
+			}
+			return changed ? result : null;
+		},
+		vite: {
+			config() {
+				const define = { __WEB_VIEW_TYPE__: JSON.stringify(webViewType) };
+				if (!shouldTunnel) return { define };
+				return {
+					define,
+					server: { allowedHosts: [".trycloudflare.com"] }
+				};
+			},
+			configureServer(server) {
+				if (shouldMcp) server.middlewares.use(MCP_STATE_PATH, (req, res) => {
+					res.setHeader("Access-Control-Allow-Origin", "*");
+					res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+					res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+					if (req.method === "OPTIONS") {
+						res.writeHead(204);
+						res.end();
+						return;
+					}
+					if (req.method === "GET") {
+						if (lastState === null) {
+							res.writeHead(503, { "Content-Type": "application/json" });
+							res.end(JSON.stringify({ error: "No state received yet. Open the app in a browser first." }));
+							return;
+						}
+						res.writeHead(200, { "Content-Type": "application/json" });
+						res.end(lastState);
+						return;
+					}
+					if (req.method === "POST") {
+						const chunks = [];
+						req.on("data", (chunk) => chunks.push(chunk));
+						req.on("end", () => {
+							try {
+								const body = Buffer.concat(chunks).toString("utf-8");
+								JSON.parse(body);
+								lastState = body;
+								res.writeHead(204);
+								res.end();
+							} catch {
+								res.writeHead(400, { "Content-Type": "application/json" });
+								res.end(JSON.stringify({ error: "Invalid JSON" }));
+							}
+						});
+						return;
+					}
+					res.writeHead(405, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "Method not allowed" }));
+				});
+				if (shouldTunnel) {
+					let tunnel = null;
+					let parentWatcher = null;
+					const httpServer = server.httpServer;
+					httpServer?.once("listening", () => {
+						const address = httpServer?.address();
+						const port = tunnelConfig.port ?? (address && typeof address === "object" ? address.port : void 0);
+						if (!port) {
+							console.warn("[@apps-in-toss/devtools] tunnel: could not determine the dev server port; skipping.");
+							return;
+						}
+						import("../tunnel-BvEf1qGV.js").then(async ({ startQuickTunnel, printTunnelBanner }) => {
+							const t = await startQuickTunnel(port);
+							tunnel = t;
+							let tunnelAppName;
+							try {
+								const { readFileSync } = await import("node:fs");
+								const pkgRaw = readFileSync(`${server.config.root}/package.json`, "utf8");
+								const pkg = JSON.parse(pkgRaw);
+								const rawName = typeof pkg.name === "string" ? pkg.name : "";
+								tunnelAppName = (rawName.includes("/") ? rawName.slice(rawName.indexOf("/") + 1) : rawName).trim() || void 0;
+							} catch {}
+							await printTunnelBanner(t.url, {
+								qr: tunnelConfig.qr,
+								name: tunnelAppName,
+								webViewType,
+								navBarTransparent,
+								navBarTheme
+							});
+							parentWatcher = startParentWatcher(() => {
+								cleanup();
+								process.exit(0);
+							});
+						}).catch((err) => {
+							console.warn(`[@apps-in-toss/devtools] tunnel failed to start: ${err instanceof Error ? err.message : String(err)}`);
+						});
+					});
+					const cleanup = () => {
+						parentWatcher?.stop();
+						tunnel?.stop();
+					};
+					httpServer?.once("close", cleanup);
+					process.once("SIGINT", cleanup);
+					process.once("SIGTERM", cleanup);
+					process.once("SIGHUP", cleanup);
+					process.once("exit", cleanup);
+				}
+			}
+		}
+	};
+});
+const vite = aitDevtoolsPlugin.vite;
+const webpack = aitDevtoolsPlugin.webpack;
+const rollup = aitDevtoolsPlugin.rollup;
+const esbuild = aitDevtoolsPlugin.esbuild;
+const rspack = aitDevtoolsPlugin.rspack;
+const aitDevtools = aitDevtoolsPlugin;
+//#endregion
+export { aitDevtools as default, detectInstalledSdkMajor, esbuild, resolveTunnelOption, rollup, rspack, vite, webpack };