require 'jsduck/source/file_parser'
require 'jsduck/util/html'

module JsDuck
  module Source

    # Represents one JavaScript or CSS source file.
    #
    # The filename parameter determines whether it's parsed as
    # JavaScript (the default) or CSS.
    class File
      attr_reader :filename
      attr_reader :contents
      attr_reader :docs
      attr_reader :html_filename

      def initialize(contents, filename="", options={})
        @contents = contents
        @filename = filename
        @html_filename = ""
        @links = {}

        @docs = Source::FileParser.new.parse(@contents, @filename, options)

        @docs.map do |docset|
          link(docset[:linenr], docset)
        end
      end

      # loops through each doc-object in file
      def each(&block)
        @docs.each(&block)
      end

      # Sets the html filename of this file,
      # updating also all doc-objects linking this file
      def html_filename=(html_filename)
        @html_filename = html_filename
        @links.each_value do |line|
          line.each do |link|
            link[:file][:html_filename] = @html_filename
            link[:file][:href] = @html_filename + "#" + id(link[:doc])
          end
        end
      end

      # Returns source code as HTML with lines starting doc-comments specially marked.
      def to_html
        linenr = 0
        lines = []
        # Use #each_line instead of #lines to support Ruby 1.6
        @contents.each_line do |line|
          linenr += 1;
          line = Util::HTML.escape(line)
          # wrap the line in as many spans as there are links to this line number.
          if @links[linenr]
            @links[linenr].each do |link|
              line = "<span id='#{id(link[:doc])}'>#{line}</span>"
            end
          end
          lines << line
        end
        lines.join()
      end

      def id(doc)
        if doc[:tagname] == :class
          doc[:name].gsub(/\./, '-')
        else
          # when creation of global class is skipped,
          # this owner property can be nil.
          (doc[:owner] || "global").gsub(/\./, '-') + "-" + doc[:id]
        end
      end

      private

      # Creates two-way link between sourcefile and doc-object.
      # If doc-object is class, links also the contained cfgs and constructor.
      # Returns the modified doc-object after done.
      def link(linenr, doc)
        @links[linenr] = [] unless @links[linenr]
        file = {
          :filename => @filename,
          :linenr => linenr,
        }
        @links[linenr] << {:doc => doc, :file => file}
        doc[:files] = [file]
        if doc[:tagname] == :class
          doc[:members].each {|m| link(linenr, m) }
        end
        doc
      end

    end

  end
end