KTrex 0.1.5__tar.gz

ktrex-0.1.5/KTrex.egg-info/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: KTrex
+Version: 0.1.5
+Summary: Interactive terminal-based directory structure builder
+Author: AK
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# KTrex 
+
+**KTrex** is an interactive, terminal-based directory and file structure builder.  
+It lets you visually create, navigate, undo, save, load, and reuse project layouts
+directly from a curses-based TUI — safely and deterministically.
+
+> Think: `mkdir` + `tree` + `undo` + `presets` + `resume`, all in one tool.
+
+---
+
+## Features
+
+- Interactive terminal UI (arrow-key driven)
+- Create directories and files visually
+- Safe undo (never deletes non-empty directories)
+- Presets (builtin or external JSON)
+- Save project structure to JSON
+- Load and resume saved structures
+- Non-destructive by design (no overwrites, no forced deletes)
+- Works offline, zero runtime dependencies
+- Scrollable tree view (keyboard + mouse)
+
+---
+
+## Installation
+
+### Using pip (recommended)
+
+```bash
+pip install KTrex
+````
+
+### Editable install (for development)
+
+```bash
+git clone https://github.com/yourusername/KTrex.git
+cd KTrex
+pip install -e .
+```
+
+---
+
+## ▶️ Usage
+
+Run KTrex inside any directory:
+
+```bash
+KTrex
+```
+
+You’ll be dropped into an interactive TUI showing your project tree and available actions.
+
+---
+
+## Controls
+
+| Key                   | Action                         |
+|-----------------------|--------------------------------|
+| ↑ / ↓                 | Navigate menu                  |
+| Enter                 | Select highlighted action      |
+| PageUp / PageDown     | Scroll tree view               |
+| Ctrl + U / Ctrl + D   | Scroll tree view               |
+| Mouse Wheel           | Scroll tree view               |
+| Any key               | Dismiss messages / dialogs     |
+| Quit                  | Exit KTrex safely               |
+
+---
+
+## Actions Explained
+
+### Create Directory
+
+* Creates a new directory in the current location
+* Automatically enters the directory
+
+### Create File
+
+* Creates a file in the current directory
+* Does **not** change navigation
+
+### Undo
+
+* Reverts the most recent create action
+* Only removes files or **empty directories**
+* Never deletes non-empty directories
+
+### Load Preset
+
+* Load a predefined structure by name or file path
+* Presets are **additive**, never destructive
+
+### Save Structure
+
+* Serialize the entire project tree to a JSON file
+* Useful for reuse, backups, or AI-assisted generation
+
+### Load Structure
+
+* Load a previously saved structure JSON
+* Applies safely without removing existing files
+
+### Go Back
+
+* Navigate to parent directory
+* Cannot escape project root
+
+### Help
+
+* View built-in documentation and keybindings
+
+---
+
+## Presets
+
+### Built-in presets
+
+```text
+ml_project
+```
+
+Usage:
+
+```
+Load Preset → ml_project
+```
+
+### External presets
+
+```text
+Load Preset → /path/to/custom_preset.json
+```
+
+Preset format is documented below.
+
+---
+
+## Preset / Structure Format
+
+KTrex uses a simple, declarative JSON format:
+
+```json
+{
+  "name": "project",
+  "type": "dir",
+  "children": [
+    {
+      "name": "src",
+      "type": "dir",
+      "children": [
+        { "name": "main.py", "type": "file" }
+      ]
+    }
+  ]
+}
+```
+
+This format is shared by:
+
+* presets
+* saved structures
+* AI-generated layouts
+
+---
+
+## Safety Guarantees
+
+KTrex is designed to be **safe by default**:
+
+* ❌ Never overwrites files
+* ❌ Never deletes non-empty directories
+* ❌ Never escapes project root
+* ✅ Undo is leaf-only and predictable
+* ✅ All destructive actions are explicit
+
+---
+
+Nice question — README polish matters a lot, especially if you want your repo to look **professional + sponsor-friendly**.
+
+Below are **clean, modern ways** to upgrade both the **License** and **Sponsor** sections without overdoing it.
+
+---
+
+## 📜 License
+
+This project is licensed under the **MIT License**.  
+You are free to use, modify, and distribute this software with proper attribution.
+
+See the [LICENSE](./LICENSE) file for details.
+
+
+## 💖 Sponsor
+
+If you find this project useful and want to support its development:
+
+[![Ko-Fi](https://img.shields.io/badge/☕%20Buy%20Me%20a%20Coffee-ko--fi-red)](https://ko-fi.com/akris)
+
+Your support helps keep this project alive and actively maintained.

ktrex-0.1.5/KTrex.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+KTrex.egg-info/PKG-INFO
+KTrex.egg-info/SOURCES.txt
+KTrex.egg-info/dependency_links.txt
+KTrex.egg-info/entry_points.txt
+KTrex.egg-info/top_level.txt
+ktrex/__init__.py
+ktrex/fs.py
+ktrex/main.py
+ktrex/presets.py
+ktrex/render.py
+ktrex/state.py
+ktrex/tree.py
+ktrex/tui.py

ktrex-0.1.5/KTrex.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ktrex-0.1.5/KTrex.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+KTrex = KTrex.main:main

ktrex-0.1.5/KTrex.egg-info/top_level.txt

@@ -0,0 +1 @@
+ktrex

ktrex-0.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ktrex-0.1.5/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: KTrex
+Version: 0.1.5
+Summary: Interactive terminal-based directory structure builder
+Author: AK
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# KTrex 
+
+**KTrex** is an interactive, terminal-based directory and file structure builder.  
+It lets you visually create, navigate, undo, save, load, and reuse project layouts
+directly from a curses-based TUI — safely and deterministically.
+
+> Think: `mkdir` + `tree` + `undo` + `presets` + `resume`, all in one tool.
+
+---
+
+## Features
+
+- Interactive terminal UI (arrow-key driven)
+- Create directories and files visually
+- Safe undo (never deletes non-empty directories)
+- Presets (builtin or external JSON)
+- Save project structure to JSON
+- Load and resume saved structures
+- Non-destructive by design (no overwrites, no forced deletes)
+- Works offline, zero runtime dependencies
+- Scrollable tree view (keyboard + mouse)
+
+---
+
+## Installation
+
+### Using pip (recommended)
+
+```bash
+pip install KTrex
+````
+
+### Editable install (for development)
+
+```bash
+git clone https://github.com/yourusername/KTrex.git
+cd KTrex
+pip install -e .
+```
+
+---
+
+## ▶️ Usage
+
+Run KTrex inside any directory:
+
+```bash
+KTrex
+```
+
+You’ll be dropped into an interactive TUI showing your project tree and available actions.
+
+---
+
+## Controls
+
+| Key                   | Action                         |
+|-----------------------|--------------------------------|
+| ↑ / ↓                 | Navigate menu                  |
+| Enter                 | Select highlighted action      |
+| PageUp / PageDown     | Scroll tree view               |
+| Ctrl + U / Ctrl + D   | Scroll tree view               |
+| Mouse Wheel           | Scroll tree view               |
+| Any key               | Dismiss messages / dialogs     |
+| Quit                  | Exit KTrex safely               |
+
+---
+
+## Actions Explained
+
+### Create Directory
+
+* Creates a new directory in the current location
+* Automatically enters the directory
+
+### Create File
+
+* Creates a file in the current directory
+* Does **not** change navigation
+
+### Undo
+
+* Reverts the most recent create action
+* Only removes files or **empty directories**
+* Never deletes non-empty directories
+
+### Load Preset
+
+* Load a predefined structure by name or file path
+* Presets are **additive**, never destructive
+
+### Save Structure
+
+* Serialize the entire project tree to a JSON file
+* Useful for reuse, backups, or AI-assisted generation
+
+### Load Structure
+
+* Load a previously saved structure JSON
+* Applies safely without removing existing files
+
+### Go Back
+
+* Navigate to parent directory
+* Cannot escape project root
+
+### Help
+
+* View built-in documentation and keybindings
+
+---
+
+## Presets
+
+### Built-in presets
+
+```text
+ml_project
+```
+
+Usage:
+
+```
+Load Preset → ml_project
+```
+
+### External presets
+
+```text
+Load Preset → /path/to/custom_preset.json
+```
+
+Preset format is documented below.
+
+---
+
+## Preset / Structure Format
+
+KTrex uses a simple, declarative JSON format:
+
+```json
+{
+  "name": "project",
+  "type": "dir",
+  "children": [
+    {
+      "name": "src",
+      "type": "dir",
+      "children": [
+        { "name": "main.py", "type": "file" }
+      ]
+    }
+  ]
+}
+```
+
+This format is shared by:
+
+* presets
+* saved structures
+* AI-generated layouts
+
+---
+
+## Safety Guarantees
+
+KTrex is designed to be **safe by default**:
+
+* ❌ Never overwrites files
+* ❌ Never deletes non-empty directories
+* ❌ Never escapes project root
+* ✅ Undo is leaf-only and predictable
+* ✅ All destructive actions are explicit
+
+---
+
+Nice question — README polish matters a lot, especially if you want your repo to look **professional + sponsor-friendly**.
+
+Below are **clean, modern ways** to upgrade both the **License** and **Sponsor** sections without overdoing it.
+
+---
+
+## 📜 License
+
+This project is licensed under the **MIT License**.  
+You are free to use, modify, and distribute this software with proper attribution.
+
+See the [LICENSE](./LICENSE) file for details.
+
+
+## 💖 Sponsor
+
+If you find this project useful and want to support its development:
+
+[![Ko-Fi](https://img.shields.io/badge/☕%20Buy%20Me%20a%20Coffee-ko--fi-red)](https://ko-fi.com/akris)
+
+Your support helps keep this project alive and actively maintained.

ktrex-0.1.5/README.md

@@ -0,0 +1,197 @@
+# KTrex 
+
+**KTrex** is an interactive, terminal-based directory and file structure builder.  
+It lets you visually create, navigate, undo, save, load, and reuse project layouts
+directly from a curses-based TUI — safely and deterministically.
+
+> Think: `mkdir` + `tree` + `undo` + `presets` + `resume`, all in one tool.
+
+---
+
+## Features
+
+- Interactive terminal UI (arrow-key driven)
+- Create directories and files visually
+- Safe undo (never deletes non-empty directories)
+- Presets (builtin or external JSON)
+- Save project structure to JSON
+- Load and resume saved structures
+- Non-destructive by design (no overwrites, no forced deletes)
+- Works offline, zero runtime dependencies
+- Scrollable tree view (keyboard + mouse)
+
+---
+
+## Installation
+
+### Using pip (recommended)
+
+```bash
+pip install KTrex
+````
+
+### Editable install (for development)
+
+```bash
+git clone https://github.com/yourusername/KTrex.git
+cd KTrex
+pip install -e .
+```
+
+---
+
+## ▶️ Usage
+
+Run KTrex inside any directory:
+
+```bash
+KTrex
+```
+
+You’ll be dropped into an interactive TUI showing your project tree and available actions.
+
+---
+
+## Controls
+
+| Key                   | Action                         |
+|-----------------------|--------------------------------|
+| ↑ / ↓                 | Navigate menu                  |
+| Enter                 | Select highlighted action      |
+| PageUp / PageDown     | Scroll tree view               |
+| Ctrl + U / Ctrl + D   | Scroll tree view               |
+| Mouse Wheel           | Scroll tree view               |
+| Any key               | Dismiss messages / dialogs     |
+| Quit                  | Exit KTrex safely               |
+
+---
+
+## Actions Explained
+
+### Create Directory
+
+* Creates a new directory in the current location
+* Automatically enters the directory
+
+### Create File
+
+* Creates a file in the current directory
+* Does **not** change navigation
+
+### Undo
+
+* Reverts the most recent create action
+* Only removes files or **empty directories**
+* Never deletes non-empty directories
+
+### Load Preset
+
+* Load a predefined structure by name or file path
+* Presets are **additive**, never destructive
+
+### Save Structure
+
+* Serialize the entire project tree to a JSON file
+* Useful for reuse, backups, or AI-assisted generation
+
+### Load Structure
+
+* Load a previously saved structure JSON
+* Applies safely without removing existing files
+
+### Go Back
+
+* Navigate to parent directory
+* Cannot escape project root
+
+### Help
+
+* View built-in documentation and keybindings
+
+---
+
+## Presets
+
+### Built-in presets
+
+```text
+ml_project
+```
+
+Usage:
+
+```
+Load Preset → ml_project
+```
+
+### External presets
+
+```text
+Load Preset → /path/to/custom_preset.json
+```
+
+Preset format is documented below.
+
+---
+
+## Preset / Structure Format
+
+KTrex uses a simple, declarative JSON format:
+
+```json
+{
+  "name": "project",
+  "type": "dir",
+  "children": [
+    {
+      "name": "src",
+      "type": "dir",
+      "children": [
+        { "name": "main.py", "type": "file" }
+      ]
+    }
+  ]
+}
+```
+
+This format is shared by:
+
+* presets
+* saved structures
+* AI-generated layouts
+
+---
+
+## Safety Guarantees
+
+KTrex is designed to be **safe by default**:
+
+* ❌ Never overwrites files
+* ❌ Never deletes non-empty directories
+* ❌ Never escapes project root
+* ✅ Undo is leaf-only and predictable
+* ✅ All destructive actions are explicit
+
+---
+
+Nice question — README polish matters a lot, especially if you want your repo to look **professional + sponsor-friendly**.
+
+Below are **clean, modern ways** to upgrade both the **License** and **Sponsor** sections without overdoing it.
+
+---
+
+## 📜 License
+
+This project is licensed under the **MIT License**.  
+You are free to use, modify, and distribute this software with proper attribution.
+
+See the [LICENSE](./LICENSE) file for details.
+
+
+## 💖 Sponsor
+
+If you find this project useful and want to support its development:
+
+[![Ko-Fi](https://img.shields.io/badge/☕%20Buy%20Me%20a%20Coffee-ko--fi-red)](https://ko-fi.com/akris)
+
+Your support helps keep this project alive and actively maintained.

ktrex-0.1.5/ktrex/fs.py

@@ -0,0 +1,49 @@
+from pathlib import Path
+from .state import history
+
+def create_dir(base: Path, name: str) -> Path | None:
+    if not name:
+        return None
+
+    p = base / name
+    if p.exists():
+        return None
+
+    p.mkdir()
+    history.append(p)
+    return p
+
+
+def create_file(base: Path, name: str) -> Path | None:
+    if not name:
+        return None
+
+    p = base / name
+    if p.exists():
+        return None
+
+    p.touch()
+    history.append(p)
+    return p
+
+
+def undo_last():
+    if not history:
+        return False
+
+    p = history.pop()
+
+    if p.is_file():
+        p.unlink()
+        return True
+
+    if p.is_dir():
+        # SAFE UNDO: only remove empty dirs
+        if any(p.iterdir()):
+            history.append(p)  # rollback undo
+            return False
+        p.rmdir()
+        return True
+
+    return False
+

ktrex-0.1.5/ktrex/main.py

@@ -0,0 +1,46 @@
+import curses
+import sys
+from pathlib import Path
+
+from KTrex import state
+from KTrex.tui import tui_main
+
+
+def resolve_root(argv: list[str]) -> Path:
+    # Resolve project root directory from CLI arguments.
+    if len(argv) == 1:
+        # No argument → ask user
+        name = input("Project directory name (or . for current): ").strip()
+        if not name:
+            raise ValueError("Project directory name cannot be empty")
+        return Path(name)
+
+    arg = argv[1]
+
+    if arg == ".":
+        return Path.cwd()
+
+    return Path(arg)
+
+
+def main():
+    try:
+        root = resolve_root(sys.argv)
+    except ValueError as e:
+        print(f"Error: {e}")
+        return
+
+    root = root.expanduser().resolve()
+
+    # Create directory only if it does not exist
+    root.mkdir(parents=True, exist_ok=True)
+    # Clean initialization
+    state.root_dir = root
+    state.path_stack = [root]
+    state.history.clear()
+
+    curses.wrapper(tui_main)
+
+
+if __name__ == "__main__":
+    main()

ktrex-0.1.5/ktrex/presets.py

@@ -0,0 +1,27 @@
+import json
+from pathlib import Path
+
+from .tree import apply_tree
+
+
+def _builtin_preset_path(name: str) -> Path:
+    # Resolve a preset bundled inside the KTrex package.
+
+    return Path(__file__).parent / "presets" / f"{name}.json"
+
+
+def load_preset(preset: str | Path, base: Path):
+    # Load a preset by name (builtin) or by explicit file path.
+
+    if isinstance(preset, str):
+        path = _builtin_preset_path(preset)
+    else:
+        path = preset
+
+    if not path.exists():
+        raise FileNotFoundError(f"Preset not found: {path}")
+
+    with open(path, "r") as f:
+        data = json.load(f)
+
+    apply_tree(base, data)

ktrex-0.1.5/ktrex/render.py

@@ -0,0 +1,44 @@
+from pathlib import Path
+
+
+def render_tree(
+    root: Path,
+    current: Path | None = None,
+    prefix: str = "",
+) -> list[str]:
+    """
+    Render a directory tree as a list of strings.
+
+    Args:
+        root: root directory to render
+        current: directory to highlight (optional)
+        prefix: internal prefix for recursion
+
+    Returns:
+        List of rendered lines
+    """
+    lines: list[str] = []
+
+    items = sorted(
+        root.iterdir(),
+        key=lambda x: (x.is_file(), x.name.lower()),
+    )
+
+    for idx, item in enumerate(items):
+        is_last = idx == len(items) - 1
+        branch = "└── " if is_last else "├── "
+        marker = "  ← current" if current and item == current else ""
+
+        lines.append(f"{prefix}{branch}{item.name}{marker}")
+
+        if item.is_dir():
+            extension = "    " if is_last else "│   "
+            lines.extend(
+                render_tree(
+                    item,
+                    current=current,
+                    prefix=prefix + extension,
+                )
+            )
+
+    return lines

ktrex-0.1.5/ktrex/state.py

@@ -0,0 +1,11 @@
+from pathlib import Path
+
+# Root directory of the session
+root_dir: Path | None = None
+
+# Stack-based navigation (no recursion)
+path_stack: list[Path] = []
+
+# Undo stack (only last-created leaf nodes)
+history: list[Path] = []
+

ktrex-0.1.5/ktrex/tree.py

@@ -0,0 +1,26 @@
+from pathlib import Path
+
+
+def build_tree(path: Path) -> dict:
+    # Convert filesystem into a serializable tree structure
+    node = {"name": path.name, "type": "dir", "children": []}
+
+    for p in sorted(path.iterdir(), key=lambda x: (x.is_file(), x.name)):
+        if p.is_dir():
+            node["children"].append(build_tree(p))
+        else:
+            node["children"].append({"name": p.name, "type": "file"})
+
+    return node
+
+
+def apply_tree(base: Path, tree: dict):
+    # Create filesystem structure from a tree model
+    for child in tree.get("children", []):
+        p = base / child["name"]
+
+        if child["type"] == "dir":
+            p.mkdir(exist_ok=True)
+            apply_tree(p, child)
+        else:
+            p.touch(exist_ok=True)

ktrex-0.1.5/ktrex/tui.py

@@ -0,0 +1,251 @@
+import curses
+import json
+from pathlib import Path
+
+from . import state
+from .fs import create_dir, create_file, undo_last
+from .presets import load_preset
+from .render import render_tree
+from .tree import apply_tree, build_tree
+
+MENU_ITEMS = [
+    "Create Directory",
+    "Create File",
+    "Undo",
+    "Load Preset",
+    "Save Structure",
+    "Load Structure",
+    "Go Back",
+    "Help",
+    "Quit",
+]
+
+HELP_TEXT = [
+    "KTrex — Interactive Directory Builder",
+    "",
+    "Navigation:",
+    "  ↑ / ↓     Move through menu",
+    "  Enter     Select action",
+    "",
+    "Actions:",
+    "  Create Directory  - Create and enter a new folder",
+    "  Create File       - Create a file in current directory",
+    "  Undo              - Revert last create action (safe)",
+    "  Load Preset       - Apply a preset by name or file path",
+    "  Save Structure    - Save project structure to JSON",
+    "  Load Structure    - Load structure from JSON",
+    "  Go Back           - Move to parent directory",
+    "",
+    "Notes:",
+    "  • KTrex never deletes non-empty directories",
+    "  • Existing files are never overwritten",
+    "  • Presets are additive",
+    "",
+    "Scrolling:",
+    "  PageUp / PageDown  Scroll tree view",
+    "  Ctrl + U / Ctrl + D  Scroll up / down",
+    "  Mouse Wheel        Scroll tree",
+    "",
+    "Press any key to return",
+]
+
+
+def draw_menu(stdscr, selected: int):
+    h, w = stdscr.getmaxyx()
+    menu_width = min(24, max(10, w - 2))
+    start_x = max(0, w - menu_width)
+    start_y = 2
+
+    if start_y >= h - 1:
+        return
+
+    stdscr.addnstr(start_y - 1, start_x, "Actions", menu_width, curses.A_BOLD)
+
+    for i, item in enumerate(MENU_ITEMS):
+        y = start_y + i
+        if y >= h - 1:
+            break
+        attr = curses.A_REVERSE if i == selected else curses.A_NORMAL
+        stdscr.addnstr(y, start_x, item, menu_width, attr)
+
+
+def draw_tree(stdscr, root: Path, current: Path, scroll_offset: int):
+    h, w = stdscr.getmaxyx()
+    stdscr.addnstr(0, 0, root.name, w - 2, curses.A_BOLD)
+
+    lines = render_tree(root, current=current)
+
+    visible_height = h - 2
+    start = scroll_offset
+    end = min(start + visible_height, len(lines))
+
+    for idx, line in enumerate(lines[start:end], start=1):
+        stdscr.addnstr(idx, 0, line, w - 2)
+
+    if len(lines) > visible_height:
+        indicator = f"[{start + 1}-{end}/{len(lines)}]"
+        stdscr.addnstr(h - 1, 0, indicator, w - 2)
+
+
+def draw_help(stdscr):
+    stdscr.clear()
+    h, w = stdscr.getmaxyx()
+
+    for i, line in enumerate(HELP_TEXT):
+        y = i + 1
+        if y >= h - 1:
+            break
+        stdscr.addnstr(y, 2, line, w - 4)
+
+    stdscr.refresh()
+    stdscr.getch()
+
+
+def prompt(stdscr, message: str) -> str:
+    h, w = stdscr.getmaxyx()
+    y = h - 2
+    if y < 0:
+        return ""
+
+    stdscr.move(y, 0)
+    stdscr.clrtoeol()
+    stdscr.addnstr(y, 0, message, w - 2)
+    stdscr.refresh()
+
+    curses.echo()
+    value = stdscr.getstr(y, min(len(message), w - 3)).decode().strip()
+    curses.noecho()
+    return value
+
+
+def notify(stdscr, message: str):
+    h, w = stdscr.getmaxyx()
+    y = h - 1
+    if y < 0:
+        return
+
+    stdscr.move(y, 0)
+    stdscr.clrtoeol()
+    stdscr.addnstr(y, 0, message, w - 2)
+    stdscr.refresh()
+    stdscr.getch()
+
+
+def tui_main(stdscr):
+    curses.curs_set(0)
+    curses.mousemask(curses.ALL_MOUSE_EVENTS)
+    stdscr.keypad(True)
+
+    scroll_offset = 0
+    root = state.root_dir
+    assert root is not None
+    selected = 0
+
+    while True:
+        current = state.path_stack[-1]
+
+        lines = render_tree(root, current=current)
+        h, _ = stdscr.getmaxyx()
+        max_offset = max(0, len(lines) - (h - 2))
+        scroll_offset = min(scroll_offset, max_offset)
+
+        stdscr.clear()
+        draw_tree(stdscr, root, current, scroll_offset)
+        draw_menu(stdscr, selected)
+
+        key = stdscr.getch()
+
+        if key == curses.KEY_RESIZE:
+            scroll_offset = 0
+
+        elif key == curses.KEY_UP and selected > 0:
+            selected -= 1
+
+        elif key == curses.KEY_DOWN and selected < len(MENU_ITEMS) - 1:
+            selected += 1
+
+        elif key == curses.KEY_NPAGE:
+            scroll_offset += 5
+
+        elif key == curses.KEY_PPAGE:
+            scroll_offset = max(0, scroll_offset - 5)
+
+        elif key == 4:
+            scroll_offset += 5
+
+        elif key == 21:
+            scroll_offset = max(0, scroll_offset - 5)
+
+        elif key == curses.KEY_MOUSE:
+            try:
+                _, _, _, _, mouse_state = curses.getmouse()
+                if mouse_state & (curses.BUTTON4_PRESSED | curses.BUTTON4_RELEASED):
+                    scroll_offset = max(0, scroll_offset - 3)
+                elif mouse_state & (curses.BUTTON5_PRESSED | curses.BUTTON5_RELEASED):
+                    scroll_offset += 3
+            except curses.error:
+                pass
+
+        elif key in (10, 13):
+            action = MENU_ITEMS[selected]
+            scroll_offset = 0
+
+            if action == "Create Directory":
+                name = prompt(stdscr, "Directory name: ")
+                if name:
+                    new_dir = create_dir(current, name)
+                    if new_dir:
+                        state.path_stack.append(new_dir)
+
+            elif action == "Create File":
+                name = prompt(stdscr, "File name: ")
+                if name:
+                    create_file(current, name)
+
+            elif action == "Undo":
+                undone = undo_last()
+                if undone and not current.exists():
+                    state.path_stack.pop()
+
+            elif action == "Load Preset":
+                value = prompt(stdscr, "Preset name or path: ")
+                if value:
+                    try:
+                        load_preset(value, current)
+                    except Exception as e:
+                        notify(stdscr, f"Error: {e}")
+
+            elif action == "Save Structure":
+                path_str = prompt(stdscr, "Save to (path): ")
+                if path_str:
+                    try:
+                        tree = build_tree(root)
+                        with open(Path(path_str), "w") as f:
+                            json.dump(tree, f, indent=2)
+                        notify(stdscr, "Structure saved successfully")
+                    except Exception as e:
+                        notify(stdscr, f"Error: {e}")
+
+            elif action == "Load Structure":
+                path_str = prompt(stdscr, "Load from (path): ")
+                if path_str:
+                    try:
+                        with open(Path(path_str), "r") as f:
+                            tree = json.load(f)
+                        apply_tree(root, tree)
+                    except Exception as e:
+                        notify(stdscr, f"Error: {e}")
+
+            elif action == "Go Back":
+                if len(state.path_stack) > 1:
+                    state.path_stack.pop()
+                else:
+                    notify(stdscr, "Already at project root")
+
+            elif action == "Help":
+                draw_help(stdscr)
+
+            elif action == "Quit":
+                break
+
+        stdscr.refresh()

ktrex-0.1.5/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "KTrex"
+version = "0.1.5"
+description = "Interactive terminal-based directory structure builder"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "AK" }
+]
+requires-python = ">=3.10"
+dependencies = []
+
+[project.scripts]
+KTrex = "KTrex.main:main"
+
+[tool.setuptools.package-data]
+KTrex = ["presets/*.json"]
+
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"

ktrex-0.1.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+