KSP Options¶

Kraft supports KSP processor options to customize code generation behavior. These options are set in your build.gradle.kts file inside the ksp block.

kraft.functionNameFormat¶

Customize the generated extension function name pattern.

Default¶

to${target} -- generates functions like toUserDto(), toOrder(), toStatusDto().

Template Variables¶

Variable	Description
`${target}`	Simple name of the target class
`${source}`	Simple name of the source class

Configuration¶

Set the option in your module's build.gradle.kts:

// build.gradle.kts — default behavior
ksp {
    arg("kraft.functionNameFormat", "to\${target}")
}

// build.gradle.kts — custom: includes source name
ksp {
    arg("kraft.functionNameFormat", "map\${source}To\${target}")
}

// build.gradle.kts — custom: different prefix
ksp {
    arg("kraft.functionNameFormat", "convert\${target}")
}

Note: Only one format is active per build (the last arg() call wins).

Examples¶

Given this mapping:

data class UserDto(val name: String)
data class User(val name: String)

@MapConfig(source = UserDto::class, target = User::class)
object UserMapper

Format	Generated function
`to${target}` (default)	`fun UserDto.toUser()`
`map${source}To${target}`	`fun UserDto.mapUserDtoToUser()`
`convert${target}`	`fun UserDto.convertUser()`

Applies to Enum Mappers Too¶

The format option applies equally to enum mappers declared with @MapEnum.

enum class SourceStatus { ACTIVE, INACTIVE }
enum class TargetStatus { ACTIVE, INACTIVE }

@MapEnum(source = SourceStatus::class, target = TargetStatus::class)
object StatusMapper

Format	Generated function
`to${target}` (default)	`fun SourceStatus.toTargetStatus()`
`map${source}To${target}`	`fun SourceStatus.mapSourceStatusToTargetStatus()`

Multiplatform Projects¶

For Kotlin Multiplatform projects, place the ksp block inside the module that applies the KSP plugin:

// shared/build.gradle.kts
plugins {
    kotlin("multiplatform")
    id("com.google.devtools.ksp")
}

ksp {
    arg("kraft.functionNameFormat", "map\${source}To\${target}")
}

The option applies globally to all mappers processed by that KSP invocation.