2.1: delete the legacy namespace trees and the driver abstraction

.dockerignore

@@ -0,0 +1,25 @@
+.github/
+.ruby-lsp/
+coverage/
+tmp/
+# Keep .git/ — needed for gemspec git ls-files and VCS checkout in tests
+.idea/
+.claude/
+.bundle/
+vendor/
+.specs/
+*.gem
+*.rbc
+*.log
+
+# Ignore report files
+*.attempt_*.png
+*.diff.png
+*.base.png
+*.attempt_*.webp
+*.diff.webp
+*.base.webp
+
+# OS files
+.DS_Store
+Thumbs.db

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,64 @@
+---
+name: Bug report
+about: Create a report to help us improve screenshot comparisons
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '...'
+3. Run `....`
+4. See error
+
+## Expected behavior
+
+A clear and concise description of what you expected to happen.
+
+## Actual behavior
+
+What actually happened. Include the full error message and stack trace if applicable.
+
+## Screenshots
+
+If applicable, add the `.diff.png` or `.heatmap.diff.png` files to help explain the problem.
+
+## Environment
+
+- **Ruby version:** (e.g., 3.4.1)
+- **Rails version:** (e.g., 8.0) or N/A (non-Rails project)
+- **`capybara-screenshot-diff` version:** (e.g., 1.12.0)
+- **Image processing driver:** (`:vips` or `:chunky_png`)
+- **Capybara driver:** (e.g., `selenium_chrome_headless`, `cuprite`)
+- **Operating system:** (e.g., macOS 14, Ubuntu 24.04)
+- **CI environment:** (e.g., GitHub Actions, local only)
+
+## Configuration
+
+```ruby
+# Your test helper configuration (omit sensitive parts)
+```
+
+## Debug output
+
+If applicable, run with `DEBUG=1` and paste the output:
+
+```
+DEBUG=1 bundle exec rake test
+```
+
+## Additional context
+
+Add any other context about the problem here. For example:
+- Is it specific to CI vs local?
+- Does it reproduce with both VIPS and ChunkyPNG drivers?
+- Is this a regression from a previous version?

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Questions & Discussion
+    url: https://github.com/snap-diff/snap_diff-capybara/discussions
+    about: Ask questions and discuss usage with the community
+  - name: Documentation
+    url: https://github.com/snap-diff/snap_diff-capybara#readme
+    about: Check the README and docs/ directory first

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,36 @@
+---
+name: Feature request
+about: Suggest an idea for improving screenshot diff testing
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+## Is your feature request related to a problem?
+
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+## Describe the solution you'd like
+
+A clear and concise description of what you want to happen.
+
+## Describe alternatives you've considered
+
+A clear and concise description of any alternative solutions or features you've considered.
+
+## How would this benefit visual regression testing?
+
+Explain how this feature would help improve the screenshot comparison workflow for you or your team.
+
+## Example usage
+
+If applicable, show how you'd expect to use this feature:
+
+```ruby
+# Example configuration or test code
+```
+
+## Additional context
+
+Add any other context, screenshots, or references about the feature request here.

.github/actions/setup-ruby-and-dependencies/action.yml

@@ -0,0 +1,38 @@
+---
+name: 'Setup Ruby and Cache'
+description: 'Set up Ruby environment and cache apt packages'
+inputs:
+  ruby-version:
+    description: 'Ruby version to set up'
+    required: true
+  ruby-cache-version:
+    description: 'Bundler cache version'
+    required: false
+  cache-apt-packages:
+    description: 'Whether to cache apt packages'
+    required: false
+    default: 'false'
+runs:
+  using: 'composite'
+  steps:
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ inputs.ruby-version }}
+        bundler-cache: true
+        cache-version: ${{ inputs.ruby-cache-version }}-v1
+
+    - name: Install and cache vips
+      if: ${{ inputs.cache-apt-packages == 'true' }}
+      uses: jetthoughts/cache-apt-pkgs-action@fix/upgrade-actions-cache-v5
+      with:
+        packages: libvips libglib2.0-0 libglib2.0-dev libwebp-dev libvips42 libpng-dev
+        version: tests-v2
+
+    - name: Install vips (fallback)
+      if: ${{ inputs.cache-apt-packages != 'true' }}
+      run: sudo apt-get -qq update && sudo apt-get -qq install -y libvips
+      shell: bash
+
+    - run: sudo sed -i 's/true/false/g' /etc/fonts/conf.d/10-yes-antialias.conf
+      shell: bash

.github/actions/upload-screenshots/action.yml

