@elefunc/send 0.1.7 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elefunc/send",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Browser-compatible file transfer CLI and TUI powered by Bun, WebRTC, and Rezi.",
   "license": "MIT",
   "type": "module",

package/src/index.ts

@@ -37,11 +37,45 @@ const waitPeerTimeout = (value: unknown) => {
   if (!Number.isFinite(parsed) || parsed < 0) throw new ExitError("--wait-peer must be a finite non-negative number of milliseconds", 1)
   return parsed
 }
+const BINARY_OPTION_FLAGS = {
+  clean: "--clean",
+  accept: "--accept",
+  offer: "--offer",
+  save: "--save",
+} as const
+type BinaryOptionKey = keyof typeof BINARY_OPTION_FLAGS
+const binaryOption = (value: unknown, flag: string) => {
+  if (value == null) return undefined
+  if (value === 1 || value === "1") return true
+  if (value === 0 || value === "0") return false
+  throw new ExitError(`${flag} must be 0 or 1`, 1)
+}
+const parseBinaryOptions = <K extends BinaryOptionKey>(options: Record<string, unknown>, keys: readonly K[]) =>
+  Object.fromEntries(keys.map(key => [key, binaryOption(options[key], BINARY_OPTION_FLAGS[key])])) as Record<K, boolean | undefined>
 
 const SELF_ID_LENGTH = 8
 const SELF_ID_PATTERN = new RegExp(`^[a-z0-9]{${SELF_ID_LENGTH}}$`)
 const SELF_HELP_TEXT = "self identity: name, name-ID, or -ID (use --self=-ID)"
 const INVALID_SELF_ID_MESSAGE = `--self ID suffix must be exactly ${SELF_ID_LENGTH} lowercase alphanumeric characters`
