@x-otto/tui 0.0.1-alpha.8 → 0.1.0-alpha.9

package/README.md

@@ -2,7 +2,7 @@
 
 ## Module Purpose
 
-The terminal UI application layer: a React + Ink component tree that provides streaming Markdown rendering, permission dialogs, input stack, message flow, and the full terminal interaction experience. Built on the npm `ink` v7 rendering engine and the `@x-otto/keybindings` keypress system.
+The terminal UI application layer: a React + Ink component tree that provides streaming Markdown rendering, permission dialogs, input stack, message flow, and the full terminal interaction experience. Built on the npm `ink` v7 rendering engine, with keybinding, theme, and fuzzy-search systems living in-package (`src/keybindings`, `src/theme`, `src/search`).
 
 ## Installation
 
@@ -18,23 +18,23 @@ import { startTui } from '@x-otto/tui'
 const tui = await startTui({
   stdin: process.stdin,
   stdout: process.stdout,
-  onMessage: async (msg) => { /* send to agent */ },
+  onSubmit: (text) => { /* send to agent */ },
 })
 
-tui.pushMessage({ role: 'assistant', content: 'Hello! I am otto.' })
-tui.showToast('Task completed')
+tui.messages.pushMessage({ role: 'assistant', content: 'Hello! I am otto.' })
+tui.info.showToast('Task completed', 'Done')
 
-await tui.dispose()
+tui.lifecycle.stop()
 ```
 
 ## Core Features
 
 | Module            | Function                                                    |
 | --------------- | ------------------------------------------------------- |
-| Store           | Application state management (zustand-driven, useAppState / createStore) |
+| Store           | Application state management (zustand-driven, useAppState / makeStore) |
 | Input           | Input stack: Cursor model + InputBuffer + History + Typeahead |
-| Messages        | Message flow: StreamState + QueryGuard + Collapse + Diff      |
-| Dialogs         | Dialog arbitration: permission queue + Select state machine + dialog components |
+| Messages        | Message flow: stream commit/coalesce + QueryGuard + Collapse + Diff |
+| Dialogs         | Dialog arbitration: routed permission dialogs + Select state machine + dialog components |
 | Components      | Common components: App / Welcome / StatusBar / Spinner / Button / DataList |
 | Term            | Terminal primitives: BracketedPaste / OSC 8/52 / SyncFrame |
 | Theme           | Color palette + icon glyphs + spinner frames + theme preset registry |
@@ -46,10 +46,8 @@ await tui.dispose()
 
 | Component          | Function                          |
 | ------------------ | ----------------------------- |
-| BaseTextInput      | Base text input (cursor/edit/paste) |
+| TextInput          | Text input (cursor/edit/paste) |
 | PromptInput        | Main prompt input box                  |
-| PromptInputFooter  | Input box status footer              |
-| HistorySearchInput | History search input |
 | QueuedCommands     | Queued command display             |
 
 ## Message Rendering
@@ -57,37 +55,44 @@ await tui.dispose()
 | Component          | Function                          |
 | ------------------ | ----------------------------- |
 | Message            | Message container (role/collapse/branch)    |
-| Markdown           | Static Markdown rendering             |
-| StreamingMarkdown  | Streaming Markdown rendering (flicker-free) |
-| StructuredDiff     | Structured diff rendering             |
-| HighlightedCode    | Syntax-highlighted code blocks |
-| ToolUseLoader      | Tool call loading animation             |
 | REPLRegion         | REPL message region container             |
+| renderMessageLines | Line-based message rendering (streaming-aware) |
+| renderMarkdownToLines | Markdown → ANSI line rendering       |
+| preloadHighlighter / highlightBlock | Syntax-highlighted code blocks |
 
 ## Directory Overview
 
 ```
 src/
