Metadata-Version: 2.4
Name: nest-ui
Version: 2.0.0
Summary: Nest UI - Terminal UI + Assistant Framework (Result Version)
Author: Nest UI Dev
License: MIT
Project-URL: Homepage, https://pypi.org/project/nest-ui/
Project-URL: Documentation, https://pypi.org/project/nest-ui/
Project-URL: Issues, https://pypi.org/project/nest-ui/
Project-URL: Source, https://pypi.org/project/nest-ui/
Keywords: terminal-ui,tui,assistant,dashboard,ops,developer-tools,voice-assistant,terminal-framework,launcher,monitoring
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorama>=0.4.6
Provides-Extra: voice
Requires-Dist: SpeechRecognition>=3.10.0; extra == "voice"
Provides-Extra: ops
Requires-Dist: psutil>=5.9.0; extra == "ops"
Provides-Extra: clipboard
Requires-Dist: pyperclip>=1.8.2; extra == "clipboard"
Provides-Extra: full
Requires-Dist: SpeechRecognition>=3.10.0; extra == "full"
Requires-Dist: psutil>=5.9.0; extra == "full"
Requires-Dist: pyperclip>=1.8.2; extra == "full"
Dynamic: license-file

# Nest UI — Result Version

> A polished, release-ready terminal UI framework scaffold for dashboards, assistants, launcher tools, ops panels, and developer utilities.

## Release codename

**Result Version**

## Highlights

- Beautiful terminal-friendly rendering
- Emoji-ready widget output
- Tabs and nested sections
- Table model with sort, filter, edit, and pagination support
- Forms and typed validation helpers
- Voice phrase matcher
- Assistant manager with cooldown and wake-word support
- Config manager
- Shortcut manager
- Event bus, plugin manager, widget registry
- Ops utilities:
  - task runner
  - background jobs
  - process monitor
  - port checker
  - health suite
  - dependency graph
  - scheduler
  - service controller
  - recent projects
  - workspace profiles
- CLI entry point
- Tests included
- PyPI upload-ready structure

---

## Install

### Core
```bash
pip install nest-ui
```

### Voice extras
```bash
pip install "nest-ui[voice]"
```

### Ops extras
```bash
pip install "nest-ui[ops]"
```

### Clipboard extras
```bash
pip install "nest-ui[clipboard]"
```

### Everything
```bash
pip install "nest-ui[full]"
```

---

## Requirements

### Core requirements
- Python **3.8+**
- `colorama>=0.4.6`

### Optional requirements

#### Voice / assistant
Install these when you want speech input or assistant-style controls:
- `SpeechRecognition>=3.10.0`

Some systems may also need:
- `PyAudio`

#### Ops / monitoring
Install these when you want process and system helpers:
- `psutil>=5.9.0`

#### Clipboard
Install this when you want copy / paste helpers:
- `pyperclip>=1.8.2`

---

## Quick start

```python
from nest_ui import App

app = App(theme="aurora", icon_pack="emoji")
window = app.create_window("Nest UI", "Result Version")

dashboard = window.create_tab("Dashboard").create_section("Overview")
dashboard.add_stat("CPU", "23%", tone="info")
dashboard.add_key_value("Workspace", "default")
dashboard.add_paragraph("Welcome", "Nest UI is ready.")
dashboard.add_progress("Build", 76)
dashboard.add_table(
    "Services",
    columns=["Name", "Type", "Status"],
    rows=[
        ["Gateway", "web", "online"],
        ["Bot Alpha", "discord", "offline"],
        ["API Server", "python", "online"],
    ],
    searchable=True,
    editable=True,
)

voice = dashboard.add_voice_command(
    "Voice Command",
    mode="hybrid",
    command_callback=lambda name, raw: window.log("VOICE", f"{name} -> {raw}")
)
voice.register_phrase("launch-roblox", "open roblox", "launch roblox", "เปิดเกม roblox")

window.log("INFO", "System initialized")
window.notify("✨ UI loaded")
window.run()
```

---

## Assistant example

```python
from nest_ui import AssistantManager

assistant = AssistantManager(name="Nest", wake_word="nest", cooldown_seconds=1.0)

assistant.register_command(
    "open_game",
    ["open roblox", "launch roblox", "เปิดเกม roblox"],
    callback=lambda text: {"action": "open_game", "heard": text}
)

result = assistant.hear("nest open roblox")
print(result)
```

---

## What is included

### Core UI
- `App`
- `Window`
- `Tab`
- `Section`
- `Widget`

### Managers
- `ThemeManager`
- `ConfigManager`
- `ShortcutManager`
- `AssistantManager`

### Data / forms
- `TableModel`
- `FieldSpec`
- `FormSchema`
- `Validators`

### Extensibility
- `EventBus`
- `PluginBase`
- `PluginManager`
- `WidgetRegistry`

### Voice
- `PhraseMatcher`
- `VoiceCommand`

### Ops
- `TaskRunner`
- `BackgroundJobManager`
- `ProcessMonitor`
- `PortChecker`
- `HealthSuite`
- `DependencyGraph`
- `Scheduler`
- `ServiceController`
- `RecentProjects`
- `WorkspaceProfiles`

---

## Release workflow

### Local development
```bash
pip install -e ".[full]"
pytest -q
```

### Build
```bash
python -m build
twine check dist/*
```

### Upload
```bash
twine upload dist/*
```

---

## Versioning

- Package version: **2.0.0**
- Release codename: **Result Version**

Use:
- patch releases for fixes
- minor releases for features
- major releases for breaking API changes

---

## Notes

This package is structured to be upload-ready and maintainable.  
If you already have a fuller internal Nest UI codebase, merge its richer internals into this release structure to publish cleanly.

