@x1a0f3n9/dsh-typert-loader 0.1.5-rc.5 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,58 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# 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:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# 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: 378be98dea5f47e4d6b0a0c70600e2a4c221c80b
-README.zh.md: e598127bba12e4057405231fe09199db18f9604d
+/:
+  en: 3fa30a143acc79d7
+  zh: 0c6fe79fba20f26f
+/x1a0f3n9-dsh-typert-loader:
+  en: 92345679476b3a2a
+  zh: 3546b7580f3117e0
+/x1a0f3n9-dsh-typert-loader/summary:
+  en: be19cf069f29d225
+  zh: d2e50148ebe20bcc
+/x1a0f3n9-dsh-typert-loader/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/x1a0f3n9-dsh-typert-loader/use-this-package:
+  en: a755161460d28bd2
+  zh: 15db6beb30e87926
+/x1a0f3n9-dsh-typert-loader/use-this-package/minimal-configuration:
+  en: 881670b2d7dfb04d
+  zh: fbf612e945aaf066
+/x1a0f3n9-dsh-typert-loader/use-this-package/what-gets-registered:
+  en: 01318fcba39e9b0f
+  zh: c5f6528a91b335ac
+/x1a0f3n9-dsh-typert-loader/use-this-package/observable-behavior-and-failures:
+  en: 01494e9fbd469ec8
+  zh: 3025d870c0f36e2b
+/x1a0f3n9-dsh-typert-loader/understand-the-implementation:
+  en: 519c0242ef4d9e21
+  zh: a72967feb0ea1b41
+/x1a0f3n9-dsh-typert-loader/understand-the-implementation/design-concept:
+  en: 03fc077e58271e18
+  zh: 20f8fc02008cee5e
+/x1a0f3n9-dsh-typert-loader/understand-the-implementation/manifest-validation:
+  en: eb246aef15ea0532
+  zh: 7a4a7bcc788b3ba3
+/x1a0f3n9-dsh-typert-loader/understand-the-implementation/caching-and-ownership:
+  en: 38e781e052fdf44e
+  zh: d8f6b4d119bf9856
+/x1a0f3n9-dsh-typert-loader/understand-the-implementation/source-map:
+  en: 40a8a6723d33b335
+  zh: 5b806e49b6279818
+/x1a0f3n9-dsh-typert-loader/further-exploration:
+  en: 9665bb4850bb92de
+  zh: 508eaf81dee2a10b
+/x1a0f3n9-dsh-typert-loader/model-experience:
+  en: d3555a846d0b19a6
+  zh: eb4815fbd81a3561
+/x1a0f3n9-dsh-typert-loader/model-experience/kv-cache-effect:
+  en: f8a0ad3d0fc0eb32
+  zh: 7649a694b279f5f3
+/x1a0f3n9-dsh-typert-loader/known-limitations-and-deferred-work:
+  en: a7e281826b58b218
+  zh: b4347c965151a1a9
+/x1a0f3n9-dsh-typert-loader/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 3bb0c20c93f16f98

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-With `dsh-typert-loader` mounted, every package that mounts in a Loader composition automatically contributes its generated Typert reflection and schemas to the runtime registry — and withdraws them when the package or the plugin unmounts. Packages without the generated export are skipped, so adding the plugin to any composition is safe. An explicit `packages` list covers plugins nested behind another Loader entry, whose fibers carry no resolvable package specifier. It is a Node-only plugin and needs the config-tree resolution anchor to resolve packages.
+With `dsh-typert-loader` mounted, every package that mounts in a Loader composition automatically contributes its generated Typert reflection and schema factories to the runtime registry — and withdraws them when the package or the plugin unmounts. Packages without the generated export are skipped, so adding the plugin to any composition is safe. An explicit `packages` list covers plugins nested behind another Loader entry, whose fibers carry no resolvable package specifier. It is a Node-only plugin and needs the config-tree resolution anchor to resolve packages.
 
 ## Table of Contents
 
@@ -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 an import that settles after either owner is gone is discarded.
+Each qualifying Loader entry contributes its generated host-face reflection and schema factories 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
 
@@ -66,7 +66,7 @@ The plugin is an incremental scanner mirroring the client-modules node half: eve
 
 ### Manifest validation
 
-`validateTypertManifest()` is the module/file boundary: the manifest crosses from a build artifact into the typed registry, so every field is checked. The manifest must name the package that exports it, carry face `host`, hold zod v4 schema instances, and keep well-formed service, event, object, member, type, and documentation records; invocation descriptors must use strict codecs. Every failure names the package and the defect.
+`validateTypertManifest()` is the module/file boundary: the manifest crosses from a build artifact into the typed registry, so every field is checked. The manifest must name the package that exports it, carry face `host`, hold schema factories, and keep well-formed service, event, object, member, type, and documentation records; invocation descriptors must use strict codecs with factories. Every failure names the package and the defect.
 
 ### Caching and ownership
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-挂载 `dsh-typert-loader` 后，Loader 组合中每个挂载的包都会自动把其生成的 Typert 反射与 schema 贡献给运行时注册表——并在包或本插件卸载时自动撤销。没有该导出的包会被跳过，因此在任何 Loader 组合中挂载它都是安全的。显式 `packages` 用于覆盖嵌套在另一 Loader 配置项之下的插件，这些插件的 fiber 不携带可解析的包说明符。它是仅支持 Node 的插件，需要配置树解析锚点才能解析包。
+挂载 `dsh-typert-loader` 后，Loader 组合中每个挂载的包都会自动把其生成的 Typert 反射与 schema factory 贡献给运行时注册表——并在包或本插件卸载时自动撤销。没有该导出的包会被跳过，因此在任何 Loader 组合中挂载它都是安全的。显式 `packages` 用于覆盖嵌套在另一 Loader 配置项之下的插件，这些插件的 fiber 不携带可解析的包说明符。它是仅支持 Node 的插件，需要配置树解析锚点才能解析包。
 
 ## 目录
 