@@ -0,0 +1,113 @@
+---
+name: 'Upload SnapDiff screenshots'
+description: 'Upload screenshot diffs, HTML report, and optionally comment on PR'
+inputs:
+  name:
+    description: 'Artifact name prefix'
+    required: true
+  report-path:
+    description: 'Path to the HTML report directory'
+    default: 'doc/screenshots'
+  retention-days:
+    description: 'Number of days to retain artifacts'
+    default: '2'
+  pr-comment:
+    description: 'Post PR comment with report link (requires pull-requests: write)'
+    default: 'false'
+outputs:
+  report-url:
+    description: 'Direct URL to the inline HTML report artifact'
+    value: ${{ steps.upload-report.outputs.artifact-url }}
+  report-full-url:
+    description: 'Direct URL to the full report artifact (with images)'
+    value: ${{ steps.upload-report-full.outputs.artifact-url }}
+runs:
+  using: 'composite'
+  steps:
+    - name: Upload screenshot diffs
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}-diffs
+        retention-days: ${{ inputs.retention-days }}
+        path: test/fixtures/app/doc/screenshots/
+        if-no-files-found: ignore
+
+    - name: Upload Capybara failure screenshots
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}-capybara-fails
+        retention-days: ${{ inputs.retention-days }}
+        path: tmp/capybara/screenshots-diffs/
+        if-no-files-found: ignore
+
+    - name: Check for HTML report
+      id: check-report
+      shell: bash
+      run: |
+        if [ -f "${{ inputs.report-path }}/snap_diff_report.html" ]; then
+          echo "exists=true" >> "$GITHUB_OUTPUT"
+        else
+          echo "exists=false" >> "$GITHUB_OUTPUT"
+        fi
+
+    - name: Prepare HTML report for inline preview
+      if: steps.check-report.outputs.exists == 'true'
+      shell: bash
+      run: cp "${{ inputs.report-path }}/snap_diff_report.html" "${{ inputs.report-path }}/${{ inputs.name }}-snap_diff-report.html"
+
+    - name: Upload HTML report (inline preview)
+      id: upload-report
+      if: steps.check-report.outputs.exists == 'true'
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}-snap_diff-report
+        retention-days: ${{ inputs.retention-days }}
+        path: ${{ inputs.report-path }}/${{ inputs.name }}-snap_diff-report.html
+        archive: false
+
+    - name: Upload HTML report with images (full download)
+      id: upload-report-full
+      if: steps.check-report.outputs.exists == 'true'
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}-report-full
+        retention-days: ${{ inputs.retention-days }}
+        path: ${{ inputs.report-path }}/
+
+    - name: Job summary
+      if: steps.check-report.outputs.exists == 'true'
+      shell: bash
+      run: |
+        cat >> "$GITHUB_STEP_SUMMARY" <<EOF
+        ### SnapDiff Report
+
+        | Artifact | Link |
+        |----------|------|
+        | HTML report (inline) | ${{ steps.upload-report.outputs.artifact-url || 'N/A' }} |
+        | Full report with images | ${{ steps.upload-report-full.outputs.artifact-url || 'N/A' }} |
+        EOF
+
+    - name: Find existing PR comment
+      if: inputs.pr-comment == 'true' && github.event_name == 'pull_request'
+      uses: peter-evans/find-comment@v3
+      id: find-comment
+      with:
+        issue-number: ${{ github.event.pull_request.number }}
+        comment-author: 'github-actions[bot]'
+        body-includes: 'Screenshot diffs'
+
+    - name: Comment PR with report link
+      if: inputs.pr-comment == 'true' && github.event_name == 'pull_request'
+      uses: peter-evans/create-or-update-comment@v5
+      with:
+        comment-id: ${{ steps.find-comment.outputs.comment-id }}
+        issue-number: ${{ github.event.pull_request.number }}
+        edit-mode: replace
+        body: |
+          ### Screenshot diffs detected
+
+          | Artifact | Link |
+          |----------|------|
+          | HTML report (inline) | ${{ steps.upload-report.outputs.artifact-url || 'N/A' }} |
+          | Full report with images | ${{ steps.upload-report-full.outputs.artifact-url || 'N/A' }} |
+          | [All artifacts](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}#artifacts) | Browse all |

.github/dependabot.yml

@@ -0,0 +1,8 @@
+---
+version: 2
+
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/lint.yml

@@ -0,0 +1,44 @@
+---
+name: Lint
+
+on:
+  pull_request:
+    branches: [ master ]
+    paths:
+      - '**.rb'
+      - '**.yml'
+      - '.github/workflows/lint.yml'
+      - '!bin/**'
+
+env:
+  RUBY_YJIT_ENABLE: 1
+
+# Test has had this since it was written; Lint never did, so every push to a
+# PR ran a fresh linter to completion alongside the superseded ones.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Ruby & YAML
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '4.0'
+          bundler-cache: true
+
+      - name: Run Standard Ruby linter
+        run: bin/standardrb --no-fix --fail-fast
+
+      - name: Run Yaml linter
+        run: |
+          sudo apt-get install --fix-missing -qq --no-install-recommends yamllint
+          yamllint ./