Introduce a limit error.

lib/protocol/url.rb

@@ -4,6 +4,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require_relative "url/version"
+require_relative "url/error"
 require_relative "url/pattern"
 require_relative "url/encoding"
 require_relative "url/form_data/nested"

lib/protocol/url/error.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+module Protocol
+	module URL
+		# Raised when URL processing exceeds a configured limit.
+		class LimitError < StandardError
+		end
+	end
+end

lib/protocol/url/form_data/nested.rb

@@ -4,6 +4,7 @@
 # Copyright, 2026, by Samuel Williams.
 
 require_relative "../encoding"
+require_relative "../error"
 
 module Protocol
 	module URL
@@ -32,7 +33,7 @@ def add(name, value)
 					end
 
 					if @depth_limit and keys.size > @depth_limit
-						raise RangeError, "Form data depth exceeded limit of #{@depth_limit}!"
+						raise LimitError, "Form data depth exceeded limit of #{@depth_limit}!"
 					end
 
 					Encoding.assign(keys, value, @root)

lib/protocol/url/form_data/parser.rb

@@ -4,6 +4,7 @@
 # Copyright, 2026, by Samuel Williams.
 
 require_relative "nested"
+require_relative "../error"
 
 module Protocol
 	module URL
@@ -107,7 +108,7 @@ def decode_component(component)
 
 				def check_limit(name, value, limit)
 					if limit and value > limit
-						raise RangeError, "Form data #{name} exceeded limit of #{limit}!"
+						raise LimitError, "Form data #{name} exceeded limit of #{limit}!"
 					end
 				end
 			end

releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## Unreleased
+
+  - Add `Protocol::URL::LimitError` for configured processing limits.
+
 ## v0.8.0
 
   - Use consistent limit naming for form data parser constraints.

test/protocol/url/form_data/nested.rb

@@ -40,7 +40,7 @@
 
 		expect do
 			nested.add("a[b][c]", "value")
-		end.to raise_exception(RangeError, message: be =~ /depth exceeded/)
+		end.to raise_exception(Protocol::URL::LimitError, message: be =~ /depth exceeded/)
 	end
 
 	it "allows the nesting limit to be disabled" do

test/protocol/url/form_data/parser.rb

@@ -81,7 +81,7 @@ def to_h
 
 		expect do
 			parser.parse(StringIO.new("a=123"))
-		end.to raise_exception(RangeError, message: be =~ /size exceeded limit of 4/)
+		end.to raise_exception(Protocol::URL::LimitError, message: be =~ /size exceeded limit of 4/)
 	end
 
 	it "applies the pair count limit at its boundary" do
@@ -92,7 +92,7 @@ def to_h
 
 		expect do
 			parser.parse(StringIO.new("a=1&b=2&c=3"))
-		end.to raise_exception(RangeError, message: be =~ /pair_count exceeded limit of 2/)
+		end.to raise_exception(Protocol::URL::LimitError, message: be =~ /pair_count exceeded limit of 2/)
 	end
 
 	it "allows limits to be disabled" do
@@ -109,7 +109,7 @@ def to_h
 
 		expect do
 			parser.parse(StringIO.new("a%5Bb%5D%5Bc%5D=1"))
-		end.to raise_exception(RangeError, message: be =~ /depth exceeded limit of 2/)
+		end.to raise_exception(Protocol::URL::LimitError, message: be =~ /depth exceeded limit of 2/)
 	end
 
 	it "rejects an empty name when building nested form data" do