@@ -44,7 +44,7 @@ kind: "package-reference"
 
 ### 注册什么
 
-每个符合条件的 Loader 配置项都会把其生成的宿主侧反射与 schema 贡献给运行时注册表。注册跟随配置项生命周期：配置项或本插件卸载时撤销；在配置项或本插件任一方卸载后才结束的导入操作会被丢弃。
+每个符合条件的 Loader 配置项都会把其生成的宿主侧反射与 schema factory 贡献给运行时注册表。注册跟随配置项生命周期：配置项或本插件卸载时撤销；在配置项或本插件任一方卸载后才结束的导入操作会被丢弃。
 
 ### 可观察行为与失败
 
@@ -66,7 +66,7 @@ kind: "package-reference"
 
 ### Manifest 校验
 
-`validateTypertManifest()` 是模块／文件边界：manifest 从构建产物进入类型化注册表，因此每个字段都会被检查。manifest 必须指名导出它的包、携带 `host` face、持有 zod v4 schema 实例，并保持服务、事件、对象、成员、类型与文档记录格式正确；调用描述符必须使用严格编解码器。每次失败都会指名包与缺陷。
+`validateTypertManifest()` 是模块／文件边界：manifest 从构建产物进入类型化注册表，因此每个字段都会被检查。manifest 必须指名导出它的包、携带 `host` face、持有 schema factory，并保持服务、事件、对象、成员、类型与文档记录格式正确；调用描述符必须使用带 factory 的严格编解码器。每次失败都会指名包与缺陷。
 
 ### 缓存与归属
 

package/lib/index.js

@@ -84,7 +84,7 @@ function validateTypertManifest(pkgName, exported) {
 		if (typeof value !== "object" || value === null) throw new Error(`typert-loader: ${pkgName} TYPERT.schemas contains a non-object schema`);
 		const schema = value;
 		requireString(pkgName, schema, "name", "schema");
-		if (typeof schema.schema !== "object" || schema.schema === null || !("_zod" in schema.schema)) throw new Error(`typert-loader: ${pkgName} TYPERT schema "${schema.name}" is not a zod v4 schema instance`);
+		if (typeof schema.create !== "function") throw new Error(`typert-loader: ${pkgName} TYPERT schema "${schema.name}" has no create() factory`);
 	}
 	const model = requireObject(pkgName, manifest.model, "TYPERT.model");
 	const services = requireArray(pkgName, model.services, "TYPERT.model.services");
@@ -207,7 +207,8 @@ function requireStrictCodec(pkgName, value, subject) {
 	const codec = requireObject(pkgName, value, subject);
 	if (codec.mode !== "strict") throw new Error(`typert-loader: ${pkgName} ${subject} must use a strict codec`);
 	requireString(pkgName, codec, "typeSymbol", subject);
-	if (typeof codec.schema !== "object" || codec.schema === null || !("_zod" in codec.schema) || typeof codec.schema.parse !== "function") throw new Error(`typert-loader: ${pkgName} ${subject} is not backed by a zod v4 schema`);
+	for (const method of ["decode", "encode"]) if (codec[method] !== void 0 && typeof codec[method] !== "function") throw new Error(`typert-loader: ${pkgName} ${subject} ${method} must be a function`);
+	if (typeof codec.create !== "function") throw new Error(`typert-loader: ${pkgName} ${subject} has no create() factory`);
 }
 /**
 * Scan current Loader entries during activation, then follow entry mounts and
@@ -217,7 +218,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 +237,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 +293,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": "@x1a0f3n9/dsh-typert-loader",
   "description": "Loader integration for generated Typert package contributions",
-  "version": "0.1.5-rc.5",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,17 +27,18 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@x1a0f3n9/dsh-typert-registry": "^0.1.5-rc.5",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
+    "@x1a0f3n9/dsh-typert-registry": "0.1.7-rc.2",
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/schemastery": "~3.18.4"
   },
   "devDependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@x1a0f3n9/dsh-typert-registry": "^0.1.5-rc.5",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@x1a0f3n9/dsh-app-boot": "0.1.7-rc.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
+    "@x1a0f3n9/dsh-typert-registry": "0.1.7-rc.2",
+    "@deepseek-ai/cordis": "~4.0.4"
   }
 }