blacklight 8.11.0 → 9.0.0.beta2

data/app/components/blacklight/document_component.rb

@@ -22,9 +22,6 @@ module Blacklight
   class DocumentComponent < Blacklight::Component
     with_collection_parameter :document
 
-    # ViewComponent 3 changes iteration counters to begin at 0 rather than 1
-    COLLECTION_INDEX_OFFSET = ViewComponent::VERSION::MAJOR < 3 ? 0 : 1
-
     # Content appearing before the document
     renders_one :header
 
@@ -37,26 +34,26 @@ module Blacklight
 
     # The document title with some reasonable default behavior
     renders_one :title, (lambda do |*args, component: nil, **kwargs|
-      component ||= @presenter&.view_config&.title_component || Blacklight::DocumentTitleComponent
+      component ||= view_config.title_component || Blacklight::DocumentTitleComponent
 
-      component.new(*args, counter: @counter, document: @document, presenter: @presenter, as: @title_component, actions: !@show, link_to_document: !@show, document_component: self, **kwargs)
+      component.new(*args, counter: @counter, presenter: @presenter, as: @title_component, actions: !@show, link_to_document: !@show, document_component: self, **kwargs)
     end)
 
     renders_one :embed, (lambda do |static_content = nil, *args, component: nil, **kwargs|
       next static_content if static_content.present?
 
-      component ||= @presenter.view_config&.embed_component
+      component ||= view_config.embed_component
 
       next unless component
 
-      component.new(*args, document: @document, presenter: @presenter, document_counter: @document_counter, **kwargs)
+      component.new(*args, presenter: @presenter, document_counter: @document_counter, **kwargs)
     end)
 
     # The primary metadata section
     renders_one :metadata, (lambda do |static_content = nil, *args, component: nil, fields: nil, **kwargs|
       next static_content if static_content.present?
 
-      component ||= @presenter&.view_config&.metadata_component || Blacklight::DocumentMetadataComponent
+      component ||= view_config.metadata_component || Blacklight::DocumentMetadataComponent
 
       component.new(*args, fields: fields || @presenter&.field_presenters || [], **kwargs)
     end)
@@ -67,9 +64,9 @@ module Blacklight
     renders_one :thumbnail, (lambda do |image_options_or_static_content = {}, *args, component: nil, **kwargs|
       next image_options_or_static_content if image_options_or_static_content.is_a? String
 
-      component ||= @presenter&.view_config&.thumbnail_component || Blacklight::Document::ThumbnailComponent
+      component ||= view_config.thumbnail_component || Blacklight::Document::ThumbnailComponent
 
-      component.new(*args, document: @document, presenter: @presenter, counter: @counter, image_options: image_options_or_static_content, **kwargs)
+      component.new(*args, presenter: @presenter, counter: @counter, image_options: image_options_or_static_content, **kwargs)
     end)
 
     # A container for partials rendered using the view config partials configuration. Its use is discouraged, but necessary until
@@ -81,7 +78,6 @@ module Blacklight
 
     # rubocop:disable Metrics/ParameterLists
     # @param document [Blacklight::DocumentPresenter]
-    # @param presenter [Blacklight::DocumentPresenter] alias for document
     # @param partials [Array, nil] view partial names that should be used to provide content for the `partials` slot
     # @param id [String] HTML id for the root element
     # @param classes [Array, String] additional HTML classes for the root element
@@ -91,13 +87,11 @@ module Blacklight
     # @param document_counter [Number, nil] provided by ViewComponent collection iteration
     # @param counter_offset [Number] the offset of the start of the collection counter parameter for the component to the overall result set
     # @param show [Boolean] are we showing only a single document (vs a list of search results); used for backwards-compatibility
