klasik 2.0.0 → 2.0.2

package/README.md

@@ -860,4 +860,4 @@ Built with:
 
 ---
 
-**Note:** Klasik 2.0 is a complete rebuild with AST-based code generation, replacing the string manipulation approach from v1. See [ARCHITECTURE.md](ARCHITECTURE.md) for technical details.
+**Note:** Klasik is a complete rebuild with AST-based code generation, replacing the string manipulation approach from v1. See [ARCHITECTURE.md](ARCHITECTURE.md) for technical details.

package/dist/generator/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,QAAQ,EAET,MAAM,aAAa,CAAC;AAErB,OAAO,EAAmC,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAQ9F;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,EAAE,gBAAgB;IAqBrC;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC3C;;OAEG;YACW,cAAc;IAY5B;;OAEG;YACW,aAAa;IAqE3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;YACW,mBAAmB;IA0CjC;;OAEG;YACW,mBAAmB;IAyBjC;;OAEG;YACW,gBAAgB;IA+B9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,QAAQ,EAET,MAAM,aAAa,CAAC;AAErB,OAAO,EAAmC,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAQ9F;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,EAAE,gBAAgB;IAqBrC;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC3C;;OAEG;YACW,cAAc;IAY5B;;OAEG;YACW,aAAa;IAqE3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;YACW,mBAAmB;IA0CjC;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;YACW,gBAAgB;IA+B9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}

package/dist/generator/generator.js

