@valyrianjs/terminal 0.1.1 → 0.2.0

package/README.md

@@ -1,71 +1,121 @@
-# valyrianjs-terminal
+# ValyrianJS Terminal
 
-Terminal-first adapter for `valyrian.js`. It lets you render text UIs with its own primitives and, when needed, mount interactive sessions on top of `stdin` and `stdout`.
+Terminal UI primitives and runtime helpers for Valyrian.js. Use it to render terminal trees as plain text, or mount an interactive session that handles focus, keyboard input, mouse input, clipboard integration, and terminal output.
 
-## What It Solves
+This package is for developers building text-based interfaces with Valyrian components. It focuses on terminal rendering and interaction, so your app can compose its own routing, commands, data loading, persistence, and application state around a clear terminal UI layer.
 
-- terminal-first layout with `Screen`, `Box`, `View`, `Text`, `Table`, `Row`, and `Td`
-- interactive primitives with `Input`, `Button`, `List`, and `ScrollView`
-- static text rendering with `renderTerminal()`
-- interactive runtime with `mountTerminal()`
-
-## Installation
+## Install
 
 ```bash
-npm install valyrianjs-terminal valyrian.js
+npm install @valyrianjs/terminal valyrian.js
 ```
 
-## Choose the Right Entrypoint
-
-- Use `renderTerminal()` for snapshots, tests, or non-interactive output.
-- Use `mountTerminal()` when you need focus, keyboard, mouse, clipboard, or writes to `stdout`.
-
-## Minimal Example
-
-```tsx
-/** @jsx v */
-/** @jsxFrag v.fragment */
-
-import { v } from "valyrian.js";
-import { Input, Screen, Text, mountTerminal } from "valyrianjs-terminal";
+## JSX config
 
-const state = { value: "" };
+For TSX, use Valyrian's automatic JSX runtime:
 
-const session = mountTerminal(() => (
-  <Screen title="Notes">
-    <Input
-      id="note"
-      value={state.value}
-      placeholder="Write a note"
-      onchange={(event) => {
-        state.value = event.value;
-      }}
-    />
-    <Text>{state.value || "Nothing yet"}</Text>
-  </Screen>
-));
-
-session.focus("note");
+```json
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "valyrian.js"
+  }
+}
 ```
 
-## Docs Map
-
-- `docs/getting-started.md` - first complete flow, from static rendering to an interactive session
-- `docs/core-concepts.md` - mental model: ids, focus, hitboxes, plain output, ANSI, and cleanup
-- `docs/interaction-model.md` - behavior of each primitive and interaction events
-- `docs/session-runtime.md` - session lifecycle, streams, clipboard, coordinates, and runtime
-- `docs/cookbook.md` - short recipes for concrete tasks
-- `docs/api-reference.md` - reference for the public surface and published subpaths
-- `docs/local-demo.md` - repo-local demo, not part of the published package
+## Smallest useful example
 
-## Published Package Scope
+Full example: [`examples/docs/interactive-note.tsx`](./examples/docs/interactive-note.tsx)
 
-The published package includes the compiled adapter in `dist/`, this documentation, and supporting metadata. Files in `examples/` live only in the repo and are not part of the distributed package.
+```tsx
+import { Input, Screen, Text, mountTerminal } from "@valyrianjs/terminal";
 
-## Local Development
+const state = { value: "" };
 
-```bash
-bun test
-bun run typecheck
-bun run build
+function App() {
+  return (
+    <Screen title="Quick note">
+      <Text>Type a note. Ctrl+C: exit.</Text>
+      <Input
+        id="note"
+        value={state.value}
+        placeholder="Write a note"
+        onchange={(event) => {
+          state.value = event.value;
+        }}
+      />
+      <Text>{state.value ? `Draft: ${state.value}` : "Draft: empty"}</Text>
+    </Screen>
+  );
+}
+
+if (import.meta.main) {
+  const session = mountTerminal(<App />);
+  session.focus("note");
+}
 ```
