@hadss/turbo-trans-json-plugin 1.0.0-rc.1 → 1.0.0-rc.2

package/src/json-plugin/tasks/BaseTask.ts

@@ -13,10 +13,12 @@
  * limitations under the License.
  */
 
-import { ITask, Logger, ImportRewriteServiceImpl, ConfigManager, CodeGenerationEngine } from '../../core';
+import {
+  ITask, Logger, ImportRewriteServiceImpl, ConfigManager, CodeGenerationEngine, IGenerationResult
+} from '../../core';
 import { BuildProfileUpdaterImpl } from '../../core/import-rewrite/services/BuildProfileUpdater';
 import { ITargetContext } from '../interfaces/ITargetContext';
-import {TaskConstants} from '../constants/TaskConstants';
+import { TaskConstants } from '../constants/TaskConstants';
 import SerializationPathUtil from '../../core/utils/SerializationPathUtil';
 
 export abstract class BaseTask implements ITask {
@@ -38,7 +40,7 @@ export abstract class BaseTask implements ITask {
     return scanFiles;
   }
 
-  protected processWithLogging(scanFiles: string[], context: ITargetContext, taskName: string) {
+  protected processWithLogging(scanFiles: string[], context: ITargetContext, taskName: string): IGenerationResult {
     Logger.debug(`Start executing ${taskName} and process ${scanFiles.length} files`);
 
     this.buildProfileUpdater.updateSourceRoots(context); // 更新builde-profile.json5中的sourceRoot

package/src/json-plugin/tasks/CleanTask.ts

@@ -19,18 +19,18 @@ import { ITargetContext } from '../interfaces/ITargetContext';
 import SerializationPathUtil from '../../core/utils/SerializationPathUtil';
 
 export class CleanTask implements ITask {
-  readonly taskName: string = TaskConstants.CLEAN_TASK
-  readonly dependencies: string[] = [] // CLI任务无依赖
-  readonly postDependencies: string[] = [] // CLI任务无依赖
+  readonly taskName: string = TaskConstants.CLEAN_TASK;
+  readonly dependencies: string[] = []; // CLI任务无依赖
+  readonly postDependencies: string[] = []; // CLI任务无依赖
 
   run(context: ITargetContext): void {
-    Logger.info('Start the code cleaning task')
+    Logger.info('Start the code cleaning task');
 
-    const generatedRootDir = context.getOutputRoot()
+    const generatedRootDir: string = context.getOutputRoot();
 
     if (SerializationPathUtil.exist(generatedRootDir)) {
-      Logger.info(`Clean up the generated directory: ${generatedRootDir}`)
-      SerializationPathUtil.rmSync(generatedRootDir, { recursive: true, force: true })
+      Logger.info(`Clean up the generated directory: ${generatedRootDir}`);
+      SerializationPathUtil.rmSync(generatedRootDir, { recursive: true, force: true });
     }
   }
 }

package/src/json-plugin/tasks/WatchTask.ts

@@ -55,45 +55,47 @@ export class WatchTask extends BaseTask {
   }
 
   private setupWatchEvents(context: ITargetContext): void {
-    if (!this.watcher) return
+    if (!this.watcher) {
+      return;
+    }
 
-    let debounceTimer: NodeJS.Timeout | null = null
+    let debounceTimer: NodeJS.Timeout | null = null;
 
     // 防抖处理，避免频繁触发
-    const debouncedGenerate = (filePath: string) => {
+    const debouncedGenerate: (filePath: string) => void = (filePath: string) => {
       if (debounceTimer) {
-        clearTimeout(debounceTimer)
+        clearTimeout(debounceTimer);
       }
       debounceTimer = setTimeout(() => {
-        this.generateCode(filePath, context)
-      }, 500) // 500ms 防抖
-    }
+        this.generateCode(filePath, context);
+      }, 500); // 500ms 防抖
+    };
 
     this.watcher
       .on('add', (filePath: string) => {
-        Logger.info(`New file detected: ${filePath}`)
-        debouncedGenerate(filePath)
+        Logger.info(`New file detected: ${filePath}`);
+        debouncedGenerate(filePath);
       })
       .on('change', (filePath: string) => {
-        Logger.info(`File change detected: ${filePath}`)
-        debouncedGenerate(filePath)
+        Logger.info(`File change detected: ${filePath}`);
+        debouncedGenerate(filePath);
       })
       .on('unlink', (filePath: string) => {
-        Logger.info(`File deletion detected: ${filePath}`)
-        debouncedGenerate(filePath)
+        Logger.info(`File deletion detected: ${filePath}`);
+        debouncedGenerate(filePath);
       })
       .on('error', (error: unknown) => {
-        Logger.error(`File monitoring error: ${error}`)
+        Logger.error(`File monitoring error: ${error}`);
       })
       .on('ready', () => {
-        Logger.info('The initial file scan is complete. Start listening for file changes...')
-      })
+        Logger.info('The initial file scan is complete. Start listening for file changes...');
+      });
   }
 
   private generateCode(scanFile: string, context: ITargetContext): void {
     // 统一处理：逐文件分析 → 直接生成
-    const processingResult = this.engine.processFileUnified(scanFile, context)
+    const processingResult = this.engine.processFileUnified(scanFile, context);
 
-    Logger.info(`The code generation is complete, and the output path is ${processingResult?.outputPath}`)
+    Logger.info(`The code generation is complete, and the output path is ${processingResult?.outputPath}`);
   }
 }

