@needle-tools/needle-component-compiler 3.0.0-alpha.6.1370e84 → 3.0.0

package/Changelog.md

@@ -4,10 +4,60 @@ 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.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/base-compiler.js

@@ -132,7 +132,7 @@ var CodeTextWriter = /** @class */ (function () {
         this.lines.length = 0;
     };
     CodeTextWriter.prototype.toString = function () {
-        return this.lines.join("\r\n");
+        return this.lines.join("\n");
     };
     return CodeTextWriter;
 }());

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@needle-tools/needle-component-compiler",
-    "version": "3.0.0-alpha.6.1370e84",
+    "version": "3.0.0",
     "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/"
     }
-}
+}