nastech-tui 0.0.1

package/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "arrowParens": "avoid",
+  "bracketSpacing": true,
+  "endOfLine": "auto",
+  "printWidth": 120,
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "none",
+  "useTabs": false
+}

package/README.md

@@ -0,0 +1,346 @@
+# NasTech TUI
+
+React + Ink terminal UI for NasTech. TypeScript owns the screen. Python owns sessions, tools, model calls, and most command logic.
+
+```bash
+nastech --tui
+```
+
+## What runs
+
+The client entrypoint is `src/entry.tsx`. It exits early if `stdin` is not a TTY, starts `GatewayClient`, then renders `App`.
+
+`GatewayClient` spawns:
+
+```text
+python -m tui_gateway.entry
+```
+
+Interpreter resolution order is: `NASTECH_PYTHON` → `PYTHON` → `$VIRTUAL_ENV/bin/python` → `./.venv/bin/python` → `./venv/bin/python` → `python3` (or `python` on Windows).
+
+The transport is newline-delimited JSON-RPC over stdio:
+
+```text
+ui-tui/src                  tui_gateway/
+-----------                 -------------
+entry.tsx                   entry.py
+  -> GatewayClient            -> request loop
+  -> App                      -> server.py RPC handlers
+
+stdin/stdout: JSON-RPC requests, responses, events
+stderr: captured into an in-memory log ring
+```
+
+Malformed stdout lines are treated as protocol noise and surfaced as `gateway.protocol_error`. Stderr lines become `gateway.stderr`. Neither writes directly into the terminal.
+
+## Running it
+
+From the repo root, the normal path is:
+
+```bash
+nastech --tui
+```
+
+The CLI expects `ui-tui/dist/entry.js` to exist, or the whole source code available in which to run `npm install` and `npm run dev`.
+
+```bash
+cd ui-tui
+npm install
+```
+
+Local package commands:
+
+```bash
+npm run dev
+npm start
+npm run build
+npm run lint
+npm run fmt
+npm run fix
+```
+
+Tests use vitest:
+
+```bash
+npm test         # single run
+npm run test:watch
+```
+
+## App model
+
+`src/app.tsx` is the center of the UI. Heavy logic is split into `src/app/`:
+
+- `createGatewayEventHandler.ts` — maps gateway events to state updates
+- `createSlashHandler.ts` — local slash command dispatch
+- `useComposerState.ts` — draft, multiline buffer, queue editing
+- `useInputHandlers.ts` — keypress routing
+- `useTurnState.ts` — agent turn lifecycle
+- `overlayStore.ts` / `uiStore.ts` — nanostores for overlay and UI state
+- `gatewayContext.tsx` — React context for the gateway client
+- `constants.ts`, `helpers.ts`, `interfaces.ts`
+
+The top-level `app.tsx` composes these into the Ink tree with `Static` transcript output, a live streaming assistant row, prompt overlays, queue preview, status rule, input line, and completion list.
+
+State managed at the top level includes:
+
+- transcript and streaming state
+- queued messages and input history
+- session lifecycle
+- tool progress and reasoning text
+- prompt flows for approval, clarify, sudo, and secret input
+- slash command routing
+- tab completion and path completion
+- theme state from gateway skin data
+
+The UI renders as a normal Ink tree with `Static` transcript output, a live streaming assistant row, prompt overlays, queue preview, status rule, input line, and completion list.
+
+The intro panel is driven by `session.info` and rendered through `branding.tsx`.
+
+## Hotkeys and interactions
+
+Current input behavior is split across `app.tsx`, `components/textInput.tsx`, and the prompt/picker components.
+
+### Main chat input
+
+| Key                             | Behavior                                                                                                                                                |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Enter`                         | Submit the current draft                                                                                                                                |
+| empty `Enter` twice             | If queued messages exist and the agent is busy, interrupt the current run. If queued messages exist and the agent is idle, send the next queued message |
+| `Shift+Enter` / `Alt+Enter`     | Insert a newline in the current draft                                                                                                                   |
+| `\` + `Enter`                   | Append the line to the multiline buffer (fallback for terminals without modifier support)                                                               |
+| `Ctrl+C`                        | Interrupt active run, or clear the current draft, or exit if nothing is pending                                                                         |
+| `Ctrl+D`                        | Exit                                                                                                                                                    |
+| `Cmd/Ctrl+G` / `Alt+G`          | Open `$EDITOR` with the current draft (use `Alt+G` in VSCode/Cursor — they bind the primary keystroke to Find Next)                                     |
+| `Ctrl+L`                        | New session (same as `/clear`)                                                                                                                          |
+| `Ctrl+V` / `Alt+V`              | Paste text first, then fall back to image/path attachment when applicable                                                                               |
+| `Tab`                           | Apply the active completion                                                                                                                             |
+| `Up/Down`                       | Cycle completions if the completion list is open; otherwise edit queued messages first, then walk input history                                         |
+| `Left/Right`                    | Move the cursor                                                                                                                                         |
+| modified `Left/Right`           | Move by word when the terminal sends `Ctrl` or `Meta` with the arrow key                                                                                |
+| `Home` / `Ctrl+A`               | Start of line                                                                                                                                           |
+| `End` / `Ctrl+E`                | End of line                                                                                                                                             |
+| `Backspace`                     | Delete the character to the left of the cursor                                                                                                          |
+| `Delete`                        | Delete the character to the right of the cursor                                                                                                         |
+| modified `Backspace`            | Delete the previous word                                                                                                                                |
+| modified `Delete`               | Delete the next word                                                                                                                                    |
+| `Ctrl+W`                        | Delete the previous word                                                                                                                                |
+| `Ctrl+U`                        | Delete from the cursor back to the start of the line                                                                                                    |
+| `Ctrl+K`                        | Delete from the cursor to the end of the line                                                                                                           |
+| `Meta+B` / `Meta+F`             | Move by word                                                                                                                                            |
+| `!cmd`                          | Run a shell command through the gateway                                                                                                                 |
+| `{!cmd}`                        | Inline shell interpolation before send; queued drafts keep the raw text until they are sent                                                            |
+
+Notes:
+
+- `Tab` only applies completions when completions are present and you are not in multiline mode.
+- Queue/history navigation only applies when you are not in multiline mode.
+- `PgUp` / `PgDn` are left to the terminal emulator; the TUI does not handle them.
+
+### Prompt and picker modes
+
+| Context                     | Keys                | Behavior                                          |
+| --------------------------- | ------------------- | ------------------------------------------------- |
+| approval prompt             | `Up/Down`, `Enter`  | Move and confirm the selected approval choice     |
+| approval prompt             | `o`, `s`, `a`, `d`  | Quick-pick `once`, `session`, `always`, `deny`    |
+| approval prompt             | `Esc`, `Ctrl+C`     | Deny                                              |
+| clarify prompt with choices | `Up/Down`, `Enter`  | Move and confirm the selected choice              |
+| clarify prompt with choices | single-digit number | Quick-pick the matching numbered choice           |
+| clarify prompt with choices | `Enter` on "Other"  | Switch into free-text entry                       |
+| clarify free-text mode      | `Enter`             | Submit typed answer                               |
+| sudo / secret prompt        | `Enter`             | Submit typed value                                |
+| sudo / secret prompt        | `Ctrl+C`            | Cancel by sending an empty response               |
+| resume picker               | `Up/Down`, `Enter`  | Move and resume the selected session              |
+| resume picker               | `1-9`               | Quick-pick one of the first nine visible sessions |
+| resume picker               | `Esc`, `Ctrl+C`     | Close the picker                                  |
+
+Notes:
+
+- Clarify free-text mode and masked prompts use `ink-text-input`, so text editing there follows the library's default bindings rather than `components/textInput.tsx`.
+- When a blocking prompt is open, the main chat input hotkeys are suspended.
+- Clarify mode has no dedicated cancel shortcut in the current client. Sudo and secret prompts only expose `Ctrl+C` cancellation from the app-level blocked handler.
+
+### Interaction rules
+
+- Plain text entered while the agent is busy is queued instead of sent immediately.
+- Slash commands and `!cmd` do not queue; they execute immediately even while a run is active.
+- Queue auto-drains after each assistant response, unless a queued item is currently being edited.
+- `Up/Down` prioritizes queued-message editing over history. History only activates when there is no queue to edit.
+- Queued drafts keep their original `!cmd` and `{!cmd}` text while you edit them. Shell commands and interpolation run when the queued item is actually sent.
+- If you load a queued item into the input and resubmit plain text, that queue item is replaced, removed from the queue preview, and promoted to send next. If the agent is still busy, the edited item is moved to the front of the queue and sent after the current run completes.
+- Completion requests are debounced by 60 ms. Input starting with `/` uses `complete.slash`. A trailing token that starts with `./`, `../`, `~/`, `/`, or `@` uses `complete.path`.
+- Text pastes are inserted inline directly into the draft. Nothing is newline-flattened.
+- `Cmd/Ctrl+G` (or `Alt+G` in VSCode/Cursor, which intercept the primary keystroke for Find Next) writes the current draft, including any multiline buffer, to a temp file, suspends Ink, launches `$EDITOR`, then restores the TUI and submits the saved text if the editor exits cleanly.
+- Input history is stored in `~/.nastech/.nastech_history` or under `NASTECH_HOME`.
+
+## Rendering
+
+Assistant output is rendered in one of two ways:
+
+- if the payload already contains ANSI, `messageLine.tsx` prints it directly
+- otherwise `components/markdown.tsx` renders a small Markdown subset into Ink components
+
+The Markdown renderer handles headings, lists, block quotes, tables, fenced code blocks, diff coloring, inline code, emphasis, links, and plain URLs.
+
+Tool/status activity is shown in a live activity lane. Transcript rows stay focused on user/assistant turns.
+
+## Prompt flows
+
+The Python gateway can pause the main loop and request structured input:
+
+- `approval.request`: allow once, allow for session, allow always, or deny
+- `clarify.request`: pick from choices or type a custom answer
+- `sudo.request`: masked password entry
+- `secret.request`: masked value entry for a named env var
+- `session.list`: used by `SessionPicker` for `/resume`
+
+These are stateful UI branches in `app.tsx`, not separate screens.
+
+## Commands
+
+The local slash handler covers the built-ins that need direct client behavior:
+
+- `/help`
+- `/quit`, `/exit`, `/q`
+- `/clear`
+- `/new`
+- `/compact`
+- `/resume`
+- `/copy`
+- `/paste`
+- `/details`
+- `/logs`
+- `/statusbar`, `/sb`
+- `/queue`
+- `/undo`
+- `/retry`
+
+Notes:
+
+- `/copy` sends the selected assistant response through OSC 52.
+- `/paste` with no args asks the gateway to attach a clipboard image.
+- Text paste remains inline-only; `Cmd+V` / `Ctrl+V` handle layered text/OSC52/image fallback before `/paste` is needed.
+- `/details [hidden|collapsed|expanded|cycle]` controls thinking/tool-detail visibility.
+- `/statusbar` toggles the status rule on/off.
+
+Anything else falls through to:
+
+1. `slash.exec`
+2. `command.dispatch`
+
+That lets Python own aliases, plugins, skills, and registry-backed commands without duplicating the logic in the TUI.
+
+## Event surface
+
+Primary event types the client handles today:
+
+| Event                    | Payload                                         |
+| ------------------------ | ----------------------------------------------- |
+| `gateway.ready`          | `{ skin? }`                                     |
+| `session.info`           | session metadata for banner + tool/skill panels |
+| `message.start`          | start assistant streaming                       |
+| `message.delta`          | `{ text, rendered? }`                           |
+| `message.complete`       | `{ text, rendered?, usage, status }`            |
+| `thinking.delta`         | `{ text }`                                      |
+| `reasoning.delta`        | `{ text }`                                      |
+| `reasoning.available`    | `{ text }`                                      |
+| `status.update`          | `{ kind, text }`                                |
+| `tool.start`             | `{ tool_id, name, context? }`                   |
+| `tool.progress`          | `{ name, preview }`                             |
+| `tool.complete`          | `{ tool_id, name }`                             |
+| `clarify.request`        | `{ question, choices?, request_id }`            |
+| `approval.request`       | `{ command, description }`                      |
+| `sudo.request`           | `{ request_id }`                                |
+| `secret.request`         | `{ prompt, env_var, request_id }`               |
+| `background.complete`    | `{ task_id, text }`                             |
+| `error`                  | `{ message }`                                   |
+| `gateway.stderr`         | synthesized from child stderr                   |
+| `gateway.protocol_error` | synthesized from malformed stdout               |
+
+## Theme model
+
+The client starts with `DEFAULT_THEME` from `theme.ts`, then merges in gateway skin data from `gateway.ready`.
+
+Current branding overrides:
+
+- agent name
+- prompt symbol
+- welcome text
+- goodbye text
+
+Current color overrides:
+
+- banner title, accent, border, body, dim
+- label, ok, error, warn
+
+`branding.tsx` uses those values for the logo, session panel, and update notice.
+
+## File map
+
+```text
+ui-tui/
+  packages/nastech-ink/   forked Ink renderer (local dep)
+  src/
+    entry.tsx            TTY gate + render()
+    app.tsx              top-level Ink tree, composes src/app/*
+    gatewayClient.ts     child process + JSON-RPC bridge
+    theme.ts             default palette + skin merge
+    constants.ts         display constants, hotkeys, tool labels
+    types.ts             shared client-side types
+    banner.ts            ASCII art data
+
+    app/
+      createGatewayEventHandler.ts  event → state mapping
+      createSlashHandler.ts         local slash dispatch
+      useComposerState.ts           draft + multiline + queue editing
+      useInputHandlers.ts           keypress routing
+      useTurnState.ts               agent turn lifecycle
+      overlayStore.ts               nanostores for overlays
+      uiStore.ts                    nanostores for UI flags
+      gatewayContext.tsx             React context for gateway client
+      constants.ts                  app-level constants
+      helpers.ts                    pure helpers
+      interfaces.ts                 internal interfaces
+
+    components/
+      appChrome.tsx      status bar, input row, completions
+      appLayout.tsx      top-level layout composition
+      appOverlays.tsx    overlay routing (pickers, prompts)
+      branding.tsx       banner + session summary
+      markdown.tsx       Markdown-to-Ink renderer
+      maskedPrompt.tsx   masked input for sudo / secrets
+      messageLine.tsx    transcript rows
+      modelPicker.tsx    model switch picker
+      prompts.tsx        approval + clarify flows
+      queuedMessages.tsx queued input preview
+      sessionPicker.tsx  session resume picker
+      textInput.tsx      custom line editor
+      thinking.tsx       spinner, reasoning, tool activity
+
+    hooks/
+      useCompletion.ts   tab completion (slash + path)
+      useInputHistory.ts persistent history navigation
+      useQueue.ts        queued message management
+      useVirtualHistory.ts in-memory history for pickers
+
+    lib/
+      history.ts         persistent input history
+      messages.ts        message formatting helpers
+      osc52.ts           OSC 52 clipboard copy
+      rpc.ts             JSON-RPC type helpers
+      text.ts            text helpers, ANSI detection, previews
+
+    types/
+      nastech-ink.d.ts    type declarations for @nastech/ink
+
+    __tests__/           vitest suite
+```
+
+Related Python side:
+
+```text
+tui_gateway/
+  entry.py               stdio entrypoint
+  server.py              RPC handlers and session logic
+  render.py              optional rich/ANSI bridge
+  slash_worker.py        persistent NasTechCLI subprocess for slash commands
+```

package/eslint.config.mjs

@@ -0,0 +1,111 @@
+import js from '@eslint/js'
+import typescriptEslint from '@typescript-eslint/eslint-plugin'
+import typescriptParser from '@typescript-eslint/parser'
+import perfectionist from 'eslint-plugin-perfectionist'
+import reactPlugin from 'eslint-plugin-react'
+import reactCompiler from 'eslint-plugin-react-compiler'
+import hooksPlugin from 'eslint-plugin-react-hooks'
+import unusedImports from 'eslint-plugin-unused-imports'
+import globals from 'globals'
+
+const noopRule = {
+  meta: { schema: [], type: 'problem' },
+  create: () => ({})
+}
+
+const customRules = {
+  rules: {
+    'no-process-cwd': noopRule,
+    'no-process-env-top-level': noopRule,
+    'no-sync-fs': noopRule,
+    'no-top-level-dynamic-import': noopRule,
+    'no-top-level-side-effects': noopRule
+  }
+}
+
+export default [
+  {
+    ignores: ['**/node_modules/**', '**/dist/**', 'src/**/*.js']
+  },
+  js.configs.recommended,
+  {
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      globals: { ...globals.node },
+      parser: typescriptParser,
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+        ecmaVersion: 'latest',
+        sourceType: 'module'
+      }
+    },
+    plugins: {
+      '@typescript-eslint': typescriptEslint,
+      'custom-rules': customRules,
+      perfectionist,
+      react: reactPlugin,
+      'react-compiler': reactCompiler,
+      'react-hooks': hooksPlugin,
+      'unused-imports': unusedImports
+    },
+    rules: {
+      'no-fallthrough': ['error', { allowEmptyCase: true }],
+      curly: ['error', 'all'],
+      '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
+      '@typescript-eslint/no-unused-vars': 'off',
+      'no-undef': 'off',
+      'no-unused-vars': 'off',
+      'react-compiler/react-compiler': 'warn',
+      'padding-line-between-statements': [
+        1,
+        { blankLine: 'always', next: ['block-like', 'block', 'return', 'if', 'class', 'continue', 'debugger', 'break', 'multiline-const', 'multiline-let'], prev: '*' },
+        { blankLine: 'always', next: '*', prev: ['case', 'default', 'multiline-const', 'multiline-let', 'multiline-block-like'] },
+        { blankLine: 'never', next: ['block', 'block-like'], prev: ['case', 'default'] },
+        { blankLine: 'always', next: ['block', 'block-like'], prev: ['block', 'block-like'] },
+        { blankLine: 'always', next: ['empty'], prev: 'export' },
+        { blankLine: 'never', next: 'iife', prev: ['block', 'block-like', 'empty'] }
+      ],
+      'perfectionist/sort-exports': ['error', { order: 'asc', type: 'natural' }],
+      'perfectionist/sort-imports': [
+        'error',
+        {
+          groups: ['side-effect', 'builtin', 'external', 'internal', 'parent', 'sibling', 'index'],
+          order: 'asc',
+          type: 'natural'
+        }
+      ],
+      'perfectionist/sort-jsx-props': ['error', { order: 'asc', type: 'natural' }],
+      'perfectionist/sort-named-exports': ['error', { order: 'asc', type: 'natural' }],
+      'perfectionist/sort-named-imports': ['error', { order: 'asc', type: 'natural' }],
+      'react-hooks/exhaustive-deps': 'warn',
+      'react-hooks/rules-of-hooks': 'error',
+      'unused-imports/no-unused-imports': 'error'
+    },
+    settings: {
+      react: { version: 'detect' }
+    }
+  },
+  {
+    files: ['packages/nastech-ink/**/*.{ts,tsx}'],
+    rules: {
+      '@typescript-eslint/consistent-type-imports': 'off',
+      'no-constant-condition': 'off',
+      'no-empty': 'off',
+      'no-redeclare': 'off',
+      'react-compiler/react-compiler': 'off',
+      'react-hooks/exhaustive-deps': 'off'
+    }
+  },
+  {
+    files: ['**/*.js'],
+    ignores: ['**/node_modules/**', '**/dist/**'],
+    languageOptions: {
+      globals: { ...globals.node },
+      ecmaVersion: 'latest',
+      sourceType: 'module'
+    }
+  },
+  {
+    ignores: ['*.config.*']
+  }
+]

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "nastech-tui",
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "dev": "npm run build --prefix packages/nastech-ink && tsx --watch src/entry.tsx",
+    "start": "tsx src/entry.tsx",
+    "build": "node scripts/build.mjs",
+    "type-check": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint src/ packages/",
+    "lint:fix": "eslint src/ packages/ --fix",
+    "fmt": "prettier --write 'src/**/*.{ts,tsx}' 'packages/**/*.{ts,tsx}'",
+    "fix": "npm run lint:fix && npm run fmt",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@nanostores/react": "^1.1.0",
+    "@nastechai/ink": "file:./packages/nastech-ink",
+    "undici": ">=7.24.0",
+    "ink": "^6.8.0",
+    "ink-text-input": "^6.0.0",
+    "nanostores": "^1.2.0",
+    "react": "^19.2.4",
+    "unicode-animations": "^1.0.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "@typescript-eslint/eslint-plugin": "^8",
+    "@typescript-eslint/parser": "^8",
+    "esbuild": "^0.28.1",
+    "eslint": "^9",
+    "eslint-plugin-perfectionist": "^5",
+    "eslint-plugin-react": "^7",
+    "eslint-plugin-react-compiler": "^19.1.0-rc.2",
+    "eslint-plugin-react-hooks": "^7",
+    "eslint-plugin-unused-imports": "^4",
+    "globals": "^16",
+    "prettier": "^3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/packages/nastech-ink/ambient.d.ts

