Add 'next' keyword

Author: mikeygough

lib/ruby_lsp/listeners/hover.rb

@@ -32,6 +32,7 @@ class Hover
         Prism::InstanceVariableTargetNode,
         Prism::InstanceVariableWriteNode,
         Prism::ModuleNode,
+        Prism::NextNode,
         Prism::SymbolNode,
         Prism::StringNode,
         Prism::InterpolatedStringNode,
@@ -88,6 +89,7 @@ def initialize(response_builder, global_state, uri, node_context, dispatcher, so
           :on_instance_variable_or_write_node_enter,
           :on_instance_variable_target_node_enter,
           :on_module_node_enter,
+          :on_next_node_enter,
           :on_super_node_enter,
           :on_forwarding_super_node_enter,
           :on_string_node_enter,
@@ -160,6 +162,11 @@ def on_module_node_enter(node)
         handle_keyword_documentation(node.module_keyword)
       end
 
+      #: (Prism::NextNode node) -> void
+      def on_next_node_enter(node)
+        handle_keyword_documentation(node.keyword)
+      end
+
       #: (Prism::InterpolatedStringNode node) -> void
       def on_interpolated_string_node_enter(node)
         generate_heredoc_hover(node)

lib/ruby_lsp/static_docs.rb

@@ -23,6 +23,7 @@ module RubyLsp
     "ensure" => "Executes the code in the ensure block regardless of whether an exception is raised or not",
     "for" => "Iterates over a collection of elements",
     "module" => "Defines a module",
+    "next" => "Skips to the next iteration of a loop",
     "yield" => "Invokes the passed block with the given arguments",
   }.freeze #: Hash[String, String]
 end

static_docs/next.md

@@ -0,0 +1,84 @@
+# Next
+
+In Ruby, the `next` keyword is used to skip the rest of the current iteration and move to the next iteration of a loop or block. It's similar to `continue` in other programming languages.
+
+```ruby
+# Basic next usage in a loop
+["README.md", ".git", "lib", ".gitignore"].each do |path|
+  next if path.start_with?(".")
+  puts "Processing: #{path}"
+end
+# Output:
+# Processing: README.md
+# Processing: lib
+```
+
+The `next` statement can be used with any of Ruby's iteration methods or blocks.
+
+```ruby
+# Using next with different iterators
+users = [
+  { name: "Alice", active: true },
+  { name: "Bob", active: false },
+  { name: "Carol", active: true }
+]
+
+# With each
+users.each do |user|
+  next unless user[:active]
+  puts "Notifying #{user[:name]}"
+end
+# Output:
+# Notifying Alice
+# Notifying Carol
+
+# With map
+messages = users.map do |user|
+  next "Account inactive" unless user[:active]
+  "Welcome back, #{user[:name]}!"
+end
+puts messages.inspect
+# Output:
+# ["Welcome back, Alice!", "Account inactive", "Welcome back, Carol!"]
+```
+
+## Conditional Next
+
+The `next` keyword is often used with conditions to create more complex iteration logic.
+
+```ruby
+# Processing specific elements
+orders = [
+  { id: 1, status: "paid" },
+  { id: 2, status: "pending" },
+  { id: 3, status: "cancelled" },
+  { id: 4, status: "paid" }
+]
+
+orders.each do |order|
+  # Skip non-paid orders
+  next unless order[:status] == "paid"
+  puts "Processing payment for order #{order[:id]}"
+end
+# Output:
+# Processing payment for order 1
+# Processing payment for order 4
+
+# Processing with multiple conditions
+products = [
+  { name: "Book", price: 15, in_stock: true },
+  { name: "Shirt", price: 25, in_stock: false },
+  { name: "Hat", price: 12, in_stock: true }
+]
+
+products.each do |product|
+  next unless product[:in_stock]    # Skip out of stock items
+  next if product[:price] > 20      # Skip expensive items
+  puts "Featured item: #{product[:name]} at $#{product[:price]}"
+end
+# Output:
+# Featured item: Book at $15
+# Featured item: Hat at $12
+```
+
+The `next` keyword helps control the flow of iterations, allowing you to skip unwanted elements or conditions while continuing the loop.