Improve docs

Author: jan-tennert

Postgrest/src/commonMain/kotlin/io/github/jan/supabase/postgrest/annotations/Cast.kt

@@ -4,7 +4,7 @@ import io.github.jan.supabase.annotations.SupabaseInternal
 
 /**
  * Annotation to cast a column in a PostgREST query.
- * @param type The type to cast the column to. If empty, the type will be inferred from the parameter type. For example, if the parameter is of type `String`, the column will be cast to `text`.
+ * @param type The type to cast the column to. If empty, the type will be inferred from the parameter type. For example, if the parameter is of type [String], the column will be cast to `text`. For all supported auto-casts see the primitive types in [Selectable].
  */
 @Target(AnnotationTarget.VALUE_PARAMETER)
 @Retention(AnnotationRetention.SOURCE)

Postgrest/src/commonMain/kotlin/io/github/jan/supabase/postgrest/annotations/JsonPath.kt

@@ -38,7 +38,6 @@ annotation class JsonPath(vararg val path: String, val returnAsText: Boolean = f
 
     companion object {
         @SupabaseInternal const val PATH_PARAMETER_NAME = "path"
-        @SupabaseInternal const val KEY_PARAMETER_NAME = "key"
         @SupabaseInternal const val RETURN_AS_TEXT_PARAMETER_NAME = "returnAsText"
     }
 

Postgrest/src/commonMain/kotlin/io/github/jan/supabase/postgrest/annotations/Selectable.kt

@@ -2,6 +2,15 @@ package io.github.jan.supabase.postgrest.annotations
 
 import io.github.jan.supabase.annotations.SupabaseExperimental
 import io.github.jan.supabase.postgrest.query.PostgrestQueryBuilder
+import kotlinx.datetime.Instant
+import kotlinx.datetime.LocalDate
+import kotlinx.datetime.LocalDateTime
+import kotlinx.datetime.LocalTime
+import kotlinx.serialization.json.JsonArray
+import kotlinx.serialization.json.JsonElement
+import kotlinx.serialization.json.JsonObject
+import kotlinx.serialization.json.JsonPrimitive
+import kotlin.uuid.Uuid
 
 /**
  * Annotates a class as selectable.
@@ -15,7 +24,7 @@ import io.github.jan.supabase.postgrest.query.PostgrestQueryBuilder
  * - All parameters in the primary constructor must a primitive type¹, a type that is also annotated with [Selectable] or a serializable type.
  * - Parameters may be annotated with [ColumnName], [ApplyFunction], [Cast], [JsonPath], [Foreign].
  *
- * ¹: Available primitive types are: String, Int, Long, Float, Double, Boolean, Byte, Short, Char, Instant, LocalDateTime, Uuid, LocalTime, LocalDate, JsonElement, JsonObject, JsonArray, JsonPrimitive
+ * ¹: Available primitive types are: [String], [Int], [Long], [Float], [Double], [Boolean], [Byte], [Short], [Char], [Instant], [LocalDateTime], [Uuid], [LocalTime], [LocalDate], [JsonElement], [JsonObject], [JsonArray], [JsonPrimitive]
  *
  * Example usage:
  * ```kotlin
@@ -42,4 +51,4 @@ import io.github.jan.supabase.postgrest.query.PostgrestQueryBuilder
 @Target(AnnotationTarget.CLASS)
 @Retention(AnnotationRetention.SOURCE)
 @SupabaseExperimental
-annotation class Selectable
+annotation class Selectable