feat!: v4.0 breaking API cleanup + explicitApi

BREAKING changes to the core:
- treeIterator is now a read-only `val`; added `iterator(order)` and use `asSequence(order)`.
- removeChild() only removes a direct child of the receiver; added `detach()` to unhook a node.
- addChild() rejects re-parenting and cycles (throws TreeNodeException); detach() first to move.
- clear() no longer nulls the receiver's own parent; only removes descendants.
- path() returns List<TreeNode<T>>? (null) instead of throwing.

Also:
- Enable strict explicitApi() across core + both modules; add explicit `public` modifiers.
- Update tests for the new contracts + add TreeNodeV4Test; refresh .api baselines.
- README + CHANGELOG (with migration notes); bump version to 4.0.0.

47 JVM tests green.

tree-structure-serialization/build.gradle.kts

@@ -48,6 +48,7 @@ repositories {
 }
 
 kotlin {
+    explicitApi()
     jvmToolchain(21)
 
     jvm()

tree-structure-serialization/src/commonMain/kotlin/com.github.adriankuta/datastructure/tree/serialization/TreeNodeDto.kt

@@ -14,8 +14,8 @@ import kotlinx.serialization.Serializable
  */
 @Serializable
 public data class TreeNodeDto<T>(
-    val value: T,
-    val children: List<TreeNodeDto<T>> = emptyList(),
+    public val value: T,
+    public val children: List<TreeNodeDto<T>> = emptyList(),
 )
 
 /** Converts this subtree into a serializable [TreeNodeDto], preserving values and shape. */