connectonion 0.6.2__py3-none-any.whl → 0.6.3__py3-none-any.whl

connectonion/cli/co_ai/prompts/connectonion/tui/dropdown.md

@@ -0,0 +1,83 @@
+# Dropdown
+
+Selection list component for autocomplete menus.
+
+## Quick Start
+
+```python
+from connectonion.tui import Dropdown, DropdownItem
+
+# Create items
+items = [
+    DropdownItem(display="/today", value="/today", description="Daily briefing"),
+    DropdownItem(display="/inbox", value="/inbox", description="Show emails"),
+]
+
+# Create dropdown
+dropdown = Dropdown(items, max_visible=5, style="modern")
+```
+
+## DropdownItem
+
+Structured item with rich metadata.
+
+```python
+from connectonion.tui import DropdownItem
+
+# Simple item
+item = DropdownItem(display="/today", value="/today")
+
+# With description
+item = DropdownItem(
+    display="/today",
+    value="/today",
+    description="Daily email briefing",
+    icon="📅"
+)
+
+# Contact style
+item = DropdownItem(
+    display="Davis Baer",
+    value="davis@oneupapp.io",
+    description="davis@oneupapp.io",
+    subtitle="OneUp · founder",
+    icon="👤"
+)
+```
+
+## API
+
+### DropdownItem
+
+```python
+DropdownItem(
+    display: str,          # Main text to show
+    value: Any,            # Value returned when selected
+    score: int = 0,        # Match score for sorting
+    positions: list = [],  # Matched char positions (for highlighting)
+    description: str = "", # Secondary text
+    subtitle: str = "",    # Third line
+    icon: str = "",        # Left icon (emoji)
+    style: str = "",       # Rich style
+)
+```
+
+### Dropdown
+
+```python
+Dropdown(
+    items: list[DropdownItem],
+    max_visible: int = 8,
+    selected: int = 0,
+    style: str = "modern",
+)
+```
+
+## File Icons
+
+Built-in icons for common file types:
+- 📁 folder
+- 📄 file (default)
+- 🐍 .py
+- 📜 .js, .ts
+- ⚙️ .json, .yaml

connectonion/cli/co_ai/prompts/connectonion/tui/footer.md

@@ -0,0 +1,44 @@
+# Footer
+
+Simple footer with tips/hints display.
+
+## Quick Start
+
+```python
+from connectonion.tui import Footer
+from rich.console import Console
+
+console = Console()
+
+footer = Footer(["? help", "/ commands", "@ contacts"])
+console.print(footer.render())
+```
+
+## Output
+
+```
+? help  / commands  @ contacts
+```
+
+## API
+
+```python
+Footer(tips: list[str])
+```
+
+### Methods
+
+```python
+footer.render() -> Text  # Returns Rich Text object
+```
+
+## Usage with Input
+
+```python
+from connectonion.tui import Input, Footer
+
+# Footer tips shown below input
+text = Input(
+    hints=["? help", "/ commands", "Enter submit"]
+).run()
+```

connectonion/cli/co_ai/prompts/connectonion/tui/fuzzy.md

@@ -0,0 +1,68 @@
+# fuzzy
+
+Fuzzy matching utilities for autocomplete.
+
+## Quick Start
+
+```python
+from connectonion.tui import fuzzy_match, highlight_match
+
+# Check if query matches text
+matched, score, positions = fuzzy_match("gp", "gpt-4")
+# matched: True
+# score: 16 (higher = better)
+# positions: [0, 1] (matched char indices)
+```
+
+## fuzzy_match
+
+Match query against text with scoring.
+
+```python
+from connectonion.tui import fuzzy_match
+
+matched, score, positions = fuzzy_match(query, text)
+```
+
+### Scoring
+
+- **+1** per matched character
+- **+10** consecutive character bonus
+- **+5** word boundary bonus (after `/_-. `)
+
+### Examples
+
+```python
+fuzzy_match("gp", "gpt-4")     # (True, 16, [0, 1])
+fuzzy_match("g4", "gpt-4")     # (True, 7, [0, 4])
+fuzzy_match("xyz", "gpt-4")    # (False, 0, [])
+fuzzy_match("", "anything")    # (True, 0, [])
+```
+
+## highlight_match
+
+Highlight matched characters in Rich Text.
+
+```python
+from connectonion.tui import highlight_match
+from rich.console import Console
+
+console = Console()
+
+# Get match positions
+matched, score, positions = fuzzy_match("gp", "gpt-4")
+
+# Create highlighted text
+text = highlight_match("gpt-4", positions)
+console.print(text)  # "gp" highlighted in magenta
+```
+
+## API
+
+```python
+fuzzy_match(query: str, text: str) -> tuple[bool, int, list[int]]
+# Returns: (matched, score, positions)
+
+highlight_match(text: str, positions: list[int]) -> Text
+# Returns: Rich Text with matched chars highlighted
+```