@@ -87,10 +87,12 @@ class Generator {
         console.log(`Generating ${ir.schemas.size} model(s)...`);
         await this.generateModels(ir, context);
         // Generate API client if in full mode and operations exist
+        let hasApiClient = false;
         if (this.options.mode === 'full' && ir.operations.size > 0) {
             const { ApiClientGenerator } = await Promise.resolve().then(() => __importStar(require('../generators/api-client-generator')));
             const apiClientGenerator = new ApiClientGenerator(this.options);
             await apiClientGenerator.generateFullClient(ir);
+            hasApiClient = true;
         }
         // Run after generation hooks
         await this.pluginRunner.runAfterGeneration(context, ir);
@@ -98,7 +100,7 @@ class Generator {
         console.log('Saving generated files...');
         await this.project.save();
         // Generate package.json
-        await this.generatePackageJson(context);
+        await this.generatePackageJson(context, hasApiClient);
         // Generate tsconfig.json
         await this.generateTsConfig();
         console.log('✅ Code generation completed successfully!');
@@ -252,7 +254,7 @@ class Generator {
     /**
      * Generate package.json
      */
-    async generatePackageJson(context) {
+    async generatePackageJson(context, hasApiClient) {
         const packageJson = {
             name: 'generated-models',
             version: '1.0.0',
@@ -262,6 +264,10 @@ class Generator {
             type: this.options.esm ? 'module' : 'commonjs',
             dependencies: {},
         };
+        // Add axios if API client was generated
+        if (hasApiClient) {
+            packageJson.dependencies['axios'] = '^1.6.0';
+        }
         // Run plugin hooks to modify package.json
         await this.pluginRunner.runModifyPackageJson(packageJson, context);
         // Write package.json

package/dist/generator/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Klasik 2.0 - TypeScript Code Generator
+ * Klasik - TypeScript Code Generator
  *
  * Public API exports
  */

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Klasik 2.0 - TypeScript Code Generator
+ * Klasik - TypeScript Code Generator
  *
  * Public API exports
  */

package/docs/ARCHITECTURE.md

@@ -0,0 +1,845 @@
+# Klasik Architecture
+
+This document provides technical implementation details for developers who want to understand, modify, or contribute to Klasik.
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Why ts-morph?](#why-ts-morph)
+- [Why Plugin Architecture?](#why-plugin-architecture)
+- [Why Intermediate Representation (IR)?](#why-intermediate-representation-ir)
+- [Architecture Components](#architecture-components)
+- [Code Generation Pipeline](#code-generation-pipeline)
+- [Plugin System](#plugin-system)
+- [Testing Strategy](#testing-strategy)
+- [Development Guide](#development-guide)
+
+## Overview
+
+- **Type Safety**: Generated code is parsed and validated as TypeScript AST
+- **Maintainability**: AST manipulation is more robust than string concatenation
+- **Extensibility**: Plugin architecture allows easy feature additions
+- **Format Agnostic**: Unified IR handles OpenAPI, CRDs, and JSON Schema
+
+## Why ts-morph?
+
+### Problem with String-Based Generation
+
+The original Klasik used template strings and manual code construction:
+
+```typescript
+// Original Klasik v1 approach
+let code = `export class ${className} {\n`;
+code += `  ${propertyName}: ${propertyType};\n`;
+code += `}\n`;
+```
+
+**Issues:**
+- ❌ No syntax validation until runtime
+- ❌ Hard to maintain complex structures (decorators, imports, etc.)
+- ❌ String escaping complexity
+- ❌ Difficult to refactor or modify generated code
+- ❌ No IDE support for template content
+
+### Solution: AST-Based Generation
+
+Klasik uses ts-morph to build proper TypeScript Abstract Syntax Trees:
+
+```typescript
+// Klasik approach
+const classDeclaration = sourceFile.addClass({
+  name: className,
+  isExported: true
+});
+
+classDeclaration.addProperty({
+  name: propertyName,
+  type: propertyType,
+  decorators: [
+    { name: 'Expose', arguments: [] },
+    { name: 'ApiProperty', arguments: ['{ type: String }'] }
+  ]
+});
+```
+
+**Benefits:**
+- ✅ TypeScript-validated AST construction
+- ✅ Automatic formatting and indentation
+- ✅ Type-safe API for code manipulation
+- ✅ Built-in import management
+- ✅ Easier to test and maintain
+- ✅ IDE autocomplete and type checking
+
+### Performance Considerations
+
+While AST manipulation is slightly slower than string concatenation, the benefits far outweigh the cost:
+
+- **Correctness**: Generated code is always syntactically valid
+- **Maintainability**: Changes to generation logic are easier and safer
+- **Debugging**: AST nodes can be inspected and validated
+- **Testing**: Unit tests can verify AST structure without running TypeScript compiler
+
+## Why Plugin Architecture?
+
+### Problem with Monolithic Code Generation
+
+Original Klasik had all generation logic in a single large module:
+- Hard to add new features without breaking existing code
+- Difficult to test individual features in isolation
+- No way to selectively enable/disable features
+- Code duplication across different generators
+
+### Solution: Hook-Based Plugin System
+
+Klasik uses a priority-ordered hook system:
+
+```typescript
+interface Plugin {
+  name: string;
+  priority: number;
+
+  hooks: {
+    beforeGeneration?(context: GenerationContext): void;
+    onSchemaLoad?(schema: SchemaIR): void;
+    onClassGeneration?(classNode: ClassDeclaration, schema: ObjectSchema): void;
+    onPropertyGeneration?(property: PropertyDeclaration, field: Field): void;
+    afterGeneration?(context: GenerationContext): void;
+  };
+}
+```
+
+**Benefits:**
+- ✅ **Modularity**: Each feature is a self-contained plugin
+- ✅ **Testability**: Plugins can be tested independently
+- ✅ **Extensibility**: Add new features without modifying core
+- ✅ **Flexibility**: Users can enable/disable features via CLI flags
+- ✅ **Priority Control**: Plugins execute in defined order
+
+### Plugin Examples
+
+**1. NestJS Swagger Plugin**
+```typescript
+class NestJSSwaggerPlugin implements Plugin {
+  name = 'nestjs-swagger';
+  priority = 100;
+
+  hooks = {
+    onPropertyGeneration(property, field) {
+      property.addDecorator({
+        name: 'ApiProperty',
+        arguments: [`{ type: ${field.type}, required: ${field.required} }`]
+      });
+    }
+  };
+}
+```
+
+**2. Class Validator Plugin**
+```typescript
+class ClassValidatorPlugin implements Plugin {
+  name = 'class-validator';
+  priority = 90;
+
+  hooks = {
+    onPropertyGeneration(property, field) {
+      if (field.required) {
+        property.addDecorator({ name: 'IsNotEmpty' });
+      }
+      if (field.type === 'string') {
+        property.addDecorator({ name: 'IsString' });
+      }
+    }
+  };
+}
+```
+
+**3. ESM Plugin**
+```typescript
+class ESMPlugin implements Plugin {
+  name = 'esm';
+  priority = 200; // Runs after others
+
+  hooks = {
+    afterGeneration(context) {
+      // Add .js extensions to all imports
+      for (const sourceFile of context.project.getSourceFiles()) {
+        for (const importDecl of sourceFile.getImportDeclarations()) {
+          const moduleSpecifier = importDecl.getModuleSpecifierValue();
+          if (moduleSpecifier.startsWith('./') && !moduleSpecifier.endsWith('.js')) {
+            importDecl.setModuleSpecifier(moduleSpecifier + '.js');
+          }
+        }
+      }
+    }
+  };
+}
+```
+
+### Plugin Priority System
+
+Plugins execute in priority order (lower numbers first):
+
+1. **Core plugins** (priority 0-50): Base class-transformer decorators
+2. **Feature plugins** (priority 50-150): NestJS, class-validator
+3. **Transform plugins** (priority 150-200): ESM, custom templates
+4. **Finalization plugins** (priority 200+): Formatting, validation
+
+## Why Intermediate Representation (IR)?
+
+### Problem with Format-Specific Generators
+
+Without IR, each input format needs its own generator:
+
+```
+OpenAPI → OpenAPI Generator → TypeScript
+CRD → CRD Generator → TypeScript
+JSON Schema → JSON Schema Generator → TypeScript
+```
+
+This leads to:
+- ❌ Code duplication across generators
+- ❌ Inconsistent output for similar schemas
+- ❌ Hard to add new input formats
+- ❌ Difficult to maintain shared features
+
+### Solution: Unified IR Layer
+
+Klasik uses a unified Intermediate Representation:
+
+```
+OpenAPI ──┐
+          ├──→ SchemaIR ──→ TypeScript Generator ──→ TypeScript
+CRD ──────┤
+          │
+JSON Schema ─┘
+```
+
+**IR Structure:**
+
+```typescript
+interface SchemaIR {
+  schemas: Map<string, ObjectSchema>;
+  metadata: {
+    sourceFormat: 'openapi' | 'crd' | 'jsonschema';
+    version: string;
+  };
+}
+
+interface ObjectSchema {
+  name: string;
+  description?: string;
+  fields: Field[];
+  required: string[];
+}
+
+interface Field {
+  name: string;
+  type: string;
+  description?: string;
+  required: boolean;
+  array?: boolean;
+  enum?: string[];
+  format?: string;
+}
+```
+
+**Benefits:**
+- ✅ **Single Source of Truth**: One generator for all formats
+- ✅ **Consistency**: Same TypeScript output for equivalent schemas
+- ✅ **Extensibility**: Add new formats by implementing IR converter
+- ✅ **Testability**: Test converters and generator separately
+- ✅ **Optimization**: Transform IR before generation (deduplication, normalization)
+
+### IR Conversion Flow
+
+**OpenAPI to IR:**
+```typescript
+OpenAPILoader.load(spec)
+  → OpenAPIConverter.toIR(spec)
+  → SchemaIR
+```
+
+**CRD to IR:**
+```typescript
+CRDLoader.load(yaml)
+  → CRDConverter.toIR(crd)
+  → SchemaIR
+  → mergeIRs() // Deduplication for multiple CRDs
+```
+
+**JSON Schema to IR:**
+```typescript
+JSONSchemaLoader.load(schema)
+  → JSONSchemaConverter.toIR(schema)
+  → SchemaIR
+```
+
+## Architecture Components
+
+### 1. Loaders (`src/loaders/`)
+
+Responsible for fetching and parsing input specifications:
+
+- **SpecLoader**: Fetches from URL or file, detects format (JSON/YAML)
+- **CRDLoader**: Loads Kubernetes CRDs, handles multi-document YAML
+- **JSONSchemaLoader**: Loads JSON Schema files
+
+**Key Features:**
+- HTTP/HTTPS support with custom headers
+- File system support
+- Automatic format detection
+- External reference resolution (`--resolve-refs`)
+
+### 2. Converters (`src/converters/`)
+
+Transform input specifications to IR:
+
+- **OpenAPIConverter**: OpenAPI 3.0 → SchemaIR
+- **CRDConverter**: Kubernetes CRD → SchemaIR
+- **JSONSchemaConverter**: JSON Schema → SchemaIR
+
+**Responsibilities:**
+- Schema traversal and extraction
+- Type mapping (OpenAPI types → TypeScript types)
+- Reference resolution
+- Metadata extraction
+
+### 3. Intermediate Representation (`src/ir/`)
+
+Core data structures:
+
+- **SchemaIR**: Top-level container
+- **ObjectSchema**: Class/interface representation
+- **Field**: Property representation
+- **IRHelpers**: Utility functions for IR manipulation
+
+### 4. Generator (`src/generator/`)
+
+Produces TypeScript code from IR:
+
+- **ClassGenerator**: Creates class declarations
+- **PropertyGenerator**: Creates property declarations with decorators
+- **ImportGenerator**: Manages import statements
+- **ExportGenerator**: Creates barrel exports (index.ts)
+
+**Uses ts-morph for:**
+- AST construction
+- Import management
+- Formatting and pretty-printing
+- Type-safe code generation
+
+### 5. Plugins (`src/plugins/`)
+
+Feature extensions:
+
+- **CorePlugin**: Base class-transformer decorators (@Expose, @Type)
+- **NestJSSwaggerPlugin**: @ApiProperty decorators (--nestjs-swagger)
+- **ClassValidatorPlugin**: Validation decorators (--class-validator)
+- **ESMPlugin**: .js extension injection (--esm)
+
+### 6. CLI (`src/cli/`)
+
+Command-line interface:
+
+- **generate**: OpenAPI → TypeScript
+- **download**: Download spec without generation
+- **generate-crd**: Kubernetes CRD → TypeScript
+- **generate-jsonschema**: JSON Schema → TypeScript
+
+## Code Generation Pipeline
+
+### Full Pipeline Flow
+
+```
+1. INPUT
+   ├─ User runs CLI command
+   ├─ Parse CLI arguments
+   └─ Initialize configuration
+
+2. LOADING
+   ├─ SpecLoader fetches specification
+   ├─ Detect format (JSON/YAML)
+   ├─ Parse with js-yaml or JSON.parse()
+   └─ Resolve external $refs if --resolve-refs
+
+3. CONVERSION
+   ├─ Select converter based on input format
+   ├─ Convert to SchemaIR
+   ├─ Merge IRs if multiple inputs (CRDs)
+   └─ Normalize and deduplicate
+
+4. PLUGIN INITIALIZATION
+   ├─ Load enabled plugins based on CLI flags
+   ├─ Sort by priority
+   └─ Call beforeGeneration hooks
+
+5. GENERATION
+   ├─ Create ts-morph Project
+   ├─ For each schema in IR:
+   │   ├─ Create SourceFile
+   │   ├─ Call onSchemaLoad hooks
+   │   ├─ Generate class declaration
+   │   ├─ Call onClassGeneration hooks
+   │   ├─ For each field:
+   │   │   ├─ Generate property
+   │   │   └─ Call onPropertyGeneration hooks
+   │   └─ Add imports
+   ├─ Generate index.ts (barrel exports)
+   └─ Call afterGeneration hooks
+
+6. OUTPUT
+   ├─ Format all files (prettier via ts-morph)
+   ├─ Write to disk
+   └─ Report statistics
+```
+
+### Example: Generating a Simple Class
+
+**Input OpenAPI Schema:**
+```yaml
+components:
+  schemas:
+    User:
+      type: object
+      required:
+        - id
+        - email
+      properties:
+        id:
+          type: string
+          format: uuid
+        email:
+          type: string
+          format: email
+        name:
+          type: string
+```
+
+**Step 1: Convert to IR**
+```typescript
+{
+  name: 'User',
+  fields: [
+    { name: 'id', type: 'string', required: true, format: 'uuid' },
+    { name: 'email', type: 'string', required: true, format: 'email' },
+    { name: 'name', type: 'string', required: false }
+  ],
+  required: ['id', 'email']
+}
+```
+
+**Step 2: Generate AST**
+```typescript
+const classDecl = sourceFile.addClass({
+  name: 'User',
+  isExported: true
+});
+
+// Core plugin adds @Expose
+classDecl.addProperty({
+  name: 'id',
+  type: 'string',
+  decorators: [{ name: 'Expose' }, { name: 'IsUUID' }]
+});
+```
+
+**Step 3: Output TypeScript**
+```typescript
+import { Expose } from 'class-transformer';
+import { IsUUID, IsEmail, IsString, IsOptional } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class User {
+  @Expose()
+  @ApiProperty({ type: String, format: 'uuid', required: true })
+  @IsUUID()
+  id: string;
+
+  @Expose()
+  @ApiProperty({ type: String, format: 'email', required: true })
+  @IsEmail()
+  email: string;
+
+  @Expose()
+  @ApiProperty({ type: String, required: false })
+  @IsOptional()
+  @IsString()
+  name?: string;
+}
+```
+
+## Plugin System
+
+### Creating a Custom Plugin
+
+```typescript
+import { Plugin, GenerationContext, ObjectSchema, Field } from 'klasik';
+import { ClassDeclaration, PropertyDeclaration } from 'ts-morph';
+
+export class CustomPlugin implements Plugin {
+  name = 'my-custom-plugin';
+  priority = 100;
+
+  hooks = {
+    // Called once before generation starts
+    beforeGeneration(context: GenerationContext): void {
+      console.log(`Generating ${context.schemas.size} schemas`);
+    },
+
+    // Called for each schema
+    onSchemaLoad(schema: ObjectSchema): void {
+      // Modify schema before generation
+      schema.fields.forEach(field => {
+        if (field.name.startsWith('_')) {
+          field.name = field.name.slice(1); // Remove leading underscore
+        }
+      });
+    },
+
+    // Called when class is created
+    onClassGeneration(classNode: ClassDeclaration, schema: ObjectSchema): void {
+      // Add class-level decorators or JSDoc
+      classNode.addJsDoc({
+        description: schema.description || `Generated class for ${schema.name}`
+      });
+    },
+
+    // Called for each property
+    onPropertyGeneration(property: PropertyDeclaration, field: Field): void {
+      // Add custom decorators based on field metadata
+      if (field.format === 'date-time') {
+        property.addDecorator({
+          name: 'Transform',
+          arguments: ['({ value }) => new Date(value)', { isDecoratorFactory: true }]
+        });
+      }
+    },
+
+    // Called after all generation is complete
+    afterGeneration(context: GenerationContext): void {
+      // Post-process all files
+      for (const sourceFile of context.project.getSourceFiles()) {
+        // Add file-level comments, organize imports, etc.
+      }
+    }
+  };
+}
+```
+
+### Plugin Registration
+
+Plugins are registered in the generator configuration:
+
+```typescript
+const generator = new TypeScriptGenerator({
+  plugins: [
+    new CorePlugin(),
+    new ClassValidatorPlugin(),
+    new NestJSSwaggerPlugin(),
+    new CustomPlugin()
+  ]
+});
+```
+
+### Built-in Plugins
+
+| Plugin | Priority | Flag | Purpose |
+|--------|----------|------|---------|
+| CorePlugin | 10 | (always) | @Expose, @Type decorators |
+| ClassValidatorPlugin | 50 | --class-validator | @IsString, @IsNumber, etc. |
+| NestJSSwaggerPlugin | 60 | --nestjs-swagger | @ApiProperty decorators |
+| ESMPlugin | 200 | --esm | Add .js extensions to imports |
+
+## Testing Strategy
+
+### Test Coverage
+
+Klasik has comprehensive test coverage across all components:
+
+- **Total Tests**: 748 (as of latest build)
+- **Test Framework**: Jest
+- **Coverage Areas**:
+  - Loaders (URL fetching, format detection)
+  - Converters (OpenAPI, CRD, JSON Schema → IR)
+  - Generator (IR → TypeScript AST)
+  - Plugins (decorator generation)
+  - CLI (command parsing, execution)
+  - Integration (end-to-end generation)
+
+### Test Organization
+
+```
+tests/
+├── unit/
+│   ├── loaders/
+│   │   ├── spec-loader.test.ts
+│   │   ├── crd-loader.test.ts
+│   │   └── jsonschema-loader.test.ts
+│   ├── converters/
+│   │   ├── openapi-converter.test.ts
+│   │   ├── crd-converter.test.ts
+│   │   └── jsonschema-converter.test.ts
+│   ├── generator/
+│   │   ├── class-generator.test.ts
+│   │   └── property-generator.test.ts
+│   └── plugins/
+│       ├── class-validator.test.ts
+│       └── nestjs-swagger.test.ts
+├── integration/
+│   ├── openapi-generation.test.ts
+│   ├── crd-generation.test.ts
+│   └── jsonschema-generation.test.ts
+└── fixtures/
+    ├── openapi/
+    ├── crds/
+    └── jsonschema/
+```
+
+### Test Examples
+
+**Unit Test: Type Conversion**
+```typescript
+describe('OpenAPIConverter', () => {
+  it('should convert string type to TypeScript string', () => {
+    const field = converter.convertField({
+      type: 'string',
+      description: 'User name'
+    });
+
+    expect(field.type).toBe('string');
+  });
+
+  it('should convert array type with items', () => {
+    const field = converter.convertField({
+      type: 'array',
+      items: { type: 'string' }
+    });
+
+    expect(field.type).toBe('string');
+    expect(field.array).toBe(true);
+  });
+});
+```
+
+**Integration Test: Full Generation**
+```typescript
+describe('CRD Generation', () => {
+  it('should generate TypeScript from ArgoCD Application CRD', async () => {
+    const result = await generateFromCRD({
+      url: 'fixtures/application-crd.yaml',
+      output: 'tmp/output',
+      nestjsSwagger: true,
+      classValidator: true
+    });
+
+    expect(result.filesGenerated).toBeGreaterThan(0);
+
+    const applicationFile = fs.readFileSync('tmp/output/models/application.ts', 'utf-8');
+    expect(applicationFile).toContain('export class Application');
+    expect(applicationFile).toContain('@ApiProperty');
+    expect(applicationFile).toContain('@IsOptional');
+  });
+});
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+npm test
+
+# Run with coverage
+npm run test:coverage
+
+# Run specific test file
+npm test -- spec-loader.test.ts
+
+# Run in watch mode
+npm test -- --watch
+```
+
+## Development Guide
+
+### Project Structure
+
+```
+klasik-2/
+├── src/
+│   ├── cli/              # Command-line interface
+│   │   ├── commands/     # CLI command implementations
+│   │   └── index.ts      # Main CLI entry point
+│   ├── loaders/          # Specification loaders
+│   ├── converters/       # Format converters to IR
+│   ├── ir/               # Intermediate Representation
+│   ├── generator/        # TypeScript code generator
+│   ├── plugins/          # Plugin implementations
+│   └── utils/            # Shared utilities
+├── tests/                # Test suites
+├── docs/                 # Additional documentation
+└── examples/             # Usage examples
+
+```
+
+### Building from Source
+
+```bash
+# Clone repository
+git clone https://github.com/your-org/klasik-2.git
+cd klasik-2
+
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Run CLI locally
+node dist/cli/index.js generate --help
+
+# Run tests
+npm test
+```
+
+### Making Changes
+
+1. **Add New Feature**:
+   - Create plugin in `src/plugins/`
+   - Register plugin in generator configuration
+   - Add CLI flag if needed
+   - Write unit tests
+   - Update documentation
+
+2. **Add New Input Format**:
+   - Create loader in `src/loaders/`
+   - Create converter in `src/converters/`
+   - Add CLI command in `src/cli/commands/`
+   - Write integration tests
+   - Update README with examples
+
+3. **Fix Bug**:
+   - Write failing test that reproduces bug
+   - Fix the issue
+   - Verify test passes
+   - Check for regression with full test suite
+
+### Debugging
+
+**Debug Generated Code:**
+```typescript
+// Enable verbose logging
+const generator = new TypeScriptGenerator({ verbose: true });
+
+// Inspect IR before generation
+console.log(JSON.stringify(schemaIR, null, 2));
+
+// Inspect AST after generation
+const sourceFile = project.getSourceFile('user.ts');
+console.log(sourceFile.getFullText());
+```
+
+**Debug Plugin Execution:**
+```typescript
+class DebugPlugin implements Plugin {
+  name = 'debug';
+  priority = 1; // Run first
+
+  hooks = {
+    onPropertyGeneration(property, field) {
+      console.log(`Generating property: ${field.name} (${field.type})`);
+    }
+  };
+}
+```
+
+### Performance Optimization
+
+**IR Caching:**
+```typescript
+// Cache converted IR for repeated generation
+const irCache = new Map<string, SchemaIR>();
+
+if (irCache.has(specUrl)) {
+  schemaIR = irCache.get(specUrl);
+} else {
+  schemaIR = await converter.toIR(spec);
+  irCache.set(specUrl, schemaIR);
+}
+```
+
+**Parallel Generation:**
+```typescript
+// Generate multiple files in parallel
+const promises = Array.from(schemaIR.schemas.entries()).map(([name, schema]) => {
+  return generateClass(schema);
+});
+
+await Promise.all(promises);
+```
+
+## Design Decisions
+
+### Why Not Use openapi-generator?
+
+The official openapi-generator has limitations:
+- Java-based (requires JVM)
+- Heavy dependencies
+- Difficult to customize
+- Inconsistent TypeScript output
+- No CRD or JSON Schema support
+
+Klasik provides:
+- Pure TypeScript/Node.js (no JVM)
+- Lightweight and fast
+- Easy plugin system for customization
+- Consistent, high-quality output
+- Multi-format support
+
+### Why class-transformer?
+
+class-transformer provides:
+- Serialization/deserialization with @Type decorators
+- Nested object support
+- Transform hooks
+- Integration with NestJS and other frameworks
+
+Alternative approaches (plain interfaces) lack runtime type information.
+
+### Why Mustache Templates?
+
+Custom templates use Mustache because:
+- Simple, logic-less syntax
+- Easy to learn
+- No arbitrary code execution (security)
+- Works with any text format
+
+Users can override default templates for custom output formats.
+
+## Future Enhancements
+
+Potential improvements for future versions:
+
+1. **GraphQL Support**: Add GraphQL schema → TypeScript converter
+2. **Zod Integration**: Generate Zod schemas alongside classes
+3. **Async API Support**: Support AsyncAPI specifications
+4. **Watch Mode**: Regenerate on spec file changes
+5. **Incremental Generation**: Only regenerate changed schemas
+6. **Source Maps**: Map generated code back to spec locations
+7. **Custom Validators**: Plugin API for custom validation decorators
+8. **gRPC Support**: Generate from Protocol Buffers
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for:
+- Code style guidelines
+- Pull request process
+- Development workflow
+- Release process
+
+## References
+
+- [ts-morph Documentation](https://ts-morph.com/)
+- [OpenAPI Specification](https://swagger.io/specification/)
+- [Kubernetes CRD Documentation](https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/)
+- [JSON Schema Specification](https://json-schema.org/)
+- [class-transformer](https://github.com/typestack/class-transformer)
+- [class-validator](https://github.com/typestack/class-validator)

package/docs/JSDOC_ESCAPING.md

@@ -0,0 +1,280 @@
+# JSDoc Escaping Strategy
+
+This document describes the JSDoc/TSDoc escaping strategy used in Klasik to prevent malformed comments in generated code.
+
+## Overview
+
+JSDoc comments in generated TypeScript code need careful handling of special characters to avoid breaking the comment syntax while preserving readability and functionality.
+
+## Escaping Rules
+
+### Characters That Are Escaped
+
+1. **Comment Delimiters**
+   - `*/` → `*\/` - Closing comment delimiter (prevents premature comment termination)
+   - `/*` → `/\*` - Opening comment delimiter (prevents nested comment issues)
+
+2. **At Symbol (Context-Aware)**
+   - `@` at start of line or after whitespace → `\@` - Prevents false JSDoc tags
+   - `@` in middle of text (e.g., `user@example.com`) → Preserved
+
+3. **Newlines**
+   - `\n` → `\n * ` - Adds proper JSDoc line prefix for multiline comments
+
+### Characters That Are Preserved
+
+These characters are intentionally **not escaped** because they're essential for JSDoc functionality and readability:
+
+1. **Backticks** (`)
+   - Used for inline code examples: `` `const foo = "bar"` ``
+   - Preserved for markdown-style code formatting
+
+2. **Quotes** (`"` and `'`)
+   - Used in descriptions and examples
+   - No escaping needed within JSDoc comments
+
+3. **Angle Brackets** (`<` and `>`)
+   - Used for generic type references: `Array<string>`, `Map<K, V>`
+   - Essential for TypeScript type documentation
+
+4. **Curly Braces** (`{` and `}`)
+   - Used in JSDoc type annotations: `@type {string}`
+   - Used in object descriptions: `{key: value}`
+
+5. **Slashes** (`/`)
+   - Only escaped when part of comment delimiters (`/*` or `*/`)
+   - Regular slashes preserved for paths and regex patterns
+
+6. **Asterisks** (`*`)
+   - Only escaped when part of comment delimiters (`*/`)
+   - Regular asterisks preserved for emphasis
+
+## Implementation
+
+### Files
+
+The escaping logic is implemented in two files:
+
+1. **`src/generators/tsdoc-generator.ts`**
+   - `escapeJSDoc()` method
+   - Used for property docs, method docs, parameter docs
+
+2. **`src/builders/class-builder.ts`**
+   - `escapeJsDocText()` method
+   - Used for class descriptions
+
+Both implementations use the **same escaping logic** to ensure consistency.
+
+### Code Example
+
+```typescript
+/**
+ * Escape JSDoc special characters
+ *
+ * Handles special characters that could break JSDoc syntax:
+ * - Comment delimiters: */ and /*
+ * - Newlines: adds proper JSDoc line prefix
+ *
+ * Characters preserved for JSDoc functionality:
+ * - Backticks (`) for inline code
+ * - Angle brackets (<>) for type references
+ * - Curly braces ({}) for @type tags
+ * - @ symbol (context-aware escaping)
+ */
+private escapeJSDoc(text: string): string {
+  if (!text) return text;
+
+  return text
+    // Escape closing comment delimiter (MUST be first to avoid double-escaping)
+    .replace(/\*\//g, '*\\/')
+    // Escape opening comment delimiter
+    .replace(/\/\*/g, '/\\*')
+    // Escape @ at start of line to prevent false JSDoc tags
+    // Only escape @ when it's at the start of a line or after whitespace
+    .replace(/(^|\n)\s*@/g, '$1\\@')
+    // Handle newlines by adding JSDoc line prefix
+    .replace(/\n/g, '\n * ');
+}
+```
+
+## Examples
+
+### Example 1: Comment Delimiters
+
+**Input:**
+```javascript
+description: "This function /* does something */ important"
+```
+
+**Output:**
+```javascript
+/**
+ * This function /\* does something *\/ important
+ */
+```
+
+### Example 2: Inline Code with Backticks
+
+**Input:**
+```javascript
+description: "Use `const foo = "bar"` for constants"
+```
+
+**Output:**
+```javascript
+/**
+ * Use `const foo = "bar"` for constants
+ */
+```
+
+### Example 3: Type References
+
+**Input:**
+```javascript
+description: "Returns Array<User> or Map<string, User>"
+```
+
+**Output:**
+```javascript
+/**
+ * Returns Array<User> or Map<string, User>
+ */
+```
+
+### Example 4: Email Addresses
+
+**Input:**
+```javascript
+description: "Email like @username or user@example.com"
+```
+
+**Output:**
+```javascript
+/**
+ * Email like \@username or user@example.com
+ */
+```
+(Note: `@username` at start is escaped, but `user@example.com` is preserved)
+
+### Example 5: Multiline Descriptions
+
+**Input:**
+```javascript
+description: "Line 1\nLine 2 with `code`\nLine 3"
+```
+
+**Output:**
+```javascript
+/**
+ * Line 1
+ * Line 2 with `code`
+ * Line 3
+ */
+```
+
+### Example 6: Complex Example
+
+**Input:**
+```javascript
+description: "Example: `const regex = /pattern/;` creates /* comment */ with types like Array<T>"
+```
+
+**Output:**
+```javascript
+/**
+ * Example: `const regex = /pattern/;` creates /\* comment *\/ with types like Array<T>
+ */
+```
+
+## Design Rationale
+
+### Why Not Escape Everything?
+
+We could escape all special characters, but this would harm readability:
+
+❌ **Over-Escaping Approach:**
+```javascript
+/**
+ * Use \`backticks\` for code like Array\<string\> with \{key: value\}
+ */
+```
+
+✅ **Our Approach:**
+```javascript
+/**
+ * Use `backticks` for code like Array<string> with {key: value}
+ */
+```
+
+### Escape Order Matters
+
+The order of replacements is critical:
+
+1. **`*/` must be escaped FIRST** - Otherwise, escaping `/*` could create `*\/` which might be further processed
+2. **`/*` escaping** - After closing delimiter is safe
+3. **`@` escaping** - Context-aware, only at line start
+4. **Newlines** - Last, adds JSDoc line prefix
+
+### Context-Aware Escaping
+
+The `@` symbol is only escaped when it could be mistaken for a JSDoc tag:
+
+- `@param` at line start → escaped to `\@param`
+- `user@example.com` in text → preserved
+- `@username` at start → escaped to `\@username`
+
+## Testing
+
+Comprehensive test coverage ensures the escaping works correctly:
+
+### Test Files
+
+1. **`src/generators/__tests__/tsdoc-generator.test.ts`**
+   - 45 tests covering all property and method doc scenarios
+   - Tests for all special characters and edge cases
+
+2. **`src/builders/__tests__/class-builder.test.ts`**
+   - 45 tests covering class-level documentation
+   - Tests for escaping in class descriptions
+
+### Test Coverage
+
+- ✅ Comment delimiters (`/*` and `*/`)
+- ✅ Backticks for inline code
+- ✅ Single and double quotes
+- ✅ Angle brackets for types
+- ✅ Curly braces
+- ✅ At symbols (@)
+- ✅ Multiline descriptions
+- ✅ Complex combinations
+- ✅ Pattern constraints
+- ✅ Example values
+- ✅ Default values
+- ✅ Parameter descriptions
+- ✅ Request body descriptions
+
+## Maintenance
+
+When modifying the escaping logic:
+
+1. **Update both files** - `tsdoc-generator.ts` and `class-builder.ts` must use identical logic
+2. **Update tests** - Add test cases for new scenarios
+3. **Verify generated code** - Run generation and inspect output
+4. **Check TypeScript compilation** - Ensure generated code compiles without errors
+5. **Update this document** - Keep documentation in sync with implementation
+
+## Related Issues
+
+This implementation addresses the following concerns:
+
+- Prevents malformed JSDoc comments that break TypeScript compilation
+- Maintains readability of generated documentation
+- Preserves JSDoc functionality (tags, types, inline code)
+- Handles edge cases like nested structures and multiline text
+- Consistent behavior across all generated code (models, APIs, properties)
+
+## References
+
+- [TSDoc Specification](https://tsdoc.org/)
+- [JSDoc Documentation](https://jsdoc.app/)
+- [TypeScript JSDoc Reference](https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html)

package/docs/json-schema-support.md

@@ -1,10 +1,10 @@
 # JSON Schema Support Matrix
 
-This document outlines which JSON Schema features are supported by Klasik 2.0 for generating TypeScript models.
+This document outlines which JSON Schema features are supported by Klasik for generating TypeScript models.
 
 ## Overview
 
-Klasik 2.0 provides solid support for common JSON Schema Draft 7 features but lacks support for some advanced patterns like `patternProperties`, `not`, and `dependencies`. This affects complex real-world schemas like GitHub Workflow but works well for most standard schemas.
+Klasik provides solid support for common JSON Schema Draft 7 features but lacks support for some advanced patterns like `patternProperties`, `not`, and `dependencies`. This affects complex real-world schemas like GitHub Workflow but works well for most standard schemas.
 
 ## Supported Features
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klasik",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "TypeScript code generator from OpenAPI/CRD/JSON Schema - rebuilt from ground up with AST-based generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,13 +37,10 @@
   "dependencies": {
     "axios": "^1.6.0",
     "chalk": "^4.1.2",
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.0",
     "commander": "^11.0.0",
     "js-yaml": "^4.1.0",
     "mustache": "^4.2.0",
     "ora": "^5.4.1",
-    "reflect-metadata": "^0.2.0",
     "ts-morph": "^21.0.0"
   },
   "devDependencies": {
@@ -51,7 +48,10 @@
     "@types/js-yaml": "^4.0.9",
     "@types/mustache": "^4.2.0",
     "@types/node": "^20.0.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.0",
     "jest": "^29.5.0",
+    "reflect-metadata": "^0.2.0",
     "ts-jest": "^29.1.0",
     "typescript": "^5.0.0"
   }