+
+![Quick note terminal result](./docs/assets/quick-note.svg)
+
+Use `renderTerminal()` for deterministic static output. Use `mountTerminal()` for interactive sessions with focus, keyboard input, lifecycle, and repeated renders. Use [Session Runtime](./docs/session-runtime.md) when streams, resize events, clipboard adapters, or mouse input are part of the host integration.
+
+## Docs
+
+- [Getting Started](./docs/getting-started.md) - build a first working terminal UI with `main.tsx`, `renderTerminal()`, and `mountTerminal()`.
+- [Core Concepts](./docs/core-concepts.md) - mental model for primitives, state, ids, focus, output, and cleanup.
+- [Cookbook](./docs/cookbook.md) - practical recipes for input, lists, state, Valyrian.js modules, overlays, logs, and full-terminal layout.
+- [Primitive Gallery](./docs/primitive-gallery.md) - choose and compose `Screen`, layout, input, collection, activity, and overlay primitives with complete mini apps.
+- [Interaction Model](./docs/interaction-model.md) - keyboard, focus, event payloads, mouse, and composed interaction behavior.
+- [Session Runtime](./docs/session-runtime.md) - common runtime usage and advanced host integration details.
+- [Valyrian Modules](./docs/valyrian-modules.md) - terminal app patterns for Valyrian.js state, request, query, tasks, forms, persistence, formatting, and utilities.
+- [API Reference](./docs/api-reference.md) - public functions, props, payloads, and session methods.
+
+Primitive Gallery maps every public terminal primitive to practical use and complete demos. Try these next:
+
+- **Operations Workspace**: `bun examples/docs/primitive-layout-shell.tsx`
+- **Ticket Intake**: `bun examples/docs/primitive-input-workbench.tsx`
+- **Service Explorer**: `bun examples/docs/primitive-data-explorer.tsx`
+- **Activity Console**: `bun examples/docs/primitive-activity-console.tsx`
+- **Command Panel**: `bun examples/docs/primitive-command-panel.tsx`
+
+Each example exits with `Ctrl+C`.
+
+Valyrian.js modules can power complete terminal apps for state, forms, API calls, async work, formatting, i18n, persistence, and utilities while `@valyrianjs/terminal` renders the interface. See [Valyrian.js modules in terminal apps](./docs/valyrian-modules.md), then run **Operations Workbench** with `bun examples/docs/module-state-workbench.tsx`, **API Operations Dashboard** with `bun examples/docs/module-api-dashboard.tsx`, or **Billing/Settings Wizard** with `bun examples/docs/module-form-workflow.tsx`; each exits with `Ctrl+C`.
+
+Core controls use app-like visual defaults from the bundled theme, so buttons, inputs, and lists do not need per-example ASCII chrome. Style examples: [`examples/docs/style-system.tsx`](./examples/docs/style-system.tsx) shows `theme.styles`, `style`, `styles`, and `state` in a runnable ANSI terminal app. Run it with `bun examples/docs/style-system.tsx`, use `Tab`, `Enter`, and `W` to change state, and quit with `Ctrl+C`. Layout examples: [`examples/docs/responsive-split.tsx`](./examples/docs/responsive-split.tsx) shows context-aware `Split` sizing, percent, `fr`, and local split breakpoints. For a full-screen pizza builder with responsive `Split` fractions and simulated checkout, run `bun examples/docs/pizza-builder.tsx`, try `Up/Down`, `Space`, `Enter`, `R`, and `C`, and quit with `Ctrl+C`; or open [`examples/docs/pizza-builder.tsx`](./examples/docs/pizza-builder.tsx).
+
+## Run the docs examples
+
+Each docs example runs directly as a small terminal app. Use the command shown, try the listed keys, and quit with `Ctrl+C`.
+
+| Example | Run | Try |
+| --- | --- | --- |
+| [`examples/docs/hello.tsx`](./examples/docs/hello.tsx) | `bun examples/docs/hello.tsx` | `Enter`, `Ctrl+C` |
+| [`examples/docs/interactive-note.tsx`](./examples/docs/interactive-note.tsx) | `bun examples/docs/interactive-note.tsx` | type a note, `Enter`, `Ctrl+C` |
+| [`examples/docs/component-composition.tsx`](./examples/docs/component-composition.tsx) | `bun examples/docs/component-composition.tsx` | `N/P`, `Ctrl+C` |
+| [`examples/docs/employees-list.tsx`](./examples/docs/employees-list.tsx) | `bun examples/docs/employees-list.tsx` | `J/K` or arrows, `Ctrl+C` |
+| [`examples/docs/theme-colors.tsx`](./examples/docs/theme-colors.tsx) | `bun examples/docs/theme-colors.tsx` | `Tab`, `Ctrl+C` |
+| [`examples/docs/style-system.tsx`](./examples/docs/style-system.tsx) | `bun examples/docs/style-system.tsx` | `Tab`, `Enter`, `W`, `Ctrl+C` |
+| [`examples/docs/responsive-split.tsx`](./examples/docs/responsive-split.tsx) | `bun examples/docs/responsive-split.tsx` | resize terminal, `Ctrl+C` |
+| [`examples/docs/pizza-builder.tsx`](./examples/docs/pizza-builder.tsx) | `bun examples/docs/pizza-builder.tsx` | `Up/Down`, `Space`, `Enter`, `R`, `C`, `Ctrl+C` |
+| [`examples/docs/background-fill.tsx`](./examples/docs/background-fill.tsx) | `bun examples/docs/background-fill.tsx` | `B`, `Ctrl+C` |
+| [`examples/docs/cursor.tsx`](./examples/docs/cursor.tsx) | `bun examples/docs/cursor.tsx` | type text, `C`, `Ctrl+C` |
+| Operations Workspace ([`examples/docs/primitive-layout-shell.tsx`](./examples/docs/primitive-layout-shell.tsx)) | `bun examples/docs/primitive-layout-shell.tsx` | resize terminal, `Ctrl+C` |
+| Ticket Intake ([`examples/docs/primitive-input-workbench.tsx`](./examples/docs/primitive-input-workbench.tsx)) | `bun examples/docs/primitive-input-workbench.tsx` | type summary, `Tab`, `Enter`, `Ctrl+C` |
+| Service Explorer ([`examples/docs/primitive-data-explorer.tsx`](./examples/docs/primitive-data-explorer.tsx)) | `bun examples/docs/primitive-data-explorer.tsx` | `J/K`, `Ctrl+C` |
+| Activity Console ([`examples/docs/primitive-activity-console.tsx`](./examples/docs/primitive-activity-console.tsx)) | `bun examples/docs/primitive-activity-console.tsx` | `Enter`, `Up/Down`, `Ctrl+C` |
+| Command Panel ([`examples/docs/primitive-command-panel.tsx`](./examples/docs/primitive-command-panel.tsx)) | `bun examples/docs/primitive-command-panel.tsx` | type filter, `Up/Down`, `Enter`, `Ctrl+C` |
+| Terminal Command Palette ([`examples/docs/module-valyrian-core.tsx`](./examples/docs/module-valyrian-core.tsx)) | `bun examples/docs/module-valyrian-core.tsx` | `J/K`, `Enter`, `R`, `Ctrl+C` |
+| Live Shift/Ticket Counter ([`examples/docs/module-pulses.tsx`](./examples/docs/module-pulses.tsx)) | `bun examples/docs/module-pulses.tsx` | `A`, `D`, `P`, `R`, `Ctrl+C` |
+| Operations Queue Manager ([`examples/docs/module-flux-store.tsx`](./examples/docs/module-flux-store.tsx)) | `bun examples/docs/module-flux-store.tsx` | `J/K`, `S`, `D`, `B`, `R`, `Ctrl+C` |
+| Service Status Client ([`examples/docs/module-request.tsx`](./examples/docs/module-request.tsx)) | `bun examples/docs/module-request.tsx` | `R`, `E`, `Ctrl+C` |
+| Cached Inventory Browser ([`examples/docs/module-query.tsx`](./examples/docs/module-query.tsx)) | `bun examples/docs/module-query.tsx` | `F`, `I`, `J/K`, `Ctrl+C` |
+| Background Maintenance Runner ([`examples/docs/module-tasks.tsx`](./examples/docs/module-tasks.tsx)) | `bun examples/docs/module-tasks.tsx` | `R`, `C`, `X`, `Z`, `Ctrl+C` |
+| Profile Editor ([`examples/docs/module-forms.tsx`](./examples/docs/module-forms.tsx)) | `bun examples/docs/module-forms.tsx` | type fields, `Enter`, `R`, `Ctrl+C` |
+| Persistent Workspace Settings ([`examples/docs/module-native-store.tsx`](./examples/docs/module-native-store.tsx)) | `bun examples/docs/module-native-store.tsx` | type workspace, `Enter`, `R`, `Ctrl+C` |
+| Bilingual Support Console ([`examples/docs/module-translate.tsx`](./examples/docs/module-translate.tsx)) | `bun examples/docs/module-translate.tsx` | `L`, `J/K`, `F`, `Ctrl+C` |
+| Invoice Calculator ([`examples/docs/module-money.tsx`](./examples/docs/module-money.tsx)) | `bun examples/docs/module-money.tsx` | `J/K`, `+/-`, `D`, `L`, `Ctrl+C` |
+| Account Data Inspector ([`examples/docs/module-utils.tsx`](./examples/docs/module-utils.tsx)) | `bun examples/docs/module-utils.tsx` | `J/K`, `F`, `R`, `Ctrl+C` |
+| Operations Workbench ([`examples/docs/module-state-workbench.tsx`](./examples/docs/module-state-workbench.tsx)) | `bun examples/docs/module-state-workbench.tsx` | `J/K`, `Enter`, `D`, `B`, `R`, `Ctrl+C` |
+| API Operations Dashboard ([`examples/docs/module-api-dashboard.tsx`](./examples/docs/module-api-dashboard.tsx)) | `bun examples/docs/module-api-dashboard.tsx` | `R`, `E`, `I`, `T`, `C`, `Ctrl+C` |
+| Billing/Settings Wizard ([`examples/docs/module-form-workflow.tsx`](./examples/docs/module-form-workflow.tsx)) | `bun examples/docs/module-form-workflow.tsx` | `N`, `L`, `S/Enter`, `R`, `X`, `Ctrl+C` |

