Streamline enum code with naming and comment updates

- Remove Hans() method with ambiguous semantics
- Use slices.Clone() instead of append pattern
- Shorten generic type params to P/E/M
- Update English/Chinese comments
- Update README documentation
- Update demo examples in demo2x and demo3x
- Update test comments and references

Author: yyle88

README.md

@@ -118,12 +118,12 @@ var enums = protoenum.NewEnums(
 )
 
 func main() {
-	// Lookup by enum code (returns default when not found)
+	// Lookup using enum code (returns default when not found)
 	skip := enums.GetByCode(int32(protoenumresult.ResultEnum_SKIP))
 	zaplog.LOG.Debug("pure", zap.String("msg", string(skip.Pure())))
 	zaplog.LOG.Debug("desc", zap.String("msg", skip.Meta().Desc()))
 
-	// Lookup by Go native enum value (type-safe lookup)
+	// Lookup using Go native enum value (type-safe)
 	pass := enums.GetByPure(ResultTypePass)
 	base := protoenumresult.ResultEnum(pass.Code())
 	zaplog.LOG.Debug("base", zap.String("msg", base.String()))
@@ -133,10 +133,10 @@ func main() {
 		zaplog.LOG.Debug("pass")
 	}
 
-	// Lookup by enum name (safe with default fallback)
+	// Lookup using enum name (safe with default fallback)
 	miss := enums.GetByName("MISS")
 	zaplog.LOG.Debug("pure", zap.String("msg", string(miss.Pure())))
-	zaplog.LOG.Debug("hans", zap.String("msg", miss.Meta().Hans()))
+	zaplog.LOG.Debug("desc", zap.String("msg", miss.Meta().Desc()))
 }
 ```
 
@@ -223,15 +223,15 @@ statusEnums := protoenum.NewEnums(
 
 **Multiple lookup methods:**
 ```go
-// By numeric code - always returns valid enum (default if not found)
+// Using numeric code - returns valid enum (default if not found)
 enum := statusEnums.GetByCode(1)
 fmt.Printf("Found: %s\n", enum.Meta().Desc())
 
-// By enum name - guaranteed non-nil
+// Using enum name - guaranteed non-nil
 enum = statusEnums.GetByName("SUCCESS")
 fmt.Printf("Status: %s\n", enum.Meta().Desc())
 
-// By Go native enum value - type-safe lookup
+// Using Go native enum value - type-safe lookup
 enum = statusEnums.GetByPure(StatusTypeSuccess)
 fmt.Printf("Pure: %s\n", enum.Pure())
 
@@ -273,7 +273,7 @@ case StatusTypeUnknown:
     fmt.Println("Unknown status")
 }
 
-// Lookup by Go native enum value
+// Lookup using Go native enum value
 found := enums.GetByPure(StatusTypeSuccess)
 fmt.Printf("Code: %d, Name: %s\n", found.Code(), found.Name())
 ```
@@ -339,7 +339,7 @@ fmt.Printf("Fallback: %s\n", notFound.Meta().Desc())  // Safe without nil check
 enums.UnsetDefault()  // Must unset first
 enums.SetDefault(enums.MustGetByCode(1))  // Then set new default
 
-// After UnsetDefault, lookups panic if not found
+// Once UnsetDefault called, lookups panic if not found
 // This enforces single usage pattern: collections must have defaults
 ```
 

README.zh.md

