kollabor 0.4.9__py3-none-any.whl

core/ui/widgets/text_input.py

@@ -0,0 +1,224 @@
+"""Text input widget for modal UI components."""
+
+from typing import List
+from .base_widget import BaseWidget
+from ...io.key_parser import KeyPress
+from ...io.visual_effects import ColorPalette
+
+
+class TextInputWidget(BaseWidget):
+    """Interactive text input widget with cursor ▌.
+
+    Displays as [text▌] with blinking cursor and accepts character input.
+    Uses ColorPalette.BRIGHT for focus highlighting.
+    """
+
+    def __init__(self, config: dict, config_path: str, config_service=None):
+        """Initialize text input widget.
+
+        Args:
+            config: Widget configuration with optional placeholder.
+            config_path: Dot-notation path to config value.
+            config_service: ConfigService instance for reading/writing config values.
+        """
+        super().__init__(config, config_path, config_service)
+        self.cursor_position = 0
+        self._show_cursor = True
+
+    def render(self) -> List[str]:
+        """Render text input with cursor indicator.
+
+        Returns:
+            List containing text input display line.
+        """
+        # Get current text value
+        current_value = self.get_pending_value()
+        text = str(current_value) if current_value is not None else ""
+        label = self.get_label()
+        placeholder = self.config.get("placeholder", "")
+
+        # Display text or placeholder
+        if text:
+            display_text = text
+        elif placeholder and not self.focused:
+            display_text = placeholder
+        else:
+            display_text = ""
+
+        # Add cursor when focused
+        if self.focused and self._show_cursor:
+            # Insert cursor at current position
+            cursor_pos = min(self.cursor_position, len(display_text))
+            display_with_cursor = (
+                display_text[:cursor_pos] + "▌" + display_text[cursor_pos:]
+            )
+        else:
+            display_with_cursor = display_text
+
+        # Apply focus highlighting
+        if self.focused:
+            return [f"{ColorPalette.BRIGHT_WHITE}  {label}: [{display_with_cursor}]{ColorPalette.RESET}"]
+        else:
+            if placeholder and not text:
+                # Show placeholder in dim text
+                return [f"  {label}: [{ColorPalette.DIM}{placeholder}{ColorPalette.RESET}]"]
+            else:
+                return [f"  {label}: [{display_with_cursor}]"]
+
+    def handle_input(self, key_press: KeyPress) -> bool:
+        """Handle text input - character insertion and navigation.
+
+        Args:
+            key_press: Key press event to handle.
+
+        Returns:
+            True if key was handled.
+        """
+        current_text = str(self.get_pending_value() or "")
+
+        # Handle special keys
+        if key_press.name == "Backspace":
+            if self.cursor_position > 0:
+                # Remove character before cursor
+                new_text = (
+                    current_text[:self.cursor_position - 1] +
+                    current_text[self.cursor_position:]
+                )
+                self.set_value(new_text)
+                self.cursor_position = max(0, self.cursor_position - 1)
+            return True
+
+        elif key_press.name == "Delete":
+            if self.cursor_position < len(current_text):
+                # Remove character at cursor
+                new_text = (
+                    current_text[:self.cursor_position] +
+                    current_text[self.cursor_position + 1:]
+                )
+                self.set_value(new_text)
+            return True
+
+        elif key_press.name == "ArrowLeft":
+            # Move cursor left
+            self.cursor_position = max(0, self.cursor_position - 1)
+            return True
+
+        elif key_press.name == "ArrowRight":
+            # Move cursor right
+            self.cursor_position = min(len(current_text), self.cursor_position + 1)
+            return True
+
+        elif key_press.name == "Home" or key_press.name == "Ctrl+A":
+            # Move cursor to beginning
+            self.cursor_position = 0
+            return True
+
+        elif key_press.name == "End" or key_press.name == "Ctrl+E":
+            # Move cursor to end
+            self.cursor_position = len(current_text)
+            return True
+
+        elif key_press.name == "Ctrl+U":
+            # Clear entire line
+            self.set_value("")
+            self.cursor_position = 0
+            return True
+
+        elif key_press.name == "Ctrl+K":
+            # Clear from cursor to end
+            new_text = current_text[:self.cursor_position]
+            self.set_value(new_text)
+            return True
+
+        # Handle printable characters
+        elif key_press.char and key_press.char.isprintable():
+            # CRITICAL FIX: Add input validation for specific field types
+            validation_type = self.config.get("validation", "text")
+
+            # For numeric fields, only allow digits and decimal points
+            if validation_type == "integer" and not key_press.char.isdigit():
+                return True  # Reject non-numeric input
+            elif validation_type == "number" and not (key_press.char.isdigit() or key_press.char == "."):
+                return True  # Reject non-numeric input
+
+            # Insert character at cursor position
+            new_text = (
+                current_text[:self.cursor_position] +
+                key_press.char +
+                current_text[self.cursor_position:]
+            )
+
+            # Validate the complete value
+            if self._validate_complete_value(new_text, validation_type):
+                self.set_value(new_text)
+                self.cursor_position += 1
+            return True
+
+        return False
+
+    def set_focus(self, focused: bool):
+        """Set focus and reset cursor position.
+
+        Args:
+            focused: Whether widget should be focused.
+        """
+        super().set_focus(focused)
+        if focused:
+            # Move cursor to end when gaining focus
+            current_text = str(self.get_pending_value() or "")
+            self.cursor_position = len(current_text)
+
+    def set_value(self, value):
+        """Set text value and adjust cursor position.
+
+        Args:
+            value: New text value.
+        """
+        super().set_value(str(value) if value is not None else "")
+        # Ensure cursor position is valid
+        new_text = str(value) if value is not None else ""
+        self.cursor_position = min(self.cursor_position, len(new_text))
+
+    def _validate_complete_value(self, value: str, validation_type: str) -> bool:
+        """Validate complete input value based on validation type.
+
+        Args:
+            value: String value to validate.
+            validation_type: Type of validation (text, integer, number).
+
+        Returns:
+            True if value is valid for the field type.
+        """
+        if validation_type == "integer":
+            if not value:  # Empty is valid (will use default)
+                return True
+            try:
+                int(value)
+                return True
+            except ValueError:
+                return False
+        elif validation_type == "number":
+            if not value:  # Empty is valid (will use default)
+                return True
+            try:
+                float(value)
+                return True
+            except ValueError:
+                return False
+        return True  # Text validation always passes
+
+    def is_valid_value(self, value) -> bool:
+        """Validate text input value - must be string-convertible.
+
+        Args:
+            value: Value to validate.
+
+        Returns:
+            True if value can be converted to string.
+        """
+        try:
+            str(value)
+            validation_type = self.config.get("validation", "text")
+            return self._validate_complete_value(str(value), validation_type)
+        except (TypeError, ValueError):
+            return False

core/utils/__init__.py

@@ -0,0 +1,11 @@
+"""Shared utility modules for Kollabor CLI."""
+
+from .dict_utils import deep_merge, safe_get, safe_set
+from .plugin_utils import has_method, safe_call_method, get_plugin_metadata
+from .error_utils import log_and_continue, safe_execute
+
+__all__ = [
+    'deep_merge', 'safe_get', 'safe_set',
+    'has_method', 'safe_call_method', 'get_plugin_metadata',
+    'log_and_continue', 'safe_execute'
+]