weapp-vite 7.3.0 → 7.5.0

package/dist/doctor.d.mts

@@ -0,0 +1,144 @@
+import { Xn as MpPlatform } from "./config-V0L-IAJf.mjs";
+import { i as AnalyzeBudgetConfig } from "./budget-BD7VqLCl.mjs";
+import { OperationDiagnostics } from "@weapp-vite/miniprogram-automator";
+//#region src/doctor/types.d.ts
+type DoctorLayer = 'project' | 'source' | 'artifact' | 'runtime';
+interface DoctorCoverage {
+  target: string;
+  layer: DoctorLayer;
+  check: string;
+  status: 'complete' | 'incomplete' | 'not-requested';
+  reason?: string;
+}
+interface DoctorDiagnostic {
+  ruleId: string;
+  target: string;
+  layer: DoctorLayer;
+  severity: 'error' | 'warning';
+  message: string;
+  location?: {
+    file: string;
+    line?: number;
+    column?: number;
+  };
+  evidence: {
+    expected: string;
+    actual: string;
+  };
+  responsibility: {
+    owner: 'project' | 'framework' | 'platform' | 'unknown';
+    confidence: 'confirmed' | 'suspected';
+  };
+  suggestion: string;
+  fingerprint: string;
+}
+interface DoctorFile {
+  path: string;
+  size: number;
+  sha256: string;
+  text?: string;
+}
+interface DoctorArtifactSnapshot {
+  files: readonly DoctorFile[];
+  origin: 'build' | 'existing';
+  capturedAt: string;
+  /** 既有目录只证明当前字节，不证明来自当前源码。 */
+  freshness: 'current-build' | 'unverified';
+  budgets?: AnalyzeBudgetConfig;
+  /** 相对项目目录的实际编译源码目录。 */
+  sourceRoot?: string;
+  /** 相对项目目录的本轮输出目录。 */
+  outputRoot?: string;
+  limitations?: readonly string[];
+}
+interface DoctorRuntimeEvidence {
+  host: string;
+  deviceSystem?: string;
+  route: string;
+  provider: string;
+  checks: readonly string[];
+  /** false 表示已有部分事实，但请求的运行时探针没有全部完成。 */
+  complete?: boolean;
+  facts?: readonly DoctorRuntimeFact[];
+  bundle?: DoctorRuntimeBundle;
+}
+type DoctorRuntimeStage = 'cli-executable' | 'service-listener' | 'login-query' | 'login-state' | 'project-connection' | 'tool-info' | 'host-version' | 'sdk-version' | 'current-page' | 'session-release';
+interface DoctorRuntimeFact {
+  stage: DoctorRuntimeStage;
+  status: 'passed' | 'failed' | 'unknown' | 'not-run';
+  code: string;
+}
+interface DoctorRuntimeProbeOptions {
+  /** 所有已请求探针的总预算，包含本次连接清理。 */
+  timeout?: number;
+  signal?: AbortSignal;
+  /** 只读检查的显式 CLI；仅 login 为 true 时执行原生查询。 */
+  cliPath?: string;
+  /** 显式允许原生 islogin，可能启动 IDE，必须同时指定 cliPath。 */
+  login?: boolean;
+  /** 只检查指定回环 TCP 端口，不据此认定监听者是微信 IDE。 */
+  servicePort?: number;
+}
+interface DoctorRuntimeBundle {
+  /** 仅含固定阶段、预算与资源类别，不包含原始错误文本。 */
+  operation?: OperationDiagnostics;
+  frameworkVersion: string;
+  nodeVersion: string;
+  versions: {
+    ide?: string;
+    sdk?: string;
+  };
+  configuration: {
+    target: string;
+    provider: string;
+    explicitCli: boolean;
+    explicitAutomatorPort: boolean;
+    explicitServicePort: boolean;
+    loginRequested: boolean;
+  };
+  lastSuccessfulStage?: DoctorRuntimeStage;
+  /** 只记录固定阶段与分类，不包含宿主原始输出、凭据或源码。 */
+  events: readonly DoctorRuntimeFact[];
+  reproduction: string;
+}
+interface DoctorReport {
+  schemaVersion: 1;
+  generatedAt: string;
+  targets: string[];
+  coverage: DoctorCoverage[];
+  diagnostics: DoctorDiagnostic[];
+  artifacts: Record<string, Omit<DoctorArtifactSnapshot, 'files'> & {
+    files: Array<Omit<DoctorFile, 'text'>>;
+  }>;
+  runtime: Record<string, DoctorRuntimeEvidence>;
+  exitCode: 0 | 1 | 2;
+}
+interface DoctorOptions {
+  cwd?: string;
+  targets?: readonly string[];
+  /** 静态检查的显式源码目录；不执行配置推断。 */
+  source?: string;
+  artifact?: string;
+  build?: boolean;
+  runtime?: boolean;
+  /** 连接已有 automator 会话的端口；省略时使用项目派生端口。 */
+  runtimePort?: number;
+  runtimeCliPath?: string;
+  runtimeLogin?: boolean;
+  runtimeServicePort?: number;
+  configFile?: string;
+  onBuildLog?: (text: string) => void;
+}
+interface DoctorAdapters {
+  build: (options: DoctorOptions, target: MpPlatform) => Promise<DoctorArtifactSnapshot>;
+  runtime: (cwd: string, target: MpPlatform, port?: number, options?: DoctorRuntimeProbeOptions) => Promise<DoctorRuntimeEvidence>;
+}
+//#endregion
+//#region src/doctor/report.d.ts
+export declare function formatDoctorReport(report: DoctorReport, format?: 'terminal' | 'json' | 'sarif'): string;
+//#endregion
+//#region src/doctor/index.d.ts
+/** 分层收集事实；静态路径永不调用配置加载器、构建或宿主连接。 */
+export declare function runDoctor(options?: DoctorOptions, adapters?: Partial<DoctorAdapters>): Promise<DoctorReport>;
+//#endregion
+export type { DoctorAdapters, DoctorArtifactSnapshot, DoctorCoverage, DoctorDiagnostic, DoctorFile, DoctorLayer, DoctorOptions, DoctorReport, DoctorRuntimeBundle, DoctorRuntimeEvidence, DoctorRuntimeFact, DoctorRuntimeProbeOptions, DoctorRuntimeStage };