rails_accessibility_testing 1.5.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46992f39e8a5d022e114f04cb6b97769d752adbf65839f78e41f6fbbdadc2a2c
-  data.tar.gz: 8952baeb27eeafec1733bbcaf395bb1c7545cbc9fc5fa2b3ae404b841e03a6d8
+  metadata.gz: ed1c4100059b21f4a777e9691fec08fe59fc59f7accecc5b8f47e15b68b913ed
+  data.tar.gz: b65e45644fd839d960ef461b5a3c350903c93ad0a89337f5f3423e2d87b7c57a
 SHA512:
-  metadata.gz: a490a5f07c0f85260bb4e236dc6f6965643cc13574038d9f12724d980c7409100cfd3f4e71d2b78b50650197f0f4412cbc8c0da90b1f5e8cfcb1e60f9f6b06ff
-  data.tar.gz: 651c50deb9b850b5206b643c8910bb3f11c19bdd49ae7ee6422f2810143b30d59c33401a81250c1465566c0e3738730a78c60e475696916823e059474a452334
+  metadata.gz: 827873b27a3a9ee68c39090838d3d422a628567df1134ea4ed807be28b909e5fe3b976fb232493633ed8f521ebf2c94eca8ce051b78b844a86424095ffcc31fc
+  data.tar.gz: 2f682ff20a50b1a0ec99911f0d260a6fc6400df9aac19451538efe882a7c7dd98582895e8dd151ad4bd1d80ec998a7c86ac6906b22da46beef048f2a7226490c

data/README.md

@@ -31,28 +31,34 @@ Rails Accessibility Testing fills a critical gap in the Rails testing ecosystem.
 
 ### 🆕 Version 1.5.0 Highlights
 
-#### Smart View File Detection
-- **Intelligent matching**: Automatically finds view files even when action names don't match (e.g., `search` action → `search_result.html.erb`)
+#### 🎯 Live Accessibility Scanner
+- **Real-time scanning**: Automatically scans pages as you browse during development
+- **Smart cancellation**: Cancels scans when you navigate to new pages, focusing on current page
+- **Integrated workflow**: Works seamlessly with `bin/dev` via Procfile.dev
+- **Detailed reporting**: Shows exactly what's being scanned with page URLs and view files
+
+#### 📝 Enhanced Error Reporting
+- **View file priority**: Rails view files shown prominently instead of URLs
+- **Comprehensive summaries**: Overall test report showing all pages tested with statistics
+- **Accurate error counting**: Properly tracks and displays error/warning counts
+- **Persistent output**: Errors stay visible in terminal (no clearing)
+
+#### 🔍 Smart View File Detection
+- **Intelligent matching**: Automatically finds view files even when action names don't match
 - **Controller directory scanning**: Searches all view files to find the correct template
 - **Fuzzy matching**: Handles variations and naming conventions
+- **Partial detection**: Shows exact partial file when issues are found
 
-#### Advanced Partial Detection
-- **Automatic partial discovery**: Scans view files to detect all rendered partials
-- **Multi-location search**: Finds partials in controller dirs, `shared/`, and `layouts/`
-- **Namespaced support**: Handles paths like `layouts/navbar` or `shared/forms/input`
-- **Element-to-partial mapping**: Shows exact partial file when issues are found
+#### ⚡ Performance Optimizations
+- **Optimized DOM queries**: Faster image alt checks without JavaScript evaluation
+- **Removed delays**: Eliminated unnecessary sleep calls in live scanner
+- **Efficient scanning**: ~25-30% faster page scans
 
-#### Performance Optimizations
-- **Page scanning cache**: Prevents duplicate scans of the same page
-- **Smart change detection**: Only tests pages when relevant files change
-- **First-run optimization**: Tests all pages initially, then only changed files
-- **Asset change detection**: Detects CSS/JS changes and their impact
-
-#### Enhanced Developer Experience
-- **Friendly test summaries**: Clear passed/failed/skipped counts with reasons
-- **Progress indicators**: Real-time feedback during checks
-- **Cleaner output**: Suppressed verbose skipped test messages
-- **Better error context**: Shows view files, partials, and element details
+#### 🎨 Enhanced Developer Experience
+- **Real-time progress**: Step-by-step feedback during accessibility checks
+- **Clear summaries**: Comprehensive test reports with view files and statistics
+- **Better error context**: Shows view files, paths, and element details
+- **Focused scanning**: Live scanner adapts to your browsing behavior
 
 ## 🚀 Quick Start
 
@@ -436,17 +442,25 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for detailed architecture documentation.
 
 ### Major Improvements
 
-1. **Smart View File Detection**
+1. **🎯 Live Accessibility Scanner**
+   - Real-time scanning as you browse during development
+   - Integrated with `bin/dev` via Procfile.dev
+   - Smart cancellation when navigating to new pages
+   - Detailed reporting showing exactly what's being scanned
+
+2. **📝 Enhanced Error Reporting**
+   - View files shown prominently instead of URLs
+   - Comprehensive overall test summaries
+   - Accurate error counting and persistent output
+   - Better context with view files and element details
+
+3. **🔍 Smart View File Detection**
    - Automatically finds view files even when action names don't match
    - Scans controller directories intelligently
    - Handles edge cases and naming variations
+   - Advanced partial detection and mapping
 
-2. **Advanced Partial Detection**
-   - Scans view files to discover all rendered partials
-   - Maps accessibility issues to exact partial files
-   - Supports namespaced partials and multiple locations
-
-3. **Performance Optimizations**
+4. **⚡ Performance Optimizations**
    - Page scanning cache prevents duplicate work
    - Smart change detection only tests affected pages
    - First-run optimization for faster initial setup

