Button

A clickable label rendered as [ LABEL ].

Constructor

new Button(label: string, handler?: () => void)

Param	Type	Description
label	string	Button text (uppercased in render)
handler	() => void	Click callback

Properties

Property	Type	Description
bounds	Bounds | undefined	Set by layout containers (Row/Col)
hovered	boolean	Whether the button is being hovered

Methods

render()

render(width: number, height: number): CharGrid

Renders [ LABEL ] vertically centered in the available space.

naturalWidth()

naturalWidth(): number

Returns the minimum width needed: label.length + 4.

onClick()

onClick(): void

Called when the button is clicked. Invokes the handler.

hitTest()

hitTest(x: number, y: number): boolean

Returns true if (x, y) is within the button's bounds.

setLabel()

setLabel(label: string): void

setHandler()

setHandler(handler: () => void): void

Example

const btn = new Button('Submit', () => {
  console.log('form submitted')
})

// use in a Row
new Row([new Text('Ready?'), btn])