♻️ refactor to use internal Utils and add Encoder/Decoder for improved structure

Author: techouse

…n/io/github/techouse/qskotlin/Decoder.kt …ub/techouse/qskotlin/internal/Decoder.ktqs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/Decoder.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/internal/Decoder.kt qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/Decoder.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/internal/Decoder.kt

@@ -1,4 +1,4 @@
-package io.github.techouse.qskotlin
+package io.github.techouse.qskotlin.internal
 
 import io.github.techouse.qskotlin.enums.Duplicates
 import io.github.techouse.qskotlin.enums.Sentinel
@@ -226,7 +226,7 @@ internal object Decoder {
                         index.toString() == decodedRoot &&
                         options.parseLists &&
                         index <= options.listLimit -> {
-                        val list = MutableList<Any?>(index + 1) { Undefined() }
+                        val list = MutableList<Any?>(index + 1) { Undefined.Companion() }
                         list[index] = leaf
                         obj = list
                     }

…n/io/github/techouse/qskotlin/Encoder.kt …ub/techouse/qskotlin/internal/Encoder.ktqs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/Encoder.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/internal/Encoder.kt qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/Encoder.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/internal/Encoder.kt

@@ -1,15 +1,23 @@
-package io.github.techouse.qskotlin
+package io.github.techouse.qskotlin.internal
 
 import io.github.techouse.qskotlin.enums.Format
 import io.github.techouse.qskotlin.enums.Formatter
 import io.github.techouse.qskotlin.enums.ListFormat
 import io.github.techouse.qskotlin.enums.ListFormatGenerator
-import io.github.techouse.qskotlin.models.*
+import io.github.techouse.qskotlin.models.DateSerializer
+import io.github.techouse.qskotlin.models.Filter
+import io.github.techouse.qskotlin.models.FunctionFilter
+import io.github.techouse.qskotlin.models.IterableFilter
+import io.github.techouse.qskotlin.models.Sorter
+import io.github.techouse.qskotlin.models.Undefined
+import io.github.techouse.qskotlin.models.ValueEncoder
+import io.github.techouse.qskotlin.models.WeakWrapper
 import java.nio.charset.Charset
 import java.nio.charset.StandardCharsets
 import java.time.Instant
 import java.time.LocalDateTime
-import java.util.*
+import java.util.WeakHashMap
+import kotlin.collections.get
 
 /** A helper object for encoding data into a query string format. */
 internal object Encoder {
@@ -153,7 +161,7 @@ internal object Encoder {
 
                         listOf(mapOf("value" to objKeysValue.ifEmpty { null }))
                     } else {
-                        listOf(mapOf("value" to Undefined()))
+                        listOf(mapOf("value" to Undefined.Companion()))
                     }
                 }
 

…lin/io/github/techouse/qskotlin/Utils.kt …thub/techouse/qskotlin/internal/Utils.ktqs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/Utils.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/internal/Utils.kt qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/Utils.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/internal/Utils.kt

@@ -1,4 +1,4 @@
-package io.github.techouse.qskotlin
+package io.github.techouse.qskotlin.internal
 
 import io.github.techouse.qskotlin.constants.HexTable
 import io.github.techouse.qskotlin.enums.Format
@@ -11,6 +11,8 @@ import java.nio.charset.Charset
 import java.nio.charset.StandardCharsets
 import java.time.Instant
 import java.time.LocalDateTime
+import java.util.Collections
+import java.util.IdentityHashMap
 
 /** A collection of utility methods used by the library. */
 internal object Utils {
@@ -473,8 +475,7 @@ internal object Utils {
         stack.add(root)
 
         // Identity-based visited set: avoids infinite loops on cycles
-        val visited: MutableSet<Any> =
-            java.util.Collections.newSetFromMap(java.util.IdentityHashMap())
+        val visited: MutableSet<Any> = Collections.newSetFromMap(IdentityHashMap())
 
         visited.add(root)
 

qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/models/DecodeOptions.kt

@@ -1,7 +1,7 @@
 package io.github.techouse.qskotlin.models
 
-import io.github.techouse.qskotlin.Utils
 import io.github.techouse.qskotlin.enums.Duplicates
+import io.github.techouse.qskotlin.internal.Utils
 import java.nio.charset.Charset
 import java.nio.charset.StandardCharsets
 

qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/models/EncodeOptions.kt

@@ -1,9 +1,9 @@
 package io.github.techouse.qskotlin.models
 
-import io.github.techouse.qskotlin.Utils
 import io.github.techouse.qskotlin.enums.Format
 import io.github.techouse.qskotlin.enums.Formatter
 import io.github.techouse.qskotlin.enums.ListFormat
+import io.github.techouse.qskotlin.internal.Utils
 import java.nio.charset.Charset
 import java.nio.charset.StandardCharsets
 import java.time.LocalDateTime

…otlin/io/github/techouse/qskotlin/api.kt …kotlin/io/github/techouse/qskotlin/qs.ktqs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/api.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/qs.kt qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/api.kt renamed to qs-kotlin/src/main/kotlin/io/github/techouse/qskotlin/qs.kt

@@ -5,6 +5,9 @@ package io.github.techouse.qskotlin
 
 import io.github.techouse.qskotlin.enums.ListFormat
 import io.github.techouse.qskotlin.enums.Sentinel
+import io.github.techouse.qskotlin.internal.Decoder
+import io.github.techouse.qskotlin.internal.Encoder
+import io.github.techouse.qskotlin.internal.Utils
 import io.github.techouse.qskotlin.models.DecodeOptions
 import io.github.techouse.qskotlin.models.EncodeOptions
 import io.github.techouse.qskotlin.models.FunctionFilter

qs-kotlin/src/test/kotlin/io/github/techouse/qskotlin/unit/DecodeSpec.kt

@@ -1,10 +1,10 @@
 package io.github.techouse.qskotlin.unit
 
-import io.github.techouse.qskotlin.Utils
 import io.github.techouse.qskotlin.decode
 import io.github.techouse.qskotlin.encode
 import io.github.techouse.qskotlin.enums.Duplicates
 import io.github.techouse.qskotlin.fixtures.data.EmptyTestCases
+import io.github.techouse.qskotlin.internal.Utils
 import io.github.techouse.qskotlin.models.DecodeOptions
 import io.github.techouse.qskotlin.models.RegexDelimiter
 import io.github.techouse.qskotlin.models.StringDelimiter

qs-kotlin/src/test/kotlin/io/github/techouse/qskotlin/unit/EncodeSpec.kt

@@ -1,11 +1,11 @@
 package io.github.techouse.qskotlin.unit
 
-import io.github.techouse.qskotlin.Utils
 import io.github.techouse.qskotlin.encode
 import io.github.techouse.qskotlin.enums.Format
 import io.github.techouse.qskotlin.enums.ListFormat
 import io.github.techouse.qskotlin.fixtures.DummyEnum
 import io.github.techouse.qskotlin.fixtures.data.EmptyTestCases
+import io.github.techouse.qskotlin.internal.Utils
 import io.github.techouse.qskotlin.models.*
 import io.kotest.assertions.throwables.shouldNotThrow
 import io.kotest.assertions.throwables.shouldThrow

qs-kotlin/src/test/kotlin/io/github/techouse/qskotlin/unit/UtilsSpec.kt

@@ -1,8 +1,8 @@
 package io.github.techouse.qskotlin.unit
 
-import io.github.techouse.qskotlin.Utils
 import io.github.techouse.qskotlin.enums.Format
 import io.github.techouse.qskotlin.fixtures.DummyEnum
+import io.github.techouse.qskotlin.internal.Utils
 import io.github.techouse.qskotlin.models.Undefined
 import io.kotest.core.spec.style.FunSpec
 import io.kotest.matchers.maps.shouldContainKey