@deepseek-ai/dsh-client-hmr 0.0.1-rc.1 → 0.0.1-rc.3

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/hmr/README.md
-README.md: 9228292547376d3fbb0ea5ce56b9e0a35ced17b2
-README.zh.md: ea62600911458556a3dcc7c46854e97db751c3ef
+README.md: c355595dd53ddcb74be629a6d5e730c6c5fcebbf
+README.zh.md: 6ed4d0e79cb755f84784823749994b448ff209b8

package/README.md

@@ -2,7 +2,7 @@
 
 English | [中文](README.zh.md)
 
-Hot reload for script-loaded client plugins. A static-arrival entry composed only into `--dev` graphs (`dsh web --dev`); production graphs omit the row, so the shell-bundled code stays inert.
+Hot reload for script-loaded client plugins. The web bundle mounts the row unconditionally; without a rebuild watcher (`pnpm run dev:web`) rewriting client bundles, the poll observes no changes and the chain stays idle.
 
 The browser half subscribes to the system SSE channel (`GET /plugins/events`) and reloads one plugin per `rebuilt` frame through a serialized queue. The sequence per frame — `invalidate`, `prefetch` (load and register the new bundle while the old fiber still serves), `registry.delete` (before the fiber: a bare fiber dispose trips the vendored Loader's self-dispose branch, which would mark the entry disabled), drain the old fiber, delete `entry.fiber`, remove owned `<style data-plugin>` tags, `entry.refresh()` re-imports and remounts, `fiber.await()` rethrows startup failures loud. Dependents reload through cordis itself: a fiber's activation epoch strings its service providers' uids, so replacing a provider's fiber cascades every dependent with zero client-side graph analysis. The node half detects rebuilds with one interval that stat-polls each graph bundle from a synchronous baseline, immediately re-hashes after adding a row, retains missing rows as dirty, and broadcasts only real rev changes; any tsdown watch process producing the bundle therefore triggers HMR with no builder→host channel.
 

package/README.zh.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 中文
 
-为通过脚本加载的客户端插件提供热重载。该静态加载配置项只组合进 `--dev` 图（`dsh web --dev`）；生产图省略该项，因此打包进 shell 的代码保持不活动。
+为通过脚本加载的客户端插件提供热重载。web 组合包无条件挂载该行；没有重建 watcher（`pnpm run dev:web`）改写客户端 bundle 时，轮询观察不到变化，链路保持空闲。
 
 浏览器侧订阅系统 SSE（Server-Sent Events）通道（`GET /plugins/events`），每个 `rebuilt` 帧重载一个插件，并通过队列串行执行。每帧的顺序是：`invalidate`、`prefetch`（旧 fiber 仍在服务时加载并注册新组合包）、`registry.delete`（在 fiber dispose（资源释放）之前执行：仅 dispose fiber 会触发 vendored Loader 的 self-dispose 分支，把配置项标为禁用）、排空旧 fiber、删除 `entry.fiber`、移除自身拥有的 `<style data-plugin>` 标签、通过 `entry.refresh()` 重新导入并挂载、通过 `fiber.await()` 直接重新抛出启动失败。依赖方由 Cordis 自身重载：fiber 的激活 epoch 会串联其服务提供方的 uid，因此替换提供方 fiber 会级联所有依赖方，无需客户端图分析。node 侧使用一个 interval 检测重建：从同步基线开始 stat-poll 每个图组合包；新增一行后立即重新计算 hash；缺失行保持 dirty；只广播真实 rev 变更。因此，任何生成组合包的 tsdown watch 进程都能触发 HMR（热模块替换），无需 builder→host 通道。
 

package/lib/index.js

@@ -17,12 +17,14 @@ const EVENTS_ENDPOINT = "/plugins/events";
 * mounts deliver no inotify events), reports content changes through
 * `clientModuleHost.rebuilt(id)`, and serves the `/plugins/events` SSE channel
 * broadcasting graph/rebuilt frames to the browser half (src/client/).
-* Dev-only row: prod compositions never mount this plugin.
+* The web bundle mounts this row unconditionally: without a rebuild
+* watcher rewriting client bundles, the poll observes no changes and the
+* chain stays idle.
 */
 /** Cordis plugin name. */
 const name = "client-hmr";
 /** Required services: the web plugin table and the route registry. */
