bone-agent 1.4.0 → 2.0.0

package/src/ui/setting_selector.py

@@ -1,590 +0,0 @@
-"""Reusable component for interactive setting selection and editing."""
-
-import asyncio
-from dataclasses import dataclass, field
-from typing import Optional, List, Dict, Any, Callable, Union
-
-from prompt_toolkit import HTML
-from prompt_toolkit.application import Application
-from prompt_toolkit.key_binding import KeyBindings
-from prompt_toolkit.keys import Keys
-from prompt_toolkit.layout import Layout, HSplit, Window
-from prompt_toolkit.layout.dimension import D
-from prompt_toolkit.layout.controls import FormattedTextControl
-
-from ui.prompt_utils import TOOLBAR_STYLE
-
-
-@dataclass
-class SettingOption:
-    """A single setting option with validation support."""
-    key: str                          # Config key
-    text: str                         # Display label
-    value: Any                        # Current value
-    options: List[Dict[str, Any]] = None  # For enum-style: {"value": x, "text": y}
-    input_type: str = "select"        # "select", "text", "number", "boolean", "float", "options"
-    description: str = ""
-    min_val: Union[int, float] = None
-    max_val: Union[int, float] = None
-    step: Union[int, float] = None
-    validate_fn: Callable[[Any], bool] = None  # Custom validator
-    on_text: str = ""   # Custom label when value is truthy (e.g. "Active")
-    off_text: str = ""  # Custom label when value is falsy (e.g. "-")
-
-    def __post_init__(self):
-        if self.options is None:
-            self.options = []
-
-
-@dataclass
-class SettingCategory:
-    """A category containing related settings."""
-    title: str
-    icon: str = ""
-    settings: List[SettingOption] = field(default_factory=list)
-
-
-class SettingSelector:
-    """Interactive setting selector with live value editing.
-
-    Boolean settings display one per line with green ON / red OFF.
-    Enter toggles booleans directly. A Save option sits at the bottom.
-    Non-boolean types still support inline editing.
-    """
-
-    _CURSOR = "  "
-    _ON_SAVE = False  # Sentinel: cursor is on the Save button
-
-    def __init__(
-        self,
-        categories: List[SettingCategory],
-        title: str = "Settings",
-        on_change: Callable[[str, str, Any], None] = None,  # Called on value change
-        show_save: bool = True,  # Whether to show the Save button
-    ):
-        """Initialize the setting selector.
-
-        Args:
-            categories: List of SettingCategory objects with settings
-            title: Panel title
-            on_change: Callback(key, action, value) when setting changes
-            show_save: Whether to display the Save button
-        """
-        self.categories = categories
-        self.title = title
-        self.on_change = on_change
-        self.show_save = show_save
-
-        self.current_cat_idx = 0
-        self.current_setting_idx = 0
-        self._on_save = self._ON_SAVE
-        self.editing_value = False
-        self.input_buffer = ""
-        self._initial_values: Dict[str, Any] = {
-            s.key: s.value
-            for cat in categories
-            for s in cat.settings
-        }
-
-    def _get_current_setting(self) -> Optional[SettingOption]:
-        """Get the currently selected setting."""
-        if 0 <= self.current_cat_idx < len(self.categories):
-            cat = self.categories[self.current_cat_idx]
-            if 0 <= self.current_setting_idx < len(cat.settings):
-                return cat.settings[self.current_setting_idx]
-        return None
-
-    def _format_value(self, setting: SettingOption) -> str:
-        """Format a setting value for display."""
-        if setting.input_type in ("boolean", "nav"):
-            if setting.on_text and setting.value:
-                return setting.on_text
-            if setting.off_text and not setting.value:
-                return setting.off_text
-            return "ON" if setting.value else "OFF"
-        elif setting.input_type == "select" and setting.options:
-            for opt in setting.options:
-                if opt.get("value") == setting.value:
-                    return opt.get("text", str(setting.value))
-        elif isinstance(setting.value, bool):
-            return "Yes" if setting.value else "No"
-        elif isinstance(setting.value, float) and setting.step and setting.step < 1:
-            return f"{setting.value:.2f}"
-        return str(setting.value)
-
-    def _total_setting_rows(self) -> int:
-        """Total navigable rows across all categories."""
-        return sum(len(cat.settings) for cat in self.categories)
-
-    def _is_boolean_setting(self, setting: Optional[SettingOption]) -> bool:
-        """Check if a setting is a boolean toggle or nav item."""
-        return setting is not None and setting.input_type in ("boolean", "nav")
-
-    def _get_display_text(self) -> HTML:
-        """Build the display HTML with one-line boolean toggles."""
-        lines = []
-
-        # Title (only if provided)
-        if self.title:
-            lines.append(f"<b>{self.title}</b>")
-            lines.append("")
-
-        # Show category headers only when there are multiple categories
-        show_headers = len(self.categories) > 1
-
-        for c_idx, cat in enumerate(self.categories):
-            is_active_cat = c_idx == self.current_cat_idx
-
-            # Add spacing between categories
-            if c_idx > 0:
-                lines.append("")
-
-            if show_headers:
-                lines.append(f"<b><style fg='#5F9EA0'>{cat.title}</style></b>")
-
-            for s_idx, setting in enumerate(cat.settings):
-                is_selected = (is_active_cat
-                               and s_idx == self.current_setting_idx
-                               and not self._on_save)
-                is_editing = is_selected and self.editing_value
-
-                if setting.input_type == "boolean":
-                    is_on = bool(setting.value)
-                    tag = "ON" if is_on else "OFF"
-                    label = setting.text
-
-                    if is_selected:
-                        color = "green" if is_on else "red"
-                        lines.append(
-                            f"> <style fg='{color}' bold='true'>{tag}</style>"
-                            f"  <b>{label}</b>"
-                        )
-                    else:
-                        lines.append(
-                            f"  <style fg='gray'>{tag}</style>"
-                            f"  {label}"
-                        )
-
-                elif setting.input_type == "nav":
-                    tag = self._format_value(setting)
-                    label = setting.text
-
-                    if is_selected:
-                        if tag and tag not in ("ON", "OFF"):
-                            lines.append(
-                                f"> <style fg='#5F9EA0' bold='true'>{tag}</style>"
-                                f"  <b>{label}</b>"
-                            )
-                        else:
-                            lines.append(
-                                f"> <b>{label}</b>"
-                            )
-                    else:
-                        if tag and tag not in ("ON", "OFF"):
-                            lines.append(
-                                f"  <style fg='gray'>{tag}</style>"
-                                f"  {label}"
-                            )
-                        else:
-                            lines.append(
-                                f"  {label}"
-                            )
-
-                elif is_editing and setting.input_type in ("number", "float"):
-                    label = setting.text
-                    lines.append(
-                        f"> <b>{label}:</b>"
-                        f"  <style fg='yellow'>{self.input_buffer}</style>"
-                    )
-                elif is_editing and setting.input_type == "text":
-                    label = setting.text
-                    lines.append(
-                        f"> <b>{label}:</b>"
-                        f"  <style fg='yellow'>{self.input_buffer}</style>"
-                    )
-                elif is_editing and setting.input_type == "select" and setting.options:
-                    tag = self._format_value(setting)
-                    label = setting.text
-                    lines.append(
-                        f"> <style fg='yellow' bold='true'>{tag}</style>"
-                        f"  <b>{label}</b>"
-                    )
-                elif setting.input_type == "select" and setting.options:
-                    tag = self._format_value(setting)
-                    label = setting.text
-                    if is_selected:
-                        lines.append(
-                            f"> <style fg='#5F9EA0' bold='true'>{tag}</style>"
-                            f"  <b>{label}</b>"
-                        )
-                    else:
-                        lines.append(
-                            f"  <style fg='gray'>{tag}</style>"
-                            f"  {label}"
-                        )
-
-                elif setting.input_type == "options" and setting.options:
-                    # Show each option on its own line with radio-style selection
-                    label = setting.text
-                    lines.append(f"  <b>{label}</b>")
-                    for opt_idx, opt in enumerate(setting.options):
-                        opt_text = opt.get("text", str(opt.get("value", "")))
-                        opt_value = opt.get("value")
-                        is_current = opt_value == setting.value
-                        is_opt_selected = is_selected and is_current
-                        indent = "  > " if is_opt_selected else "    "
-                        marker = "◉" if is_current else "○"
-                        desc = opt.get("description", "")
-                        if is_current:
-                            color = "#5F9EA0"
-                            lines.append(
-                                f'{indent}<style fg="{color}">{marker}</style> '
-                                f'<style fg="{color}" bold="true">{opt_text}</style>'
-                                + (f'  <style fg="gray">{desc}</style>' if desc else '')
-                            )
-                        else:
-                            lines.append(
-                                f'{indent}<style fg="gray">{marker}</style> '
-                                f'{opt_text}'
-                                + (f'  <style fg="gray">{desc}</style>' if desc else '')
-                            )
-                else:
-                    label = setting.text
-                    val = self._format_value(setting)
-                    if is_selected:
-                        lines.append(
-                            f"> <b>{label}:</b>"
-                            f"  <style fg='#5F9EA0'>{val}</style>"
-                        )
-                    else:
-                        lines.append(
-                            f"  {label}:  "
-                            f"<style fg='gray'>{val}</style>"
-                        )
-
-        # Separator + Save button
-        if self.show_save:
-            lines.append("")
-            if self._on_save:
-                lines.append("> <b>[ Save ]</b>")
-            else:
-                lines.append("  [ Save ]")
-
-        # Help text
-        lines.append("")
-        setting = self._get_current_setting()
-        if self._on_save:
-            lines.append("<style fg='gray'>Enter to save changes, Esc to save &amp; close</style>")
-        elif self.editing_value:
-            if setting and setting.input_type in ("number", "float", "text"):
-                lines.append("<style fg='gray'>Type value, Enter to confirm, Esc to discard</style>")
-            elif setting and setting.input_type == "select":
-                lines.append("<style fg='gray'>↑↓ Change, Enter to confirm, Esc to discard</style>")
-        else:
-            if setting and setting.input_type == "nav":
-                lines.append("<style fg='gray'>↑↓ Navigate, Enter to open, Esc to save &amp; close</style>")
-            elif setting and setting.input_type == "options":
-                lines.append("<style fg='gray'>↑↓ Change option, Enter to select, Esc to save &amp; close</style>")
-            elif setting and self._is_boolean_setting(setting):
-                lines.append("<style fg='gray'>↑↓ Navigate, Enter to toggle, Esc to save &amp; close</style>")
-            elif setting:
-                lines.append("<style fg='gray'>↑↓ Navigate, Enter to edit, Esc to save &amp; close</style>")
-            else:
-                lines.append("<style fg='gray'>↑↓ Navigate, Esc to save &amp; close</style>")
-
-        return HTML("\n".join(lines))
-
-    def _validate_input(self, setting: SettingOption, value: str) -> bool:
-        """Validate user input for a setting."""
-        if setting.validate_fn:
-            try:
-                if setting.input_type == "number":
-                    return setting.validate_fn(int(value))
-                elif setting.input_type == "float":
-                    return setting.validate_fn(float(value))
-                return setting.validate_fn(value)
-            except (ValueError, TypeError):
-                return False
-
-        # Built-in validation
-        if setting.input_type == "number":
-            try:
-                int_val = int(value)
-                if setting.min_val is not None and int_val < setting.min_val:
-                    return False
-                if setting.max_val is not None and int_val > setting.max_val:
-                    return False
-                if setting.step is not None and setting.step > 0:
-                    if (int_val - setting.min_val if setting.min_val is not None else int_val) % setting.step != 0:
-                        return False
-                return True
-            except ValueError:
-                return False
-        elif setting.input_type == "float":
-            try:
-                float_val = float(value)
-                if setting.min_val is not None and float_val < setting.min_val:
-                    return False
-                if setting.max_val is not None and float_val > setting.max_val:
-                    return False
-                if setting.step is not None and setting.step > 0:
-                    base = setting.min_val if setting.min_val is not None else 0.0
-                    remainder = abs(float_val - base) % setting.step
-                    if remainder > 1e-9 and abs(remainder - setting.step) > 1e-9:
-                        return False
-                return True
-            except ValueError:
-                return False
-
-        return len(value) > 0
-
-    def _apply_change(self, key: str, new_value: Any) -> None:
-        """Apply a setting change."""
-        # Find and update the setting
-        for cat in self.categories:
-            for setting in cat.settings:
-                if setting.key == key:
-                    old_value = setting.value
-                    setting.value = new_value
-                    if self.on_change and old_value != new_value:
-                        self.on_change(key, "change", new_value)
-                    return
-
-    def _navigate_down(self):
-        """Move selection down one row, wrapping into the Save button."""
-        if self._on_save:
-            return  # Already at bottom
-        cat = self.categories[self.current_cat_idx]
-        if self.current_setting_idx < len(cat.settings) - 1:
-            self.current_setting_idx += 1
-        elif self.current_cat_idx < len(self.categories) - 1:
-            self.current_cat_idx += 1
-            self.current_setting_idx = 0
-        elif self.show_save:
-            # Past last setting -> move to Save button
-            self._on_save = True
-
-    def _navigate_up(self):
-        """Move selection up one row, off the Save button if needed."""
-        if self._on_save:
-            self._on_save = False
-            return
-        if self.current_setting_idx > 0:
-            self.current_setting_idx -= 1
-        elif self.current_cat_idx > 0:
-            self.current_cat_idx -= 1
-            self.current_setting_idx = len(self.categories[self.current_cat_idx].settings) - 1
-
-    def _save(self, event):
-        """Exit with changes (or empty dict if nothing changed)."""
-        changes = {}
-        for cat in self.categories:
-            for setting in cat.settings:
-                if setting.value != self._initial_values.get(setting.key):
-                    changes[setting.key] = setting.value
-        event.app.exit(result=changes if changes else {})
-
-    def run(self) -> Optional[Dict[str, Any]]:
-        """Display and run the setting selector.
-
-        Returns:
-            Dict of {key: new_value} for changed settings, or None if canceled
-        """
-        bindings = KeyBindings()
-
-        def invalidate():
-            if hasattr(invalidate, 'app'):
-                invalidate.app.invalidate()
-
-        @bindings.add(Keys.Up)
-        def move_up(event):
-            if self.editing_value:
-                setting = self._get_current_setting()
-                if setting and setting.input_type == "select" and setting.options:
-                    current_idx = next((i for i, o in enumerate(setting.options) if o.get("value") == setting.value), 0)
-                    new_idx = max(0, current_idx - 1)
-                    self._apply_change(setting.key, setting.options[new_idx].get("value"))
-                invalidate()
-                return
-            # Options type: navigate within options
-            setting = self._get_current_setting()
-            if setting and setting.input_type == "options" and setting.options:
-                current_idx = next((i for i, o in enumerate(setting.options) if o.get("value") == setting.value), 0)
-                new_idx = max(0, current_idx - 1)
-                self._apply_change(setting.key, setting.options[new_idx].get("value"))
-                invalidate()
-                return
-            self._navigate_up()
-            invalidate()
-
-        @bindings.add(Keys.Down)
-        def move_down(event):
-            if self.editing_value:
-                setting = self._get_current_setting()
-                if setting and setting.input_type == "select" and setting.options:
-                    current_idx = next((i for i, o in enumerate(setting.options) if o.get("value") == setting.value), 0)
-                    new_idx = min(len(setting.options) - 1, current_idx + 1)
-                    self._apply_change(setting.key, setting.options[new_idx].get("value"))
-                invalidate()
-                return
-            # Options type: navigate within options
-            setting = self._get_current_setting()
-            if setting and setting.input_type == "options" and setting.options:
-                current_idx = next((i for i, o in enumerate(setting.options) if o.get("value") == setting.value), 0)
-                new_idx = min(len(setting.options) - 1, current_idx + 1)
-                self._apply_change(setting.key, setting.options[new_idx].get("value"))
-                invalidate()
-                return
-            self._navigate_down()
-            invalidate()
-
-        @bindings.add(Keys.Enter)
-        def confirm(event):
-            # On the Save button -> commit
-            if self._on_save:
-                self._save(event)
-                return
-
-            setting = self._get_current_setting()
-            if not setting:
-                return
-
-            # Nav: activate drill-down
-            if setting.input_type == 'nav':
-                event.app.exit(result={'_nav': setting.key})
-                return
-
-            # Boolean: toggle directly
-            if self._is_boolean_setting(setting):
-                self._apply_change(setting.key, not setting.value)
-                invalidate()
-                return
-
-            # Select: cycle to next option directly
-            if setting.input_type == "select" and setting.options:
-                current_idx = next((i for i, o in enumerate(setting.options) if o.get("value") == setting.value), 0)
-                new_idx = (current_idx + 1) % len(setting.options)
-                self._apply_change(setting.key, setting.options[new_idx].get("value"))
-                invalidate()
-                return
-
-            # Options: confirm selection (same behavior as save)
-            if setting.input_type == "options" and setting.options:
-                self._save(event)
-                return
-
-            if self.editing_value:
-                if setting.input_type in ("text", "number", "float"):
-                    if self._validate_input(setting, self.input_buffer):
-                        if setting.input_type == "number":
-                            new_val = int(self.input_buffer)
-                        elif setting.input_type == "float":
-                            new_val = float(self.input_buffer)
-                        else:
-                            new_val = self.input_buffer
-                        self._apply_change(setting.key, new_val)
-                    self.editing_value = False
-                    self.input_buffer = ""
-                invalidate()
-            else:
-                # Start editing for text/number/float types
-                if setting.input_type in ("text", "number", "float"):
-                    self.editing_value = True
-                    self.input_buffer = str(setting.value)
-                invalidate()
-
-        @bindings.add(Keys.Escape)
-        def close(event):
-            if self.editing_value:
-                # First Esc while editing: discard in-progress input
-                self.editing_value = False
-                self.input_buffer = ""
-                invalidate()
-                return
-            # Esc saves (same as Save button)
-            self._save(event)
-
-        @bindings.add(Keys.Right)
-        def enter_edit(event):
-            setting = self._get_current_setting()
-            if setting and not self.editing_value and setting.input_type not in ("boolean",):
-                self.editing_value = True
-                if setting.input_type in ("text", "number", "float"):
-                    self.input_buffer = str(setting.value)
-                invalidate()
-
-        @bindings.add(Keys.Left)
-        def exit_edit(event):
-            if self.editing_value:
-                self.editing_value = False
-                self.input_buffer = ""
-                invalidate()
-
-        # Character input for text/number editing
-        @bindings.add(Keys.Any)
-        def handle_char(event):
-            if not self.editing_value:
-                return
-            setting = self._get_current_setting()
-            if setting and setting.input_type in ("text", "number", "float"):
-                data = event.data
-                if len(data) == 1 and ord(data) >= 32:
-                    if setting.input_type == "number":
-                        if data.isdigit() or (data == '-' and not self.input_buffer):
-                            self.input_buffer += data
-                    elif setting.input_type == "float":
-                        if data.isdigit() or (data == '.' and '.' not in self.input_buffer) or (data == '-' and not self.input_buffer):
-                            self.input_buffer += data
-                    else:
-                        self.input_buffer += data
-                    invalidate()
-
-        @bindings.add(Keys.Backspace)
-        def handle_backspace(event):
-            if self.editing_value and self.input_buffer:
-                self.input_buffer = self.input_buffer[:-1]
-                invalidate()
-
-        @bindings.add(Keys.Delete)
-        def handle_delete(event):
-            if self.editing_value and self.input_buffer:
-                self.input_buffer = self.input_buffer[:-1]
-                invalidate()
-
-        # Layout
-        def get_content():
-            return self._get_display_text()
-
-        content = FormattedTextControl(get_content)
-        container = HSplit([
-            Window(content=content, height=D(min=1), width=D(min=1), wrap_lines=True),
-        ])
-
-        application = Application(
-            layout=Layout(container),
-            key_bindings=bindings,
-            full_screen=False,
-            mouse_support=False,
-            cursor=None,
-            style=TOOLBAR_STYLE,
-        )
-
-        invalidate.app = application
-        # Add a blank line before the selector to separate from prior output
-        application.output.write_raw("\n")
-        # Save cursor position before rendering so we can erase on exit
-        application.output.write_raw("\033[s")
-        application.output.flush()
-        # Use run_async with asyncio to properly await coroutines
-        result = asyncio.run(application.run_async())
-
-        # Erase rendered content: use ANSI save/restore cursor position.
-        # We saved cursor before the app rendered, so restoring it puts
-        # us back at the top of our content. Then erase to end of screen.
-        output = application.output
-        output.write_raw("\033[u")  # Restore cursor to saved position
-        output.write_raw("\033[J")  # Erase from cursor to end of screen
-        output.flush()
-
-        # None = cancelled, {} = saved with no changes, {...} = saved with changes
-        return result