@needle-tools/needle-component-compiler 3.0.17 → 3.0.19-next.e2b9a6e

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.19] - 2026-04-28
+### Fixed
+- C#: skip `= undefined` initializers — `undefined` is not valid in C#
+
+## [3.0.18] - 2026-04-28
+### Added
+- CLI: Blender write types automatically
+
+### Fixed
+- Blender: fix custom enum type parsing
+- Blender: fix missing default values in component.json
+
 ## [3.0.17] - 2026-04-17
 ### Added
 - Support for string literal union types (e.g. `axis: "x" | "y" | "z" = "y"`)

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

@@ -429,7 +429,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/cli.js

@@ -8,6 +8,7 @@ var base_compiler_1 = require("./base-compiler");
 var csharp_compiler_1 = require("./impl/csharp-compiler");
 var blender_compiler_1 = require("./impl/blender-compiler");
 var log_1 = require("./log");
+var register_types_1 = require("./register-types");
 var pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8"));
 var rawArgs = process.argv.slice(2);
 if (rawArgs.includes("--version") || rawArgs.includes("-v")) {
@@ -24,7 +25,8 @@ if (rawArgs.includes("--help") || rawArgs.includes("-h") || rawArgs.length < 3)
     console.log("  input_files  one or more .ts source files");
     console.log("");
     console.log("Options:");
-    console.log("  --types <path>  path to Types.json with extra type mappings");
+    console.log("  --types <path>           path to Types.json with extra type mappings");
+    console.log("  --register-types <bool>  auto-generate register-types (default: true)");
     console.log("");
     console.log("Flags:");
     console.log("  --silent, -s    only output errors and CMD: lines");
@@ -38,11 +40,16 @@ if (rawArgs.includes("--help") || rawArgs.includes("-h") || rawArgs.length < 3)
 // Extract flags from anywhere in the args
 var typesPath;
 var silent = false;
+var registerTypes = true;
 var positionalArgs = [];
 for (var i = 0; i < rawArgs.length; i++) {
     if (rawArgs[i] === "--types" && i + 1 < rawArgs.length) {
         typesPath = rawArgs[++i];
     }
+    else if (rawArgs[i] === "--register-types" && i + 1 < rawArgs.length) {
+        var val = rawArgs[++i].toLowerCase();
+        registerTypes = val !== "false" && val !== "0";
+    }
     else if (rawArgs[i] === "--silent" || rawArgs[i] === "-s") {
         silent = true;
     }
@@ -98,6 +105,40 @@ for (var _i = 0, inputFiles_1 = inputFiles; _i < inputFiles_1.length; _i++) {
         hasErrors = true;
     }
 }
+// Auto-detect and write register-types files using needle.config.json
+if (registerTypes && target === "blender") {
+    var codegenDir = void 0;
+    // Search upward from outputDir for needle.config.json
+    var searchDir = path.resolve(outputDir);
+    while (searchDir !== path.dirname(searchDir)) {
+        var configPath = path.join(searchDir, "needle.config.json");
+        if (fs.existsSync(configPath)) {
+            try {
+                var config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+                if (config.codegenDirectory) {
+                    codegenDir = path.resolve(searchDir, config.codegenDirectory);
+                }
+            }
+            catch (_e) { }
+            break;
+        }
+        searchDir = path.dirname(searchDir);
+    }
+    if (codegenDir) {
+        var candidates = [
+            path.join(codegenDir, "register-types.js"),
+            path.join(codegenDir, "register-types.ts"),
+            path.join(codegenDir, "register_types.ts"),
+            path.join(codegenDir, "register_types.js"),
+        ];
+        for (var _a = 0, candidates_1 = candidates; _a < candidates_1.length; _a++) {
+            var candidate = candidates_1[_a];
+            if (fs.existsSync(candidate)) {
+                (0, register_types_1.writeTypeRegistry)(writer.outputInfo, candidate);
+            }
+        }
+    }
+}
 if (hasErrors) {
     process.exit(1);
 }

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) {
@@ -245,7 +245,10 @@ var CSharpWriter = /** @class */ (function (_super) {
         // Resolve assignment
         var assignment = "";
         if (initialValue !== undefined && initialValue !== null) {
-            if (initialValue === "null") {
+            if (initialValue === "undefined") {
+                // skip — `undefined` is not valid in C#
+            }
+            else if (initialValue === "null") {
                 // keep null for reference types, skip for value types
             }
             else if (isArray && initialValue === "[]") {
@@ -387,7 +390,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.17",
+    "version": "3.0.19-next.e2b9a6e",
     "description": "Compile Editor components for Needle Engine for C# and Blender",
     "main": "dist/index.js",
     "bin": "dist/cli.js",