module ROXML
  HASH_KEYS = [:attrs, :key, :value].freeze
  TYPE_KEYS = [:attr, :text, :hash, :content].freeze

  class HashDesc # :nodoc:
    attr_reader :key, :value, :wrapper

    def initialize(opts, wrapper)
      unless (invalid_keys = opts.keys - HASH_KEYS).empty?
        raise ArgumentError, "Invalid Hash description keys: #{invalid_keys.join(', ')}"
      end

      @wrapper = wrapper
      if opts.has_key? :attrs
        @key   = to_hash_args(opts, :attr, opts[:attrs][0])
        @value = to_hash_args(opts, :attr, opts[:attrs][1])
      else
        @key = to_hash_args opts, *fetch_element(opts, :key)
        @value = to_hash_args opts, *fetch_element(opts, :value)
      end
    end

  private
    def fetch_element(opts, what)
      case opts[what]
      when Hash
        raise ArgumentError, "Hash #{what} is over-specified: #{opts[what].inspect}" unless opts[what].keys.one?
        type = opts[what].keys.first
        [type, opts[what][type]]
      when :content
        [:content, opts[:name]]
      when :name
        [:name, '*']
      when String
        [:text, opts[what]]
      when Symbol
        [:text, opts[what]]
      else
        raise ArgumentError, "unrecognized hash parameter: #{what} => #{opts[what]}"
      end
    end

    def to_hash_args(args, type, name)
      args = [args] unless args.is_a? Array

      if args.one? && !(args.first.keys & HASH_KEYS).empty?
        opts = {type => name}
        if type == :content
          opts[:type] = :text
          (opts[:as] ||= []) << :content
        end
        Opts.new(name, opts)
      else
        opts = args.extract_options!
        raise opts.inspect
      end
    end
  end

  class Opts # :nodoc:
    attr_reader :name, :type, :hash, :blocks, :accessor, :to_xml

    class << self
      def silence_xml_name_warning?
        @silence_xml_name_warning || (ROXML.const_defined?('SILENCE_XML_NAME_WARNING') && ROXML::SILENCE_XML_NAME_WARNING)
      end

      def silence_xml_name_warning!
        @silence_xml_name_warning = true
      end
    end

    def initialize(sym, *args, &block)
      @accessor = sym
      @opts = extract_options!(args)
      @default = @opts.delete(:else)
      @to_xml = @opts.delete(:to_xml)

      if @opts.has_key?(:readonly)
        raise ArgumentError, "There is no 'readonly' option. You probably mean to use :frozen => true"
      end

      @opts.reverse_merge!(:as => [], :in => nil)
      @opts[:as] = [*@opts[:as]]

      @type = extract_type(args)
      @opts[:as] << :bool if @accessor.to_s.ends_with?('?')

      if @type.try(:xml_name_without_deprecation?)
        unless self.class.silence_xml_name_warning?
          warn "WARNING: As of 2.3, a breaking change has been in the naming of sub-objects. " +
               "ROXML now considers the xml_name of the sub-object before falling back to the accessor name of the parent. " +
               "Use :from on the parent declaration to override this behavior. Set ROXML::SILENCE_XML_NAME_WARNING to avoid this message."
          self.class.silence_xml_name_warning!
        end
        @opts[:from] ||= @type.tag_name
      else
        @opts[:from] ||= variable_name
      end

      @blocks = collect_blocks(block, @opts[:as])

      @name = @opts[:from].to_s
      @name = @name.singularize if hash? || array?
      if hash? && (hash.key.name? || hash.value.name?)
        @name = '*'
      end

      raise ArgumentError, "Can't specify both :else default and :required" if required? && @default
    end

    def variable_name
      accessor.to_s.ends_with?('?') ? accessor.to_s.chomp('?') : accessor.to_s
    end

    def hash
      @hash ||= HashDesc.new(@opts.delete(:hash), name) if hash?
    end

    def hash?
      @type == :hash
    end

    def name?
      @name == '*'
    end

    def content?
      @type == :content
    end

    def array?
      @opts[:as].include? :array
    end

    def cdata?
      @opts[:as].include? :cdata
    end

    def wrapper
      @opts[:in]
    end

    def required?
      @opts[:required]
    end

    def freeze?
      @opts[:frozen]
    end

    def default
      @default ||= [] if array?
      @default ||= {} if hash?
      @default.duplicable? ? @default.dup : @default
    end

    def to_ref(inst)
      case type
      when :attr    then XMLAttributeRef
      when :content then XMLTextRef
      when :text    then XMLTextRef
      when :hash    then XMLHashRef
      when Symbol   then raise ArgumentError, "Invalid type argument #{opts.type}"
      else               XMLObjectRef
      end.new(self, inst)
    end

  private
    BLOCK_TO_FLOAT = lambda do |val|
      if val.is_a? Array
        val.collect do |v|
          Float(v)
        end
      else
        Float(val)
      end
    end

    BLOCK_TO_INT = lambda do |val|
      if val.is_a? Array
        val.collect do |v|
          Integer(v)
        end
      else
        Integer(val)
      end
    end

    TRUE_VALS = %w{TRUE True true 1}
    FALSE_VALS = %w{FALSE False false 0}

    BLOCK_SHORTHANDS = {
      :integer => BLOCK_TO_INT,
      Integer  => BLOCK_TO_INT,
      :float   => BLOCK_TO_FLOAT,
      Float    => BLOCK_TO_FLOAT,
      :bool    => nil,
      :bool_standalone => lambda do |val|
        if TRUE_VALS.include? val
          true
        elsif FALSE_VALS.include? val
          false
        else
          nil
        end
      end,

      :bool_combined => lambda do |val|
        if TRUE_VALS.include? val
          true
        elsif FALSE_VALS.include? val
          false
        else
          val
        end
      end
    }

    def collect_blocks(block, as)
      shorthands = as & BLOCK_SHORTHANDS.keys
      if shorthands.size > 1
        raise ArgumentError, "multiple block shorthands supplied #{shorthands.map(&:to_s).join(', ')}"
      end

      shorthand = shorthands.first
      if shorthand == :bool
        # if a second block is present, and we can't coerce the xml value
        # to bool, we need to be able to pass it to the user-provided block
        shorthand = block ? :bool_combined : :bool_standalone
      end
      [BLOCK_SHORTHANDS[shorthand], block].compact
    end

    def extract_options!(args)
      opts = args.extract_options!
      unless (opts.keys & HASH_KEYS).empty?
        args.push(opts)
        opts = {}
      end
      opts
    end

    def extract_type(args)
      types = (@opts.keys & TYPE_KEYS)
      # type arg
      if args.one? && types.empty?
        type = args.first
        if type.is_a? Array
          @opts[:as] << :array
          return type.first
        elsif type.is_a? Hash
          @opts[:hash] = type
          return :hash
        else
          return type
        end
      end

      unless args.empty?
        raise ArgumentError, "too many arguments (#{(args + types).join(', ')}).  Should be name, type, and " +
                             "an options hash, with the type and options optional"
      end

      # type options
      if types.one?
        @opts[:from] = @opts.delete(types.first)
        types.first
      elsif types.empty?
        :text
      else
        raise ArgumentError, "more than one type option specified: #{types.join(', ')}"
      end
    end
  end
end