@supacloud/compiler 0.4.0 → 0.4.1

package/dist/analyze.d.ts

@@ -1,7 +1,7 @@
 import type { ApplicationGraph } from "./types";
 /**
- * 分析 rootDir 下的源码（ts-morph AST，无类型检查依赖），构建 ApplicationGraph。
- * 装饰器仅按名字匹配（Module/Injectable/Inject/Command/Query/Controller/Get/...），
- * 不校验 import 来源，因此本包不需要依赖 @supacloud/app。
+ * Analyzes source code under rootDir (via ts-morph AST, without typecheck dependency) to build ApplicationGraph.
+ * Decorators are matched by name only (Module/Injectable/Inject/Command/Query/Controller/Get/...),
+ * without checking import origins, so this package does not need to depend on @supacloud/app.
  */
 export declare function analyzeProject(rootDir: string, include?: string[]): Promise<ApplicationGraph>;

package/dist/compile.d.ts

@@ -1,7 +1,7 @@
 import type { CheckProjectResult, CompileOptions, CompileResult } from "./types";
 /**
- * 完整编译流程：AST 分析 → 校验 → 生成静态工厂代码与 manifest。
- * 即使存在 error 级诊断也会照常写出文件，由调用方根据 diagnostics 决定是否采用。
+ * Complete compilation pipeline: AST analysis -> validation -> generate static factory code and manifest.
+ * Files are emitted even when error-level diagnostics exist; caller decides adoption based on diagnostics.
  */
 export declare function compileProject(options: CompileOptions): Promise<CompileResult>;
 /**

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 /**
- * ApplicationGraph：编译器从源码 AST 构建出的静态应用图。
- * 运行期不反射、无容器，所有信息都在该结构与生成代码中显式给出。
+ * ApplicationGraph: Static application graph built by the compiler from source AST.
+ * No runtime reflection or container; all metadata is explicitly represented here and in generated code.
  */
 export type Scope = "application" | "request" | "job";
 export type ProviderKind = "class" | "value" | "factory" | "existing";