@@ -0,0 +1,83 @@
+/// <reference types="react" />
+
+declare module 'react/compiler-runtime' {
+  export function c(size: number): any[]
+}
+
+declare module 'bidi-js' {
+  const bidiFactory: () => Record<string, any>
+  export default bidiFactory
+}
+
+declare module 'stack-utils' {
+  class StackUtils {
+    static nodeInternals(): RegExp[]
+    constructor(opts?: { cwd?: string; internals?: RegExp[] })
+    clean(stack: string | undefined): string | undefined
+    parseLine(line: string): { file?: string; line?: number; column?: number; function?: string } | undefined
+  }
+  export default StackUtils
+}
+
+declare module 'react-reconciler' {
+  export type FiberRoot = unknown
+  const createReconciler: any
+  export default createReconciler
+}
+
+declare module 'react-reconciler/constants.js' {
+  export const ConcurrentRoot: number
+  export const LegacyRoot: number
+  export const DiscreteEventPriority: symbol | number
+  export const ContinuousEventPriority: symbol | number
+  export const DefaultEventPriority: symbol | number
+  export const NoEventPriority: symbol | number
+}
+
+declare module 'lodash-es/noop.js' {
+  const noop: (...args: unknown[]) => void
+  export default noop
+}
+
+declare module 'lodash-es/throttle.js' {
+  function throttle<T extends (...args: unknown[]) => unknown>(
+    fn: T,
+    wait?: number,
+    opts?: { leading?: boolean; trailing?: boolean }
+  ): T & { cancel(): void; flush(): void }
+  export default throttle
+}
+
+declare module 'semver' {
+  export function coerce(version: string | number | null | undefined): { version: string } | null
+  export function gt(a: string, b: string, opts?: { loose?: boolean }): boolean
+  export function gte(a: string, b: string, opts?: { loose?: boolean }): boolean
+  export function lt(a: string, b: string, opts?: { loose?: boolean }): boolean
+  export function lte(a: string, b: string, opts?: { loose?: boolean }): boolean
+  export function satisfies(version: string, range: string, opts?: { loose?: boolean }): boolean
+  export function compare(a: string, b: string, opts?: { loose?: boolean }): number
+}
+
+interface BunSemver {
+  order(a: string, b: string): -1 | 0 | 1
+  satisfies(version: string, range: string): boolean
+}
+
+interface BunRuntime {
+  stringWidth(s: string, opts?: { ambiguousIsNarrow?: boolean }): number
+  semver: BunSemver
+  wrapAnsi?(input: string, columns: number, options?: { hard?: boolean; wordWrap?: boolean; trim?: boolean }): string
+}
+
+declare var Bun: BunRuntime | undefined
+
+declare namespace React {
+  namespace JSX {
+    interface IntrinsicElements {
+      'ink-box': Record<string, unknown>
+      'ink-text': Record<string, unknown>
+      'ink-link': Record<string, unknown>
+      'ink-raw-ansi': Record<string, unknown>
+    }
+  }
+}