package/template/SerializerPerformanceTemplate.hbs

@@ -7,7 +7,7 @@ deserialize(decoder: Decoder, plain: ESObject): {{class.className}}{{#if class.g
     const result = new {{class.className}}{{#if class.generics.isGeneric}}<{{genericParametersString class.generics.parameters}}>{{/if}}(
     {{#each (getCtorProperties class.constructorParams properties)}}
       {{#unless analysis.decorators.isTransient}}
-        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{analysis.name}}Serializer.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}}{{#unless @last}},{{/unless}}
+        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{getSerializer analysis}}.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}}{{#unless @last}},{{/unless}}
       {{/unless}}
     {{/each}});
   {{else}}
@@ -23,19 +23,19 @@ deserialize(decoder: Decoder, plain: ESObject): {{class.className}}{{#if class.g
       {{! 有默认值的属性 }}
       {{#if (eq analysis.visibility "private")}}
       ObjectUtils.setProp(result, '{{analysis.name}}', {{analysis.name}}PlainValue === undefined ? {{analysis.defaultValue}} :
-        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{analysis.name}}Serializer.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}});
+        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{getSerializer analysis}}.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}});
       {{else}}
       result.{{analysis.name}} = {{analysis.name}}PlainValue === undefined ? {{analysis.defaultValue}} :
-        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{analysis.name}}Serializer.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}};
+        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{getSerializer analysis}}.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}};
       {{/if}}
       {{else}}
       {{! 无默认值的属性 }}
       {{#if (eq analysis.visibility "private")}}
       ObjectUtils.setProp(result, '{{analysis.name}}', {{analysis.name}}PlainValue === undefined ? undefined :
-        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{analysis.name}}Serializer.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}});
+        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{getSerializer analysis}}.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}});
       {{else}}
       result.{{analysis.name}} = {{analysis.name}}PlainValue === undefined ? undefined :
