arfi 0.5.0 → 1.0.0

data/rbs_collection.lock.yaml

@@ -6,7 +6,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: actionmailer
@@ -14,7 +14,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: actionpack
@@ -22,7 +22,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: actiontext
@@ -30,7 +30,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: actionview
@@ -38,7 +38,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: activejob
@@ -46,7 +46,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: activemodel
@@ -54,7 +54,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: activerecord
@@ -62,7 +62,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: activestorage
@@ -70,7 +70,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: activesupport
@@ -78,7 +78,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: ast
@@ -86,39 +86,35 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: base64
-  version: '0.1'
+  version: 0.3.0
+  source:
+    type: rubygems
+- name: bigdecimal
+  version: '4.0'
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
-- name: benchmark
-  version: '0'
-  source:
-    type: stdlib
-- name: bigdecimal
-  version: '3.1'
+- name: cgi
+  version: '0.5'
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
-- name: cgi
-  version: '0'
-  source:
-    type: stdlib
 - name: concurrent-ruby
   version: '1.1'
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: connection_pool
@@ -126,7 +122,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: csv
@@ -134,13 +130,17 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: date
   version: '0'
   source:
     type: stdlib
+- name: dbm
+  version: '0'
+  source:
+    type: stdlib
 - name: delegate
   version: '0'
   source:
@@ -150,7 +150,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: digest
@@ -162,7 +162,7 @@ gems:
   source:
     type: stdlib
 - name: ffi
-  version: 1.17.2
+  version: 1.17.3
   source:
     type: rubygems
 - name: fileutils
@@ -178,7 +178,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: i18n
@@ -186,7 +186,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: io-console
@@ -197,12 +197,20 @@ gems:
   version: '0'
   source:
     type: stdlib
+- name: lint_roller
+  version: '1.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
 - name: listen
   version: '3.9'
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: logger
@@ -214,7 +222,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: marcel
@@ -222,7 +230,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: mini_mime
@@ -230,7 +238,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: minitest
@@ -238,7 +246,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: monitor
@@ -249,6 +257,14 @@ gems:
   version: 0.3.0
   source:
     type: rubygems
+- name: mysql2
+  version: '0.5'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
 - name: net-protocol
   version: '0'
   source:
@@ -258,7 +274,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: nokogiri
@@ -266,7 +282,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: openssl
@@ -282,7 +298,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: parser
@@ -290,13 +306,9 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
-- name: pathname
-  version: '0'
-  source:
-    type: stdlib
 - name: pp
   version: '0'
   source:
@@ -306,15 +318,23 @@ gems:
   source:
     type: stdlib
 - name: prism
-  version: 1.4.0
+  version: 1.8.0
   source:
     type: rubygems
+- name: pstore
+  version: '0'
+  source:
+    type: stdlib
+- name: psych
+  version: '0'
+  source:
+    type: stdlib
 - name: rack
   version: '2.2'
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: rails-dom-testing
@@ -322,7 +342,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: rails-html-sanitizer
@@ -330,7 +350,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: railties
@@ -338,7 +358,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: rainbow
@@ -346,7 +366,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: rake
@@ -354,11 +374,11 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: rbs
-  version: 3.9.4
+  version: 3.10.2
   source:
     type: rubygems
 - name: rdoc
@@ -370,29 +390,33 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
-- name: repl_type_completor
-  version: 0.1.11
+- name: ripper
+  version: '0'
   source:
-    type: rubygems
+    type: stdlib
 - name: rubocop
   version: '1.57'
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: rubocop-ast
-  version: '1.30'
+  version: '1.46'
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
+- name: rubocop-sorted_methods_by_call
+  version: 1.2.3
+  source:
+    type: rubygems
 - name: securerandom
   version: '0'
   source:
@@ -422,7 +446,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: time
@@ -442,11 +466,19 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: a9830177c3fdbebb92f6db6a166ae3e368818162
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: uri
   version: '0'
   source:
     type: stdlib
+- name: yard
+  version: '0.9'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: d07edeb13c53de1c65b2bede98a720ac52d497a2
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
 gemfile_lock_path: Gemfile.lock

data/sig/compat/active_record_base_compat.rbs

