@needle-tools/needle-component-compiler 3.0.11 → 3.0.13

package/Changelog.md

@@ -4,6 +4,10 @@ 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.12] - 2026-03-23
+### Fixed
+- Fix nullable array types (`Texture[] | null`, `Array<Texture> | null`, `Array<Texture | null>`) not emitting as arrays in C# and Blender output
+
 ## [3.0.5] - 2026-03-15
 ### Added
 - `--types <path>` CLI flag to load external type mappings from a JSON file (e.g. Unity's `Types.json`)

package/dist/Compiler.js

@@ -342,6 +342,17 @@ var Compiler = /** @class */ (function () {
             return undefined;
         // check if its an array
         if (this.isArrayType(typeNode)) {
+            // Unwrap union types (e.g. Texture[] | null) to find the array member
+            if (ts.isUnionTypeNode(typeNode)) {
+                for (var _i = 0, _a = typeNode.types; _i < _a.length; _i++) {
+                    var member = _a[_i];
+                    if (member.kind !== ts.SyntaxKind.NullKeyword &&
+                        member.kind !== ts.SyntaxKind.UndefinedKeyword &&
+                        member.kind !== ts.SyntaxKind.VoidKeyword) {
+                        return this.resolveType(member, writer);
+                    }
+                }
+            }
             if (typeNode.kind === ts.SyntaxKind.ArrayType) {
                 var arrayType = typeNode;
                 return this.resolveType(arrayType.elementType, writer);
@@ -381,8 +392,8 @@ var Compiler = /** @class */ (function () {
         }
         // Union types: Object3D | null | undefined → resolve the first concrete member
         if (ts.isUnionTypeNode(typeNode)) {
-            for (var _i = 0, _a = typeNode.types; _i < _a.length; _i++) {
-                var member = _a[_i];
+            for (var _b = 0, _c = typeNode.types; _b < _c.length; _b++) {
+                var member = _c[_b];
                 if (member.kind !== ts.SyntaxKind.NullKeyword &&
                     member.kind !== ts.SyntaxKind.UndefinedKeyword &&
                     member.kind !== ts.SyntaxKind.VoidKeyword) {
@@ -410,6 +421,18 @@ var Compiler = /** @class */ (function () {
     Compiler.prototype.isArrayType = function (typeNode) {
         if (!typeNode)
             return false;
+        // Unwrap union types (e.g. Texture[] | null → Texture[])
+        if (ts.isUnionTypeNode(typeNode)) {
+            for (var _i = 0, _a = typeNode.types; _i < _a.length; _i++) {
+                var member = _a[_i];
+                if (member.kind !== ts.SyntaxKind.NullKeyword &&
+                    member.kind !== ts.SyntaxKind.UndefinedKeyword &&
+                    member.kind !== ts.SyntaxKind.VoidKeyword) {
+                    return this.isArrayType(member);
+                }
+            }
+            return false;
+        }
         // check if its an array
         if (typeNode.kind === ts.SyntaxKind.ArrayType) {
             return true;

package/dist/base-compiler.js

@@ -173,7 +173,7 @@ function handleDeletedFile(filePath, types) {
 }
 function runFromFile(writer, path) {
     if (!fs.existsSync(path)) {
-        console.error("File not found", path);
+        log_1.logger.error("File not found", path);
         return;
     }
     var code = (0, fs_1.readFileSync)(path).toString();

package/dist/cli.js

@@ -57,14 +57,15 @@ var target = positionalArgs[0];
 var outputDir = positionalArgs[1];
 var inputFiles = positionalArgs.slice(2);
 if (target !== "csharp" && target !== "blender") {
-    console.error("Error: unknown target \"".concat(target, "\". Use \"csharp\" or \"blender\"."));
+    log_1.logger.error("Error: unknown target \"".concat(target, "\". Use \"csharp\" or \"blender\"."));
     process.exit(1);
 }
+log_1.logger.log("needle-component-compiler v".concat(pkg.version));
 // Load external types if provided
 var externalTypes;
 if (typesPath) {
     if (!fs.existsSync(typesPath)) {
-        console.warn("Warning: types file not found: ".concat(typesPath));
+        log_1.logger.warn("Warning: types file not found: ".concat(typesPath));
     }
     else {
         try {
@@ -72,12 +73,11 @@ if (typesPath) {
             log_1.logger.log("Loaded ".concat(Object.keys(externalTypes).length, " external type mappings from ").concat(typesPath));
         }
         catch (e) {
-            console.error("Error reading types file: ".concat(e));
+            log_1.logger.error("Error reading types file: ".concat(e));
             process.exit(1);
         }
     }
 }
-log_1.logger.log("needle-component-compiler v".concat(pkg.version));
 var sink = new base_compiler_1.FileSink(outputDir);
 var writer = target === "csharp" ? new csharp_compiler_1.CSharpWriter(sink, externalTypes) : new blender_compiler_1.BlenderWriter(sink);
 var compiler = new Compiler_1.Compiler();
@@ -86,7 +86,7 @@ for (var _i = 0, inputFiles_1 = inputFiles; _i < inputFiles_1.length; _i++) {
     var filePath = inputFiles_1[_i];
     try {
         if (!fs.existsSync(filePath)) {
-            console.error("Error: file not found: ".concat(filePath));
+            log_1.logger.error("Error: file not found: ".concat(filePath));
             hasErrors = true;
             continue;
         }
@@ -94,7 +94,7 @@ for (var _i = 0, inputFiles_1 = inputFiles; _i < inputFiles_1.length; _i++) {
         compiler.compile(writer, code, filePath);
     }
     catch (e) {
-        console.error("Error processing ".concat(filePath, ": ").concat(e));
+        log_1.logger.error("Error processing ".concat(filePath, ": ").concat(e));
         hasErrors = true;
     }
 }

package/dist/impl/blender-compiler.js

@@ -18,6 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlenderWriter = void 0;
 var base_compiler_1 = require("../base-compiler");
 var BaseWriter_1 = require("../BaseWriter");
+var log_1 = require("../log");
 var supportedTypes = ["string", "float", "int", "bool", "col", "obj", "evt", "fn", "vec2", "vec3", "comp"];
 var knownBaseTypes = ["Behaviour", "IComponent"];
 var BlenderWriter = /** @class */ (function (_super) {
@@ -187,7 +188,7 @@ var BlenderWriter = /** @class */ (function (_super) {
         this.writer.endBlock("},");
     };
     BlenderWriter.prototype.writeNewTypeExpression = function (typeName, args) {
-        console.log("new type:", typeName);
+        log_1.logger.log("new type:", typeName);
     };
     return BlenderWriter;
 }(BaseWriter_1.BaseWriter));

package/dist/impl/csharp-compiler.js

@@ -18,6 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CSharpWriter = void 0;
 var base_compiler_1 = require("../base-compiler");
 var BaseWriter_1 = require("../BaseWriter");
+var log_1 = require("../log");
 var allowDebugLogs = false;
 /** Inline type dictionary: TypeScript type name → fully-qualified C# type name */
 var TYPE_MAP = {
@@ -45,6 +46,7 @@ var TYPE_MAP = {
     "Vector3": "UnityEngine.Vector3",
     "Vector4": "UnityEngine.Vector4",
     "Quaternion": "UnityEngine.Quaternion",
+    "Euler": "UnityEngine.Vector3",
     "Color": "UnityEngine.Color",
     "RGBAColor": "UnityEngine.Color",
     "THREE.Color": "UnityEngine.Color",
@@ -209,7 +211,7 @@ var CSharpWriter = /** @class */ (function (_super) {
     CSharpWriter.prototype.writeMember = function (visibility, name, isArray, type, initialValue, comments) {
         var _a;
         if (allowDebugLogs)
-            console.log("[CSharp] writeMember", name, type, comments);
+            log_1.logger.log("[CSharp] writeMember", name, type, comments);
         // @nonSerialized → skip entirely
         if (comments === null || comments === void 0 ? void 0 : comments.some(function (c) { return c.startsWith("@nonSerialized"); }))
             return;
@@ -290,7 +292,7 @@ var CSharpWriter = /** @class */ (function (_super) {
         var _this = this;
         var _a, _b;
         if (allowDebugLogs)
-            console.log("[CSharp] writeMethod", name, returnType);
+            log_1.logger.log("[CSharp] writeMethod", name, returnType);
         // @nonSerialized → skip entirely
         if (comments === null || comments === void 0 ? void 0 : comments.some(function (c) { return c.startsWith("@nonSerialized"); }))
             return;

package/dist/register-types.js

@@ -4,8 +4,9 @@ exports.writeTypeRegistry = writeTypeRegistry;
 var fs_1 = require("fs");
 var path = require("path");
 var base_compiler_1 = require("./base-compiler");
+var log_1 = require("./log");
 function writeTypeRegistry(types, registerTypesPath) {
-    console.log("Writing type registry to", registerTypesPath);
+    log_1.logger.log("Writing type registry to", registerTypesPath);
     var directory = path.dirname(registerTypesPath);
     if (!(0, fs_1.existsSync)(directory)) {
         (0, fs_1.mkdirSync)(directory);

package/dist/watcher.js

@@ -41,7 +41,7 @@ var DirectoryWatcher = /** @class */ (function () {
                 }
             }
             catch (err) {
-                console.error(err);
+                log_1.logger.error(err);
             }
         });
         // call reload cmd 
@@ -62,14 +62,14 @@ process.on('exit', function () {
 });
 var args = process.argv.slice(2);
 if (args.length < 3) {
-    console.error("Missing arguments, usage: node watcher.js <directory> <output> <registerTypesPath>");
+    log_1.logger.error("Missing arguments, usage: node watcher.js <directory> <output> <registerTypesPath>");
     process.exit(1);
 }
 var directoryToWatch = args[0].replace("\"", "");
 var outputDirectory = args[1].replace("\"", "");
 var registerTypesPath = args[2].replace("\"", "");
 if (!fs.existsSync(directoryToWatch)) {
-    console.error("Directory to watch does not exist");
+    log_1.logger.error("Directory to watch does not exist");
     process.exit(1);
 }
 if (fs.existsSync(outputDirectory))

package/package.json

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