Add kdoc examples and complex JSON5 build configuration test

Co-authored-by: hossain-khan <[email protected]>

Author: Copilot

lib/src/main/kotlin/io/github/json5/kotlin/JSON5.kt

@@ -53,6 +53,15 @@ object JSON5 {
      * @param serializer The serializer for type [T]
      * @param value The value to encode
      * @return JSON5 string representation
+     *
+     * ```kotlin
+     * @Serializable
+     * data class Config(val name: String, val version: Int)
+     * 
+     * val config = Config("MyApp", 1)
+     * val json5 = JSON5.encodeToString(Config.serializer(), config)
+     * // Result: {name:'MyApp',version:1}
+     * ```
      */
     fun <T> encodeToString(serializer: SerializationStrategy<T>, value: T): String {
         return format.encodeToString(serializer, value)
@@ -64,6 +73,21 @@ object JSON5 {
      * @param deserializer The deserializer for type [T]
      * @param string JSON5 string to decode
      * @return Decoded value of type [T]
+     *
+     * ```kotlin
+     * @Serializable
+     * data class Config(val name: String, val version: Int)
+     * 
+     * val json5 = """
+     *     {
+     *         // Application name
+     *         name: 'MyApp',
+     *         version: 1, // current version
+     *     }
+     * """.trimIndent()
+     * val config = JSON5.decodeFromString(Config.serializer(), json5)
+     * // Result: Config(name="MyApp", version=1)
+     * ```
      */
     fun <T> decodeFromString(deserializer: DeserializationStrategy<T>, string: String): T {
         return format.decodeFromString(deserializer, string)

lib/src/test/kotlin/io/github/json5/kotlin/JSON5IntegrationTest.kt

@@ -68,4 +68,87 @@ class JSON5IntegrationTest {
             settings = mapOf("theme" to "dark", "lang" to "en")
         )
     }
+
+    @Serializable
+    data class BuildConfig(
+        val modelVersion: String,
+        val dependencies: Map<String, String>,
+        val execution: ExecutionConfig,
+        val logging: LoggingConfig,
+        val debugging: DebuggingConfig,
+        val nodeOptions: NodeOptionsConfig
+    )
+
+    @Serializable
+    data class ExecutionConfig(
+        val analyze: String,
+        val daemon: Boolean,
+        val incremental: Boolean,
+        val parallel: Boolean,
+        val typeCheck: Boolean
+    )
+
+    @Serializable
+    data class LoggingConfig(
+        val level: String
+    )
+
+    @Serializable
+    data class DebuggingConfig(
+        val stacktrace: Boolean
+    )
+
+    @Serializable
+    data class NodeOptionsConfig(
+        val maxOldSpaceSize: Int,
+        val exposeGC: Boolean
+    )
+
+    @Test
+    fun `should handle complex JSON5 build configuration with mixed comment styles`() {
+        val buildConfigJson5 = """
+            {
+              "modelVersion": "5.0.1",  // Version of the hvigor base build capability
+              "dependencies": {
+              },
+              "execution": {
+                 "analyze": "normal",              /* Build analysis mode */
+                 "daemon": true,                   /* Whether to enable daemon process build */
+                 "incremental": true,              /* Whether to enable incremental build */
+                 "parallel": true,                 /* Whether to enable parallel build */
+                 "typeCheck": false,               /* Whether to enable type check */
+              },
+              "logging": {
+                 "level": "info"                          /* Log level */
+              },
+              "debugging": {
+                 "stacktrace": false                      /* Whether to enable stack trace */
+              },
+              "nodeOptions": {
+                 "maxOldSpaceSize": 4096,                  /* Memory size of the daemon process when the daemon process is enabled for build, in MB */
+                 "exposeGC": true                         /* Whether to enable GC */
+              }
+            }
+        """.trimIndent()
+        
+        val buildConfig = JSON5.decodeFromString(BuildConfig.serializer(), buildConfigJson5)
+        
+        buildConfig shouldBe BuildConfig(
+            modelVersion = "5.0.1",
+            dependencies = emptyMap(),
+            execution = ExecutionConfig(
+                analyze = "normal",
+                daemon = true,
+                incremental = true,
+                parallel = true,
+                typeCheck = false
+            ),
+            logging = LoggingConfig(level = "info"),
+            debugging = DebuggingConfig(stacktrace = false),
+            nodeOptions = NodeOptionsConfig(
+                maxOldSpaceSize = 4096,
+                exposeGC = true
+            )
+        )
+    }
 }