require 'jsduck/util/html'

module JsDuck
  module Source

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

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

        @docs.map do |docset|
          link(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.
      # Returns the modified doc-object after done.
      def link(docset)
        file = docset[:files].first
        linenr = file[:linenr]
        @links[linenr] = [] unless @links[linenr]
        @links[linenr] << {:doc => docset, :file => file}
        docset
      end

    end

  end
end