@morlay/dsh-client-modules 0.2.9 → 0.2.11-alpha.0

package/dist/client.d.cts

@@ -1,9 +1,7 @@
 import { Context } from "@deepseek-ai/cordis";
-//#region src/client/index.d.ts
 /**
- * 发布 `modules` 服务（上游同名的服务面，见文件头）。
+ * 浏览器侧的根插件。
  *
  * @param ctx - 浏览器侧根上下文。
  */
-export declare function apply(ctx: Context): void;
-//#endregion
+export declare function apply(ctx: Context): void;

package/dist/client.d.mts

@@ -1,9 +1,7 @@
 import { Context } from "@deepseek-ai/cordis";
-//#region src/client/index.d.ts
 /**
- * 发布 `modules` 服务（上游同名的服务面，见文件头）。
+ * 浏览器侧的根插件。
  *
  * @param ctx - 浏览器侧根上下文。
  */
-export declare function apply(ctx: Context): void;
-//#endregion
+export declare function apply(ctx: Context): void;

package/dist/client.mjs

@@ -1,4 +1,5 @@
-//#region src/client/index.ts
+import { apply as apply$1 } from "@morlay/dsh-client-ui-primitives/client";
+// src/client/index.ts
 /** 恒 `undefined` 的可订阅快照（`useSyncExternalStore` 的入参形状）。 */
 const NO_RELEASE_CHANGE = {
 	getSnapshot: () => void 0,
@@ -10,6 +11,7 @@ const NO_RELEASE_CHANGE = {
 * @param ctx - 浏览器侧根上下文。
 */
 function apply(ctx) {
+	apply$1(ctx);
 	ctx.reflect.provide("modules", {
 		entries: {
 			releaseChange: NO_RELEASE_CHANGE,
@@ -52,5 +54,4 @@ function installTerminalRecovery(ctx) {
 		};
 	});
 }
-//#endregion
 export { apply };

package/dist/index.cjs

@@ -8,7 +8,7 @@ let node_crypto = require("node:crypto");
 let _morlay_dsh_cordis_assets_styles = require("@morlay/dsh-cordis-assets/styles");
 let rolldown = require("rolldown");
 let vite = require("vite");
-//#region src/trace.ts
+// src/trace.ts
 /**
 * 诊断细节（逐包预编译、逐请求那一类）的具名 logger。
 *
@@ -29,8 +29,7 @@ function traceOf(ctx, name) {
 		logger.debug(format, ...args);
 	};
 }
-//#endregion
-//#region src/config.ts
+// src/config.ts
 /**
 * dev 形态的分流配置：profile 的 `dsh.dev.exclude` 点名的包**不算开发模块**。
 *
@@ -87,8 +86,7 @@ async function devExcluded(profileDir) {
 function isAggregated(name, patterns) {
 	return patterns.some((pattern) => pattern.test(name));
 }
-//#endregion
-//#region src/resolve.ts
+// src/resolve.ts
 /** 路由前缀（沿用上游的 `/plugins`，页面上不改 URL 形态）。 */
 const PLUGIN_ROUTE = "/plugins";
 /** `@deepseek-ai/dsh-x` → `@deepseek-ai+dsh-x`：包名里的 `/` 在 URL 段里要转义。 */
@@ -343,8 +341,7 @@ async function clientHalfOf(root, subpath) {
 	const conventional = (0, node_path.join)(root, "src", "client", "index.ts");
 	return await exists(conventional) ? conventional : void 0;
 }
-//#endregion
-//#region src/bundle.ts
+// src/bundle.ts
 /**
 * 客户端资源的**联邦式**产出：一个包一份产物，三方的与我们的**没有本质区别**。
 *
@@ -784,8 +781,7 @@ async function packageJsonNear(file) {
 		directory = parent;
 	}
 }
-//#endregion
-//#region src/dirs.ts
+// src/dirs.ts
 /** 本包自己的根（页面的骨架、`node-stub` 与依赖解析的兜底基准都从它推）。 */
 function packageRoot() {
 	return (0, node_path.dirname)((0, node_url.fileURLToPath)(new URL("../package.json", require("url").pathToFileURL(__filename).href)));
@@ -984,8 +980,7 @@ function dshClientRowsPlugin(options) {
 		}
 	};
 }
-//#endregion
-//#region src/serve-vite.ts
+// src/serve-vite.ts
 function rowsOf(source) {
 	return source.rows();
 }
@@ -1085,8 +1080,7 @@ async function startViteDev(ctx, options) {
 		hmr: options.httpServer !== void 0
 	};
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 const name = "client-modules";
 const inject = ["loader", "webServer"];
 /**
@@ -1127,10 +1121,17 @@ async function clientRowsOf(loader) {
 	}
 	return [...found.values()];
 }
-/** 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，rev 跟着出口变就等于永不命中）。 */
+/**
+* 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，rev 跟着出口变就等于永不命中）。
+*
+* 上游包的 `lib/` 也是打包输入：`exports` 的 `./typert` / `./remote` / `./client/typert` 指向
+* `lib/typert.*.ts`（`just vendor prebuild` 生成的），只盯 `src/` 时重新生成 typert 产物不会让缓存失效，
+* 浏览器会继续拿旧的 descriptor——例如 `terminal/retain` 仍按旧的 `workspaceFileScopeId` 发参数，宿主
+* 按新 descriptor 拒掉（`missing "sessionId"`）。
+*/
 function watchOf(root, entry) {
 	if (root === void 0) return [entry];
-	return root.includes("node_modules") ? [(0, node_path.join)(root, "package.json")] : [(0, node_path.join)(root, "src")];
+	return root.includes("node_modules") ? [(0, node_path.join)(root, "package.json")] : [(0, node_path.join)(root, "src"), (0, node_path.join)(root, "lib")];
 }
 function apply(ctx) {
 	const trace = traceOf(ctx, "federation");
@@ -1439,7 +1440,7 @@ function apply(ctx) {
 		handler: serve
 	}), "client-modules: /plugins route");
 }
