@mnmal-ai/surface-core 0.15.0 → 0.17.0

package/dist/index.js

@@ -1,8 +1,9 @@
-import { $ as maskDraft, A as completeDraft, B as EMPTY_HISTORY, C as reprintStart, D as MENU_NAME_WIDTH, E as unavailableReason, F as paletteQuery, G as walk, H as mayWalk, I as paletteRows, J as EMPTY_DRAFT, K as CTRL_C_WINDOW_MS, L as parseCommandLine, M as menuWindow, N as moveSelection, O as clampSelection, P as paletteMatches, Q as insertChunk, R as keySpecOf, S as reflowSequence, T as routeInput, U as remember, V as HISTORY_MAX, W as settle, X as editKey, Y as atEnd, Z as graphemeAt, _ as anchorPadding, a as answerEntry, at as RESERVED_GLOBAL_KEYS, b as prepareSequence, c as dropGaps, ct as normaliseKeySpec, d as markedFlights, et as pasteToLine, f as sendTurn, g as RESET_GROUND, h as REPRINT_LINES, i as addGap, it as CompositionError, j as enterRuns, k as commandUsage, l as emptyTranscript, lt as applySuggestion, m as DEFAULT_GROUND, n as setPanel, nt as wordRight, o as arriveTurn, ot as assertComposes, p as CLEAR_PANE, q as ctrlC, r as defineModule, rt as applyInput, s as commitEntry, st as composeModules, t as panelOf, tt as wordLeft, u as heldAsks, ut as mergeCompletions, v as groundSequence, w as sanitise, x as prepareTerminal, y as liveShrink, z as resolveKey } from "./overlay-DMjCbsaC.js";
-import { spinnerFrame } from "@mnmal-ai/surface-kit";
+import { $ as parseCommandLine, A as RESET_GROUND, At as normaliseKeySpec, B as sanitise, C as emptyTranscript, Ct as wordLeft, D as CLEAR_PANE, Dt as RESERVED_GLOBAL_KEYS, E as sendTurn, Et as CompositionError, F as liveShrink, G as commandUsage, H as unavailableReason, I as prepareSequence, J as menuWindow, K as completeDraft, L as prepareTerminal, M as WHEEL_ARROWS_ON, Mt as mergeCompletions, N as anchorPadding, O as DEFAULT_GROUND, Ot as assertComposes, P as groundSequence, Q as paletteRows, R as reflowSequence, S as dropGaps, St as pasteToLine, T as markedFlights, Tt as applyInput, U as MENU_NAME_WIDTH, V as routeInput, W as clampSelection, X as paletteMatches, Y as moveSelection, Z as paletteQuery, _ as visibleRows, _t as atEnd, a as backspace, at as remember, b as arriveTurn, bt as insertChunk, c as listStep, ct as FOLLOWING, d as placement, dt as resolveFullscreen, et as keySpecOf, f as push, ft as scrollBy, g as typeChar, gt as EMPTY_DRAFT, h as turn, ht as ctrlC, i as back, it as mayWalk, j as WHEEL_ARROWS_OFF, jt as applySuggestion, k as REPRINT_LINES, kt as composeModules, l as move, lt as linesBelow, m as startFilter, mt as CTRL_C_WINDOW_MS, n as setPanel, nt as EMPTY_HISTORY, o as cursorRow, ot as settle, p as scrollDetail, pt as viewTop, q as enterRuns, r as defineModule, rt as HISTORY_MAX, s as endFilter, st as walk, t as panelOf, tt as resolveKey, u as pagerAt, ut as pageStep, v as addGap, vt as editKey, w as heldAsks, wt as wordRight, x as commitEntry, xt as maskDraft, y as answerEntry, yt as graphemeAt, z as reprintStart } from "./overlay-5s8slC38.js";
+import { ListRows, spinnerFrame } from "@mnmal-ai/surface-kit";
 import { Box, Static, Text, measureElement, render, useApp, useInput, usePaste, useStdout } from "ink";
 import { Component, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { listLines, wrapCells } from "@mnmal-ai/surface-kit/list";
 
 //#region src/app.tsx
 /** Calls a module's view as a component, so a throw lands in the boundary and not in the shell. */
@@ -71,6 +72,15 @@ const OVERLAY_PAD_Y = 1;
 *  not scanned; both come out of the size the panel view is handed (operator, 2026-10-09). */
 const PANEL_PAD_X = 4;
 const PANEL_PAD_Y = 1;
+/** What a panel view may draw in: its insets, its own or the default, come out of the outer size. */
+function panelInner(outer, def) {
+	const x = def?.inset?.x ?? PANEL_PAD_X;
+	const y = def?.inset?.y ?? PANEL_PAD_Y;
+	return {
+		columns: Math.max(1, outer.columns - 2 * x),
+		rows: Math.max(1, outer.rows - 2 * y)
+	};
+}
 /**
 * The `/` palette and the completion menu, directly above the input on the band's ground: a fixed name column, the detail dimmed, the selection on the `selection` tone, a window
 * that follows the selection, and a hint line.
@@ -117,11 +127,12 @@ function defaultPanelRows(terminalRows, opts) {
 	return Math.max(3, terminalRows - SHELL_ROWS - (opts?.band === true ? BAND_ROWS : 0));
 }
 /** What `run()` prepares the terminal with, or `null` when the host has prepared it already. */
-function runTerminalOptions(opts) {
+function runTerminalOptions(opts, fullscreen) {
 	if (opts.terminal === false) return null;
 	return {
 		anchor: opts.anchored === true,
-		...opts.terminal
+		...opts.terminal,
+		...fullscreen ? { fullscreen } : {}
 	};
 }
 function createApp(opts) {
@@ -140,9 +151,13 @@ function createApp(opts) {
 	const presenceModule = registry.presence?.module ?? "";
 	const panelRows = opts.panelRows ?? ((r) => defaultPanelRows(r, { band }));
 	const anchored = opts.anchored === true;
+	const fs = resolveFullscreen(opts.fullscreen, process.env.SURFACE_FULLSCREEN);
 	function App({ columns, rows }) {
 		const { exit } = useApp();
-		const stdout = useStdout().stdout;
+		const ink = useStdout();
+		const stdout = ink.stdout;
+		const full = fs.on && stdout.isTTY === true;
+		const relays = anchored && !full;
 		const [term, setTerm] = useState(() => ({
 			columns: stdout.columns ?? 120,
 			rows: stdout.rows ?? 30
@@ -157,12 +172,16 @@ function createApp(opts) {
 		const heights = useRef(/* @__PURE__ */ new Map());
 		const [reprintFrom, setReprintFrom] = useState(0);
 		const relayout = useCallback(() => {
-			if (stdout.isTTY) stdout.write(reflowSequence(stdout.rows));
+			if (stdout.isTTY) ink.write(reflowSequence(stdout.rows));
 			putTranscript(dropGaps);
 			const kept = transcriptRef.current.committed;
 			setReprintFrom(reprintStart(kept.map((e) => heights.current.get(e.key) ?? 1), REPRINT_LINES));
 			setEpoch((e) => e + 1);
-		}, [stdout, putTranscript]);
+		}, [
+			stdout,
+			ink,
+			putTranscript
+		]);
 		useEffect(() => {
 			const laidOut = {
 				columns: stdout.columns ?? 120,
@@ -174,7 +193,7 @@ function createApp(opts) {
 					columns: stdout.columns ?? 120,
 					rows: stdout.rows ?? 30
 				});
-				if (!anchored) return;
+				if (!relays) return;
 				clearTimeout(timer);
 				timer = setTimeout(() => {
 					const now = {
@@ -193,7 +212,11 @@ function createApp(opts) {
 				clearTimeout(timer);
 				stdout.off("resize", onResize);
 			};
-		}, [stdout, relayout]);
+		}, [
+			stdout,
+			relayout,
+			relays
+		]);
 		const width = Math.max(1, (columns ?? term.columns) - 2 * gutter);
 		const height = rows ?? term.rows;
 		const showRail = registry.rail.length > 0 && width >= railMin;
@@ -201,12 +224,8 @@ function createApp(opts) {
 			columns: Math.max(1, width - (showRail ? RAIL_COLUMNS : 0)),
 			rows: Math.max(1, panelRows(height))
 		};
-		const panelSize = {
-			columns: Math.max(1, panelOuter.columns - 8),
-			rows: Math.max(1, panelOuter.rows - 2)
-		};
-		const sizeRef = useRef(panelSize);
-		sizeRef.current = panelSize;
+		const outerRef = useRef(panelOuter);
+		outerRef.current = panelOuter;
 		const [live, setLive] = useState(/* @__PURE__ */ new Map());
 		const [draft, setDraft] = useState(EMPTY_DRAFT);
 		const [, setHistory] = useState(EMPTY_HISTORY);
@@ -238,6 +257,12 @@ function createApp(opts) {
 			armedRef.current = a;
 			setArmed(a);
 		}, []);
+		const [scroll, setScroll] = useState(FOLLOWING);
+		const scrollRef = useRef(FOLLOWING);
+		const putScroll = useCallback((next) => {
+			scrollRef.current = next;
+			setScroll(next);
+		}, []);
 		const defOf = useCallback((o) => o ? registry.panels.get(`${o.module}/${o.panel}`)?.def : void 0, []);
 		const putHistory = useCallback((h) => {
 			historyRef.current = h;
@@ -327,7 +352,7 @@ function createApp(opts) {
 		const ctxFor = useCallback((moduleId) => ({
 			theme,
 			signal: appAbort.current.signal,
-			size: () => sizeRef.current,
+			size: () => panelInner(outerRef.current, defOf(overlayRef.current)),
 			open: (panel, state, opts) => {
 				if (disposed.current) return;
 				if (!registry.panels.has(`${moduleId}/${panel}`)) throw new Error(`module '${moduleId}' has no panel '${panel}'`);
@@ -338,6 +363,7 @@ function createApp(opts) {
 					state
 				});
 			},
+			panelOpen: () => overlayRef.current !== null,
 			update: (panel, fn) => {
 				if (disposed.current) return;
 				const o = overlayRef.current;
@@ -386,7 +412,8 @@ function createApp(opts) {
 			say,
 			guard,
 			putOverlay,
-			showToast
+			showToast,
+			defOf
 		]);
 		const runTurn = useCallback(async (line, module, handler, sent) => {
 			const id = nextId.current++;
@@ -438,6 +465,7 @@ function createApp(opts) {
 			}
 		}, [ctxFor, putTranscript]);
 		const handleLine = useCallback((line, sent) => {
+			putScroll(FOLLOWING);
 			const text = line.trim();
 			const open = overlayRef.current;
 			const owner = open ? registry.panels.get(`${open.module}/${open.panel}`)?.def : void 0;
@@ -472,13 +500,43 @@ function createApp(opts) {
 			putHistory,
 			runTurn,
 			guard,
-			putOverlay
+			putOverlay,
+			putScroll
 		]);
 		handleLineRef.current = handleLine;
+		const viewportRef = useRef(null);
+		const flightsRef = useRef(null);
+		const [measured, setMeasured] = useState({
+			content: 0,
+			viewport: 1
+		});
+		const measuredRef = useRef(measured);
+		const contentRows = useCallback(() => {
+			let rows = 0;
+			for (const e of transcriptRef.current.committed) rows += heights.current.get(e.key) ?? 1;
+			return rows + (flightsRef.current === null ? 0 : measureElement(flightsRef.current).height);
+		}, []);
+		const viewportRows = useCallback(() => viewportRef.current === null ? measuredRef.current.viewport : Math.max(1, measureElement(viewportRef.current).height), []);
+		useEffect(() => {
+			if (!full || viewportRef.current === null) return;
+			const now = {
+				content: contentRows(),
+				viewport: viewportRows()
+			};
+			const held = scrollRef.current.held;
+			if (held !== null && held >= Math.max(0, now.content - now.viewport)) putScroll(FOLLOWING);
+			const was = measuredRef.current;
+			if (now.content === was.content && now.viewport === was.viewport) return;
+			measuredRef.current = now;
+			setMeasured(now);
+		});
+		useEffect(() => {
+			if (fs.invalid !== null) print(`SURFACE_FULLSCREEN=${fs.invalid} ignored: use on or off`, "warn");
+		}, [print]);
 		const liveRef = useRef(null);
 		const lastLive = useRef(null);
 		useEffect(() => {
-			if (!anchored || liveRef.current === null) return;
+			if (!relays || liveRef.current === null) return;
 			const now = {
 				height: measureElement(liveRef.current).height,
 				committed: transcript.committed.filter((e) => e.kind !== "gap").length,
@@ -491,9 +549,13 @@ function createApp(opts) {
 		const panelOpen = overlay !== null || menu !== null;
 		const wasPanelOpen = useRef(panelOpen);
 		useEffect(() => {
-			if (anchored && wasPanelOpen.current && !panelOpen) relayout();
+			if (relays && wasPanelOpen.current && !panelOpen) relayout();
 			wasPanelOpen.current = panelOpen;
-		}, [panelOpen, relayout]);
+		}, [
+			panelOpen,
+			relayout,
+			relays
+		]);
 		const [pendingLine, setPendingLine] = useState(null);
 		useEffect(() => {
 			if (pendingLine === null) return;
@@ -501,7 +563,7 @@ function createApp(opts) {
 			handleLine(pendingLine);
 		}, [pendingLine, handleLine]);
 		const sendAfterClose = (line) => {
-			if (anchored) setPendingLine(line);
+			if (relays) setPendingLine(line);
 			else handleLine(line);
 		};
 		const putDraft = useCallback((d) => {
@@ -580,7 +642,8 @@ function createApp(opts) {
 				} : null,
 				menu: menu?.kind ?? null,
 				draftEmpty: draft.text === "",
-				armed: armedOn !== null && overlay?.module === armedOn.module && overlay.panel === armedOn.panel && draft.text === armedOn.key ? armedOn.key : null
+				armed: armedOn !== null && overlay?.module === armedOn.module && overlay.panel === armedOn.panel && draft.text === armedOn.key ? armedOn.key : null,
+				...full ? { viewport: scrollRef.current.held === null ? "following" : "held" } : {}
 			};
 			const route = resolveKey(state, key, registry);
 			switch (route.kind) {
@@ -640,12 +703,16 @@ function createApp(opts) {
 					}
 					return;
 				}
-				case "panel": {
-					const handler = (registry.panels.get(`${route.module}/${route.panel}`)?.def)?.on?.[route.act];
-					if (!handler || !overlay) return;
+				case "panel":
+				case "panel-text": {
+					const def = registry.panels.get(`${route.module}/${route.panel}`)?.def;
+					const act = route.kind === "panel" ? def?.on?.[route.act] : void 0;
+					const typed = route.kind === "panel-text" ? def?.text : void 0;
+					if (!act && !typed || !overlay) return;
 					let next;
 					try {
-						next = handler(overlay.state, ctxFor(route.module));
+						const c = ctxFor(route.module);
+						next = act ? act(overlay.state, c) : typed?.(overlay.state, route.text, c);
 					} catch (err) {
 						guard(route.module, () => {
 							throw err;
@@ -731,6 +798,13 @@ function createApp(opts) {
 					putDraft(atEnd(step.text));
 					return;
 				}
+				case "scroll": {
+					const content = contentRows();
+					const viewport = viewportRows();
+					const step = route.act === "page-up" ? -pageStep(viewport) : pageStep(viewport);
+					putScroll(route.act === "bottom" ? FOLLOWING : scrollBy(scrollRef.current, step, content, viewport));
+					return;
+				}
 				case "submit": {
 					putArmed(null);
 					const line = draft.text;
@@ -941,6 +1015,230 @@ function createApp(opts) {
 			text: `… ${reprintFrom} earlier ${reprintFrom === 1 ? "entry" : "entries"} not reprinted`,
 			tone: "dim"
 		}, ...transcript.committed.slice(reprintFrom)];
+		const flightRows = /* @__PURE__ */ jsxs(Fragment, { children: [markedFlights(transcript).map((f) => /* @__PURE__ */ jsx(Box, { children: waiting(f, false) }, `marked:${f.id}`)), heldAsks(transcript).map((f) => /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			children: [askView ? /* @__PURE__ */ jsx(Safe, {
+				module: "app",
+				theme,
+				render: () => askView({
+					entry: f,
+					held: true,
+					theme,
+					size: { columns: width }
+				})
+			}) : /* @__PURE__ */ jsxs(Text, {
+				color: theme.color.accent,
+				children: [
+					theme.glyph.prompt,
+					" ",
+					sanitise(f.question)
+				]
+			}), waiting(f, true)]
+		}, f.id))] });
+		const overlayRows = /* @__PURE__ */ jsxs(Fragment, { children: [
+			panel && overlay ? /* @__PURE__ */ jsx(Box, {
+				backgroundColor: panel.ground ?? theme.color.raised,
+				paddingX: panel.inset?.x ?? PANEL_PAD_X,
+				paddingY: panel.inset?.y ?? PANEL_PAD_Y,
+				flexDirection: "column",
+				children: /* @__PURE__ */ jsx(Safe, {
+					module: overlay.module,
+					theme,
+					render: () => panel.view({
+						state: overlay.state,
+						theme,
+						size: panelInner(panelOuter, panel),
+						...armed !== null && armed.module === overlay.module && armed.panel === overlay.panel && draft.text === armed.key ? { armed: {
+							key: armed.key,
+							label: armed.label
+						} } : {}
+					})
+				}, `${overlay.module}/${overlay.panel}`)
+			}) : null,
+			menu?.kind === "palette" ? /* @__PURE__ */ jsx(MenuList, {
+				theme,
+				rows: paletteItems.map((c) => ({
+					key: c.name,
+					name: commandUsage(c),
+					detail: c.summary
+				})),
+				selected: menu.selected,
+				height: menuRows,
+				empty: `no command matches ${draft.text}`,
+				hint: "tab complete · enter run · esc close"
+			}) : null,
+			menu?.kind === "completion" ? /* @__PURE__ */ jsx(MenuList, {
+				theme,
+				rows: menu.items.map((s) => ({
+					key: s.insert,
+					name: s.label,
+					detail: s.detail ?? ""
+				})),
+				selected: menu.selected,
+				height: menuRows,
+				empty: "no completions",
+				hint: "tab complete · esc close"
+			}) : null
+		] });
+		const pinnedRows = /* @__PURE__ */ jsxs(Fragment, { children: [
+			band ? /* @__PURE__ */ jsxs(Box, {
+				borderStyle: "bold",
+				borderTop: false,
+				borderRight: false,
+				borderBottom: false,
+				borderColor: theme.color.edge,
+				backgroundColor: theme.color.surfaceAlt,
+				paddingX: 1,
+				paddingY: 1,
+				flexDirection: "column",
+				children: [/* @__PURE__ */ jsxs(Text, { children: [
+					shownDraft.text.slice(0, shownDraft.cursor),
+					under === "" ? /* @__PURE__ */ jsx(Text, {
+						color: theme.color.cursor,
+						children: "█"
+					}) : /* @__PURE__ */ jsx(Text, {
+						inverse: true,
+						children: under
+					}),
+					under === "" ? "" : shownDraft.text.slice(shownDraft.cursor + under.length)
+				] }), /* @__PURE__ */ jsxs(Box, {
+					marginTop: 1,
+					children: [
+						presence ? /* @__PURE__ */ jsx(Box, {
+							flexShrink: 0,
+							children: /* @__PURE__ */ jsxs(Text, {
+								bold: true,
+								children: [sanitise(presence.name), " "]
+							})
+						}) : null,
+						/* @__PURE__ */ jsx(Box, {
+							flexGrow: 1,
+							minWidth: 0,
+							children: /* @__PURE__ */ jsx(Text, {
+								color: theme.color.dim,
+								wrap: "truncate",
+								children: presence?.view ? /* @__PURE__ */ jsx(Safe, {
+									module: presenceModule,
+									theme,
+									render: () => presence.view?.({ theme })
+								}) : null
+							})
+						}),
+						/* @__PURE__ */ jsx(Box, {
+							flexShrink: 0,
+							paddingLeft: notice === null ? 0 : 2,
+							children: /* @__PURE__ */ jsx(Text, {
+								color: theme.color.warn,
+								children: notice ?? " "
+							})
+						})
+					]
+				})]
+			}) : /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsxs(Text, {
+				color: theme.color.accent,
+				children: [theme.glyph.prompt, " "]
+			}), shownDraft.text] }),
+			toast ? /* @__PURE__ */ jsx(Text, {
+				color: theme.color[toast.tone],
+				children: toast.text
+			}) : null,
+			/* @__PURE__ */ jsxs(Box, {
+				...band ? { marginTop: 1 } : {},
+				children: [registry.status.map((s) => /* @__PURE__ */ jsx(Box, {
+					marginRight: 2,
+					children: /* @__PURE__ */ jsx(Safe, {
+						module: s.module,
+						theme,
+						render: () => s.item.view({ theme })
+					})
+				}, `${s.module}:${s.item.id}`)), [...status.entries()].map(([k, v]) => /* @__PURE__ */ jsxs(Text, {
+					color: theme.color[v.tone],
+					children: [v.text, " "]
+				}, k))]
+			})
+		] });
+		const railColumn = /* @__PURE__ */ jsx(Fragment, { children: showRail ? /* @__PURE__ */ jsx(Box, {
+			flexDirection: "column",
+			width: 32,
+			marginLeft: 1,
+			children: registry.rail.map((r) => /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Safe, {
+				module: r.module,
+				theme,
+				render: () => r.item.view({ theme })
+			}) }, `${r.module}:${r.item.id}`))
+		}) : null });
+		if (full) {
+			const { content, viewport } = measured;
+			const top = viewTop(scroll, content, viewport);
+			const below = linesBelow(scroll, content, viewport);
+			const lo = top - viewport;
+			const hi = top + 2 * viewport;
+			const shown = [];
+			let at = 0;
+			let skipped = null;
+			for (const e of transcript.committed) {
+				const h = heights.current.get(e.key);
+				const rows = h ?? 1;
+				if (at + rows > lo && at < hi || h === void 0) {
+					if (skipped === null) skipped = at;
+					shown.push(e);
+				}
+				at += rows;
+			}
+			const rowsAbove = skipped ?? at;
+			const markerText = `↓ ${below} lines below · End to jump back`;
+			return /* @__PURE__ */ jsxs(Box, {
+				flexDirection: "row",
+				height,
+				paddingX: gutter,
+				children: [/* @__PURE__ */ jsxs(Box, {
+					flexDirection: "column",
+					flexGrow: 1,
+					children: [/* @__PURE__ */ jsxs(Box, {
+						ref: viewportRef,
+						flexDirection: "column",
+						flexGrow: 1,
+						flexShrink: 1,
+						minHeight: 1,
+						overflow: "hidden",
+						children: [/* @__PURE__ */ jsxs(Box, {
+							flexDirection: "column",
+							flexShrink: 0,
+							marginTop: -(top - rowsAbove),
+							children: [shown.map((e) => /* @__PURE__ */ jsx(Printed, {
+								id: e.key,
+								heights: heights.current,
+								paddingX: 0,
+								children: committed(e)
+							}, e.key)), /* @__PURE__ */ jsx(Box, {
+								ref: flightsRef,
+								flexDirection: "column",
+								flexShrink: 0,
+								children: flightRows
+							})]
+						}), panelOpen ? /* @__PURE__ */ jsx(Box, {
+							position: "absolute",
+							bottom: 0,
+							width: "100%",
+							flexDirection: "column",
+							children: overlayRows
+						}) : below > 0 ? /* @__PURE__ */ jsx(Box, {
+							position: "absolute",
+							bottom: 0,
+							children: /* @__PURE__ */ jsx(Text, {
+								color: theme.color.dim,
+								wrap: "truncate",
+								children: markerText.padEnd(panelOuter.columns)
+							})
+						}) : null]
+					}), /* @__PURE__ */ jsx(Box, {
+						flexDirection: "column",
+						flexShrink: 0,
+						children: pinnedRows
+					})]
+				}), railColumn]
+			});
+		}
 		return /* @__PURE__ */ jsxs(Box, {
 			flexDirection: "column",
 			children: [/* @__PURE__ */ jsx(Static, {
@@ -959,170 +1257,475 @@ function createApp(opts) {
 					flexDirection: "column",
 					flexGrow: 1,
 					children: [
-						markedFlights(transcript).map((f) => /* @__PURE__ */ jsx(Box, { children: waiting(f, false) }, `marked:${f.id}`)),
-						heldAsks(transcript).map((f) => /* @__PURE__ */ jsxs(Box, {
-							flexDirection: "column",
-							children: [askView ? /* @__PURE__ */ jsx(Safe, {
-								module: "app",
-								theme,
-								render: () => askView({
-									entry: f,
-									held: true,
-									theme,
-									size: { columns: width }
-								})
-							}) : /* @__PURE__ */ jsxs(Text, {
-								color: theme.color.accent,
-								children: [
-									theme.glyph.prompt,
-									" ",
-									sanitise(f.question)
-								]
-							}), waiting(f, true)]
-						}, f.id)),
-						panel && overlay ? /* @__PURE__ */ jsx(Box, {
-							backgroundColor: theme.color.raised,
-							paddingX: PANEL_PAD_X,
-							paddingY: PANEL_PAD_Y,
-							flexDirection: "column",
-							children: /* @__PURE__ */ jsx(Safe, {
-								module: overlay.module,
-								theme,
-								render: () => panel.view({
-									state: overlay.state,
-									theme,
-									size: panelSize,
-									...armed !== null && armed.module === overlay.module && armed.panel === overlay.panel && draft.text === armed.key ? { armed: {
-										key: armed.key,
-										label: armed.label
-									} } : {}
-								})
-							}, `${overlay.module}/${overlay.panel}`)
-						}) : null,
-						menu?.kind === "palette" ? /* @__PURE__ */ jsx(MenuList, {
-							theme,
-							rows: paletteItems.map((c) => ({
-								key: c.name,
-								name: commandUsage(c),
-								detail: c.summary
-							})),
-							selected: menu.selected,
-							height: menuRows,
-							empty: `no command matches ${draft.text}`,
-							hint: "tab complete · enter run · esc close"
-						}) : null,
-						menu?.kind === "completion" ? /* @__PURE__ */ jsx(MenuList, {
-							theme,
-							rows: menu.items.map((s) => ({
-								key: s.insert,
-								name: s.label,
-								detail: s.detail ?? ""
-							})),
-							selected: menu.selected,
-							height: menuRows,
-							empty: "no completions",
-							hint: "tab complete · esc close"
-						}) : null,
-						band ? /* @__PURE__ */ jsxs(Box, {
-							borderStyle: "bold",
-							borderTop: false,
-							borderRight: false,
-							borderBottom: false,
-							borderColor: theme.color.edge,
-							backgroundColor: theme.color.surfaceAlt,
-							paddingX: 1,
-							paddingY: 1,
-							flexDirection: "column",
-							children: [/* @__PURE__ */ jsxs(Text, { children: [
-								shownDraft.text.slice(0, shownDraft.cursor),
-								under === "" ? /* @__PURE__ */ jsx(Text, {
-									color: theme.color.cursor,
-									children: "█"
-								}) : /* @__PURE__ */ jsx(Text, {
-									inverse: true,
-									children: under
-								}),
-								under === "" ? "" : shownDraft.text.slice(shownDraft.cursor + under.length)
-							] }), /* @__PURE__ */ jsxs(Box, {
-								marginTop: 1,
-								children: [
-									presence ? /* @__PURE__ */ jsx(Box, {
-										flexShrink: 0,
-										children: /* @__PURE__ */ jsxs(Text, {
-											bold: true,
-											children: [sanitise(presence.name), " "]
-										})
-									}) : null,
-									/* @__PURE__ */ jsx(Box, {
-										flexGrow: 1,
-										minWidth: 0,
-										children: /* @__PURE__ */ jsx(Text, {
-											color: theme.color.dim,
-											wrap: "truncate",
-											children: presence?.view ? /* @__PURE__ */ jsx(Safe, {
-												module: presenceModule,
-												theme,
-												render: () => presence.view?.({ theme })
-											}) : null
-										})
-									}),
-									/* @__PURE__ */ jsx(Box, {
-										flexShrink: 0,
-										paddingLeft: notice === null ? 0 : 2,
-										children: /* @__PURE__ */ jsx(Text, {
-											color: theme.color.warn,
-											children: notice ?? " "
-										})
-									})
-								]
-							})]
-						}) : /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsxs(Text, {
-							color: theme.color.accent,
-							children: [theme.glyph.prompt, " "]
-						}), shownDraft.text] }),
-						toast ? /* @__PURE__ */ jsx(Text, {
-							color: theme.color[toast.tone],
-							children: toast.text
-						}) : null,
-						/* @__PURE__ */ jsxs(Box, {
-							...band ? { marginTop: 1 } : {},
-							children: [registry.status.map((s) => /* @__PURE__ */ jsx(Box, {
-								marginRight: 2,
-								children: /* @__PURE__ */ jsx(Safe, {
-									module: s.module,
-									theme,
-									render: () => s.item.view({ theme })
-								})
-							}, `${s.module}:${s.item.id}`)), [...status.entries()].map(([k, v]) => /* @__PURE__ */ jsxs(Text, {
-								color: theme.color[v.tone],
-								children: [v.text, " "]
-							}, k))]
-						})
+						flightRows,
+						overlayRows,
+						pinnedRows
 					]
-				}), showRail ? /* @__PURE__ */ jsx(Box, {
-					flexDirection: "column",
-					width: 32,
-					marginLeft: 1,
-					children: registry.rail.map((r) => /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Safe, {
-						module: r.module,
-						theme,
-						render: () => r.item.view({ theme })
-					}) }, `${r.module}:${r.item.id}`))
-				}) : null]
+				}), railColumn]
 			})]
 		});
 	}
 	return {
 		registry,
 		App,
+		fullscreen: fs.on,
 		async run() {
-			const prepare = runTerminalOptions(opts);
+			const full = fs.on && process.stdout.isTTY === true;
+			const prepare = runTerminalOptions(opts, full);
 			const restore = prepare === null ? () => {} : prepareTerminal(process.stdout, prepare);
-			await render(/* @__PURE__ */ jsx(App, {}), { exitOnCtrlC: false }).waitUntilExit();
+			await render(/* @__PURE__ */ jsx(App, {}), {
+				exitOnCtrlC: false,
+				alternateScreen: full
+			}).waitUntilExit();
 			restore();
 		}
 	};
 }
 
 //#endregion
-export { CLEAR_PANE, CTRL_C_WINDOW_MS, CompositionError, DEFAULT_GROUND, EMPTY_DRAFT, EMPTY_HISTORY, HISTORY_MAX, MENU_NAME_WIDTH, RESERVED_GLOBAL_KEYS, RESET_GROUND, addGap, anchorPadding, answerEntry, applyInput, applySuggestion, arriveTurn, assertComposes, atEnd, clampSelection, commandUsage, commitEntry, completeDraft, composeModules, createApp, ctrlC, defaultPanelRows, defineModule, editKey, emptyTranscript, enterRuns, groundSequence, heldAsks, insertChunk, keySpecOf, liveShrink, markedFlights, maskDraft, mayWalk, menuWindow, mergeCompletions, moveSelection, normaliseKeySpec, paletteMatches, paletteQuery, paletteRows, panelOf, parseCommandLine, pasteToLine, prepareSequence, prepareTerminal, reflowSequence, remember, resolveKey, routeInput, sanitise, sendTurn, setPanel, settle, walk, wordLeft, wordRight };
+//#region src/list-pager.tsx
+/** A list longer than this is paged rather than printed. */
+const INLINE_LIST_ROWS = 10;
+const LIST_REPLY_KIND = "surface.list";
+/** Rows a page holds in a panel `rows` tall: the heading, filter and hint lines take the rest. */
+const pageSizeFor = (rows) => Math.max(5, rows - 6);
+const cleanSpan = (s) => s.em === true ? {
+	text: sanitise(s.text),
+	em: true
+} : { text: sanitise(s.text) };
+const cleanRow = (r) => ({
+	key: r.key,
+	name: typeof r.name === "string" ? sanitise(r.name) : r.name.map(cleanSpan),
+	...r.details ? { details: r.details.map(sanitise) } : {},
+	...r.value !== void 0 ? { value: sanitise(r.value) } : {}
+});
+/** Everything an app hands in reaches the terminal sanitised. */
+const cleanList = (l) => ({
+	heading: sanitise(l.heading),
+	rows: l.rows.map(cleanRow),
+	...l.total !== void 0 ? { total: l.total } : {},
+	...l.notes ? { notes: l.notes.map(sanitise) } : {}
+});
+const cleanDetail = (d) => ({
+	title: sanitise(d.title),
+	...d.meta !== void 0 ? { meta: sanitise(d.meta) } : {},
+	...d.body !== void 0 ? { body: sanitise(d.body) } : {}
+});
+const inAll = (l) => l.total !== void 0 && l.total > l.rows.length ? `, ${l.total} in all` : "";
+const isPromise = (v) => typeof v?.then === "function";
+const errorText = (e) => sanitise(e instanceof Error ? e.message : String(e));
+/** The detail's body lines and the room the panel gives them. */
+function detailLayout(d, size) {
+	const lines = d.body === void 0 ? [] : wrapCells(d.body, size.columns);
+	const room = Math.max(1, size.rows - (d.meta === void 0 ? 3 : 4));
+	return {
+		lines,
+		room,
+		maxScroll: Math.max(0, lines.length - room)
+	};
+}
+function Hint({ theme, parts }) {
+	return /* @__PURE__ */ jsx(Box, {
+		marginTop: 1,
+		children: /* @__PURE__ */ jsx(Text, {
+			color: theme.color.dim,
+			wrap: "truncate",
+			children: parts.join(" · ")
+		})
+	});
+}
+function ListPage({ step, depth, theme, size }) {
+	const shown = visibleRows(step);
+	const per = pageSizeFor(size.rows);
+	const pages = Math.max(1, Math.ceil(shown.length / per));
+	const at = placement(step, per);
+	const page = Math.min(at.page, pages - 1);
+	const slice = shown.slice(page * per, page * per + per);
+	const total = step.list.total;
+	const of = total !== void 0 && total > step.list.rows.length ? ` · ${step.list.rows.length} of ${total}` : "";
+	const hint = [
+		"↑↓ row",
+		"←→ page",
+		...step.hooks.open ? ["enter open"] : [],
+		...step.hooks.related ? ["r related"] : [],
+		"/ filter",
+		depth > 1 || step.filter !== "" || step.filtering ? "esc back" : "esc close"
+	];
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate",
+				children: [
+					/* @__PURE__ */ jsx(Text, {
+						color: theme.color.accent,
+						children: "📋 List "
+					}),
+					/* @__PURE__ */ jsx(Text, {
+						bold: true,
+						children: step.list.heading
+					}),
+					/* @__PURE__ */ jsx(Text, {
+						color: theme.color.dim,
+						children: `${of} · page ${page + 1} of ${pages}`
+					})
+				]
+			}),
+			step.filtering || step.filter !== "" ? /* @__PURE__ */ jsx(Text, {
+				color: theme.color.dim,
+				children: `filter: ${step.filter}${step.filtering ? "▌" : ""}`
+			}) : null,
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				flexDirection: "column",
+				children: slice.length === 0 ? /* @__PURE__ */ jsx(Text, {
+					color: theme.color.dim,
+					children: `no rows match ${step.filter}`
+				}) : /* @__PURE__ */ jsx(ListRows, {
+					lines: listLines(slice, size.columns, page * per + 1),
+					theme,
+					cursor: at.cursor
+				})
+			}),
+			/* @__PURE__ */ jsx(Hint, {
+				theme,
+				parts: hint
+			})
+		]
+	});
+}
+function DetailPage({ step, theme, size }) {
+	const hint = [
+		"↑↓ scroll",
+		...step.hooks.related ? ["r related"] : [],
+		"esc back"
+	];
+	if (step.detail === "loading" || "error" in step.detail) return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [step.detail === "loading" ? /* @__PURE__ */ jsx(Text, {
+			color: theme.color.dim,
+			children: "loading…"
+		}) : /* @__PURE__ */ jsx(Text, {
+			color: theme.color.warn,
+			children: step.detail.error
+		}), /* @__PURE__ */ jsx(Hint, {
+			theme,
+			parts: ["esc back"]
+		})]
+	});
+	const d = step.detail;
+	const { lines, room } = detailLayout(d, size);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate",
+				children: [/* @__PURE__ */ jsx(Text, {
+					color: theme.color.accent,
+					children: "📋 "
+				}), /* @__PURE__ */ jsx(Text, {
+					bold: true,
+					children: d.title
+				})]
+			}),
+			d.meta !== void 0 ? /* @__PURE__ */ jsx(Text, {
+				color: theme.color.dim,
+				wrap: "truncate",
+				children: d.meta
+			}) : null,
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				flexDirection: "column",
+				children: lines.slice(step.scroll, step.scroll + room).map((l, i) => /* @__PURE__ */ jsx(Text, { children: l }, i))
+			}),
+			/* @__PURE__ */ jsx(Hint, {
+				theme,
+				parts: hint
+			})
+		]
+	});
+}
+function PagerView({ state, theme, size }) {
+	const step = state.steps[state.steps.length - 1];
+	if (step === void 0) return null;
+	if (step.kind === "list") return /* @__PURE__ */ jsx(ListPage, {
+		step,
+		depth: state.steps.length,
+		theme,
+		size
+	});
+	if (step.kind === "detail") return /* @__PURE__ */ jsx(DetailPage, {
+		step,
+		theme,
+		size
+	});
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [step.error === void 0 ? /* @__PURE__ */ jsx(Text, {
+			color: theme.color.dim,
+			children: "loading…"
+		}) : /* @__PURE__ */ jsx(Text, {
+			color: theme.color.warn,
+			children: step.error
+		}), /* @__PURE__ */ jsx(Hint, {
+			theme,
+			parts: ["esc back"]
+		})]
+	});
+}
+function ListReply({ data, theme, columns }) {
+	const { list, paged } = data;
+	const n = list.rows.length;
+	const width = Math.max(1, columns - 2);
+	let tail = null;
+	if (paged) tail = `${n} rows — in the list (/list)${inAll(list)}`;
+	else if (n > 10) tail = `…and ${n - 10} more — /list to page through them${inAll(list)}`;
+	else if (list.total !== void 0 && list.total > n) tail = `… ${list.total} in all`;
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				wrap: "wrap",
+				children: `${list.heading}:`
+			}),
+			paged ? null : /* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(ListRows, {
+					lines: listLines(list.rows.slice(0, 10), width),
+					theme
+				})
+			}),
+			tail !== null ? /* @__PURE__ */ jsx(Text, {
+				color: theme.color.dim,
+				children: `  ${tail}`
+			}) : null,
+			(list.notes ?? []).length > 0 ? /* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				flexDirection: "column",
+				children: (list.notes ?? []).map((note, i) => /* @__PURE__ */ jsx(Text, {
+					color: theme.color.dim,
+					italic: true,
+					wrap: "wrap",
+					children: note
+				}, i))
+			}) : null
+		]
+	});
+}
+/**
+* The pager module and `present`, which a turn handler yields as its reply:
+* `yield { phase: 'final', reply: pager.present(list, { open, related }) }`. A list of up to
+* `INLINE_LIST_ROWS` prints inline. A longer one opens the pager when no panel is open, and the
+* transcript then carries only its heading and a pointer; otherwise its first rows print inline.
+* `/list` reopens the last long list where it was left.
+*/
+function listPager() {
+	let own;
+	let last = null;
+	/**
+	* Keeps the first step as the operator left it, and returns the state to show. Only for the
+	* list `/list` would reopen: an older list paged while a newer one landed must not take its place.
+	*/
+	const keep = (s) => {
+		const first = s.steps[0];
+		const was = last?.steps[0];
+		if (first?.kind === "list" && was?.kind === "list" && first.list === was.list) last = {
+			steps: [first],
+			token: s.token
+		};
+		return s;
+	};
+	const top = (s) => s.steps[s.steps.length - 1];
+	const replaceTop = (s, step) => ({
+		...s,
+		steps: [...s.steps.slice(0, -1), step]
+	});
+	/** Settles an async step, only while the pager still shows the step it was started for. */
+	const settle = (ctx, token, step) => ctx.update("pager", (cur) => {
+		const t = top(cur);
+		return cur.token === token && t !== void 0 ? replaceTop(cur, step(t)) : cur;
+	});
+	const open = (s, ctx) => {
+		const t = top(s);
+		if (t?.kind !== "list") return s;
+		if (t.filtering) return keep(endFilter(s));
+		const row = cursorRow(s);
+		const hook = t.hooks.open;
+		if (row === void 0 || hook === void 0) return s;
+		const base = {
+			kind: "detail",
+			row,
+			hooks: t.hooks,
+			detail: "loading",
+			scroll: 0
+		};
+		let got;
+		try {
+			got = hook(row);
+		} catch (e) {
+			return push(s, {
+				...base,
+				detail: { error: errorText(e) }
+			});
+		}
+		if (!isPromise(got)) return push(s, {
+			...base,
+			detail: cleanDetail(got)
+		});
+		const next = push(s, base);
+		got.then((d) => settle(ctx, next.token, (cur) => cur.kind === "detail" ? {
+			...cur,
+			detail: cleanDetail(d)
+		} : cur), (e) => settle(ctx, next.token, (cur) => cur.kind === "detail" ? {
+			...cur,
+			detail: { error: errorText(e) }
+		} : cur));
+		return next;
+	};
+	const related = (s, ctx) => {
+		const t = top(s);
+		if (t?.kind === "list" && t.filtering) return keep(typeChar(s, "r"));
+		if (t === void 0 || t.kind === "loading-related") return s;
+		const row = cursorRow(s);
+		const hook = t.hooks.related;
+		if (row === void 0 || hook === void 0) return s;
+		const hooks = t.hooks;
+		let got;
+		try {
+			got = hook(row);
+		} catch (e) {
+			return push(s, {
+				kind: "loading-related",
+				row,
+				error: errorText(e)
+			});
+		}
+		if (!isPromise(got)) return push(s, listStep(cleanList(got), hooks));
+		const next = push(s, {
+			kind: "loading-related",
+			row
+		});
+		got.then((l) => settle(ctx, next.token, () => listStep(cleanList(l), hooks)), (e) => settle(ctx, next.token, () => ({
+			kind: "loading-related",
+			row,
+			error: errorText(e)
+		})));
+		return next;
+	};
+	const vertical = (delta) => (s, ctx) => {
+		const t = top(s);
+		if (t?.kind === "detail" && t.detail !== "loading" && !("error" in t.detail)) return scrollDetail(s, delta, detailLayout(t.detail, ctx.size()).maxScroll);
+		return keep(move(s, delta, pageSizeFor(ctx.size().rows)));
+	};
+	const page = (delta) => (s, ctx) => keep(turn(s, delta, pageSizeFor(ctx.size().rows)));
+	return {
+		module: defineModule("surface.list", {
+			init(ctx) {
+				own = ctx;
+				return () => {
+					own = void 0;
+				};
+			},
+			commands: [{
+				name: "list",
+				summary: "page through the last long list",
+				args: [],
+				run(_args, ctx) {
+					if (last === null) {
+						ctx.print("nothing to page through");
+						return;
+					}
+					ctx.open("pager", last);
+				}
+			}],
+			renderers: { [LIST_REPLY_KIND]: ({ data, theme, size }) => /* @__PURE__ */ jsx(ListReply, {
+				data,
+				theme,
+				columns: size.columns
+			}) },
+			panels: { pager: {
+				view: ({ state, theme, size }) => /* @__PURE__ */ jsx(PagerView, {
+					state,
+					theme,
+					size
+				}),
+				keymap: [
+					{
+						key: "up",
+						act: "up"
+					},
+					{
+						key: "down",
+						act: "down"
+					},
+					{
+						key: "left",
+						act: "left"
+					},
+					{
+						key: "right",
+						act: "right"
+					},
+					{
+						key: "enter",
+						act: "open"
+					},
+					{
+						key: "r",
+						act: "related"
+					},
+					{
+						key: "/",
+						act: "filter"
+					},
+					{
+						key: "backspace",
+						act: "backspace"
+					}
+				],
+				on: {
+					up: vertical(-1),
+					down: vertical(1),
+					left: page(-1),
+					right: page(1),
+					open,
+					related,
+					filter: (s) => {
+						const t = top(s);
+						return keep(t?.kind === "list" && t.filtering ? typeChar(s, "/") : startFilter(s));
+					},
+					backspace: (s) => keep(backspace(s))
+				},
+				text: (s, text) => keep(typeChar(s, text)),
+				escape: (s) => {
+					const prev = back(s);
+					return prev === void 0 ? void 0 : keep(prev);
+				}
+			} }
+		}),
+		present(list, hooks = {}) {
+			const clean = cleanList(list);
+			if (clean.rows.length <= 10) return {
+				kind: LIST_REPLY_KIND,
+				data: {
+					list: clean,
+					paged: false
+				}
+			};
+			last = pagerAt(clean, hooks);
+			const paged = own !== void 0 && !own.panelOpen();
+			if (paged) own?.open("pager", last);
+			return {
+				kind: LIST_REPLY_KIND,
+				data: {
+					list: clean,
+					paged
+				}
+			};
+		}
+	};
+}
+
+//#endregion
+export { CLEAR_PANE, CTRL_C_WINDOW_MS, CompositionError, DEFAULT_GROUND, EMPTY_DRAFT, EMPTY_HISTORY, FOLLOWING, HISTORY_MAX, INLINE_LIST_ROWS, LIST_REPLY_KIND, MENU_NAME_WIDTH, RESERVED_GLOBAL_KEYS, RESET_GROUND, WHEEL_ARROWS_OFF, WHEEL_ARROWS_ON, addGap, anchorPadding, answerEntry, applyInput, applySuggestion, arriveTurn, assertComposes, atEnd, back, backspace, clampSelection, commandUsage, commitEntry, completeDraft, composeModules, createApp, ctrlC, cursorRow, defaultPanelRows, defineModule, editKey, emptyTranscript, endFilter, enterRuns, groundSequence, heldAsks, insertChunk, keySpecOf, linesBelow, listPager, listStep, liveShrink, markedFlights, maskDraft, mayWalk, menuWindow, mergeCompletions, move, moveSelection, normaliseKeySpec, pageSizeFor, pageStep, pagerAt, paletteMatches, paletteQuery, paletteRows, panelOf, parseCommandLine, pasteToLine, placement, prepareSequence, prepareTerminal, push, reflowSequence, remember, resolveFullscreen, resolveKey, routeInput, sanitise, scrollBy, scrollDetail, sendTurn, setPanel, settle, startFilter, turn, typeChar, viewTop, visibleRows, walk, wordLeft, wordRight };