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

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

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

    #
    # Total number of Objs available that have this value.
    #
    # @api public
    #
    # 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

    #
    # The Objs that were included in this search.
    #
    # @api public
    #
    # 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