@deepseek-ai/dsh-client-modules 0.0.1-rc.1 → 0.0.1-rc.2

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/modules/README.md
-README.md: a1d578850c2518a85dc32f048768b78caf5ffec4
+README.md: efaff699839b977cc45f89f3c164402241b90dc2
 README.zh.md: 772a4870f7ef6730d9d3d4db434ed771d97984f0

package/README.md

@@ -4,7 +4,7 @@ English | [中文](README.zh.md)
 
 Client module system: the browser peer of Node's internal ESM loader, built as a lazy CJS table. The web shell mounts the vendored cordis Loader for entry governance (fiber lifecycle, inject waiting, update/refresh) and injects this package's `ClientModuleLoader` through its `internal` contract — the vendored side's only consumption point is `EntryTree.import`, so replacing `internal` replaces exactly "how plugin code arrives" and nothing else.
 
-Lazy CJS model (web2): executing a plugin bundle only REGISTERS its factory (`window.__ModuleLoader__.load({id, factory})`); every module body side effect — CSS injection included — lives in the factory closure and runs at materialization (`factory(require)` → export surface, memoized in `loadCache`), not at script execution. A factory that requires another registered-but-unmaterialized module materializes it recursively, so load order needs no external sequencing; require cycles throw (factory-form CJS cannot deliver partial exports). `<id>/client` and the bare id name the same surface (a plugin bundle IS its package's client half).
+Lazy CJS model (web2): executing a plugin bundle only REGISTERS its factory (`window.__ModuleLoader__.load({id, factory})`); every module body side effect — CSS injection included — lives in the factory closure and runs at materialization (`factory(require)` → exports, memoized in `loadCache`), not at script execution. A factory that requires another registered-but-unmaterialized module materializes it recursively, so load order needs no external sequencing; require cycles throw (factory-form CJS cannot deliver partial exports). `<id>/client` and the bare id resolve to the same exports (a plugin bundle IS its package's client half).
 
 Resolution branch order (`import(specifier)`): platform seed word → shell instance; memoized record → surface; shell-own static registry (`registerStatic`, app-shell) → module; registered factory → materialize; graph row (`window.__DSH_BOOT__`) → load its external classic script + materialize; anything else throws — the runtime mirror of the build-time bundle purity gate. The synchronous `require` handed to factories walks the same order minus the asynchronous load branch and records observed edges into the module record. `prefetch` is the stage-one arrival hook (script load and factory registration only; concurrent calls share one in-flight task); `invalidate` drops the factory and materialized record so the next prefetch/import reloads the script (the HMR hook).
 

package/lib/client.js

@@ -23,7 +23,7 @@ window.__ModuleLoader__.load({
 		/**
 		* A plugin bundle IS its package's client half: `<id>/client` (the exports
 		* subpath external bundles emit) and the bare graph id name the same
-		* surface, so table lookups normalize the suffix away.
+		* exports, so table lookups normalize the suffix away.
 		*/
 		const stripClientSuffix = (spec) => spec.endsWith("/client") ? spec.slice(0, -7) : spec;
 		/**
@@ -101,7 +101,7 @@ window.__ModuleLoader__.load({
 					const edges = /* @__PURE__ */ new Set();
 					const record = {
 						id,
-						surface: registered(this.makeRequire(edges)),
+						exports: registered(this.makeRequire(edges)),
 						styles: claimStyles(id),
 						edges
 					};
@@ -125,31 +125,31 @@ window.__ModuleLoader__.load({
 					if (this.statics.has(spec)) return this.statics.get(spec);
 					const id = stripClientSuffix(spec);
 					const record = this.loadCache.get(id);
-					if (record !== void 0) return record.surface;
-					if (this.factories.has(id)) return this.materialize(id).surface;
+					if (record !== void 0) return record.exports;
+					if (this.factories.has(id)) return this.materialize(id).exports;
 					throw new Error(`client-modules: require("${spec}") missed the module table — not a platform seed word, not a shell-own module, and no registered factory (a build-time externals drift, or a forbidden cross-plugin value import)`);
 				};
 			}
 			async import(specifier) {
 				if (this.seed.has(specifier)) return this.seed.get(specifier);
 				const existing = this.loadCache.get(specifier);
-				if (existing !== void 0) return existing.surface;
+				if (existing !== void 0) return existing.exports;
 				if (this.statics.has(specifier)) {
-					const surface = this.statics.get(specifier);
+					const exports = this.statics.get(specifier);
 					this.loadCache.set(specifier, {
 						id: specifier,
-						surface,
+						exports,
 						styles: [],
 						edges: /* @__PURE__ */ new Set()
 					});
-					return surface;
+					return exports;
 				}
 				if (!this.factories.has(specifier)) {
 					const row = this.graphRows.get(specifier);
 					if (row === void 0) throw new Error(`client-modules: cannot resolve "${specifier}" — not a seed word, not a shell-own module, and not a row in the boot graph (the runtime mirror of the bundle purity gate)`);
 					await this.arrive(row);
 				}
-				return this.materialize(specifier).surface;
+				return this.materialize(specifier).exports;
 			}
 			registerStatic(id, module) {
 				if (this.statics.has(id)) throw new Error(`client-modules: shell-own module "${id}" registered twice`);
@@ -180,13 +180,13 @@ window.__ModuleLoader__.load({
 		* factory (`window.__ModuleLoader__.load({id, factory})`); every module body
 		* side effect — including CSS injection — lives inside the factory closure
 		* and runs at materialization, not at script execution. Materialization
-		* (factory(require) → export surface) happens on first import/require and is
+		* (factory(require) → exports) happens on first import/require and is
 		* memoized in {@link ClientModuleLoader.loadCache}; a factory that requires
 		* another registered-but-unmaterialized module materializes it recursively,
 		* so load order needs no external sequencing.
 		*
 		* Resolution branch order (import): seed word → shell instance; memoized
-		* record → surface; static registry (shell-own modules, e.g. app-shell) →
+		* record → exports; static registry (shell-own modules, e.g. app-shell) →
 		* module; registered factory → materialize; graph row → load + materialize;
 		* anything else → throw (loud — the runtime mirror of the
 		* build-time bundle purity gate). The synchronous `require` handed to

package/lib/types/client/manifest.d.ts

@@ -10,13 +10,13 @@
  * factory (`window.__ModuleLoader__.load({id, factory})`); every module body
  * side effect — including CSS injection — lives inside the factory closure
  * and runs at materialization, not at script execution. Materialization
- * (factory(require) → export surface) happens on first import/require and is
+ * (factory(require) → exports) happens on first import/require and is
  * memoized in {@link ClientModuleLoader.loadCache}; a factory that requires
  * another registered-but-unmaterialized module materializes it recursively,
  * so load order needs no external sequencing.
  *
  * Resolution branch order (import): seed word → shell instance; memoized
- * record → surface; static registry (shell-own modules, e.g. app-shell) →
+ * record → exports; static registry (shell-own modules, e.g. app-shell) →
  * module; registered factory → materialize; graph row → load + materialize;
  * anything else → throw (loud — the runtime mirror of the
  * build-time bundle purity gate). The synchronous `require` handed to
@@ -103,12 +103,12 @@ export interface ClientPluginHandoff {
     id: string;
     /**
      * Closure factory holding the whole bundle body: receives the synchronous
-     * require bound to the module table and returns the bundle's export
-     * surface. Runs once, at materialization.
+     * require bound to the module table and returns the bundle's exports. Runs
+     * once, at materialization.
      */
     factory: (require: (spec: string) => unknown) => Record<string, unknown>;
 }
-/** Window surface of the web boot protocol: the host-injected graph, the registration sink, and the kernel handoff slot. */
+/** Window API of the web boot protocol: the host-injected graph, registration sink, and kernel handoff slot. */
 export interface DshWindow {
     /** Host-composed entry graph, injected before the shell bundle runs; wire-boundary raw until {@link parseBootManifest}. */
     __DSH_BOOT__?: unknown;
@@ -128,8 +128,8 @@ export interface DshWindow {
 export interface ClientModuleRecord {
     /** Module id (entry name / package name). */
     id: string;
-    /** The materialized export surface (factory `module.exports`, or the shell module for static registrations). */
-    surface: unknown;
+    /** Materialized exports (`module.exports` from a factory, or a statically registered shell module). */
+    exports: unknown;
     /** Owned `<style data-plugin>` tag ids (`data-plugin-css` values) injected during materialization. */
     styles: string[];
     /** Observed `require()` edges (module-graph boundary; only table words can appear today). */
@@ -143,7 +143,7 @@ export interface ClientModuleRecord {
 export interface ClientModuleLoader {
     /** Discriminant against Node's internal loader shapes ('v1'/'v2'). */
     version: 'client';
-    /** Materialized-module registry: id → record. The governance-side read face for entry export surfaces. */
+    /** Materialized-module registry: id → record. The governance-side read API for entry exports. */
     loadCache: Map<string, ClientModuleRecord>;
     /**
      * Internal contract consumed by the vendored Loader's `tree.import`. Resolves
@@ -152,7 +152,7 @@ export interface ClientModuleLoader {
      * @param specifier - module specifier (entry name or table word).
      * @param parentURL - importer URL (unused — the client module graph is flat).
      * @param attrs - Import attributes (unused; interface parity with Node's loader contract).
-     * @returns the module's export surface.
+     * @returns the module's exports.
      */
     import(specifier: string, parentURL: string, attrs: Record<string, unknown>): Promise<unknown>;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-modules",
   "description": "Client module system, dual-face: node half composes the __DSH_BOOT__ entry graph (incremental dsh.client scan, bundle route, index tap, webPlugins service); browser half is the lazy-CJS module table the vendored cordis Loader consumes as its internal seam",
-  "version": "0.0.1-rc.1",
+  "version": "0.0.1-rc.2",
   "publishConfig": {
     "access": "restricted"
   },
@@ -39,9 +39,9 @@
   "license": "BSD-3-Clause",
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1"
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "files": [
     "lib/index.js",
@@ -50,7 +50,7 @@
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "scripts": {