Ejecutar en una terminal

text run ejecuta la misma app en una terminal. El layout, los componentes, los mapas de teclas y los manejadores de ruta se comparten, y la salida es ANSI de color verdadero en lugar de spans CSS %c.

#text run

Añade un script y ejecútalo:

bun run tui                        # render ./app at /bun run tui -- --path /deployments # start on another route

text run importa todos los archivos de app/, monta el App Router con un historial en memoria y lo dibuja a pantalla completa. <Link>, useRouter(), notFound() y redirect() funcionan sin cambios, y las llamadas a fetch("/api/…") del mismo origen ejecutan tus manejadores de ruta en el mismo proceso. Ctrl+C cierra la app y restaura tu historial de desplazamiento. Requiere Bun.

#Salir con q

Quienes usan la terminal esperan poder salir con q. useApp().exit() desmonta la app y restaura la terminal; en el navegador desmonta la app de consola.

#Tu propia CLI

Para un solo componente, usa renderToTerminal. Monta un elemento sin el App Router, y fetch("/api/…") solo llega a tus manejadores de ruta bajo text run, así que pasa los datos al componente:

import { renderToTerminal } from "@textjs/app/terminal";import { Table } from "@textjs/app";import { DEPLOYMENTS } from "./lib/deployments";const columns = [{ key: "commit", header: "Commit" }, { key: "project", header: "Project", width: 10 }];const app = await renderToTerminal(<Table columns={columns} rows={DEPLOYMENTS} autoFocus />);await app.waitUntilExit();

Ejecútalo con bun cli.tsx. DeploymentsPage obtiene sus filas, por lo que necesita text run.

#Diferencias

Las terminales repintan más rápido (hasta 60 fps en lugar de ~15) y ajustan la cuadrícula a la ventana en lugar de a la consola acoplada. Las imágenes necesitan datos de píxeles en lugar de una URL. Todo lo demás, incluido este panel, usa el mismo código.