ruby_raider 3.10.0 → 3.12.0

data/spec/integration/content/test_content_spec.rb

@@ -116,18 +116,41 @@ describe 'Test file content' do
     end
   end
 
+  shared_examples 'logged in example' do |project_name|
+    it 'adds a :logged_in example that reuses the saved login and keeps the login example' do
+      spec = read_generated(project_name, 'spec/login_page_spec.rb')
+      expect(spec).to include("describe 'Account', :logged_in", 'opens the account page with the saved login',
+                              "describe 'Login' do", 'can successfully log in')
+    end
+  end
+
+  shared_examples 'logged in scenario' do |project_name|
+    it 'adds a @logged_in scenario and keeps the login scenario' do
+      feature = read_generated(project_name, 'features/login.feature')
+      expect(feature).to include("@logged_in\nScenario: A logged-in user opens the account page",
+                                 "Given I'm a registered user\n", 'Scenario: A user can login')
+    end
+
+    it 'defines the step that picks the user without logging in' do
+      steps = read_generated(project_name, 'features/step_definitions/login_steps.rb')
+      expect(steps).to include(%q(Given("I'm a {user}") do |user|))
+    end
+  end
+
   # --- RSpec contexts ---
 
   context 'with rspec and selenium' do
     name = "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
     include_examples 'valid rspec spec', name
     include_examples 'selenium rspec spec', name
+    include_examples 'logged in example', name
   end
 
   context 'with rspec and watir' do
     name = "#{FrameworkIndex::RSPEC}_#{AutomationIndex::WATIR}"
     include_examples 'valid rspec spec', name
     include_examples 'watir rspec spec', name
+    include_examples 'logged in example', name
   end
 
   # --- Cucumber contexts ---
@@ -138,6 +161,7 @@ describe 'Test file content' do
     include_examples 'valid cucumber env', name
     include_examples 'valid cucumber world', name
     include_examples 'valid cucumber config', name
+    include_examples 'logged in scenario', name
   end
 
   context 'with cucumber and watir' do
@@ -146,5 +170,63 @@ describe 'Test file content' do
     include_examples 'valid cucumber env', name
     include_examples 'valid cucumber world', name
     include_examples 'valid cucumber config', name
