cursorflow 2.2.8__py3-none-any.whl → 2.3.0__py3-none-any.whl

cursorflow/cli.py

@@ -191,12 +191,22 @@ def test(base_url, path, actions, output, logs, config, verbose, headless, timeo
             console.print(f"[red]❌ Failed to load actions: {e}[/red]")
             return
     elif path:
-        # Simple path navigation
-        test_actions = [
-            {"navigate": path},
-            {"wait_for_selector": "body"},
-            {"screenshot": "page_loaded"}
-        ]
+        # Simple path navigation with optional wait conditions
+        test_actions = [{"navigate": path}]
+        
+        # Add wait conditions if specified
+        if wait:
+            test_actions.append({"wait_for_timeout": int(wait * 1000)})
+        if wait_for:
+            test_actions.append({"wait_for_selector": wait_for})
+        if wait_for_network_idle:
+            test_actions.append({"wait_for_load_state": "networkidle"})
+        
+        # Default wait if none specified
+        if not any([wait, wait_for, wait_for_network_idle]):
+            test_actions.append({"wait_for_selector": "body"})
+        
+        test_actions.append({"screenshot": "page_loaded"})
         console.print(f"📋 Using simple path navigation to [cyan]{path}[/cyan]")
     else:
         # Default actions - just navigate to root and screenshot
@@ -766,14 +776,21 @@ def sessions(subcommand, name):
 
 @main.command()
 @click.option('--base-url', '-u', required=True)
+@click.option('--path', '-p', default='/', help='Path to navigate to')
 @click.option('--selector', '-s', required=True)
-def inspect(base_url, selector):
+@click.option('--verbose', '-v', is_flag=True, help='Show all computed styles')
+def inspect(base_url, path, selector, verbose):
     """
-    Quick element inspection without full test
+    Comprehensive element inspection with full data capture
+    
+    Shows computed CSS, dimensions, selectors, and visual context for matching elements.
+    Perfect for CSS debugging and element analysis.
     
-    Phase 3.5: Inspect selector and show matching elements
+    Examples:
+      cursorflow inspect --base-url http://localhost:3000 --selector "#messages-panel"
+      cursorflow inspect -u http://localhost:3000 -p /dashboard -s ".card"
     """
-    console.print(f"🔍 Inspecting selector: [cyan]{selector}[/cyan]")
+    console.print(f"🔍 Inspecting selector: [cyan]{selector}[/cyan] at [blue]{path}[/blue]")
     
     try:
         from .core.cursorflow import CursorFlow
@@ -783,18 +800,255 @@ def inspect(base_url, selector):
             browser_config={'headless': True}
         )
         
-        # Quick inspection
+        # Comprehensive inspection with full data capture
+        console.print("📸 Capturing comprehensive page data...")
         results = asyncio.run(flow.execute_and_collect([
-            {"navigate": "/"},
-            {"evaluate": f"""
-                document.querySelectorAll('{selector}').length
-            """}
+            {"navigate": path},
+            {"wait_for_selector": "body"},
+            {"screenshot": "inspection"}
         ]))
         