package/packages/nastech-ink/index.d.ts

@@ -0,0 +1,40 @@
+/// <reference path="./ambient.d.ts" />
+export { default as useStderr } from './src/hooks/use-stderr.ts'
+export type { StderrHandle } from './src/hooks/use-stderr.ts'
+export { default as useStdout } from './src/hooks/use-stdout.ts'
+export type { StdoutHandle } from './src/hooks/use-stdout.ts'
+export { Ansi } from './src/ink/Ansi.tsx'
+export { evictInkCaches } from './src/ink/cache-eviction.ts'
+export type { EvictLevel, InkCacheSizes } from './src/ink/cache-eviction.ts'
+export { AlternateScreen } from './src/ink/components/AlternateScreen.tsx'
+export type { MouseTrackingMode } from './src/ink/termio/dec.ts'
+export { default as Box } from './src/ink/components/Box.tsx'
+export type { Props as BoxProps } from './src/ink/components/Box.tsx'
+export { default as Link } from './src/ink/components/Link.tsx'
+export { default as Newline } from './src/ink/components/Newline.tsx'
+export { NoSelect } from './src/ink/components/NoSelect.tsx'
+export { RawAnsi } from './src/ink/components/RawAnsi.tsx'
+export { default as ScrollBox } from './src/ink/components/ScrollBox.tsx'
+export type { ScrollBoxHandle, ScrollBoxProps } from './src/ink/components/ScrollBox.tsx'
+export { default as Spacer } from './src/ink/components/Spacer.tsx'
+export type { Props as StdinProps } from './src/ink/components/StdinContext.ts'
+export { default as Text } from './src/ink/components/Text.tsx'
+export type { Props as TextProps } from './src/ink/components/Text.tsx'
+export type { Key } from './src/ink/events/input-event.ts'
+export { default as useApp } from './src/ink/hooks/use-app.ts'
+export { useCursorAdvance } from './src/ink/hooks/use-cursor-advance.ts'
+export { useDeclaredCursor } from './src/ink/hooks/use-declared-cursor.ts'
+export { default as useInput } from './src/ink/hooks/use-input.ts'
+export { useHasSelection, useSelection } from './src/ink/hooks/use-selection.ts'
+export { default as useStdin } from './src/ink/hooks/use-stdin.ts'
+export { useTabStatus } from './src/ink/hooks/use-tab-status.ts'
+export { useTerminalFocus } from './src/ink/hooks/use-terminal-focus.ts'
+export { useTerminalTitle } from './src/ink/hooks/use-terminal-title.ts'
+export { useTerminalViewport } from './src/ink/hooks/use-terminal-viewport.ts'
+export { default as measureElement } from './src/ink/measure-element.ts'
+export { createRoot, forceRedraw, default as render, renderSync } from './src/ink/root.ts'
+export type { Instance, RenderOptions, Root } from './src/ink/root.ts'
+export { stringWidth } from './src/ink/stringWidth.ts'
+export { wrapAnsi } from './src/ink/wrapAnsi.ts'
+export { default as TextInput, UncontrolledTextInput } from 'ink-text-input'
+export type { Props as TextInputProps } from 'ink-text-input'

package/packages/nastech-ink/index.js

@@ -0,0 +1 @@
+export * from './dist/entry-exports.js'