-    def initialize(document: nil, presenter: nil, partials: nil,
+    def initialize(document: nil, partials: nil,
                    id: nil, classes: [], component: :article, title_component: nil,
                    counter: nil, document_counter: nil, counter_offset: 0,
                    show: false, **args)
-      Blacklight.deprecation.warn('the `presenter` argument to DocumentComponent#initialize is deprecated; pass the `presenter` in as document instead') if presenter
-
-      @presenter = presenter || document || args[self.class.collection_parameter]
+      @presenter = document || args[self.class.collection_parameter]
       @document = @presenter.document
       @view_partials = partials || []
 
@@ -108,7 +102,7 @@ module Blacklight
 
       @counter = counter
       @document_counter = document_counter || args.fetch(self.class.collection_counter_parameter, nil)
-      @counter ||= @document_counter + COLLECTION_INDEX_OFFSET + counter_offset if @document_counter.present?
+      @counter ||= 1 + @document_counter + counter_offset if @document_counter.present?
 
       @show = show
     end
@@ -139,6 +133,8 @@ module Blacklight
 
     private
 
+    delegate :view_config, to: :@presenter
+
     attr_reader :document_counter, :presenter, :view_partials
 
     def show?

data/app/components/blacklight/document_title_component.rb

@@ -7,11 +7,9 @@ module Blacklight
     renders_many :actions
 
     # rubocop:disable Metrics/ParameterLists
-    def initialize(title = nil, document: nil, presenter: nil, as: :h3, counter: nil, classes: 'index_title document-title-heading col', link_to_document: true, document_component: nil, actions: true)
-      raise ArgumentError, 'missing keyword: :document or :presenter' if presenter.nil? && document.nil?
-
+    def initialize(title = nil, presenter:, as: :h3, counter: nil, classes: 'index_title document-title-heading col h5', link_to_document: true, document_component: nil,
+                   actions: true)
       @title = title
-      @document = document
       @presenter = presenter
       @as = as || :h3
       @counter = counter
@@ -22,6 +20,8 @@ module Blacklight
     end
     # rubocop:enable Metrics/ParameterLists
 
+    attr_accessor :presenter
+
     # Content for the document title area; should be an inline element
     def title
       if @link_to_document
@@ -42,7 +42,7 @@ module Blacklight
 
       (@has_actions_slot && get_slot(:actions)) ||
         ([@document_component&.actions] if @document_component&.actions.present?) ||
-        [helpers.render_index_doc_actions(presenter.document, wrapping_class: 'index-document-functions col-sm-3 col-lg-2')]
+        [helpers.render_index_doc_actions(presenter.document, wrapping_class: 'index-document-functions col-sm-3 col-lg-2 mb-4 mb-sm-0')]
     end
 
     def counter
@@ -52,11 +52,5 @@ module Blacklight
         t('blacklight.search.documents.counter', counter: @counter)
       end
     end
-
-    private
-
-    def presenter
-      @presenter ||= helpers.document_presenter(@document)
-    end
   end
 end

data/app/components/blacklight/facet_field_checkboxes_component.rb

@@ -1,24 +1,6 @@
 # frozen_string_literal: true
 
 module Blacklight
-  class FacetFieldCheckboxesComponent < Blacklight::Component
-    def initialize(facet_field:, layout: nil)
-      @facet_field = facet_field
-      @layout = layout == false ? FacetFieldNoLayoutComponent : Blacklight::FacetFieldComponent
-    end
-
-    def render?
-      presenters.any?
-    end
-
-    def presenters
-      return [] unless @facet_field.paginator
-
-      return to_enum(:presenters) unless block_given?
-
-      @facet_field.paginator.items.each do |item|
-        yield Blacklight::FacetCheckboxItemPresenter.new(item, @facet_field.facet_field, helpers, @facet_field.key, @facet_field.search_state)
-      end
-    end
-  end
+  class FacetFieldCheckboxesComponent < Facets::CheckboxesComponent; end
+  FacetFieldCheckboxesComponent = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("FacetFieldCheckboxesComponent", "Blacklight::Facets::CheckboxesComponent", ActiveSupport::Deprecation.new)
 end

data/app/components/blacklight/facet_field_component.rb

@@ -1,21 +1,6 @@
 # frozen_string_literal: true
 
 module Blacklight
-  class FacetFieldComponent < Blacklight::Component
-    renders_one :label
-    renders_one :body
-
-    # @param [Blacklight::FacetFieldPresenter] facet_field
-    def initialize(facet_field:)
-      @facet_field = facet_field
-    end
-
-    def html_id
-      "facet-#{@facet_field.key.parameterize}"
-    end
-
-    def header_html_id
-      "#{html_id}-header"
-    end
-  end
+  class FacetFieldComponent < Facets::FieldComponent; end
+  FacetFieldComponent = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("FacetFieldComponent", "Blacklight::Facets::FieldComponent", ActiveSupport::Deprecation.new)
 end

data/app/components/blacklight/facet_field_filter_component.rb

@@ -1,25 +1,6 @@
 # frozen_string_literal: true
 
 module Blacklight
-  class FacetFieldFilterComponent < Blacklight::Component
-    def initialize(facet_field:)
-      @facet_field = facet_field
-    end
-
-    def render?
-      @facet_field.facet_field.index_range.any?
-    end
-
-    def prefix
-      @facet_field.paginator.prefix
-    end
-
-    def clear_facet_prefix_url
-      @facet_field.paginator.params_for_resort_url('index', @facet_field.search_state.to_h.except(@facet_field.paginator.request_keys[:prefix]))
-    end
-
-    def facet_prefix_url(letter)
-      @facet_field.paginator.params_for_resort_url('index', @facet_field.search_state.to_h.merge(@facet_field.paginator.request_keys[:prefix] => letter))
-    end
-  end
+  class FacetFieldFilterComponent < Facets::IndexNavigationComponent; end
+  FacetFieldFilterComponent = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("FacetFieldFilterComponent", "Blacklight::Facets::IndexNavigationComponent", ActiveSupport::Deprecation.new)
 end

data/app/components/blacklight/facet_field_inclusive_constraint_component.rb

@@ -1,29 +1,8 @@
 # frozen_string_literal: true
 
 module Blacklight
-  class FacetFieldInclusiveConstraintComponent < Blacklight::Component
-    with_collection_parameter :facet_field
-
-    def initialize(facet_field:, values: nil)
-      @facet_field = facet_field
-      @values = values
-    end
-
-    def values
-      @values ||= @facet_field.values.find { |v| v.is_a? Array }
-      @values || []
-    end
-
-    def render?
-      values.present?
-    end
-
-    def presenters
-      return to_enum(:presenters) unless block_given?
-
-      values.each do |item|
-        yield Blacklight::FacetGroupedItemPresenter.new(values, item, @facet_field.facet_field, helpers, @facet_field.key, @facet_field.search_state)
-      end
-    end
-  end
+  class FacetFieldInclusiveConstraintComponent < Facets::InclusiveConstraintComponent; end
+  FacetFieldInclusiveConstraintComponent = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("FacetFieldInclusiveConstraintComponent",
+                                                                                                   "Blacklight::Facets::InclusiveConstraintComponent",
+                                                                                                   ActiveSupport::Deprecation.new)
 end

data/app/components/blacklight/facet_field_list_component.rb

@@ -1,54 +1,6 @@
 # frozen_string_literal: true
 
 module Blacklight
-  class FacetFieldListComponent < Blacklight::Component
-    def initialize(facet_field:, layout: nil)
-      @facet_field = facet_field
-      @layout = layout == false ? FacetFieldNoLayoutComponent : Blacklight::FacetFieldComponent
-    end
-
-    ##
-    # Renders the list of values
-    # removes any elements where render_facet_item returns a nil value. This enables an application
-    # to filter undesireable facet items so they don't appear in the UI
-    # @deprecated
-    def render_facet_limit_list(paginator, facet_field, wrapping_element = :li)
-      return render(facet_items(wrapping_element: wrapping_element)) if paginator == @facet_field.paginator && facet_field == @facet_field.key
-
-      facet_config ||= helpers.facet_configuration_for_field(facet_field)
-
-      collection = paginator.items.map do |item|
-        facet_item_presenter(item, facet_config, facet_field)
-      end
-
-      render(facet_item_component_class(facet_config).with_collection(collection, wrapping_element: wrapping_element))
-    end
-    Blacklight.deprecation.deprecate_methods(self, render_facet_limit_list: 'Call e.g. `render facet_items` instead')
-
-    def facet_items(wrapping_element: :li, **item_args)
-      facet_item_component_class.with_collection(facet_item_presenters, wrapping_element: wrapping_element, **item_args)
-    end
-
-    def facet_item_presenters
-      @facet_field.paginator.items.map do |item|
-        facet_item_presenter(item)
-      end
-    end
-
-    def render?
-      @facet_field.paginator&.items&.any?
-    end
-
-    def facet_item_presenter(facet_item, deprecated_facet_config = nil, facet_field = nil)
-      (deprecated_facet_config || facet_config).item_presenter.new(facet_item, deprecated_facet_config || facet_config, helpers, facet_field || @facet_field.key)
-    end
-
-    def facet_item_component_class(deprecated_facet_config = nil)
-      (deprecated_facet_config || facet_config).item_component
-    end
-
-    def facet_config
-      @facet_field.facet_field
-    end
-  end
+  class FacetFieldListComponent < Facets::ListComponent; end
+  FacetFieldListComponent = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("FacetFieldListComponent", "Blacklight::Facets::ListComponent", ActiveSupport::Deprecation.new)
 end

data/app/components/blacklight/facet_field_no_layout_component.rb

@@ -1,14 +1,6 @@
 # frozen_string_literal: true
 
 module Blacklight
-  class FacetFieldNoLayoutComponent < Blacklight::Component
-    renders_one :label
-    renders_one :body
-
-    def initialize(**); end
-
-    def call
-      body.to_s
-    end
-  end
+  class FacetFieldNoLayoutComponent < Facets::NoLayoutComponent; end
+  FacetFieldNoLayoutComponent = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("FacetFieldNoLayoutComponent", "Blacklight::Facets::NoLayoutComponent", ActiveSupport::Deprecation.new)
 end

data/app/components/blacklight/facet_item_component.rb

@@ -1,78 +1,6 @@
 # frozen_string_literal: true
 
 module Blacklight
-  class FacetItemComponent < Blacklight::Component
-    attr_reader :label, :href, :hits
-
-    with_collection_parameter :facet_item
-
-    def initialize(facet_item:, wrapping_element: 'li', suppress_link: false)
-      @facet_item = facet_item
-      @label = facet_item.label
-      @hits = facet_item.hits
-      @href = facet_item.href
-      @selected = facet_item.selected?
-      @wrapping_element = wrapping_element
-      @suppress_link = suppress_link
-    end
-
-    def call
-      # if the downstream app has overridden the helper methods we'd usually call,
-      # use the helpers to preserve compatibility
-      content = if @selected
-                  render_selected_facet_value
-                else
-                  render_facet_value
-                end
-
-      return '' if content.blank?
-      return content unless @wrapping_element
-
-      content_tag @wrapping_element, content
-    end
-
-    ##
-    # Standard display of a facet value in a list. Used in both _facets sidebar
-    # partial and catalog/facet expanded list. Will output facet value name as
-    # a link to add that to your restrictions, with count in parens.
-    #
-    # @return [String]
-    # @private
-    def render_facet_value
-      tag.span(class: "facet-label") do
-        link_to_unless(@suppress_link, label, href, class: "facet-select", rel: "nofollow")
-      end + render_facet_count
-    end
-
-    ##
-    # Standard display of a SELECTED facet value (e.g. without a link and with a remove button)
-    # @see #render_facet_value
-    #
-    # @private
-    def render_selected_facet_value
-      tag.span(class: "facet-label") do
-        tag.span(label, class: "selected") +
-          # remove link
-          link_to(href, class: "remove", rel: "nofollow") do
-            render(Blacklight::Icons::RemoveComponent.new) +
-              tag.span(helpers.t(:'blacklight.search.facets.selected.remove'), class: 'sr-only visually-hidden')
-          end
-      end + render_facet_count(classes: ["selected"])
-    end
-
-    ##
-    # Renders a count value for facet limits. Can be over-ridden locally
-    # to change style. And can be called by plugins to get consistent display.
-    #
-    # @param [Hash] options
-    # @option options [Array<String>]  an array of classes to add to count span.
-    # @return [String]
-    # @private
-    def render_facet_count(options = {})
-      return '' if hits.blank?
-
-      classes = (options[:classes] || []) << "facet-count"
-      tag.span(t('blacklight.search.facets.count', number: number_with_delimiter(hits)), class: classes)
-    end
-  end
+  class FacetItemComponent < Facets::ItemComponent; end
+  FacetItemComponent = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("FacetItemComponent", "Blacklight::Facets::ItemComponent", ActiveSupport::Deprecation.new)
 end

data/app/components/blacklight/facet_item_pivot_component.rb

@@ -28,11 +28,11 @@ module Blacklight
     end
 
     def call
-      facet = Blacklight::FacetItemComponent.new(facet_item: @facet_item, wrapping_element: nil, suppress_link: @suppress_link)
+      facet = Blacklight::Facets::ItemComponent.new(facet_item: @facet_item, wrapping_element: nil, suppress_link: @suppress_link)
 
       id = "h-#{self.class.mint_id}" if @collapsing && has_items?
 
-      content_tag @wrapping_element, role: 'treeitem', class: 'treeitem' do
+      content_tag @wrapping_element, class: 'treeitem' do
         concat(content_tag('span', class: "d-flex flex-row align-items-center") do
           concat facet_toggle_button(id) if has_items? && @collapsing
           concat content_tag('span', render(facet), class: "facet-values d-flex flex-row flex-grow-1 #{'facet-leaf-node' if has_items? && @collapsing}", id: id && "#{id}_label")
@@ -75,7 +75,7 @@ module Blacklight
     def toggle_icon(type)
       content_tag 'span', class: type do
         concat @icons[type]
-        concat content_tag('span', t(type, scope: 'blacklight.search.facets.pivot'), class: 'sr-only visually-hidden')
+        concat content_tag('span', t(type, scope: 'blacklight.search.facets.pivot'), class: 'visually-hidden')
       end
     end
   end

data/app/components/blacklight/facets/checkboxes_component.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Blacklight
+  module Facets
+    class CheckboxesComponent < Blacklight::Component
+      def initialize(facet_field:, layout: nil)
+        @facet_field = facet_field
+        @layout = layout == false ? Blacklight::Facets::NoLayoutComponent : Blacklight::Facets::FieldComponent
+      end
+
+      def render?
+        presenters.any?
+      end
+
+      def presenters
+        return [] unless @facet_field.paginator
+
+        return to_enum(:presenters) unless block_given?
+
+        @facet_field.paginator.items.each do |item|
+          yield Blacklight::FacetCheckboxItemPresenter.new(item, @facet_field.facet_field, helpers, @facet_field.key, @facet_field.search_state)
+        end
+      end
+    end
+  end
+end

data/app/components/blacklight/facets/count_component.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Blacklight
+  module Facets
+    # Display count of a facet value
+    class CountComponent < Blacklight::Component
+      def initialize(hits:, classes:)
+        @hits = hits
+        @classes = classes
+      end
+
+      attr_reader :hits, :classes
+
+      def render?
+        hits.present?
+      end
+
+      def call
+        tag.span(t('blacklight.search.facets.count', number: number_with_delimiter(hits)), class: classes)
+      end
+    end
+  end
+end

data/app/components/blacklight/{facet_field_component.html.erb → facets/field_component.html.erb}

@@ -1,8 +1,8 @@
-<div class="card facet-limit blacklight-<%= @facet_field.key %> <%= 'facet-limit-active' if @facet_field.active? %>">
-  <h3 class="card-header p-0 facet-field-heading" id="<%= header_html_id %>">
+<div class="accordion-item facet-limit blacklight-<%= @facet_field.key %> <%= 'facet-limit-active' if @facet_field.active? %>">
+  <h3 class="accordion-header p-0 facet-field-heading h6" id="<%= header_html_id %>">
     <button
       type="button"
-      class="btn w-100 d-block btn-block p-2 text-start text-left collapse-toggle <%= "collapsed" if @facet_field.collapsed? %>"
+      class="btn accordion-button <%= "collapsed" if @facet_field.collapsed? %>"
       data-toggle="collapse"
       data-bs-toggle="collapse"
       data-target="#<%= html_id %>"
@@ -14,7 +14,7 @@
     </button>
   </h3>
   <div id="<%= html_id %>" role="region" aria-labelledby="<%= header_html_id %>" class="panel-collapse facet-content collapse <%= "show" unless @facet_field.collapsed? %>">
-    <div class="card-body">
+    <div class="accordion-body">
       <%= body %>
 
       <% if @facet_field.modal_path %>

data/app/components/blacklight/facets/field_component.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Blacklight
+  module Facets
+    class FieldComponent < Blacklight::Component
+      renders_one :label
+      renders_one :body
+
+      # @param [Blacklight::FacetFieldPresenter] facet_field
+      def initialize(facet_field:)
+        @facet_field = facet_field
+      end
+
+      def html_id
+        "facet-#{@facet_field.key.parameterize}"
+      end
+
+      def header_html_id
+        "#{html_id}-header"
+      end
+    end
+  end
+end

data/app/components/blacklight/facets/filters_component.html.erb

@@ -0,0 +1,4 @@
+  <div class="<%= classes %>">
+    <%= render Blacklight::Facets::SuggestComponent.new(presenter: presenter) %>
+    <%= render Blacklight::Facets::IndexNavigationComponent.new(presenter: presenter) %>
+  </div>

data/app/components/blacklight/facets/filters_component.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Blacklight::Facets
+  class FiltersComponent < Blacklight::Component
+    # @param [Blacklight::FacetFieldPresenter] presenter
+    def initialize(presenter:, classes: 'facet-filters card card-body bg-light p-3 mb-3 border-0')
+      @presenter = presenter
+      @classes = classes
+    end
+
+    def facet
+      @presenter.facet_field
+    end
+
+    attr_reader :classes, :presenter
+
+    delegate :display_facet, to: :presenter
+
+    def render?
+      facet.suggest != false || render_index_navigation?
+    end
+
+    def render_index_navigation?
+      facet.index_range && display_facet.index?
+    end
+  end
+end

data/app/components/blacklight/{facet_field_inclusive_constraint_component.html.erb → facets/inclusive_constraint_component.html.erb}

@@ -1,6 +1,6 @@
 <div class="inclusive_or card card-body bg-light mb-3">
   <h5><%= t('blacklight.advanced_search.any_of') %></h5>
   <ul class="list-unstyled facet-values">
-    <%= render(Blacklight::FacetItemComponent.with_collection(presenters.to_a)) %>
+    <%= render Blacklight::Facets::ItemComponent.with_collection(presenters.to_a) %>
   </ul>
 </div>

data/app/components/blacklight/facets/inclusive_constraint_component.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Blacklight
+  module Facets
+    class InclusiveConstraintComponent < Blacklight::Component
+      with_collection_parameter :facet_field
+
+      def initialize(facet_field:, values: nil)
+        @facet_field = facet_field
+        @values = values
+      end
+
+      def values
+        @values ||= @facet_field.values.find { |v| v.is_a? Array }
+        @values || []
+      end
+
+      def render?
+        values.present?
+      end
+
+      def presenters
+        return to_enum(:presenters) unless block_given?
+
+        values.each do |item|
+          yield Blacklight::FacetGroupedItemPresenter.new(values, item, @facet_field.facet_field, helpers, @facet_field.key, @facet_field.search_state)
+        end
+      end
+    end
+  end
+end

data/app/components/blacklight/{facet_field_filter_component.html.erb → facets/index_navigation_component.html.erb}

@@ -3,7 +3,7 @@
     <li class="page-item <%= 'active' if prefix.blank? %>">
       <%= link_to t('blacklight.search.facets.all'), clear_facet_prefix_url, data: { blacklight_modal: "preserve" }, class: 'page-link' %>
     </li>
-    <% @facet_field.facet_field.index_range.each do |letter| %>
+    <% index_range.each do |letter| %>
       <li class="page-item <%= 'active' if prefix == letter %>">
         <%= link_to(letter, facet_prefix_url(letter), class: 'page-link', data: { blacklight_modal: "preserve" }) %>
       </li>

data/app/components/blacklight/facets/index_navigation_component.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Blacklight
+  module Facets
+    class IndexNavigationComponent < Blacklight::Component
+      # @params [Blacklight::FacetFieldPresenter] presenter
+      def initialize(presenter:)
+        @presenter = presenter
+      end
+
+      def render?
+        index_range && @presenter.display_facet.index?
+      end
+
+      def index_range
+        @presenter.facet_field.index_range
+      end
+
+      def prefix
+        @presenter.paginator.prefix
+      end
+
+      def clear_facet_prefix_url
+        @presenter.paginator.params_for_resort_url('index', @presenter.search_state.to_h.except(@presenter.paginator.request_keys[:prefix]))
+      end
+
+      def facet_prefix_url(letter)
+        @presenter.paginator.params_for_resort_url('index', @presenter.search_state.to_h.merge(@presenter.paginator.request_keys[:prefix] => letter))
+      end
+    end
+  end
+end