Thanks to @haruue, @hfhbd, @yz4230, @mina-jaff, @BoD, @RaoPrashanth for contributing to this release.

• New: Kotlin 2.3.20.
• New: KSP 2.3.6.
• New: Support for defining type aliases inside other types. (#2167)
• New: Add TypeName.annotated() convenience API for adding annotations to types. (#2281)
• New: Add FileSpec.addImport(MemberName) to explicitly import a member. (#2198)
• New: Add NameAllocator.contains to check if a given tag is already allocated. (#2160)
• New: :interop:javapoet module has been discontinued and is not published starting with this release. (#2292)
• New: In-development snapshots are now published to the Central Portal Snapshots repository at https://central.sonatype.com/repository/maven-snapshots/. (#2135)
• Fix: Annotation array parameters with annotation elements now correctly handled. (#2142)
• Fix: KType.asTypeName now correctly handles recursively bound generics (e.g. T : Comparable<T>). (#2162)
• Fix: Don't convert multi-statement function to expression body. (#2163)
• Fix: FunSpec.beginControlFlow now accepts nullable arguments for consistency with CodeBlock.beginControlFlow. (#2174)
• Fix: Ignore illegal characters inside escaped identifiers. (#2204)
• Fix: emitNullable correctly when deferring type in CodeWriter. (#2217)
• Fix: Escape /* and */ when emitting Kdoc. (#2258)
• Fix: Generate imports for extension members used via %M in KDocs. (#2266)

Thanks to @IRus for contributing to this release.

• New: Kotlin 2.1.21.
• New: KSP 2.1.21-2.0.1.
• New: Add support for context parameters. (#2112)
• New: Eliminate Guava dependency. (#2110)
• New: Migrate to Dokka plugin V2. (#2113)

Thanks to @ForteScarlet, @TrevorSStone, @RaoPrashanth, @damianw, @ansehoon1999, @TheMrMilchmann for contributing to this release.

• New: Kotlin 2.1.10.
• New: KSP 2.1.10-1.0.30.
• Fix: Support delegates on anonymous classes. (#2034)
• Fix: Prevent aliased imports from colliding with existing imports. (#2052)
• Fix: TypeName.MUTABLE_MAP_ENTRY now correctly uses the MutableEntry nested class name. (#2061)
• Fix: Use the same aliased import for both the nullable and non-nullable versions of a type. (#2068)
• Fix: Allow zero methods in a functional interface if it has a superinterface. (#2075)

Thanks to @brokenhappy, @tajobe, @niyajali, @ForteScarlet for contributing to this release.

This release is source- and binary-compatible with KotlinPoet 1.x.

The most important behavior change in this release is that spaces in generated code don't wrap by default anymore.

KotlinPoet 1.x used to replace space characters with newline characters whenever a given line of code exceeded the length limit. This usually led to better code formatting, but could also lead to compilation errors in generated code. Non-breaking spaces could be marked by the · character, but the discoverability of this feature wasn't great.

KotlinPoet 2.0 does not wrap spaces, even if the line of code they occur in exceeds the length limit. The newly introduced ♢ character can be used to mark spaces that are safe to wrap, which can improve code formatting. The · character has been preserved for compatibility, but its behavior is now equivalent to a regular space character.

• New: Kotlin 2.0.10.
• New: Spaces don't break by default.
• New: New ♢ placeholder representing a space that is safe to wrap.
• New: Add KSTypeAlias.toClassName(). (#1956)
• New: Add KSType.toClassNameOrNull(). (#1956)
• Fix: Enum classes that only have an init block now also generate the required semicolon. (#1953)
• Fix: Preserve typealiases in KSAnnotation.toAnnotationSpec(). (#1956)
• Fix: Preserve nullability in KSType.toClassName(). (#1956)

Thanks to @mitasov-ra for contributing to this release.

• Fix: Workaround for KT-18706: KotlinPoet now generates import aliases without backticks (#1920).

// before, doesn't compile due to KT-18706
import com.example.one.`$Foo` as `One$Foo`
import com.example.two.`$Foo` as `Two$Foo`

// now, compiles
import com.example.one.`$Foo` as One__Foo
import com.example.two.`$Foo` as Two__Foo

Thanks to @DanielGronau for contributing to this release.

• New: Kotlin 2.0.0.
• New: KSP 2.0.0-1.0.22.
• New: Promote kotlinpoet-metadata out of preview to stable.
• New: Migrate kotlinpoet-metadata to stable org.jetbrains.kotlin:kotlin-metadata-jvm artifact for Metadata parsing.
• New: Make enum entry references in KSAnnotation.toAnnotationSpec() and KSClassDeclaration.toClassName() more robust.
• Fix: Don't expand typealiases of function types to LambdaTypeNames in KSTypeReference.toTypeName().
• Fix: Avoid rounding small double and float values in %L translation (#1927).
• Fix: Fix typealias type argument resolution in KSP2 (#1929).

Thanks to @jisungbin, @hfhbd, @evant, @sgjesse, @sebek64 for contributing to this release.

• Change: kotlinx-metadata 0.9.0. Note that the KotlinClassMetadata.read is deprecated in 0.9.0 and replaced with readStrict (#1830).
  • Note: we now also provide lenient parameters to map to the underlying readStrict() and readLenient() calls (#1766).
  • We have also removed various Class/TypeElement/Metadata-to-KmClass APIs from the public API, as these are trivial to write now with kotlinx-metadata's newer APIs and allows us to focus the API surface area of this artifact better (#1891).
• New: Supertype list wraps to one-per-line if the primary constructor spans multiple lines (#1866).
• New: Extract MemberSpecHolder interface for constructs that can hold PropertySpecs and FunSpecs and their builders (#1877).
• New: joinToCode variant which operates on any type, but requires a transform lambda to convert each element into a CodeBlock (#1874).
• New: Support annotation type arguments in KSAnnotation.toAnnotationSpec() (#1889).
• Fix: Prevent name clashes between a function in class and a function call in current scope (#1850).
• Fix: Fix extension function imports (#1814).
• Fix: Omit implicit modifiers on FileSpec.scriptBuilder (#1813).
• Fix: Fix trailing newline in PropertySpec (#1827).
• Fix: KSAnnotation.toAnnotationSpec writes varargs in place instead of making them an array to work around a Kotlin issue with OptIn annotations (#1833).
• Fix: MemberNames without a package are now correctly imported (#1841)
• Fix: Throw if primary constructor delegates to other constructors (#1859).
• Fix: Aliased imports with nested class (#1876).
• Fix: Check for error types in KSType.toClassName() (#1890).
• Fix: Support generating a single import for overloaded MemberNames (#1909).

Thanks to @drawers, @rickclephas for contributing to this release.

• New: Kotlin 1.9.22.
• New: KSP 1.9.22-1.0.16.
• New: Add NameAllocator API to control keyword pre-allocation (#1803).
• Fix: Fix issue with missing suspend modifier in KSTypeReference.toTypeName (#1793).
• Fix: Honour same-package import aliases (#1794).
• Fix: Always include parameter docs in the type header (#1800).

Thanks to @gabrielittner for contributing to this release.

• Fix: Fix nullability of lambdas in KSTypeReference.toTypeName (#1756).

Thanks to @evant for contributing to this release.

• New: Kotlin 1.9.21.
• New: KSP 1.9.21-1.0.15.
• New: KSP: more accurately represent function types (#1742).