-//#endregion
 exports.apply = apply;
 exports.inject = inject;
 exports.name = name;
+exports.watchOf = watchOf;

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import { Context } from "@deepseek-ai/cordis";
-//#region src/index.d.ts
 export declare const name = "client-modules";
 export declare const inject: string[];
 /** 一行 client 声明：包名与它的 client 半源文件。 */
@@ -9,5 +8,13 @@ export interface ClientRow {
   /** 包版本：联邦地址（`@client-modules/<pkg>@<version>/<file>`）的组成部分。 */
   version: string;
 }
-export declare function apply(ctx: Context): void;
-//#endregion
+/**
+ * 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，rev 跟着出口变就等于永不命中）。
+ *
+ * 上游包的 `lib/` 也是打包输入：`exports` 的 `./typert` / `./remote` / `./client/typert` 指向
+ * `lib/typert.*.ts`（`just vendor prebuild` 生成的），只盯 `src/` 时重新生成 typert 产物不会让缓存失效，
+ * 浏览器会继续拿旧的 descriptor——例如 `terminal/retain` 仍按旧的 `workspaceFileScopeId` 发参数，宿主
+ * 按新 descriptor 拒掉（`missing "sessionId"`）。
+ */
+export declare function watchOf(root: string | undefined, entry: string): string[];
+export declare function apply(ctx: Context): void;

package/dist/index.mjs

@@ -7,7 +7,7 @@ import { createHash } from "node:crypto";
 import { cssInlinePlugins } from "@morlay/dsh-cordis-assets/styles";
 import { rolldown } from "rolldown";
 import { createServer, esmExternalRequirePlugin } from "vite";
-//#region src/trace.ts
+// src/trace.ts
 /**
 * 诊断细节（逐包预编译、逐请求那一类）的具名 logger。
 *
@@ -28,8 +28,7 @@ function traceOf(ctx, name) {
 		logger.debug(format, ...args);
 	};
 }
-//#endregion
-//#region src/config.ts
+// src/config.ts
 /**
 * dev 形态的分流配置：profile 的 `dsh.dev.exclude` 点名的包**不算开发模块**。
 *
@@ -86,8 +85,7 @@ async function devExcluded(profileDir) {
 function isAggregated(name, patterns) {
 	return patterns.some((pattern) => pattern.test(name));
 }
-//#endregion
-//#region src/resolve.ts
+// src/resolve.ts
 /** 路由前缀（沿用上游的 `/plugins`，页面上不改 URL 形态）。 */
 const PLUGIN_ROUTE = "/plugins";
 /** `@deepseek-ai/dsh-x` → `@deepseek-ai+dsh-x`：包名里的 `/` 在 URL 段里要转义。 */
@@ -342,8 +340,7 @@ async function clientHalfOf(root, subpath) {
 	const conventional = join(root, "src", "client", "index.ts");
 	return await exists(conventional) ? conventional : void 0;
 }
