@needle-tools/needle-component-compiler 3.0.0-alpha.2.b3c6deb → 3.0.0-alpha.4

package/Readme.md

@@ -2,10 +2,42 @@
 
 Compiles TypeScript component definitions into **Unity C#** component stubs and **Blender** Python component schemas for Needle Engine.
 
+### CLI Usage
+
+```
+npx @needle-tools/needle-component-compiler <target> <output_dir> <input_files...>
+```
+
+- `target`: `csharp` or `blender`
+- `output_dir`: directory for generated files
+- `input_files`: one or more `.ts` source files
+
+```bash
+# Generate C# component stubs
+npx @needle-tools/needle-component-compiler csharp ./codegen ./src/MyComponent.ts
+
+# Generate Blender component schemas
+npx @needle-tools/needle-component-compiler blender ./codegen ./src/MyComponent.ts
+
+# Print version
+npx @needle-tools/needle-component-compiler --version
+```
+
+### Programmatic API
+
 ```
 npm install @needle-tools/needle-component-compiler
 ```
 
+```ts
+import { Compiler, CSharpWriter, FileSink } from "@needle-tools/needle-component-compiler";
+
+const sink = new FileSink("./output");
+const writer = new CSharpWriter(sink);
+const compiler = new Compiler();
+compiler.compile(writer, code, "MyComponent.ts");
+```
+
 ### Supported TypeScript Features
 
 - Classes extending `Behaviour`, `MonoBehaviour`, or implementing `IComponent`

package/dist/Compiler.js

@@ -106,6 +106,16 @@ var Compiler = /** @class */ (function () {
         this.debugLog("[COMPILER] CLASS END", name, "\n");
     };
     Compiler.prototype.visitPropertyDeclaration = function (node, writer) {
+        // Skip static and abstract properties — they don't map to serialized fields
+        if (node.modifiers) {
+            for (var _i = 0, _a = node.modifiers; _i < _a.length; _i++) {
+                var modifier = _a[_i];
+                if (modifier.kind === ts.SyntaxKind.StaticKeyword ||
+                    modifier.kind === ts.SyntaxKind.AbstractKeyword) {
+                    return;
+                }
+            }
+        }
         var name = node.name.getText();
         var type = this.resolveType(node.type, writer);
         var visibility = this.getVisibility(node);

package/dist/impl/blender-compiler.js

@@ -97,6 +97,8 @@ var BlenderWriter = /** @class */ (function (_super) {
         return typeName;
     };
     BlenderWriter.prototype.startNewType = function (filePath, typeName, baseTypes, comments) {
+        if (comments === null || comments === void 0 ? void 0 : comments.includes("@dont-generate-component"))
+            return false;
         var isSupportedType = false;
         for (var i = 0; i < knownBaseTypes.length; i++) {
             if (baseTypes.includes(knownBaseTypes[i])) {
@@ -104,12 +106,9 @@ var BlenderWriter = /** @class */ (function (_super) {
                 break;
             }
         }
-        // console.log(baseTypes, knownBaseTypes, isSupportedType)
         if (!isSupportedType)
             return false;
         this.writer.beginBlock("{");
-        if (comments)
-            console.log(comments);
         this.writer.beginBlock("\"" + typeName + "\": {");
     };
     BlenderWriter.prototype.endNewType = function (filePath, typeName) {
@@ -120,6 +119,14 @@ var BlenderWriter = /** @class */ (function (_super) {
     BlenderWriter.prototype.writeMember = function (visibility, name, isArray, type, initialValue, comments) {
         if (visibility !== base_compiler_1.Visibility.Public)
             return;
+        // @nonSerialized → skip entirely
+        if (comments === null || comments === void 0 ? void 0 : comments.some(function (c) { return c.startsWith("@nonSerialized"); }))
+            return;
+        // @type override
+        var typeOverride = comments === null || comments === void 0 ? void 0 : comments.find(function (c) { return c.startsWith("@type "); });
+        if (typeOverride) {
+            type = typeOverride.substring("@type ".length).trim();
+        }
         // Check if type is a registered TypeScript enum
         var enumMembers = this._enumRegistry.get(type);
         if (enumMembers && enumMembers.length > 0) {

package/dist/impl/csharp-compiler.js

@@ -273,7 +273,7 @@ var CSharpWriter = /** @class */ (function (_super) {
             : "void";
         if (contextMenu)
             this.writer.writeLine("[UnityEngine.ContextMenu(\"".concat(contextMenu, "\")]"));
-        this.writer.writeLine("public void ".concat(methodName, "(").concat(paramList, ") {}"));
+        this.writer.writeLine("public ".concat(csReturnType, " ").concat(methodName, "(").concat(paramList, ") {}"));
     };
     CSharpWriter.prototype.writeNewTypeExpression = function (typeName, args) {
         // no-op for C# output

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@needle-tools/needle-component-compiler",
-    "version": "3.0.0-alpha.2.b3c6deb",
+    "version": "3.0.0-alpha.4",
     "description": "Compile Editor components for Needle Engine for C# and Blender",
     "main": "dist/index.js",
     "bin": {
@@ -57,7 +57,7 @@
         "url": "git+https://github.com/needle-tools/needle-tiny-component-compiler.git"
     },
     "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
+      "access": "public",
+      "registry": "https://registry.npmjs.org/"
     }
-}
+}