mirror of
https://github.com/AdrianKuta/Tree-Data-Structure.git
synced 2026-06-20 03:10:14 +02:00
Adrian Kuta
69d19f89e3
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.
25 lines
725 B
Kotlin
25 lines
725 B
Kotlin
package com.github.adriankuta.datastructure.tree
|
|
|
|
import com.github.adriankuta.datastructure.tree.iterators.TreeNodeIterators
|
|
import kotlin.jvm.JvmSynthetic
|
|
|
|
public typealias ChildDeclaration<T> = ChildDeclarationInterface<T>.() -> Unit
|
|
|
|
/**
|
|
* This method can be used to initialize new tree.
|
|
* ```
|
|
* val root = tree("World") { ... }
|
|
* ```
|
|
* @param root Root element of new tree.
|
|
* @see [ChildDeclarationInterface.child]
|
|
*/
|
|
@JvmSynthetic
|
|
public inline fun <reified T> tree(
|
|
root: T,
|
|
defaultIterator: TreeNodeIterators = TreeNodeIterators.PreOrder,
|
|
childDeclaration: ChildDeclaration<T>
|
|
): TreeNode<T> {
|
|
val treeNode = TreeNode(root, defaultIterator)
|
|
treeNode.childDeclaration()
|
|
return treeNode
|
|
} |