@siyavuyachagi/typesharp 0.1.0 → 0.1.2

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,35 +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?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)
+🗂️ **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
 
-## How TypeSharp Compares   
 This is not an OpenApi-based tool !
-| Feature               | TypeSharp | NSwag | openapi-typescript | TypeGen |
+| Feature | TypeSharp | NSwag | openapi-typescript | TypeGen |
 | --------------------- | --------- | ----- | ------------------ | ------- |
-| 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)
+| Direct C# parsing | ✅ | ❌ | ❌ | ✅ |
+| Attribute targeting | ✅ | ⚠️ | ❌ | ⚠️ |
+| Non-API models | ✅ | ❌ | ❌ | ✅ |
+| Generics preserved | ✅ | ⚠️ | ⚠️ | ⚠️ |
+| File grouping | ✅ | ❌ | ❌ | ❌ |
+| Naming control | ✅ | ⚠️ | ⚠️ | ❌ |
+| API client generation | ❌ | ✅ | ❌ | ❌ |
 
+Also see [docs/why-typesharp](docs/why-typesharp.md)
 
 ## Installation
 
@@ -85,7 +99,7 @@ public class ApiResponse<T>
 
 ### 3. Create a configuration file
 
-In your frontend end project run the following script
+In your frontend project run the following script
 
 ```bash
 # Create TypeScript config
@@ -93,29 +107,27 @@ npx typesharp init
 
 # ----- OR -------
 
-# Create JSON config (default)
+# Create JSON config
 npx typesharp init --format json
 
-# Create TypeScript config
+# Create TypeScript config (default)
 npx typesharp init --format ts
 
 # Create JavaScript config
 npx typesharp init --format js
-
 ```
 
 This creates `typesharp.config.json`:
 
 ```json
 {
-  "projectFile": [
+  "source": [
     "C:/Users/User/Desktop/MyApp/Api/Api.csproj",
     "C:/Users/User/Desktop/MyApp/Domain/Domain.csproj"
   ],
   "outputPath": "./app/types",
   "targetAnnotation": "TypeSharp",
   "singleOutputFile": false,
-  "fileNamingConvention": "kebab",
   "namingConvention": "camel"
 }
 ```
@@ -183,23 +195,40 @@ export interface ApiResponse<T> {
   errors: string[];
 }
 ```
+
 For more advanced usage [docs/usage](docs/usage.md)
 
 ## Configuration
 
 ### 1. Configuration Options
 
-| Option                 | Type       | Default       | Description                                      |
-| ---------------------- | ---------- | ------------- | ------------------------------------------------ |
-| `projectFiles`         | `string[]` | _required_    | Full path(s) to your C# .csproj file             |
-| `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)  |
-| `fileNamingConvention` | `string`   | `'kebab'`     | File naming: `kebab`, `camel`, `pascal`, `snake` |
-| `namingConvention`     | `string`   | `'camel'`     | Property naming: `camel`, `pascal`, `snake`      |
-| `fileSuffix`           | `string`   | `optional`    | Suffix for file names: `user-dto.ts`             |
+| Option             | Type                                      | Default       | Description                                                   |
+| ------------------ | ----------------------------------------- | ------------- | ------------------------------------------------------------- |
+| `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)               |
+| `namingConvention` | `string \| { dir: string, file: string }` | `'camel'`     | Property/file/dir naming: `kebab`, `camel`, `pascal`, `snake` |
+| `fileSuffix`       | `string`                                  | _optional_    | Suffix appended to generated file names: `user-dto.ts`        |
 
-### 2. Output File Behavior
+### 2. Naming Convention
+
+`namingConvention` accepts either a simple string that applies to everything, or a config object for separate control over directories and files:
+
+```json
+// Simple — applies to both dirs and files
+{ "namingConvention": "kebab" }
+
+// Advanced — separate control
+{
+  "namingConvention": {
+    "dir": "kebab",
+    "file": "camel"
+  }
+}
+```
+
+### 3. Output File Behavior
 
 TypeSharp preserves your C# file organization. Here's how it works:
 
@@ -226,7 +255,7 @@ Backend/                           src/types/
 
 **This means if you organize related DTOs in one C# file, they'll stay together in the generated TypeScript file!** 🎯
 
-### 3. Configuration File Formats
+### 4. Configuration File Formats
 
 TypeSharp supports multiple configuration formats:
 
@@ -311,44 +340,166 @@ export interface Product extends BaseEntity {
 }
 ```
 