connectonion/cli/co_ai/prompts/connectonion/tui/input.md

@@ -0,0 +1,84 @@
+# Input
+
+Smart text input with trigger-based autocomplete.
+
+## Quick Start
+
+```python
+from connectonion.tui import Input
+
+# Simple input
+text = Input().run()
+
+# With file autocomplete
+from connectonion.tui import FileProvider
+text = Input(triggers={"@": FileProvider()}).run()
+```
+
+## Features
+
+### Trigger Autocomplete
+
+```python
+from connectonion.tui import Input, FileProvider, StaticProvider
+
+# @ triggers file browser
+text = Input(triggers={"@": FileProvider()}).run()
+# User types: "edit @src/" → shows file dropdown
+
+# / triggers command palette
+commands = StaticProvider([("/today", "/today"), ("/inbox", "/inbox")])
+text = Input(triggers={"/": commands}).run()
+```
+
+### Hints and Tips
+
+```python
+text = Input(
+    hints=["/ commands", "@ files", "Enter submit"],
+    tips=["Try /today for briefing", "Join Discord!"],
+    divider=True,
+).run()
+```
+
+## API
+
+```python
+Input(
+    prompt: str = None,       # Custom prompt text
+    triggers: dict = None,    # {char: Provider} for autocomplete
+    hints: list[str] = None,  # Always-visible hints
+    tips: list[str] = None,   # Rotating tips
+    divider: bool = False,    # Add horizontal dividers
+    max_visible: int = 8,     # Max dropdown items
+    console: Console = None,
+    style: str = "modern",    # "modern", "minimal", "classic"
+).run() -> str
+```
+
+## Styles
+
+- **modern** - Magenta prompt, clean design
+- **minimal** - Bare bones, no decorations
+- **classic** - Traditional input style
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Submit input or accept selection |
+| `Tab` | Accept autocomplete selection |
+| `Escape` | Cancel autocomplete |
+| `↑` / `↓` | Navigate dropdown |
+| `Ctrl+C` | Cancel input |
+| `Ctrl+D` | Exit |
+
+## Paste Handling
+
+Input uses **bracketed paste mode** for reliable paste detection:
+
+- Pasted text is handled atomically (no display glitches)
+- Works with any terminal that supports bracketed paste
+- Automatically enabled/disabled during input
+
+This prevents the common issue of pasted text causing multiple prompt lines or character loss.

connectonion/cli/co_ai/prompts/connectonion/tui/keys.md

@@ -0,0 +1,77 @@
+# keys
+
+Low-level keyboard input primitives.
+
+## Quick Start
+
+```python
+from connectonion.tui import getch, read_key
+
+# Read single character
+ch = getch()  # Blocks until keypress
+
+# Read key with arrow handling
+key = read_key()  # Returns 'up', 'down', etc.
+```
+
+## getch
+
+Read single character without waiting for Enter.
+
+```python
+from connectonion.tui import getch
+
+ch = getch()
+# Returns: 'a', '1', '\n', etc.
+```
+
+Works on both Unix (termios) and Windows (msvcrt).
+
+## read_key
+
+Read key with arrow/escape sequence handling.
+
+```python
+from connectonion.tui import read_key
+
+key = read_key()
+```
+
+### Return Values
+
+| Input | Returns |
+|-------|---------|
+| Arrow Up | `'up'` |
+| Arrow Down | `'down'` |
+| Arrow Left | `'left'` |
+| Arrow Right | `'right'` |
+| Escape | `'esc'` |
+| Enter | `'\n'` or `'\r'` |
+| Regular char | The character |
+
+## Example: Navigation Loop
+
+```python
+from connectonion.tui import read_key
+
+selected = 0
+options = ["Option A", "Option B", "Option C"]
+
+while True:
+    key = read_key()
+
+    if key == 'up':
+        selected = max(0, selected - 1)
+    elif key == 'down':
+        selected = min(len(options) - 1, selected + 1)
+    elif key == '\n':
+        break  # Selected
+    elif key == 'esc':
+        selected = -1
+        break  # Cancelled
+```
+
+## Platform Support
+
+- **Unix/macOS**: Uses `termios` + `tty`
+- **Windows**: Uses `msvcrt`

connectonion/cli/co_ai/prompts/connectonion/tui/pick.md