@@ -13,7 +13,7 @@ export interface Diagnostic {
     line?: number;
 }
 export interface ProviderNode {
-    /** token 名（InjectionToken 变量名或类名）。 */
+    /** Token name (InjectionToken variable name or class name). */
     token: string;
     tokenKind: TokenKind;
     kind: ProviderKind;
@@ -22,12 +22,12 @@ export interface ProviderNode {
     useFactoryName?: string;
     useExisting?: string;
     scope: Scope;
-    /** token 名，构造/工厂参数顺序。 */
+    /** Token names in constructor/factory parameter order. */
     deps: string[];
     exported: boolean;
     file: string;
     line: number;
-    /** useClass/useFactory/useValue 符号的模块相对路径（供生成 import）。 */
+    /** Relative module path of useClass/useFactory/useValue symbol (for import generation). */
     importPath?: string;
 }
 export interface RouteNode {
@@ -49,7 +49,7 @@ export interface ControllerNode {
     routes: RouteNode[];
     file: string;
     importPath: string;
-    /** 路由 schema 符号名 → 模块相对路径（供生成 import）。 */
+    /** Route schema symbol name -> relative module path (for import generation). */
     schemaImports?: Record<string, string>;
 }
 export interface CommandNode {
@@ -65,46 +65,46 @@ export interface QueryNode {
     name: string;
 }
 export interface ModuleNode {
-    /** @Module({ name }) 或 defineModule 的 name。 */
+    /** Name from @Module({ name }) or defineModule. */
     name: string;
     className: string;
-    /** 模块标签（如 ['scope:case', 'type:feature']），用于架构边界治理。 */
+    /** Module tags (e.g. ['scope:case', 'type:feature']) for architecture boundary governance. */
     tags?: string[];
     file: string;
     line: number;
-    /** 被 import 模块的 name。 */
+    /** Names of imported modules. */
     imports: string[];
     providers: ProviderNode[];
     controllers: ControllerNode[];
     commands: CommandNode[];
     queries: QueryNode[];
-    /** 导出的 token 名。 */
+    /** Exported token names. */
     exports: string[];
 }
 export interface ApplicationGraph {
     modules: ModuleNode[];
-    /** 被依赖但无任何模块提供的 token 名（平台注入）。 */
+    /** Depended token names provided by platform injection rather than any module. */
     externalTokens: string[];
     /**
-     * 分析阶段产生的诊断（如 missing-deps），由 compileProject 合并进结果。
-     * 不写入 app.manifest.json。
+     * Diagnostics produced during analysis (e.g. missing-deps), merged by compileProject.
+     * Omitted from app.manifest.json.
      */
     diagnostics?: Diagnostic[];
     /**
-     * InjectionToken 变量名 → 字符串 name（如 REQUEST_CONTEXT →
-     * "supacloud.request-context"），供代码生成识别内置上下文 token。
-     * 不写入 app.manifest.json。
+     * InjectionToken variable name -> string name (e.g. REQUEST_CONTEXT ->
+     * "supacloud.request-context"), used during code generation to identify built-in context tokens.
+     * Omitted from app.manifest.json.
      */
     tokenNames?: Record<string, string>;
 }
 export interface CompileOptions {
-    /** 项目根（含 tsconfig）。 */
+    /** Project root directory (containing tsconfig). */
     rootDir: string;
-    /** glob，默认 ['**\/*.module.ts', '**\/*.ts']。 */
+    /** Glob patterns, defaults to ['**\/*.module.ts', '**\/*.ts']. */
     include?: string[];
-    /** 生成目录（如 <rootDir>/generated）。 */
+    /** Output directory (e.g. <rootDir>/generated). */
     outDir: string;
-    /** warn 级诊断升级为 error。 */
+    /** Upgrade warn-level diagnostics to error. */
     strict?: boolean;
     /** Built-in architecture boundary preset (for example, 'modular-monolith'). */
     moduleBoundaryPreset?: ModuleBoundaryPresetName;

package/dist/util.d.ts

@@ -1,15 +1,15 @@
 /**
- * token 名 → services 对象的 key。
- * CASE_REPOSITORY → caseRepository、LOGGER → logger（常量命名转 camelCase），
- * CaseService → caseService（PascalCase 首字母小写）。
+ * Token name -> key in services object.
+ * CASE_REPOSITORY -> caseRepository, LOGGER -> logger (convert CONSTANT_CASE to camelCase),
+ * CaseService -> caseService (lowercase first letter of PascalCase).
  */
 export declare function camelName(token: string): string;
-/** 计算 from 目录到 to 文件的相对 import 路径（去扩展名，保证 ./ 或 ../ 前缀）。 */
+/** Computes relative import path from fromDir to toFile (stripping extension, ensuring ./ or ../ prefix). */
 export declare function relativeImportPath(fromDir: string, toFile: string): string;
-/** 内置上下文 token 的字符串 name（与 @supacloud/app 的 REQUEST_CONTEXT/JOB_CONTEXT 对齐）。 */
+/** String names of built-in context tokens (aligned with REQUEST_CONTEXT/JOB_CONTEXT in @supacloud/app). */
 export declare const REQUEST_CONTEXT_TOKEN_NAME = "supacloud.request-context";
 export declare const JOB_CONTEXT_TOKEN_NAME = "supacloud.job-context";
-/** 判断 token 是否为内置 request 上下文（变量名 REQUEST_CONTEXT 或 token name 匹配）。 */
+/** Determines whether token is built-in request context (variable name REQUEST_CONTEXT or matching token name). */
 export declare function isRequestContextToken(token: string, tokenNames?: Record<string, string>): boolean;
-/** 判断 token 是否为内置 job 上下文。 */
+/** Determines whether token is built-in job context. */
 export declare function isJobContextToken(token: string, tokenNames?: Record<string, string>): boolean;

package/dist/validate.d.ts

@@ -1,6 +1,6 @@
 import type { ApplicationGraph, Diagnostic, ValidateOptions } from "./types";
 /**
- * 校验 ApplicationGraph，产出诊断列表。
- * strict 时 warn 级诊断升级为 error。
+ * Validates ApplicationGraph and produces diagnostics list.
+ * In strict mode, warn-level diagnostics are promoted to error.
  */
 export declare function validateGraph(graph: ApplicationGraph, options?: boolean | ValidateOptions): Diagnostic[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",