@yeshwanthyk/open-tui 0.1.0

package/README.md

@@ -0,0 +1,122 @@
+# @yeshwanthyk/open-tui
+
+A Terminal User Interface library built on [OpenTUI](https://github.com/anthropics/opentui) with SolidJS reactive rendering.
+
+## Installation
+
+```bash
+bun add @yeshwanthyk/open-tui
+```
+
+## Quick Start
+
+```tsx
+import { render } from "@opentui/solid"
+import { ThemeProvider, useTheme, Markdown, Panel } from "@yeshwanthyk/open-tui"
+
+function App() {
+  const { theme } = useTheme()
+  
+  return (
+    <Panel variant="panel" padding={1}>
+      <Markdown text="# Hello World\n\nThis is **bold** text." />
+    </Panel>
+  )
+}
+
+render(
+  () => (
+    <ThemeProvider mode="dark" themeName="tokyonight">
+      <App />
+    </ThemeProvider>
+  ),
+  { exitOnCtrlC: true }
+)
+```
+
+## Components
+
+### Layout
+- `Panel` - Bordered container with theme variants
+- `Dialog` - Modal overlay with backdrop
+- `Spacer` - Flexible space filler
+- `Divider` - Horizontal/vertical separator
+
+### Content
+- `Markdown` - Tree-sitter highlighted markdown
+- `CodeBlock` - Syntax-highlighted code with line numbers
+- `Diff` - Unified/split diff view
+- `Image` - Kitty/iTerm2 inline images
+
+### Input
+- `Editor` - Multi-line text input
+- `Input` - Single-line text input
+- `SelectList` - Filterable selection list
+
+### Feedback
+- `Loader` - Animated spinner
+- `Toast` / `ToastViewport` - Notification toasts
+- `Badge` - Status badges
+
+## Theming
+
+### Built-in Themes
+```tsx
+<ThemeProvider themeName="dracula" mode="dark">
+```
+
+Available themes: `aura`, `ayu`, `catppuccin`, `cobalt2`, `dracula`, `everforest`, 
+`flexoki`, `github`, `gruvbox`, `kanagawa`, `material`, `monokai`, `nightowl`, 
+`nord`, `one-dark`, `palenight`, `rosepine`, `solarized`, `synthwave84`, 
+`tokyonight`, `vercel`, `vesper`, `zenburn`, and more.
+
+### Custom Theme Overrides
+```tsx
+<ThemeProvider 
+  themeName="dracula"
+  customTheme={{ primary: parseColor("#ff79c6") }}
+>
+```
+
+### Accessing Theme
+```tsx
+function MyComponent() {
+  const { theme, mode, setMode, themeName, setTheme } = useTheme()
+  
+  return <text fg={theme.primary}>Themed text</text>
+}
+```
+
+## Tree-sitter Setup
+
+For syntax highlighting, configure parsers before rendering:
+
+```tsx
+import { configureParsers } from "@yeshwanthyk/open-tui"
+
+await configureParsers({
+  languages: ["typescript", "python", "markdown"],
+  wasmPath: "./parsers" // Path to .wasm files
+})
+```
+
+## Autocomplete
+
+```tsx
+import { CombinedAutocompleteProvider } from "@yeshwanthyk/open-tui"
+
+const provider = new CombinedAutocompleteProvider(
+  [{ name: "help", description: "Show help" }],
+  process.cwd()
+)
+
+// Get suggestions
+const suggestions = provider.getSuggestions(lines, cursorLine, cursorCol)
+
+// Apply completion
+const result = provider.applyCompletion(lines, cursorLine, cursorCol, item, prefix)
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@yeshwanthyk/open-tui",
+	"version": "0.1.0",
+	"description": "OpenTUI-based Terminal User Interface with SolidJS reactive rendering",
+	"type": "module",
+	"main": "src/index.ts",
+	"types": "src/index.ts",
+	"scripts": {
+		"clean": "rm -rf dist",
+		"lint": "biome check --write . && oxlint .",
+		"lint:check": "biome check . && oxlint .",
+		"typecheck": "tsc --noEmit",
+		"check": "bun run lint:check && bun run typecheck",
+		"test": "bun test",
+		"demo": "bun run examples/run.ts"
+	},
+	"files": [
+		"dist/**/*",
+		"README.md"
+	],
+	"keywords": [
+		"tui",
+		"terminal",
+		"ui",
+		"opentui",
+		"solid-js",
+		"reactive"
+	],
+	"author": "Yesh Yendamuri",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Yeshwanthyk/marvin.git",
+		"directory": "packages/open-tui"
+	},
+	"engines": {
+		"node": ">=20.0.0",
+		"bun": ">=1.2.0"
+	},
+	"dependencies": {
+		"@opentui/core": "0.1.63",
+		"@opentui/solid": "0.1.63",
+		"fuzzysort": "^3.1.0",
+		"opentui-spinner": "^0.0.6",
+		"solid-js": "1.9.9"
+	},
+	"devDependencies": {
+		"@babel/core": "^7.28.5",
+		"@babel/preset-typescript": "^7.28.5",
+		"@types/bun": "latest",
+		"@types/node": "^24.0.0",
+		"babel-preset-solid": "1.9.9"
+	}
+}

package/src/index.ts

@@ -0,0 +1,121 @@
+/**
+ * @yeshwanthyk/open-tui
+ *
+ * OpenTUI-based Terminal User Interface with SolidJS reactive rendering
+ */
+
+import "./opentui-augmentations.js"
+
+// Re-export commonly used OpenTUI types and utilities
+export {
+	BoxRenderable,
+	// Renderer config
+	type CliRendererConfig,
+	type ColorInput,
+	InputRenderable,
+	MouseButton,
+	// Mouse events
+	MouseEvent,
+	// Color utilities
+	parseColor,
+	// Renderable types for advanced usage
+	type Renderable,
+	ScrollBoxRenderable,
+	SelectRenderable,
+	// Text attributes
+	TextAttributes,
+	TextareaRenderable,
+	TextRenderable,
+} from "@opentui/core"
+// Re-export SolidJS render and hooks
+export { render, testRender } from "@opentui/solid"
+// App entry point
+export { type AppConfig, startApp } from "./app.js"
+export {
+	type CliRenderer,
+	type KeyEvent,
+	onResize,
+	type PasteEvent,
+	RendererContext,
+	type Selection,
+	useRenderer,
+	useSelectionHandler,
+	useTerminalDimensions,
+} from "./context/terminal.js"
+// Context providers
+export {
+	BUILTIN_THEMES,
+	createSyntaxStyle,
+	RGBA,
+	type SyntaxVariant,
+	type Theme,
+	type ThemeColors,
+	type ThemeMode,
+	ThemeProvider,
+	type ThemeProviderProps,
+	toRGBA,
+	useTheme,
+} from "./context/theme.js"
+export type { UseKeyboardOptions } from "./hooks/use-keyboard.js"
+// Hooks
+export { useKeyboard, usePaste } from "./hooks/use-keyboard.js"
+// Utilities
+export { copyToClipboard } from "./utils/clipboard.js"
+export {
+	stripAnsi,
+	truncateToWidth,
+	visibleWidth,
+} from "./utils/text-width.js"
+// Components
+export { Editor, Input, type EditorProps, type EditorRef, type EditorTheme, type InputProps } from "./components/editor.js"
+export {
+	getCellDimensions,
+	getCapabilities,
+	getImageDimensions,
+	Image,
+	type ImageDimensions,
+	type ImageProps,
+	type ImageProtocol,
+	resetCapabilitiesCache,
+	setCellDimensions,
+	type TerminalCapabilities,
+} from "./components/image.js"
+export { Loader, type LoaderProps } from "./components/loader.js"
+export { Markdown, type MarkdownProps, type MarkdownTheme } from "./components/markdown.js"
+export {
+	SelectList,
+	SelectListKeys,
+	type SelectItem,
+	type SelectListProps,
+	type SelectListRef,
+	type SelectListTheme,
+} from "./components/select-list.js"
+export { Spacer, type SpacerProps } from "./components/spacer.js"
+export { Badge, type BadgeProps, type BadgeVariant } from "./components/badge.js"
+export { CodeBlock, type CodeBlockProps } from "./components/code-block.js"
+export { Dialog, type DialogProps } from "./components/dialog.js"
+export { Diff, type DiffProps, type DiffView, type DiffWrapMode } from "./components/diff.js"
+export { Divider, type DividerOrientation, type DividerProps } from "./components/divider.js"
+export { Panel, type PanelProps, type PanelVariant } from "./components/panel.js"
+export {
+	Toast,
+	ToastViewport,
+	type ToastItem,
+	type ToastVariant,
+	type ToastViewportPosition,
+	type ToastViewportProps,
+} from "./components/toast.js"
+
+// Autocomplete support
+export {
+	type AutocompleteItem,
+	type AutocompleteProvider,
+	CombinedAutocompleteProvider,
+	FileIndex,
+	type FileIndexOptions,
+	type FileSearchResult,
+	type SlashCommand,
+} from "./autocomplete/index.js"
+
+// Tree-sitter parser configuration
+export { parsersConfig } from "./parsers-config.js"