-  types.ts           # TUI-local type stubs (no dependency on @x-otto/ai)
-  theme.ts           # THEME / PALETTE / FIGURES / SPINNER_FRAMES
-  startTui.tsx       # production entry point
-  print-messages.ts   # print mode
-  compat.ts          # backward-compatibility (legacy API shim)
-  index.ts           # barrel export
-  store/             # application state management
-  term/              # terminal primitives (paste/keys/OSC)
-  input/             # input stack (Cursor/Buffer/History/Typeahead)
-  messages/          # message flow (Stream/QueryGuard/Collapse/Diff)
-  dialogs/           # dialogs (Permission/Select/Arbiter)
-  components/        # common components (App/Welcome/StatusBar/Spinner)
-tests/               # 20 test files
+  types.ts             # TUI-local type stubs (no dependency on @x-otto/ai)
+  theme.ts             # THEME / PALETTE / FIGURES / SPINNER_FRAMES
+  main.ts              # production entry point (startTui)
+  compat.ts            # backward-compatibility (legacy API shim)
+  index.ts             # barrel export
+  stores/              # application state (zustand: message/stream/task/context/...)
+  term/                # terminal primitives (paste/keys/OSC/sync/scrollback)
+  input/               # input stack (Cursor/Buffer/History/Typeahead)
+  messages/            # message flow (commit/QueryGuard/Collapse/Diff)
+  dialogs/             # dialogs (Permission/Select/Confirm/Alert/...)
+  components/          # common components (App/Welcome/StatusBar/Spinner)
+  panes/               # side panes (Context/Task/Subagents/Sigil/Schedule/...)
+  router/ + routes/    # router-driven views & modal routes (FocusBus/Router/Tabable)
+  overlays/            # overlay components
+  status-bar/          # status bar widgets (provider usage badge, background tasks)
+  keybindings/         # keybinding parsing & overrides
+  history/             # shell history parsing (zsh/bash/fish)
+  search/              # fuzzy search
+  sigil/               # #/@ sigil input completion
+  bootstrap/           # TuiHandle/TuiOptions types + session data-source bridges
+  app/                 # App shell assembly (input/dialog/panel/status regions)
+tests/               # 385 test files
 ```
 
 ## Public Exports
 
 ```ts
 // State management
-export { createStore, useAppState }
+export { useAppState, makeStore }
 export type { Store }
 
 // Terminal primitives
@@ -99,17 +104,18 @@ export { insertHistory, preWrapLine, displayWidth, guardScrollbackStdout }
 export { Cursor, MeasuredText, stringWidth }
 export { createInputBuffer, createInputHistory, createPasteStore }
 export { createCommandRegistry, getCommandSuggestions, applySlashCompletion }
-export { TextInput, PromptInput, QueuedCommands, HistorySearchInput }
+export { TextInput, PromptInput, QueuedCommands }
 export type { InputBuffer, BufferEntry }
 
 // Message flow
-export { createStreamState, reduceStreamEvent, reduceStreamEvents }
+export { safeCommitBoundary, initStreamCommit, streamCommitStep, makeCoalescer }
 export { createQueryGuard, collapseMessages, toggleCollapse, expandCollapsed }
-export { Markdown, Message, REPLRegion, StructuredDiff, ToolUseLoader, StreamingMarkdown }
+export { Message, REPLRegion }
+export { renderMessageLines, renderMarkdownToLines, preloadHighlighter, highlightBlock }
 export { registerPluginRenderers, clearPluginRenderers }
 
 // Dialogs
-export { createDialogArbiter, createPermissionQueue, createSelectState }
+export { createSelectState }
 export { Select, PermissionDialogDialog, BashPermissionDialog, ConfirmDialog, AlertDialog, PromptDialog, MemoryDialog }
 
 // Components
@@ -124,9 +130,6 @@ export type { ThemePreset, ThemePresetInput, ThemePresetSelection, ThemeAppearan
 // Search
 export { rankCandidates, rankNamedItems, rankLabeledItems, createIncrementalSearcher }
 
-// Inspect
-export { createInspectorStore, InspectorPane, buildEventTree, buildToolList }
-
 // i18n
 export { detectLanguage, t, i18next, initI18n }
 export type { Lang, LangMode }
@@ -147,4 +150,4 @@ pnpm --filter @x-otto/tui clean
 
 ## Related Packages
 
-`@x-otto/keybindings`
+`@x-otto/interchange`, `@x-otto/session-contract`, `@x-otto/shared`, `@x-otto/env`