@deepseek-ai/dsh-typert-generator 0.2.0-rc.2 → 0.2.1-alpha.1

package/README.i18n.yaml

@@ -21,8 +21,8 @@
   en: b8720f6ac186a8e8
   zh: 3e04a4c1bebc2cf4
 /deepseek-ai-dsh-typert-generator/use-this-package/analyzing-a-workspace-statically:
-  en: 88f4e7fc9d4c7701
-  zh: cecd35ff4f35bfd2
+  en: 4ea0e4977cefa39d
+  zh: 41bdb6047bc79524
 /deepseek-ai-dsh-typert-generator/use-this-package/running-generation-inside-a-tsdown-build:
   en: cc3f7d23739380f6
   zh: 864d15088f581271
@@ -57,5 +57,5 @@
   en: f3b1002133fe8736
   zh: e8d5fecd10db5e3a
 /deepseek-ai-dsh-typert-generator/known-limitations-and-deferred-work/dev-note:
-  en: cc7e47f271475e4c
-  zh: 8426eb322816bd28
+  en: e67f633dc6fe7773
+  zh: 3bb0c20c93f16f98

package/README.md

@@ -47,6 +47,8 @@ After the build, `lib/typert.host.js` and `lib/typert.host.d.ts` exist and the [
 
 Static consumers call `WorkspaceAnalyzer` directly against the workspace's `tsconfig.host.json` and `tsconfig.client.json` aggregates, select a face and package subset, and read the resulting `FaceModel` and type graph without emitting or loading runtime artifacts. `analyzeInBatches()` processes a large package selection through bounded compiler programs with the same model shape, and `discoverPackages()` finds contributing packages without building a type-checker program.
 
+JSON, YAML, SVG, PNG, JPEG, and WebP resource exports contribute no TypeScript declarations and are excluded from the API model. Missing JavaScript or TypeScript export sources remain errors.
+
 ### Running generation inside a tsdown build
 
 The package's `./tsdown` subpath provides `typertPlugin()` for the root tsdown config: it lowers standard decorators in TypeScript dependencies before bundling and emits the model-driven face artifacts at the package output root. In `package` mode it emits only the bundled package; in `workspace` mode it emits every explicit contributor once.
@@ -141,5 +143,3 @@ These limits define what the generator cannot model or emit; they are current pa
 None.
 
 </details>
-
-**Runtime invariant:** No companion is published. The source-project analyzer and build-time emitter run outside any Cordis runtime; model snapshots, executable artifacts, and consuming-package typechecks enforce the output contract.

package/README.zh.md

@@ -47,6 +47,8 @@ files:
 
 静态消费方直接针对工作区的 `tsconfig.host.json` 与 `tsconfig.client.json` 聚合配置调用 `WorkspaceAnalyzer`，选择 face 与包子集，并在不生成或加载运行时产物的前提下读取生成的 `FaceModel` 与类型图。`analyzeInBatches()` 通过有界的编译器程序处理大批量包选择，模型形态保持一致；`discoverPackages()` 无需构建类型检查程序即可找出参与贡献的包。
 
+JSON、YAML、SVG、PNG、JPEG 和 WebP 资源导出不提供 TypeScript 声明，因此不进入 API 模型。JavaScript 或 TypeScript 导出源文件缺失时仍报错。
+
 ### 在 tsdown 构建中运行生成
 
 包的 `./tsdown` 子路径为根 tsdown 配置提供 `typertPlugin()`：它在打包前转换 TypeScript 依赖中的标准装饰器，并在包输出根目录生成模型驱动的 face 产物。`package` 模式只生成当前打包的包；`workspace` 模式对每个显式贡献方各生成一次。
@@ -141,5 +143,3 @@ Host 与 Client 是两个独立的 TypeScript 程序。直接项目引用确定
 无。
 
 </details>
-
-**运行时不变式：** 不发布伴生入口。源码项目分析器与构建时 emitter 均不在任何 Cordis 运行时中运行；模型快照、可执行产物与消费方包的类型检查会强制执行其输出约定。

package/lib/index.js

@@ -455,7 +455,7 @@ var FaceAnalyzer = class {
 		const targets = packageExportTargets(registration.manifest).filter(([subpath]) => registration.exportSubpaths === void 0 || registration.exportSubpaths.includes(subpath));
 		const records = [];
 		for (const [subpath, target] of targets) {
-			if (target.includes("*") || subpath === "./package.json" || subpath === "./typert" || subpath === "./client/typert" || subpath === "./remote" || target.endsWith(".json") || target.endsWith(".yml") || target.endsWith(".yaml")) continue;
+			if (target.includes("*") || subpath === "./package.json" || subpath === "./typert" || subpath === "./client/typert" || subpath === "./remote" || /\.(?:json|ya?ml|svg|png|jpe?g|webp)$/iu.test(target)) continue;
 			const sourcePath = sourcePathForExport(registration.root, target);
 			const sourceFile = this.sourceFiles.get(realPath(sourcePath));
 			if (sourceFile === void 0) throw new TypertAnalysisError(`typert(${this.face}): ${registration.name} export ${subpath} resolves to missing source ${sourcePath}`);

package/lib/types/analyzer.js

@@ -556,8 +556,8 @@ class FaceAnalyzer {
         for (const [subpath, target] of targets) {
             if (target.includes('*') || subpath === './package.json'
                 || subpath === './typert' || subpath === './client/typert' || subpath === './remote'
-                // Data exports (bundle patch lists, JSON manifests) carry no TypeScript API.
-                || target.endsWith('.json') || target.endsWith('.yml') || target.endsWith('.yaml'))
+                // Data exports carry no TypeScript API; their owning readers validate the resources.
+                || /\.(?:json|ya?ml|svg|png|jpe?g|webp)$/iu.test(target))
                 continue;
             const sourcePath = sourcePathForExport(registration.root, target);
             const sourceFile = this.sourceFiles.get(realPath(sourcePath));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-typert-generator",
   "description": "TypeScript project analyzer and model-driven Typert artifact generator",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.1-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -36,12 +36,12 @@
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
   },
   "devDependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-tool-cordis": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-typert-registry": "0.2.0-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/dsh-tool-cordis": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.1",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
   }
 }