package/dist/ansi.d.ts

@@ -1,6 +1,22 @@
-import type { CursorPosition, TerminalFrame, TerminalStyleSpan } from "./types.js";
+import type { CursorPosition, TerminalFrame, TerminalStyleSpan, TerminalTheme } from "./types.js";
+export declare const ANSI_ENTER_ALTERNATE_SCREEN = "\u001B[?1049h";
+export declare const ANSI_EXIT_ALTERNATE_SCREEN = "\u001B[?1049l";
+export declare const ANSI_HIDE_CURSOR = "\u001B[?25l";
+export declare const ANSI_SHOW_CURSOR = "\u001B[?25h";
+type AnsiFrameOptions = {
+    showCursor?: boolean;
+    showCursorWhenFrameHasCursor?: boolean;
+    theme?: TerminalTheme;
+};
+export type AnsiFrameDiffResult = {
+    changedLineIndexes: number[];
+    outputChunk: string;
+    restoresCursor: boolean;
+};
 export declare function stripCursorMarker(value: string): string;
-export declare function formatPlainFrame(frame: TerminalFrame): string;
-export declare function toAnsiFrame(lines: string[], cursor: CursorPosition | null, spans?: TerminalStyleSpan[]): string;
-export declare function createAnsiDiffWriter(): (lines: string[], cursor: CursorPosition | null, spans?: TerminalStyleSpan[]) => string;
+export declare function formatPlainFrame(frame: TerminalFrame, options?: AnsiFrameOptions): string;
+export declare function toAnsiFrame(lines: string[], cursor: CursorPosition | null, spans?: TerminalStyleSpan[], options?: AnsiFrameOptions): string;
+export declare function createAnsiFrameDiff(previousAnsiLines: string[], nextAnsiLines: string[], cursor: CursorPosition | null, options?: AnsiFrameOptions): AnsiFrameDiffResult;
+export declare function createAnsiDiffWriter(options?: AnsiFrameOptions): (lines: string[], cursor: CursorPosition | null, spans?: TerminalStyleSpan[]) => string;
+export {};
 //# sourceMappingURL=ansi.d.ts.map

