phoebe 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.2

data/rbi/phoebe/models/ref/hotspot_list_params.rbi

@@ -12,6 +12,9 @@ module Phoebe
             T.any(Phoebe::Ref::HotspotListParams, Phoebe::Internal::AnyHash)
           end
 
+        sig { returns(String) }
+        attr_accessor :region_code
+
         # The number of days back to fetch hotspots.
         sig { returns(T.nilable(Integer)) }
         attr_reader :back
@@ -30,12 +33,14 @@ module Phoebe
 
         sig do
           params(
+            region_code: String,
             back: Integer,
             fmt: Phoebe::Ref::HotspotListParams::Fmt::OrSymbol,
             request_options: Phoebe::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
+          region_code:,
           # The number of days back to fetch hotspots.
           back: nil,
           # Fetch the records in CSV or JSON format.
@@ -47,6 +52,7 @@ module Phoebe
         sig do
           override.returns(
             {
+              region_code: String,
               back: Integer,
               fmt: Phoebe::Ref::HotspotListParams::Fmt::OrSymbol,
               request_options: Phoebe::RequestOptions

data/rbi/phoebe/models/ref/region/adjacent_list_params.rbi

@@ -16,15 +16,23 @@ module Phoebe
               )
             end
 
+          sig { returns(String) }
+          attr_accessor :region_code
+
           sig do
-            params(request_options: Phoebe::RequestOptions::OrHash).returns(
-              T.attached_class
-            )
+            params(
+              region_code: String,
+              request_options: Phoebe::RequestOptions::OrHash
+            ).returns(T.attached_class)
           end
-          def self.new(request_options: {})
+          def self.new(region_code:, request_options: {})
           end
 
-          sig { override.returns({ request_options: Phoebe::RequestOptions }) }
+          sig do
+            override.returns(
+              { region_code: String, request_options: Phoebe::RequestOptions }
+            )
+          end
           def to_hash
           end
         end

data/rbi/phoebe/models/ref/region/info_retrieve_params.rbi

@@ -16,6 +16,9 @@ module Phoebe
               )
             end
 
+          sig { returns(String) }
+          attr_accessor :region_code
+
           # The characters used to separate elements in the name.
           sig { returns(T.nilable(String)) }
           attr_reader :delim
@@ -43,6 +46,7 @@ module Phoebe
 
           sig do
             params(
+              region_code: String,
               delim: String,
               region_name_format:
                 Phoebe::Ref::Region::InfoRetrieveParams::RegionNameFormat::OrSymbol,
@@ -50,6 +54,7 @@ module Phoebe
             ).returns(T.attached_class)
           end
           def self.new(
+            region_code:,
             # The characters used to separate elements in the name.
             delim: nil,
             # Control how the name is displayed.
@@ -61,6 +66,7 @@ module Phoebe
           sig do
             override.returns(
               {
+                region_code: String,
                 delim: String,
                 region_name_format:
                   Phoebe::Ref::Region::InfoRetrieveParams::RegionNameFormat::OrSymbol,

data/rbi/phoebe/models/ref/region/list_list_params.rbi

@@ -19,6 +19,9 @@ module Phoebe
           sig { returns(String) }
           attr_accessor :region_type
 
+          sig { returns(String) }
+          attr_accessor :parent_region_code
+
           # Fetch the records in CSV or JSON format.
           sig do
             returns(
@@ -35,12 +38,14 @@ module Phoebe
           sig do
             params(
               region_type: String,
+              parent_region_code: String,
               fmt: Phoebe::Ref::Region::ListListParams::Fmt::OrSymbol,
               request_options: Phoebe::RequestOptions::OrHash
             ).returns(T.attached_class)
           end
           def self.new(
             region_type:,
+            parent_region_code:,
             # Fetch the records in CSV or JSON format.
             fmt: nil,
             request_options: {}
@@ -51,6 +56,7 @@ module Phoebe
             override.returns(
               {
                 region_type: String,
+                parent_region_code: String,
                 fmt: Phoebe::Ref::Region::ListListParams::Fmt::OrSymbol,
                 request_options: Phoebe::RequestOptions
               }

data/rbi/phoebe/models/ref/taxonomy/form_list_params.rbi

@@ -16,15 +16,23 @@ module Phoebe
               )
             end
 
+          sig { returns(String) }
+          attr_accessor :species_code
+
           sig do
-            params(request_options: Phoebe::RequestOptions::OrHash).returns(
-              T.attached_class
-            )
+            params(
+              species_code: String,
+              request_options: Phoebe::RequestOptions::OrHash
+            ).returns(T.attached_class)
           end
-          def self.new(request_options: {})
+          def self.new(species_code:, request_options: {})
           end
 
-          sig { override.returns({ request_options: Phoebe::RequestOptions }) }
+          sig do
+            override.returns(
+              { species_code: String, request_options: Phoebe::RequestOptions }
+            )
+          end
           def to_hash
           end
         end

data/rbi/phoebe/models/ref/taxonomy/species_group_list_params.rbi

@@ -16,6 +16,14 @@ module Phoebe
               )
             end
 
+          # The order in which groups are returned.
+          sig do
+            returns(
+              Phoebe::Ref::Taxonomy::SpeciesGroupListParams::SpeciesGrouping::OrSymbol
+            )
+          end
+          attr_accessor :species_grouping
+
           # Locale for species group names. English names are returned for any non-listed
           # locale or any non-translated group name.
           sig { returns(T.nilable(String)) }
@@ -26,11 +34,15 @@ module Phoebe
 
           sig do
             params(
+              species_grouping:
+                Phoebe::Ref::Taxonomy::SpeciesGroupListParams::SpeciesGrouping::OrSymbol,
               group_name_locale: String,
               request_options: Phoebe::RequestOptions::OrHash
             ).returns(T.attached_class)
           end
           def self.new(
+            # The order in which groups are returned.
+            species_grouping:,
             # Locale for species group names. English names are returned for any non-listed
             # locale or any non-translated group name.
             group_name_locale: nil,
@@ -41,6 +53,8 @@ module Phoebe
           sig do
             override.returns(
               {
+                species_grouping:
+                  Phoebe::Ref::Taxonomy::SpeciesGroupListParams::SpeciesGrouping::OrSymbol,
                 group_name_locale: String,
                 request_options: Phoebe::RequestOptions
               }

data/rbi/phoebe/resources/data/observations/geo/recent/notable.rbi

@@ -6,6 +6,11 @@ module Phoebe
       class Observations
         class Geo
           class Recent
+            # The data/obs end-points are used to fetch observations submitted to eBird in
+            # checklists. There are two categories of end-point: 1. Fetch observations for a
+            # specific country, region or location. 2. Fetch observations for nearby
+            # locations - up to a distance of 50km. Each end-point supports optional query
+            # parameters which allow you to filter the list of observations returned.
             class Notable
               # Get the list of notable observations (up to 30 days ago) of birds seen at
               # locations within a radius of up to 50 kilometers, from a given set of

data/rbi/phoebe/resources/data/observations/geo/recent/species.rbi

@@ -6,6 +6,11 @@ module Phoebe
       class Observations
         class Geo
           class Recent
+            # The data/obs end-points are used to fetch observations submitted to eBird in
+            # checklists. There are two categories of end-point: 1. Fetch observations for a
+            # specific country, region or location. 2. Fetch observations for nearby
+            # locations - up to a distance of 50km. Each end-point supports optional query
+            # parameters which allow you to filter the list of observations returned.
             class Species
               # Get all observations of a species, seen up to 30 days ago, at any location
               # within a radius of up to 50 kilometers, from a given set of coordinates. Results

data/rbi/phoebe/resources/data/observations/geo/recent.rbi

@@ -5,7 +5,17 @@ module Phoebe
     class Data
       class Observations
         class Geo
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           class Recent
+            # The data/obs end-points are used to fetch observations submitted to eBird in
+            # checklists. There are two categories of end-point: 1. Fetch observations for a
+            # specific country, region or location. 2. Fetch observations for nearby
+            # locations - up to a distance of 50km. Each end-point supports optional query
+            # parameters which allow you to filter the list of observations returned.
             sig do
               returns(
                 Phoebe::Resources::Data::Observations::Geo::Recent::Species
@@ -13,6 +23,11 @@ module Phoebe
             end
             attr_reader :species
 
+            # The data/obs end-points are used to fetch observations submitted to eBird in
+            # checklists. There are two categories of end-point: 1. Fetch observations for a
+            # specific country, region or location. 2. Fetch observations for nearby
+            # locations - up to a distance of 50km. Each end-point supports optional query
+            # parameters which allow you to filter the list of observations returned.
             sig do
               returns(
                 Phoebe::Resources::Data::Observations::Geo::Recent::Notable

data/rbi/phoebe/resources/data/observations/geo.rbi

@@ -5,6 +5,11 @@ module Phoebe
     class Data
       class Observations
         class Geo
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           sig { returns(Phoebe::Resources::Data::Observations::Geo::Recent) }
           attr_reader :recent
 

data/rbi/phoebe/resources/data/observations/nearest/geo_species.rbi

@@ -5,6 +5,11 @@ module Phoebe
     class Data
       class Observations
         class Nearest
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           class GeoSpecies
             # Find the nearest locations where a species has been seen recently. #### Notes
             # The species code is typically a 6-letter code, e.g. barswa for Barn Swallow. You

data/rbi/phoebe/resources/data/observations/nearest.rbi

@@ -5,6 +5,11 @@ module Phoebe
     class Data
       class Observations
         class Nearest
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           sig do
             returns(Phoebe::Resources::Data::Observations::Nearest::GeoSpecies)
           end

data/rbi/phoebe/resources/data/observations/recent/historic.rbi

@@ -5,6 +5,11 @@ module Phoebe
     class Data
       class Observations
         class Recent
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           class Historic
             # Get a list of all taxa seen in a country, region or location on a specific date,
             # with the specific observations determined by the "rank" parameter (defaults to
@@ -32,13 +37,13 @@ module Phoebe
               ).returns(T::Array[Phoebe::Data::Observation])
             end
             def list(
-              # Path param:
+              # Path param
               d,
               # Path param: The country, subnational1, subnational2 or location code.
               region_code:,
-              # Path param:
+              # Path param
               y_:,
-              # Path param:
+              # Path param
               m:,
               # Query param: Only fetch observations from these taxonomic categories
               cat: nil,

data/rbi/phoebe/resources/data/observations/recent/notable.rbi

@@ -5,6 +5,11 @@ module Phoebe
     class Data
       class Observations
         class Recent
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           class Notable
             # Get the list of recent, notable observations (up to 30 days ago) of birds seen
             # in a country, region or location. Notable observations can be for locally or

data/rbi/phoebe/resources/data/observations/recent/species.rbi

@@ -5,6 +5,11 @@ module Phoebe
     class Data
       class Observations
         class Recent
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           class Species
             # Get the recent observations, up to 30 days ago, of a particular species in a
             # country, region or location. Results include only the most recent observation

data/rbi/phoebe/resources/data/observations/recent.rbi

@@ -4,17 +4,37 @@ module Phoebe
   module Resources
     class Data
       class Observations
+        # The data/obs end-points are used to fetch observations submitted to eBird in
+        # checklists. There are two categories of end-point: 1. Fetch observations for a
+        # specific country, region or location. 2. Fetch observations for nearby
+        # locations - up to a distance of 50km. Each end-point supports optional query
+        # parameters which allow you to filter the list of observations returned.
         class Recent
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           sig do
             returns(Phoebe::Resources::Data::Observations::Recent::Notable)
           end
           attr_reader :notable
 
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           sig do
             returns(Phoebe::Resources::Data::Observations::Recent::Species)
           end
           attr_reader :species
 
+          # The data/obs end-points are used to fetch observations submitted to eBird in
+          # checklists. There are two categories of end-point: 1. Fetch observations for a
+          # specific country, region or location. 2. Fetch observations for nearby
+          # locations - up to a distance of 50km. Each end-point supports optional query
+          # parameters which allow you to filter the list of observations returned.
           sig do
             returns(Phoebe::Resources::Data::Observations::Recent::Historic)
           end

data/rbi/phoebe/resources/data/observations.rbi

@@ -4,6 +4,11 @@ module Phoebe
   module Resources
     class Data
       class Observations
+        # The data/obs end-points are used to fetch observations submitted to eBird in
+        # checklists. There are two categories of end-point: 1. Fetch observations for a
+        # specific country, region or location. 2. Fetch observations for nearby
+        # locations - up to a distance of 50km. Each end-point supports optional query
+        # parameters which allow you to filter the list of observations returned.
         sig { returns(Phoebe::Resources::Data::Observations::Recent) }
         attr_reader :recent
 

data/rbi/phoebe/resources/product/checklist.rbi

@@ -3,6 +3,11 @@
 module Phoebe
   module Resources
     class Product
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       class Checklist
         # Get the details and observations of a checklist.
         #

data/rbi/phoebe/resources/product/lists/historical.rbi

@@ -4,6 +4,11 @@ module Phoebe
   module Resources
     class Product
       class Lists
+        # The product end-points make it easy to get the information shown in various
+        # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+        # checklists submitted on a given date. 3. The most recent checklists
+        # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+        # details and all the observations of a checklist.
         class Historical
           # Get information on the checklists submitted on a given date for a country or
           # region.

data/rbi/phoebe/resources/product/lists.rbi

@@ -3,7 +3,17 @@
 module Phoebe
   module Resources
     class Product
+      # The data/obs end-points are used to fetch observations submitted to eBird in
+      # checklists. There are two categories of end-point: 1. Fetch observations for a
+      # specific country, region or location. 2. Fetch observations for nearby
+      # locations - up to a distance of 50km. Each end-point supports optional query
+      # parameters which allow you to filter the list of observations returned.
       class Lists
+        # The product end-points make it easy to get the information shown in various
+        # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+        # checklists submitted on a given date. 3. The most recent checklists
+        # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+        # details and all the observations of a checklist.
         sig { returns(Phoebe::Resources::Product::Lists::Historical) }
         attr_reader :historical
 

data/rbi/phoebe/resources/product/species_list.rbi

@@ -3,6 +3,11 @@
 module Phoebe
   module Resources
     class Product
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       class SpeciesList
         # Get a list of species codes ever seen in a region, in taxonomic order (species
         # taxa only)

data/rbi/phoebe/resources/product/stats.rbi

@@ -3,6 +3,11 @@
 module Phoebe
   module Resources
     class Product
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       class Stats
         # Get a summary of the number of checklist submitted, species seen and
         # contributors on a given date for a country or region.

data/rbi/phoebe/resources/product/top100.rbi

@@ -3,6 +3,11 @@
 module Phoebe
   module Resources
     class Product
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       class Top100
         # Get the top 100 contributors on a given date for a country or region.
         #

data/rbi/phoebe/resources/product.rbi

@@ -3,18 +3,43 @@
 module Phoebe
   module Resources
     class Product
+      # The data/obs end-points are used to fetch observations submitted to eBird in
+      # checklists. There are two categories of end-point: 1. Fetch observations for a
+      # specific country, region or location. 2. Fetch observations for nearby
+      # locations - up to a distance of 50km. Each end-point supports optional query
+      # parameters which allow you to filter the list of observations returned.
       sig { returns(Phoebe::Resources::Product::Lists) }
       attr_reader :lists
 
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       sig { returns(Phoebe::Resources::Product::Top100) }
       attr_reader :top100
 
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       sig { returns(Phoebe::Resources::Product::Stats) }
       attr_reader :stats
 
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       sig { returns(Phoebe::Resources::Product::SpeciesList) }
       attr_reader :species_list
 
+      # The product end-points make it easy to get the information shown in various
+      # pages on the eBird web site: 1. The Top 100 contributors on a given date. 2. The
+      # checklists submitted on a given date. 3. The most recent checklists
+      # submitted. 4. A summary of the checklists submitted on a given date. 5. The
+      # details and all the observations of a checklist.
       sig { returns(Phoebe::Resources::Product::Checklist) }
       attr_reader :checklist
 

data/rbi/phoebe/resources/ref/hotspot/geo.rbi

@@ -4,6 +4,8 @@ module Phoebe
   module Resources
     class Ref
       class Hotspot
+        # With the ref/hotspot end-points you can find the hotspots for a given country or
+        # region or nearby hotspots
         class Geo
           # Get the list of hotspots, within a radius of up to 50 kilometers, from a given
           # set of coordinates.

data/rbi/phoebe/resources/ref/hotspot/info.rbi

@@ -4,6 +4,8 @@ module Phoebe
   module Resources
     class Ref
       class Hotspot
+        # With the ref/hotspot end-points you can find the hotspots for a given country or
+        # region or nearby hotspots
         class Info
           # Get information on the location of a hotspot. #### Notes This API call only
           # works for hotspots. If you pass the location code for a private location or an

data/rbi/phoebe/resources/ref/hotspot.rbi

@@ -3,10 +3,16 @@
 module Phoebe
   module Resources
     class Ref
+      # With the ref/hotspot end-points you can find the hotspots for a given country or
+      # region or nearby hotspots
       class Hotspot
+        # With the ref/hotspot end-points you can find the hotspots for a given country or
+        # region or nearby hotspots
         sig { returns(Phoebe::Resources::Ref::Hotspot::Geo) }
         attr_reader :geo
 
+        # With the ref/hotspot end-points you can find the hotspots for a given country or
+        # region or nearby hotspots
         sig { returns(Phoebe::Resources::Ref::Hotspot::Info) }
         attr_reader :info
 

data/rbi/phoebe/resources/ref/region/adjacent.rbi

@@ -4,6 +4,7 @@ module Phoebe
   module Resources
     class Ref
       class Region
+        # With the ref/geo end-point you can find a country's or region's neighbours.
         class Adjacent
           # Get the list of countries or regions that share a border with this one. ####
           # Notes Only subnational2 codes in the United States, New Zealand, or Mexico are

data/rbi/phoebe/resources/ref/region/info.rbi

@@ -4,6 +4,7 @@ module Phoebe
   module Resources
     class Ref
       class Region
+        # The ref/region end-points return information on regions.
         class Info
           # Get information on the name and geographical area covered by a region.
           #

data/rbi/phoebe/resources/ref/region/list.rbi

@@ -4,6 +4,7 @@ module Phoebe
   module Resources
     class Ref
       class Region
+        # The ref/region end-points return information on regions.
         class List
           # Get the list of sub-regions for a given country or region. #### Notes Not all
           # combinations of region type and region code are valid. You can fetch all the

data/rbi/phoebe/resources/ref/region.rbi

@@ -4,12 +4,15 @@ module Phoebe
   module Resources
     class Ref
       class Region
+        # With the ref/geo end-point you can find a country's or region's neighbours.
         sig { returns(Phoebe::Resources::Ref::Region::Adjacent) }
         attr_reader :adjacent
 
+        # The ref/region end-points return information on regions.
         sig { returns(Phoebe::Resources::Ref::Region::Info) }
         attr_reader :info
 
+        # The ref/region end-points return information on regions.
         sig { returns(Phoebe::Resources::Ref::Region::List) }
         attr_reader :list
 

data/rbi/phoebe/resources/ref.rbi

@@ -6,6 +6,8 @@ module Phoebe
       sig { returns(Phoebe::Resources::Ref::Region) }
       attr_reader :region
 
+      # With the ref/hotspot end-points you can find the hotspots for a given country or
+      # region or nearby hotspots
       sig { returns(Phoebe::Resources::Ref::Hotspot) }
       attr_reader :hotspot
 

data/sig/phoebe/internal/util.rbs

@@ -45,8 +45,12 @@ module Phoebe
         -> top?
       } -> top?
 
+      RFC_3986_NOT_PCHARS: Regexp
+
       def self?.uri_origin: (URI::Generic uri) -> String
 
+      def self?.encode_path: (String | Integer path) -> String
+
       def self?.interpolate_path: (String | ::Array[String] path) -> String
 
       def self?.decode_query: (String? query) -> ::Hash[String, ::Array[String]]
@@ -106,6 +110,16 @@ module Phoebe
       JSON_CONTENT: Regexp
       JSONL_CONTENT: Regexp
 
+      def encode_query_params: (
+        ::Hash[Symbol, top] query
+      ) -> ::Hash[Symbol, top]
+
+      private def write_query_param_element!: (
+        ::Hash[Symbol, top] collection,
+        String key,
+        top element
+      ) -> nil
+
       def self?.write_multipart_content: (
         Enumerator::Yielder y,
         val: top,