@deepseek-ai/dsh-typert-loader 0.1.5-rc.1 → 0.1.6-alpha.1

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/typert/loader/README.md
-README.md: ba8fe7d6b13924b6f9a39d1e792153f346aec530
-README.zh.md: a4c16ac5f5b54e8524422f6574092e909988be95
+README.md: 378be98dea5f47e4d6b0a0c70600e2a4c221c80b
+README.zh.md: e598127bba12e4057405231fe09199db18f9604d

package/README.md

@@ -44,7 +44,7 @@ The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-a
 
 ### What gets registered
 
-Each qualifying Loader entry contributes its generated host-face reflection and schemas to the runtime registry. Registration follows the entry lifecycle: it is withdrawn when the entry or the plugin unmounts, and a registration whose import settles after both are gone is discarded.
+Each qualifying Loader entry contributes its generated host-face reflection and schemas to the runtime registry. Registration follows the entry lifecycle: it is withdrawn when the entry or the plugin unmounts, and an import that settles after either owner is gone is discarded.
 
 ### Observable behavior and failures
 

package/README.zh.md

@@ -40,15 +40,15 @@ kind: "package-reference"
 |---|---|---|
 | `packages` | `[]` | 为嵌套在另一 Loader 配置项下的插件额外注册的包产物；每个包都必须能从配置树解析，并导出 `./typert` |
 
-生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-typert-loader)是每个受支持字段的穷尽式真源。
+生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-typert-loader)是所有受支持字段的完整真源。
 
 ### 注册什么
 
-每个符合条件的 Loader 配置项都会把其生成的宿主侧反射与 schema 贡献给运行时注册表。注册跟随配置项生命周期：配置项或本插件卸载时撤销；在两者都已消失后才结束的注册会被丢弃。
+每个符合条件的 Loader 配置项都会把其生成的宿主侧反射与 schema 贡献给运行时注册表。注册跟随配置项生命周期：配置项或本插件卸载时撤销；在配置项或本插件任一方卸载后才结束的导入操作会被丢弃。
 
 ### 可观察行为与失败
 
-没有该导出的包会被静默跳过。解析结论与已导入的 manifest 会在整个进程生命周期内缓存，因此新增 `./typert` 导出后必须重启。已挂载配置项对应的产物格式错误时，激活会大声失败；之后才发生的失败按包记录日志，不会阻止无关包完成注册。无法从配置树解析、或缺少该导出的显式 `packages` 条目会大声失败并指名该包。
+没有该导出的包会被静默跳过。解析结论与已导入的 manifest（元数据清单）会在整个进程生命周期内缓存，因此新增 `./typert` 导出后必须重启。已挂载配置项对应的产物格式错误时，激活会明确报错；之后才发生的失败按包记录日志，不会阻止无关包完成注册。无法从配置树解析、或缺少该导出的显式 `packages` 条目会明确报错并指名该包。
 
 -----
 
@@ -62,7 +62,7 @@ kind: "package-reference"
 
 ### 设计理念
 
-本插件是一个增量扫描器，与 client-modules 的 Node 半实现对称：每次 Cordis `internal/plugin` 事件都会把该 fiber 的配置项名称标记为脏，微任务 flush 会针对实时 Loader 配置项逐一调和每个脏名称；激活阶段用所有当前配置项填充同一脏集合。
+本插件是一个增量扫描器，与 client-modules 的 Node 侧实现对称：每次 Cordis `internal/plugin` 事件都会把该 fiber 的配置项名称标记为脏，微任务 flush 会针对实时 Loader 配置项逐一调和每个脏名称；激活阶段用所有当前配置项填充同一脏集合。
 
 ### Manifest 校验
 
@@ -76,8 +76,8 @@ kind: "package-reference"
 
 | 文件 | 职责 |
 |---|---|
-| [`src/index.ts`](src/index.ts) | 插件入口：`Config`、扫描器、manifest 校验、注册接线 |
-| — | 不发布运行时不变式伴生入口；Loader entry 生命周期直接持有每个准确的 registry disposer，integration test 会观察注册与移除。 |
+| [`src/index.ts`](src/index.ts) | 插件入口：`Config`、扫描器、manifest 校验、注册装配逻辑 |
+| — | 不发布运行时不变式伴生入口；Loader 配置项的生命周期直接持有每个对应的注册表资源释放函数，集成测试会观察注册与移除。 |
 
 </details>
 
@@ -86,7 +86,7 @@ kind: "package-reference"
 <a id="further-exploration"></a>
 ## 进一步探索
 