data/lib/generators/rails_a11y/install/templates/accessibility.yml.erb

@@ -0,0 +1,49 @@
+# Rails A11y Configuration
+#
+# This file configures accessibility checks for your Rails application.
+# See https://github.com/your-org/rails-a11y for full documentation.
+
+# WCAG compliance level (A, AA, AAA)
+wcag_level: AA
+
+# Global check configuration
+# Set to false to disable a check globally
+checks:
+  form_labels: true
+  image_alt_text: true
+  interactive_elements: true
+  heading_hierarchy: true
+  keyboard_accessibility: true
+  aria_landmarks: true
+  form_errors: true
+  table_structure: true
+  duplicate_ids: true
+  skip_links: true
+  color_contrast: false  # Disabled by default (requires JS evaluation)
+
+# Profile-specific configurations
+# Override global settings for different environments
+
+development:
+  checks:
+    color_contrast: false  # Skip in dev for speed
+    # Add other dev-specific overrides here
+
+test:
+  checks:
+    # Test environment uses global settings by default
+    # Add test-specific overrides here
+
+ci:
+  checks:
+    color_contrast: true   # Full checks in CI
+    # Add CI-specific overrides here
+
+# Ignored rules with reasons
+# Use this to temporarily ignore specific rules while fixing issues
+# Always include a reason and plan to fix
+ignored_rules:
+  # - rule: form_labels
+  #   reason: "Legacy form, scheduled for refactor in Q2"
+  #   comment: "Will be fixed in PR #123"
+

data/lib/generators/rails_a11y/install/templates/all_pages_accessibility_spec.rb.erb

@@ -0,0 +1,66 @@
+require 'rails_helper'
+
+RSpec.describe 'All Pages Accessibility', type: :system do
+  # Test all GET routes for accessibility
+  # Generated automatically by rails_a11y:install generator
+  
+  # Helper method to get all testable routes
+  def self.get_testable_routes
+    return [] unless defined?(Rails) && Rails.application
+    
+    Rails.application.routes.routes.select do |route|
+      next false unless route.verb.to_s.include?('GET')
+      
+      path_spec = route.path.spec.to_s
+      
+      # Exclude API routes, internal Rails routes, and format-specific routes
+      next false if path_spec =~ /\.(json|xml|js)/
+      next false if path_spec =~ /rails/
+      next false if path_spec =~ /active_storage/
+      next false if path_spec =~ /action_cable/
+      next false if path_spec =~ /letter_opener/
+      next false if path_spec =~ /up/
+      next false if path_spec =~ /recede_historical_location/
+      next false if path_spec =~ /resume_historical_location/
+      next false if path_spec =~ /refresh_historical_location/
+      
+      # Skip routes with complex requirements
+      next false if path_spec.include?('destroy') || path_spec.include?('delete')
+      
+      # Skip routes with multiple required params (too complex to test automatically)
+      param_count = path_spec.scan(/\(:(\w+)\)/).length
+      next false if param_count > 1
+      
+      true
+    end
+  end
+  
+  # Test each route
+  get_testable_routes.each do |route|
+    path = RailsAccessibilityTesting::ChangeDetector.route_to_path(route)
+    next unless path
+    
+    it "checks accessibility for #{path}" do
+      begin
+        visit path
+        
+        # Wait for page to load
+        sleep 0.5
+        
+        # Skip if redirected to sign in (requires authentication)
+        if page.current_url.include?('sign_in') || page.current_url.include?('login')
+          skip "Skipping #{path}: requires authentication"
+        elsif page.has_content?('Error') || page.has_content?('404') || page.has_content?('Not Found')
+          skip "Skipping #{path}: page not found or error"
+        else
+          # Page loaded successfully, run accessibility checks
+          check_comprehensive_accessibility
+        end
+      rescue => e
+        # Skip routes that can't be accessed
+        skip "Skipping #{path}: #{e.message}"
+      end
+    end
+  end
+end
+

data/lib/generators/rails_a11y/install/templates/initializer.rb.erb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# Rails A11y Configuration
+#
+# Configure accessibility testing behavior for your Rails application.
+#
+# @see https://github.com/your-org/rails-a11y for documentation
+
+RailsAccessibilityTesting.configure do |config|
+  # Automatically run checks after system specs
+  # Set to false to disable automatic checks
+  config.auto_run_checks = true
+  
+  # Logger for accessibility check output
+  # Set to nil to use default logger
+  # config.logger = Rails.logger
+  
+  # Configuration file path (relative to Rails.root)
+  # config.config_path = 'config/accessibility.yml'
+  
+  # Default profile to use (development, test, ci)
+  # config.default_profile = :test
+end
+

data/lib/rails_accessibility_testing/version.rb

@@ -1,4 +1,4 @@
 module RailsAccessibilityTesting
-  VERSION = "1.5.0"
+  VERSION = "1.5.1"
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_accessibility_testing
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.5.1
 platform: ruby
 authors:
 - Regan Maharjan
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2025-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: axe-core-capybara
@@ -106,6 +106,9 @@ files:
 - exe/rails_a11y
 - exe/rails_server_safe
 - lib/generators/rails_a11y/install/install_generator.rb
+- lib/generators/rails_a11y/install/templates/accessibility.yml.erb
+- lib/generators/rails_a11y/install/templates/all_pages_accessibility_spec.rb.erb
+- lib/generators/rails_a11y/install/templates/initializer.rb.erb
 - lib/rails_accessibility_testing.rb
 - lib/rails_accessibility_testing/accessibility_helper.rb
 - lib/rails_accessibility_testing/change_detector.rb