-//#endregion
-//#region src/bundle.ts
+// src/bundle.ts
 /**
 * 客户端资源的**联邦式**产出：一个包一份产物，三方的与我们的**没有本质区别**。
 *
@@ -783,8 +780,7 @@ async function packageJsonNear(file) {
 		directory = parent;
 	}
 }
-//#endregion
-//#region src/dirs.ts
+// src/dirs.ts
 /** 本包自己的根（页面的骨架、`node-stub` 与依赖解析的兜底基准都从它推）。 */
 function packageRoot() {
 	return dirname(fileURLToPath(new URL("../package.json", import.meta.url)));
@@ -983,8 +979,7 @@ function dshClientRowsPlugin(options) {
 		}
 	};
 }
-//#endregion
-//#region src/serve-vite.ts
+// src/serve-vite.ts
 function rowsOf(source) {
 	return source.rows();
 }
@@ -1084,8 +1079,7 @@ async function startViteDev(ctx, options) {
 		hmr: options.httpServer !== void 0
 	};
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 const name = "client-modules";
 const inject = ["loader", "webServer"];
 /**
@@ -1126,10 +1120,17 @@ async function clientRowsOf(loader) {
 	}
 	return [...found.values()];
 }
-/** 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，rev 跟着出口变就等于永不命中）。 */
+/**
+* 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，rev 跟着出口变就等于永不命中）。
+*
+* 上游包的 `lib/` 也是打包输入：`exports` 的 `./typert` / `./remote` / `./client/typert` 指向
+* `lib/typert.*.ts`（`just vendor prebuild` 生成的），只盯 `src/` 时重新生成 typert 产物不会让缓存失效，
+* 浏览器会继续拿旧的 descriptor——例如 `terminal/retain` 仍按旧的 `workspaceFileScopeId` 发参数，宿主
+* 按新 descriptor 拒掉（`missing "sessionId"`）。
+*/
 function watchOf(root, entry) {
 	if (root === void 0) return [entry];
-	return root.includes("node_modules") ? [join(root, "package.json")] : [join(root, "src")];
+	return root.includes("node_modules") ? [join(root, "package.json")] : [join(root, "src"), join(root, "lib")];
 }
 function apply(ctx) {
 	const trace = traceOf(ctx, "federation");
@@ -1438,5 +1439,4 @@ function apply(ctx) {
 		handler: serve
 	}), "client-modules: /plugins route");
 }
