StarScript: the verbs and the tells
One grammar, one source: love-shared/dialogue_parser.lua’s VALID_VERBS, parsed for the web at the site’s build (star-web/src/board_script.rs) and stepped by board_rt/stepper.js, a line-for-line port of love-shared’s board/stepper.lua. The prose is the StarScript page; here each verb has a one-card board that runs it.
The verbs
say
A line, spoken by who. Play holds on it until the reader goes on. $name in the text is the value kept at name (a full stop after it ends the sentence).
say · press Play
say s2ar "A line, spoken. Play holds here until you go on."
end
pause
A world editor’s beat; on a card Play steps over it.
pause · press Play
say s2ar "A pause is a world editor's beat; Play steps over it."
pause 2
say s2ar "No wait was taken."
end
label
A place in the script to go to. Three names are hooks (below).
label · press Play
label openCard
say s2ar "openCard is where Play starts."
end
goto
Goes to a label in this script, or to a card.
goto · press Play
goto later
say s2ar "Never said."
label later
say s2ar "Jumped here."
end
when
Runs the next line only when the value at name is value; notequals runs it only when it is not. gt and lt compare as numbers (when hp gt 3); a value that is not a number is never greater or less.
when · press Play
set door open
when door equals open
say s2ar "Open: this line ran."
when door equals shut
say s2ar "Shut: this line is skipped."
set hp 10
when hp gt 3
say s2ar "10 is over 3, as numbers: this line ran."
say s2ar "And on."
end
set
Keeps a value. A name with dots (door.open) is a path; every card of the stack reads it while Play runs.
set · press Play
set door open
say s2ar "The door is $door."
end
end
Ends the card’s script. A card with links, or with cards its script names, offers to go on to them.
end · press Play
say s2ar "One line, then end."
end
wait_for_chat
block until heard buffer matches
branch
Goes to then when the value at name is value, else to else: each a label or a card. (the grammar’s note: multi-way jump on KV equality)
branch · press Play
set coin heads
branch coin heads yes no
label yes
say s2ar "Heads."
end
label no
say s2ar "Tails."
end
commit
snapshot last-sealed manifest as npc author
choice
An answer offered under the say before it. to is a card (c-…) or a label in this script. The pick is kept at choice, and its set: pairs keep their values when it is picked (choice yes “Yes” set:mood=glad). (the grammar’s note: choice )*
choice · press Play
say s2ar "Which way?"
choice left "Left" set:way=west
choice right "Right" set:way=east
end
label left
say s2ar "Left it is: heading $way."
end
label right
say s2ar "Right, then: heading $way."
end
ask
Asks the reader for a line of text and keeps it at name. (the grammar’s note: ask
ask · press Play
ask name "What shall we call it?"
say s2ar "$name. Kept."
end
request_file
The desktop: waits for a file dropped on the window and keeps its path at name. (the grammar’s note: request_file
request_file · press Play
request_file clip video "Drop a video (the desktop)."
say s2ar "Kept at clip."
end
pass
In an onClick hook: hands the click on to the background card under it. (the grammar’s note: pass <event_name>)
pass · press Play
label openCard
say s2ar "Click the card: onClick passes the click on."
end
label onClick
pass mouseUp
The tells
A set on tell.<to> is kept as any set and told to the page the board is on (sb-tell, {to, what}). The home answers:
| to | what | |
|---|---|---|
tell.world |
meteor, comet, flash, take |
a strike on the world (a sphere op on its tape), the light alone, or the session taken as a tape cart |
tell.act |
starlab, starboard, starlore, startune, starsaga, desk |
a tool opened beside the board |
tell.camera |
orbit |
a shot |
On these pages the live view answers tell.world (a meteor drops lava, a comet ice, a flash flashes it) and tell.camera "orbit" (one turn); the home’s tools say so.
tell.world · press Play
say s2ar "Tell the world: a meteor, a comet, a flash."
set tell.world "meteor"
say s2ar "The view beside this board took the strike."
set tell.world "flash"
end
tell.worldRests at frame 240 with the digest 23e7eb22801d70df (pinned in api.json; tools/demo_check.mjs holds it).
The demo: its world, its ops and its steps
{
"world": "cube",
"ops": [],
"steps": 240
}
The events
The other way: the page tells the board. An sb-event on a board’s wrapper, while it plays, runs label on.<name> on every card that has one, after keeping the event’s name at event.name and its words at event.<word> (board.dispatchEvent(new CustomEvent("sb-event", {detail: {name, words}})); love-shared’s walker takes the same, fire). A button needs no script: data-sb-event, data-sb-words and data-sb-board send it. This card waits for one; the button under it sends ping with by=this-page.
on.ping · Play, then the button under the board · press Play
label openCard
say s2ar "Press Ping under this board, then go on."
branch pinged yes came waiting
label waiting
say s2ar "Nothing yet: press Ping, then go on."
goto openCard
label came
say s2ar "The ping came from $event.by: on.ping ran and kept pinged."
end
label on.ping
set pinged yes
Parsing in the page
board_rt/script.js parses a card’s script in the browser: a port of the build’s parser (star-web/src/board_script.rs), held to the build’s own cases (tests/board_rt/parse_cases.json, minted from the Rust) and to the Lua’s (starboard/tests/stepper_cases.json) by tests/board_rt/script.test.mjs. On an editable board the editor parses as you type: Play runs the new script the next time it enters the card, and a line the grammar refuses shows the Lua’s words under the script. Rewrite this card’s line and play it.
rewrite me · Edit, double-click the card, change its script, Done, then · press Play
say s2ar "Rewrite this line, then Play: it runs as you typed it."
end
VERBS
VERBS
The verbs (dialogue_parser.lua’s VALID_VERBS), each with the line the graph’s palette inserts and what it does. board: false: the board’s stepper steps over it (an app’s verb).
TELLS
TELLS
The tells a page answers (the home’s and the reference’s; StarScript’s reference has the words): set tell.<to>.
tokenise
tokenise(line)
dialogue_parser.lua’s M.tokenise, as board_script.rs ports it.
parse
parse(source)
A card’s script as dialogue_parser.lua’s M.parse makes it: {ok, prog}, or {ok: false, err} in the Lua’s words.
// with `parse` from board_rt/script.js and `Stepper` from board_rt/stepper.js
const r = parse('say s2ar "Hello"\nchoice next "Go on"\nend\nlabel next\nend\n');
return { ok: r.ok, kinds: r.prog.commands.map((c) => c.kind), labels: r.prog.labels };
Gives, held by tests/board_rt/examples.test.mjs:
{
"ok": true,
"kinds": [
"say",
"choice",
"end",
"label",
"end"
],
"labels": {
"next": 4
}
}
The work on this page: the commits of the last 30 days on its sources, the work open against them, its checks
starlens 74b1736reference: a hand page's code fences written from their sources, and the one that had drifted (2026-11-09)
starlens 2f38fddsite: X6, the graph pane in the reference and the StarScript page, held by the apps e2e (2026-11-06)starlens bf0100fsite: the StarScript bench in StarBoard on the web and in the reference, held by the apps e2e (2026-11-06)starlens df192e8site: the StarScript reference follows the night's grammar: when … gt|lt, choice … set:, the on.<event> hook and the event bridge, each with a board that runs it; the verb sheets as the merged registries write them (2026-11-06)love-shared 467a8bdStarScript steps 3 and 4, landed here first: numeric compare (when gt|lt) and on.<event> handlersstarlens 506fbcesite: StarBoard on the web starts on the desk's StarScript starter (a choice that keeps values, a branch, a tell the status line shows); the StarScript page says what the M2's stepper does now (the M2's handoff, 2026-11-06)rust-shared 9f1fa70star-web board runtime: the stepper follows the M2's two new cases: a choice's set:k=v pairs written on its pick, and every tell kept in order (the M2's handoff, 2026-11-06)
rust-shared 0e28e98star-web board runtime: script.js, StarScript parsed in the browser, so an edited card runs without a rebuild; the parse cases minted from the Rust (X1 of the visual language, 2026-11-05)starlens 5c540afsite: the tutorial's board mounts once the landing is under way as well as near (the observer fired on a phone at the top: 70 KB on every first visit) (2026-11-05)starlens 2b9b6ccsite: the acts' strip centres its tab by its own scrollLeft (scrollIntoView scrolled the page 784 px to the strip on load: the home landed itself and the tutorial's board loaded on the first visit); views.mjs opens every page through about:blank (a same-URL open is a reload and restores the scroll), records the band's and the tutorial's place and mount, and --only matches a page by any of its states (2026-11-05)starlens 596e518site: the views harness (every page at phone, tablet and desktop size as a sheet and a gate) and the console on a phone: the acts a strip, the console a sheet with the 5x7 status line, the density pass (2026-11-05)
starlens 16349e5site: the world's core and the scene switch (L2 of the three-landings program): moon.js becomes world.js + glsl.js + scenes/moon.js, chosen by [hero] scenestarlens e0fb396site: the landing is "Land", and one number drives the camera, the card's dissolve and the UI's arrivalstarlens 56e4e35site: the icy moon home: the world behind the home drawn in the page by one shader, the engine behind a door, the basin toy on the stagestarlens e53348asite: the descent from orbit on the engine, ready for its data: the live camera over the whole runway, the recording made by the engine (2026-11-04, the tower; P2 of the planet home)
starlens 114037asite: take the world: the session on the crater as a tape cart, downloaded from the home; the engine 2d8c18efa6b7 (2026-11-03, the tower; H4 of the planet home)starlens 6a6b441site: the landing as a tutorial: a StarScript stack beside the tools at the crater, the tell bridge routed, the doors to the docs (2026-11-03, the tower; H3 of the planet home)starlens b8cbb7dsite: the home on the engine: the crater behind the descent, the acts strike it, the gates (2026-11-03, the tower; H2 of the planet home)
starlens 62c982csite: the home on design B, the world behind the whole page (2026-11-03, the tower)starlens 0727a40site: the demo-first drafts, the revision: a toy rests while unseen, a framed toy's links leave the frame, the drafts' own anchors (2026-11-02, the tower)starlens f5c8816site: the two demo-first drafts, /next/a/ the world as the page and /next/b/ one stage, six acts (the demo-first home, stage 2; 2026-11-02, the tower)
starlens bed6159site: the interactive landing, the revision: the frame fits the toy, the toys' keys and a phone's width (2026-10-31, the tower)starlens a280cafsite: the interactive landing, stage 1: the toys' frame, Try it on a tool card, the desk's toy (2026-10-31, the tower)starlens 44acd47site: the platform pages on the apps' look (the s2ar site redesign, stage 1; 2026-10-31, the tower)
The work record as of , from the fold on tower.
Nothing open against these sources.
- FAIL
lint/web-reference - PASS
node/board-stepper
Generated by tools/reference_pages.py from love-shared/dialogue_parser.lua, media/house/house.js, content/developers/starscript.md, star-web/src/board_rt/script.js, star-web/tests/board_rt/examples.json; the twin bfaad079a7ce (434093 bytes). The words are a draft.