// string
"something"

// narration string
"** something is being narrated **"

// HTML string
"<a href="/something">something</a>"

// TextObject
{ text: "something", character: "jason" }

// function that returns a string
() => "something" 

// function that returns a TextObject
() => { text: "something", character: "jason" }

// TextObject  
{ 
	text: "something",
	character: "jason"
}

// TextObject  
{ 
	text: "something",
	onSpawn: () => console.log("something spawned.")
}

// TextObject (it can have both of the additional properties)
{ 
	text: "something",
	character: "jason",
	onSpawn: () => console.log("something spawned.")
}

const tree = {
  start: [
    "Hello",
    { 
      text: "world", 
      onSpawn: () => console.log("spawned world")
    }
  ]
}

let health = 100;

function fallFromCliff() {
  health -= 50;
}

const tree = {
  start: [
    "** You wake up near a cliff. **",
    { 
      text: "** You panic and fall from the cliff. **", 
      onSpawn: fallFromCliff 
    }
  ]
}

const characters = {
  gotrek: {
    name: "Gotrek the Trollslayer",
    avatarSrc: "gotrek.jpg"
  }
}

const tree = {
  start: [
    "** You open your eyes and see a dwarf looking at you in disdain **",
    { 
      text: "Wake up, manling.",
      character: "gotrek" 
    }
  ]
}

// ChoiceLeaf
[
	// ChoiceObject
	// ChoiceObject
]

// ChoiceLeaf
() => [
	// ChoiceObject
	// ChoiceObject
]

{ 
	/** REQUIRED */
	label: "YES",
	text: "I think that's right",
	next: "yesBranch"

	/** OPTIONAL */
	titleTag: "some title"
	disabled: true 
}

{ 
	// code
	label: "YES",
}

{ 
	// code
	text: "I think so.",
}

// (1) A BranchKey (string)
{
	// code
	next: "yesBranch"
}

// (2) A function that returns a BranchKey
{
	// code
	next: () => "yesBranch" 
}

// (3) A nested branch
{
	// code
	next: [
		"Great! Let's go bowling."
		"How would you like to go?"
		[
			{ 
				label: "🚗",
				text: "How about we take your Honda?", 
				next: [
					"Oh, it's actually broken. We can take a cab though."
				]
			},
			{ 
				label: "🚶‍♀️",
				text: "It's not that far, we can walk.", 
				next: [
					"Sure!"
					"Would you like to race?"
					[
						{       
							label: "YES",
							text: "I don't know. ** You start running **", 
							next: [
								"** You win **"
								// Nesting can go forever 
							]
						},
						{       
							label: "No",
							text: "Nah, I don't feel like it.", 
							next: [
								"** You don't race **"
								// Nesting can go forever 
							]
						}
					]
				] 
			},
			{ 
				label: "Cancel the date",
				text: "You know what? I forgot I had some things to do.", 
				next: "cancelBranch" 
			},
		]
	]
}

// a string
{ 
	// code
	titleTag: "some title",
}

// or a function that returns a string
{ 
	// code
	titleTag: () => Math.random() < 0.5 ? "Not enough." : "Good enough.",
}

// boolean
{ 
	// code
	disabled: true,
}

// or a function that returns a boolean
{ 
	// code
	disabled: () => Math.random() < 0.5,
}