@@ -0,0 +1,17 @@
+module ActiveRecord
+  class Base
+    def self.connection_handler: () -> ::ActiveRecord::ConnectionAdapters::ConnectionHandler
+
+    def self.clear_active_connections!: () -> void
+
+    def self.configurations: () -> ::ActiveRecord::DatabaseConfigurations
+  end
+
+  class DatabaseConfigurations::DatabaseConfig
+    def name: () -> ::String
+
+    def env_name: () -> ::String
+
+    def configuration_hash: () -> ::Hash[::Symbol | ::String, ::String | ::Integer | bool | nil]
+  end
+end

data/sig/compat/thor_dsl.rbs

@@ -0,0 +1,8 @@
+class Thor
+  # Thor DSL methods used by ARFI
+  def self.subcommand: (::String name, ::Class klass) -> void
+
+  def self.default_task: (::Symbol name) -> void
+
+  def self.map: (::Hash[::String | ::Array[::String], ::Symbol] mapping) -> void
+end

data/sig/lib/arfi/commands/f_idx.rbs

@@ -1,107 +1,9 @@
 module Arfi
   module Commands
-    class FIdx < Thor
-      ADAPTERS: Array[Symbol]
-
-      # +Arfi::Commands::FIdx#create+                        -> void
-      #
-      # This command is used to create the functional index.
-      #
-      # @example
-      #   bundle exec arfi f_idx create some_function
-      # @param index_name [String] Name of the index.
-      # @return [void]
-      # @raise [Arfi::Errors::InvalidSchemaFormat] if ActiveRecord.schema_format is not :ruby
-      # @raise [Arfi::Errors::NoFunctionsDir] if there is no `db/functions` directory
-      # @see Arfi::Commands::FIdx#validate_schema_format!
-      def create: (string index_name) -> untyped
-
-      # +Arfi::Commands::FIdx#destroy+                        -> void
-      #
-      # This command is used to delete the functional index.
-      #
-      # @example
-      #   bundle exec arfi f_idx destroy some_function [revision index (just an integer, 1 is by default)]
-      # @param index_name [String] Name of the index.
-      # @return [void]
-      # @raise [Arfi::Errors::InvalidSchemaFormat] if ActiveRecord.schema_format is not :ruby
-      def destroy: (string index_name) -> untyped
-
-      private
-
-      # +Arfi::Commands::FIdx#build_from_file+                          -> String
-      #
-      # Helper method to build the SQL function. Used with flag `--template`.
-      #
-      # @!visibility private
-      # @private
-      # @param index_name [String] Name of the index.
-      # @return [String] SQL function body.
-      # @see Arfi::Commands::FIdx#create
-      # @see Arfi::Commands::FIdx#build_sql_function
-      def build_from_file: (string index_name) -> String
-
-      # +Arfi::Commands::FIdx#functions_dir+                        -> Pathname
-      #
-      # Helper method to get path to `db/functions` directory.
-      #
-      # @!visibility private
-      # @private
-      # @return [Pathname] Path to `db/functions` directory
-      def functions_dir: () -> Pathname
-
-      # +Arfi::Commands::FIdx#validate_schema_format!+                        -> void
-      #
-      # Helper method to validate the schema format.
-      #
-      # @!visibility private
-      # @private
-      # @raise [Arfi::Errors::InvalidSchemaFormat] if ActiveRecord.schema_format is not :ruby.
-      # @return [nil] if the schema format is valid.
-      def validate_schema_format!: () -> (untyped | nil)
-
-      # +Arfi::Commands::FIdx#build_sql_function+                        -> String
-      #
-      # Helper method to build the SQL function.
-      #
-      # @!visibility private
-      # @private
-      # @param index_name [String] Name of the index.
-      # @return [String] SQL function body.
-      def build_sql_function: (string index_name) -> ::String
-
-      # +Arfi::Commands::FIdx#create_function_file+                        -> void
-      #
-      # Helper method to create the index file.
-      #
-      # @!visibility private
-      # @private
-      # @param index_name [String] Name of the index.
-      # @param content [String] SQL function body.
-      # @return [void]
-      def create_function_file: (string index_name, ::String content) -> untyped
-
-      # +Arfi::Commands::FIdx#extract_latest_version+                        -> String
-      #
-      # Helper method to extract the latest version of the index.
-      #
-      # @!visibility private
-      # @private
-      # @param files [Array<String>] List of files.
-      # @return [String] Latest version of the index.
-      def extract_latest_version: (Array[String] files) -> String
-
-      # +Arfi::Commands::FIdx#write_file+                        -> void
-      #
-      # Helper method to write the index file.
-      #
-      # @!visibility private
-      # @private
-      # @param index_name [String] Name of the index.
-      # @param content [String] SQL function body.
-      # @param version [String|Integer] Version of the index.
-      # @return [void]
-      def write_file: (string index_name, ::String content, (::String | ::Integer) version) -> void
-    end
+    # +Arfi::Commands::FIdx+ module contains commands for manipulating functional index in Rails project.
+    #
+    # Backward-compatible constant for code that references Arfi::Commands::FIdx.
+    # @deprecated
+    FIdx: untyped
   end
 end

