@needle-tools/needle-component-compiler 3.0.0-alpha.7 → 3.0.1

package/Changelog.md

@@ -4,10 +4,67 @@ 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.0-alpha.1] - 2026-03-02
-- Fix: destructured method parameters (e.g. `{xr}`) now emit as `object @obj` instead of invalid `object @{xr}`
-- Fix: `Object3D` type now correctly maps to `UnityEngine.Transform`
-- Add: `RectTransform` type mapping to `UnityEngine.RectTransform`
+## [3.0.1] - 2026-03-04
+
+### Fixed
+- Fix string enum values being double-quoted in Blender output (e.g. `"\"A\""` instead of `"A"`)
+- Fix user-defined enums whose name collides with a built-in type (e.g. `Color`) being mapped to the built-in type instead of emitting as enum
+- Fix enum registry leaking across compilations, causing stale enum definitions from previous files to affect subsequent compilations
+
+## [3.0.0] - 2026-03-04
+
+### Changed
+- Rewritten compiler architecture with a new `Compiler` (TypeScript walker) + `IWriter` (output backend) design, enabling pluggable output targets
+- CLI interface: `needle-component-compiler <target> <output_dir> <input_files...>` where target is `csharp` or `blender`
+
+### Added
+
+#### Architecture
+- New `BaseWriter` / `IWriter` interface allows pluggable output backends (C#, Blender, and future targets like React Three Fiber)
+- New `ISink` / `FileSink` abstraction for output, with `NEEDLE_CODEGEN_START` / `NEEDLE_CODEGEN_END` fence support to preserve hand-written code sections
+- Standalone CLI (`npx @needle-tools/needle-component-compiler`) with `--help` and `--version` flags
+
+#### C# Compiler
+- Enum declarations with numeric and string initializers
+- Union type fields (e.g. `field: string | number`) emit as `object` with a doc comment listing the union members
+- Inferred types from initializers (e.g. `speed = 5` infers `float`, `name = "hello"` infers `string`, `new Vector3()` infers `Vector3`)
+- `@dont-generate-component` decorator to skip class generation
+- `@nonSerialized` support for fields (skips serialization)
+- `@type` override decorator for fields and classes
+- `@tooltip` decorator emits `[Tooltip("...")]` attribute
+- `@serializable` / `@serializeField` for private field serialization
+- `@ifdef` / `#if UNITY_EDITOR` wrapping for editor-only fields
+- `NEEDLE_CODEGEN` fences in generated output to preserve manual code sections
+- Static and abstract member handling (static fields skipped, static/abstract methods ignored)
+- Method return type emission (void, primitive types, mapped types)
+- Support for `declare class` with `IComponent` interface
+
+#### Blender Compiler
+- Full Blender panel schema generation from TypeScript components
+- Property type mapping: `number` → `FloatProperty`, `string` → `StringProperty`, `boolean` → `BoolProperty`, enums → `EnumProperty`, arrays → `CollectionProperty`
+- Inferred types from initializers (numbers, strings, booleans, `new` expressions)
+- Enum support with `EnumProperty` items generation
+- `@tooltip` decorator maps to Blender `description` field
+- `@nonSerialized` decorator to skip properties
+- `@dont-generate-component` decorator to skip class generation
+- `@type` override decorator
+- Missing/unknown type handling with sensible defaults
+- `register_types` generation for Blender add-on registration
+- File watcher for automatic recompilation on source changes
+- Per-component output files with automatic cleanup on deletion
+
+### Fixed
+- Destructured method parameters (e.g. `{xr}`) now emit as `object @obj` instead of invalid `object @{xr}`
+- `Object3D` type correctly maps to `UnityEngine.GameObject` (not `Transform`)
+- `new` expression type inference for explicit types (e.g. `new RGBAColor()`)
+- `RGBAColor` → `Color` automatic type mapping
+- Method inline anonymous type declarations (e.g. `myMethod(arg: {x: number})`)
+- Codegen no longer deletes manually added code outside of codegen sections
+- Output directory is created automatically if it doesn't exist
+
+### Testing
+- Comprehensive test suite with separate C# and Blender test runners (`npm test`, `npm run test:csharp`, `npm run test:blender`)
+- Test coverage for: basic fields, primitives, enums, unions, tooltips, inferred types, advanced features, codegen fences, methods, and extended type mappings
 
 ## [2.4.1-pre] - 2023-04-03
 # Blender compiler

package/dist/BaseWriter.js

@@ -31,6 +31,7 @@ var BaseWriter = /** @class */ (function () {
         configurable: true
     });
     BaseWriter.prototype.begin = function (filePath) {
+        this._enumRegistry.clear();
         if (!this._currentlyProcessingFiles[filePath]) {
             this._currentlyProcessingFiles[filePath] = [];
         }

package/dist/Compiler.js

@@ -16,13 +16,13 @@ var Compiler = /** @class */ (function () {
     Compiler.prototype.run = function (prog, writer, sourceFile, filePath) {
         var _this = this;
         console.log("Starting compilation of " + filePath);
+        writer.begin(filePath);
         // Pre-scan: collect enum declarations so type resolution works for class fields
         ts.forEachChild(sourceFile, function (node) {
             if (ts.isEnumDeclaration(node)) {
                 _this.visitEnumDeclaration(node, writer);
             }
         });
-        writer.begin(filePath);
         ts.forEachChild(sourceFile, function (node) {
             _this.visit(filePath, node, writer);
         });
@@ -46,8 +46,12 @@ var Compiler = /** @class */ (function () {
                     value = parseFloat(ts.tokenToString(member.initializer.operator) + member.initializer.operand.getText());
                     nextValue = value + 1;
                 }
+                else if (ts.isStringLiteral(member.initializer)) {
+                    // String enum value — use .text to get the raw string without surrounding quotes
+                    value = member.initializer.text;
+                }
                 else {
-                    // String or computed value — store as-is
+                    // Other computed value — store as-is
                     value = member.initializer.getText();
                 }
             }

package/dist/impl/blender-compiler.js

@@ -29,6 +29,9 @@ var BlenderWriter = /** @class */ (function (_super) {
         typeName = typeName.toLocaleLowerCase();
         if (typeName.startsWith("three."))
             typeName = typeName.substring("three.".length);
+        // If the type is a registered enum, return as-is so writeMember handles it
+        if (this._enumRegistry.has(typeName))
+            return typeName;
         switch (typeName) {
             case "number":
                 return "float";

package/package.json

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