@morlay/dsh-client-modules 0.2.11-alpha.3 → 0.2.11

package/src/client-meta.ts

@@ -0,0 +1,128 @@
+/**
+ * 浏览器构建里烘焙的版本元数据。
+ *
+ * 上游的 client 构建（`scripts/client-build-environment.ts`）把一组 `DSH_CLIENT_*` 值当 `define` 注入产物：
+ * - `DSH_CLIENT_VERSION`：设置页「当前版本」那一行；
+ * - `DSH_CLIENT_COMMIT_HASH` + `DSH_CLIENT_GIT_DIRTY`：侧栏显示的 `<commit>` / `<commit>-dirty`；
+ * - `DSH_CLIENT_BUILD_PROFILE`：`official` / `local`（官方品牌只在 official 下出现）。
+ *
+ * 这条链以前把 `process.env` 整个替换成 `{ env: {} }`，于是这些值全是 `undefined`：版本行不显示、
+ * `ui-settings-account` 还会因为 `DSH_CLIENT_VERSION` 缺失直接抛错。取值顺序（越靠前越权威）：
+ *
+ * 1. 宿主进程的 `DSH_CLIENT_*`（`dshdev` 与桌面壳在起宿主时注入）；
+ * 2. 仓库根的 `.dsh-build/client-build-environment.json`（`just prepare` 里的 `dshdev client-meta` 写）；
+ * 3. 现算：仓库根的 `package.json` 版本 + `git rev-parse` / `git status`（dev 常见，代价是几次 git 调用）。
+ */
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+
+/** 一份构建元数据；缺项表示该值不可得（前端自己会判 `undefined`）。 */
+export interface ClientBuildMeta {
+  readonly version?: string;
+  readonly commit?: string;
+  readonly dirty?: boolean;
+  /** `DSH_CLIENT_BUILD_PROFILE`：`official` / `local`，由上游的构建环境定义，缺了就不注入。 */
+  readonly profile?: string;
+}
+
+/** `prepare` 写、构建读的那份记录（形状与上游 `client-build-environment.json` 一致）。 */
+export const CLIENT_BUILD_RECORD = join(".dsh-build", "client-build-environment.json");
+
+const VERSION = "DSH_CLIENT_VERSION";
+const COMMIT = "DSH_CLIENT_COMMIT_HASH";
+const DIRTY = "DSH_CLIENT_GIT_DIRTY";
+const PROFILE = "DSH_CLIENT_BUILD_PROFILE";
+
+/** 环境里那组 `DSH_CLIENT_*` → 元数据。 */
+function metaOfEnvironment(environment: NodeJS.ProcessEnv): ClientBuildMeta {
+  const version = environment[VERSION];
+  const commit = environment[COMMIT];
+  const dirty = environment[DIRTY];
+  const profile = environment[PROFILE];
+  return {
+    ...(version === undefined || version === "" ? {} : { version }),
+    ...(commit === undefined || commit === "" ? {} : { commit }),
+    ...(dirty === "true" ? { dirty: true } : {}),
+    ...(profile === undefined || profile === "" ? {} : { profile }),
+  };
+}
+
+const runFile = promisify(execFile);
+
+/** `git` 的输出；不在 git 工作树里、或 git 不可用时 undefined。 */
+async function gitOutput(root: string, args: readonly string[]): Promise<string | undefined> {
+  try {
+    const { stdout } = await runFile("git", args, { cwd: root, encoding: "utf8" });
+    return stdout.trim();
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * 现算：**装的是哪一版 harness**（`DEEPSEEK_HARNESS_VERSION`，与同步链同一个真源）+ 本仓库的 git 元数据。
+ *
+ * 正常路径拿不到这里：`dshdev` 会注入环境、`prepare` 会写记录。只有"绕过 dshdev 直接构建 client 产物"
+ * 时才走到，所以版本只能取环境或仓库根的 `package.json`（后者不是权威值，缺 env 时用它兜底）。
+ */
+async function computeMeta(repoRoot: string): Promise<ClientBuildMeta> {
+  const explicit = process.env["DEEPSEEK_HARNESS_VERSION"];
+  let version: string | undefined = explicit === undefined || explicit === "" ? undefined : explicit;
+  if (version === undefined) {
+    const manifest = await readFile(join(repoRoot, "package.json"), "utf8").catch(() => undefined);
+    if (manifest !== undefined) {
+      const parsed = JSON.parse(manifest) as { version?: unknown };
+      if (typeof parsed.version === "string" && parsed.version !== "") version = parsed.version;
+    }
+  }
+  const commit = await gitOutput(repoRoot, ["rev-parse", "--short=7", "HEAD"]);
+  const status = await gitOutput(repoRoot, ["status", "--porcelain", "--untracked-files=normal"]);
+  return {
+    ...(version === undefined ? {} : { version }),
+    ...(commit === undefined ? {} : { commit }),
+    ...(status === undefined || status === "" ? {} : { dirty: true }),
+  };
+}
+
+/** 读 `prepare` 写下的那份记录（缺失 / 坏掉都给 undefined，不挡构建）。 */
+async function recordedMeta(repoRoot: string): Promise<ClientBuildMeta | undefined> {
+  const raw = await readFile(join(repoRoot, CLIENT_BUILD_RECORD), "utf8").catch(() => undefined);
+  if (raw === undefined) return undefined;
+  try {
+    const parsed = JSON.parse(raw) as { environment?: Record<string, string> };
+    const environment = parsed.environment ?? {};
+    return metaOfEnvironment(environment as NodeJS.ProcessEnv);
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * 这个仓库在浏览器产物里该带的版本元数据。
+ * @param repoRoot - 仓库根（dev 是工作区，打包形态是 profile：那里通常读不到记录，靠宿主注入的环境）。
+ */
+export async function clientBuildMeta(repoRoot: string): Promise<ClientBuildMeta> {
+  const inherited = metaOfEnvironment(process.env);
+  if (inherited.version !== undefined && inherited.commit !== undefined) return inherited;
+  const recorded = await recordedMeta(repoRoot);
+  const computed = recorded ?? (await computeMeta(repoRoot));
+  return { ...computed, ...inherited };
+}
+
+/**
+ * `define` 用的一组键：`process.env.DSH_CLIENT_*` → 字面量。
+ *
+ * `browserProcessPlugin` 会跳过这些键（见那里的负向前瞻），所以 define 这一层能把它们换成真实值；
+ * 其余 `process.env` 仍是空壳对象。
+ */
+export function clientMetaDefines(meta: ClientBuildMeta): Record<string, string> {
+  return {
+    [`process.env.${VERSION}`]: meta.version === undefined ? "undefined" : JSON.stringify(meta.version),
+    [`process.env.${COMMIT}`]: meta.commit === undefined ? "undefined" : JSON.stringify(meta.commit),
+    [`process.env.${DIRTY}`]: meta.dirty === true ? JSON.stringify("true") : "undefined",
+    // 官方品牌（`ui-brand-official`）按这个值判断：值也来自上游的构建环境，缺了就不注入。
+    [`process.env.${PROFILE}`]: meta.profile === undefined ? "undefined" : JSON.stringify(meta.profile),
+  };
+}

package/src/index.ts

@@ -398,6 +398,10 @@ export function apply(ctx: Context): void {
   ): Promise<string | undefined> => {
     // `@/…` 是本地文件（alias 管），不是包——`packageNameOf` 会把它切成 `@/vendor` 这种假包名。
     if (specifier.startsWith("@/")) return undefined;
+    // 样式引用交给 vite 的 CSS 管线内联：改写成联邦 URL 会让浏览器把 `text/css` 当 ESM 模块加载
+    // （`Failed to load module script: … MIME type "text/css"`）。联邦构建那侧有对应的内联（见
+    // `dsh-css-specifiers`）。
+    if (specifier.endsWith(".css")) return undefined;
     // `zlib` / `stream` 这类**裸名的 node 内置**不是包：接管成联邦地址只会换来一串 404。留给 alias
     // 的替身（名单同一份）。
     if (NODE_BUILTIN.test(specifier)) return undefined;
@@ -579,8 +583,11 @@ export function apply(ctx: Context): void {
     // **不发 304**：这边的响应最终要由上游包成 Fetch `Response`，而它不接受 304
     // （`Invalid response status code 304`）——请求会以异常告终。产物本来就不大，直接 200 全量。
     const etag = `"${bundled.rev}"`;
+    // 产物类型由文件扩展名决定：CSS 出口就是 CSS 文本，其余是 JS 模块。
+    const extension = target.slice(target.lastIndexOf(".") + 1).toLowerCase();
     res.writeHead(200, {
-      "content-type": "text/javascript; charset=utf-8",
+      "content-type":
+        extension === "css" ? "text/css; charset=utf-8" : "text/javascript; charset=utf-8",
       "cache-control": cacheControl,
       etag,
     });

package/src/resolve.ts

@@ -268,7 +268,8 @@ export async function exportTargetOf(
     // `exports` 的三种形状（都要认）：
     // · 以 `.` 开头的键映射（标准）→ 取 `exports["."]` / `exports["./sub"]`；
     // · **条件对象本身**（`{ development, default }`，`mdast-util-*` 就是这形状）→ 它**就是**根出口；
-    // · 没有 `exports` → 按 node 规则退回 `module` → `main`（老包如 `fortune-sheet`）。
+    // · 没有 `exports` → 打包器约定：`module`（ESM）→ `main`。有 ESM 就走 ESM，不把双形态包
+    //   降级成 CJS 再来适配（`rrule` / `@xterm/xterm` 的 `module` 都是它们的 ESM 面）。
     const table = manifest.exports;
     const isSubpathMap =
       table !== undefined &&

package/src/serve-vite.ts

@@ -11,7 +11,8 @@ import { fileURLToPath } from "node:url";
 import type { Context } from "@deepseek-ai/cordis";
 import { traceOf } from "./trace.ts";
 import { createServer, type ServerOptions, type ViteDevServer } from "vite";
-import { clientModulesAlias } from "./bundle.ts";
+import { browserProcessPlugin, clientModulesAlias } from "./bundle.ts";
+import { clientBuildMeta } from "./client-meta.ts";
 import { dshClientRowsPlugin, ROWS_VIRTUAL } from "./vite-plugin.ts";
 import { packageRootOf } from "./resolve.ts";
 
@@ -93,11 +94,9 @@ export async function startViteDev(
     // **不要**把 base 改成 `/@/` 去"统一前缀"：vite 会给所有不以 base 开头的绝对 URL 再补一层，
     // 联邦地址（`/@client-modules/…`）会变成 `/@/@client-modules/…`，两条链全断。
     base: "/",
-    // 浏览器没有 `process`：客户端半常读 `process.env.NODE_ENV`（上游 client 打包也做同样的替换）。
+    // 浏览器没有 `process`：裸 `process` 给空壳（逐文件服务的源码里会读它）。`process.env` 与版本元数据
+    // （`DSH_CLIENT_*`）由 `browserProcessPlugin` 处理——与联邦构建同一份规则，顺序只写在一处。
     define: {
-      "process.env.NODE_ENV": JSON.stringify(process.env["NODE_ENV"] ?? "development"),
-      "process.env": "{ env: {} }",
-      // 裸 `process` 同样要给空壳（逐文件服务的源码里也会读它）。
       process: "{ env: {} }",
     },
     publicDir: false,
@@ -151,6 +150,8 @@ export async function startViteDev(
     // 官方口径的"整个关掉"就是这两个字段（`optimizeDeps.disabled` 在 Vite 5.1 已移除，传它只会换来一条告警）。
     optimizeDeps: { noDiscovery: true, include: [] },
     plugins: [
+      // 与联邦构建同一份 `process.env` 处理（含 `DSH_CLIENT_*` 的版本元数据）。
+      browserProcessPlugin(await clientBuildMeta(repoRoot)),
       dshClientRowsPlugin({
         repoRoot,
         rows: () => rowsOf(options.rows),