module Scrivito
  # Instances of this class represent the result of a faceted search.
  # @api beta
  class ObjFacetValue

    def initialize(value, total, included_objs = [])
      @name = value
      @count = total
      @included_objs = included_objs
    end

    # @api beta
    # The value of the attribute name of this ObjFacetValue.
    #
    # @return [String]
    def name
      @name
    end

    # @api beta
    # Total number of Objs available that have this value.
    #
    # Note that this refers to all Objs,
    # not just the Objs included in this search.
    # Also note that the count is approximate.
    # @return [Integer]
    def count
      @count
    end

    # @api beta
    # The Objs that were included in this search.
    #
    # if you did not specify +include_objs+ in your facet options,
    # an empty array is returned.
    # The Objs are ordered by relevance.
    # @return [Array<BasicObj>]
    def included_objs
      @included_objs
    end
  end
end