neft/scripts/api-wiki/jobs/api-headings.coffee

Universal Platform

'use strict'

PEG = require 'pegjs'
fs = require 'fs-extra'
pathUtils = require 'path'
marked = require 'marked'
{Heading, Paragraph} = require '../markdown'

headingPegPath = pathUtils.join __dirname, './api-headings/syntax.pegjs'
grammar = fs.readFileSync headingPegPath, 'utf-8'
parser = PEG.buildParser grammar,
    optimize: 'speed'

PROPERTY_TYPES =
    __proto__: null
    Signal: true

exports.modifyFile = (file, path) ->
    i = -1
    while ++i < file.length
        type = file[i]

        unless type instanceof Heading
            continue

        text = type.getHeadingText()
        try
            def = parser.parse text
        catch
            continue

        if def.name is text
            continue

        type.syntax = text
        type.setHeadingText def.name

        html = '<dl>'

        syntax = text.replace /\*/gm, '&#x2A;'
        html += '<dt>Syntax</dt>'
        html += "<dd><code>#{syntax}</code></dd>"

        if def.namespace
            if def.parameters and not PROPERTY_TYPES[def.returns]
                html += '<dt>Static method of</dt>'
            else
                html += '<dt>Static property of</dt>'
            html += "<dd><i>#{def.namespace}</i></dd>"

        if def.parent
            if def.parameters
                html += '<dt>Prototype method of</dt>'
            else
                html += '<dt>Prototype property of</dt>'
            html += "<dd><i>#{def.parent}</i></dd>"

        if def.extends
            html += '<dt>Extends</dt>'
            html += "<dd><i>#{def.extends}</i></dd>"

        if def.parameters?.length > 0
            html += '<dt>Parameters</dt>'
            html += '<dd><ul>'
            for param in def.parameters
                html += '<li>'
                html += "#{param.name} — <i>"
                html += param.types.join '</i> or <i>'
                html += '</i>'
                if param.defaults?
                    html += " — <code>= #{param.defaults}</code>"
                if param.optional
                    html += ' — <i>optional</i>'
                html += '</li>'
            html += '</ul></dd>'

        if def.returns
            if def.parameters and not PROPERTY_TYPES[def.returns]
                html += '<dt>Returns</dt>'
            else
                html += '<dt>Type</dt>'
            html += "<dd><i>#{def.returns}</i></dd>"

        if def.default
            html += '<dt>Default</dt>'
            html += "<dd><code>#{def.default}</code></dd>"

        if def.features
            for extra in def.features
                html += "<dt>#{extra}</dt>"

        html += '</dl>'

        htmlType = new Paragraph type.line, html
        file.splice i + 1, 0, htmlType
        i += 1

    return