-当包级约定不够用时阅读以下页面；它们从 loader 逐步进入它注册什么以及什么产生这些内容。
+当包级约定不够用时阅读以下页面；这些页面从 loader 开始，依次介绍它注册的内容及其生成方。
 
 - [Typert 注册表](../registry/README.zh.md)——本插件所供给的服务。
 - [Typert 生成器](../generator/README.zh.md)——产生 loader 所导入产物的包。
@@ -102,7 +102,7 @@ kind: "package-reference"
 
 #### KV Cache 影响
 
-无直接影响；注册变化只有在消费方读取注册表时才会触及请求。
+无直接影响；注册变更只有通过读取注册表的消费方才会影响请求。
 
 ## 已知限制与延期工作
 

package/lib/index.js

@@ -217,7 +217,8 @@ function requireStrictCodec(pkgName, value, subject) {
 */
 async function apply(ctx, config) {
 	if (ctx.baseUrl === void 0) throw new Error("typert-loader: ctx.baseUrl is unset — the loader needs the config-tree anchor to resolve plugin packages");
-	const require = createRequire(ctx.baseUrl);
+	const baseUrl = ctx.baseUrl;
+	const require = createRequire(baseUrl);
 	const configured = new Set(config.packages);
 	const registered = /* @__PURE__ */ new Map();
 	const pending = /* @__PURE__ */ new Map();
@@ -235,17 +236,33 @@ async function apply(ctx, config) {
 	const resolveArtifact = (pkgName) => {
 		const cached = artifactPath.get(pkgName);
 		if (cached !== void 0) return cached;
+		const firstSlash = pkgName.indexOf("/");
+		if (firstSlash >= 0 && (pkgName[0] !== "@" || pkgName.indexOf("/", firstSlash + 1) >= 0)) {
+			if (configured.has(pkgName)) throw new Error(`typert-loader: configured package "${pkgName}" cannot be resolved from the config tree — add it to the composition package dependencies or remove it from packages`);
+			artifactPath.set(pkgName, null);
+			return null;
+		}
 		let pkgPath;
+		let pkg;
 		try {
-			pkgPath = require.resolve(`${pkgName}/package.json`);
+			const packages = ctx.get("pluginPackages");
+			const resolvedPackage = packages?.packageOf(pkgName, baseUrl);
+			if (packages !== void 0 && resolvedPackage === void 0) throw new Error("package is absent from the active resolver");
+			pkgPath = resolvedPackage === void 0 ? require.resolve(`${pkgName}/package.json`) : resolvedPackage.manifestPath;
+			pkg = resolvedPackage?.manifest;
 		} catch (cause) {
 			if (configured.has(pkgName)) throw new Error(`typert-loader: configured package "${pkgName}" cannot be resolved from the config tree — add it to the composition package dependencies or remove it from packages`, { cause });
 			artifactPath.set(pkgName, null);
 			return null;
 		}
-		const rel = typertExportOf(pkgName, JSON.parse(readFileSync(pkgPath, "utf8")).exports);
+		pkg ??= JSON.parse(readFileSync(pkgPath, "utf8"));
+		const manifestName = typeof pkg.name === "string" ? pkg.name : pkgName;
+		const rel = typertExportOf(manifestName, pkg.exports);
 		if (rel === void 0 && configured.has(pkgName)) throw new Error(`typert-loader: configured package "${pkgName}" does not export "${TYPERT_HOST_EXPORT}"`);
-		const resolved = rel === void 0 ? null : join(dirname(pkgPath), rel);
+		const resolved = rel === void 0 ? null : {
+			packageName: manifestName,
+			path: join(dirname(pkgPath), rel)
+		};
 		artifactPath.set(pkgName, resolved);
 		return resolved;
 	};
@@ -275,9 +292,9 @@ async function apply(ctx, config) {
 			return;
 		}
 		if (registered.has(entryName) || pending.has(entryName)) return void 0;
-		const path = resolveArtifact(entryName);
-		if (path === null) return void 0;
-		const task = loadManifest(entryName, path).then((manifest) => {
+		const artifact = resolveArtifact(entryName);
+		if (artifact === null) return void 0;
+		const task = loadManifest(artifact.packageName, artifact.path).then((manifest) => {
 			if (!active || !qualifies(entryName) || registered.has(entryName)) return;
 			registered.set(entryName, ctx.typert.register(manifest));
 		});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-typert-loader",
   "description": "Loader integration for generated Typert package contributions",
-  "version": "0.1.5-rc.1",
+  "version": "0.1.6-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -28,16 +28,17 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.5-rc.1"
+    "@deepseek-ai/dsh-typert-registry": "^0.1.6-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
     "zod": "^4.4.3",
+    "@deepseek-ai/dsh-app-boot": "^0.1.6-alpha.1",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.6-alpha.1",
     "@deepseek-ai/cordis": "^4.0.2"
   }
 }