+    include_examples 'logged in scenario', name
+  end
+end
+
+describe 'Cucumber world WaitHelper wiring' do
+  %w[selenium ios android cross_platform].each do |automation|
+    it "makes WaitHelper available to steps in #{automation}" do
+      world = read_generated("cucumber_#{automation}", 'features/support/world.rb')
+      expect(world).to include("require_relative '../../helpers/wait_helper'", 'World(WaitHelper)')
+    end
+  end
+
+  it 'leaves the watir world without WaitHelper' do
+    expect(read_generated('cucumber_watir', 'features/support/world.rb')).not_to include('WaitHelper')
+  end
+end
+
+describe 'Example tests on the wait helper' do
+  it 'wraps every assertion of the selenium rspec spec in eventually' do
+    spec = read_generated('rspec_selenium', 'spec/login_page_spec.rb')
+    expect(spec.scan('eventually { expect(').size).to eq(3)
+    expect(spec.scan(/^ +expect\(/)).to be_empty
+  end
+
+  it "wraps the selenium cucumber Then step's assertion in eventually" do
+    steps = read_generated('cucumber_selenium', 'features/step_definitions/login_steps.rb')
+    expect(steps).to include('eventually { expect(account_page.header.customer_name).to eq ')
+  end
+
+  %w[ios android cross_platform].each do |automation|
+    it "wraps the #{automation} rspec assertion in eventually" do
+      spec = read_generated("rspec_#{automation}", 'spec/pdp_page_spec.rb')
+      expect(spec).to include("eventually { expect(pdp_page.add_to_cart_text).to eq 'Add to Cart' }")
+    end
+
+    it "wraps the #{automation} cucumber Then step's assertion in eventually" do
+      steps = read_generated("cucumber_#{automation}", 'features/step_definitions/home_steps.rb')
+      expect(steps).to include("eventually { expect(pdp_page.add_to_cart_text).to eq 'Add to Cart' }")
+    end
+  end
+end
+
+# The Watir output must stay as master generated it (1274a66); the snapshots in
+# spec/fixtures/watir_master were generated from that commit's lib.
+# To regenerate: `git archive 1274a66 lib` into a scratch dir, generate rspec and cucumber Watir projects there,
+# then apply only the Readme deprecation-line delta (the `> **Deprecated:**` line under the heading block).
+describe 'Watir example output' do
+  snapshots = File.expand_path('../../fixtures/watir_master', __dir__)
+
+  { 'rspec_watir' => %w[page_objects/pages/login.rb page_objects/abstract/page.rb spec/login_page_spec.rb Readme.md],
+    'cucumber_watir' => %w[page_objects/pages/login.rb page_objects/abstract/page.rb
+                           features/step_definitions/login_steps.rb Readme.md] }.each do |project, files|
+    files.each do |file|
+      it "keeps #{project}/#{file} as master generates it" do
+        expected = File.read(File.join(snapshots, project, "#{file}.snapshot"))
+        expect(read_generated(project, file)).to eq(expected)
+      end
+    end
   end
 end

data/spec/integration/end_to_end_spec.rb

@@ -269,6 +269,29 @@ describe 'End-to-End Project Generation and Execution' do
   context 'Web Automation Frameworks' do
     describe 'Selenium + RSpec' do
       include_examples 'executable rspec project', 'rspec_selenium'
+
+      it 'saves the login once and reuses it', :aggregate_failures, :slow do
+        skip 'Bundle install failed' unless bundle_install('rspec_selenium')
+
+        state_file = File.join('rspec_selenium', '.raider', 'auth', 'user.json')
+        FileUtils.rm_rf(File.join('rspec_selenium', '.raider'))
+        first = run_in_project('rspec_selenium', 'bundle exec rspec spec/', env: { 'HEADLESS' => 'true' })
+        failed = ->(run, index) { "Run #{index} failed.\nSTDOUT: #{run[:stdout]}\nSTDERR: #{run[:stderr]}" }
+        raise failed.call(first, 1) unless first[:exit_code].zero? # show run 1's output, not a missing state file
+
+        expect(File).to exist(state_file)
+        saved = JSON.parse(File.read(state_file))
+        second = run_in_project('rspec_selenium', 'bundle exec rspec spec/', env: { 'HEADLESS' => 'true' })
+        expect(second[:exit_code]).to eq(0), failed.call(second, 2)
+        expect(File.stat(state_file).mode & 0o777).to eq(0o600)
+        expect(saved).to include('format' => 1, 'origin' => 'https://raider-test-site.onrender.com')
+        expect(JSON.parse(File.read(state_file))['saved_at']).to eq(saved['saved_at'])
+        cookie_values = saved['cookies'].map { |cookie| cookie['value'].to_s }
+        expect(cookie_values.reject(&:empty?)).not_to be_empty
+        output = [first, second].map { |run| run[:stdout] + run[:stderr] }.join
+        # Short values like "1" or "en" can appear in any output; a leaked token is long.
+        cookie_values.select { |value| value.length >= 8 }.each { |value| expect(output).not_to include(value) }
+      end
     end
 
     describe 'Watir + RSpec' do
@@ -375,6 +398,40 @@ describe 'End-to-End Project Generation and Execution' do
     end
   end
 
+  # An empty skeleton (examples: false) still passes its run, so its CI is green until tests are added
+  def generate_skeleton_project(framework)
+    name = "skeleton_e2e_#{framework}_selenium"
+    unless LazyProjectGenerator::GENERATED.include?(name)
+      generate_framework(framework:, automation: 'selenium', name:, examples: false)
+      LazyProjectGenerator::GENERATED.add(name)
+    end
+    name
+  end
+
+  context 'Empty skeleton projects (examples: false)' do
+    it 'runs bundle exec rspec on a selenium rspec skeleton with 0 examples', :aggregate_failures do
+      project = generate_skeleton_project('rspec')
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      ['rspec', 'rspec spec/'].each do |command|
+        result = run_in_project(project, "bundle exec #{command}", timeout: 120)
+        expect(result[:exit_code]).to eq(0), "#{command}\nSTDOUT: #{result[:stdout]}\nSTDERR: #{result[:stderr]}"
+        expect(result[:stdout]).to include('0 examples, 0 failures')
+      end
+    end
+
+    it 'runs bundle exec cucumber on a selenium cucumber skeleton with 0 scenarios', :aggregate_failures do
+      project = generate_skeleton_project('cucumber')
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      ['cucumber', 'cucumber features'].each do |command|
+        result = run_in_project(project, "bundle exec #{command}", timeout: 120)
+        expect(result[:exit_code]).to eq(0), "#{command}\nSTDOUT: #{result[:stdout]}\nSTDERR: #{result[:stderr]}"
+        expect(result[:stdout]).to include('0 scenarios')
+      end
+    end
+  end
+
   # Failure video replay against real browsers. Needs an ffmpeg with libvpx (RAIDER_FFMPEG_PATH), because the
   # RaiderHQ ffmpeg release has no checksums yet. Skipped when it, or the browser, is missing. Firefox can be
   # pointed at a specific binary with FIREFOX_BINARY.
@@ -660,38 +717,26 @@ describe 'End-to-End Project Generation and Execution' do
 
   # Verify template system performance (caching working)
   context 'Template System Performance' do
-    it 'benefits from template caching on second generation' do
+    it 'compiles each partial once and reuses it on the second generation' do
       require_relative '../../lib/generators/generator'
 
-      # Clear cache
       Generator.clear_template_cache
+      compiled = []
+      allow_any_instance_of(TemplateRenderer::PartialCache).to(
+        receive(:compile_template).and_wrap_original { |original, *args| compiled << args.first && original.call(*args) }
+      )
 
-      # First generation (cache miss)
-      start_time = Time.now
-      settings1 = create_settings(framework: 'rspec', automation: 'selenium')
-      settings1[:name] = 'test_cache_1'
-      generate_framework(settings1)
-      first_duration = Time.now - start_time
-
-      # Second generation (cache hit)
-      start_time = Time.now
-      settings2 = create_settings(framework: 'rspec', automation: 'selenium')
-      settings2[:name] = 'test_cache_2'
-      generate_framework(settings2)
-      second_duration = Time.now - start_time
-
-      # Second generation should be faster (or similar if I/O dominates)
-      # At minimum, cache should not slow things down
-      expect(second_duration).to be <= (first_duration * 1.2)
-
-      # Cleanup
-      FileUtils.rm_rf('test_cache_1')
-      FileUtils.rm_rf('test_cache_2')
-
-      # Verify cache has entries
-      stats = Generator.template_cache_stats
-      expect(stats[:size]).to be > 0
-      puts "\n📊 Template cache: #{stats[:size]} entries, ~#{stats[:memory_estimate] / 1024}KB"
+      %w[test_cache_1 test_cache_2].map do |name|
+        before = compiled.size
+        generate_framework(create_settings(framework: 'rspec', automation: 'selenium').merge(name:))
+        compiled.size - before
+      end => [first, second]
+
+      expect(first).to be_positive
+      expect(second).to eq(0)
+      expect(Generator.template_cache_stats[:size]).to be_positive
+    ensure
+      FileUtils.rm_rf(%w[test_cache_1 test_cache_2])
     end
   end
 end

data/spec/integration/generators/automation_generator_spec.rb

@@ -71,4 +71,54 @@ describe AutomationGenerator do
   context 'with cucumber and appium cross platform' do
     include_examples 'creates mobile automation framework', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
   end
+
+  describe 'without example tests' do
+    %w[rspec cucumber].product(%w[selenium ios cross_platform]).each do |framework, automation|
+      context "with #{framework} and #{automation}" do
+        let(:name) { ensure_project(framework:, automation:, examples: false) }
+
+        it 'creates no example pages' do
+          expect(Dir.glob("#{name}/page_objects/pages/*.rb")).to be_empty
+        end
+
+        it 'keeps the pages folder with a .keep' do
+          expect(File).to exist("#{name}/page_objects/pages/.keep")
+        end
+
+        it 'creates the abstract page' do
+          expect(File).to exist("#{name}/page_objects/abstract/page.rb")
+        end
+
+        it 'gives the abstract page no header component' do
+          expect(File.read("#{name}/page_objects/abstract/page.rb")).not_to include('Header')
+        end
+
+        it 'creates no models' do
+          expect(File).not_to exist("#{name}/models")
+        end
+      end
+    end
+
+    context 'with a web project' do
+      let(:name) { ensure_project(framework: 'rspec', automation: 'selenium', examples: false) }
+
+      it 'creates the abstract component' do
+        expect(File).to exist("#{name}/page_objects/abstract/component.rb")
+      end
+
+      it 'keeps the components folder with a .keep and no example component' do
+        expect(Dir.children("#{name}/page_objects/components")).to eq(['.keep'])
+      end
+    end
+
+    context 'with watir' do
+      it 'still creates the examples, because the Watir templates are frozen' do
+        InvokeGenerators.generate_framework(framework: 'rspec', automation: 'watir', name: 'skeleton_watir',
+                                            examples: false)
+        expect(File).to exist('skeleton_watir/page_objects/pages/login.rb')
+      ensure
+        FileUtils.rm_rf('skeleton_watir')
+      end
+    end
+  end
 end

data/spec/integration/generators/common_generator_spec.rb

@@ -107,4 +107,24 @@ describe CommonGenerator do
     include_examples 'creates a config file', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates a gitignore file', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
   end
+
+  describe 'without example tests' do
+    %w[rspec cucumber].product(%w[selenium ios cross_platform]).each do |framework, automation|
+      context "with #{framework} and #{automation}" do
+        let(:name) { ensure_project(framework:, automation:, examples: false) }
+        let(:ci_file) { automation == 'selenium' ? 'test_pipeline.yml' : 'appium_pipeline.yml' }
+
+        it 'creates the README, Gemfile, Rakefile and CI file' do
+          %W[Readme.md Gemfile Rakefile .github/workflows/#{ci_file}].each do |file|
+            expect(File).to exist("#{name}/#{file}")
+          end
+        end
+
+        it 'creates the settings' do
+          settings = automation == 'ios' ? 'config/capabilities.yml' : 'config/config.yml'
+          expect(File).to exist("#{name}/#{settings}")
+        end
+      end
+    end
+  end
 end

data/spec/integration/generators/config_features_spec.rb

@@ -35,9 +35,9 @@ describe 'Config features for generated projects' do
       expect(config['driver_options']).to be_nil
     end
 
-    it 'generates driver_helper with timeout from config' do
+    it 'generates driver_helper without an implicit wait' do
       helper = File.read('config_selenium_test/helpers/driver_helper.rb')
-      expect(helper).to include("config.fetch('timeout', 10)")
+      expect(helper).not_to include('implicit_wait')
     end
 
     it 'generates spec_helper with viewport-aware window setup' do

data/spec/integration/generators/cucumber_generator_spec.rb

@@ -61,4 +61,40 @@ describe CucumberGenerator do
     include_examples 'creates cucumber files', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}", 'login'
     include_examples 'creates factories for web projects', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}", 'login'
   end