-        console.print(f"✅ Found matches for: {selector}")
+        # Extract element data from comprehensive analysis
+        comprehensive_data = results.get('comprehensive_data', {})
+        dom_analysis = comprehensive_data.get('dom_analysis', {})
+        elements = dom_analysis.get('elements', [])
+        
+        # Find matching elements
+        matching_elements = []
+        for element in elements:
+            # Check multiple selector strategies
+            if _element_matches_selector(element, selector):
+                matching_elements.append(element)
+        
+        if not matching_elements:
+            console.print(f"[yellow]⚠️  No elements found matching: {selector}[/yellow]")
+            console.print(f"💡 Total elements captured: {len(elements)}")
+            return
+        
+        console.print(f"\n✅ Found [bold]{len(matching_elements)}[/bold] matching element(s)\n")
+        
+        # Display detailed information for each match
+        for idx, element in enumerate(matching_elements[:5], 1):  # Show first 5
+            console.print(f"[bold cyan]═══ Element {idx}/{len(matching_elements)} ═══[/bold cyan]")
+            
+            # Basic info
+            tag = element.get('tagName', 'unknown')
+            elem_id = element.get('id', '')
+            classes = element.get('className', '')
+            
+            console.print(f"Tag:       [yellow]{tag}[/yellow]")
+            if elem_id:
+                console.print(f"ID:        [green]#{elem_id}[/green]")
+            if classes:
+                console.print(f"Classes:   [blue].{classes}[/blue]")
+            
+            # Selectors
+            unique_selector = element.get('uniqueSelector', 'N/A')
+            console.print(f"Unique:    [cyan]{unique_selector}[/cyan]")
+            
+            # Dimensions
+            bbox = element.get('boundingBox', {})
+            if bbox:
+                console.print(f"\n📐 Dimensions:")
+                console.print(f"   Position:  x={bbox.get('x', 0):.0f}, y={bbox.get('y', 0):.0f}")
+                console.print(f"   Size:      {bbox.get('width', 0):.0f}w × {bbox.get('height', 0):.0f}h")
+            
+            # Computed styles (key CSS properties)
+            computed = element.get('computedStyles', {})
+            if computed:
+                console.print(f"\n🎨 Key CSS Properties:")
+                
+                # Layout
+                display = computed.get('display', 'N/A')
+                position = computed.get('position', 'N/A')
+                console.print(f"   display:   {display}")
+                console.print(f"   position:  {position}")
+                
+                # Flexbox
+                if 'flex' in computed:
+                    console.print(f"   flex:      {computed.get('flex', 'N/A')}")
+                if 'flexBasis' in computed:
+                    console.print(f"   flex-basis: {computed.get('flexBasis', 'N/A')}")
+                
+                # Dimensions
+                width = computed.get('width', 'N/A')
+                height = computed.get('height', 'N/A')
+                console.print(f"   width:     {width}")
+                console.print(f"   height:    {height}")
+                
+                # Spacing
+                margin = computed.get('margin', 'N/A')
+                padding = computed.get('padding', 'N/A')
+                if margin != 'N/A':
+                    console.print(f"   margin:    {margin}")
+                if padding != 'N/A':
+                    console.print(f"   padding:   {padding}")
+                
+                # Show all styles in verbose mode
+                if verbose:
+                    console.print(f"\n📋 All Computed Styles:")
+                    for prop, value in sorted(computed.items())[:30]:  # Limit to 30
+                        console.print(f"   {prop}: {value}")
+            
+            # Accessibility info
+            accessibility = element.get('accessibility', {})
+            if accessibility:
+                role = accessibility.get('role', 'N/A')
+                is_interactive = accessibility.get('isInteractive', False)
+                console.print(f"\n♿ Accessibility:")
+                console.print(f"   Role:         {role}")
+                console.print(f"   Interactive:  {'✅' if is_interactive else '❌'}")
+            
+            # Visual context
+            visual = element.get('visual_context', {})
+            if visual:
+                console.print(f"\n👁️  Visual Context:")
+                if visual.get('is_visible'):
+                    console.print(f"   Visibility:   ✅ Visible")
+                else:
+                    console.print(f"   Visibility:   ❌ Hidden")
+                if visual.get('z_index'):
+                    console.print(f"   Z-index:      {visual.get('z_index')}")
+            
+            console.print("")  # Spacing between elements
+        
+        if len(matching_elements) > 5:
+            console.print(f"[dim]... and {len(matching_elements) - 5} more elements[/dim]")
+        
+        # Show screenshot location
+        screenshots = results.get('artifacts', {}).get('screenshots', [])
+        if screenshots:
+            screenshot_path = screenshots[0]
+            console.print(f"\n📸 Screenshot saved: [cyan]{screenshot_path}[/cyan]")
         
     except Exception as e:
         console.print(f"[red]❌ Inspection failed: {e}[/red]")
