Head and Tail are how many characters Addr and Short keep on each side.

A gno.land address is 40 characters ("g1" plus 38 of bech32 data), so 8+1+4 renders it as g1manfre…dlf5: enough of the head to recognise a familiar account, enough of the tail to tell two similar ones apart.

Ellipsis is the character placed between the kept head and tail of a shortened string.

Action renders a clickable call to a function of the current realm.

1ui.Action("Play cell 4", "Move", "gameID", "7", "cell", "4")

Arguments are key/value pairs, as in p/moul/txlink. The title is escaped, which is the one thing helplink.Func does not do.

ActionIn is Action against another realm, given as the full package path that realm declares on the module line of its gnomod.toml.

This doc deliberately contains no example path, not even a placeholder one. gnopm scans doc comments the way it scans imports, so any package path spelled out in a comment becomes a dependency of the package holding it: one that is neither live nor in the workspace BLOCKS publishing this package and everything that imports it, and naming a live one is no better, since it drags an unrelated realm into every publish plan. This comment previously named a path that deversioning had already removed, which blocked the whole ui dependency tree on every chain.

Addr renders an address shortened and in backticks: `g1manfre…dlf5`.

This is the default way to show an address. It is monospace (an address is opaque data, not prose), and the backticks make it inert markdown, so it is safe in a table cell or anywhere else without further escaping.

AddrFull renders an address in full, in backticks. Use it where the reader needs to copy the value; use Addr everywhere else.

AddrOf is Addr for an address already in its string form, which is how realms hold one when it is an avl key or a stored field.

AddrText renders an address shortened, with no backticks. Use it inside a link title or another construct where backticks would not render.

Cell escapes user-supplied text for a markdown table cell: Inline plus tab and pipe handling, so the value cannot open a new column.

Empty renders the placeholder shown where a list would be: an italic line, newline-terminated, so it drops into a Render body as-is.

1ui.Empty("No games yet.")  // "_No games yet._\n"

The message is realm chrome, not user input, and is not escaped.

Excerpt is Inline for a string too long to show whole: it keeps the first width runes, appends Ellipsis, and escapes what it kept.

Use it for a preview of user-written prose where only the beginning carries meaning: the first line of a post in an index, a note on a board, a comment in a list. For an identifier whose tail has to stay recognisable, an address, a hash, a URL, use Short instead, which keeps both ends.

The order is the whole point, and it is what a call site gets wrong. Escaping inserts backslashes, so cutting an ALREADY-escaped string can strand a trailing lone backslash that escapes whatever chrome follows it. Excerpt cuts first, on a rune boundary so a multi-byte character is never split, then escapes. Ellipsis stays outside the escaper: it is this package's chrome, not the user's text.

Inline escapes user-supplied text for an inline markdown context: a sentence, a list item, a link title.

It delegates to sanitize.InlineText, which strips bidi and zero-width characters, folds newlines to spaces so the text cannot escape its line, and applies the full CommonMark inline escape. Never concatenate user-supplied text into rendered output without this.

Join concatenates parts, skipping empty ones, with sep between them. It is the small piece of glue every Render needs to assemble optional sections without emitting stray separators.

Podium returns the medal for a zero-based rank, or "" past third place.

Short shortens any string with the house rule: unchanged when shortening would not save a character, otherwise head + ellipsis + tail.

It is the same rule Addr uses, exposed for the non-address strings realms also truncate: URLs, handles, commitment hashes.

ShortN is Short with an explicit head and tail. A negative head or tail is treated as zero. When head+tail cannot save a character against the input, the input is returned unchanged.

NewTable starts a table with the given header cells.

Table accumulates markdown table rows and renders them.

Cells are markdown, not plain text: pass Addr and friends straight through, and wrap anything user-supplied in Cell first.

Table renders the GFM table itself rather than delegating to p/moul/mdtable(/p/moul/mdtable/v0), which unconditionally rewrites "|" to "|" in every cell. Stacked on Cell, which already emits the GFM escape "\|", that double-escapes into a stray backslash ("a\|b"). One escaping stage is the only way to get this right, and it has to be the one that knows whether the text is user input.

1t := ui.NewTable("#", "X", "O", "Status")
2t.Row("7", ui.Addr(x), ui.Addr(o), "Turn: X")
3return t.String()