+
+  describe 'without example tests' do
+    %w[selenium ios cross_platform].each do |automation|
+      context "with cucumber and #{automation}" do
+        let(:name) { ensure_project(framework: 'cucumber', automation:, examples: false) }
+
+        it 'creates no feature files' do
+          expect(Dir.glob("#{name}/features/**/*.feature")).to be_empty
+        end
+
+        it 'keeps an empty step_definitions folder' do
+          expect(Dir.children("#{name}/features/step_definitions")).to eq(['.keep'])
+        end
+
+        it 'creates the support files' do
+          expect(Dir.children("#{name}/features/support")).to contain_exactly('env.rb', 'world.rb')
+        end
+
+        it 'creates the cucumber.yml file' do
+          expect(File).to exist("#{name}/cucumber.yml")
+        end
+
+        it 'creates no user factory' do
+          expect(File).not_to exist("#{name}/models/user_factory.rb")
+        end
+      end
+    end
+
+    it 'creates no accessibility example' do
+      InvokeGenerators.generate_framework(framework: 'cucumber', automation: 'selenium', name: 'skeleton_axe_cucumber',
+                                          examples: false, accessibility: true)
+      expect(Dir.glob('skeleton_axe_cucumber/features/**/accessibility*')).to be_empty
+    ensure
+      FileUtils.rm_rf('skeleton_axe_cucumber')
+    end
+  end
 end

