Kairo Reflect

kairo-reflect extends Kotlin’s reflection library.

KairoType

JVM/Kotlin reflection is powerful, but the standard APIs are fragmented across Class<T>, KClass<T>, Type, and KType. kairo-reflect unifies these into a single, runtime-rich abstraction: KairoType<T>.

• Full generic fidelity: Preserves type arguments at runtime (List<String>, not just List<*>).
• Unified access: Seamlessly move between Java and Kotlin reflection models.
• Runtime inference: Extract generic parameter types without boilerplate.
• Safer metaprogramming: Fewer lossy conversions, fewer reflection edge cases.

This makes dynamic frameworks (serialization, dependency injection, query builders) more reliable and maintainable.

Installation

Install kairo-reflect. You don’t need to install Kotlin’s reflection library separately — it’s included by default.

build.gradle.kts

dependencies {
  implementation("software.airborne.kairo:kairo-reflect")
}

Usage

kairoType

Capture a rich KairoType<T> that includes context from all major reflection models.

val type: KairoType<T> = kairoType<MyClass<String>>()

val javaClass: Class<T> = type.javaClass
val kotlinClass: KClass<T> = type.kotlinClass
val javaType: Type = type.javaType
val kotlinType: KType = type.kotlinType

KairoType.from()

Infer a generic type parameter at runtime with no manual plumbing.

abstract class MyClass<T> {
  val type: KairoType<T> = KairoType.from(MyClass::class, 0, this::class)
}