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

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

@@ -370,6 +370,9 @@ var FaceAnalyzer = class {
 	nodes = /* @__PURE__ */ new Map();
 	exportsByPackage = /* @__PURE__ */ new Map();
 	nodeOrdinals = /* @__PURE__ */ new Map();
+	/** Registration and package lookups per source path; the registration set is fixed per analyzer. */
+	registrationByFile = /* @__PURE__ */ new Map();
+	packageNameByFile = /* @__PURE__ */ new Map();
 	staticLookups;
 	staticContexts;
 	constructor(options) {
@@ -455,7 +458,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}`);
@@ -1954,12 +1957,19 @@ var FaceAnalyzer = class {
 		return `${this.packageNameForFile(declaration.getSourceFile().fileName)}:${location.file}#${symbol.name}`;
 	}
 	registrationForFile(file) {
+		if (this.registrationByFile.has(file)) return this.registrationByFile.get(file);
 		const path = realPath(file);
-		return this.allRegistrations.find((registration) => registration.face === this.face && isWithin(path, registration.root));
+		const registration = this.allRegistrations.find((registration) => registration.face === this.face && isWithin(path, registration.root));
+		this.registrationByFile.set(file, registration);
+		return registration;
 	}
 	packageNameForFile(file) {
+		const cached = this.packageNameByFile.get(file);
+		if (cached !== void 0) return cached;
 		const path = realPath(file);
-		return this.allRegistrations.find((registration) => isWithin(path, registration.root))?.name ?? "<external>";
+		const name = this.allRegistrations.find((registration) => isWithin(path, registration.root))?.name ?? "<external>";
+		this.packageNameByFile.set(file, name);
+		return name;
 	}
 	allocateNodeId(site) {
 		const location = this.locationKey(site);
@@ -2140,7 +2150,8 @@ function declarationText(declaration) {
 function classShape(node) {
 	const nonPublic = (member) => (ts.canHaveModifiers(member) ? ts.getModifiers(member) : void 0)?.some((modifier) => modifier.kind === ts.SyntaxKind.PrivateKeyword || modifier.kind === ts.SyntaxKind.ProtectedKeyword) ?? false;
 	const members = node.members.flatMap((member) => {
-		if (nonPublic(member) || ts.isPropertyDeclaration(member) && ts.isPrivateIdentifier(member.name)) return [];
+		const name = ts.getNameOfDeclaration(member);
+		if (ts.isClassStaticBlockDeclaration(member) || nonPublic(member) || name !== void 0 && ts.isPrivateIdentifier(name)) return [];
 		if (ts.isMethodDeclaration(member)) return [ts.factory.updateMethodDeclaration(member, member.modifiers, member.asteriskToken, member.name, member.questionToken, member.typeParameters, member.parameters, member.type, void 0)];
 		if (ts.isConstructorDeclaration(member)) return [ts.factory.updateConstructorDeclaration(member, member.modifiers, member.parameters, void 0)];
 		if (ts.isGetAccessorDeclaration(member)) return [ts.factory.updateGetAccessorDeclaration(member, member.modifiers, member.name, member.parameters, member.type, void 0)];
@@ -2383,8 +2394,14 @@ function formatProgramDiagnostic(root, face, diagnostic) {
 	return `typert(${face}): ${slash(relative(root, diagnostic.file.fileName))}:${String(position.line + 1)}:${String(position.character + 1)}: TypeScript TS${String(diagnostic.code)}: ${message}`;
 }
 const realPathCache = /* @__PURE__ */ new Map();
+/** Normalized form per requested path; `resolve` reads only the process working directory. */
+const absolutePathCache = /* @__PURE__ */ new Map();
 function realPath(path) {
-	const absolute = resolve(path);
+	let absolute = absolutePathCache.get(path);
+	if (absolute === void 0) {
+		absolute = resolve(path);
+		absolutePathCache.set(path, absolute);
+	}
 	const cached = realPathCache.get(absolute);
 	if (cached !== void 0) return cached;
 	if (!existsSync(absolute)) return absolute;

package/lib/types/analyzer.js

@@ -437,6 +437,9 @@ class FaceAnalyzer {
     nodes = new Map();
     exportsByPackage = new Map();
     nodeOrdinals = new Map();
+    /** Registration and package lookups per source path; the registration set is fixed per analyzer. */
+    registrationByFile = new Map();
+    packageNameByFile = new Map();
     staticLookups;
     staticContexts;
     constructor(options) {
@@ -556,8 +559,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));
@@ -2337,13 +2340,23 @@ class FaceAnalyzer {
         return `${this.packageNameForFile(declaration.getSourceFile().fileName)}:${location.file}#${symbol.name}`;
     }
     registrationForFile(file) {
+        if (this.registrationByFile.has(file))
+            return this.registrationByFile.get(file);
         const path = realPath(file);
-        return this.allRegistrations
+        const registration = this.allRegistrations
             .find(registration => registration.face === this.face && isWithin(path, registration.root));
+        this.registrationByFile.set(file, registration);
+        return registration;
     }
     packageNameForFile(file) {
+        const cached = this.packageNameByFile.get(file);
+        if (cached !== undefined)
+            return cached;
         const path = realPath(file);
-        return this.allRegistrations.find(registration => isWithin(path, registration.root))?.name ?? '<external>';
+        const name = this.allRegistrations
+            .find(registration => isWithin(path, registration.root))?.name ?? '<external>';
+        this.packageNameByFile.set(file, name);
+        return name;
     }
     allocateNodeId(site) {
         const location = this.locationKey(site);
@@ -2587,7 +2600,9 @@ function declarationText(declaration) {
 function classShape(node) {
     const nonPublic = (member) => (ts.canHaveModifiers(member) ? ts.getModifiers(member) : undefined)?.some(modifier => modifier.kind === ts.SyntaxKind.PrivateKeyword || modifier.kind === ts.SyntaxKind.ProtectedKeyword) ?? false;
     const members = node.members.flatMap((member) => {
-        if (nonPublic(member) || (ts.isPropertyDeclaration(member) && ts.isPrivateIdentifier(member.name)))
+        const name = ts.getNameOfDeclaration(member);
+        if (ts.isClassStaticBlockDeclaration(member) || nonPublic(member)
+            || (name !== undefined && ts.isPrivateIdentifier(name)))
             return [];
         if (ts.isMethodDeclaration(member)) {
             return [ts.factory.updateMethodDeclaration(member, member.modifiers, member.asteriskToken, member.name, member.questionToken, member.typeParameters, member.parameters, member.type, undefined)];
@@ -2865,8 +2880,14 @@ function formatProgramDiagnostic(root, face, diagnostic) {
     return `typert(${face}): ${file}:${String(position.line + 1)}:${String(position.character + 1)}: TypeScript TS${String(diagnostic.code)}: ${message}`;
 }
 const realPathCache = new Map();
+/** Normalized form per requested path; `resolve` reads only the process working directory. */
+const absolutePathCache = new Map();
 function realPath(path) {
-    const absolute = resolve(path);
+    let absolute = absolutePathCache.get(path);
+    if (absolute === undefined) {
+        absolute = resolve(path);
+        absolutePathCache.set(path, absolute);
+    }
     const cached = realPathCache.get(absolute);
     if (cached !== undefined)
         return cached;

package/lib/types/tsdown-plugin.js

@@ -10,10 +10,10 @@ import { dirname, join, resolve } from 'node:path';
 import ts from 'typescript';
 import { WorkspaceTypertGenerator } from "./workspace.js";
 const DECORATOR_SYNTAX = /^\s*@[A-Za-z_$][\w$]*/m;
-// This plugin consumes tsc-emitted `lib/types` output, so every project it
-// would re-diagnose has already passed the workspace tsc build in the same
-// orchestration; the generator skips its per-package diagnostic pass here.
-const TSC_VERIFIED_INPUT = { checkDiagnostics: false };
+// Full builds and typecheck own TypeScript diagnostics. Benchmark-only emission
+// defers them to the required full-build CI jobs; Typert generates reflection
+// without repeating those diagnostics.
+const TSC_OWNED_DIAGNOSTICS = { checkDiagnostics: false };
 /**
  * Create the decorator-lowering and typert-generation plugin for the root tsdown config.
  * @param pluginOptions - package/workspace emission mode and independent program faces.
@@ -64,7 +64,7 @@ export function typertPlugin(pluginOptions = {}) {
                 return;
             let artifacts = artifactsByRoot.get(root);
             if (artifacts === undefined) {
-                const generator = new WorkspaceTypertGenerator(root, TSC_VERIFIED_INPUT);
+                const generator = new WorkspaceTypertGenerator(root, TSC_OWNED_DIAGNOSTICS);
                 artifacts = pluginOptions.faces === undefined
                     ? generator.generate()
                     : generator.generate(undefined, pluginOptions.faces);
@@ -74,7 +74,7 @@ export function typertPlugin(pluginOptions = {}) {
         },
     };
     function emitWorkspace(root, faces) {
-        const generator = new WorkspaceTypertGenerator(root, TSC_VERIFIED_INPUT);
+        const generator = new WorkspaceTypertGenerator(root, TSC_OWNED_DIAGNOSTICS);
         const packages = generator.discover(faces)
             .filter(candidate => hasTypertExport(readManifest(join(root, candidate.root)).exports))
             .map(candidate => candidate.package);

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.2",
   "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.2",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "zod": "^4.4.3"
   }
 }