@@ -136,7 +136,7 @@ func main() {
 	// 按枚举名称查找（安全且有默认值回退）
 	miss := enums.GetByName("MISS")
 	zaplog.LOG.Debug("pure", zap.String("msg", string(miss.Pure())))
-	zaplog.LOG.Debug("hans", zap.String("msg", miss.Meta().Hans()))
+	zaplog.LOG.Debug("desc", zap.String("msg", miss.Meta().Desc()))
 }
 ```
 

internal/demos/demo2x/main.go

@@ -28,13 +28,13 @@ var enums = protoenum.NewEnums(
 )
 
 func main() {
-	// Lookup by enum code (returns default when not found)
+	// Lookup using enum code (returns default when not found)
 	// 按枚举代码查找（找不到时返回默认值）
 	skip := enums.GetByCode(int32(protoenumresult.ResultEnum_SKIP))
 	zaplog.LOG.Debug("pure", zap.String("msg", string(skip.Pure())))
 	zaplog.LOG.Debug("desc", zap.String("msg", skip.Meta().Desc()))
 
-	// Lookup by Go native enum value (type-safe lookup)
+	// Lookup using Go native enum value (type-safe)
 	// 按 Go 原生枚举值查找（类型安全查找）
 	pass := enums.GetByPure(ResultTypePass)
 	base := protoenumresult.ResultEnum(pass.Code())
@@ -46,9 +46,9 @@ func main() {
 		zaplog.LOG.Debug("pass")
 	}
 
-	// Lookup by enum name (safe with default fallback)
+	// Lookup using enum name (safe with default fallback)
 	// 按枚举名称查找（安全且有默认值回退）
 	miss := enums.GetByName("MISS")
 	zaplog.LOG.Debug("pure", zap.String("msg", string(miss.Pure())))
-	zaplog.LOG.Debug("hans", zap.String("msg", miss.Meta().Hans()))
+	zaplog.LOG.Debug("desc", zap.String("msg", miss.Meta().Desc()))
 }

internal/demos/demo3x/main.go

@@ -17,7 +17,7 @@ const (
 	StatusTypeFailure StatusType = "failure"
 )
 
-// MetaI18n represents a custom metadata type with bilingual descriptions
+// MetaI18n represents a custom metadata type with dual-language descriptions
 // MetaI18n 代表带有双语描述的自定义元数据类型
 type MetaI18n struct {
 	zhCN string // Chinese description // 中文描述
@@ -27,7 +27,7 @@ type MetaI18n struct {
 func (c *MetaI18n) Chinese() string { return c.zhCN }
 func (c *MetaI18n) English() string { return c.enUS }
 
-// Build enum collection with custom bilingual metadata
+// Build enum collection with custom dual-language metadata
 // 构建带有自定义双语元数据的枚举集合
 var enums = protoenum.NewEnums(
 	protoenum.NewEnumWithMeta(protoenumstatus.StatusEnum_UNKNOWN, StatusTypeUnknown, &MetaI18n{zhCN: "未知", enUS: "Unknown"}),
@@ -36,14 +36,14 @@ var enums = protoenum.NewEnums(
 )
 
 func main() {
-	// Lookup by Go native enum value (type-safe lookup)
+	// Lookup using Go native enum value (type-safe)
 	// 按 Go 原生枚举值查找（类型安全查找）
 	success := enums.GetByPure(StatusTypeSuccess)
 	zaplog.LOG.Debug("pure", zap.String("msg", string(success.Pure())))
 	zaplog.LOG.Debug("zh-CN", zap.String("msg", success.Meta().Chinese()))
 	zaplog.LOG.Debug("en-US", zap.String("msg", success.Meta().English()))
 
-	// Lookup by enum code (returns default when not found)
+	// Lookup using enum code (returns default when not found)
 	// 按枚举代码查找（找不到时返回默认值）
 	failure := enums.GetByCode(int32(protoenumstatus.StatusEnum_FAILURE))
 	zaplog.LOG.Debug("pure", zap.String("msg", string(failure.Pure())))

meta.go

@@ -18,12 +18,3 @@ type MetaDesc struct{ description string }
 func (c *MetaDesc) Desc() string {
 	return c.description
 }
-
-// Hans returns the Chinese description of the enum
-// Alias to Desc method, convenient with Chinese language support
-//
-// 返回枚举的中文描述
-// Desc 方法的别名，方便中文语言支持
-func (c *MetaDesc) Hans() string {
-	return c.description
-}

protoenum.go

@@ -131,12 +131,12 @@ func (c *Enum[protoEnum, plainEnum, extraMeta]) Name() string {
 // Pure returns the Go native enum value associated with this enum
 // Enables type-safe conversion from protobuf enum to Go native enum (e.g. type StatusType string)
 // Use this to get the plain enum value when working with Go native enum patterns
-// Bridges protobuf enums with existing Go enum-based business logic seamlessly
+// Bridges protobuf enums with existing Go enum-based business logic with ease
 //
 // 返回与此枚举关联的 Go 原生枚举值
 // 实现从 protobuf 枚举到 Go 原生枚举的类型安全转换（如 type StatusType string）
 // 在使用 Go 原生枚举模式时使用此方法获取朴素枚举值
-// 在桥接 protobuf 枚举与现有基于 Go 枚举的业务逻辑时至关重要
+// 无缝桥接 protobuf 枚举与现有基于 Go 枚举的业务逻辑
 func (c *Enum[protoEnum, plainEnum, extraMeta]) Pure() plainEnum {
 	return c.pure
 }

protoenum_test.go

@@ -24,13 +24,11 @@ func TestNewEnum(t *testing.T) {
 	t.Log(enum.Name())
 	t.Log(enum.Pure())
 	t.Log(enum.Meta().Desc())
-	t.Log(enum.Meta().Hans())
 
 	require.Equal(t, enum.Code(), int32(protoenumstatus.StatusEnum_SUCCESS.Number()))
 	require.Equal(t, enum.Name(), protoenumstatus.StatusEnum_SUCCESS.String())
 	require.Equal(t, enum.Pure(), StatusTypeSuccess)
 	require.Equal(t, enum.Meta().Desc(), "任务完成")
-	require.Equal(t, enum.Meta().Hans(), "任务完成")
 }
 
 // TestEnum_Base tests the Base method returns the source enum
@@ -93,10 +91,10 @@ func TestEnum_Pure(t *testing.T) {
 }
 
 // TestNewEnumWithMeta tests custom metadata type with NewEnumWithMeta
-// Checks that user-defined meta types work with the Enum instance
+// Checks that custom meta types work with the Enum instance
 //
 // 验证 NewEnumWithMeta 支持自定义元数据类型
-// 测试用户自定义的 meta 类型与 Enum 包装器配合工作
+// 测试自定义 meta 类型与 Enum 包装器配合工作
 func TestNewEnumWithMeta(t *testing.T) {
 	type StatusType string
 	const (
@@ -105,14 +103,14 @@ func TestNewEnumWithMeta(t *testing.T) {
 		StatusTypeFailure StatusType = "failure"
 	)
 
-	// MetaI18n represents a custom metadata type with bilingual descriptions
+	// MetaI18n represents a custom metadata type with dual-language descriptions
 	// MetaI18n 代表带有双语描述的自定义元数据类型
 	type MetaI18n struct {
 		zh string // Chinese description // 中文描述
 		en string // English description // 英文描述
 	}
 
-	// Create enums with custom bilingual metadata
+	// Create enums with custom dual-language metadata
 	// 使用自定义双语元数据创建枚举
 	enumUnknown := protoenum.NewEnumWithMeta(protoenumstatus.StatusEnum_UNKNOWN, StatusTypeUnknown, &MetaI18n{zh: "未知", en: "Unknown"})
 	enumSuccess := protoenum.NewEnumWithMeta(protoenumstatus.StatusEnum_SUCCESS, StatusTypeSuccess, &MetaI18n{zh: "成功", en: "Success"})
@@ -131,7 +129,7 @@ func TestNewEnumWithMeta(t *testing.T) {
 	require.Equal(t, "失败", enumFailure.Meta().zh)
 	require.Equal(t, "Failure", enumFailure.Meta().en)
 
-	// Check Pure still works with custom meta
+	// Check Pure works with custom meta as expected
 	// 验证 Pure 在自定义 meta 下仍然工作
 	require.Equal(t, StatusTypeSuccess, enumSuccess.Pure())
 	require.Equal(t, int32(protoenumstatus.StatusEnum_SUCCESS.Number()), enumSuccess.Code())