The landing's words jump to their recordings, the casts open on their telling frame, and #mode-box draws the box

Each recording on the landing has an anchor (rec-<name>); the "What's
in it" words jump to theirs (Terminals, PDFs, Images, Diff review,
Scripting) and the recording's caption ends in a link to the docs;
Language servers and Themes, with no recording, link to the docs. A
cast's `poster_at` in casts.toml picks the frame it shows until it
plays: live-text at the error, terminals at the copied line, petscii on
the Mandelbrot; the casts wait for the in-view script to play them. A
caption may hold markup: the 9P clip links 9ns to setup. The downloads
give their size, read from project.download, and the footer links the
changes (project.changes).

The guide's annotated pane has alt text, pin 1 beside the workspace tag
rather than on Changelog, and pin 5 on the body's text; pin positions
are written with repr, since str puts a U+2212 minus CSS cannot read.
#mode-box(mark, unsaved:) draws a pane's box as it looks, in print and
HTML.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 11 insertions, 1 deletions

diff --git a/docs/typ/README b/docs/typ/README
index 5db2cf76..9d3913c0 100644
--- a/docs/typ/README
+++ b/docs/typ/README
@@ -35,7 +35,7 @@ Build (from the repo root):
 The contract for content files
 ------------------------------
 Start a content file with
-  #import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, fstree
+  #import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, fstree, annotated, mode-box
 (a content file does not import page setup; the same file goes into the
 book, the HTML and, for the cheatsheet, the A4 page)
 and use plain markup (= headings, - lists, `raw`, *strong*) plus these.
@@ -82,6 +82,16 @@ new function instead.
                    pane/
                      new     open: a new pane    @panes
                    ```)
+  annotated(src, size, alt:, ..pins)
+                   a screenshot with numbered pins, their labels as text
+                   beside it. src from the repository root, size in
+                   pixels, each pin ([label], x, y) in its pixels.
+                   #annotated("/docs/site/media/themes/orchard.png", (640, 513),
+                     alt: "a pardes window", ([the box], 8, 58))
+  mode-box(mark, unsaved:)
+                   a pane's box as it looks: " " normal, "^" insert,
+                   "$" raw; unsaved: true fills it.
+                   #mode-box("^")   #mode-box(" ", unsaved: true)
   theme-gallery()  every theme as a picture, on the site's Themes page;
                    nothing on paper.
   pairs(split:, ..cells)