Features

  • Kotlin Multiplatform First: Works seamlessly across a wide range of targets:
    • Android & JVM/Desktop
    • JavaScript (Browser & Node.js)
    • Wasm (JS & Wasi)
    • iOS, macOS, watchOS, tvOS
    • Linux
  • Type-Safe & Compile-Time Verified: All mappings are generated and validated by KSP at compile time. No reflection, no runtime errors.
  • Zero Runtime Dependencies: The annotation library is SOURCE-only and adds no overhead to your production app.
  • Broad Class Support: Out-of-the-box support for data, enum, and sealed classes, including complex nested hierarchies.
  • Powerful Mapping Customization:
    • Property Renaming: Easily map properties with different names using @PropertyMapping.
    • Default Values: Provide fallback values for missing or null properties with @DefaultValue.
  • Advanced Type Conversion:
    • Custom Converters: Define your own conversion logic for complex types (like Uuid or Instant) using @AutoConverter.
    • Automatic Primitive Conversion: Handles conversions between primitives like Int, Long, String automatically.
  • Smart & Safe Generation:
    • Bidirectional Mapping: Generate forward and reverse mappings with a single reversible = true flag.
    • Visibility Control: Generated code automatically inherits the visibility (public or internal) of your @AutoMapperModule.
    • @OptIn Propagation: Automatically propagates @OptIn annotations from your custom converters to the generated functions, ensuring compile-time safety for experimental APIs.