@siyavuyachagi/typesharp 0.1.1 → 0.1.3

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Siyavuya Chagi
+Copyright (c) 2025 Siyavuya Chagi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,42 +1,49 @@
 # TypeSharp
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![npm version](https://img.shields.io/npm/v/@siyavuyachagi/typesharp.svg)](https://www.npmjs.com/package/@siyavuyachagi/typesharp)
+[![npm version](https://img.shields.io/npm/v/@siyavuyachagi/typesharp.svg?label=Version)](https://www.npmjs.com/package/@siyavuyachagi/typesharp)
+[![npm downloads](https://img.shields.io/npm/dm/@siyavuyachagi/typesharp.svg?label=Downloads)](https://www.npmjs.com/package/@siyavuyachagi/typesharp)
+[![GitHub commits](https://img.shields.io/github/commit-activity/m/siyavuyachagi/typesharp?label=Commits)](https://github.com/siyavuyachagi/typesharp/commits/main)
+[![GitHub last commit](https://img.shields.io/github/last-commit/siyavuyachagi/typesharp?label=Last+commit)](https://github.com/siyavuyachagi/typesharp/commits/main)
+[![GitHub stars](https://img.shields.io/github/stars/siyavuyachagi/typesharp?label=Stars)](https://github.com/siyavuyachagi/typesharp/stargazers)
 [![Sponsor](https://img.shields.io/badge/Sponsor-💖-ff69b4)](https://github.com/sponsors/siyavuyachagi)
 
 Generate TypeScript types from C# models with ease! TypeSharp scans your ASP.NET Core projects and automatically generates TypeScript interfaces from your C# classes decorated with the `[TypeSharp]` attribute.
 
+Project structure: [docs/project-structure](docs/project-structure.md)
+
 ## Features
 
-✨ **Automatic Type Generation** – Convert C# models to TypeScript interfaces  
-🎯 **Custom Attribute Targeting** – Use `[TypeSharp]` or any custom attribute  
-🔄 **Nullable Support** – `string?` → `string | null`  
-📦 **Collection Handling** – Supports `List<T>`, `IEnumerable<T>`, arrays **and generic collections**  
-🗺️ **Dictionary Mapping** – `Dictionary<K, V>` → `Record<K, V>`  
-🧬 **Generic Types** – Preserves generic type definitions like `Response<T>` → `Response<T>`  
-🧬 **Inheritance** – Preserves class inheritance using `extends`  
-🏗️ **Computed Properties** – Expression-bodied and block getter properties are included  
-🎨 **Naming Conventions** – Convert property names (camel, pascal, snake, kebab)  
-📁 **Flexible Output** – Single file or multiple files  
-🔢 **Enum Support** – Converts C# enums to TypeScript string enums  
-🗂️ **File Grouping** – Preserves C# file organization (multiple classes per file stay together)  
-🔗 **Auto Imports** – Automatically generates `import type` statements between output files  
-🏢 **Multi-Project** – Scan multiple `.csproj` files in a single run
+- **Automatic Type Generation** – Convert C# models to TypeScript interfaces
+- **Custom Attribute Targeting** – Use `[TypeSharp]` or any custom attribute
+- **Nullable Support** – `string?` → `string | null`
+- **Collection Handling** – Supports `List<T>`, `IEnumerable<T>`, arrays **and generic collections**
+- **Dictionary Mapping** – `Dictionary<K, V>` → `Record<K, V>`
+- **Generic Types** – Preserves generic type definitions like `Response<T>` → `Response<T>`
+- **Inheritance** – Preserves class inheritance using `extends`
+- **Computed Properties** – Expression-bodied and block getter properties are included
+- **Naming Conventions** – Convert property names (camel, pascal, snake, kebab)
+- **Flexible Output** – Single file or multiple files
+- **Enum Support** – Converts C# enums to TypeScript string enums
+- **File Grouping** – Preserves C# file organization (multiple classes per file stay together)
+- **Auto Imports** – Automatically generates `import type` statements between output files
+- **Multi-Project** – Scan multiple `.csproj` files in a single run
+- **Obsolete Support** – `[Obsolete]` / `[Obsolete("...")]` → `/** @deprecated ... */` JSDoc
 
 ## How TypeSharp Compares
 
 This is not an OpenApi-based tool !
 | Feature | TypeSharp | NSwag | openapi-typescript | TypeGen |
 | --------------------- | --------- | ----- | ------------------ | ------- |
-| Direct C# parsing | ✅ | ❌ | ❌ | ✅ |
-| Attribute targeting | ✅ | ⚠️ | ❌ | ⚠️ |
-| Non-API models | ✅ | ❌ | ❌ | ✅ |
-| Generics preserved | ✅ | ⚠️ | ⚠️ | ⚠️ |
-| File grouping | ✅ | ❌ | ❌ | ❌ |
-| Naming control | ✅ | ⚠️ | ⚠️ | ❌ |
-| API client generation | ❌ | ✅ | ❌ | ❌ |
+| Direct C# parsing | ✓ | ✕ | ✕ | ✓ |
+| Attribute targeting | ✓ | ! | ✕ | ! |
+| Non-API models | ✓ | ✕ | ✕ | ✓ |
+| Generics preserved | ✓ | ! | ! | ! |
+| File grouping | ✓ | ✕ | ✕ | ✕ |
+| Naming control | ✓ | ! | ! | ✕ |
+| API client generation | ✕ | ✓ | ✕ | ✕ |
 
-For more [docs/why-typesharp](docs/why-typesharp.md)
+Also see [docs/why-typesharp](docs/why-typesharp.md)
 
 ## Installation
 
@@ -46,20 +53,18 @@ npm install -D @siyavuyachagi/typesharp
 
 ## Quick Start
 
-### 1. Create an attribute to target
+### 1. Install the NuGet attributes package
 
-In your target project create the following attribute (`TypeSharp`)
+In your C# project:
 
-```cs
-namespace YourProject.Attribute
-{
-  [AttributeUsage(AttributeTargets.Class | AttributeTargets.Enum)]
-  public class TypeSharpAttribute : Attribute { }
-}
+```bash
+dotnet add package TypeSharp.Attributes
 ```
 
 ### 2. Decorate your C# models or DTOs
 
+Use `[TypeSharp]` to include a class, or `[TypeSharp("name")]` to include it with a custom TypeScript type name:
+
 ```csharp
 [TypeSharp]
 public class User
@@ -114,7 +119,7 @@ This creates `typesharp.config.json`:
 
 ```json
 {
-  "projectFiles": [
+  "source": [
     "C:/Users/User/Desktop/MyApp/Api/Api.csproj",
     "C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"
   ],
@@ -197,7 +202,7 @@ For more advanced usage [docs/usage](docs/usage.md)
 
 | Option             | Type                                      | Default       | Description                                                   |
 | ------------------ | ----------------------------------------- | ------------- | ------------------------------------------------------------- |
-| `projectFiles`     | `string \| string[]`                      | _required_    | Full path(s) to your C# .csproj file(s)                       |
+| `source`           | `string \| string[]`                      | _required_    | Full path(s) to your C# .csproj file(s)                       |
 | `outputPath`       | `string`                                  | _required_    | Where to generate TypeScript files                            |
 | `targetAnnotation` | `string`                                  | `'TypeSharp'` | C# attribute name to look for                                 |
 | `singleOutputFile` | `boolean`                                 | `false`       | Generate one file or multiple files (see below)               |
@@ -256,7 +261,7 @@ TypeSharp supports multiple configuration formats:
 
 ```json
 {
-  "projectFiles": ["C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"],
+  "source": ["C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"],
   "outputPath": "./src/types"
 }
 ```
@@ -267,7 +272,7 @@ TypeSharp supports multiple configuration formats:
 import { TypeSharpConfig } from "typesharp";
 
 const config: TypeSharpConfig = {
-  projectFiles: ["C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"],
+  source: ["C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"],
   outputPath: "./src/types",
 };
 
@@ -278,7 +283,7 @@ export default config;
 
 ```javascript
 module.exports = {
-  projectFiles: ["C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"],
+  source: ["C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"],
   outputPath: "./src/types",
 };
 ```
@@ -393,13 +398,83 @@ export interface PermissionMap {
 }
 ```
 
-### 4. Multi-Project
+### 4. Obsolete / Deprecated Properties
+
+**C#:**
+
+```csharp
+[TypeSharp]
+public class Employee
+{
+    public int Id { get; set; }
+    public string Department { get; set; }
+
+    [Obsolete("Use Department instead.")]
+    public string? DepartmentName { get; set; }
+
+    [Obsolete]
+    public string? LegacyCode { get; set; }
+}
+```
+
+**Generated TypeScript:**
+
+```typescript
+export interface Employee {
+  id: number;
+  department: string;
+  /** @deprecated Use Department instead. */
+  departmentName: string | null;
+  /** @deprecated */
+  legacyCode: string | null;
+}
+```
+
+### 5. Custom Type Name Override
+
+Use `[TypeSharp("name")]` to override the generated TypeScript type name. The override takes precedence over `namingConvention`.
+
+**C#:**
+
+```csharp
+[TypeSharp("auth_response")]
+public class AuthResponse
+{
+    public string AccessToken { get; set; }
+    public string RefreshToken { get; set; }
+}
+
+[TypeSharp("user_role")]
+public enum UserRole
+{
+    Admin,
+    User,
+    Guest
+}
+```
+
+**Generated TypeScript:**
+
+```typescript
+export interface auth_response {
+  accessToken: string;
+  refreshToken: string;
+}
+
+export enum user_role {
+  Admin = "Admin",
+  User = "User",
+  Guest = "Guest",
+}
+```
+
+### 6. Multi-Project
 
 Scan multiple C# projects at once:
 
 ```json
 {
-  "projectFiles": [
+  "source": [
     "C:/MyApp/Api/Api.csproj",
     "C:/MyApp/Domain/Domain.csproj",
     "C:/MyApp/Contracts/Contracts.csproj"
@@ -408,13 +483,13 @@ Scan multiple C# projects at once:
 }
 ```
 
-### 5. Single Output File
+### 7. Single Output File
 
 **Config:**
 
 ```typescript
 const config: TypeSharpConfig = {
-  projectFiles: "./Backend/Backend.csproj",
+  source: "./Backend/Backend.csproj",
   outputPath: "./src/types",
   singleOutputFile: true,
 };
@@ -422,13 +497,13 @@ const config: TypeSharpConfig = {
 
 All types will be generated in `src/types/types.ts`
 
-### 6. Custom Naming Conventions
+### 8. Custom Naming Conventions
 
 **Config:**
 
 ```typescript
 const config: TypeSharpConfig = {
-  projectFiles: "./Backend/Backend.csproj",
+  source: "./Backend/Backend.csproj",
   outputPath: "./src/types",
   namingConvention: {
     dir: "kebab", // ./src/types/my-feature/
@@ -480,7 +555,7 @@ generateTypes();
 
 ## Requirements
 
-- Node.js >= 14
+- Node.js >= 20
 - TypeScript >= 4.5 (if using TypeScript config)
 
 ## License

package/dist/cli/index.js

@@ -7,11 +7,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const core_1 = require("../core");
 const chalk_1 = __importDefault(require("chalk"));
+const package_json_1 = require("../../package.json");
+const create_sample_config_1 = require("../core/create-sample-config");
 const program = new commander_1.Command();
 program
-    .name('typesharp')
-    .description('Generate TypeScript types from C# models with TypeSharp attribute')
-    .version('1.0.0')
+    .name(package_json_1.name)
+    .description(package_json_1.description)
+    .version(package_json_1.version)
     .usage('[command] [options]');
 // Generate command (default)
 program
@@ -39,7 +41,7 @@ program
             console.error(chalk_1.default.red.bold('❌ Invalid format.') + ' Use: ' + chalk_1.default.yellow('json, ts, ') + 'or' + chalk_1.default.yellow(' js'));
             process.exit(1);
         }
-        (0, core_1.createSampleConfig)(format);
+        (0, create_sample_config_1.createSampleConfig)(format);
         process.exit(0);
     }
     catch (error) {

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,kCAAuD;AACvD,kDAA0B;AAE1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,mEAAmE,CAAC;KAChF,OAAO,CAAC,OAAO,CAAC;KAChB,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAEhC,6BAA6B;AAC7B,OAAO;KACJ,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACxC,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;KAC3D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,IAAA,eAAQ,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,eAAe;AACf,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,uBAAuB,EAAE,0CAA0C,EAAE,IAAI,CAAC,CAAC,kBAAkB;KACpG,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAA8B,CAAC;QAEtD,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,QAAQ,GAAG,eAAK,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,GAAG,eAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAA,yBAAkB,EAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,kCAAmC;AACnC,kDAA0B;AAC1B,qDAAgE;AAChE,uEAAkE;AAClE,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,mBAAI,CAAC;KACV,WAAW,CAAC,0BAAW,CAAC;KACxB,OAAO,CAAC,sBAAO,CAAC;KAChB,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAEhC,6BAA6B;AAC7B,OAAO;KACJ,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACxC,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;KAC3D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,IAAA,eAAQ,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,eAAe;AACf,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,uBAAuB,EAAE,0CAA0C,EAAE,IAAI,CAAC,CAAC,kBAAkB;KACpG,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAA8B,CAAC;QAEtD,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,QAAQ,GAAG,eAAK,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,GAAG,eAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAA,yCAAkB,EAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/core/create-sample-config.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Create a sample configuration file
+ */
+export declare const createSampleConfig: (format: "ts" | "js" | "json") => void;
+//# sourceMappingURL=create-sample-config.d.ts.map

package/dist/core/create-sample-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sample-config.d.ts","sourceRoot":"","sources":["../../src/core/create-sample-config.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,IAAI,GAAG,IAAI,GAAG,MAAM,KAAG,IA2CjE,CAAA"}

package/dist/core/create-sample-config.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSampleConfig = void 0;
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Create a sample configuration file
+ */
+const createSampleConfig = (format) => {
+    const sampleConfig = {
+        source: [
+            'C:/Users/User/Desktop/MyApp/MyApp.sln',
+        ],
+        outputPath: './app/types',
+        targetAnnotation: 'TypeSharp',
+        singleOutputFile: false,
+        namingConvention: 'camel',
+        fileSuffix: ''
+    };
+    let fileName;
+    let content;
+    if (format === 'json') {
+        fileName = 'typesharp.config.json';
+        content = JSON.stringify(sampleConfig, null, 2);
+    }
+    else if (format === 'js') {
+        fileName = 'typesharp.config.js';
+        content = `module.exports = ${formatAsJsObject(sampleConfig)};\n`;
+    }
+    else {
+        fileName = 'typesharp.config.ts';
+        let namespace = '@siyavuyachagi/typesharp';
+        content = [
+            `import type { TypeSharpConfig } from '${namespace}';`,
+            ``,
+            `const config: TypeSharpConfig = ${formatAsJsObject(sampleConfig)};`,
+            ``,
+            `export default config;`,
+            ``
+        ].join('\n');
+    }
+    const allConfigFiles = ['typesharp.config.ts', 'typesharp.config.js', 'typesharp.config.json'];
+    const existingConfig = allConfigFiles.find(f => fs.existsSync(f));
+    if (existingConfig) {
+        console.log(chalk_1.default.yellow.bold('❗ Warning:'), chalk_1.default.white(`${existingConfig} already exists. Skipping creation.`));
+        return;
+    }
+    fs.writeFileSync(fileName, content, 'utf-8');
+    console.log(chalk_1.default.green.bold('✅ Created'), chalk_1.default.white(`./${fileName}`));
+};
+exports.createSampleConfig = createSampleConfig;
+/**
+ * Format a plain object as a JS/TS object literal (no quoted keys)
+ */
+const formatAsJsObject = (obj, indent = 0) => {
+    const pad = ' '.repeat(indent + 2);
+    const closePad = ' '.repeat(indent);
+    const lines = Object.entries(obj).map(([key, value]) => {
+        let formatted;
+        if (Array.isArray(value)) {
+            const items = value.map(v => `${pad}  ${JSON.stringify(v)}`).join(',\n');
+            formatted = `[\n${items}\n${pad}]`;
+        }
+        else if (typeof value === 'object' && value !== null) {
+            formatted = formatAsJsObject(value, indent + 2);
+        }
+        else {
+            formatted = JSON.stringify(value);
+        }
+        return `${pad}${key}: ${formatted}`;
+    });
+    return `{\n${lines.join(',\n')}\n${closePad}}`;
+};
+//# sourceMappingURL=create-sample-config.js.map

package/dist/core/create-sample-config.js.map

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

package/dist/core/index.d.ts

@@ -1,4 +1,8 @@
 import { TypeSharpConfig } from '../types/typesharp-config';
+/**
+ * Merge user config with defaults
+ */
+export declare const mergeWithDefaults: (config: Partial<TypeSharpConfig>) => TypeSharpConfig;
 export declare function generate(configPath?: string): Promise<void>;
 /**
  * Deletes all contents of a directory but keeps the directory itself.
@@ -8,9 +12,5 @@ export declare function cleanOutputDirectory(dir: string): void;
 /**
  * Load configuration from file or use provided config
  */
-export declare function loadConfig(configPath?: string): TypeSharpConfig;
-/**
- * Create a sample configuration file
- */
-export declare function createSampleConfig(format: 'ts' | 'js' | 'json'): void;
+export declare function loadConfig(configPath?: string): Promise<TypeSharpConfig>;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAuD5D,wBAAsB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEjE;AASD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,QAiB/C;AAUD;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAqB/D;AA2CD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAwCrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA6C5D;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,OAAO,CAAC,eAAe,CAAC,KAAG,eAsBpE,CAAC;AAMF,wBAAsB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEjE;AASD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,QAiB/C;AAUD;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqB9E"}

package/dist/core/index.js

@@ -36,63 +36,77 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeWithDefaults = void 0;
 exports.generate = generate;
 exports.cleanOutputDirectory = cleanOutputDirectory;
 exports.loadConfig = loadConfig;
-exports.createSampleConfig = createSampleConfig;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const parser_1 = require("../parser");
 const generator_1 = require("../generator");
 const chalk_1 = __importDefault(require("chalk"));
+const url_1 = require("url");
+const resolve_project_files_from_source_1 = require("../parser/resolve-project-files-from-source");
 /**
  * Default configuration values
  */
 const DEFAULT_CONFIG = {
     targetAnnotation: 'TypeSharp',
     singleOutputFile: false,
-    // fileNamingConvention: 'kebab',
     namingConvention: 'camel'
 };
 /**
  * Load configuration from a file
  */
-function loadConfigFromFile(filePath) {
+async function loadConfigFromFile(filePath) {
     const ext = path.extname(filePath);
     if (ext === '.json') {
         const content = fs.readFileSync(filePath, 'utf-8');
         const config = JSON.parse(content);
-        return mergeWithDefaults(config);
-    }
-    if (ext === '.js' || ext === '.ts') {
-        // For TypeScript/JavaScript files, we need to require them
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const config = require(path.resolve(filePath));
-        const exportedConfig = config.default || config;
-        return mergeWithDefaults(exportedConfig);
+        return (0, exports.mergeWithDefaults)(config);
+    }
+    if (ext === '.js') {
+        const fileUrl = (0, url_1.pathToFileURL)(path.resolve(filePath)).href;
+        const module = await Promise.resolve(`${fileUrl}`).then(s => __importStar(require(s)));
+        const exportedConfig = module.default || module;
+        return (0, exports.mergeWithDefaults)(exportedConfig);
+    }
+    if (ext === '.ts') {
+        // Use tsx to load TypeScript config files at runtime
+        const tsxPath = require.resolve('tsx/cjs');
+        require(tsxPath);
+        const module = require(path.resolve(filePath));
+        const exportedConfig = module.default || module;
+        return (0, exports.mergeWithDefaults)(exportedConfig);
     }
     throw new Error(`Unsupported config file format: ${ext}`);
 }
 /**
  * Merge user config with defaults
  */
-function mergeWithDefaults(config) {
-    if (!config.projectFiles) {
-        throw new Error('targetPath is required in configuration');
+const mergeWithDefaults = (config) => {
+    // Deprecation warning
+    if (config.projectFiles && !config.source) {
+        console.warn(chalk_1.default.yellow.bold('⚠ Deprecation:'), chalk_1.default.white('`projectFiles` is deprecated. Please rename it to `source` in your config.'));
+        config.source = config.projectFiles;
+    }
+    if (!config.source && !config.projectFiles) {
+        throw new Error('`source` is required in configuration');
     }
     if (!config.outputPath) {
         throw new Error('outputPath is required in configuration');
     }
     return {
         ...DEFAULT_CONFIG,
-        ...config
+        ...config,
     };
-}
+};
+exports.mergeWithDefaults = mergeWithDefaults;
 async function generate(configPath) {
     try {
         console.log(chalk_1.default.cyan.bold('\n🚀 TypeSharp - Starting generation...'));
         // Load configuration
-        const config = loadConfig(configPath);
+        const config = await loadConfig(configPath);
         console.log(chalk_1.default.green.bold('\n✓ Configuration loaded'));
         // Display project files
         const projectFiles = Array.isArray(config.projectFiles)
@@ -123,7 +137,7 @@ async function generate(configPath) {
         console.log(chalk_1.default.cyan('\n⧖ Parsing C# files...'));
         const parseResults = await (0, parser_1.parseCSharpFiles)(config);
         if (parseResults.length === 0) {
-            console.warn(chalk_1.default.yellow.bold('❗ Warning:'), chalk_1.default.white(`No C# files found with [TypeSharp] attribute\n`));
+            console.warn(chalk_1.default.yellow.bold('❗ Warning:'), chalk_1.default.white(`No C# files found with [${config.targetAnnotation}] attribute\n`));
             return;
         }
         // Collect all classes
@@ -168,9 +182,9 @@ function cleanOutputDirectory(dir) {
 /**
  * Load configuration from file or use provided config
  */
-function loadConfig(configPath) {
+async function loadConfig(configPath) {
     if (configPath && fs.existsSync(configPath)) {
-        return loadConfigFromFile(configPath);
+        return await loadConfigFromFile(configPath);
     }
     // Look for default config files
     const defaultPaths = [
@@ -180,7 +194,7 @@ function loadConfig(configPath) {
     ];
     for (const defaultPath of defaultPaths) {
         if (fs.existsSync(defaultPath)) {
-            return loadConfigFromFile(defaultPath);
+            return await loadConfigFromFile(defaultPath);
         }
     }
     throw new Error('No configuration file found. Please create typesharp.config.ts, typesharp.config.js, or typesharp.config.json');
@@ -190,9 +204,7 @@ function loadConfig(configPath) {
  */
 function validateConfig(config) {
     // Convert single project to array for unified handling
-    const projectFiles = Array.isArray(config.projectFiles)
-        ? config.projectFiles
-        : [config.projectFiles];
+    const projectFiles = (0, resolve_project_files_from_source_1.resolveProjectFilesFromSource)(config.source);
     // Validate each project file
     for (const projectFile of projectFiles) {
         if (!fs.existsSync(projectFile)) {
@@ -218,46 +230,4 @@ function validateConfig(config) {
         }
     }
 }
-/**
- * Create a sample configuration file
- */
-function createSampleConfig(format) {
-    const sampleConfig = {
-        // Show array format as example
-        projectFiles: [
-            'C:/Users/User/Desktop/MyApp/Api/Api.csproj',
-            'C:/Users/User/Desktop/MyApp/Domain/Domain.csproj'
-        ],
-        outputPath: './app/types',
-        targetAnnotation: 'TypeSharp',
-        singleOutputFile: false,
-        namingConvention: 'camel',
-        fileSuffix: ''
-    };
-    let fileName;
-    let content;
-    if (format === 'json') {
-        fileName = 'typesharp.config.json';
-        content = JSON.stringify(sampleConfig, null, 2);
-    }
-    else if (format === 'js') {
-        fileName = 'typesharp.config.js';
-        content = `module.exports = ${JSON.stringify(sampleConfig, null, 2)};\n`;
-    }
-    else {
-        fileName = 'typesharp.config.ts';
-        content = `import type { TypeSharpConfig } from 'typesharp';
-
-const config: TypeSharpConfig = ${JSON.stringify(sampleConfig, null, 2)};
-
-export default config;
-`;
-    }
-    if (fs.existsSync(fileName)) {
-        console.log(chalk_1.default.yellow.bold('❗ Warning:'), chalk_1.default.white(`${fileName} already exists. Skipping creation.`));
-        return;
-    }
-    fs.writeFileSync(fileName, content, 'utf-8');
-    console.log(chalk_1.default.green.bold('✅ Created'), chalk_1.default.white(`./${fileName}`));
-}
 //# sourceMappingURL=index.js.map