Initial commit

scripts/utils/helpers.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+"""
+General helper utilities for Bubble Tea Designer.
+"""
+
+from datetime import datetime
+from typing import Optional
+
+
+def get_timestamp() -> str:
+    """Get current timestamp in ISO format."""
+    return datetime.now().isoformat()
+
+
+def format_list_markdown(items: list, ordered: bool = False) -> str:
+    """Format list as markdown."""
+    if not items:
+        return ""
+
+    if ordered:
+        return "\n".join(f"{i}. {item}" for i, item in enumerate(items, 1))
+    else:
+        return "\n".join(f"- {item}" for item in items)
+
+
+def truncate_text(text: str, max_length: int = 100) -> str:
+    """Truncate text to max length with ellipsis."""
+    if len(text) <= max_length:
+        return text
+    return text[:max_length-3] + "..."
+
+
+def estimate_complexity(num_components: int, num_views: int = 1) -> str:
+    """Estimate implementation complexity."""
+    if num_components <= 2 and num_views == 1:
+        return "Simple (1-2 hours)"
+    elif num_components <= 4 and num_views <= 2:
+        return "Medium (2-4 hours)"
+    else:
+        return "Complex (4+ hours)"