Compatibility

Runtime libraries and optional analysis have different requirements.

Runtime libraries

Area	Supported or tested requirement
Runtime platform	Kotlin/JVM; Java 17 or later
Runtime consumer compiler	Kotlin 2.3.0 or later; 2.3.0 consumer coverage in repository tests
Mosaic build	Kotlin compiler/Gradle plugin 2.4.20; language/API level 2.4
Kotlin runtime dependencies	stdlib and kotlin-test 2.4.20
Coroutines	core/test 1.11.0
Repository build and examples	JDK 21; Gradle wrapper 8.14.4
OpenTelemetry adapter	API 1.66.0; application supplies SDK or agent

The BOM aligns mosaic-core, mosaic-test, and mosaic-opentelemetry at one Mosaic version. It does not include analysis tooling. Runtime use needs no analysis plugin or registration processor.

Optional analysis

Analysis supports exactly Kotlin compiler and Gradle plugin 2.4.20, with the tested pure Kotlin/JVM main source layout under src/main/kotlin.

The plugin rejects nonstandard/generated Kotlin source paths, scripts, mixed Java/Kotlin, friend paths, other compiler plugins, plugin options, opt-ins, free compiler arguments, progressive mode, nondefault JVM interface mode, no-JDK compilation, and KSP. Android, multiplatform, test sources, framework lifecycle callbacks, and arbitrary virtual dispatch are unsupported.

The plugin validates the Java toolchain against Kotlin’s toolchain. Regenerate dependency summaries produced with incompatible toolchains. Metadata compatibility is determined by its header, not by the resource directory name.

Configure analysis and read the full supported project boundary. Unknown paths stay visible; a STANDARD warning pass is not proof that every lookup is safe.

Release migration

Mosaic 0.6.0 makes Canvas a final Mosaic-owned class. Replace external Canvas implementations and removed MosaicCanvas construction with canvas or withLayer, then recompile. Read the 0.6.0 migration notes for source/binary changes and delegate-operator behavior.