-const inject = ["clientModuleHost", "httpServer"];
+const inject = ["clientModules", "webServer"];
 const Config = z.object({ pollIntervalMs: z.number().step(1).min(1).default(500) });
 /** Serialize one frame as an SSE data line. */
 function sseData(frame) {
@@ -30,7 +32,7 @@ function sseData(frame) {
 }
 /**
 * Mount the dev chain: bundle watches, rebuilt reporting, and the SSE channel.
-* @param ctx - host plugin context carrying clientModuleHost and httpServer.
+* @param ctx - host plugin context carrying clientModuleHost and webServer.
 * @param config - validated {@link Config}.
 */
 function apply(ctx, config) {
@@ -38,7 +40,7 @@ function apply(ctx, config) {
 	const watched = /* @__PURE__ */ new Map();
 	const rehash = (id, watch, current) => {
 		try {
-			ctx.clientModuleHost.rebuilt(id);
+			ctx.clientModules.rebuilt(id);
 		} catch (error) {
 			if (error.code === "ENOENT") {
 				watch.dirty = true;
@@ -89,8 +91,8 @@ function apply(ctx, config) {
 	};
 	const syncWatches = () => {
 		const rows = /* @__PURE__ */ new Map();
-		for (const row of ctx.clientModuleHost.graph().entries) {
-			const path = ctx.clientModuleHost.clientPath(row.id);
+		for (const row of ctx.clientModules.graph().entries) {
+			const path = ctx.clientModules.clientPath(row.id);
 			if (path !== void 0) rows.set(row.id, path);
 		}
 		for (const [id, watch] of watched) {
@@ -101,7 +103,7 @@ function apply(ctx, config) {
 	};
 	ctx.effect(() => {
 		syncWatches();
-		const unsubscribe = ctx.clientModuleHost.onGraphChanged(syncWatches);
+		const unsubscribe = ctx.clientModules.onGraphChanged(syncWatches);
 		const timer = setInterval(pollWatches, pollIntervalMs);
 		timer.unref();
 		return () => {
@@ -120,7 +122,7 @@ function apply(ctx, config) {
 		res.write(": connected\n\n");
 		res.write(sseData({
 			type: "graph",
-			graph: ctx.clientModuleHost.graph()
+			graph: ctx.clientModules.graph()
 		}));
 		connections.add(res);
 		res.on("close", () => {
@@ -128,7 +130,7 @@ function apply(ctx, config) {
 		});
 	};
 	ctx.effect(() => {
-		const disposeRoute = ctx.httpServer.register({
+		const disposeRoute = ctx.webServer.register({
 			kind: "exact",
 			path: EVENTS_ENDPOINT,
 			handler: (req, res) => {
@@ -140,7 +142,7 @@ function apply(ctx, config) {
 				connect(res);
 			}
 		});
-		const unsubscribe = ctx.clientModuleHost.onRebuilt((id, rev) => {
+		const unsubscribe = ctx.clientModules.onRebuilt((id, rev) => {
 			const line = sseData({
 				type: "rebuilt",
 				id,

package/lib/types/index.d.ts

@@ -14,7 +14,7 @@ export interface Config {
 export declare const Config: z<Config>;
 /**
  * Mount the dev chain: bundle watches, rebuilt reporting, and the SSE channel.
- * @param ctx - host plugin context carrying clientModuleHost and httpServer.
+ * @param ctx - host plugin context carrying clientModuleHost and webServer.
  * @param config - validated {@link Config}.
  */
 export declare function apply(ctx: Context, config: Config): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-hmr",
   "description": "Dev-only hot-reload driver for script-loaded client entries: SSE rebuilt frames → invalidate/prefetch → fiber swap through the vendored Loader entry",
-  "version": "0.0.1-rc.1",
+  "version": "0.0.1-rc.3",
   "publishConfig": {
     "access": "restricted"
   },
@@ -41,17 +41,17 @@
     "@deepseek-ai/schemastery": "^3.18.1-rc.1"
   },
   "peerDependencies": {
+    "@deepseek-ai/dsh-client-modules": "^0.0.1-rc.3",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
-    "@deepseek-ai/dsh-client-modules": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.3"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
-    "@deepseek-ai/dsh-client-modules": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-modules": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
     "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "files": [