data/spec/integration/generators/helpers_generator_spec.rb

@@ -10,6 +10,18 @@ describe HelpersGenerator do
     end
   end
 
+  shared_examples 'creates a session state helper' do |name|
+    it 'creates a session state helper file' do
+      expect(File).to exist("#{name}/helpers/session_state.rb")
+    end
+  end
+
+  shared_examples 'skips the session state helper' do |name|
+    it 'does not create a session state helper file' do
+      expect(File).not_to exist("#{name}/helpers/session_state.rb")
+    end
+  end
+
   shared_examples 'creates selenium helpers' do |name|
     it 'creates a driver helper file' do
       expect(File).to exist("#{name}/helpers/driver_helper.rb")
@@ -20,6 +32,18 @@ describe HelpersGenerator do
     it 'creates a browser helper file' do
       expect(File).to exist("#{name}/helpers/browser_helper.rb")
     end
+
+    it 'does not create the wait helper or the element wrapper' do
+      expect(File).not_to exist("#{name}/helpers/wait_helper.rb")
+      expect(File).not_to exist("#{name}/helpers/raider_element.rb")
+    end
+  end
+
+  shared_examples 'creates the wait helper' do |name|
+    it 'creates the wait helper and the element wrapper' do
+      expect(File).to exist("#{name}/helpers/wait_helper.rb")
+      expect(File).to exist("#{name}/helpers/raider_element.rb")
+    end
   end
 
   shared_examples 'creates rspec helpers' do |name|
