vibe-widget 0.1.0__tar.gz

vibe_widget-0.1.0/.claude/settings.local.json

@@ -0,0 +1,17 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(tree:*)",
+      "Bash(python3:*)",
+      "Bash(pip install:*)",
+      "Bash(npm run build:*)",
+      "Bash(npm install:*)",
+      "Bash(chmod:*)",
+      "Bash(./scripts/build-react-widget.sh:*)",
+      "Bash(python:*)",
+      "Bash(pkill:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

vibe_widget-0.1.0/.gitignore

@@ -0,0 +1,70 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+
+# Distribution
+pip-wheel-metadata/
+
+# Jupyter
+.ipynb_checkpoints
+*.ipynb
+
+# Environment variables
+.env
+.env.local
+
+# Generated widgets
+*.html
+output/
+
+.meridian/
+
+# Vibe widget cache
+.vibe_cache/
+
+
+
+/venv311/
+**/widgets/**
+/testdata/

vibe_widget-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include src/vibe_widget/widgets *.js

vibe_widget-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: vibe_widget
+Version: 0.1.0
+Summary: Create interactive visualizations using natural language and LLMs
+Project-URL: Homepage, https://github.com/yourusername/vibe-widget
+Project-URL: Documentation, https://github.com/yourusername/vibe-widget#readme
+Project-URL: Repository, https://github.com/yourusername/vibe-widget
+Project-URL: Issues, https://github.com/yourusername/vibe-widget/issues
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Keywords: interactive,jupyter,llm,visualization,widgets
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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 :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.9
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: anywidget>=0.9.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: ipython>=8.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Vibe Widget
+
+Create interactive visualizations using natural language and LLMs.
+
+## Installation
+
+```bash
+pip install vibe-widget
+```
+
+Or with `uv`:
+
+```bash
+uv pip install vibe-widget
+```
+
+## Quick Start
+
+```python
+import pandas as pd
+import vibe_widget as vw
+
+df = pd.DataFrame({
+    'height': [150, 160, 170, 180, 190],
+    'weight': [50, 60, 70, 80, 90]
+})
+
+vw.create("an interactive scatterplot of height and weight", df)
+```
+
+This will:
+1. Analyze your data structure
+2. Generate a React component via Claude API
+3. Return an HTML file with the interactive visualization
+
+## API Key Setup
+
+Set your Anthropic API key:
+
+```bash
+export ANTHROPIC_API_KEY='your-api-key-here'
+```
+
+Or pass it directly:
+
+```python
+vw.create(
+    "a bar chart of sales by region", 
+    df, 
+    api_key="your-api-key-here"
+)
+```
+
+## Saving to File
+
+```python
+vw.create(
+    "an interactive line chart showing trends over time",
+    df,
+    output_path="output/visualization.html"
+)
+```
+
+## Development
+
+Install with dev dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Run tests:
+
+```bash
+pytest
+```
+
+Lint and format:
+
+```bash
+ruff check .
+ruff format .
+```
+
+Type checking:
+
+```bash
+mypy src/
+```
+
+## Features
+
+- 🚀 Modern Python packaging (pyproject.toml, src layout)
+- 🤖 LLM-powered visualization generation
+- ⚛️ React-based interactive widgets
+- 📊 Pandas DataFrame integration
+- 🔧 Extensible LLM provider system
+
+## License
+
+MIT

vibe_widget-0.1.0/README.md

@@ -0,0 +1,101 @@
+# Vibe Widget
+
+Create interactive visualizations using natural language and LLMs.
+
+## Installation
+
+```bash
+pip install vibe-widget
+```
+
+Or with `uv`:
+
+```bash
+uv pip install vibe-widget
+```
+
+## Quick Start
+
+```python
+import pandas as pd
+import vibe_widget as vw
+
+df = pd.DataFrame({
+    'height': [150, 160, 170, 180, 190],
+    'weight': [50, 60, 70, 80, 90]
+})
+
+vw.create("an interactive scatterplot of height and weight", df)
+```
+
+This will:
+1. Analyze your data structure
+2. Generate a React component via Claude API
+3. Return an HTML file with the interactive visualization
+
+## API Key Setup
+
+Set your Anthropic API key:
+
+```bash
+export ANTHROPIC_API_KEY='your-api-key-here'
+```
+
+Or pass it directly:
+
+```python
+vw.create(
+    "a bar chart of sales by region", 
+    df, 
+    api_key="your-api-key-here"
+)
+```
+
+## Saving to File
+
+```python
+vw.create(
+    "an interactive line chart showing trends over time",
+    df,
+    output_path="output/visualization.html"
+)
+```
+
+## Development
+
+Install with dev dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Run tests:
+
+```bash
+pytest
+```
+
+Lint and format:
+
+```bash
+ruff check .
+ruff format .
+```
+
+Type checking:
+
+```bash
+mypy src/
+```
+
+## Features
+
+- 🚀 Modern Python packaging (pyproject.toml, src layout)
+- 🤖 LLM-powered visualization generation
+- ⚛️ React-based interactive widgets
+- 📊 Pandas DataFrame integration
+- 🔧 Extensible LLM provider system
+
+## License
+
+MIT

vibe_widget-0.1.0/pyproject.toml

@@ -0,0 +1,93 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vibe_widget"
+version = "0.1.0"
+description = "Create interactive visualizations using natural language and LLMs"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Your Name", email = "your.email@example.com" }
+]
+keywords = ["visualization", "widgets", "llm", "interactive", "jupyter"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+
+dependencies = [
+    "anywidget>=0.9.0",
+    "anthropic>=0.40.0",
+    "pandas>=2.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "mypy>=1.8.0",
+    "ruff>=0.6.0",
+    "ipython>=8.12.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/vibe-widget"
+Documentation = "https://github.com/yourusername/vibe-widget#readme"
+Repository = "https://github.com/yourusername/vibe-widget"
+Issues = "https://github.com/yourusername/vibe-widget/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vibe_widget"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+    "B008",  # do not perform function calls in argument defaults
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--cov=vibe_widget",
+]

vibe_widget-0.1.0/src/vibe_widget/__init__.py

@@ -0,0 +1,4 @@
+from vibe_widget.core import VibeWidget, create
+
+__version__ = "0.1.0"
+__all__ = ["VibeWidget", "create"]

vibe_widget-0.1.0/src/vibe_widget/code_parser.py

@@ -0,0 +1,137 @@
+import re
+import time
+from typing import Dict, List, Tuple
+
+
+class CodeStreamParser:
+    """Parse streaming JavaScript code to detect landmarks and generate micro-updates."""
+    
+    BUBBLE_COOLDOWN = 0.5  # 500ms between bubbles of same type
+    
+    PATTERNS = {
+        "import": (
+            r'import\s+.*?\s+from\s+["\'](?:https?://)?(?:esm\.sh/)?([^"\'@]+)(?:@([^"\']+))?',
+            "📦 Importing {package}..."
+        ),
+        "function_render": (
+            r'function\s+render\s*\(',
+            "⚙️ Building render function..."
+        ),
+        "const_data": (
+            r'const\s+data\s*=\s*model\.get\(',
+            "📊 Loading data..."
+        ),
+        "svg_create": (
+            r'\.append\(["\']svg["\']\)',
+            "🎨 Creating SVG canvas..."
+        ),
+        "element_create": (
+            r'\.append\(["\'](?:div|canvas|g|circle|rect|path)["\']\)',
+            "🎨 Adding visualization elements..."
+        ),
+        "scale": (
+            r'd3\.scale(?:Linear|Band|Time|Point)',
+            "📏 Setting up scales..."
+        ),
+        "axis": (
+            r'd3\.axis(?:Bottom|Left|Top|Right)',
+            "📐 Creating axes..."
+        ),
+        "data_binding": (
+            r'model\.on\(["\']change:',
+            "🔄 Setting up reactivity..."
+        ),
+        "selection": (
+            r'\.selectAll\(["\'][^"\']+["\']\)',
+            "🎯 Binding data to elements..."
+        ),
+        "transition": (
+            r'\.transition\(\)',
+            "✨ Adding animations..."
+        ),
+        "event_listener": (
+            r'\.on\(["\'](?:click|mouseover|mouseout)',
+            "👆 Adding interactivity..."
+        ),
+    }
+    
+    def __init__(self):
+        self.buffer = ""
+        self.detected = set()
+        self.actions = []
+        self.last_bubble_time = {}
+        self.has_new_updates = False
+        
+    def parse_chunk(self, chunk: str) -> List[Dict[str, str]]:
+        """Parse a code chunk and return detected micro-updates."""
+        self.buffer += chunk
+        updates = []
+        self.has_new_updates = False
+        current_time = time.time()
+        
+        for pattern_name, (regex, message_template) in self.PATTERNS.items():
+            if pattern_name in self.detected:
+                continue
+                
+            match = re.search(regex, self.buffer)
+            if match:
+                # Check cooldown - only emit bubble if enough time has passed
+                if pattern_name in self.last_bubble_time:
+                    if current_time - self.last_bubble_time[pattern_name] < self.BUBBLE_COOLDOWN:
+                        continue  # Skip this update, too soon
+                
+                self.detected.add(pattern_name)
+                self.last_bubble_time[pattern_name] = current_time
+                self.has_new_updates = True
+                
+                # Extract package name for imports
+                if pattern_name == "import" and match.groups():
+                    package = match.group(1)
+                    version = match.group(2) if len(match.groups()) > 1 else None
+                    message = message_template.format(
+                        package=f"{package}@{version}" if version else package
+                    )
+                else:
+                    message = message_template
+                
+                updates.append({
+                    "type": "micro_bubble",
+                    "message": message,
+                    "pattern": pattern_name,
+                })
+                
+                # Also create action tile for imports
+                if pattern_name == "import":
+                    self.actions.append({
+                        "type": "action_tile",
+                        "title": "Loaded dependency",
+                        "message": message,
+                        "icon": "📦"
+                    })
+        
+        return updates
+    
+    def has_new_pattern(self) -> bool:
+        """Check if new patterns were detected in last parse."""
+        return self.has_new_updates
+    
+    def get_actions(self) -> List[Dict[str, str]]:
+        """Get all detected actions for the timeline."""
+        return self.actions
+    
+    def get_progress(self) -> float:
+        """Get code generation progress based on detected patterns (0.0 to 1.0)."""
+        total_patterns = len(self.PATTERNS)
+        detected_count = len(self.detected)
+        return min(1.0, detected_count / total_patterns)
+    
+    def get_completion_summary(self) -> Dict[str, any]:
+        """Get summary of detected code features."""
+        return {
+            "total_patterns": len(self.detected),
+            "has_imports": "import" in self.detected,
+            "has_reactivity": "data_binding" in self.detected,
+            "has_animation": "transition" in self.detected,
+            "has_interaction": "event_listener" in self.detected,
+            "detected_patterns": list(self.detected),
+        }