package/dist/ansi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,UAE9C;AA6FD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,UAEpD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,KAAK,GAAE,iBAAiB,EAAO,UAI1G;AAED,wBAAgB,oBAAoB,KAGP,OAAO,MAAM,EAAE,EAAE,QAAQ,cAAc,GAAG,IAAI,EAAE,QAAO,iBAAiB,EAAO,YAe3G"}
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElG,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAC3D,eAAO,MAAM,0BAA0B,kBAAkB,CAAC;AAC1D,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAE9C,KAAK,gBAAgB,GAAG;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,UAE9C;AAiMD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,gBAAqB,UAEpF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,KAAK,GAAE,iBAAiB,EAAO,EAAE,OAAO,GAAE,gBAAqB,UAK1I;AAED,wBAAgB,mBAAmB,CACjC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,OAAO,GAAE,gBAAqB,GAC7B,mBAAmB,CA0BrB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,gBAAqB,IAGtC,OAAO,MAAM,EAAE,EAAE,QAAQ,cAAc,GAAG,IAAI,EAAE,QAAO,iBAAiB,EAAO,YAM3G"}

package/dist/ansi.js

@@ -1,41 +1,91 @@
+import { resolveTerminalStyle, resolveTerminalStyleToken } from "./theme.js";
+export const ANSI_ENTER_ALTERNATE_SCREEN = "\u001b[?1049h";
+export const ANSI_EXIT_ALTERNATE_SCREEN = "\u001b[?1049l";
+export const ANSI_HIDE_CURSOR = "\u001b[?25l";
+export const ANSI_SHOW_CURSOR = "\u001b[?25h";
 export function stripCursorMarker(value) {
     return value.replaceAll("|", "");
 }
