@needle-tools/needle-component-compiler 3.0.19-next.e2b9a6e → 3.0.20-next.2ca1149

package/Changelog.md

@@ -4,6 +4,11 @@ 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.20] - 2026-05-05
+### Changed
+- Fields without `@serializable()` decorator (or `//@serializable` / `//@serializeField` comment directive) are no longer emitted in C# or Blender output. This prevents unresolvable types (e.g. `article: Article | undefined = undefined`) from producing compile errors in generated stubs.
+- Blender: component reference types now emit concrete type names (e.g. `Camera`, `Rigidbody`, `AudioSource`) instead of generic `comp`. Added support for: Animation, Animator, Camera, Light, Rigidbody, Renderer, Canvas, VideoPlayer, AudioSource, SphereCollider, MeshCollider, BoxCollider, PlayableDirector, DragControls, Button, Text.
+
 ## [3.0.19] - 2026-04-28
 ### Fixed
 - C#: skip `= undefined` initializers — `undefined` is not valid in C#

package/Readme.md

@@ -70,6 +70,7 @@ Use `//` comments above classes, fields, or methods to control code generation:
 | `@abstract` | Class | Mark the generated class as `abstract` |
 | `@serializeField` | Field | Emit `[UnityEngine.SerializeField]` attribute |
 | `@nonSerialized` | Field / Method | Skip generating C# code for this member |
+| `@header "My text"` | Field | Emit `[UnityEngine.Header("My text")]` (C# only) |
 | `@tooltip "My text"` | Field | Emit `[UnityEngine.Tooltip("My text")]` (C#) or `"description"` (Blender) |
 | `@contextmenu "Label"` | Method | Emit `[UnityEngine.ContextMenu("Label")]` |
 | `@ifdef MY_DEFINE` | Field | Wrap field in `#if MY_DEFINE` / `#endif` |

package/dist/Compiler.js

@@ -151,7 +151,10 @@ var Compiler = /** @class */ (function () {
         // If the property has a @serializable() decorator, ensure it's in the comments
         // so the writer emits private/protected fields with [SerializeField]
         var hasSerialized = this.hasSerializableDecorator(node);
-        if (hasSerialized && !comments.some(function (c) { return c.startsWith("@serializable"); })) {
+        var hasSerializedComment = comments.some(function (c) { return c.startsWith("@serializable") || c.startsWith("@serializeField"); });
+        if (!hasSerialized && !hasSerializedComment)
+            return; // only emit fields marked with @serializable() or //@serializable or //@serializeField
+        if (!comments.some(function (c) { return c.startsWith("@serializable"); })) {
             comments.push("@serializable");
         }
         var flags = [];

package/dist/impl/csharp-compiler.js

@@ -230,6 +230,9 @@ var CSharpWriter = /** @class */ (function (_super) {
         }
         // @serializeField → add attribute + force private becomes serialized
         var serializeField = comments === null || comments === void 0 ? void 0 : comments.some(function (c) { return c.startsWith("@serializeField") || c.startsWith("@serializable"); });
+        // @header
+        var headerComment = comments === null || comments === void 0 ? void 0 : comments.find(function (c) { return c.startsWith("@header "); });
+        var header = headerComment ? headerComment.substring("@header ".length).trim().replace(/^["']|["']$/g, "") : null;
         // @tooltip
         var tooltipComment = comments === null || comments === void 0 ? void 0 : comments.find(function (c) { return c.startsWith("@tooltip "); });
         var tooltip = tooltipComment ? tooltipComment.substring("@tooltip ".length).trim().replace(/^["']|["']$/g, "") : null;
@@ -302,6 +305,8 @@ var CSharpWriter = /** @class */ (function (_super) {
         if (needsEditorWrap)
             this.writer.writeLine("#if UNITY_EDITOR");
         // Emit attributes
+        if (header)
+            this.writer.writeLine("[UnityEngine.Header(\"".concat(header, "\")]"));
         if (tooltip)
             this.writer.writeLine("[UnityEngine.Tooltip(\"".concat(tooltip, "\")]"));
         if (contextMenu)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@needle-tools/needle-component-compiler",
-    "version": "3.0.19-next.e2b9a6e",
+    "version": "3.0.20-next.2ca1149",
     "description": "Compile Editor components for Needle Engine for C# and Blender",
     "main": "dist/index.js",
     "bin": "dist/cli.js",