data/sig/lib/arfi/commands/functions.rbs

@@ -0,0 +1,99 @@
+module Arfi
+  module Commands
+    ADAPTERS: ::Array[:postgresql | :mysql | :trilogy]
+
+    ROOT_DIR: "db/functions"
+
+    DEFAULT_SCHEMA: "public"
+
+    IDENT: ::Regexp
+
+    type candidate = {
+      key: String,
+      schema: String,
+      function: String,
+      source: String,
+      origin: String,
+      priority: Integer,
+      path: String
+    }
+
+    type resolved_row = {
+      key: String,
+      schema: String,
+      function: String,
+      source: String,
+      origin: String,
+      priority: Integer,
+      path: String,
+      ?chosen: bool,
+      ?shadowed: Array[String],
+      ?shadowed_by: String?
+    }
+
+    class Functions < Thor
+      # steep:ignore:end
+      def create: (String function_ref) -> void
+
+      # steep:ignore:end
+      def destroy: (String function_ref) -> void
+
+      # steep:ignore:end
+      def list: () -> void
+
+      private
+
+      def validate_schema_format!: () -> void
+
+      def validate_adapter_option!: () -> void
+
+      def parse_function_ref: (String ref) -> [String?, String]
+
+      def schema_opt: () -> String?
+
+      def validate_identifiers!: (String? schema, String function_name) -> void
+
+      def ensure_dirs!: (adapter: String?, schema: String?) -> void
+
+      def build_sql_function: (String? schema, String function_name, original_ref: String) -> String
+
+      def build_from_file: (String? schema, String function_name, original_ref: String) -> String
+
+      def write_file: (String? schema, String function_name, String content) -> void
+
+      def canonical_path: (String? schema, String function_name) -> String
+
+      def function_paths: (String? schema, String function_name) -> Array[String]
+
+      def adapter_opt: () -> String?
+
+      def infer_adapter_from_config: () -> String?
+
+      def resolve_functions_for: (adapter: String) -> Array[::Hash[Symbol, untyped]]
+
+      def collect_candidates: (glob: ::Pathname, schema: String, source: String, origin: String, priority: Integer) -> Array[candidate]
+
+      def print_table: (Array[resolved_row] rows) -> void
+
+      def rel: (::Pathname | String path) -> String
+
+      def remove_function_file: (String? schema, String function_name) -> void
+
+      def resolve_adapter: () -> String
+
+      def render_list: (Array[::Hash[Symbol, untyped]] rows) -> void
+
+      def resolve_key_group: (Array[candidate] arr) -> Array[::Hash[Symbol, untyped]]
+
+      def resolve_schema_name: (String? schema) -> String?
+
+      def collect_all_candidates: (::Pathname root, String adapter) -> Array[candidate]
+
+      def group_candidates_by_key: (Array[candidate] candidates) -> ::Hash[String, Array[candidate]]
+
+      def build_resolved_rows: (::Hash[String, Array[candidate]] by_key) -> Array[::Hash[Symbol, untyped]]
+
+      def validate_function_ref!: (String ref) -> void
+    end
+  end
+end