@@ -42,63 +66,99 @@ describe HelpersGenerator do
 
   context 'with rspec and selenium' do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
+    include_examples 'creates a session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
   end
 
   context 'with rspec and watir' do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::WATIR}"
+    include_examples 'creates a session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::WATIR}"
     include_examples 'creates watir helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::WATIR}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::WATIR}"
   end
 
   context 'with cucumber and selenium' do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
+    include_examples 'creates a session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
   end
 
   context 'with cucumber and watir' do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}"
+    include_examples 'creates a session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}"
     include_examples 'creates watir helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}"
   end
 
   context 'with rspec and appium android' do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
+    include_examples 'skips the session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
   end
 
   context 'with rspec and appium ios' do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
+    include_examples 'skips the session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
   end
 
   context 'with cucumber and appium android' do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
+    include_examples 'skips the session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
   end
 
   context 'with cucumber and appium ios' do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
+    include_examples 'skips the session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
   end
 
   context 'with rspec and appium cross platform' do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
+    include_examples 'skips the session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates cross platform helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
   end
 
   context 'with cucumber and appium cross platform' do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
+    include_examples 'skips the session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates cross platform helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
   end
+
+  describe 'without example tests' do
+    %w[rspec cucumber].product(%w[selenium ios cross_platform]).each do |framework, automation|
+      context "with #{framework} and #{automation}" do
+        let(:name) { ensure_project(framework:, automation:, examples: false) }
+
+        it 'creates the wait helper and RaiderElement' do
+          expect(File).to exist("#{name}/helpers/wait_helper.rb")
+          expect(File).to exist("#{name}/helpers/raider_element.rb")
+        end
+      end
+    end
+
+    it 'keeps the session state for web' do
+      name = ensure_project(framework: 'rspec', automation: 'selenium', examples: false)
+      expect(File).to exist("#{name}/helpers/session_state.rb")
+    end
+  end
 end

data/spec/integration/generators/invoke_generators_spec.rb

@@ -49,4 +49,74 @@ describe InvokeGenerators do
       expect(File).not_to exist('case_bad_ci')
     end
   end
