Merge pull request #216 from simple-robot/dev/fix-event-name

fix: 修复部分事件在命名模式下的错误结果  see #215

Author: ForteScarlet

internal-processors/intents-processor/src/main/kotlin/qg/internal/processors/intents/EventIntentsAggregationProcessor.kt

@@ -52,6 +52,9 @@ private val IntentsClassName = ClassName(INTENTS_PACKAGE, INTENTS_CLASS_NAME)
 
 private const val NO_WARP = "·"
 
+private const val EVENT_NAME_BASED_MARKER_NAME = "EventNameBasedMarker"
+private const val EVENT_NAME_BASED_MARKER_PKG = "love.forte.simbot.qguild.internal"
+
 /**
  * 寻找所有 `love.forte.simbot.qguild.event.EventIntents` 的子 `object` 类型，
  * 并生成它们 intents 的各种聚合到 `EventIntentsAggregation` 中。
@@ -99,7 +102,10 @@ internal class EventIntentsAggregationProcessor(
 
         val fileBuilder = FileSpec.builder(OUTPUT_PACKAGE, AGGREGATION_FILE_NAME)
         fileBuilder.addType(aggregationBuilder.build())
-        fileBuilder.addFileComment("本文件内容为自动生成，生成于 %L", OffsetDateTime.now(ZoneOffset.ofHours(8)).toString())
+        fileBuilder.addFileComment(
+            "本文件内容为自动生成，生成于 %L",
+            OffsetDateTime.now(ZoneOffset.ofHours(8)).toString()
+        )
 
         val targetFile = fileBuilder.build()
 
@@ -198,14 +204,40 @@ internal class EventIntentsAggregationProcessor(
         data class NamesToType(val names: Set<String>, val declaration: KSClassDeclaration)
 
         val nameToTypes = list.map { declaration ->
-            val baseName = declaration.simpleName.asString()
+            val nameBasedAnnotation = declaration.annotations
+                .firstOrNull {
+                    (it.annotationType.resolve().declaration as? KSClassDeclaration)?.let { annoDecl ->
+                        annoDecl.simpleName.asString() == EVENT_NAME_BASED_MARKER_NAME
+                                && annoDecl.packageName.asString() == EVENT_NAME_BASED_MARKER_PKG
+                    } ?: false
+                }
+
+            fun baseName(): String = declaration.simpleName.asString()
+
+            fun findFromAnnotation(name: String): String? =
+                nameBasedAnnotation?.arguments?.firstOrNull {
+                    it.name?.asString() == name
+                }?.value as? String?
+
+            val firstUpper = findFromAnnotation("firstUpper")
+                ?.takeUnless { it.isBlank() }
+                ?: baseName()
+            val firstLower = findFromAnnotation("firstLower")
+                ?.takeUnless { it.isBlank() }
+                ?: baseName().replaceFirstChar(Char::lowercaseChar)
+            val snackUpper = findFromAnnotation("snackUpper")
+                ?.takeUnless { it.isBlank() }
+                ?: baseName().toSnack(true)
+            val snackLower = findFromAnnotation("snackLower")
+                ?.takeUnless { it.isBlank() }
+                ?: baseName().toSnack(false)
+
+
             val set = setOf(
-                baseName,
-                // 开头小写
-                baseName.replaceFirstChar(Char::lowercaseChar),
-                // 下划线的全大写与全小写
-                baseName.toSnack(false),
-                baseName.toSnack(true)
+                firstUpper,
+                firstLower,
+                snackUpper,
+                snackLower,
             )
 
             NamesToType(set, declaration)

simbot-component-qq-guild-api/src/commonMain/kotlin/love/forte/simbot/qguild/event/EventIntents.kt

@@ -23,6 +23,7 @@ import love.forte.simbot.qguild.PrivateDomainOnly
 import love.forte.simbot.qguild.event.EventIntents.*
 import love.forte.simbot.qguild.event.EventIntents.Companion.READY_TYPE
 import love.forte.simbot.qguild.event.EventIntents.Companion.RESUMED_TYPE
+import love.forte.simbot.qguild.internal.EventNameBasedMarker
 import love.forte.simbot.qguild.model.User
 import kotlin.jvm.JvmInline
 import kotlin.jvm.JvmName
@@ -350,6 +351,10 @@ public sealed class EventIntents {
      *   - GROUP_MSG_RECEIVE       // 群管理员主动在机器人资料页操作开启通知
      * ```
      */
+    @EventNameBasedMarker(
+        snackLower = "group_and_c2c_event",
+        snackUpper = "GROUP_AND_C2C_EVENT"
+    )
     public data object GroupAndC2CEvent : EventIntents() {
         public const val INTENTS_INDEX: Int = 25
         internal const val INTENTS: Int = 1 shl INTENTS_INDEX

simbot-component-qq-guild-api/src/commonMain/kotlin/love/forte/simbot/qguild/internal/EventNameBasedMarker.kt

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024. ForteScarlet.
+ *
+ * This file is part of simbot-component-qq-guild.
+ *
+ * simbot-component-qq-guild is free software: you can redistribute it and/or modify it under the terms
+ * of the GNU Lesser General Public License as published by the Free Software Foundation,
+ * either version 3 of the License, or (at your option) any later version.
+ *
+ * simbot-component-qq-guild is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License along with simbot-component-qq-guild.
+ * If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package love.forte.simbot.qguild.internal
+
+@Suppress("unused")
+@Target(AnnotationTarget.CLASS)
+@Retention(AnnotationRetention.SOURCE)
+internal annotation class EventNameBasedMarker(
+    val firstUpper: String = "",
+    val firstLower: String = "",
+    val snackUpper: String = "",
+    val snackLower: String = "",
+)