docs(tree): add NodeChildren Replace example

tree/example_test.go

@@ -5,6 +5,7 @@ import (
 
 	"github.com/charmbracelet/lipgloss"
 	"github.com/charmbracelet/lipgloss/tree"
+	"github.com/charmbracelet/x/ansi"
 )
 
 // Leaf Examples
@@ -67,7 +68,7 @@ func ExampleNewLeaf() {
 	//
 }
 
-func ExampleSetValue() {
+func ExampleNodeChildren_Replace() {
 	enumeratorStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("63")).MarginRight(1)
 	rootStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("35"))
 	itemStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("212"))
@@ -89,11 +90,36 @@ func ExampleSetValue() {
 		EnumeratorStyle(enumeratorStyle).
 		RootStyle(rootStyle).
 		ItemStyle(itemStyle)
-	glossier := t.Children().At(0)
-	glossier.SetValue(tree.Root(glossier.Value()).Child(tree.Root("Apparel").Child("Pink Hoodie", "Baseball Cap")))
-	fmt.Println(t.String())
+	// Add a Tree as a Child of "Glossier"
+	// This rewrites all of the tree data to do one replace. Not the most
+	// efficient. Maybe we can improve on this.
+	//
+	// That is how we're handling any Child manipulation in the Child() func as
+	// well. Because the children are an interface it's a bit trickier. We need
+	// to do an assignment, can't just manipulate the children directly.
+	t.SetChildren(t.Children().(tree.NodeChildren).
+		Replace(0, t.Children().At(0).Child(
+			tree.Root("Apparel").Child("Pink Hoodie", "Baseball Cap"),
+		)))
+
+	// Add a Leaf as a Child of "Glossier"
+	t.Children().At(0).Child("Makeup")
+	fmt.Println(ansi.Strip(t.String()))
+
 	// Output:
-	// hello
+	// ⁜ Makeup
+	// ├── Glossier
+	// │   ├── Apparel
+	// │   │   ├── Pink Hoodie
+	// │   │   ╰── Baseball Cap
+	// │   ╰── Makeup
+	// ├── Fenty Beauty
+	// │   ├── Gloss Bomb Universal Lip Luminizer
+	// │   ╰── Hot Cheeks Velour Blushlighter
+	// ├── Nyx
+	// ├── Mac
+	// ╰── Milk
+	//
 }
 
 // Tree Examples