The menu asks "What would you like to do?" and its five sections each name a doing. "What is this thing, and who made it" is not one, and had nowhere to go — so it gets the sixth section, the one that names a subject, sorted last where a reader who has run out of things to do finds it. Three pages, in the order a stranger asks: About MeshTerm what this is, where it came from, its terms About the author the person behind it, on the mesh and off it Support this project what keeps it going, and the ways to help Every page is scaffolding: the headings are the settled part, and each section carries one lowercase muted "placeholder — …" line where its prose will go. That is the app's own empty-state voice, so an unwritten page reads as deliberately unwritten rather than as a screen that failed to load, and filling one in means replacing its placeholder — the screen, the menu rows and the CLI faces all follow unchanged. What is not a placeholder is the version, the author and the copyright span: they come from the package itself, so the About page can never describe a build it isn't running inside. The pages act on nothing — no radio, no database, no device — so each opens straight to its screen with no prompt first, and each keeps a CLI face (meshterm about / about-author / support) printing the same page to a shell. Two new icons, both funnelled for the console: 📖 read/about becomes ¶, the page-of-prose mark, and 💰 support/donate becomes $. ScrollScreen earns a derived footer hint on the way through. A read-only body has only two keys to name, the pager and Esc, so passing "↑↓ PgUp/ PgDn scroll · Esc close" at every call site was both repetition and a lie on a body that fits — the standing rule is that a footer never advertises a key that would do nothing. Left unset, it now names the pager only while the content actually overflows, and takes its Esc verb from the surface: a floating view closes, a full screen goes back. Every existing caller passes its hint explicitly and is untouched. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
155 lines
6.5 KiB
Python
155 lines
6.5 KiB
Python
"""The visual-language specimen: every mark, icon, colour and fold on one screen.
|
|
|
|
``meshterm specimen`` prints this through the platform's real machinery — the active
|
|
theme, the ``glyph()`` icon funnel, the render-boundary fold, the heat and SNR scales —
|
|
so what it shows *is* what the platform draws, not a mock-up of it. On the PicoCalc
|
|
console it doubles as the font/palette acceptance card (all nine P3 marks, the node
|
|
glyphs, braille, the 16 programmed slots); on a desktop terminal it shows the same
|
|
content in the regular platform's emoji-and-truecolor dress. Sized to the PicoCalc
|
|
floor: every line ≤ 53 cells, the whole card ≤ 24 rows.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from rich.console import RenderableType
|
|
from rich.text import Text
|
|
|
|
from ..platforms import get_platform
|
|
from .packet_viewer import KIND_ICONS, PAYLOAD_ICONS
|
|
from .theme import _VT_SLOTS, fold_text, glyph, name_style, snr_style
|
|
from .tui.fkeys import FPair, lane_text
|
|
from .widgets import _recency_style, channel_glyph
|
|
|
|
#: Demo identities for the name-colour row: ``(name, key)``. The keys are synthetic, and
|
|
#: chosen so their first bytes land in three different sectors of the hue wheel — on the
|
|
#: console that means three different palette slots (see ``theme._NODE_SLOT_HEXES``).
|
|
_DEMO_NAMES = (("Alice", "a1b2"), ("YUL-Poly", "3d63"), ("Lounge", "cc10"))
|
|
|
|
|
|
def _palette_row() -> Text:
|
|
"""The 16 slots as filled blocks, dim bank then bright bank.
|
|
|
|
On PicoCalc the blocks address the console's real slots (``color(N)``), so the row
|
|
shows exactly what ``setvtrgb`` programmed; on the regular platform they carry the
|
|
design's RGB values instead — a preview of the same palette in truecolor.
|
|
"""
|
|
row = Text()
|
|
for slot, _, hex_ in _VT_SLOTS:
|
|
style = f"color({slot})" if not get_platform().truecolor else hex_
|
|
row.append("██", style=style)
|
|
return row
|
|
|
|
|
|
def _ages_row() -> Text:
|
|
"""The heat scale over its own anchors — one age just inside each of the seven steps."""
|
|
row = Text()
|
|
anchors = (
|
|
("now", 0), ("20m", 1200), ("3h", 10800), ("2d", 172800),
|
|
("2w", 1209600), ("3mo", 7776000), ("never", None),
|
|
)
|
|
for label, secs in anchors:
|
|
if row.plain:
|
|
row.append(" ")
|
|
row.append(label, style=_recency_style(secs))
|
|
return row
|
|
|
|
|
|
def specimen_lines() -> list[RenderableType]:
|
|
"""The specimen card, one renderable per line (print through the themed console)."""
|
|
platform = get_platform()
|
|
lines: list[RenderableType] = []
|
|
lines.append(Text.assemble(("Specimen", "accent"), (" · ", "muted"), platform.name))
|
|
lines.append(Text())
|
|
lines.append(_palette_row())
|
|
legend = Text("stock palette · 8 muted · 9-14 node hues · 15 you", style="muted")
|
|
lines.append(legend)
|
|
lines.append(Text())
|
|
|
|
status = Text("status ")
|
|
for mark, style in (("✓", "ok"), ("✗", "err"), ("⚠", "warn"), ("●", "err"), ("○", "muted")):
|
|
status.append(mark + " ", style=style)
|
|
lines.append(status)
|
|
|
|
# The node-type marks in the theme's own ``type.*`` entries — the same styles every
|
|
# typed node in the app is drawn in (ui.widgets._NODE_GLYPHS), so this row *is* the
|
|
# marker language rather than a restatement of it. The star and the unknown ring have
|
|
# no type of their own: they take the ``you`` white and ``muted`` grey they carry
|
|
# everywhere else.
|
|
nodes = Text("nodes ")
|
|
nodes.append("★ ", style="you")
|
|
for mark, style in (
|
|
("● ", "type.node"), ("▲ ", "type.repeater"), ("■ ", "type.room"),
|
|
("◉ ", "type.sensor"), ("○", "muted"),
|
|
):
|
|
nodes.append(mark, style=style)
|
|
lines.append(nodes)
|
|
|
|
classes = Text("classes ")
|
|
for icon in KIND_ICONS.values():
|
|
classes.append(glyph(icon) + " ", style="brand")
|
|
classes.append(" payloads ", style="muted")
|
|
for typename in ("REQ", "RESPONSE", "TEXT_MSG", "GRP_TXT", "GRP_DATA", "ANON_REQ"):
|
|
classes.append(glyph(PAYLOAD_ICONS[typename]) + " ")
|
|
for typename in ("PATH", "TRACE", "MULTIPART", "CONTROL"):
|
|
classes.append(glyph(PAYLOAD_ICONS[typename]) + " ")
|
|
lines.append(classes)
|
|
|
|
channels = Text("channels ")
|
|
channels.append(channel_glyph("#public", None) + " name-derived ", style="brand")
|
|
channels.append(glyph("🌐") + " public ")
|
|
channels.append(glyph("🔒") + " private")
|
|
lines.append(channels)
|
|
|
|
concepts = Text("concepts ")
|
|
for icon in ("📡", "🕒", "🔄", "💾", "📂", "🔑", "🗑", "✎", "⚡", "⭐", "📤", "📨"):
|
|
concepts.append(glyph(icon) + " ")
|
|
for icon in ("🔔", "🔕", "📱", "🔗", "🏆", "⌨", "📖", "💰"):
|
|
concepts.append(glyph(icon) + " ")
|
|
lines.append(concepts)
|
|
|
|
lines.append(Text("keys ⌫ ⇧ … ↕ ↔ ↻ ⌖ ❯ ▸"))
|
|
lines.append(Text())
|
|
|
|
names = Text("names ")
|
|
for name, key in _DEMO_NAMES:
|
|
names.append(name + " ", style=name_style(name, key))
|
|
names.append("me", style="you")
|
|
lines.append(names)
|
|
|
|
lines.append(Text("heard ").append_text(_ages_row()))
|
|
|
|
snr = Text("snr ")
|
|
for reading in (8.0, -2.0, -12.0):
|
|
snr.append(f"{reading:+.1f} ", style=snr_style(reading))
|
|
lines.append(snr)
|
|
|
|
# What the render boundary makes of stored text: accents fold on PicoCalc (the raw
|
|
# form would be tofu there — the console font has no accented Latin), Cyrillic is
|
|
# font-native and passes through on both platforms.
|
|
folded = fold_text("café Montréal")
|
|
lines.append(Text.assemble("text ", (folded, "brand"), (" · ", "muted"), "привет мир"))
|
|
lines.append(Text())
|
|
|
|
chart = Text("chart ")
|
|
chart.append("⡀⡄⡆⣆⣦⣶⣷⣿", style="snr.good")
|
|
chart.append("⣶⣤⣀", style="snr.ok")
|
|
chart.append("⡀⠄⠂", style="snr.bad")
|
|
chart.append(" braille", style="muted")
|
|
lines.append(chart)
|
|
|
|
# The F-key lane, on the one platform that draws it: both fills, plus a dim slot and
|
|
# an unassigned one, so the card shows every state a chip can be in. Built through
|
|
# lane_text itself — this is the acceptance screen, so it must be the real renderer.
|
|
if platform.footer_fkeys:
|
|
lane = (
|
|
FPair("Region", "home"),
|
|
FPair("You", "locate", enabled=False),
|
|
None,
|
|
FPair("Page ↓", "pagedown", "Bottom", "end"),
|
|
FPair("Page ↑", "pageup", "Top", "home"),
|
|
)
|
|
lines.append(Text())
|
|
lines.append(lane_text(lane))
|
|
lines.append(lane_text(lane, shifted=True))
|
|
return lines
|