-//#endregion
-export { apply, inject, name };
+export { apply, inject, name, watchOf };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-client-modules",
-  "version": "0.2.9",
+  "version": "0.2.11-alpha.0",
   "description": "Dev-form web layer for dsh: serves the page, the app entry and every client resource through an in-process vite dev server (middleware mode) — the node-side counterpart of upstream @deepseek-ai/dsh-client-modules, with the module table replaced by vite's resolver, dependency prebundling and HMR.",
   "keywords": [
     "client",
@@ -36,26 +36,27 @@
     "./locale/*.json": "./locale/*.json"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-client-ui-theme": "^0.2.1-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.2.1-rc.1",
-    "@morlay/dsh-cordis-assets": "0.2.8",
+    "@deepseek-ai/dsh-client-ui-theme": "^0.2.2-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.2-alpha.2",
+    "@morlay/dsh-client-ui-primitives": "0.0.14-alpha.0",
+    "@morlay/dsh-cordis-assets": "0.2.10-alpha.0",
     "@oxc-project/runtime": "^0.153.0",
     "lightningcss": "^1.30.0",
     "vite": "^8.3.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/cordis": "^4.0.6-alpha.1",
     "@local/devkit": "0.1.0",
     "@types/node": "^26.5.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/cordis": "^4.0.6-alpha.1",
     "react": "^18.3.1",
     "rolldown": "^1.2.14"
   },
   "engines": {
-    "node": ">=24.11.0",
-    "dsh": ">= 0.2.1-rc.1 < 0.2.2"
+    "dsh": ">= 0.2.2-alpha.2 < 0.2.3",
+    "node": ">=24.11.0"
   },
   "dsh": {
     "client": {

package/src/__tests__/watch.spec.ts

@@ -0,0 +1,35 @@
+/**
+ * 预编译缓存指纹的输入集：上游包的 `lib/`（typert 产物）与 `src/` 都是打包输入。
+ *
+ * 现场：`just vendor prebuild` 重新生成 `lib/typert.*.ts` 后，指纹只盯 `src/` 时会继续命中旧缓存，
+ * 浏览器拿到的还是旧 descriptor（`terminal/retain` 仍发 `workspaceFileScopeId`，宿主按新 descriptor
+ * 拒掉 `missing "sessionId"`）。
+ */
+import { join } from "node:path";
+import { expect, test } from "vitest";
+import { watchOf } from "../index.ts";
+
+test("上游包（非 node_modules）：指纹看 src 与 lib", () => {
+  const root = join(process.cwd(), "vendor", "deepseek-harness", "packages", "api", "demo");
+  expect(watchOf(root, join(root, "src", "index.ts"))).toEqual([
+    join(root, "src"),
+    join(root, "lib"),
+  ]);
+});
+
+test("node_modules 里的三方包：只看 package.json（版本已进缓存目录名）", () => {
+  const root = join(
+    process.cwd(),
+    "node_modules",
+    ".pnpm",
+    "react@18.3.1",
+    "node_modules",
+    "react",
+  );
+  expect(watchOf(root, join(root, "index.js"))).toEqual([join(root, "package.json")]);
+});
+
+test("没有包根时退到入口文件", () => {
+  const entry = join(process.cwd(), "dist", "index.js");
+  expect(watchOf(undefined, entry)).toEqual([entry]);
+});

package/src/client/index.ts

@@ -1,4 +1,8 @@
-// client 半：两件事，都是**把上游那条链缺的面补上**。
+// client 半：三件事——把上游那条链缺的面补上，并给内联的 UI 基础面一个唯一装配点。
+//
+// 0. UI 基础面（`@morlay/dsh-client-ui-primitives`）的装配：它是内联库（不是装配行），
+//    字典 / 字段槽 / 按行配置页只能装一次；由本行（客户端装配的根）统一调用，消费方不再各自调用
+//    （多份副本同时注册会撞 `locale namespace "settings.schema-form" already has locale "zh"`）。
 //
 // 1. `modules` 服务面：上游 `ui-settings-general` 的 client 插件 inject 它（有它就忽略 peer），
 //    我们的装配停用了上游 `client-modules` 行，所以这里补一个最小实现（见文件头注释与 README）。
@@ -8,6 +12,7 @@
 //    已失效的 id 一直带回来，`TerminalView` 的 `createWhenMissing` 只在「没有 saved id」时才分配新终端
 //    —— 于是面板永远停在"此终端已不存在，请新建终端"，点"新建终端"复用的还是它。
 import type { Context } from "@deepseek-ai/cordis";
+import { apply as installUiPrimitives } from "@morlay/dsh-client-ui-primitives/client";
 
 /** 恒 `undefined` 的可订阅快照（`useSyncExternalStore` 的入参形状）。 */
 const NO_RELEASE_CHANGE = {
@@ -21,6 +26,8 @@ const NO_RELEASE_CHANGE = {
  * @param ctx - 浏览器侧根上下文。
  */
 export function apply(ctx: Context): void {
+  // 内联库的唯一装配点：`apply` 自己等依赖到齐，并在服务已在场时让位。
+  installUiPrimitives(ctx);
   ctx.reflect.provide("modules", {
     entries: {
       releaseChange: NO_RELEASE_CHANGE,

package/src/index.ts

@@ -131,10 +131,19 @@ async function clientRowsOf(loader: { entries(): Generator<LoaderEntry> }): Prom
   return [...found.values()];
 }
 
-/** 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，rev 跟着出口变就等于永不命中）。 */
-function watchOf(root: string | undefined, entry: string): string[] {
+/**
+ * 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，rev 跟着出口变就等于永不命中）。
+ *
+ * 上游包的 `lib/` 也是打包输入：`exports` 的 `./typert` / `./remote` / `./client/typert` 指向
+ * `lib/typert.*.ts`（`just vendor prebuild` 生成的），只盯 `src/` 时重新生成 typert 产物不会让缓存失效，
+ * 浏览器会继续拿旧的 descriptor——例如 `terminal/retain` 仍按旧的 `workspaceFileScopeId` 发参数，宿主
+ * 按新 descriptor 拒掉（`missing "sessionId"`）。
+ */
+export function watchOf(root: string | undefined, entry: string): string[] {
   if (root === undefined) return [entry];
-  return root.includes("node_modules") ? [join(root, "package.json")] : [join(root, "src")];
+  return root.includes("node_modules")
+    ? [join(root, "package.json")]
+    : [join(root, "src"), join(root, "lib")];
 }
 
 export function apply(ctx: Context): void {