+
+  describe '.collect_flags' do
+    it 'adds no_examples when examples is false' do
+      expect(described_class.collect_flags(automation: 'selenium', examples: false)).to include('no_examples')
+    end
+
+    it 'keeps the examples by default' do
+      expect(described_class.collect_flags(automation: 'selenium')).not_to include('no_examples')
+    end
+
+    it 'keeps the examples for watir, whose templates are frozen' do
+      expect(described_class.collect_flags(automation: 'watir', examples: false)).not_to include('no_examples')
+    end
+  end
+
+  context 'with the Watir deprecation notice' do
+    let(:notice) do
+      'Watir is deprecated and will be removed in the next major version of ruby_raider; new projects should use Selenium.'
+    end
+
+    it 'prints it for watir' do
+      expect { described_class.generate_framework(framework: 'rspec', automation: 'watir', name: 'case_dep') }
+        .to output(/#{Regexp.escape(notice)}/).to_stdout
+    end
+
+    it 'does not print it for selenium' do
+      expect { described_class.generate_framework(framework: 'rspec', automation: 'selenium', name: 'case_nodep') }
+        .not_to output(/Watir is deprecated/).to_stdout
+    end
+
+    it 'still prints it for raider new with automation:watir' do
+      root = File.expand_path('../../..', __dir__)
+      out, status = Open3.capture2e('ruby', "#{root}/bin/raider", 'new', 'case_cli_watir', '-p',
+                                    'framework:rspec', 'automation:watir')
+      expect(status.success?).to be(true)
+      expect(out).to include(notice)
+      expect(File).to exist('case_cli_watir/.rspec')
+    end
+  end
+
+  context 'with examples false for watir' do
+    it 'says the examples are kept' do
+      expect { described_class.generate_framework(framework: 'rspec', automation: 'watir', name: 'case_watir', examples: false) }
+        .to output(/Watir projects always include the example tests/).to_stdout
+    end
+  end
+end
+
+describe 'Projects named like a generator option' do
+  after { FileUtils.rm_rf(%w[no_examples watir selenium]) }
+
+  it 'keeps the example tests in a project named no_examples' do
+    InvokeGenerators.generate_framework(automation: 'selenium', framework: 'rspec', name: 'no_examples')
+    expect(File).to exist('no_examples/spec/login_page_spec.rb')
+    expect(File).to exist('no_examples/page_objects/pages/login.rb')
+  end
+
+  it 'gives a Selenium project named watir the wait helper it wires in' do
+    InvokeGenerators.generate_framework(automation: 'selenium', framework: 'cucumber', name: 'watir')
+    expect(File).to exist('watir/helpers/wait_helper.rb')
+    expect(File.read('watir/features/support/env.rb')).not_to include('Watir')
+    expect(File.read('watir/page_objects/abstract/page.rb')).to include('include WaitHelper')
+  end
+
+  it 'keeps a Watir project named selenium on Watir' do
+    InvokeGenerators.generate_framework(automation: 'watir', framework: 'rspec', name: 'selenium')
+    expect(File).not_to exist('selenium/helpers/wait_helper.rb')
+    expect(File.read('selenium/page_objects/abstract/page.rb')).to include('browser.element')
+    expect(File.read('selenium/page_objects/abstract/page.rb')).not_to include('find_element')
+  end
 end

data/spec/integration/generators/rspec_generator_spec.rb

@@ -46,4 +46,24 @@ describe RspecGenerator do
     include_examples 'creates rspec files examples',
                      "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}", 'pdp'
   end
+
+  describe 'without example tests' do
+    %w[selenium ios cross_platform].each do |automation|
+      context "with rspec and #{automation}" do
+        let(:name) { ensure_project(framework: 'rspec', automation:, examples: false) }
+
+        it 'creates an empty spec folder' do
+          expect(Dir.children("#{name}/spec")).to eq(['.keep'])
+        end
+      end
+    end
+
+    it 'creates no accessibility example' do
+      InvokeGenerators.generate_framework(framework: 'rspec', automation: 'selenium', name: 'skeleton_axe_rspec',
+                                          examples: false, accessibility: true)
+      expect(Dir.children('skeleton_axe_rspec/spec')).to eq(['.keep'])
+    ensure
+      FileUtils.rm_rf('skeleton_axe_rspec')
+    end
+  end
 end