@needle-tools/needle-component-compiler 3.0.2 → 3.0.3

package/Changelog.md

@@ -4,6 +4,18 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [3.0.3] - 2026-03-11
+
+### Fixed
+- Fix `Promise<T>` return types passing through as `Promise` instead of resolving to `void`
+- Fix unknown/web-only types (e.g. user-defined interfaces) in method parameters passing through instead of becoming `object`
+- Fix `@nonSerialized` comment directive not being respected on methods (only worked on fields before)
+- Fix `void` in union return types not being filtered out (e.g. `void | boolean` now correctly resolves to `bool`)
+- Fix enum types in method parameters and return types becoming `object` instead of preserving the enum name
+
+### Added
+- `@type` override on methods: `// @type ReturnType` overrides the return type, `// @type paramName ParamType` overrides a specific parameter's type
+
 ## [3.0.1] - 2026-03-04
 
 ### Fixed

package/dist/impl/csharp-compiler.js

@@ -275,6 +275,25 @@ var CSharpWriter = /** @class */ (function (_super) {
         // @contextmenu on method → add attribute
         var contextMenuComment = comments === null || comments === void 0 ? void 0 : comments.find(function (c) { return c.startsWith("@contextmenu "); });
         var contextMenu = contextMenuComment ? contextMenuComment.substring("@contextmenu ".length).trim() : null;
+        // @type overrides: "@type ReturnType" for return, "@type paramName ParamType" for params
+        var returnTypeOverride;
+        var paramTypeOverrides = {};
+        if (comments) {
+            for (var _i = 0, comments_1 = comments; _i < comments_1.length; _i++) {
+                var c = comments_1[_i];
+                if (!c.startsWith("@type "))
+                    continue;
+                var parts = c.substring("@type ".length).trim().split(/\s+/);
+                if (parts.length >= 2) {
+                    // "@type paramName Type" → param override
+                    paramTypeOverrides[parts[0]] = parts.slice(1).join(" ");
+                }
+                else if (parts.length === 1) {
+                    // "@type Type" → return type override
+                    returnTypeOverride = parts[0];
+                }
+            }
+        }
         // Only emit public methods and lifecycle methods (which are always public)
         var lifecycleName = LIFECYCLE_METHODS[name];
         if (visibility !== base_compiler_1.Visibility.Public && !lifecycleName)
@@ -285,7 +304,10 @@ var CSharpWriter = /** @class */ (function (_super) {
         var paramList = (_a = args === null || args === void 0 ? void 0 : args.map(function (arg) {
             var _a;
             var csharpType;
-            if (!arg.type || arg.type.includes("{")) {
+            if (paramTypeOverrides[arg.name]) {
+                csharpType = paramTypeOverrides[arg.name];
+            }
+            else if (!arg.type || arg.type.includes("{")) {
                 csharpType = "object";
             }
             else {
@@ -293,9 +315,7 @@ var CSharpWriter = /** @class */ (function (_super) {
             }
             return "".concat(csharpType, " @").concat(arg.name);
         }).join(", ")) !== null && _a !== void 0 ? _a : "";
-        var csReturnType = returnType
-            ? ((_b = this.resolveKnownCSharpTypeName(returnType)) !== null && _b !== void 0 ? _b : "void")
-            : "void";
+        var csReturnType = returnTypeOverride !== null && returnTypeOverride !== void 0 ? returnTypeOverride : (returnType ? ((_b = this.resolveKnownCSharpTypeName(returnType)) !== null && _b !== void 0 ? _b : "void") : "void");
         if (contextMenu)
             this.writer.writeLine("[UnityEngine.ContextMenu(\"".concat(contextMenu, "\")]"));
         this.writer.writeLine("public ".concat(csReturnType, " ").concat(methodName, "(").concat(paramList, ") {}"));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@needle-tools/needle-component-compiler",
-    "version": "3.0.2",
+    "version": "3.0.3",
     "description": "Compile Editor components for Needle Engine for C# and Blender",
     "main": "dist/index.js",
     "bin": {