@morlay/dsh-client-modules 0.2.8 → 0.2.10

package/dist/client.d.cts

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

package/dist/client.d.mts

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

package/dist/client.mjs

@@ -1,3 +1,4 @@
+import { apply as apply$1 } from "@morlay/dsh-client-ui-primitives/client";
 //#region src/client/index.ts
 /** 恒 `undefined` 的可订阅快照（`useSyncExternalStore` 的入参形状）。 */
 const NO_RELEASE_CHANGE = {
@@ -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,

package/dist/index.cjs

@@ -1127,10 +1127,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");
@@ -1443,3 +1450,4 @@ function apply(ctx) {
 exports.apply = apply;
 exports.inject = inject;
 exports.name = name;
+exports.watchOf = watchOf;

package/dist/index.d.mts

@@ -9,5 +9,14 @@ export interface ClientRow {
   /** 包版本：联邦地址（`@client-modules/<pkg>@<version>/<file>`）的组成部分。 */
   version: string;
 }
+/**
+ * 打包器指纹的输入集：**只与包有关、与出口无关**（缓存按包聚合，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;
 //#endregion

package/dist/index.mjs

@@ -1126,10 +1126,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");
@@ -1439,4 +1446,4 @@ function apply(ctx) {
 	}), "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.8",
+  "version": "0.2.10",
   "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",
@@ -38,7 +38,8 @@
   "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.7",
+    "@morlay/dsh-client-ui-primitives": "0.0.13",
+    "@morlay/dsh-cordis-assets": "0.2.9",
     "@oxc-project/runtime": "^0.153.0",
     "lightningcss": "^1.30.0",
     "vite": "^8.3.1"
@@ -54,8 +55,8 @@
     "rolldown": "^1.2.14"
   },
   "engines": {
-    "node": ">=24.11.0",
-    "dsh": ">= 0.2.1-rc.1 < 0.2.2"
+    "dsh": ">= 0.2.1-rc.1 < 0.2.2",
+    "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 {