@needle-tools/needle-component-compiler 3.0.4 → 3.0.5

package/Changelog.md

@@ -4,8 +4,16 @@ 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
+## [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`)
+- `@serializable()` decorator on getter/setter accessors now generates C# fields, with deduplication when both getter and setter are decorated
+- Support for `@type`, `@nonSerialized`, and `@serializeField` comment directives on accessor properties
 
+### Fixed
+- Fix `npx` scoped package name resolution by changing `bin` to a string
+
+## [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`

package/dist/cli.js

@@ -16,12 +16,15 @@ if (args.includes("--version") || args.includes("-v")) {
 if (args.includes("--help") || args.includes("-h") || args.length < 3) {
     console.log("needle-component-compiler v".concat(pkg.version));
     console.log("");
-    console.log("Usage: needle-component-compiler <target> <output_dir> <input_files...>");
+    console.log("Usage: needle-component-compiler <target> <output_dir> [options] <input_files...>");
     console.log("");
     console.log("  target       csharp or blender");
     console.log("  output_dir   directory for generated files");
     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("");
     console.log("Flags:");
     console.log("  --version, -v   print version");
     console.log("  --help, -h      print this help");
@@ -32,14 +35,42 @@ if (args.includes("--help") || args.includes("-h") || args.length < 3) {
 }
 var target = args[0];
 var outputDir = args[1];
-var inputFiles = args.slice(2);
+// Parse --types flag from remaining args
+var typesPath;
+var inputFiles = [];
+var remaining = args.slice(2);
+for (var i = 0; i < remaining.length; i++) {
+    if (remaining[i] === "--types" && i + 1 < remaining.length) {
+        typesPath = remaining[++i];
+    }
+    else {
+        inputFiles.push(remaining[i]);
+    }
+}
 if (target !== "csharp" && target !== "blender") {
     console.error("Error: unknown target \"".concat(target, "\". Use \"csharp\" or \"blender\"."));
     process.exit(1);
 }
+// Load external types if provided
+var externalTypes;
+if (typesPath) {
+    if (!fs.existsSync(typesPath)) {
+        console.warn("Warning: types file not found: ".concat(typesPath));
+    }
+    else {
+        try {
+            externalTypes = JSON.parse(fs.readFileSync(typesPath, "utf-8"));
+            console.log("Loaded ".concat(Object.keys(externalTypes).length, " external type mappings from ").concat(typesPath));
+        }
+        catch (e) {
+            console.error("Error reading types file: ".concat(e));
+            process.exit(1);
+        }
+    }
+}
 console.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) : new blender_compiler_1.BlenderWriter(sink);
+var writer = target === "csharp" ? new csharp_compiler_1.CSharpWriter(sink, externalTypes) : new blender_compiler_1.BlenderWriter(sink);
 var compiler = new Compiler_1.Compiler();
 var hasErrors = false;
 for (var _i = 0, inputFiles_1 = inputFiles; _i < inputFiles_1.length; _i++) {

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

@@ -1,6 +1,8 @@
-import { Argument, Visibility } from "../base-compiler";
+import { Argument, ISink, Visibility } from "../base-compiler";
 import { BaseWriter } from "../BaseWriter";
 export declare class CSharpWriter extends BaseWriter {
+    private externalTypes;
+    constructor(sink?: ISink, externalTypes?: Record<string, string>);
     resolveCSharpTypeName(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. */

package/dist/impl/csharp-compiler.js

@@ -122,21 +122,23 @@ function isEditorType(typeName) {
 }
 var CSharpWriter = /** @class */ (function (_super) {
     __extends(CSharpWriter, _super);
-    function CSharpWriter() {
-        return _super !== null && _super.apply(this, arguments) || this;
+    function CSharpWriter(sink, externalTypes) {
+        var _this = _super.call(this, sink) || this;
+        _this.externalTypes = externalTypes;
+        return _this;
     }
     CSharpWriter.prototype.resolveCSharpTypeName = function (typescriptTypeName) {
-        var _a, _b;
+        var _a, _b, _c, _d, _e, _f;
         if (!typescriptTypeName)
             return undefined;
         // Strip THREE. prefix for lookup fallback
         var stripped = typescriptTypeName.startsWith("THREE.") ? typescriptTypeName.substring(6) : typescriptTypeName;
-        return (_b = (_a = TYPE_MAP[typescriptTypeName]) !== null && _a !== void 0 ? _a : TYPE_MAP[stripped]) !== null && _b !== void 0 ? _b : typescriptTypeName;
+        return (_f = (_d = (_b = (_a = TYPE_MAP[typescriptTypeName]) !== null && _a !== void 0 ? _a : TYPE_MAP[stripped]) !== null && _b !== void 0 ? _b : (_c = this.externalTypes) === null || _c === void 0 ? void 0 : _c[typescriptTypeName]) !== null && _d !== void 0 ? _d : (_e = this.externalTypes) === null || _e === void 0 ? void 0 : _e[stripped]) !== null && _f !== void 0 ? _f : typescriptTypeName;
     };
     /** Tries to resolve a C# type name; returns undefined if the type is not known.
      *  Checks TYPE_MAP keys/values and the enum registry. */
     CSharpWriter.prototype.resolveKnownCSharpTypeName = function (typeName) {
-        var _a;
+        var _a, _b;
         if (!typeName)
             return undefined;
         // Check if it's a TS type name in the map
@@ -147,6 +149,18 @@ var CSharpWriter = /** @class */ (function (_super) {
         // Check if it's already a resolved C# type (e.g. "float", "UnityEngine.Vector3")
         if (KNOWN_CSHARP_TYPES.has(typeName))
             return typeName;
+        // Check external types (key lookup and reverse-lookup by value)
+        if (this.externalTypes) {
+            var ext = (_b = this.externalTypes[typeName]) !== null && _b !== void 0 ? _b : this.externalTypes[stripped];
+            if (ext)
+                return ext;
+            // Check if typeName is already a resolved external C# type
+            for (var _i = 0, _c = Object.values(this.externalTypes); _i < _c.length; _i++) {
+                var val = _c[_i];
+                if (val === typeName)
+                    return typeName;
+            }
+        }
         // Check if it's a registered enum type
         if (this._enumRegistry.has(typeName.toLowerCase()))
             return typeName;

package/package.json

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