import xnano

# `xnano.open()` puts a live terminal on your screen: give it a `height` to draw in a
# region below your prompt, or leave it out to take over the whole window
with xnano.open(height=3, title='my app') as terminal:
    terminal.screen.write('Welcome to xnano!', border='rounded')
    label = terminal.screen.write('press space', x=22, y=1)

    # the terminal itself can register hooks, which hear every event on the screen
    @terminal.hook(on='key', keys='space')
    def pressed(ctx: xnano.Context):
        label.text = f'space at {ctx.clock.elapsed_seconds:.1f}s'

    # `run()` keeps the terminal alive until one of the `stop_on` keys is pressed
    terminal.run(stop_on='q')

import xnano

with xnano.open(height=3) as terminal:
    label = terminal.screen.write('')
    ball = terminal.screen.write('●', y=1)

    # the clock can be used directly in math, so the ball moves on every frame by itself
    ball.x = (terminal.clock * 10) % terminal.screen.width

    # tick hooks run on a timer, measured in seconds of the clock
    @terminal.hook(on='tick', every=1.0)
    def show_time(ctx: xnano.Context):
        label.text = f'{ctx.clock.elapsed_seconds:.0f}s on the clock'

    # `pause()` freezes everything that follows the clock, and `resume()` lets it run on
    @terminal.hook(on='key', keys='space')
    def toggle(ctx: xnano.Context):
        if ctx.clock.is_paused:
            ctx.clock.resume()
        else:
            ctx.clock.pause()
            label.text = 'paused: press space to resume'

    terminal.run(stop_on='q')

import xnano

# each service's response time, and its requests over the last 30 seconds
services = {
    'api': ('41 ms', '▂▃▃▅▃▂▃▅▆▅▃▂▃▅▆▅▃▂▂▃▅▃▂▃▅▆▅▃▂▃'),
    'web': ('870 ms', '▃▅▆▅▃▂▂▃▅▇██▇▇█▇▅▆▇██▇▆▇█▇▆▅▆▇'),
    'worker': ('12 ms', '▁▁▂▁▁▃▁▁▁▂▅▂▁▁▁▂▁▁▃▂▁▁▁▂▁▁▁▂▃▁'),
}

# a canvas from `xnano.new()` needs no live terminal: `width='100%'` fills the window
with xnano.new(width='100%', height=7) as canvas:
    screen = canvas.screen

    # positions and sizes take cells, percentages or words such as 'center' and 'right'
    screen.write('services', bold=True)
    screen.write(f'{screen.width}×{screen.height} cells', x='right', y=0, dim=True)

    cards = {}
    for index, (name, (latency, graph)) in enumerate(services.items()):
        cards[name] = screen.write(
            ['● online', f'p95 {latency}', graph],
            x=f'{index * 34}%',
            y=1,
            width='32%',
            border='rounded',
            title=name,
            foreground='green',
        )

    # `write()` returns a live placement: its text and colors can change at any time
    cards['web'].text = cards['web'].text.replace('● online', '▲ slow responses')
    cards['web'].color.fg = 'yellow'

    # and it can be read back, like any other value
    healthy = sum(card.text.startswith('●') for card in cards.values())
    screen.write(f'{healthy} of {len(cards)} services healthy', y='bottom', dim=True)

    print(screen.render(format='ansi'))

import xnano

# this stops any content within this terminal's canvas from moving outside it
with xnano.open(height=8, edges='stop') as terminal:
    player = terminal.screen.write('@', x='center', y='center')
    terminal.screen.write(
        'arrows or wasd to move · ctrl+r to reset · q to quit', y='bottom', dim=True
    )

    # `on='key'` hooks run on every key press, and again while a key repeats
    @terminal.hook(on='key')
    def move(ctx: xnano.Context):
        # `direction()` reads the arrow keys (or wasd) as a step along each axis
        step_x, step_y = ctx.keyboard.direction()
        player.move(step_x, step_y)

    # `keys=` narrows a hook to one key, or a binding with modifiers
    @terminal.hook(on='key', keys='ctrl+r')
    def reset(ctx: xnano.Context):
        player.x, player.y = 'center', 'center'

    terminal.run(stop_on='q')

import xnano

# `mouse=True` enables mouse events
with xnano.open(height=3, mouse=True) as terminal:
    terminal.screen.write('─' * 30, y=1)
    label = terminal.screen.write('drag the ●', y=2)

    # a range keeps the thumb's `x` between two columns, however far it's dragged
    thumb = terminal.screen.write('●', x=(0, 29), y=1)

    # a drag hook is a generator: each `yield` waits for the next movement of the pointer
    @thumb.hook(on='drag')
    def slide(ctx: xnano.Context):
        while ctx.mouse.is_down:
            thumb.x = ctx.parent.local(ctx.mouse.position).x
            ctx = yield
        label.text = f'dropped at {thumb.x}'

    terminal.run(stop_on='q')

import xnano

# notes are plain values, so they can be defined once and played anywhere
scale = ['C4', 'D4', 'E4', 'G4', 'A4']
chord = xnano.Note(('C4', 'E4', 'G4'), beats=2, instrument='electric_piano')

with xnano.open(height=2) as terminal:
    terminal.screen.write('press 1-5 for a note, space for a chord')
    playing = terminal.screen.write('', y=1, foreground='cyan')

    @terminal.hook(on='key')
    def play_note(ctx: xnano.Context):
        key = ctx.keyboard.key
        if key in ('1', '2', '3', '4', '5'):
            pitch = scale[int(key) - 1]
            ctx.speaker.play(xnano.Note(pitch, beats=0.5))
            playing.text = f'♪ {pitch}'
        elif key == 'space':
            ctx.speaker.play(chord)
            playing.text = '♪ C4 E4 G4'

    # melodies can also be written as text: a pitch, and its length in beats after a `:`
    if terminal.speaker.is_available:
        terminal.speaker.play('C4 E4 G4:2', instrument='piano')
    terminal.run(stop_on='q')

import xnano

with xnano.open(height=2) as terminal:
    terminal.screen.write('speak into your microphone')

    # `level` is an expression from 0.0 to 1.0, so content can follow it on every frame
    # (the default input device opens the first time a frame reads it)
    level = terminal.microphone.level
    terminal.screen.write('░' * 40, x=0, y=1, dim=True)
    terminal.screen.write(
        '█' * 40, x=0, y=1, width=level * 40 + 1, foreground='green', layer=1
    )

    terminal.run(stop_on='q')