+        import traceback
+        console.print(traceback.format_exc())
+
+def _element_matches_selector(element: Dict, selector: str) -> bool:
+    """Check if element matches the given selector"""
+    
+    # ID selector
+    if selector.startswith('#'):
+        target_id = selector[1:]
+        return element.get('id') == target_id
+    
+    # Class selector
+    if selector.startswith('.'):
+        target_class = selector[1:]
+        classes = element.get('className', '')
+        return target_class in classes.split()
+    
+    # Tag selector
+    tag = element.get('tagName', '').lower()
+    selector_lower = selector.lower()
+    if tag == selector_lower:
+        return True
+    
+    # Check unique selector contains the target
+    unique_selector = element.get('uniqueSelector', '').lower()
+    if selector_lower in unique_selector:
+        return True
+    
+    return False
+
+@main.command()
+@click.option('--base-url', '-u', required=True)
+@click.option('--path', '-p', default='/', help='Path to navigate to')
+@click.option('--selector', '-s', required=True, multiple=True, help='Selector(s) to measure (can specify multiple)')
+@click.option('--verbose', '-v', is_flag=True, help='Show all computed CSS properties')
+def measure(base_url, path, selector, verbose):
+    """
+    Surgical element dimension measurement
+    
+    Quickly measure width, height, and position of elements.
+    Use --verbose to see all computed CSS properties.
+    
+    Examples:
+      cursorflow measure --base-url http://localhost:3000 --selector "#messages-panel"
+      cursorflow measure -u http://localhost:3000 -s "#panel1" -s "#panel2" --verbose
+    """
+    console.print(f"📏 Measuring element dimensions at [blue]{path}[/blue]\n")
+    
+    try:
+        from .core.cursorflow import CursorFlow
+        flow = CursorFlow(
+            base_url=base_url,
+            log_config={'source': 'local', 'paths': []},
+            browser_config={'headless': True}
+        )
+        
+        # Use comprehensive data capture but display only dimensions
+        selectors_list = list(selector)
+        
+        # Execute with screenshot to get comprehensive data
+        results = asyncio.run(flow.execute_and_collect([
+            {"navigate": path},
+            {"wait_for_selector": "body"},
+            {"screenshot": "measurement"}
+        ]))
+        
+        # Extract element data from comprehensive analysis
+        comprehensive_data = results.get('comprehensive_data', {})
+        dom_analysis = comprehensive_data.get('dom_analysis', {})
+        elements = dom_analysis.get('elements', [])
+        
+        # For each selector, find matching elements and display dimensions
+        for sel in selectors_list:
+            matching_elements = []
+            for element in elements:
+                if _element_matches_selector(element, sel):
+                    matching_elements.append(element)
+            
+            if not matching_elements:
+                console.print(f"[yellow]⚠️  {sel}: No elements found[/yellow]\n")
+                continue
+            
+            for idx, element in enumerate(matching_elements):
+                if len(matching_elements) > 1:
+                    console.print(f"[bold cyan]{sel}[/bold cyan] [dim](element {idx + 1}/{len(matching_elements)})[/dim]")
+                else:
+                    console.print(f"[bold cyan]{sel}[/bold cyan]")
+                
+                # Dimensions - check both camelCase and snake_case
+                bbox = element.get('boundingBox') or element.get('visual_context', {}).get('bounding_box')
+                if bbox:
+                    width = bbox.get('width', 0)
+                    height = bbox.get('height', 0)
+                    x = bbox.get('x', 0)
+                    y = bbox.get('y', 0)
+                    console.print(f"  📐 Rendered:  {width:.0f}w × {height:.0f}h")
+                    console.print(f"  📍 Position:  x={x:.0f}, y={y:.0f}")
+                
+                # Computed styles
+                computed = element.get('computedStyles', {})
+                if computed:
+                    if verbose:
+                        # Show ALL computed CSS properties
+                        console.print(f"  🎨 Computed CSS (all properties):")
+                        for prop, value in sorted(computed.items()):
+                            console.print(f"     {prop}: {value}")
+                    else:
+                        # Show key CSS properties only
+                        console.print(f"  🎨 Display:   {computed.get('display', 'N/A')}")
+                        console.print(f"  📦 CSS Width: {computed.get('width', 'N/A')}")
+                        
+                        if computed.get('flex'):
+                            console.print(f"  🔧 Flex:      {computed.get('flex')}")
+                        if computed.get('flexBasis') and computed.get('flexBasis') != 'auto':
+                            console.print(f"  📏 Flex Base: {computed.get('flexBasis')}")
+                        
+                        console.print(f"  💡 Use --verbose to see all {len(computed)} CSS properties")
+                
+                console.print("")
+        
+        console.print("✅ Measurement complete")
+        
+    except Exception as e:
+        console.print(f"[red]❌ Measurement failed: {e}[/red]")
+        import traceback
+        console.print(traceback.format_exc())
 
 @main.command()
 @click.option('--base-url', '-u', required=True)

cursorflow/core/browser_controller.py

