feat: rename enum property names

Author: engsr6982

ApiDesign.md

@@ -53,14 +53,14 @@ class T {
   }
 
   /**
-   * C++ 侧的原始枚举名
+   * 原始枚举名（带命名空间）
    */
-  static get $c_type() {
+  static get $raw_name() {
     /* native code */
   }
 
   /**
-   * 注册到 engine 的枚举名
+   * 枚举别名（当前注册到 JsEngine 的枚举名）
    */
   static get $nick_name() {
     /* native code */
@@ -163,7 +163,7 @@ class Actor {
   }
 
   //! engine helper api
-  static get $c_type() {
+  static get $raw_name() {
     /* native code */
   }
 
@@ -173,7 +173,7 @@ class Actor {
 
   /**
    * 对两个对象进行相等性比较
-   * 由于 js 侧的比较无法准确判断两个对象是否相等，所以引擎提供了此方法，此方法会调用 C++ 侧的 operator==
+   * 此方法会调用 C++ 侧的 operator==
    */
   static $equals(a, b) {
     /* native code */

generator/binder/BindGenerator.py

@@ -336,7 +336,6 @@ def process_classes(self, namespace: NamespaceInfo):
 
     def process_enums(self, namespace: NamespaceInfo):
         result = create_result_data_struct()
-        # TODO: 处理 impl (EnumBuilder)
         # TODO: 处理 dts (EnumDecl)
 
         decl_enum_builder = self.get_template("decl_enum_builder.h.j2")

generator/binder/templates/dts_enum.d.ts.j2

@@ -17,7 +17,7 @@ declare class {{enum_info.name}} {
 
 
     // helper functions
-    static get $c_type(): string;
+    static get $raw_name(): string;
 
     static get $nick_name(): string;
 

generator/binder/templates/impl_enum_builder.cc.j2

@@ -1,5 +1,5 @@
 
-ClassDefine<void> {{fixed_enum_name}}_EnumBuilder = EnumDefineBuilder<{{enum_full_name}}>("{{enum_info.name}}", "{{fixed_enum_name}}")
+ClassDefine<void> {{fixed_enum_name}}_EnumBuilder = EnumDefineBuilder<{{enum_full_name}}>("{{enum_full_name}}", "{{fixed_enum_name}}")
 {% for enum_value_info in enum_info.values %}
 {% if str_to_num(enum_value_info.value) >= 128 or str_to_num(enum_value_info.value) < -128: %}
     .supplementEnum("{{enum_value_info.name}}", {{enum_full_name}}::{{enum_value_info.name}})

src/helper/EnumDefineBuilder.h

@@ -15,13 +15,11 @@ namespace jse {
 template <typename T>
 struct EnumDefineBuilder {
     std::string mNickName;
-    std::string mOriginName;
+    std::string mRawName;
 
-    explicit EnumDefineBuilder<T>(std::string originName)
-    : mOriginName(std::move(originName)),
-      mNickName(mOriginName) {}
-    explicit EnumDefineBuilder<T>(std::string originName, std::string nickName)
-    : mOriginName(std::move(originName)),
+    explicit EnumDefineBuilder<T>() = delete;
+    explicit EnumDefineBuilder<T>(std::string rawName, std::string nickName)
+    : mRawName(std::move(rawName)),
       mNickName(std::move(nickName)) {}
 
 
@@ -35,9 +33,9 @@ struct EnumDefineBuilder {
     }
 
     inline void registerHelperFunc(script::ClassDefineBuilder<void>& builder) {
-        builder.property("$c_type", [=]() -> Local<Value> {
+        builder.property("$raw_name", [=]() -> Local<Value> {
             try {
-                return String::newString(mOriginName);
+                return String::newString(mRawName);
             } catch (script::Exception const& e) {
             } catch (std::exception const& e) {}
             return {};