-        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{analysis.name}}Serializer.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}};
+        {{#if analysis.decorators.isPlainValue}}plain[keys[{{getPropertyIndex this ../properties}}]]{{else}}{{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}decoder.{{serializer.decodeMethod}}(plain[keys[{{getPropertyIndex this ../properties}}]]){{else}}this.{{getSerializer analysis}}.deserialize(decoder, plain[keys[{{getPropertyIndex this ../properties}}]]){{/if}}{{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}}{{/if}};
       {{/if}}
       {{/if}}
     {{/unless}}

package/template/SerializerStrictTemplate.hbs

@@ -33,7 +33,7 @@ deserialize(decoder: Decoder, plain: ESObject): {{class.className}}{{#if class.g
         {{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}
         {{analysis.name}}Value = decoder.{{serializer.decodeMethod}}(value);
         {{else}}
-        {{analysis.name}}Value = this.{{analysis.name}}Serializer.deserialize(decoder, value){{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}};
+        {{analysis.name}}Value = this.{{getSerializer analysis}}.deserialize(decoder, value){{#if serializer.needsTypeAssertion}} as {{analysis.type.sourceText}}{{/if}};
         {{/if}}
         {{/if}}
         break;

package/template/SerializerTemplate.hbs

@@ -14,11 +14,15 @@ export class {{class.className}}Serializer<{{genericParametersString class.gener
   {{! 属性序列化器声明 }}
   {{#each properties}}
     {{#unless (eqPrimitiveType analysis.type.kind)}}
-    private readonly {{analysis.name}}Serializer: {{serializer.typeDeclaration}};
+    private get{{toUpperCase analysis.name}}Serializer: () => {{serializer.typeDeclaration}};
     {{/unless}}
   {{/each}}
 
-  readonly serialDescriptor: SerialDescriptor;
+  private getSerialDescriptor: () => SerialDescriptor;
+
+  get serialDescriptor(): SerialDescriptor {
+    return this.getSerialDescriptor();
+  }
 
   constructor(
     {{#each class.generics.parameters}}
@@ -29,39 +33,37 @@ export class {{class.className}}Serializer<{{genericParametersString class.gener
     {{! 初始化属性序列化器 }}
     {{#each properties}}
       {{#unless (eqPrimitiveType analysis.type.kind)}}
-      this.{{analysis.name}}Serializer = {{serializer.instantiationTemplate}};
+      this.get{{toUpperCase analysis.name}}Serializer = () => {
+        const serializer: {{serializer.typeDeclaration}} = {{serializer.instantiationTemplate}};
+        this.get{{toUpperCase analysis.name}}Serializer = () => serializer;
+        return serializer;
+      };
       {{/unless}}
     {{/each}}
 
-    this.serialDescriptor = buildClassSerialDescriptor(
-      {{class.className}}_SERIAL_NAME,
-      builder => {
-        {{#each properties}}
-          {{! 处理数字属性名的特殊情况 }}
-          {{#if (isNumericPropertyName (formatPropertyName analysis))}}
-          builder.element({
-            elementName: '{{formatPropertyName analysis}}',
-            elementDecodingName: this.fixNonNegativeIntegerElementName('{{formatPropertyName analysis}}'),
-            descriptor:
-              {{#if (eqPrimitiveType analysis.type.kind)}}
-                {{serializer.name}}.INSTANCE.serialDescriptor
-              {{else}}
-                this.{{analysis.name}}Serializer.serialDescriptor
-              {{/if}}
-          });
-          {{else}}
-          builder.element({
-            elementName: '{{formatPropertyName analysis}}',
-            descriptor:
-              {{#if (eqPrimitiveType analysis.type.kind)}}
-                {{serializer.name}}.INSTANCE.serialDescriptor
-              {{else}}
-                this.{{analysis.name}}Serializer.serialDescriptor
+    this.getSerialDescriptor = () => {
+      const descriptor: SerialDescriptor = buildClassSerialDescriptor(
+        {{class.className}}_SERIAL_NAME,
+        builder => {
+          {{#each properties}}
+            {{! 处理数字属性名的特殊情况 }}
+            builder.element({
+              elementName: '{{formatPropertyName analysis}}',
+              {{#if (isNumericPropertyName (formatPropertyName analysis))}}
+              elementDecodingName: this.fixNonNegativeIntegerElementName('{{formatPropertyName analysis}}'),
               {{/if}}
-          });
-          {{/if}}
-        {{/each}}
-      });
+              descriptor:
+                {{#if (eqPrimitiveType analysis.type.kind)}}
+                  {{serializer.name}}.INSTANCE.serialDescriptor
+                {{else}}
+                  lazy(() => this.{{getSerializer analysis}}.serialDescriptor)
+                {{/if}}
+            });
+          {{/each}}
+        });
+      this.getSerialDescriptor = () => descriptor;
+      return descriptor;
+    }
   }
 {{else}}
 {{! 非泛型类：单例模式 }}
@@ -78,30 +80,45 @@ export class {{class.className}}Serializer extends Serializer<{{class.className}
 
   {{! 属性序列化器声明 }}
   {{#each properties}}
+    {{#if (eqPrimitiveType analysis.type.kind)}}
     private readonly {{analysis.name}}Serializer: {{serializer.typeDeclaration}} = {{serializer.instantiationTemplate}};
+    {{else}}
+    private get{{toUpperCase analysis.name}}Serializer: () => {{serializer.typeDeclaration}} = () => {
+      const serializer: {{serializer.typeDeclaration}} = {{serializer.instantiationTemplate}};
+      this.get{{toUpperCase analysis.name}}Serializer = () => serializer;
+      return serializer;
+    };
+    {{/if}}
   {{/each}}
 
   {{! 序列描述符构建 }}
-  readonly serialDescriptor: SerialDescriptor = buildClassSerialDescriptor(
+  private getSerialDescriptor: () => SerialDescriptor = () => {
+    const descriptor: SerialDescriptor = buildClassSerialDescriptor(
       {{class.className}}_SERIAL_NAME,
       builder => {
         {{#each properties}}
-          {{! 处理数字属性名的特殊情况 }}
-          {{#if (isNumericPropertyName (formatPropertyName analysis))}}
           builder.element({
             elementName: '{{formatPropertyName analysis}}',
+            {{! 处理数字属性名的特殊情况 }}
+            {{#if (isNumericPropertyName (formatPropertyName analysis))}}
             elementDecodingName: this.fixNonNegativeIntegerElementName('{{formatPropertyName analysis}}'),
+            {{/if}}
+            {{#if (eqPrimitiveType analysis.type.kind)}}
             descriptor: this.{{analysis.name}}Serializer.serialDescriptor
+            {{else}}
+            descriptor: lazy(() => this.{{getSerializer analysis}}.serialDescriptor)
+            {{/if}}
           });
-          {{else}}
-          builder.element({
-            elementName: '{{formatPropertyName analysis}}',
-            descriptor: this.{{analysis.name}}Serializer.serialDescriptor
-          });
-          {{/if}}
         {{/each}}
       }
     )
+    this.getSerialDescriptor = () => descriptor;
+    return descriptor;
+  }
+
+  get serialDescriptor(): SerialDescriptor {
+    return this.getSerialDescriptor();
+  }
 
   private constructor() {
     super();
@@ -130,13 +147,13 @@ export class {{class.className}}Serializer extends Serializer<{{class.className}
         {{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}
           encoder.{{serializer.encodeMethod}}(result, keys[{{@index}}], ObjectUtils.getProp(value, '{{analysis.name}}'));
         {{else}}
-          encoder.encodeSerializableElement(result, keys[{{@index}}], this.{{analysis.name}}Serializer, ObjectUtils.getProp(value, '{{analysis.name}}'));
+          encoder.encodeSerializableElement(result, keys[{{@index}}], this.{{getSerializer analysis}}, ObjectUtils.getProp(value, '{{analysis.name}}'));
         {{/if}}
       {{else}}
         {{#if (and (eqPrimitiveType analysis.type.kind) (not (hasDecoratorWith analysis.decorators)))}}
           encoder.{{serializer.encodeMethod}}(result, keys[{{@index}}], value.{{analysis.name}});
         {{else}}
-          encoder.encodeSerializableElement(result, keys[{{@index}}], this.{{analysis.name}}Serializer, value.{{analysis.name}});
+          encoder.encodeSerializableElement(result, keys[{{@index}}], this.{{getSerializer analysis}}, value.{{analysis.name}});
         {{/if}}
       {{/if}}
     {{/each}}