@ait-co/devtools 0.1.143 → 0.2.0

package/dist/unplugin/index.d.ts

@@ -1,16 +1,14 @@
 /// <reference types="node" />
 import { URL as URL$1 } from "node:url";
 import * as _$unplugin from "unplugin";
+import * as fs from "node:fs";
 import * as http from "node:http";
 import { Agent, ClientRequest, ClientRequestArgs, OutgoingHttpHeaders } from "node:http";
-import * as fs from "node:fs";
 import { Http2SecureServer } from "node:http2";
 import { EventEmitter } from "node:events";
 import { Server as Server$1, ServerOptions as ServerOptions$1 } from "node:https";
 import * as net from "node:net";
 import { Duplex, DuplexOptions, Stream } from "node:stream";
-import * as _$esbuild from "esbuild";
-import esbuild$1 from "esbuild";
 import { SecureContextOptions } from "node:tls";
 import { ZlibOptions } from "node:zlib";
 import DartSass from "sass";
@@ -6326,6 +6324,27 @@ interface TransformOptions$1 extends BindingEnhancedTransformOptions {}
 * @category Utilities
 */
 //#endregion
+//#region node_modules/.pnpm/esbuild@0.28.1/node_modules/esbuild/lib/main.d.ts
+// Note: These declarations exist to avoid type errors when you omit "dom" from
+// "lib" in your "tsconfig.json" file. TypeScript confusingly declares the
+// global "WebAssembly" type in "lib.dom.d.ts" even though it has nothing to do
+// with the browser DOM and is present in many non-browser JavaScript runtimes
+// (e.g. node and deno). Declaring it here allows esbuild's API to be used in
+// these scenarios.
+//
+// There's an open issue about getting this problem corrected (although these
+// declarations will need to remain even if this is fixed for backward
+// compatibility with older TypeScript versions):
+//
+//   https://github.com/microsoft/TypeScript-DOM-lib-generator/issues/826
+//
+declare global {
+  namespace WebAssembly {
+    interface Module {}
+  }
+  interface URL {}
+}
+//#endregion
 //#region node_modules/.pnpm/vite@8.0.16_@types+node@25.6.0_esbuild@0.28.1_jiti@2.6.1_terser@5.46.1_tsx@4.22.4_yaml@2.8.3/node_modules/vite/types/internal/esbuildOptions.d.ts
 /* eslint-enable @typescript-eslint/ban-ts-comment */
 type EsbuildTarget = string | string[];
@@ -10257,13 +10276,19 @@ interface AitDevtoolsOptions {
    *
    * true이면 진입점에 게이트된 dynamic import를 자동 추가한다:
    * `?debug=1` + `relay` URL 파라미터가 모두 존재할 때만 런타임에
-   * `@ait-co/devtools/in-app`을 로드하고 `maybeAttach()`를 호출한다.
+   * `@ait-co/debug-console`을 로드하고 `maybeAttach()`를 호출한다.
    *
    * gate가 통과하지 못하면 chunk 자체를 로드하지 않으므로 일반 production
    * 로드에서 dormant하고, 번들러의 DCE 대상이 된다.
    *
+   * `@ait-co/debug-console`은 **optional peer**다 (#817). 설치돼 있지 않으면
+   * 주입 자체를 하지 않으므로 attach 코드가 번들에 구조적으로 들어갈 수 없다 —
+   * 이게 디버그 표면 보안 스코프의 기술적 강제 지점이다. 환경 1(브라우저 mock)만
+   * 쓰는 소비자는 아무것도 추가로 설치하지 않아도 된다.
+   *
    * 소비자가 이미 직접 배선한 경우 중복 주입을 방지하기 위해 파일에
-   * `@ait-co/devtools/in-app`이 이미 있으면 자동으로 스킵한다.
+   * `@ait-co/debug-console`(또는 분리 전 `@ait-co/devtools/in-app`)이 이미 있으면
+   * 자동으로 스킵한다.
    */
   inApp?: boolean;
   /**
@@ -10329,6 +10354,10 @@ interface AitDevtoolsOptions {
      * AI host MCP가 그 relay에 client로 붙으면 실기기 WebKit 위에서 CDP 디버깅이 열린다.
      * mock SDK는 그대로라 `call_sdk`는 환경 2에서 mock을 친다 (fidelity 사다리의
      * 설계 의도 — SDK fidelity가 필요하면 환경 3로 올라간다).
+     *
+     * 이 경로는 **optional peer `@ait-co/debugger`**를 요구한다 (#817).
+     * 미설치면 CDP 배선을 건너뛰고 일반 화면 미리보기 터널로 degrade하며,
+     * 설치 안내를 한 번 출력한다.
      */
     cdp?: boolean;
   };
@@ -10356,7 +10385,7 @@ declare const aitDevtoolsPlugin: _$unplugin.UnpluginInstance<AitDevtoolsOptions
 declare const vite: (options?: AitDevtoolsOptions | undefined) => Plugin<any> | Plugin<any>[];
 declare const webpack: (options?: AitDevtoolsOptions | undefined) => WebpackPluginInstance;
 declare const rollup: (options?: AitDevtoolsOptions | undefined) => _$unplugin.RollupPlugin<any> | _$unplugin.RollupPlugin<any>[];
-declare const esbuild: (options?: AitDevtoolsOptions | undefined) => _$esbuild.Plugin;
+declare const esbuild: (options?: AitDevtoolsOptions | undefined) => _$unplugin.EsbuildPlugin;
 declare const rspack: (options?: AitDevtoolsOptions | undefined) => RspackPluginInstance;
 //#endregion
 export { AitDevtoolsOptions, aitDevtoolsPlugin as default, esbuild, resolveTunnelOption, rollup, rspack, vite, webpack };