# Product UI

### PromptBox
A prompt box: the question types itself in, with tool chips and a send button under it.
props: text: string; chips?: [string] = ["Search","Create"]; w?: 300–1800 = 980; cps?: 1–200 = 16; delay?: 0–60 = 0.5; accent?: color = "accent"; fill?: color = "paper"; ink?: color = "ink"
example: {"el":"PromptBox","text":"Cut this talk down to 30 seconds"}

### DataTable
A data table whose rows arrive one after another, with a selection box that moves from cell to cell (path: [[row, column], …]).
props: columns: [string]; rows: […] (a list of rows, each a list of cell texts); path?: […] ([[row, column], …] cells the selection visits); hold?: 0.1–10 = 0.55; colW?: 40–800 = 230; rowH?: 20–200 = 58; each?: 0–2 = 0.07; ink?: color = "ink"; accent?: color = "accent"; fill?: color = "paper"
example: {"el":"DataTable","columns":["clip","length","status"],"rows":[["intro","0:08","cut"],["hook","0:05","kept"]],"path":[[0,2],[1,2]]}

### AuthCard
A sign-up card that fills itself in: the password types as dots, then the button turns green and says it worked.
props: title?: string = "Create your account"; email?: string = "you@example.com"; button?: string = "Sign up"; done?: string = "Signed in"; wait?: 0–30 = 1.6; accent?: color = "accent"; fill?: color = "paper"; ink?: color = "ink"
example: {"el":"AuthCard"}

### TerminalPill
A one-line terminal that types a command.
props: text: string; cps?: 1–200 = 22; delay?: 0–60 = 0.2; accent?: color = "accent"
example: {"el":"TerminalPill","text":"reelify cut talk.mp4 --post"}

### Globe
A wireframe globe that draws itself, with arcs leaping between points on it.
props: size?: 80–1600 = 520; color?: color = "accent"
example: {"el":"Globe"}

### NamedCursor
Somebody else's cursor with their name on it, travelling a path: for showing people working in the same place. The path is in pixels from where the cursor is placed ([0,0] is its own spot), so give it "place" and write small offsets such as [[0,0],[140,-60]].
props: name: string; path: [point]; color?: color = "accent"; at?: seconds|cue = 0; seconds?: 0.2–20 = 1.4
example: {"el":"NamedCursor","name":"Alan","path":[[0,0],[220,-140]]}

### FileGrid
A grid of file tiles where different ones light up in turn: "any kind of file".
props: icons?: [string] = ["play","music","chat","star","mic","search","bell","heart"]; rows?: 1–12 = 4; size?: 20–300 = 96; accent?: color = "accent"
example: {"el":"FileGrid"}

### PointCloud
A cube of points turning in space: vectors, embeddings, "it understands".
props: count?: 4–400 = 70; size?: 60–1400 = 460; color?: color = "accent"; period?: -120–120 = 10
example: {"el":"PointCloud"}

### KeyChips
Keyboard keys pressed one after another: a shortcut such as ⌘ K.
props: keys: [string]; size?: 30–400 = 110; each?: 0–2 = 0.18; ink?: color = "ink"
example: {"el":"KeyChips","keys":["⌘","K"]}

### StatusChip
A small status pill with a spinner and a verb that changes as the work moves on: Thinking, Cutting, Done.
props: verbs: [string]; hold?: 0.3–10 = 1.1; size?: 20–160 = 44; ink?: color = "ink"; accent?: color = "accent"
example: {"el":"StatusChip","verbs":["Thinking","Cutting","Captioning","Done"]}

### BubbleStack
Messages from named people piling up, one after another: requests coming in.
props: messages: […] ([{name, text}]); each?: 0–5 = 0.7; w?: 300–1700 = 900; ink?: color = "ink"; accent?: color = "accent"
example: {"el":"BubbleStack","messages":[{"name":"Maya","text":"Can you cut this to thirty seconds?"},{"name":"Omar","text":"And add captions?"}]}

### CommandPalette
A command palette: a query types itself, results list under it, the selection walks down to one and presses it. pick is the row it lands on (0 is the first).
props: query: string; results: [string]; pick?: 0–5 = 0; cps?: 2–80 = 22; delay?: 0–30 = 0.3; w?: 400–1800 = 1100; accent?: color = "accent"; ink?: color = "ink"
example: {"el":"CommandPalette","query":"cut the pauses","results":["Cut pauses and retakes","Caption every word","Add a title","Post it"],"pick":0}

### Bento
A grid of feature cards that assembles: the first is wide, the rest fill two rows. Each item has a title, and may have an icon and a big value.
props: items: […] ([{title, icon?, value?}]); w?: 500–1800 = 1500; cellH?: 120–600 = 250; each?: 0–2 = 0.1; ink?: color = "ink"; accent?: color = "accent"
example: {"el":"Bento","items":[{"title":"Cuts","icon":"scissors"},{"title":"Captions","icon":"chat"},{"title":"Motion","icon":"sparkle"},{"title":"Posting","icon":"send","value":"1 tap"}]}

### TimelineMock
An editor's timeline: named lanes, clips that slide into place, and a playhead that sweeps across. clips are [start, length] in the same units as span.
props: lanes: […] ([{label, clips: [[start, length], …]}]); span?: 1–3600 = 30; w?: 500–1800 = 1300; rowH?: 40–200 = 78; sweep?: 0.5–60 = 3.5; ink?: color = "ink"; accent?: color = "accent"
example: {"el":"TimelineMock","lanes":[{"label":"Video","clips":[[0,9],[10,8],[19,11]]},{"label":"Captions","clips":[[0,30]]},{"label":"Graphics","clips":[[3,4],[14,5],[24,4]]}]}

### CutBars
A sound wave whose silent stretches turn red and close up: the pauses being cut. cuts are [from, to] bar numbers.
props: count?: 8–90 = 46; cuts?: […] = [[8,13],[23,29],[36,40]] ([[from, to], …] in bars); w?: 300–1800 = 1200; h?: 60–800 = 240; at?: 0–60 = 0.7; color?: color = "accent"; cutColor?: color = "bad"
example: {"el":"CutBars"}
