niceeval 0.2.1 → 0.3.0

package/src/view/index.ts

@@ -2,9 +2,10 @@
 // 读取/版本判定在 loader.ts,聚合在 aggregate.ts,HTTP 与 HTML 烘焙在 server.ts,
 // server/前端共用的折叠口径、格式化与数据形状在 shared/。
 
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, resolve } from "node:path";
-import { loadSummaries } from "./loader.ts";
+import { copyFile, mkdir, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { loadSummaries, type ScanResult } from "./loader.ts";
 import { renderHtml, type ViewOptions } from "./server.ts";
 
 export { startViewServer, type ViewOptions, type ViewServer } from "./server.ts";
@@ -19,11 +20,45 @@ export {
   type SkippedRun,
 } from "./loader.ts";
 
-/** 导出静态 HTML 报告(--out):一次性把当前结果烘焙进单个可分享文件。 */
+/** --out 目标是单文件(*.html)还是目录式静态导出;CLI 的提示文案也按这个口径分。 */
+export function isSingleFileOut(out: string): boolean {
+  return /\.html?$/i.test(out);
+}
+
+/**
+ * 导出静态报告(--out)。两种形态:
+ * - `--out report.html`:单个可分享 HTML。榜单/断言/检查自包含;代码视图、transcript、
+ *   trace 依赖工件文件,单文件带不动(diff/trace 可达上百 MB),静态托管时优雅降级。
+ * - `--out <dir>`:目录式静态导出。写 <dir>/index.html,并把前端会 fetch 的工件
+ *   (sources.json / events.json / trace.json)复制到 <dir>/artifact/<base>/——与本地
+ *   server 的 /artifact/<rel> 路由同一布局,整个目录扔给任何静态托管即是完整体验。
+ */
 export async function buildView(opts: ViewOptions = {}): Promise<string> {
   const scan = await loadSummaries(opts.input);
   const out = resolve(opts.out ?? ".niceeval/report.html");
-  await mkdir(dirname(out), { recursive: true });
-  await writeFile(out, await renderHtml(scan), "utf-8");
+  if (isSingleFileOut(out)) {
+    await mkdir(dirname(out), { recursive: true });
+    await writeFile(out, await renderHtml(scan), "utf-8");
+    return out;
+  }
+  await mkdir(out, { recursive: true });
+  await writeFile(join(out, "index.html"), await renderHtml(scan), "utf-8");
+  await copyFetchedArtifacts(scan, join(out, "artifact"));
   return out;
 }
+
+// 只复制前端会 fetch 的三类工件。diff.json / o11y.json 是运行侧产物,查看器从不读取,
+// 且 diff 可达上百 MB,带进静态导出只会拖垮部署体积。
+const FETCHED_ARTIFACTS = ["sources.json", "events.json", "trace.json"];
+
+async function copyFetchedArtifacts(scan: ScanResult, artifactRoot: string): Promise<void> {
+  for (const [base, srcDir] of scan.artifactDirs) {
+    const destDir = join(artifactRoot, base);
+    // 输入本身已经是导出布局(比如对着上次导出的目录重新生成 index.html)时不自拷。
+    if (resolve(srcDir) === resolve(destDir)) continue;
+    const files = FETCHED_ARTIFACTS.filter((name) => existsSync(join(srcDir, name)));
+    if (!files.length) continue;
+    await mkdir(destDir, { recursive: true });
+    await Promise.all(files.map((name) => copyFile(join(srcDir, name), join(destDir, name))));
+  }
+}

package/src/view/server.ts

@@ -37,6 +37,13 @@ export async function startViewServer(opts: ViewOptions = {}): Promise<ViewServe
         return;
       }
       // 按需提供拆分工件(trace.json / events.json / …),前端展开时 fetch。
+      // 路径式 /artifact/<rel> 与目录式静态导出的文件布局一致(见 view/index.ts 的 buildView),
+      // 同一份前端产物在本地 server 和静态托管上用同一个相对 URL。
+      if (url.pathname.startsWith("/artifact/")) {
+        await serveArtifact(root, decodeURIComponent(url.pathname.slice("/artifact/".length)), res);
+        return;
+      }
+      // 兼容旧的 query 形式(0.2.x 前端烘焙的 HTML 可能还开着)。
       if (url.pathname === "/artifact") {
         await serveArtifact(root, url.searchParams.get("p") ?? "", res);
         return;