@needle-tools/needle-component-compiler 3.0.19 → 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/BaseWriter.d.ts

@@ -8,7 +8,7 @@ export declare abstract class BaseWriter implements IWriter {
     /** Enum registry: lowercased enum name → members */
     protected _enumRegistry: Map<string, EnumMember[]>;
     registerEnum(name: string, members: EnumMember[]): void;
-    abstract resolveCSharpTypeName(typescriptTypeName: string, baseTypes?: string[]): string | void;
+    abstract resolveNeedleTypeName(typescriptTypeName: string, baseTypes?: string[]): string | void;
     abstract startNewType(filePath: string, typeName: string, baseType: string[], comments?: string[]): boolean | void;
     abstract endNewType(filePath: string, typeName: string): void;
     abstract writeMember(visibility: Visibility, name: string, isArray: boolean, type: string, initialValue?: string, comments?: string[]): void;

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 = [];
@@ -429,7 +432,7 @@ var Compiler = /** @class */ (function () {
         return this.resolveTypeFromString(typeNode.getText(), writer);
     };
     Compiler.prototype.resolveTypeFromString = function (type, writer) {
-        var resolved = writer.resolveCSharpTypeName(type);
+        var resolved = writer.resolveNeedleTypeName(type);
         return resolved || type;
     };
     Compiler.prototype.isArrayType = function (typeNode) {

package/dist/base-compiler.d.ts

@@ -44,7 +44,7 @@ export type EnumMember = {
 export interface IWriter {
     get outputInfo(): TypeSourceInformation;
     begin(filePath: string | null): void;
-    resolveCSharpTypeName(typescriptTypeName: string, baseTypes?: string[]): string | void;
+    resolveNeedleTypeName(typescriptTypeName: string, baseTypes?: string[]): string | void;
     end(filePath: string | null): void;
     startNewType(filePath: string | null, typeName: string, baseType: string[], comments?: string[]): void | boolean;
     endNewType(filePath: string | null, typeName: string): void;

package/dist/impl/blender-compiler.d.ts

@@ -1,7 +1,7 @@
 import { Visibility } from "../base-compiler";
 import { BaseWriter } from "../BaseWriter";
 export declare class BlenderWriter extends BaseWriter {
-    resolveCSharpTypeName(typeName: string, comments?: string[]): string | void;
+    resolveNeedleTypeName(typeName: string, comments?: string[]): string | void;
     startNewType(filePath: string | null, typeName: string, baseTypes: string[], comments?: string[]): void | boolean;
     endNewType(filePath: string | null, typeName: string): void;
     writeMember(visibility: Visibility, name: string, isArray: boolean, type: string, initialValue?: string, comments?: string[]): void;

package/dist/impl/blender-compiler.js

@@ -26,7 +26,7 @@ var BlenderWriter = /** @class */ (function (_super) {
     function BlenderWriter() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
-    BlenderWriter.prototype.resolveCSharpTypeName = function (typeName, comments) {
+    BlenderWriter.prototype.resolveNeedleTypeName = function (typeName, comments) {
         typeName = typeName.toLocaleLowerCase();
         if (typeName.startsWith("three."))
             typeName = typeName.substring("three.".length);
@@ -59,17 +59,23 @@ var BlenderWriter = /** @class */ (function (_super) {
             case "eventlist":
                 return "evt";
             case "behaviour":
-            case "animation": // Animation component ref
-            case "animator": // Animator component ref
-            case "camera":
-            case "light":
-            case "rigidbody":
-            case "renderer": // Renderer component ref
-            case "canvas": // Canvas component ref
-            case "charactercontroller": // CharacterController component ref
-            case "videoplayer": // VideoPlayer component ref
-            case "lookatconstraint": // LookAtConstraint component ref
                 return "comp";
+            case "animation": return "Animation";
+            case "animator": return "Animator";
+            case "camera": return "Camera";
+            case "light": return "Light";
+            case "rigidbody": return "Rigidbody";
+            case "renderer": return "Renderer";
+            case "canvas": return "Canvas";
+            case "videoplayer": return "VideoPlayer";
+            case "audiosource": return "AudioSource";
+            case "spherecollider": return "SphereCollider";
+            case "meshcollider": return "MeshCollider";
+            case "boxcollider": return "BoxCollider";
+            case "playabledirector": return "PlayableDirector";
+            case "dragcontrols": return "DragControls";
+            case "button": return "Button";
+            case "text": return "Text";
             case "texture":
                 return "tex";
             case "image":

package/dist/impl/csharp-compiler.d.ts

@@ -3,7 +3,7 @@ import { BaseWriter } from "../BaseWriter";
 export declare class CSharpWriter extends BaseWriter {
     private externalTypes;
     constructor(sink?: ISink, externalTypes?: Record<string, string>);
-    resolveCSharpTypeName(typescriptTypeName: string): string | void;
+    resolveNeedleTypeName(typescriptTypeName: string): string | void;
     /** Tries to resolve a C# type name; returns undefined if the type is not known.
      *  Checks TYPE_MAP keys/values and the enum registry. */
     resolveKnownCSharpTypeName(typeName: string): string | undefined;

package/dist/impl/csharp-compiler.js

@@ -129,7 +129,7 @@ var CSharpWriter = /** @class */ (function (_super) {
         _this.externalTypes = externalTypes;
         return _this;
     }
-    CSharpWriter.prototype.resolveCSharpTypeName = function (typescriptTypeName) {
+    CSharpWriter.prototype.resolveNeedleTypeName = function (typescriptTypeName) {
         var _a, _b, _c, _d, _e;
         if (!typescriptTypeName)
             return undefined;
@@ -191,7 +191,7 @@ var CSharpWriter = /** @class */ (function (_super) {
         }
         else if (baseTypes === null || baseTypes === void 0 ? void 0 : baseTypes.length) {
             var first = baseTypes[0];
-            resolvedBase = (_a = this.resolveCSharpTypeName(first)) !== null && _a !== void 0 ? _a : "UnityEngine.MonoBehaviour";
+            resolvedBase = (_a = this.resolveNeedleTypeName(first)) !== null && _a !== void 0 ? _a : "UnityEngine.MonoBehaviour";
         }
         // Abstract modifier
         var isAbstract = comments === null || comments === void 0 ? void 0 : comments.includes("@abstract");
@@ -222,7 +222,7 @@ var CSharpWriter = /** @class */ (function (_super) {
         var typeOverride = comments === null || comments === void 0 ? void 0 : comments.find(function (c) { return c.startsWith("@type "); });
         var csharpType = typeOverride
             ? typeOverride.substring("@type ".length).trim()
-            : ((_a = this.resolveCSharpTypeName(type)) !== null && _a !== void 0 ? _a : type);
+            : ((_a = this.resolveNeedleTypeName(type)) !== null && _a !== void 0 ? _a : type);
         // Determine visibility string
         var vis = "public";
         if (visibility === base_compiler_1.Visibility.Private || visibility === base_compiler_1.Visibility.Protected) {
@@ -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)
@@ -390,7 +395,7 @@ var CSharpWriter = /** @class */ (function (_super) {
         if (!match)
             return expr;
         var typeName = match[1], argsStr = match[2];
-        var csharpType = (_a = this.resolveCSharpTypeName(typeName)) !== null && _a !== void 0 ? _a : typeName;
+        var csharpType = (_a = this.resolveNeedleTypeName(typeName)) !== null && _a !== void 0 ? _a : typeName;
         // Convert numeric literals to float
         var csharpArgs = argsStr.replace(/(\d+\.?\d*)/g, function (n) {
             return n.includes(".") ? "".concat(n, "f") : "".concat(n, "f");

package/dist/impl/react-three-fiber-compiler.d.ts

@@ -4,7 +4,7 @@ export declare class ReactThreeFiberCompiler implements IWriter {
     get outputInfo(): TypeSourceInformation;
     private readonly _typeSourceInformation;
     constructor();
-    resolveCSharpTypeName(typescriptTypeName: string): string | void;
+    resolveNeedleTypeName(typescriptTypeName: string): string | void;
     begin(filePath: string): void;
     end(filePath: string): void;
     startNewType(filePath: string, typeName: string, baseType: string[], comments?: string[]): boolean | void;

package/dist/impl/react-three-fiber-compiler.js

@@ -12,7 +12,7 @@ var ReactThreeFiberCompiler = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
-    ReactThreeFiberCompiler.prototype.resolveCSharpTypeName = function (typescriptTypeName) {
+    ReactThreeFiberCompiler.prototype.resolveNeedleTypeName = function (typescriptTypeName) {
         return typescriptTypeName;
     };
     ReactThreeFiberCompiler.prototype.begin = function (filePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@needle-tools/needle-component-compiler",
-    "version": "3.0.19",
+    "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",