@valyrianjs/terminal 0.1.0

package/dist/tree.js

@@ -0,0 +1,103 @@
+function isVnodeLike(value) {
+    return Boolean(value && typeof value === "object" && "tag" in value && "children" in value);
+}
+function isPojoComponent(value) {
+    return Boolean(value && typeof value === "object" && typeof value.view === "function");
+}
+function normalizeChildren(children) {
+    const out = [];
+    for (let i = 0; i < children.length; i += 1) {
+        out.push(...resolveToTerminalNodes(children[i]));
+    }
+    return out;
+}
+function resolveComponent(component, props, children) {
+    if (isPojoComponent(component)) {
+        return component.view.call(component, props, children);
+    }
+    return component(props, children);
+}
+export function resolveToTerminalNodes(input) {
+    if (input == null || input === false || input === true) {
+        return [];
+    }
+    if (Array.isArray(input)) {
+        return input.flatMap(resolveToTerminalNodes);
+    }
+    if (typeof input === "string" || typeof input === "number") {
+        return [{ type: "text", value: String(input) }];
+    }
+    if (isVnodeLike(input)) {
+        if (input.props && "v-for" in (input.props || {})) {
+            const set = (input.props || {})["v-for"];
+            const callback = input.children?.[0];
+            if (typeof callback === "function" && Array.isArray(set)) {
+                const out = [];
+                for (let i = 0; i < set.length; i += 1) {
+                    out.push(...resolveToTerminalNodes(callback(set[i], i)));
+                }
+                return out;
+            }
+        }
+        if (typeof input.tag === "function" || isPojoComponent(input.tag)) {
+            return resolveToTerminalNodes(resolveComponent(input.tag, input.props || {}, input.children || []));
+        }
+        return [
+            {
+                type: "element",
+                tag: input.tag,
+                props: (input.props || {}),
+                children: normalizeChildren(input.children || [])
+            }
+        ];
+    }
+    return [{ type: "text", value: String(input) }];
+}
+export function resolveRoot(input) {
+    if (typeof input === "function" && !isVnodeLike(input)) {
+        return resolveToTerminalNodes(input({}, []));
+    }
+    return resolveToTerminalNodes(input);
+}
+export function textContent(node) {
+    if (node.type === "text") {
+        return node.value;
+    }
+    return node.children.map(textContent).join("");
+}
+export function isFocusable(node) {
+    return node.type === "element" && (node.tag === "terminal-input" || node.tag === "terminal-button" || node.tag === "terminal-list" || node.tag === "terminal-scroll" || Boolean(node.props.focusable));
+}
+export function collectFocusableNodes(nodes, out) {
+    for (let i = 0; i < nodes.length; i += 1) {
+        const node = nodes[i];
+        if (isFocusable(node)) {
+            out.push(node);
+        }
+        if (node.type === "element") {
+            collectFocusableNodes(node.children, out);
+        }
+    }
+}
+export function findFocusableById(nodes, id) {
+    for (let i = 0; i < nodes.length; i += 1) {
+        const node = nodes[i];
+        if (isFocusable(node) && node.props.id === id) {
+            return node;
+        }
+        if (node.type === "element") {
+            const found = findFocusableById(node.children, id);
+            if (found) {
+                return found;
+            }
+        }
+    }
+    return null;
+}
+export function findFocused(nodes, focusedId) {
+    if (!focusedId) {
+        return null;
+    }
+    return findFocusableById(nodes, focusedId);
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,224 @@
+export type AnyProps = Record<string, any> | null | undefined;
+export type TerminalPrimitiveTag = "terminal-screen" | "terminal-box" | "terminal-view" | "terminal-text" | "terminal-input" | "terminal-button" | "terminal-scroll" | "terminal-list" | "terminal-table" | "terminal-row" | "terminal-td";
+export interface VnodeLike {
+    tag: any;
+    props: AnyProps;
+    children: any[];
+}
+export interface TerminalTextNode {
+    type: "text";
+    value: string;
+}
+export interface TerminalElementNode {
+    type: "element";
+    tag: TerminalPrimitiveTag;
+    props: Record<string, any>;
+    children: TerminalNode[];
+}
+export type TerminalNode = TerminalTextNode | TerminalElementNode;
+export interface TerminalFocusNode extends TerminalElementNode {
+    props: Record<string, any> & {
+        id?: string;
+    };
+}
+export interface TerminalHitbox {
+    id: string;
+    tag: TerminalPrimitiveTag;
+    x1: number;
+    x2: number;
+    y1: number;
+    y2: number;
+    textStartX?: number;
+    textLength?: number;
+}
+export interface CursorPosition {
+    x: number;
+    y: number;
+}
+export interface TerminalSelectionRange {
+    x1: number;
+    x2: number;
+    y: number;
+}
+export interface TerminalStyleSpan extends TerminalSelectionRange {
+    kind: "selection" | "focus" | "highlight" | (string & {});
+}
+export interface TerminalFrame {
+    lines: string[];
+    hitboxes: TerminalHitbox[];
+    cursor: CursorPosition | null;
+    spans: TerminalStyleSpan[];
+}
+export interface InputInteractionState {
+    cursor: number;
+    anchor: number;
+}
+export interface TerminalClipboardAdapter {
+    readText?(): string | undefined;
+    writeText?(value: string): void;
+}
+export interface TerminalFocusableProps {
+    id?: string;
+    focusable?: boolean;
+}
+export interface TerminalPointerCaptureProps {
+    pointerCapture?: boolean;
+}
+export interface TerminalDirectiveProps {
+    "v-for"?: any[];
+}
+export interface TerminalLayoutProps extends TerminalFocusableProps {
+    direction?: "row" | "column";
+    gap?: number;
+    padding?: number;
+    border?: boolean;
+    width?: number;
+    height?: number;
+}
+export interface TerminalEventPayloadBase {
+    id: string;
+}
+export interface TerminalValueEventPayloadBase<T = string> extends TerminalEventPayloadBase {
+    value: T;
+}
+export interface TerminalInputChangeEventPayload extends TerminalValueEventPayloadBase<string> {
+    type: "change" | "input";
+}
+export interface TerminalInputSubmitEventPayload extends TerminalValueEventPayloadBase<string> {
+    type: "submit";
+}
+export interface TerminalButtonPressEventPayload extends TerminalEventPayloadBase {
+    type: "press" | "click";
+}
+export interface TerminalListChangeEventPayload<T = any> extends TerminalValueEventPayloadBase<T> {
+    type: "change";
+    index: number;
+}
+export interface TerminalListPressEventPayload<T = any> extends TerminalValueEventPayloadBase<T> {
+    type: "press";
+    index: number;
+}
+export type TerminalChangeEventPayload = TerminalInputChangeEventPayload | TerminalListChangeEventPayload<any>;
+export type TerminalPressEventPayload = TerminalButtonPressEventPayload | TerminalListPressEventPayload<any>;
+export type TerminalMouseEventType = "hover" | "rowenter" | "rowleave";
+export type TerminalPointerSource = "press" | "drag" | "release";
+export interface TerminalPointerCoordinates {
+    x: number | null;
+    y: number | null;
+}
+export interface TerminalRowPointerEventPayloadBase extends TerminalPointerCoordinates {
+    id: string;
+    row: number;
+}
+export interface TerminalListPointerEventPayload<T = any> extends TerminalRowPointerEventPayloadBase {
+    type: TerminalMouseEventType;
+    index: number;
+    value: T;
+}
+export interface TerminalScrollPointerEventPayload extends TerminalRowPointerEventPayloadBase {
+    type: TerminalMouseEventType;
+    value: string;
+}
+export type TerminalRowPointerEventPayload = TerminalListPointerEventPayload<any> | TerminalScrollPointerEventPayload;
+export interface TerminalCaptureEventPayload extends TerminalPointerCoordinates {
+    type: "capturestart" | "captureend";
+    id: string;
+    source: TerminalPointerSource;
+    row: number | null;
+}
+export interface TerminalInputProps extends TerminalFocusableProps {
+    value?: string;
+    placeholder?: string;
+    onchange?(event: TerminalInputChangeEventPayload): void;
+    oninput?(event: TerminalInputChangeEventPayload): void;
+    onsubmit?(event: TerminalInputSubmitEventPayload): void;
+    onChangeText?(value: string): void;
+}
+export interface TerminalButtonProps extends TerminalFocusableProps {
+    label?: string;
+    onpress?(event: TerminalButtonPressEventPayload): void;
+    onclick?(event: TerminalButtonPressEventPayload): void;
+    action?(event: TerminalButtonPressEventPayload): void;
+    onPress?(event: TerminalButtonPressEventPayload): void;
+}
+export interface TerminalListProps<T = any> extends TerminalFocusableProps, TerminalPointerCaptureProps {
+    items?: T[];
+    renderItem?(item: T, index: number): string;
+    onchange?(event: TerminalListChangeEventPayload<T>): void;
+    onpress?(event: TerminalListPressEventPayload<T>): void;
+    onhover?(event: TerminalListPointerEventPayload<T>): void;
+    onrowenter?(event: TerminalListPointerEventPayload<T>): void;
+    onrowleave?(event: TerminalListPointerEventPayload<T>): void;
+    oncapturestart?(event: TerminalCaptureEventPayload): void;
+    oncaptureend?(event: TerminalCaptureEventPayload): void;
+}
+export interface TerminalScrollViewProps extends TerminalLayoutProps, TerminalPointerCaptureProps {
+    highlightRows?: number[];
+    onhover?(event: TerminalScrollPointerEventPayload): void;
+    onrowenter?(event: TerminalScrollPointerEventPayload): void;
+    onrowleave?(event: TerminalScrollPointerEventPayload): void;
+    oncapturestart?(event: TerminalCaptureEventPayload): void;
+    oncaptureend?(event: TerminalCaptureEventPayload): void;
+}
+export interface TerminalScreenProps extends TerminalFocusableProps {
+    title?: string;
+}
+export interface TerminalBoxProps extends TerminalLayoutProps {
+}
+export interface TerminalViewProps extends TerminalLayoutProps {
+    role?: string;
+}
+export interface TerminalTextProps {
+    value?: any;
+}
+export interface TerminalTableProps extends TerminalDirectiveProps {
+}
+export interface TerminalRowProps {
+    separator?: string;
+}
+export interface TerminalTdProps {
+    padding?: number;
+}
+export interface TerminalSession {
+    update(): string;
+    output(): string;
+    ansiOutput(): string;
+    tree(): TerminalNode[];
+    focus(id: string): boolean;
+    focusAt(x: number, y: number): boolean;
+    focusNext(): boolean;
+    focusPrev(): boolean;
+    dispatchKey(key: string): string;
+    click(id?: string): string;
+    clickAt(x: number, y: number): string;
+    clipboard(): string;
+    setClipboard(value: string): string;
+    selectAll(): string;
+    destroy(): void;
+}
+export interface TerminalMountOptions {
+    ansi?: boolean;
+    clipboard?: TerminalClipboardAdapter | false;
+    stdin?: {
+        on(event: "data", listener: (chunk: string | Uint8Array) => void): any;
+        off?(event: "data", listener: (chunk: string | Uint8Array) => void): any;
+        removeListener?(event: "data", listener: (chunk: string | Uint8Array) => void): any;
+        setRawMode?(value: boolean): void;
+        resume?(): void;
+        pause?(): void;
+    };
+    stdout?: {
+        write(chunk: string): any;
+    };
+}
+export type ParsedTerminalInput = {
+    type: "key";
+    key: string;
+} | {
+    type: "mouse";
+    x: number;
+    y: number;
+    button: number;
+    action: "press" | "release" | "drag" | "wheel-up" | "wheel-down";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/docs/api-reference.md

@@ -0,0 +1,273 @@
+# API Reference
+
+Referencia de la superficie publica real publicada por `valyrianjs-terminal`.
+
+## Entrypoints publicados
+
+### `valyrianjs-terminal`
+
+Entrada principal. Expone a alto nivel:
+
+- `renderTerminal()`
+- `mountTerminal()`
+- primitivas `Screen`, `Box`, `View`, `Text`, `Input`, `Button`, `ScrollView`, `List`, `Table`, `Row`, `Td`
+- tipos de props, eventos, nodos y sesion
+
+### `valyrianjs-terminal/render`
+
+Subpath publicado para utilidades de render de bajo nivel.
+
+- `renderTerminal(input): string`
+- `renderTerminalNode(node): string`
+- `renderTerminalFrame(node): TerminalFrame`
+
+Usa este subpath cuando solo necesites transformar nodos terminales a texto o `TerminalFrame`, sin montar una sesion interactiva.
+
+## Funciones principales
+
+### `renderTerminal(input): string`
+
+Resuelve la raiz recibida y devuelve la salida terminal en texto plano.
+
+Casos de uso respaldados por la implementacion actual:
+
+- snapshots y pruebas
+- validacion de layout sin `stdin` ni `stdout`
+- inspeccion de contenido en modo no interactivo
+
+Notas:
+
+- concatena los nodos raiz con saltos de linea
+- elimina solo el whitespace final con `trimEnd()`
+- no crea listeners ni estado interactivo
+
+### `mountTerminal(input, options?): TerminalSession`
+
+Monta una sesion interactiva sobre el arbol terminal y devuelve un `TerminalSession`.
+
+Comportamiento de alto nivel:
+
+- resuelve el arbol actual y lo rerenderiza con `session.update()`
+- administra foco por `id`
+- procesa teclado, mouse, seleccion y clipboard
+- puede escribir automaticamente a `stdout` si se provee
+- si recibe `stdin`, activa raw mode al montar y lo revierte en `destroy()`
+
+## `TerminalMountOptions`
+
+- `ansi?: boolean` - si hay `stdout`, escribe diffs ANSI en vez de texto plano
+- `clipboard?: TerminalClipboardAdapter | false` - adapter custom o desactiva el clipboard del sistema
+- `stdin?` - stream con `on("data")`; `off()`, `removeListener()`, `setRawMode()`, `resume()` y `pause()` son opcionales
+- `stdout?` - writer con `write(chunk: string)`
+
+## Primitivas de layout
+
+### `Screen`
+
+Props de `TerminalScreenProps`:
+
+- `title?: string`
+
+Funcion: contenedor raiz. Si `title` existe, se renderiza como primera linea del frame.
+
+### `Box`
+
+Props de `TerminalBoxProps`:
+
+- `direction?: "row" | "column"`
+- `gap?: number`
+- `padding?: number`
+- `border?: boolean`
+- `width?: number`
+- `height?: number`
+- `id?: string`
+- `focusable?: boolean`
+
+Funcion: contenedor de layout. En `row` compone horizontalmente; en `column`, verticalmente.
+
+### `View`
+
+Props de `TerminalViewProps`:
+
+- todas las props de layout de `Box`
+- `role?: string`
+
+Funcion: contenedor semantico equivalente a `terminal-view`.
+
+### `Text`
+
+Props de `TerminalTextProps`:
+
+- `value?: any`
+
+Funcion: renderiza `value` o el texto concatenado de sus hijos. Si hay saltos de linea, se preservan.
+
+### `Table`
+
+Props de `TerminalTableProps`:
+
+- `v-for?: any[]`
+
+Funcion: compone filas y calcula automaticamente el ancho maximo por columna.
+
+### `Row`
+
+Props de `TerminalRowProps`:
+
+- `separator?: string`
+
+Funcion: une celdas usando `separator` o `" | "` por default.
+
+### `Td`
+
+Props de `TerminalTdProps`:
+
+- `padding?: number`
+
+Funcion: envuelve el contenido de la celda y aplica padding interno si se define.
+
+## Primitivas interactivas
+
+Todas dependen de `id` para participar completamente en foco, hitboxes, busqueda por coordenadas y varios helpers de `TerminalSession`.
+
+### `Input`
+
+Props de `TerminalInputProps`:
+
+- `id?: string`
+- `focusable?: boolean`
+- `value?: string`
+- `placeholder?: string`
+- `onchange?(event)`
+- `oninput?(event)`
+- `onsubmit?(event)`
+- `onChangeText?(value)`
+
+Soporte actual de interaccion:
+
+- cursor y seleccion de texto
+- `LEFT`, `RIGHT`, `SHIFT_LEFT`, `SHIFT_RIGHT`
+- `ALT_LEFT`, `ALT_RIGHT`, `HOME`, `END`
+- `CTRL_A`, `CTRL_C`, `CTRL_X`, `CTRL_V`
+- `BACKSPACE`, `DELETE`, escritura de caracteres y `ENTER`
+
+Payloads importantes:
+
+- `TerminalInputChangeEventPayload` - `{ type: "change" | "input", id, value }`
+- `TerminalInputSubmitEventPayload` - `{ type: "submit", id, value }`
+
+### `Button`
+
+Props de `TerminalButtonProps`:
+
+- `id?: string`
+- `focusable?: boolean`
+- `label?: string`
+- `onpress?(event)`
+- `onclick?(event)`
+- `action?(event)`
+- `onPress?(event)`
+
+Activacion actual:
+
+- `session.click(id?)`
+- `session.clickAt(x, y)`
+- `dispatchKey("ENTER")` o `dispatchKey("SPACE")` cuando el foco esta en el boton
+
+Payload importante:
+
+- `TerminalButtonPressEventPayload` - `{ type: "press" | "click", id }`
+
+### `List<T>`
+
+Props de `TerminalListProps<T>`:
+
+- `id?: string`
+- `focusable?: boolean`
+- `pointerCapture?: boolean`
+- `items?: T[]`
+- `renderItem?(item, index): string`
+- `onchange?(event)`
+- `onpress?(event)`
+- `onhover?(event)`
+- `onrowenter?(event)`
+- `onrowleave?(event)`
+- `oncapturestart?(event)`
+- `oncaptureend?(event)`
+
+Interaccion actual:
+
+- `UP` y `LEFT` mueven la seleccion hacia arriba
+- `DOWN` y `RIGHT` mueven la seleccion hacia abajo
+- `ENTER` dispara `onpress`
+- el hover por mouse expone fila, indice y valor
+
+Payloads importantes:
+
+- `TerminalListChangeEventPayload<T>` - `{ type: "change", id, index, value }`
+- `TerminalListPressEventPayload<T>` - `{ type: "press", id, index, value }`
+- `TerminalListPointerEventPayload<T>` - `{ type: "hover" | "rowenter" | "rowleave", id, row, index, value, x, y }`
+- `TerminalCaptureEventPayload` - `{ type: "capturestart" | "captureend", id, source, row, x, y }`
+
+### `ScrollView`
+
+Props de `TerminalScrollViewProps`:
+
+- props de layout (`direction`, `gap`, `padding`, `border`, `width`, `height`, `id`, `focusable`)
+- `pointerCapture?: boolean`
+- `highlightRows?: number[]`
+- `onhover?(event)`
+- `onrowenter?(event)`
+- `onrowleave?(event)`
+- `oncapturestart?(event)`
+- `oncaptureend?(event)`
+
+Interaccion actual:
+
+- `UP` y `DOWN` ajustan el offset vertical cuando tiene foco
+- el render recorta el contenido visible segun `height`
+- `highlightRows` marca filas visibles concretas
+- el hover por mouse expone fila visible y texto renderizado
+
+Payloads importantes:
+
+- `TerminalScrollPointerEventPayload` - `{ type: "hover" | "rowenter" | "rowleave", id, row, value, x, y }`
+- `TerminalCaptureEventPayload` - `{ type: "capturestart" | "captureend", id, source, row, x, y }`
+
+## `TerminalSession`
+
+Contrato publico de la sesion interactiva.
+
+- `update(): string` - vuelve a resolver la raiz y retorna la salida actual en texto plano
+- `output(): string` - devuelve el ultimo frame plano renderizado
+- `ansiOutput(): string` - devuelve el frame actual serializado con ANSI
+- `tree(): TerminalNode[]` - expone el arbol terminal resuelto actual
+- `focus(id: string): boolean` - enfoca un nodo interactivo por `id`
+- `focusAt(x: number, y: number): boolean` - enfoca por hitbox calculado
+- `focusNext(): boolean` - recorre el foco en orden de render
+- `focusPrev(): boolean` - recorre el foco hacia atras
+- `dispatchKey(key: string): string` - inyecta una tecla normalizada y devuelve la salida actual
+- `click(id?: string): string` - activa el boton enfocado o uno especifico por `id`
+- `clickAt(x: number, y: number): string` - activa o enfoca usando coordenadas
+- `clipboard(): string` - devuelve el ultimo valor de clipboard conocido por la sesion
+- `setClipboard(value: string): string` - actualiza el clipboard interno y, si existe, el adapter
+- `selectAll(): string` - selecciona todo el contenido del `Input` enfocado
+- `destroy(): void` - desmonta listeners de `stdin`, sale de raw mode y pausa el stream si aplica
+
+## Tipos utilitarios relevantes
+
+- `TerminalMountOptions` - opciones para montar la sesion
+- `TerminalClipboardAdapter` - contrato minimo para integrar clipboard externo
+- `TerminalFrame` - frame renderizado con `lines`, `hitboxes`, `cursor` y `spans`
+- `TerminalHitbox` - region interactiva calculada para foco y clicks por coordenadas
+- `TerminalStyleSpan` - marca visual como `selection`, `focus` o `highlight`
+- `TerminalNode`, `TerminalElementNode`, `TerminalTextNode` - arbol terminal resuelto
+- `TerminalLayoutProps` - base comun para `Box`, `View` y `ScrollView`
+- `TerminalFocusableProps` - `id` y `focusable`
+- `TerminalPointerCaptureProps` - `pointerCapture` para listas y scroll
+- `InputInteractionState` - posicion de cursor y ancla de seleccion
+- `TerminalChangeEventPayload` - union de cambios de `Input` y `List`
+- `TerminalPressEventPayload` - union de presses de `Button` y `List`
+- `TerminalPointerCoordinates` - coordenadas `x` y `y` opcionales en payloads de mouse
+- `TerminalMouseEventType` - `"hover" | "rowenter" | "rowleave"`
+- `TerminalPointerSource` - `"press" | "drag" | "release"`