@@ -0,0 +1,71 @@
+# pick
+
+Single-select menu with keyboard navigation.
+
+## Quick Start
+
+```python
+from connectonion.tui import pick
+
+choice = pick("Pick a color", ["Red", "Green", "Blue"])
+# Press 1 → "Red", 2 → "Green", 3 → "Blue"
+# Or use arrow keys + Enter
+```
+
+## Options
+
+### Simple List
+
+```python
+choice = pick("Select model", ["gpt-4", "claude-3", "gemini"])
+# Returns: "gpt-4" (selected string)
+```
+
+### With Descriptions
+
+```python
+choice = pick("Send email?", [
+    ("Yes, send it", "Send immediately"),
+    ("Auto approve", "Skip approval for this recipient"),
+    ("No", "Cancel"),
+])
+```
+
+### With "Other" Option
+
+```python
+choice = pick("Continue?", ["Yes", "No"], other=True)
+# Adds "Other..." option for custom text input
+```
+
+## Keyboard Controls
+
+| Key | Action |
+|-----|--------|
+| ↑/↓ | Navigate |
+| 1-9 | Jump to option |
+| Enter | Confirm |
+| Esc | Cancel |
+
+## API
+
+```python
+pick(
+    title: str,           # Question to display
+    options: list,        # Strings or (label, description) tuples
+    other: bool = False,  # Add "Other..." option
+    console: Console = None
+) -> str                  # Returns selected label
+```
+
+## Example Output
+
+```
+Pick a color
+
+  ❯ 1  Red
+    2  Green
+    3  Blue
+
+↑↓ navigate  1-9 jump  Enter select
+```

connectonion/cli/co_ai/prompts/connectonion/tui/providers.md

@@ -0,0 +1,89 @@
+# providers
+
+Data providers for autocomplete in Input and CommandPalette.
+
+## Quick Start
+
+```python
+from connectonion.tui import Input, FileProvider, StaticProvider
+
+# File autocomplete
+text = Input(triggers={"@": FileProvider()}).run()
+
+# Command autocomplete
+commands = StaticProvider([
+    ("/today", "/today", "Daily briefing"),
+    ("/inbox", "/inbox", "Show emails"),
+])
+text = Input(triggers={"/": commands}).run()
+```
+
+## StaticProvider
+
+Provider for static list of items.
+
+```python
+from connectonion.tui import StaticProvider
+
+# Simple (display, value)
+provider = StaticProvider([
+    ("/today", "/today"),
+    ("/inbox", "/inbox"),
+])
+
+# With descriptions
+provider = StaticProvider([
+    ("/today", "/today", "Daily email briefing"),
+    ("/inbox", "/inbox", "Show recent emails"),
+])
+
+# With icons
+provider = StaticProvider([
+    ("/today", "/today", "Daily briefing", "📅"),
+    ("/inbox", "/inbox", "Show emails", "📥"),
+])
+```
+
+## FileProvider
+
+Provider for filesystem autocomplete.
+
+```python
+from connectonion.tui import FileProvider
+
+# Default: current directory
+provider = FileProvider()
+
+# Custom root
+provider = FileProvider(root="src/")
+
+# Results include:
+# - Folders with 📁 icon
+# - Files with type-specific icons
+# - Fuzzy matched against query
+```
+
+## Custom Provider
+
+Implement the Provider protocol:
+
+```python
+from connectonion.tui import DropdownItem
+
+class MyProvider:
+    def search(self, query: str) -> list[DropdownItem]:
+        # Return matching items
+        return [
+            DropdownItem(display="Result", value="result"),
+        ]
+```
+
+## Provider Protocol
+
+```python
+class Provider(Protocol):
+    def search(self, query: str) -> list[DropdownItem]:
+        ...
+```
+
+Returns list of `DropdownItem` or tuples `(display, value, score, positions)`.

connectonion/cli/co_ai/prompts/connectonion/tui/status_bar.md

@@ -0,0 +1,67 @@
+# StatusBar
+
+Powerline-style status bar with colored segments.
+
+## Quick Start
+
+```python
+from connectonion.tui import StatusBar
+from rich.console import Console
+
+console = Console()
+
+status = StatusBar([
+    ("🤖", "co/gemini-2.5-pro", "magenta"),
+    ("📊", "50%", "green"),
+    ("", "main", "blue"),
+])
+console.print(status.render())
+```
+
+## Segments
+
+### Text Segments
+
+```python
+# (icon, text, color)
+segments = [
+    ("🤖", "gpt-4", "magenta"),
+    ("💰", "$0.02", "yellow"),
+    ("", "main", "blue"),
+]
+```
+
+### Progress Segments
+
+```python
+from connectonion.tui import StatusBar, ProgressSegment
+
+status = StatusBar([
+    ("🤖", "gpt-4", "magenta"),
+    ProgressSegment(percent=78, bg_color="green"),
+])
+# Output: 🤖 gpt-4  ████████░░ 78%
+```
+
+## ProgressSegment
+
+```python
+ProgressSegment(
+    percent: float,        # 0-100, how much used
+    bg_color: str = "green",
+    width: int = 10,
+    show_percent: bool = True,
+)
+```
+
+## Styles
+
+- Uses powerline arrows for segment transitions
+- Falls back to unicode on terminals without powerline fonts
+- Works on both light and dark terminals
+
+## Example Output
+
+```
+🤖 co/gemini-2.5-pro  📊 50%   main
+```