-### 2. Single Output File
+### 2. Computed Properties
+
+TypeSharp includes expression-bodied and block getter properties in the generated output:
+
+**C#:**
+
+```csharp
+[TypeSharp]
+public class PollOptionUserLinkDto
+{
+    public int Id { get; set; }
+    public int UserId { get; set; }
+    public UserDto User { get; set; }
+
+    // Expression-bodied
+    public string? Avatar => User?.Avatar;
+
+    // Block getter
+    public string UserFirstName { get { return User.FirstName; } }
+
+    // Init-only (Planned)
+    // public string Slug { get; init; }
+}
+```
+
+**Generated TypeScript:**
+
+```typescript
+export interface PollOptionUserLinkDto {
+  id: number;
+  userId: number;
+  user: UserDto;
+  avatar: string | null;
+  userFirstName: string;
+  slug: string;
+}
+```
+
+### 3. Dictionary Types
+
+**C#:**
+
+```csharp
+[TypeSharp]
+public class PermissionMap
+{
+    public Dictionary<string, bool> Flags { get; set; }
+    public IReadOnlyDictionary<string, List<string>> RolePermissions { get; set; }
+}
+```
+
+**Generated TypeScript:**
+
+```typescript
+export interface PermissionMap {
+  flags: Record<string, boolean>;
+  rolePermissions: Record<string, string[]>;
+}
+```
+
+### 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. Multi-Project
+
+Scan multiple C# projects at once:
+
+```json
+{
+  "source": [
+    "C:/MyApp/Api/Api.csproj",
+    "C:/MyApp/Domain/Domain.csproj",
+    "C:/MyApp/Contracts/Contracts.csproj"
+  ],
+  "outputPath": "./src/types"
+}
+```
+
+### 6. Single Output File
 
 **Config:**
 
 ```typescript
 const config: TypeSharpConfig = {
-  projectFile: "./Backend/Backend.csproj",
+  source: "./Backend/Backend.csproj",
   outputPath: "./src/types",
   singleOutputFile: true,
 };
 ```
 
-All types will be generated in `src/types/index.ts`
+All types will be generated in `src/types/types.ts`
 
-### 3. Custom Naming Conventions
+### 7. Custom Naming Conventions
 
 **Config:**
 
 ```typescript
 const config: TypeSharpConfig = {
-  projectFile: "./Backend/Backend.csproj",
+  source: "./Backend/Backend.csproj",
   outputPath: "./src/types",
-  fileNamingConvention: "snake", // user_model.ts
-  namingConvention: "pascal", // UserName, not userName
+  namingConvention: {
+    dir: "kebab", // ./src/types/my-feature/
+    file: "camel", // myFeatureDto.ts
+  },
 };
 ```
 
 ## Type Mappings
 
-| C# Type                                     | TypeScript Type  |
-| ------------------------------------------- | ---------------- |
-| `string`                                    | `string`         |
-| `int`, `long`, `double`, `float`, `decimal` | `number`         |
-| `bool`                                      | `boolean`        |
-| `DateTime`, `DateOnly`, `TimeOnly`          | `string`         |
-| `Guid`                                      | `string`         |
-| `List<T>`, `IEnumerable<T>`, `T[]`          | `T[]`            |
-| `string?`                                   | `string \| null` |
+### Primitives & Common Types
+
+| C# Type                                             | TypeScript Type |
+| --------------------------------------------------- | --------------- |
+| `bool`                                              | `boolean`       |
+| `byte`, `decimal`, `double`, `float`, `int`, `long` | `number`        |
+| `DateTime`, `DateOnly`, `TimeOnly`                  | `string`        |
+| `Guid`, `string`                                    | `string`        |
+| `object`                                            | `any`           |
+
+### Collections
+
+| C# Type                                                              | TypeScript Type |
+| -------------------------------------------------------------------- | --------------- |
+| `List<T>`, `ICollection<T>`, `IEnumerable<T>`, `T[]`                 | `T[]`           |
+| `Dictionary<K, V>`, `IDictionary<K, V>`, `IReadOnlyDictionary<K, V>` | `Record<K, V>`  |
+
+### ASP.NET / File Types
+
+| C# Type                                | TypeScript Type |
+| -------------------------------------- | --------------- |
+| `IFormFile`, `FormFile`                | `File`          |
+| `IFormFileCollection`                  | `File[]`        |
+| `FileStream`, `MemoryStream`, `Stream` | `Blob`          |
 
 ## Programmatic Usage
 
@@ -369,10 +520,6 @@ generateTypes();
 - Node.js >= 14
 - TypeScript >= 4.5 (if using TypeScript config)
 
-<!-- ## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request. -->
-
 ## License
 
 MIT © Siyavuya Chagi

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
@@ -31,7 +33,7 @@ program
 program
     .command('init')
     .description('Create a sample configuration file')
-    .option('-f, --format <format>', 'Configuration file format (ts, js, json)', 'json') // default to 'json'
+    .option('-f, --format <format>', 'Configuration file format (ts, js, json)', 'ts') // default to 'ts'
     .action((options) => {
     try {
         const format = options.format;
@@ -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,MAAM,CAAC,CAAC,oBAAoB;KACxG,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,GAAE,IAAI,GAAG,IAAI,GAAG,MAAe,GAAG,IAAI,CAwC9E"}
+{"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"}