StarScript: the verbs and the tells

this page as plaintext

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).

Skip the board

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.

Skip the board

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).

Skip the board

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.

Skip the board

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.

Skip the board

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.

Skip the board

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.

Skip the board

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)

Skip the board

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 )*

Skip the board

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 “”)

Skip the board

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 “”)

Skip the board

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>)

Skip the board

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.

Skip the board

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
the board beside it tells the world: meteor, comet, flashshows tell.world

Rests 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.

Skip the board

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.

Skip the board

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).

rust-shared/star-web/src/board_rt/script.js:23

TELLS

TELLS

The tells a page answers (the home’s and the reference’s; StarScript’s reference has the words): set tell.<to>.

rust-shared/star-web/src/board_rt/script.js:42

tokenise

tokenise(line)

dialogue_parser.lua’s M.tokenise, as board_script.rs ports it.

rust-shared/star-web/src/board_rt/script.js:60

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
 }
}

rust-shared/star-web/src/board_rt/script.js:116

The work on this page: the commits of the last 30 days on its sources, the work open against them, its checks

  • starlens 74b1736 reference: a hand page's code fences written from their sources, and the one that had drifted (2026-11-09)

  • starlens 2f38fdd site: X6, the graph pane in the reference and the StarScript page, held by the apps e2e (2026-11-06)
  • starlens bf0100f site: the StarScript bench in StarBoard on the web and in the reference, held by the apps e2e (2026-11-06)
  • starlens df192e8 site: 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 467a8bd StarScript steps 3 and 4, landed here first: numeric compare (when gt|lt) and on.<event> handlers launcher/starscript-steps-3-and-4-landed-on-the-m2-first-numeric-compare-when-gtlt-one-predicate-for-every-runner-and-onevent-handlers-fire-onpin-ontell-boardfire
  • starlens 506fbce site: 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 9f1fa70 star-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 0e28e98 star-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 5c540af site: 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 2b9b6cc site: 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 596e518 site: 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 16349e5 site: 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] scene
  • starlens e0fb396 site: the landing is "Land", and one number drives the camera, the card's dissolve and the UI's arrival
  • starlens 56e4e35 site: 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 stage
  • starlens e53348a site: 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 114037a site: 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 6a6b441 site: 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 b8cbb7d site: 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 62c982c site: the home on design B, the world behind the whole page (2026-11-03, the tower)
  • starlens 0727a40 site: 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 f5c8816 site: 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 bed6159 site: the interactive landing, the revision: the frame fits the toy, the toys' keys and a phone's width (2026-10-31, the tower)
  • starlens a280caf site: the interactive landing, stage 1: the toys' frame, Try it on a tool card, the desk's toy (2026-10-31, the tower)
  • starlens 44acd47 site: 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.

  • FAILlint/web-reference 12 Nov on tower
  • PASSnode/board-stepper 6 Nov on tower

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.