ono 0.1.0

Beautiful terminal UI components for Ratatui — themeable widgets with an eject-to-source CLI.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# Component: splash
# Animated FIGlet wordmark with gradient sweep, per-eye pulse, optional
# scanline and idle flicker. Hero piece. Heavily parameterized; tasteful
# defaults carry the aesthetic.

[component]
name = "splash"
kind = "component"
description = "Animated FIGlet wordmark. Gradient sweep across large text, asynchronous pulse on each O, optional scanline and idle flicker driven by theme knobs."
targets = ["ratatui"]

[params.text]
type = "string"
default = "ono"
doc = "Wordmark text. Two-letter repeated characters work best for the 'eyes' effect."

[params.figlet_font]
type = "enum"
values = ["ansi_shadow", "big", "standard"]
default = "ansi_shadow"
doc = "FIGlet font. ansi_shadow renders the cleanest eye shape for O."

[params.tagline]
type = "string"
default = "beautiful terminal UI components"
doc = "Subtitle rendered below the wordmark. Set to empty to suppress."

[params.sweep_secs]
type = "float"
default = 5.0
doc = "Seconds per full gradient cycle. Falls through to theme.knobs().gradient_period_secs when unset."

[params.pulse]
type = "bool"
default = true
doc = "Enable per-eye brightness pulse (async phases on the two O's)."

[params.scanline]
type = "bool"
default = true
doc = "Enable scanline overlay. Effective only when theme.knobs().scanline is also true (forest disables it)."

[params.flicker]
type = "bool"
default = true
doc = "Enable occasional 1-frame dim pulse. Effective only when theme.knobs().idle_flicker is true."

# Hand-tuned animation beats. First-class fields, not a 'custom' escape hatch.
[animation]
pulse_left_phase   = 0.0
pulse_right_phase  = 0.5
scanline_opacity   = 0.10
idle_flicker_range = [8.0, 12.0]  # seconds between flickers

# Class → palette role mapping.
[classes]
text       = "primary"
highlight  = "bright"
accent     = "accent"
tagline    = "dim"
scanline   = "bright"
background = "bg"

# Theme knobs this component reads. Listed for documentation; the engine
# always has full theme access, but this is the contract for codegen later.
[theme_knobs]
uses = ["gradient_period_secs", "pulse_amplitude", "scanline", "scanline_speed_rows_per_sec", "idle_flicker"]

# No [compose] — splash is a hero composite in logic, but does not compose
# other registered components. Its primitives (FIGlet, gradient, scanline)
# live in the engine, not the catalog.