@fairyhunter13/opentui-core 0.1.90 → 0.1.92

package/src/renderables/TextNode.test.ts

@@ -1,1058 +0,0 @@
-import { describe, expect, it } from "bun:test"
-import { TextNodeRenderable, isTextNodeRenderable } from "./TextNode.js"
-import { RGBA } from "../lib/RGBA.js"
-import { StyledText, red, bold, t } from "../lib/styled-text.js"
-
-describe("TextNodeRenderable", () => {
-  describe("Constructor and Options", () => {
-    it("should create TextNode with default options", () => {
-      const node = new TextNodeRenderable({})
-
-      expect(node.fg).toBeUndefined()
-      expect(node.bg).toBeUndefined()
-      expect(node.attributes).toBe(0)
-      expect(node.children).toEqual([])
-    })
-
-    it("should create TextNode with custom options", () => {
-      const fgColor = RGBA.fromInts(255, 0, 0, 255)
-      const bgColor = RGBA.fromInts(0, 0, 255, 255)
-      const attributes = 1
-
-      const node = new TextNodeRenderable({
-        fg: fgColor,
-        bg: bgColor,
-        attributes,
-      })
-
-      expect(node.fg).toEqual(fgColor)
-      expect(node.bg).toEqual(bgColor)
-      expect(node.attributes).toBe(attributes)
-    })
-
-    it("should parse color strings in constructor", () => {
-      const node = new TextNodeRenderable({
-        fg: "#ff0000",
-        bg: "blue",
-      })
-
-      expect(node.fg?.r).toBe(1)
-      expect(node.fg?.g).toBe(0)
-      expect(node.fg?.b).toBe(0)
-      expect(node.fg?.a).toBe(1)
-      expect(node.bg?.r).toBe(0)
-      expect(node.bg?.g).toBe(0)
-      expect(node.bg?.b).toBe(1)
-      expect(node.bg?.a).toBe(1)
-    })
-
-    it("should handle undefined colors", () => {
-      const node = new TextNodeRenderable({
-        fg: undefined,
-        bg: undefined,
-      })
-
-      expect(node.fg).toBeUndefined()
-      expect(node.bg).toBeUndefined()
-    })
-  })
-
-  describe("Type Guard", () => {
-    it("should identify TextNodeRenderable instances", () => {
-      const node = new TextNodeRenderable({})
-      const plainObject = {}
-
-      expect(isTextNodeRenderable(node)).toBe(true)
-      expect(isTextNodeRenderable(plainObject)).toBe(false)
-      expect(isTextNodeRenderable(null)).toBe(false)
-      expect(isTextNodeRenderable(undefined)).toBe(false)
-    })
-  })
-
-  describe("add Method", () => {
-    it("should add string child using add", () => {
-      const node = new TextNodeRenderable({})
-
-      const index = node.add("Hello")
-
-      expect(index).toBe(0)
-      expect(node.children).toEqual(["Hello"])
-    })
-
-    it("should add TextNode child using add", () => {
-      const parent = new TextNodeRenderable({})
-      const child = new TextNodeRenderable({})
-
-      const index = parent.add(child)
-
-      expect(index).toBe(0)
-      expect(parent.children).toEqual([child])
-    })
-
-    it("should add multiple children sequentially", () => {
-      const node = new TextNodeRenderable({})
-
-      node.add("First")
-      node.add("Second")
-      const childNode = new TextNodeRenderable({})
-      node.add(childNode)
-
-      expect(node.children).toEqual(["First", "Second", childNode])
-    })
-
-    it("should add child at specific index using add method", () => {
-      const node = new TextNodeRenderable({})
-      const child1 = new TextNodeRenderable({})
-      const child2 = new TextNodeRenderable({})
-
-      node.add("First")
-      node.add(child1, 0) // Insert at beginning
-      node.add(child2, 2) // Insert at end
-
-      expect(node.children).toEqual([child1, "First", child2])
-    })
-
-    it("should add string at specific index using add method", () => {
-      const node = new TextNodeRenderable({})
-      const child1 = new TextNodeRenderable({})
-
-      node.add("First")
-      node.add(child1, 0) // Insert at beginning
-      node.add("Middle", 1) // Insert in middle
-      node.add("Last") // Append at end
-
-      expect(node.children).toEqual([child1, "Middle", "First", "Last"])
-    })
-
-    it("should reject non-TextNode children in add method", () => {
-      const node = new TextNodeRenderable({})
-      const invalidChild = { id: "invalid" }
-
-      expect(() => {
-        node.add(invalidChild as any, 0)
-      }).toThrow("TextNodeRenderable only accepts strings, TextNodeRenderable instances, or StyledText instances")
-    })
-
-    it("should add StyledText child using add method", () => {
-      const node = new TextNodeRenderable({})
-      const styledText = new StyledText([
-        { __isChunk: true, text: "Hello", fg: RGBA.fromInts(255, 0, 0, 255), attributes: 1 },
-        { __isChunk: true, text: " World", fg: RGBA.fromInts(0, 255, 0, 255), attributes: 0 },
-      ])
-
-      const index = node.add(styledText)
-
-      expect(index).toBe(0)
-      expect(node.children).toHaveLength(2)
-      expect(node.children[0]).toBeInstanceOf(TextNodeRenderable)
-      expect(node.children[1]).toBeInstanceOf(TextNodeRenderable)
-
-      const firstChild = node.children[0] as TextNodeRenderable
-      const secondChild = node.children[1] as TextNodeRenderable
-
-      expect(firstChild.children).toEqual(["Hello"])
-      expect(firstChild.fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(firstChild.attributes).toBe(1)
-
-      expect(secondChild.children).toEqual([" World"])
-      expect(secondChild.fg).toEqual(RGBA.fromInts(0, 255, 0, 255))
-      expect(secondChild.attributes).toBe(0)
-    })
-
-    it("should add StyledText child at specific index using add method", () => {
-      const node = new TextNodeRenderable({})
-      node.add("First")
-      node.add("Third")
-
-      const styledText = new StyledText([
-        { __isChunk: true, text: "Second", fg: RGBA.fromInts(255, 255, 0, 255), attributes: 2 },
-      ])
-
-      node.add(styledText, 1)
-
-      expect(node.children).toHaveLength(3)
-      expect(node.children[0]).toBe("First")
-      expect(node.children[1]).toBeInstanceOf(TextNodeRenderable)
-      expect(node.children[2]).toBe("Third")
-
-      const styledChild = node.children[1] as TextNodeRenderable
-      expect(styledChild.children).toEqual(["Second"])
-      expect(styledChild.fg).toEqual(RGBA.fromInts(255, 255, 0, 255))
-      expect(styledChild.attributes).toBe(2)
-    })
-  })
-
-  describe("insertBefore and remove Methods", () => {
-    it("should insert child before anchor node", () => {
-      const node = new TextNodeRenderable({})
-      const anchor = new TextNodeRenderable({})
-
-      node.add("First")
-      node.add(anchor)
-      node.add("Last")
-
-      node.insertBefore("Middle", anchor)
-
-      expect(node.children).toEqual(["First", "Middle", anchor, "Last"])
-    })
-
-    it("should throw error when anchor node not found in insertBefore", () => {
-      const node = new TextNodeRenderable({})
-      const anchor = new TextNodeRenderable({})
-
-      expect(() => {
-        node.insertBefore("Test", anchor)
-      }).toThrow("Anchor node not found in children")
-    })
-
-    it("should insert StyledText before anchor node", () => {
-      const node = new TextNodeRenderable({})
-      const anchor = new TextNodeRenderable({})
-      anchor.add("Anchor")
-
-      node.add("First")
-      node.add(anchor)
-      node.add("Last")
-
-      const styledText = new StyledText([
-        { __isChunk: true, text: "Middle", fg: RGBA.fromInts(128, 128, 128, 255), attributes: 4 },
-      ])
-
-      node.insertBefore(styledText, anchor)
-
-      expect(node.children).toHaveLength(4)
-      expect(node.children[0]).toBe("First")
-      expect(node.children[1]).toBeInstanceOf(TextNodeRenderable)
-      expect(node.children[2]).toBe(anchor)
-      expect(node.children[3]).toBe("Last")
-
-      const styledChild = node.children[1] as TextNodeRenderable
-      expect(styledChild.children).toEqual(["Middle"])
-      expect(styledChild.fg).toEqual(RGBA.fromInts(128, 128, 128, 255))
-      expect(styledChild.attributes).toBe(4)
-    })
-
-    it("should remove child from node", () => {
-      const node = new TextNodeRenderable({})
-      const child = new TextNodeRenderable({})
-
-      node.add("First")
-      node.add(child)
-      node.add("Last")
-
-      node.remove(child.id)
-
-      expect(node.children).toEqual(["First", "Last"])
-      expect(child.parent).toBeNull()
-    })
-
-    it("should throw error when child not found in remove", () => {
-      const node = new TextNodeRenderable({})
-
-      expect(() => {
-        node.remove("nonexistent-id")
-      }).toThrow("Child not found in children")
-    })
-  })
-
-  describe("clear Method", () => {
-    it("should clear all children and change log", () => {
-      const node = new TextNodeRenderable({})
-
-      node.add("Test")
-      node.add(new TextNodeRenderable({}))
-
-      expect(node.children).toHaveLength(2)
-
-      node.clear()
-
-      expect(node.children).toEqual([])
-    })
-  })
-
-  describe("Style Inheritance and Merging", () => {
-    it("should merge styles with parent styles", () => {
-      const node = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        attributes: 1,
-      })
-
-      const parentStyle = {
-        bg: RGBA.fromInts(0, 0, 255, 255),
-        attributes: 2,
-      }
-
-      const merged = node.mergeStyles(parentStyle)
-
-      expect(merged.fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(merged.bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(merged.attributes).toBe(3)
-    })
-
-    it("should inherit undefined styles from parent", () => {
-      const node = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        // bg and attributes undefined (attributes defaults to 0)
-      })
-
-      const parentStyle = {
-        bg: RGBA.fromInts(0, 0, 255, 255),
-        attributes: 2,
-      }
-
-      const merged = node.mergeStyles(parentStyle)
-
-      expect(merged.fg?.r).toBe(1)
-      expect(merged.fg?.g).toBe(0)
-      expect(merged.fg?.b).toBe(0)
-      expect(merged.bg?.r).toBe(0)
-      expect(merged.bg?.g).toBe(0)
-      expect(merged.bg?.b).toBe(1)
-      expect(merged.attributes).toBe(2)
-    })
-
-    it("should inherit nothing when parent has no styling", () => {
-      const node = new TextNodeRenderable({}) // No styles defined
-
-      const parentStyle = {
-        fg: undefined,
-        bg: undefined,
-        attributes: 0,
-      }
-
-      const merged = node.mergeStyles(parentStyle)
-
-      expect(merged.fg).toBeUndefined()
-      expect(merged.bg).toBeUndefined()
-      expect(merged.attributes).toBe(0)
-    })
-
-    it("should combine attributes using bitwise OR", () => {
-      // Test various attribute combinations
-      const testCases = [
-        { nodeAttrs: 0, parentAttrs: 0, expected: 0 }, // 0 | 0 = 0
-        { nodeAttrs: 1, parentAttrs: 0, expected: 1 }, // 1 | 0 = 1 (bold)
-        { nodeAttrs: 0, parentAttrs: 2, expected: 2 }, // 0 | 2 = 2 (italic)
-        { nodeAttrs: 1, parentAttrs: 2, expected: 3 }, // 1 | 2 = 3 (bold + italic)
-        { nodeAttrs: 3, parentAttrs: 4, expected: 7 }, // 3 | 4 = 7 (bold + italic + underline)
-        { nodeAttrs: 7, parentAttrs: 8, expected: 15 }, // 7 | 8 = 15 (all previous + strikethrough)
-      ]
-
-      testCases.forEach(({ nodeAttrs, parentAttrs, expected }) => {
-        const node = new TextNodeRenderable({ attributes: nodeAttrs })
-        const parentStyle = { fg: undefined, bg: undefined, attributes: parentAttrs }
-
-        const merged = node.mergeStyles(parentStyle)
-        expect(merged.attributes).toBe(expected)
-      })
-    })
-  })
-
-  describe("gatherWithInheritedStyle Method", () => {
-    it("should gather chunks with inherited styles", () => {
-      const node = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        bg: RGBA.fromInts(0, 0, 255, 255),
-        attributes: 1,
-      })
-
-      node.add("Hello")
-      node.add(" ")
-      node.add("World")
-
-      const chunks = node.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(3)
-      chunks.forEach((chunk) => {
-        expect(chunk.fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-        expect(chunk.bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-        expect(chunk.attributes).toBe(1)
-      })
-
-      expect(chunks[0].text).toBe("Hello")
-      expect(chunks[1].text).toBe(" ")
-      expect(chunks[2].text).toBe("World")
-    })
-
-    it("should recursively gather from child TextNodes", () => {
-      const parent = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-      })
-
-      const child = new TextNodeRenderable({
-        bg: RGBA.fromInts(0, 255, 0, 255),
-      })
-
-      child.add("Child")
-      parent.add("Parent")
-      parent.add(child)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(2)
-      expect(chunks[0].text).toBe("Parent")
-      expect(chunks[0].fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(chunks[0].bg).toBeUndefined()
-
-      expect(chunks[1].text).toBe("Child")
-      expect(chunks[1].fg).toEqual(RGBA.fromInts(255, 0, 0, 255)) // Inherited from parent
-      expect(chunks[1].bg).toEqual(RGBA.fromInts(0, 255, 0, 255)) // Own style
-    })
-
-    it("should inherit nothing when parent has no default styling", () => {
-      const parent = new TextNodeRenderable({}) // No styles
-
-      const child = new TextNodeRenderable({}) // No styles
-      child.add("Child")
-
-      parent.add("Parent")
-      parent.add(child)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(2)
-      expect(chunks[0].text).toBe("Parent")
-      expect(chunks[0].fg).toBeUndefined()
-      expect(chunks[0].bg).toBeUndefined()
-      expect(chunks[0].attributes).toBe(0)
-
-      expect(chunks[1].text).toBe("Child")
-      expect(chunks[1].fg).toBeUndefined() // Nothing inherited
-      expect(chunks[1].bg).toBeUndefined() // Nothing inherited
-      expect(chunks[1].attributes).toBe(0) // Nothing inherited
-    })
-
-    it("should allow children to override parent styles independently", () => {
-      const parent = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        bg: RGBA.fromInts(0, 0, 255, 255),
-        attributes: 1,
-      })
-
-      const childOverrideFg = new TextNodeRenderable({
-        fg: RGBA.fromInts(0, 255, 0, 255),
-      })
-      childOverrideFg.add("Green Text")
-
-      const childOverrideBg = new TextNodeRenderable({
-        bg: RGBA.fromInts(255, 255, 0, 255),
-      })
-      childOverrideBg.add("Yellow BG")
-
-      const childOverrideAttrs = new TextNodeRenderable({
-        attributes: 2,
-      })
-      childOverrideAttrs.add("Italic")
-
-      parent.add(childOverrideFg)
-      parent.add(childOverrideBg)
-      parent.add(childOverrideAttrs)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(3)
-
-      // First child: overrides fg, inherits bg and attributes
-      expect(chunks[0].text).toBe("Green Text")
-      expect(chunks[0].fg).toEqual(RGBA.fromInts(0, 255, 0, 255)) // Overridden
-      expect(chunks[0].bg).toEqual(RGBA.fromInts(0, 0, 255, 255)) // Inherited
-      expect(chunks[0].attributes).toBe(1) // Inherited
-
-      // Second child: overrides bg, inherits fg and attributes
-      expect(chunks[1].text).toBe("Yellow BG")
-      expect(chunks[1].fg).toEqual(RGBA.fromInts(255, 0, 0, 255)) // Inherited
-      expect(chunks[1].bg).toEqual(RGBA.fromInts(255, 255, 0, 255)) // Overridden
-      expect(chunks[1].attributes).toBe(1) // Inherited
-
-      // Third child: overrides attributes (OR'd), inherits fg and bg
-      expect(chunks[2].text).toBe("Italic")
-      expect(chunks[2].fg).toEqual(RGBA.fromInts(255, 0, 0, 255)) // Inherited
-      expect(chunks[2].bg).toEqual(RGBA.fromInts(0, 0, 255, 255)) // Inherited
-      expect(chunks[2].attributes).toBe(3) // 1 | 2 = 3
-    })
-
-    it("should support multi-level inheritance (grandparent -> parent -> child)", () => {
-      const grandparent = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        attributes: 1,
-      })
-
-      const parent = new TextNodeRenderable({
-        bg: RGBA.fromInts(0, 0, 255, 255),
-      })
-
-      const child = new TextNodeRenderable({
-        fg: RGBA.fromInts(0, 255, 0, 255),
-        attributes: 2,
-      })
-
-      child.add("Grandchild")
-      parent.add("Parent")
-      parent.add(child)
-      grandparent.add("Grandparent")
-      grandparent.add(parent)
-
-      const chunks = grandparent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(3)
-
-      expect(chunks[0].text).toBe("Grandparent")
-      expect(chunks[0].fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(chunks[0].bg).toBeUndefined()
-      expect(chunks[0].attributes).toBe(1)
-
-      expect(chunks[1].text).toBe("Parent")
-      expect(chunks[1].fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(chunks[1].bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(chunks[1].attributes).toBe(1)
-
-      expect(chunks[2].text).toBe("Grandchild")
-      expect(chunks[2].fg).toEqual(RGBA.fromInts(0, 255, 0, 255))
-      expect(chunks[2].bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(chunks[2].attributes).toBe(3)
-    })
-
-    it("should support partial style overrides in children", () => {
-      const parent = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        bg: RGBA.fromInts(0, 0, 255, 255),
-        attributes: 1,
-      })
-
-      const childPartial1 = new TextNodeRenderable({
-        fg: RGBA.fromInts(0, 255, 0, 255),
-      })
-      childPartial1.add("Green on Blue")
-
-      const childPartial2 = new TextNodeRenderable({
-        bg: RGBA.fromInts(255, 255, 0, 255),
-      })
-      childPartial2.add("Red on Yellow")
-
-      const childPartial3 = new TextNodeRenderable({
-        attributes: 2,
-      })
-      childPartial3.add("Red on Blue Bold+Italic")
-
-      const childPartial4 = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 255, 255, 255),
-        attributes: 4,
-      })
-      childPartial4.add("White on Blue Bold+Underline")
-
-      parent.add(childPartial1)
-      parent.add(childPartial2)
-      parent.add(childPartial3)
-      parent.add(childPartial4)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(4)
-
-      // Child 1: only fg overridden
-      expect(chunks[0].text).toBe("Green on Blue")
-      expect(chunks[0].fg).toEqual(RGBA.fromInts(0, 255, 0, 255))
-      expect(chunks[0].bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(chunks[0].attributes).toBe(1)
-
-      // Child 2: only bg overridden
-      expect(chunks[1].text).toBe("Red on Yellow")
-      expect(chunks[1].fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(chunks[1].bg).toEqual(RGBA.fromInts(255, 255, 0, 255))
-      expect(chunks[1].attributes).toBe(1)
-
-      // Child 3: only attributes overridden (OR'd)
-      expect(chunks[2].text).toBe("Red on Blue Bold+Italic")
-      expect(chunks[2].fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(chunks[2].bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(chunks[2].attributes).toBe(3) // 1 | 2 = 3
-
-      // Child 4: fg and attributes overridden, bg inherited
-      expect(chunks[3].text).toBe("White on Blue Bold+Underline")
-      expect(chunks[3].fg).toEqual(RGBA.fromInts(255, 255, 255, 255))
-      expect(chunks[3].bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(chunks[3].attributes).toBe(5) // 1 | 4 = 5
-    })
-  })
-
-  describe("Static Factory Methods", () => {
-    it("should create TextNode from string using fromString", () => {
-      const node = TextNodeRenderable.fromString("Hello World", {
-        fg: "#ff0000",
-        attributes: 1,
-      })
-
-      expect(node.children).toEqual(["Hello World"])
-      expect(node.fg?.r).toBe(1)
-      expect(node.fg?.g).toBe(0)
-      expect(node.fg?.b).toBe(0)
-      expect(node.attributes).toBe(1)
-    })
-
-    it("should create TextNode from nodes using fromNodes", () => {
-      const child1 = new TextNodeRenderable({})
-      const child2 = new TextNodeRenderable({})
-
-      child1.add("First")
-      child2.add("Second")
-
-      const parent = TextNodeRenderable.fromNodes([child1, child2], {
-        fg: RGBA.fromInts(255, 255, 0, 255),
-      })
-
-      expect(parent.children).toEqual([child1, child2])
-      expect(parent.fg).toEqual(RGBA.fromInts(255, 255, 0, 255))
-    })
-  })
-
-  describe("Utility Methods", () => {
-    it("should convert to chunks using toChunks", () => {
-      const node = new TextNodeRenderable({
-        fg: "#00ff00",
-      })
-
-      node.add("Test")
-
-      const chunks = node.toChunks()
-
-      expect(chunks).toHaveLength(1)
-      expect(chunks[0].text).toBe("Test")
-      expect(chunks[0].fg?.r).toBe(0)
-      expect(chunks[0].fg?.g).toBe(1)
-      expect(chunks[0].fg?.b).toBe(0)
-    })
-
-    it("should get children using getChildren", () => {
-      const node = new TextNodeRenderable({})
-
-      node.add("String child")
-      const textNodeChild = new TextNodeRenderable({})
-      node.add(textNodeChild)
-
-      const children = node.getChildren()
-
-      expect(children).toHaveLength(1)
-      expect(children[0]).toBe(textNodeChild)
-    })
-
-    it("should get children count", () => {
-      const node = new TextNodeRenderable({})
-
-      expect(node.getChildrenCount()).toBe(0)
-
-      node.add("First")
-      expect(node.getChildrenCount()).toBe(1)
-
-      node.add(new TextNodeRenderable({}))
-      expect(node.getChildrenCount()).toBe(2)
-    })
-
-    it("should find renderable by id", () => {
-      const node = new TextNodeRenderable({})
-
-      const child1 = new TextNodeRenderable({ id: "child1" })
-      const child2 = new TextNodeRenderable({ id: "child2" })
-
-      node.add(child1)
-      node.add(child2)
-
-      expect(node.getRenderable("child1")).toBe(child1)
-      expect(node.getRenderable("child2")).toBe(child2)
-      expect(node.getRenderable("nonexistent")).toBeUndefined()
-    })
-  })
-
-  describe("StyledText Integration", () => {
-    it("should work with template literal styled text", () => {
-      const node = new TextNodeRenderable({})
-      const styled = t`Hello ${red("World")} with ${bold("bold")} text!`
-
-      node.add(styled)
-
-      expect(node.children).toHaveLength(5) // All parts become TextNodeRenderable instances
-      expect(node.children[0]).toBeInstanceOf(TextNodeRenderable)
-      expect(node.children[1]).toBeInstanceOf(TextNodeRenderable)
-      expect(node.children[2]).toBeInstanceOf(TextNodeRenderable)
-      expect(node.children[3]).toBeInstanceOf(TextNodeRenderable)
-      expect(node.children[4]).toBeInstanceOf(TextNodeRenderable)
-
-      // Check first chunk: "Hello " (no styling)
-      const helloChild = node.children[0] as TextNodeRenderable
-      expect(helloChild.children).toEqual(["Hello "])
-      expect(helloChild.fg).toBeUndefined()
-      expect(helloChild.attributes).toBe(0)
-
-      // Check second chunk: "World" (red styling)
-      const redChild = node.children[1] as TextNodeRenderable
-      expect(redChild.children).toEqual(["World"])
-      expect(redChild.fg?.r).toBe(1)
-      expect(redChild.fg?.g).toBe(0)
-      expect(redChild.fg?.b).toBe(0)
-      expect(redChild.attributes).toBe(0)
-
-      // Check third chunk: " with " (no styling)
-      const withChild = node.children[2] as TextNodeRenderable
-      expect(withChild.children).toEqual([" with "])
-      expect(withChild.fg).toBeUndefined()
-      expect(withChild.attributes).toBe(0)
-
-      // Check fourth chunk: "bold" (bold styling)
-      const boldChild = node.children[3] as TextNodeRenderable
-      expect(boldChild.children).toEqual(["bold"])
-      expect(boldChild.fg).toBeUndefined()
-      expect(boldChild.attributes).toBe(1) // bold attribute
-
-      // Check fifth chunk: " text!" (no styling)
-      const textChild = node.children[4] as TextNodeRenderable
-      expect(textChild.children).toEqual([" text!"])
-      expect(textChild.fg).toBeUndefined()
-      expect(textChild.attributes).toBe(0)
-    })
-
-    it("should preserve styles when converting StyledText to TextNodes", () => {
-      const node = new TextNodeRenderable({})
-      const styledText = new StyledText([
-        {
-          __isChunk: true,
-          text: "Red",
-          fg: RGBA.fromInts(255, 0, 0, 255),
-          bg: RGBA.fromInts(0, 0, 0, 255),
-          attributes: 1,
-        },
-        { __isChunk: true, text: "Blue", fg: RGBA.fromInts(0, 0, 255, 255), attributes: 2 },
-        { __isChunk: true, text: "Green", fg: RGBA.fromInts(0, 255, 0, 255), attributes: 0 },
-      ])
-
-      node.add(styledText)
-
-      expect(node.children).toHaveLength(3)
-
-      const redNode = node.children[0] as TextNodeRenderable
-      expect(redNode.children).toEqual(["Red"])
-      expect(redNode.fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(redNode.bg).toEqual(RGBA.fromInts(0, 0, 0, 255))
-      expect(redNode.attributes).toBe(1)
-
-      const blueNode = node.children[1] as TextNodeRenderable
-      expect(blueNode.children).toEqual(["Blue"])
-      expect(blueNode.fg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(blueNode.bg).toBeUndefined()
-      expect(blueNode.attributes).toBe(2)
-
-      const greenNode = node.children[2] as TextNodeRenderable
-      expect(greenNode.children).toEqual(["Green"])
-      expect(greenNode.fg).toEqual(RGBA.fromInts(0, 255, 0, 255))
-      expect(greenNode.bg).toBeUndefined()
-      expect(greenNode.attributes).toBe(0)
-    })
-
-    it("should handle empty StyledText", () => {
-      const node = new TextNodeRenderable({})
-      const emptyStyledText = new StyledText([])
-
-      // Add empty StyledText
-      const index = node.add(emptyStyledText)
-      expect(index).toBe(0)
-
-      // Should have no children since empty StyledText produces no TextNodes
-      expect(node.children).toHaveLength(0)
-
-      // Verify that gatherWithInheritedStyle returns empty array
-      const chunks = node.gatherWithInheritedStyle()
-      expect(chunks).toHaveLength(0)
-    })
-
-    it("should handle StyledText with empty text chunks", () => {
-      const node = new TextNodeRenderable({})
-      const styledTextWithEmptyChunks = new StyledText([
-        { __isChunk: true, text: "", fg: RGBA.fromInts(255, 0, 0, 255), attributes: 1 },
-        { __isChunk: true, text: "middle", fg: RGBA.fromInts(0, 255, 0, 255), attributes: 0 },
-        { __isChunk: true, text: "", fg: RGBA.fromInts(0, 0, 255, 255), attributes: 2 },
-      ])
-
-      node.add(styledTextWithEmptyChunks)
-
-      expect(node.children).toHaveLength(3)
-
-      // First chunk: empty text with red styling
-      const emptyRedNode = node.children[0] as TextNodeRenderable
-      expect(emptyRedNode.children).toEqual([""])
-      expect(emptyRedNode.fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(emptyRedNode.attributes).toBe(1)
-
-      // Second chunk: "middle" with green styling
-      const middleNode = node.children[1] as TextNodeRenderable
-      expect(middleNode.children).toEqual(["middle"])
-      expect(middleNode.fg).toEqual(RGBA.fromInts(0, 255, 0, 255))
-      expect(middleNode.attributes).toBe(0)
-
-      // Third chunk: empty text with blue styling
-      const emptyBlueNode = node.children[2] as TextNodeRenderable
-      expect(emptyBlueNode.children).toEqual([""])
-      expect(emptyBlueNode.fg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(emptyBlueNode.attributes).toBe(2)
-    })
-  })
-
-  describe("Link Inheritance", () => {
-    it("should inherit link from parent to child", () => {
-      const parent = new TextNodeRenderable({
-        link: { url: "https://opentui.com" },
-      })
-
-      const child = new TextNodeRenderable({})
-      child.add("Child text")
-
-      parent.add("Parent text")
-      parent.add(child)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(2)
-      expect(chunks[0].text).toBe("Parent text")
-      expect(chunks[0].link?.url).toBe("https://opentui.com")
-
-      expect(chunks[1].text).toBe("Child text")
-      expect(chunks[1].link?.url).toBe("https://opentui.com")
-    })
-
-    it("should allow child to override parent link", () => {
-      const parent = new TextNodeRenderable({
-        link: { url: "https://parent.com" },
-      })
-
-      const child = new TextNodeRenderable({
-        link: { url: "https://child.com" },
-      })
-      child.add("Child text")
-
-      parent.add("Parent text")
-      parent.add(child)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(2)
-      expect(chunks[0].link?.url).toBe("https://parent.com")
-      expect(chunks[1].link?.url).toBe("https://child.com")
-    })
-
-    it("should inherit link through multiple nesting levels", () => {
-      const grandparent = new TextNodeRenderable({
-        link: { url: "https://example.com" },
-      })
-
-      const parent = new TextNodeRenderable({})
-      const child = new TextNodeRenderable({})
-
-      child.add("Grandchild")
-      parent.add(child)
-      grandparent.add(parent)
-
-      const chunks = grandparent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(1)
-      expect(chunks[0].text).toBe("Grandchild")
-      expect(chunks[0].link?.url).toBe("https://example.com")
-    })
-
-    it("should merge link with other styles", () => {
-      const parent = new TextNodeRenderable({
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        attributes: 1,
-        link: { url: "https://opentui.com" },
-      })
-
-      const child = new TextNodeRenderable({
-        bg: RGBA.fromInts(0, 0, 255, 255),
-        attributes: 2,
-      })
-      child.add("Styled linked text")
-
-      parent.add(child)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(1)
-      expect(chunks[0].text).toBe("Styled linked text")
-      expect(chunks[0].fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(chunks[0].bg).toEqual(RGBA.fromInts(0, 0, 255, 255))
-      expect(chunks[0].attributes).toBe(3) // 1 | 2
-      expect(chunks[0].link?.url).toBe("https://opentui.com")
-    })
-
-    it("should handle undefined link in parent", () => {
-      const parent = new TextNodeRenderable({})
-
-      const child = new TextNodeRenderable({
-        link: { url: "https://child.com" },
-      })
-      child.add("Child with link")
-
-      parent.add("Parent without link")
-      parent.add(child)
-
-      const chunks = parent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(2)
-      expect(chunks[0].link).toBeUndefined()
-      expect(chunks[1].link?.url).toBe("https://child.com")
-    })
-
-    it("should preserve link when merging styles", () => {
-      const node = new TextNodeRenderable({
-        link: { url: "https://example.com" },
-        attributes: 1,
-      })
-
-      const parentStyle = {
-        fg: RGBA.fromInts(255, 0, 0, 255),
-        bg: undefined,
-        attributes: 2,
-      }
-
-      const merged = node.mergeStyles(parentStyle)
-
-      expect(merged.link?.url).toBe("https://example.com")
-      expect(merged.fg).toEqual(RGBA.fromInts(255, 0, 0, 255))
-      expect(merged.attributes).toBe(3)
-    })
-
-    it("should inherit link when node has no link", () => {
-      const node = new TextNodeRenderable({
-        fg: RGBA.fromInts(0, 255, 0, 255),
-      })
-
-      const parentStyle = {
-        fg: undefined,
-        bg: undefined,
-        attributes: 0,
-        link: { url: "https://inherited.com" },
-      }
-
-      const merged = node.mergeStyles(parentStyle)
-
-      expect(merged.link?.url).toBe("https://inherited.com")
-      expect(merged.fg).toEqual(RGBA.fromInts(0, 255, 0, 255))
-    })
-
-    it("should handle complex link inheritance tree", () => {
-      // Grandparent with link
-      const grandparent = new TextNodeRenderable({
-        link: { url: "https://grandparent.com" },
-        fg: RGBA.fromInts(255, 0, 0, 255),
-      })
-
-      // Parent inherits link, adds bg
-      const parent = new TextNodeRenderable({
-        bg: RGBA.fromInts(0, 0, 255, 255),
-      })
-
-      // Child1 inherits link, overrides fg
-      const child1 = new TextNodeRenderable({
-        fg: RGBA.fromInts(0, 255, 0, 255),
-      })
-      child1.add("Child1")
-
-      // Child2 overrides link
-      const child2 = new TextNodeRenderable({
-        link: { url: "https://child2.com" },
-      })
-      child2.add("Child2")
-
-      // Child3 has no link set, should inherit from parent
-      const child3 = new TextNodeRenderable({
-        attributes: 1,
-      })
-      child3.add("Child3")
-
-      parent.add(child1)
-      parent.add(child2)
-      parent.add(child3)
-      grandparent.add(parent)
-
-      const chunks = grandparent.gatherWithInheritedStyle()
-
-      expect(chunks).toHaveLength(3)
-
-      // Child1: inherits link from grandparent
-      expect(chunks[0].text).toBe("Child1")
-      expect(chunks[0].link?.url).toBe("https://grandparent.com")
-      expect(chunks[0].fg).toEqual(RGBA.fromInts(0, 255, 0, 255))
-
-      // Child2: overrides link
-      expect(chunks[1].text).toBe("Child2")
-      expect(chunks[1].link?.url).toBe("https://child2.com")
-
-      // Child3: inherits link from grandparent
-      expect(chunks[2].text).toBe("Child3")
-      expect(chunks[2].link?.url).toBe("https://grandparent.com")
-    })
-  })
-
-  describe("Edge Cases and Error Handling", () => {
-    it("should handle empty strings", () => {
-      const node = new TextNodeRenderable({})
-
-      node.add("")
-      node.add(" ")
-
-      const chunks = node.gatherWithInheritedStyle()
-      expect(chunks).toHaveLength(2)
-      expect(chunks[0].text).toBe("")
-      expect(chunks[1].text).toBe(" ")
-    })
-
-    it("should handle nested empty TextNodes", () => {
-      const parent = new TextNodeRenderable({})
-      const child = new TextNodeRenderable({})
-
-      parent.add(child)
-
-      const chunks = parent.gatherWithInheritedStyle()
-      expect(chunks).toHaveLength(0)
-    })
-
-    it("should handle multiple operations in sequence", () => {
-      const node = new TextNodeRenderable({})
-
-      // Add multiple items
-      for (let i = 0; i < 5; i++) {
-        node.add(`Item ${i}`)
-      }
-
-      expect(node.children).toHaveLength(5)
-
-      // Clear and verify
-      node.clear()
-      expect(node.children).toHaveLength(0)
-    })
-
-    it("should efficiently calculate positions for large trees", () => {
-      const root = new TextNodeRenderable({})
-
-      // Add many children to test position calculation efficiency
-      for (let i = 0; i < 10; i++) {
-        const child = new TextNodeRenderable({})
-        for (let j = 0; j < 5; j++) {
-          child.add(`Child ${i}-${j}`)
-        }
-        root.add(child)
-      }
-
-      // Insert before the 5th child - should be efficient
-      const fifthChild = root.children[4] as TextNodeRenderable
-      const insertChild = new TextNodeRenderable({})
-      insertChild.add("Inserted")
-
-      const startTime = performance.now()
-      root.insertBefore(insertChild, fifthChild)
-      const endTime = performance.now()
-
-      // Should complete quickly (less than 1ms for this small tree)
-      expect(endTime - startTime).toBeLessThan(1)
-
-      // Verify correct position
-      expect(root.children.indexOf(insertChild)).toBe(4)
-    })
-  })
-})