+type CliCommand = ReturnType<CAC["command"]>
+const ROOM_SELF_OPTIONS = [
+  ["--room <room>", "room id; omit to create a random room"],
+  ["--self <self>", SELF_HELP_TEXT],
+] as const
+const TURN_OPTIONS = [
+  ["--turn-url <url>", "custom TURN url, repeat or comma-separate"],
+  ["--turn-username <value>", "custom TURN username"],
+  ["--turn-credential <value>", "custom TURN credential"],
+] as const
+const SAVE_DIR_OPTION = ["--save-dir <dir>", "save directory"] as const
+const TUI_TOGGLE_OPTIONS = [
+  ["--clean <0|1>", "show only active peers when 1; show terminal peers too when 0"],
+  ["--accept <0|1>", "auto-accept incoming offers: 1 on, 0 off"],
+  ["--offer <0|1>", "auto-offer drafts to matching ready peers: 1 on, 0 off"],
+  ["--save <0|1>", "auto-save completed incoming files: 1 on, 0 off"],
+] as const
+const addOptions = (command: CliCommand, definitions: readonly (readonly [string, string])[]) =>
+  definitions.reduce((next, [flag, description]) => next.option(flag, description), command)
 
 const requireSelfId = (value: string) => {
   if (!SELF_ID_PATTERN.test(value)) throw new ExitError(INVALID_SELF_ID_MESSAGE, 1)
@@ -61,12 +95,13 @@ const parseSelfOption = (value: unknown): Pick<SessionConfig, "name" | "localId"
 export const sessionConfigFrom = (options: Record<string, unknown>, defaults: { autoAcceptIncoming?: boolean; autoSaveIncoming?: boolean }): SessionConfig & { room: string } => {
   const room = cleanRoom(firstNonEmptyText(options.room, process.env.SEND_ROOM))
   const self = parseSelfOption(options.self ?? process.env.SEND_SELF)
+  const { accept, save } = parseBinaryOptions(options, ["accept", "save"] as const)
   return {
     room,
     ...self,
     saveDir: resolve(`${options.saveDir ?? process.env.SEND_SAVE_DIR ?? "downloads"}`),
-    autoAcceptIncoming: defaults.autoAcceptIncoming ?? false,
-    autoSaveIncoming: defaults.autoSaveIncoming ?? false,
+    autoAcceptIncoming: accept ?? defaults.autoAcceptIncoming ?? false,
+    autoSaveIncoming: save ?? defaults.autoSaveIncoming ?? false,
     turnUrls: splitList(options.turnUrl ?? process.env.SEND_TURN_URL),
     turnUsername: `${options.turnUsername ?? process.env.SEND_TURN_USERNAME ?? ""}`.trim() || undefined,
     turnCredential: `${options.turnCredential ?? process.env.SEND_TURN_CREDENTIAL ?? ""}`.trim() || undefined,
@@ -218,8 +253,13 @@ const acceptCommand = async (options: Record<string, unknown>) => {
 
 const tuiCommand = async (options: Record<string, unknown>) => {
   const initialConfig = sessionConfigFrom(options, { autoAcceptIncoming: true, autoSaveIncoming: true })
+  const { clean, offer } = parseBinaryOptions(options, ["clean", "offer"] as const)
   const { startTui } = await loadTuiRuntime()
-  await startTui(initialConfig, !!options.events)
+  await startTui(initialConfig, {
+    events: !!options.events,
+    clean: clean ?? true,
+    offer: offer ?? true,
+  })
 }
 
 type CliHandlers = {
@@ -240,53 +280,38 @@ export const createCli = (handlers: CliHandlers = defaultCliHandlers) => {
   const cli = cac("send")
   cli.usage("[command] [options]")
 
-  cli
-    .command("peers", "list discovered peers")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--wait <ms>", "discovery wait in milliseconds")
-    .option("--json", "print a json snapshot")
-    .option("--save-dir <dir>", "save directory")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.peers)
-
-  cli
-    .command("offer [...files]", "offer files to browser-compatible peers")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--to <peer>", "target peer id or name-suffix, or `.` for all ready peers; default: `.`")
-    .option("--wait-peer <ms>", "wait for eligible peers in milliseconds; omit to wait indefinitely")
-    .option("--json", "emit ndjson events")
-    .option("--save-dir <dir>", "save directory")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.offer)
-
-  cli
-    .command("accept", "receive and save files")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--save-dir <dir>", "save directory")
-    .option("--once", "exit after the first saved incoming transfer")
-    .option("--json", "emit ndjson events")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.accept)
-
-  cli
-    .command("tui", "launch the interactive terminal UI")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--events", "show the event log pane")
-    .option("--save-dir <dir>", "save directory")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.tui)
+  addOptions(cli.command("peers", "list discovered peers"), [
+    ...ROOM_SELF_OPTIONS,
+    ["--wait <ms>", "discovery wait in milliseconds"],
+    ["--json", "print a json snapshot"],
+    SAVE_DIR_OPTION,
+    ...TURN_OPTIONS,
+  ]).action(handlers.peers)
+
+  addOptions(cli.command("offer [...files]", "offer files to browser-compatible peers"), [
+    ...ROOM_SELF_OPTIONS,
+    ["--to <peer>", "target peer id or name-suffix, or `.` for all ready peers; default: `.`"],
+    ["--wait-peer <ms>", "wait for eligible peers in milliseconds; omit to wait indefinitely"],
+    ["--json", "emit ndjson events"],
+    SAVE_DIR_OPTION,
+    ...TURN_OPTIONS,
+  ]).action(handlers.offer)
+
+  addOptions(cli.command("accept", "receive and save files"), [
+    ...ROOM_SELF_OPTIONS,
+    SAVE_DIR_OPTION,
+    ["--once", "exit after the first saved incoming transfer"],
+    ["--json", "emit ndjson events"],
+    ...TURN_OPTIONS,
+  ]).action(handlers.accept)
+
+  addOptions(cli.command("tui", "launch the interactive terminal UI"), [
+    ...ROOM_SELF_OPTIONS,
+    ...TUI_TOGGLE_OPTIONS,
+    ["--events", "show the event log pane"],
+    SAVE_DIR_OPTION,
+    ...TURN_OPTIONS,
+  ]).action(handlers.tui)
 
   cli.help(sections => {
     const usage = sections.find(section => section.title === "Usage:")

package/src/tui/app.ts

@@ -1,3 +1,4 @@
+import { resolve } from "node:path"
 import { rgb, ui, type BadgeVariant, type VNode } from "@rezi-ui/core"
 import { createNodeApp } from "@rezi-ui/node"
 import { inspectLocalFile } from "../core/files"
@@ -37,6 +38,7 @@ type DenseSectionOptions = {
   border?: "rounded" | "single" | "none"
   flex?: number
 }
+type TuiLaunchOptions = { events?: boolean; clean?: boolean; offer?: boolean }
 
 export type VisiblePane = "peers" | "transfers" | "logs"
 
@@ -45,6 +47,7 @@ export interface TuiState {
   sessionSeed: SessionSeed
   peerSelectionByRoom: Map<string, Map<string, boolean>>
   snapshot: SessionSnapshot
+  aboutOpen: boolean
   peerSearch: string
   focusedId: string | null
   roomInput: string
@@ -67,6 +70,8 @@ export interface TuiState {
 
 export interface TuiActions {
   toggleEvents: TuiAction
+  openAbout: TuiAction
+  closeAbout: TuiAction
   jumpToRandomRoom: TuiAction
   commitRoom: TuiAction
   setRoomInput: (value: string) => void
@@ -101,11 +106,20 @@ const ROOM_INPUT_ID = "room-input"
 const NAME_INPUT_ID = "name-input"
 const PEER_SEARCH_INPUT_ID = "peer-search-input"
 const DRAFT_INPUT_ID = "draft-input"
+const ABOUT_TRIGGER_ID = "open-about"
 const TRANSPARENT_BORDER_STYLE = { fg: rgb(7, 10, 12) } as const
 const METRIC_BORDER_STYLE = { fg: rgb(20, 25, 32) } as const
 const PRIMARY_TEXT_STYLE = { fg: rgb(255, 255, 255) } as const
 const HEADING_TEXT_STYLE = { fg: rgb(255, 255, 255), bold: true } as const
 const DEFAULT_WEB_URL = "https://send.rt.ht/"
+const DEFAULT_SAVE_DIR = resolve(process.cwd(), "downloads")
+const ABOUT_ELEFUNC_URL = "https://elefunc.com"
+const ABOUT_TITLE = "About Send"
+const ABOUT_INTRO = "Peer-to-Peer Transfers for the Web and CLI"
+const ABOUT_SUMMARY = "Join the same room, see who is there, and offer files directly to selected peers."
+const ABOUT_RUNTIME = "Send uses lightweight signaling to discover peers and negotiate WebRTC. Files move over WebRTC data channels, using direct paths when possible and TURN relay when needed."
+const ABOUT_CLI_LABEL = "bunx @elefunc/send@latest"
+const ABOUT_WEB_LINK_LABEL = "Web"
 const TRANSFER_DIRECTION_ARROW = {
   out: { glyph: "↗", style: { fg: rgb(170, 217, 76), bold: true } },
   in: { glyph: "↙", style: { fg: rgb(240, 113, 120), bold: true } },
@@ -119,8 +133,50 @@ const pluralRules = new Intl.PluralRules()
 export const visiblePanes = (showEvents: boolean): VisiblePane[] => showEvents ? ["peers", "transfers", "logs"] : ["peers", "transfers"]
 
 const noop = () => {}
+export const isEditableFocusId = (focusedId: string | null) =>
+  focusedId === ROOM_INPUT_ID || focusedId === NAME_INPUT_ID || focusedId === PEER_SEARCH_INPUT_ID || focusedId === DRAFT_INPUT_ID
+export const shouldSwallowQQuit = (focusedId: string | null) => !isEditableFocusId(focusedId)
 
 const hashBool = (value: boolean) => value ? "1" : "0"
+const safeShellArgPattern = /^[A-Za-z0-9._/:?=&,+@%-]+$/
+const TUI_QUIT_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"] as const
+type TuiQuitSignal = (typeof TUI_QUIT_SIGNALS)[number]
+type ProcessSignalLike = {
+  on?: (signal: TuiQuitSignal, handler: () => void) => unknown
+  off?: (signal: TuiQuitSignal, handler: () => void) => unknown
+  removeListener?: (signal: TuiQuitSignal, handler: () => void) => unknown
+}
+type ShareUrlState = Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming">
+type ShareCliState = ShareUrlState & Pick<TuiState, "sessionSeed" | "eventsExpanded">
+const shellQuote = (value: string) => safeShellArgPattern.test(value) ? value : `'${value.replaceAll("'", `'\"'\"'`)}'`
+const appendCliFlag = (args: string[], flag: string, value?: string | null) => {
+  const text = `${value ?? ""}`.trim()
+  if (!text) return
+  args.push(flag, shellQuote(text))
+}
+const SHARE_TOGGLE_FLAGS = [
+  ["clean", "hideTerminalPeers", "--clean"],
+  ["accept", "autoAcceptIncoming", "--accept"],
+  ["offer", "autoOfferOutgoing", "--offer"],
+  ["save", "autoSaveIncoming", "--save"],
+] as const satisfies readonly (readonly [string, keyof ShareUrlState, string])[]
+const appendToggleCliFlags = (args: string[], state: ShareUrlState) => {
+  for (const [, stateKey, flag] of SHARE_TOGGLE_FLAGS) if (!state[stateKey]) appendCliFlag(args, flag, "0")
+}
+const buildHashParams = (state: ShareUrlState, omitDefaults = false) => {
+  const params = new URLSearchParams({ room: cleanRoom(state.snapshot.room) })
+  for (const [key, stateKey] of SHARE_TOGGLE_FLAGS) if (!omitDefaults || !state[stateKey]) params.set(key, hashBool(state[stateKey]))
+  return params
+}
+const shareTurnCliArgs = (sessionSeed: SessionSeed) => {
+  const turnUrls = [...new Set((sessionSeed.turnUrls ?? []).map(url => `${url ?? ""}`.trim()).filter(Boolean))]
+  if (!turnUrls.length) return []
+  const args: string[] = []
+  for (const turnUrl of turnUrls) appendCliFlag(args, "--turn-url", turnUrl)
+  appendCliFlag(args, "--turn-username", sessionSeed.turnUsername)
+  appendCliFlag(args, "--turn-credential", sessionSeed.turnCredential)
+  return args
+}
 
 export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => {
   const candidate = `${value ?? ""}`.trim() || DEFAULT_WEB_URL
@@ -131,23 +187,75 @@ export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => {
   }
 }
 
-export const webInviteUrl = (
-  state: Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming">,
-  baseUrl = resolveWebUrlBase(),
-) => {
+const renderWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL, omitDefaults = true) => {
   const url = new URL(baseUrl)
-  url.hash = new URLSearchParams({
-    room: cleanRoom(state.snapshot.room),
-    clean: hashBool(state.hideTerminalPeers),
-    accept: hashBool(state.autoAcceptIncoming),
-    offer: hashBool(state.autoOfferOutgoing),
-    save: hashBool(state.autoSaveIncoming),
-  }).toString()
+  url.hash = buildHashParams(state, omitDefaults).toString()
   return url.toString()
 }
+const renderCliCommand = (state: ShareCliState, { includeSelf = false, includePrefix = false } = {}) => {
+  const args = includePrefix ? ["bunx", "@elefunc/send@latest"] : []
+  appendCliFlag(args, "--room", state.snapshot.room)
+  if (includeSelf) appendCliFlag(args, "--self", displayPeerName(state.snapshot.name, state.snapshot.localId))
+  appendToggleCliFlags(args, state)
+  if (state.eventsExpanded) args.push("--events")
+  if (resolve(state.snapshot.saveDir) !== DEFAULT_SAVE_DIR) appendCliFlag(args, "--save-dir", state.snapshot.saveDir)
+  args.push(...shareTurnCliArgs(state.sessionSeed))
+  return args.join(" ")
+}
+
+export const webInviteUrl = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => {
+  return renderWebUrl(state, baseUrl)
+}
+
+export const aboutWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+
+export const aboutWebLabel = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => aboutWebUrl(state, baseUrl).replace(/^https:\/\//, "")
+
+export const aboutCliCommand = (state: ShareCliState) => renderCliCommand(state)
+
+export const resumeWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+
+export const resumeCliCommand = (state: ShareCliState) => renderCliCommand(state, { includeSelf: true, includePrefix: true })
+
+export const resumeOutputLines = (state: ShareCliState) => [
+  "Rejoin with:",
+  "",
+  "Web",
+  resumeWebUrl(state),
+  "",
+  "CLI",
+  resumeCliCommand(state),
+  "",
+]
+
+export const createQuitController = (processLike: ProcessSignalLike | null = process) => {
+  let settled = false
+  let resolvePromise = () => {}
+  const promise = new Promise<void>(resolve => { resolvePromise = resolve })
+  const requestStop = () => {
+    if (settled) return false
+    settled = true
+    resolvePromise()
+    return true
+  }
+  const handler = () => { requestStop() }
+  for (const signal of TUI_QUIT_SIGNALS) processLike?.on?.(signal, handler)
+  return {
+    promise,
+    requestStop,
+    detach: () => {
+      for (const signal of TUI_QUIT_SIGNALS) {
+        processLike?.off?.(signal, handler)
+        processLike?.removeListener?.(signal, handler)
+      }
+    },
+  }
+}
 
 export const createNoopTuiActions = (): TuiActions => ({
   toggleEvents: noop,
+  openAbout: noop,
+  closeAbout: noop,
   jumpToRandomRoom: noop,
   commitRoom: noop,
   setRoomInput: noop,
@@ -481,7 +589,7 @@ export const groupTransfersByPeer = (transfers: TransferSnapshot[], peers: PeerS
   return [...groups.values()]
 }
 
-export const createInitialTuiState = (initialConfig: SessionConfig, showEvents = false): TuiState => {
+export const createInitialTuiState = (initialConfig: SessionConfig, showEvents = false, launchOptions: Pick<TuiLaunchOptions, "clean" | "offer"> = {}): TuiState => {
   const sessionSeed = normalizeSessionSeed(initialConfig)
   const autoAcceptIncoming = initialConfig.autoAcceptIncoming ?? true
   const autoSaveIncoming = initialConfig.autoSaveIncoming ?? true
@@ -493,6 +601,7 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
     sessionSeed,
     peerSelectionByRoom,
     snapshot: session.snapshot(),
+    aboutOpen: false,
     peerSearch: "",
     focusedId: null,
     roomInput: sessionSeed.room,
@@ -502,10 +611,10 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
     draftInputKeyVersion: 0,
     filePreview: emptyFilePreviewState(),
     drafts: [],
-    autoOfferOutgoing: true,
+    autoOfferOutgoing: launchOptions.offer ?? true,
     autoAcceptIncoming,
     autoSaveIncoming,
-    hideTerminalPeers: true,
+    hideTerminalPeers: launchOptions.clean ?? true,
     eventsExpanded: showEvents,
     offeringDrafts: false,
     notice: { text: "Tab focus", variant: "info" },
@@ -594,9 +703,64 @@ const renderHeaderBrand = () => ui.row({ id: "brand-title", gap: 1, items: "cent
 const renderHeader = (state: TuiState, actions: TuiActions) => denseSection({
   id: "header-shell",
   titleNode: renderHeaderBrand(),
-  actions: [toggleButton("toggle-events", "Events", state.eventsExpanded, actions.toggleEvents)],
+  actions: [
+    toggleButton("toggle-events", "Events", state.eventsExpanded, actions.toggleEvents),
+    actionButton(ABOUT_TRIGGER_ID, "About", actions.openAbout),
+  ],
 }, [])
 
+const renderAboutModal = (state: TuiState, actions: TuiActions) => {
+  const cliCommand = aboutCliCommand(state)
+  const cliCopyText = `${ABOUT_CLI_LABEL} ${cliCommand}`
+  const cliCopyUrl = `https://copy.rt.ht/#${new URLSearchParams({ text: cliCopyText })}`
+  const currentWebUrl = aboutWebUrl(state)
+  const currentWebLabel = aboutWebLabel(state)
+  return ui.modal({
+  id: "about-modal",
+  title: ABOUT_TITLE,
+  content: ui.column({ gap: 1 }, [
+    ui.text(ABOUT_INTRO, { id: "about-intro", variant: "heading", wrap: true }),
+    ui.text(ABOUT_SUMMARY, { id: "about-summary", wrap: true }),
+    ui.text(ABOUT_RUNTIME, { id: "about-runtime", wrap: true }),
+    ui.column({ gap: 0 }, [
+      ui.text(ABOUT_CLI_LABEL, { id: "about-cli-label", variant: "caption", wrap: true }),
+      ui.link({
+        id: "about-current-cli",
+        label: cliCommand,
+        accessibleLabel: "Copy current CLI command",
+        url: cliCopyUrl,
+      }),
+    ]),
+    ui.column({ gap: 0 }, [
+      ui.text(ABOUT_WEB_LINK_LABEL, { id: "about-web-link-label", variant: "caption", wrap: true }),
+      ui.link({
+        id: "about-current-web-link",
+        label: currentWebLabel,
+        accessibleLabel: "Open current web link",
+        url: currentWebUrl,
+      }),
+    ]),
+  ]),
+  actions: [
+    ui.link({
+      id: "about-elefunc-link",
+      label: "elefunc.com",
+      accessibleLabel: "Open Elefunc website",
+      url: ABOUT_ELEFUNC_URL,
+    }),
+    actionButton("close-about", "Close", actions.closeAbout, "primary"),
+  ],
+  width: 72,
+  maxWidth: 84,
+  minWidth: 54,
+  frameStyle: { background: rgb(0, 0, 0) },
+  backdrop: { variant: "none" },
+  initialFocus: "close-about",
+  returnFocusTo: ABOUT_TRIGGER_ID,
+  onClose: actions.closeAbout,
+})
+}
+
 const renderRoomCard = (state: TuiState, actions: TuiActions) => denseSection({
   id: "room-card",
 }, [
@@ -630,6 +794,14 @@ const renderSelfMetric = (label: string, value: string) => ui.box({ flex: 1, min
 ])
 
 const renderSelfProfileLine = (value: string) => ui.text(value || "—")
+const ipLookupUrl = (value: string) => value ? `https://gi.rt.ht/:${encodeURIComponent(value)}` : null
+const renderIpProfileLine = (value: string) => {
+  const ip = value || ""
+  const url = ipLookupUrl(ip)
+  return url
+    ? ui.link({ label: ip, url, accessibleLabel: `Open IP lookup for ${ip}` })
+    : ui.text("—")
+}
 const formatPeerRtt = (value: number) => Number.isFinite(value) ? `${countFormat.format(Math.round(value))}ms` : "—"
 const renderPeerMetric = (label: string, value: string, asTag = false) => ui.box({ flex: 1, minWidth: 10, border: "single", borderStyle: METRIC_BORDER_STYLE }, [
   ui.column({ gap: 0 }, [
@@ -663,7 +835,7 @@ const renderSelfCard = (state: TuiState, actions: TuiActions) => denseSection({
     renderSelfProfileLine(geoSummary(state.snapshot.profile)),
     renderSelfProfileLine(netSummary(state.snapshot.profile)),
     renderSelfProfileLine(uaSummary(state.snapshot.profile)),
-    renderSelfProfileLine(profileIp(state.snapshot.profile)),
+    renderIpProfileLine(profileIp(state.snapshot.profile)),
   ]),
 ])
 
@@ -708,7 +880,7 @@ const renderPeerRow = (peer: PeerSnapshot, turnShareEnabled: boolean, actions: T
       renderSelfProfileLine(geoSummary(peer.profile)),
       renderSelfProfileLine(netSummary(peer.profile)),
       renderSelfProfileLine(uaSummary(peer.profile)),
-      renderSelfProfileLine(profileIp(peer.profile)),
+      renderIpProfileLine(profileIp(peer.profile)),
     ]),
     peer.lastError ? ui.callout(peer.lastError, { variant: "error" }) : null,
   ]),
@@ -1021,7 +1193,7 @@ export const renderTuiView = (state: TuiState, actions: TuiActions): VNode => {
     gap: 0,
   })
 
-  return state.pendingFocusTarget
+  const basePage = state.pendingFocusTarget
     ? ui.focusTrap({
         id: `focus-request-${state.focusRequestEpoch}`,
         key: `focus-request-${state.focusRequestEpoch}`,
@@ -1029,6 +1201,10 @@ export const renderTuiView = (state: TuiState, actions: TuiActions): VNode => {
         initialFocus: state.pendingFocusTarget,
       }, [page])
     : page
+
+  return state.aboutOpen
+    ? ui.layers([basePage, renderAboutModal(state, actions)])
+    : basePage
 }
 
 const withNotice = (state: TuiState, notice: Notice): TuiState => ({ ...state, notice })
@@ -1043,10 +1219,11 @@ export const withAcceptedDraftInput = (state: TuiState, draftInput: string, file
     focusRequestEpoch: state.focusRequestEpoch + 1,
   }, notice)
 
-export const startTui = async (initialConfig: SessionConfig, showEvents = false) => {
+export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiLaunchOptions = {}) => {
   await installCheckboxClickPatch()
-  const initialState = createInitialTuiState(initialConfig, showEvents)
+  const initialState = createInitialTuiState(initialConfig, !!launchOptions.events, launchOptions)
   const app = createNodeApp<TuiState>({ initialState })
+  const quitController = createQuitController()
   let state = initialState
   let unsubscribe = () => {}
   let stopping = false
@@ -1086,11 +1263,7 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
   const requestStop = () => {
     if (stopping) return
     stopping = true
-    try {
-      process.kill(process.pid, "SIGINT")
-    } catch {
-      void app.stop()
-    }
+    quitController.requestStop()
   }
 
   const resetFilePreview = (overrides: Partial<FilePreviewState> = {}): FilePreviewState => ({
@@ -1368,6 +1541,8 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
 
   const actions: TuiActions = {
     toggleEvents: () => commit(current => ({ ...withNotice(current, { text: current.eventsExpanded ? "Events hidden." : "Events shown.", variant: "info" }), eventsExpanded: !current.eventsExpanded })),
+    openAbout: () => commit(current => ({ ...current, aboutOpen: true })),
+    closeAbout: () => commit(current => ({ ...current, aboutOpen: false })),
     jumpToRandomRoom: () => replaceSession({ ...state.sessionSeed, room: uid(8) }, "Joined a new room."),
     commitRoom,
     setRoomInput: value => commit(current => ({ ...current, roomInput: value })),
@@ -1523,6 +1698,11 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
   })
   app.keys({
     "ctrl+c": { description: "Quit", handler: requestStop },
+    q: {
+      description: "no-op",
+      when: ctx => shouldSwallowQQuit(ctx.focusedId),
+      handler: noop,
+    },
     tab: {
       description: "Accept focused preview row",
       when: ctx => ctx.focusedId === DRAFT_INPUT_ID && !!selectedFilePreviewMatch(state) && filePreviewVisible(state),
@@ -1593,17 +1773,31 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
     stopping = true
     unsubscribe()
     stopPreviewSession()
+    try {
+      await app.stop()
+    } catch {}
     await state.session.close()
   }
 
+  const printResumeOutput = async () => {
+    const output = `${resumeOutputLines(state).join("\n")}\n`
+    await new Promise<void>(resolve => process.stdout.write(output, () => resolve()))
+  }
+
   try {
     bindSession(state.session)
-    await app.run()
+    await app.start()
+    await quitController.promise
   } finally {
     try {
       await stop()
     } finally {
-      app.dispose()
+      try {
+        app.dispose()
+      } finally {
+        await printResumeOutput()
+        quitController.detach()
+      }
     }
   }
 }