+function spanLayerPriority(span) {
+    return span.kind === "focus" ? 0 : 1;
+}
 function lineSpans(spans, y) {
-    return spans.filter((span) => span.y === y).sort((a, b) => a.x1 - b.x1);
+    return spans
+        .map((span, index) => ({ span, index }))
+        .filter(({ span }) => span.y === y)
+        .sort((a, b) => a.span.x1 - b.span.x1 || spanLayerPriority(a.span) - spanLayerPriority(b.span) || b.span.x2 - a.span.x2 || a.index - b.index)
+        .map(({ span }) => span);
 }
-function spanAnsiOpen(kind) {
-    if (kind === "selection" || kind === "focus" || kind === "current-row") {
-        return "\u001b[7m";
-    }
-    if (kind === "hover") {
-        return "\u001b[4m";
+function tokenStyle(token) {
+    if (!token)
+        return undefined;
+    return token.style || token.color || token.background
+        ? { ...token.style, color: token.color ?? token.style?.color, background: token.background ?? token.style?.background }
+        : undefined;
+}
+function styleAnsiOpen(style) {
+    return `${colorAnsi(style?.color, false)}${colorAnsi(style?.background, true)}`;
+}
+function styleAnsiClose(style) {
+    return `${style?.background ? "\u001b[49m" : ""}${style?.color ? "\u001b[39m" : ""}`;
+}
+function spanAnsiOpen(span, theme) {
+    const { kind, style } = span;
+    if (style)
+        return styleAnsiOpen(style);
+    const token = resolveTerminalStyleToken(kind, theme);
+    const resolvedTokenStyle = tokenStyle(token);
+    if (resolvedTokenStyle)
+        return styleAnsiOpen(resolvedTokenStyle);
+    if (token?.ansiOpen)
+        return token.ansiOpen;
+    try {
+        return styleAnsiOpen(resolveTerminalStyle(kind, theme));
     }
-    if (kind === "highlight") {
-        return "\u001b[1m";
+    catch {
+        return "";
     }
-    return "";
 }
-function spanAnsiClose(kind) {
-    if (kind === "selection" || kind === "focus" || kind === "current-row") {
-        return "\u001b[27m";
+function spanAnsiClose(span, theme) {
+    const { kind, style } = span;
+    if (style)
+        return styleAnsiClose(style);
+    const token = resolveTerminalStyleToken(kind, theme);
+    const resolvedTokenStyle = tokenStyle(token);
+    if (resolvedTokenStyle)
+        return styleAnsiClose(resolvedTokenStyle);
+    if (token?.ansiClose)
+        return token.ansiClose;
+    try {
+        return styleAnsiClose(resolveTerminalStyle(kind, theme));
     }
-    if (kind === "hover") {
-        return "\u001b[24m";
+    catch {
+        return "";
     }
-    if (kind === "highlight") {
-        return "\u001b[22m";
+}
+function colorAnsi(value, background) {
+    if (!value)
+        return "";
+    const hex = value.startsWith("#") ? value.slice(1) : "";
+    const full = hex.length === 3
+        ? hex.split("").map((part) => part + part).join("")
+        : hex;
+    if (!/^[0-9a-fA-F]{6}$/.test(full)) {
+        throw new RangeError(`Unsupported terminal style color: ${value}`);
     }
-    return "";
+    const red = Number.parseInt(full.slice(0, 2), 16);
+    const green = Number.parseInt(full.slice(2, 4), 16);
+    const blue = Number.parseInt(full.slice(4, 6), 16);
+    return `\u001b[${background ? 48 : 38};2;${red};${green};${blue}m`;
 }
-function renderAnsiLine(line, spans, y) {
+function renderAnsiLine(line, spans, y, theme) {
     let output = "";
     let visibleColumn = 1;
     const rowSpans = lineSpans(spans, y);
     let activeSpanIndex = 0;
     for (let i = 0; i < line.length; i += 1) {
         while (rowSpans[activeSpanIndex]?.x1 === visibleColumn) {
-            output += spanAnsiOpen(rowSpans[activeSpanIndex].kind);
+            output += spanAnsiOpen(rowSpans[activeSpanIndex], theme);
             activeSpanIndex += 1;
         }
         const char = line[i];
@@ -46,60 +96,134 @@ function renderAnsiLine(line, spans, y) {
         visibleColumn += 1;
         for (const span of rowSpans) {
             if (span.x2 === visibleColumn) {
-                output += spanAnsiClose(span.kind);
+                if (span.kind !== "focus") {
+                    output += spanAnsiClose(span, theme);
+                }
+            }
+        }
+        for (const span of rowSpans) {
+            if (span.x2 === visibleColumn && span.kind === "focus") {
+                output += spanAnsiClose(span, theme);
+            }
+        }
+    }
+    for (const span of rowSpans) {
+        if (span.x1 < visibleColumn && span.x2 > visibleColumn) {
+            if (span.kind !== "focus") {
+                output += spanAnsiClose(span, theme);
             }
         }
     }
+    for (const span of rowSpans) {
+        if (span.x1 < visibleColumn && span.x2 > visibleColumn && span.kind === "focus") {
+            output += spanAnsiClose(span, theme);
+        }
+    }
     return output;
 }
-function formatPlainLine(line, spans, y) {
+function hasPlainAffordance(token) {
+    return typeof token !== "undefined" && ("plainPrefix" in token || "plainSuffix" in token);
+}
+function formatPlainLine(line, spans, y, theme) {
     let output = "";
     let visibleColumn = 1;
-    const rowSpans = lineSpans(spans, y).filter((span) => span.kind === "selection");
+    const firstFallbackFocusY = lineSpans(spans, y).some((span) => {
+        const token = resolveTerminalStyleToken(span.kind, theme);
+        return span.kind === "focus" && !hasPlainAffordance(token) && span.x1 === 1;
+    })
+        ? Math.min(...spans.filter((span) => span.kind === "focus" && span.x1 === 1).map((span) => span.y))
+        : null;
+    const rowSpans = lineSpans(spans, y).map((span) => {
+        const token = resolveTerminalStyleToken(span.kind, theme);
+        const fallbackFocusMarker = span.kind === "focus"
+            && !token?.plainPrefix
+            && !token?.plainSuffix
+            && span.x1 === 1
+            && y === firstFallbackFocusY
+            && span.x2 <= line.length + 1
+            && !line.trimStart().startsWith(">")
+            && !line.includes("|")
+            && !line.includes("[>");
+        return {
+            ...span,
+            x2: fallbackFocusMarker ? Math.min(span.x2, line.trimEnd().length + 1) : span.x2,
+            plainPrefix: token?.plainPrefix ?? span.style?.plainPrefix ?? (fallbackFocusMarker ? ">" : ""),
+            plainSuffix: token?.plainSuffix ?? span.style?.plainSuffix ?? (fallbackFocusMarker ? "<" : "")
+        };
+    }).filter((span) => Boolean(span.plainPrefix || span.plainSuffix));
     for (let i = 0; i < line.length; i += 1) {
         const char = line[i];
         if (char === "|") {
             output += char;
             continue;
         }
-        if (rowSpans.some((span) => span.x1 === visibleColumn)) {
-            output += "[";
+        for (const span of rowSpans) {
+            if (span.x1 === visibleColumn) {
+                output += span.plainPrefix;
+            }
         }
         output += char;
         visibleColumn += 1;
-        if (rowSpans.some((span) => span.x2 === visibleColumn)) {
-            output += "]";
+        for (const span of rowSpans) {
+            if (span.x2 === visibleColumn) {
+                if (span.kind !== "focus") {
+                    output += span.plainSuffix;
+                }
+            }
+        }
+        for (const span of rowSpans) {
+            if (span.x2 === visibleColumn && span.kind === "focus") {
+                output += span.plainSuffix;
+            }
         }
     }
-    if (rowSpans.some((span) => span.x1 === visibleColumn)) {
-        output += "[]";
+    for (const span of rowSpans) {
+        if (span.x1 === visibleColumn) {
+            output += span.plainPrefix + span.plainSuffix;
+        }
     }
     return output;
 }
-export function formatPlainFrame(frame) {
-    return frame.lines.map((line, index) => formatPlainLine(line, frame.spans, index + 1)).join("\n");
+export function formatPlainFrame(frame, options = {}) {
+    return frame.lines.map((line, index) => formatPlainLine(line, frame.spans, index + 1, options.theme)).join("\n");
 }
-export function toAnsiFrame(lines, cursor, spans = []) {
-    const ansiLines = lines.map((line, index) => renderAnsiLine(line, spans, index + 1));
-    const cursorCode = cursor ? `\u001b[${cursor.y};${cursor.x}H\u001b[?25h` : "\u001b[?25h";
+export function toAnsiFrame(lines, cursor, spans = [], options = {}) {
+    const ansiLines = lines.map((line, index) => `${renderAnsiLine(line, spans, index + 1, options.theme)}\u001b[K`);
+    const showCursor = options.showCursor !== false || (options.showCursorWhenFrameHasCursor === true && cursor);
+    const cursorCode = cursor ? `\u001b[${cursor.y};${cursor.x}H${showCursor ? ANSI_SHOW_CURSOR : ""}` : showCursor ? ANSI_SHOW_CURSOR : "";
     return `\u001b[?25l\u001b[H${ansiLines.join("\n")}${cursorCode}`;
 }
-export function createAnsiDiffWriter() {
+export function createAnsiFrameDiff(previousAnsiLines, nextAnsiLines, cursor, options = {}) {
+    const changedLineIndexes = [];
+    const writes = ["\u001b[?25l"];
+    const maxLines = Math.max(previousAnsiLines.length, nextAnsiLines.length);
+    for (let i = 0; i < maxLines; i += 1) {
+        const nextLine = nextAnsiLines[i] || "";
+        const prevLine = previousAnsiLines[i] || "";
+        if (nextLine !== prevLine) {
+            changedLineIndexes.push(i);
+            writes.push(`\u001b[${i + 1};1H${nextLine}\u001b[0m\u001b[K`);
+        }
+    }
+    if (cursor) {
+        writes.push(`\u001b[${cursor.y};${cursor.x}H`);
+    }
+    if (options.showCursor !== false || (options.showCursorWhenFrameHasCursor === true && cursor)) {
+        writes.push(ANSI_SHOW_CURSOR);
+    }
+    return {
+        changedLineIndexes,
+        outputChunk: writes.join(""),
+        restoresCursor: Boolean(cursor)
+    };
+}
+export function createAnsiDiffWriter(options = {}) {
     let previousAnsiLines = [];
     return function toAnsiDiff(lines, cursor, spans = []) {
-        const ansiLines = lines.map((line, index) => renderAnsiLine(line, spans, index + 1));
-        const writes = ["\u001b[?25l"];
-        const maxLines = Math.max(previousAnsiLines.length, ansiLines.length);
-        for (let i = 0; i < maxLines; i += 1) {
-            const nextLine = ansiLines[i] || "";
-            const prevLine = previousAnsiLines[i] || "";
-            if (nextLine !== prevLine) {
-                writes.push(`\u001b[${i + 1};1H${nextLine}\u001b[0m\u001b[K`);
-            }
-        }
-        writes.push(cursor ? `\u001b[${cursor.y};${cursor.x}H\u001b[?25h` : "\u001b[?25h");
+        const ansiLines = lines.map((line, index) => renderAnsiLine(line, spans, index + 1, options.theme));
+        const diff = createAnsiFrameDiff(previousAnsiLines, ansiLines, cursor, options);
         previousAnsiLines = ansiLines.slice();
-        return writes.join("");
+        return diff.outputChunk;
     };
 }
 //# sourceMappingURL=ansi.js.map

package/dist/ansi.js.map

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

package/dist/editor-state.d.ts

@@ -0,0 +1,22 @@
+export interface EditorCursor {
+    line: number;
+    column: number;
+}
+export interface EditorState {
+    value: string;
+    lines: string[];
+    cursor: EditorCursor;
+    desiredColumn?: number;
+}
+export type EditorCursorDirection = "left" | "right" | "up" | "down" | "home" | "end";
+export interface EditorOperationResult {
+    value: string;
+    state: EditorState;
+}
+export declare function createEditorState(value: string, cursor?: EditorCursor, desiredColumn?: number): EditorState;
+export declare function normalizeEditorState(value: string, cursor?: EditorCursor, desiredColumn?: number): EditorState;
+export declare function insertEditorText(value: string, state: EditorState, text: string): EditorOperationResult;
+export declare function removeEditorBackward(value: string, state: EditorState): EditorOperationResult;
+export declare function removeEditorForward(value: string, state: EditorState): EditorOperationResult;
+export declare function moveEditorCursor(value: string, state: EditorState, direction: EditorCursorDirection): EditorState;
+//# sourceMappingURL=editor-state.d.ts.map

package/dist/editor-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-state.d.ts","sourceRoot":"","sources":["../src/editor-state.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEtF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,WAAW,CAE3G;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,WAAW,CAY9G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAgBvG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAmB7F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAY5F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,qBAAqB,GAAG,WAAW,CAiDjH"}