@@ -1380,7 +1380,7 @@ class BrowserController:
                             animationData.transition_details.push({
                                 element_selector: element.tagName.toLowerCase() + 
                                     (element.id ? '#' + element.id : '') +
-                                    (element.className ? '.' + element.className.split(' ').join('.') : ''),
+                                    (element.className && typeof element.className === 'string' ? '.' + element.className.split(' ').join('.') : ''),
                                 transition_property: transitionProperty,
                                 duration: computedStyle.transitionDuration,
                                 delay: computedStyle.transitionDelay,

cursorflow/rules/cursorflow-usage.mdc

@@ -255,8 +255,9 @@ cursorflow test --base-url http://localhost:3000 --actions '[
 ### **All CLI Commands:**
 ```bash
 cursorflow test              # Test UI with comprehensive data capture
+cursorflow inspect           # Comprehensive element analysis (CSS, dimensions, accessibility)
+cursorflow measure           # Surgical dimension checking (quick CSS verification)
 cursorflow rerun             # Re-run last test
-cursorflow inspect           # Quick element inspection
 cursorflow count             # Count matching elements
 cursorflow timeline          # View event timeline
 cursorflow sessions          # Manage saved sessions
@@ -376,6 +377,54 @@ cursorflow test \
   ]'
 ```
 
+### CSS Debugging & Element Analysis
+```bash
+# Comprehensive element inspection (full CSS analysis)
+cursorflow inspect --base-url http://localhost:3000 --selector "#messages-panel"
+
+# Output includes:
+# - Computed CSS (all properties: display, flex, width, etc.)
+# - Rendered dimensions (actual width × height on screen)
+# - Position (x, y coordinates)
+# - Unique selector for targeting
+# - Accessibility info (role, interactive state)
+# - Visual context (visibility, z-index)
+# - Screenshot saved to artifacts
+
+# Show ALL computed CSS properties (verbose mode)
+cursorflow inspect -u http://localhost:3000 -p /dashboard -s ".card" --verbose
+
+# Quick dimension check (surgical precision)
+cursorflow measure --base-url http://localhost:3000 --selector "#panel"
+
+# Measure multiple elements at once
+cursorflow measure -u http://localhost:3000 -s "#panel1" -s "#panel2"
+
+# Verify CSS changes with all properties
+cursorflow measure -u http://localhost:3000 -s ".button" --verbose
+```
+
+**When to use inspect vs measure:**
+- **`inspect`**: Deep CSS debugging, complex layout issues, need accessibility info
+- **`measure`**: Quick dimension verification, CSS change validation, multiple elements
+
+**Workflow example:**
+```bash
+# 1. Quick check dimensions
+cursorflow measure -u http://localhost:3000 -s "#panel"
+# Output: 260w × 900h
+
+# 2. Dimensions seem wrong, get full analysis
+cursorflow inspect -u http://localhost:3000 -s "#panel" --verbose
+# Output: Full CSS, flex: 1 1 0%, flex-basis: 260px, etc.
+
+# 3. Make CSS changes based on insights
+
+# 4. Verify fix
+cursorflow measure -u http://localhost:3000 -s "#panel"
+# Output: 532w × 900h ✅
+```
+
 ## Analyzing Results
 
 ### **Hot Reload CSS Iteration Results** 

{cursorflow-2.2.8.dist-info → cursorflow-2.3.0.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.2.8
+Version: 2.3.0
 Summary: 🔥 Complete page intelligence for AI-driven development with Hot Reload Intelligence - captures DOM, network, console, performance, HMR events, and comprehensive page analysis
 Author-email: GeekWarrior Development <rbush@cooltheory.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/haley-marketing-group/cursorflow
-Project-URL: Documentation, https://cursorflow.readthedocs.io
+Project-URL: Documentation, https://cursorflow.dev
 Project-URL: Repository, https://github.com/haley-marketing-group/cursorflow
 Keywords: ui-testing,automation,cursor,ai,web-testing,css-iteration,hot-reload,hmr,element-intelligence,page-analysis,error-context
 Classifier: Development Status :: 5 - Production/Stable
@@ -386,6 +386,24 @@ cursorflow iterate-mockup https://mockup.com/design \
   ]'
 ```
 
+### **Element Analysis & CSS Debugging**
+```bash
+# Comprehensive element inspection with full CSS analysis
+cursorflow inspect --base-url http://localhost:3000 --selector "#messages-panel"
+
+# Show all computed CSS properties
+cursorflow inspect -u http://localhost:3000 -s ".card" --verbose
+
+# Quick dimension check (surgical precision)
+cursorflow measure --base-url http://localhost:3000 --selector "#panel"
+
+# Measure multiple elements at once
+cursorflow measure -u http://localhost:3000 -s "#panel1" -s "#panel2"
+
+# Verify CSS changes with all properties
+cursorflow measure -u http://localhost:3000 -s ".button" --verbose
+```
+
 ### **AI Integration**
 ```bash
 # Install Cursor AI rules
@@ -397,14 +415,6 @@ cursorflow update
 
 ## 🧠 Why This Matters
 
-### **For Job Board v4 Testing:**
-✅ **Real API response times** from `/ajax_rq.smpl?fn=gjapi_typeahead`  
-✅ **Actual network failures** when they occur  
-✅ **Real browser console errors** from production code  
-✅ **Genuine performance metrics** under real load  
-
-❌ **With mocking:** You'd never know the typeahead is slow in production!
-
 ### **For Any Web Application:**
 - **Trust your test results** - they reflect actual behavior
 - **Find real performance bottlenecks** - no artificial speed boosts
@@ -427,9 +437,8 @@ cursorflow update
 
 ## 📖 Documentation
 
-- **[Complete User Manual](docs/USER_MANUAL.md)** - Full feature guide
-- **[Examples](examples/)** - Practical usage examples  
-- **[API Reference](docs/api/)** - Complete Python API documentation
+- **[Usage Guide](docs/user/USAGE_GUIDE.md)** - Complete usage documentation (included in pip install)
+- **[Examples](examples/)** - Practical usage examples (included in pip install)
 
 ## 🎪 The CursorFlow Advantage
 

{cursorflow-2.2.8.dist-info → cursorflow-2.3.0.dist-info}/RECORD

@@ -1,14 +1,14 @@
 cursorflow/__init__.py,sha256=5G0Zm1HeS4oGx9S9E5GFRon5gduljQMlJhs1XEBUuE4,2763
 cursorflow/auto_init.py,sha256=dXQaXXiXe4wkUP-jd8fcJ5fYVt7ASdTb47b7SzXymOM,6122
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=cRxhu48AwQfpO48qlU2B29Vi_jfUIXFe5bvi8LS8poA,50423
+cursorflow/cli.py,sha256=l8TTcX6ve5Zx4sAOkdX5P1OChrZkDjvkix4Fbgdf-VE,62069
 cursorflow/install_cursorflow_rules.py,sha256=DsZ0680y9JMuTKFXjdgYtOKIEAjBMsdwL8LmA9WEb5A,11864
 cursorflow/post_install.py,sha256=WieBiKWG0qBAQpF8iMVWUyb9Fr2Xky9qECTMPrlAbpE,2678
 cursorflow/updater.py,sha256=SroSQHQi5cYyzcOK_bf-WzmQmE7yeOs8qo3r__j-Z6E,19583
 cursorflow/core/action_validator.py,sha256=SCk3w_62D1y0cCRDOajK8L44-abSj_KpnUBgR_yNVW4,6846
 cursorflow/core/agent.py,sha256=f3lecgEzDRDdGTVccAtorpLGfNJJ49bbsQAmgr0vNGg,10136
 cursorflow/core/auth_handler.py,sha256=oRafO6ZdxoHryBIvHsrNV8TECed4GXpJsdEiH0KdPPk,17149
-cursorflow/core/browser_controller.py,sha256=mfJ5a6-996TC6Z2CHNxxQUQPPqPjPWAvL1njTONwqsA,147423
+cursorflow/core/browser_controller.py,sha256=Efx48lxIz6MYZI8bHhIDpP_hqKDxeHSLvK8vgiPaXBM,147464
 cursorflow/core/browser_engine.py,sha256=7N9hPOyDrEhLWYgZW2981N9gKlHF6Lbp7D7h0zBzuz8,14851
 cursorflow/core/config_validator.py,sha256=HRtONSOmM0Xxt3-ok3xwnBADRiNnI0nNOMaS2OqOkDk,7286
 cursorflow/core/css_iterator.py,sha256=whLCIwbHZEWaH1HCbmqhNX5zrh_fL-r3hsxKjYsukcE,16478
@@ -29,10 +29,10 @@ cursorflow/log_sources/local_file.py,sha256=GVnhsaifIdc41twXwbxRM9-fBeRDsknDpk5I
 cursorflow/log_sources/ssh_remote.py,sha256=_Kwh0bhRpKgq-0c98oaX2hN6h9cT-wCHlqY5NiWVCoY,8388
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
 cursorflow/rules/cursorflow-installation.mdc,sha256=D55pzzDPAVVbE3gAtKPUGoT-2fvB-FI2l6yrTdzUIEo,10208
-cursorflow/rules/cursorflow-usage.mdc,sha256=JVj-Xgura1rIfHaR5W_GHy6mBVlYCgE922RtuRVEJvg,21383
-cursorflow-2.2.8.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.2.8.dist-info/METADATA,sha256=Pt_t2eFlVaGhHPNP5FiBHF6PlnvqSW25ZwEX6oDd7e8,14538
-cursorflow-2.2.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.2.8.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.2.8.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.2.8.dist-info/RECORD,,
+cursorflow/rules/cursorflow-usage.mdc,sha256=8TUeQ1hq2fTlgPqUBYOVBXrdEN0BR0Xp0d_1L-eUsME,23150
+cursorflow-2.3.0.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.3.0.dist-info/METADATA,sha256=hC0JZcjfBUi9MolXNXB80aX_YU23nH0Zgnr350bYKlI,14793
+cursorflow-2.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.3.0.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.3.0.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.3.0.dist-info/RECORD,,