/lenasys/trunk

/* ***** BEGIN LICENSE BLOCK *****

 * Distributed under the BSD license:

 *

 * Copyright (c) 2010, Ajax.org B.V.

 * All rights reserved.

 * 

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions are met:

 *     * Redistributions of source code must retain the above copyright

 *       notice, this list of conditions and the following disclaimer.

 *     * Redistributions in binary form must reproduce the above copyright

 *       notice, this list of conditions and the following disclaimer in the

 *       documentation and/or other materials provided with the distribution.

 *     * Neither the name of Ajax.org B.V. nor the

 *       names of its contributors may be used to endorse or promote products

 *       derived from this software without specific prior written permission.

 * 

 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND

 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

 * DISCLAIMED. IN NO EVENT SHALL AJAX.ORG B.V. BE LIABLE FOR ANY

 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 *

 * ***** END LICENSE BLOCK ***** */

 

define('ace/mode/svg', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/xml', 'ace/mode/javascript', 'ace/tokenizer', 'ace/mode/svg_highlight_rules', 'ace/mode/folding/mixed', 'ace/mode/folding/xml', 'ace/mode/folding/cstyle'], function(require, exports, module) {

 

 

var oop = require("../lib/oop");

var XmlMode = require("./xml").Mode;

var JavaScriptMode = require("./javascript").Mode;

var Tokenizer = require("../tokenizer").Tokenizer;

var SvgHighlightRules = require("./svg_highlight_rules").SvgHighlightRules;

var MixedFoldMode = require("./folding/mixed").FoldMode;

var XmlFoldMode = require("./folding/xml").FoldMode;

var CStyleFoldMode = require("./folding/cstyle").FoldMode;

 

var Mode = function() {

    XmlMode.call(this);

    

    this.highlighter = new SvgHighlightRules();

    this.$tokenizer = new Tokenizer(this.highlighter.getRules());

    

    this.$embeds = this.highlighter.getEmbeds();

    this.createModeDelegates({

        "js-": JavaScriptMode

    });

    

    this.foldingRules = new MixedFoldMode(new XmlFoldMode({}), {

        "js-": new CStyleFoldMode()

    });

};

 

oop.inherits(Mode, XmlMode);

 

(function() {

 

    this.getNextLineIndent = function(state, line, tab) {

        return this.$getIndent(line);

    };

    

 

}).call(Mode.prototype);

 

exports.Mode = Mode;

});

 

define('ace/mode/xml', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/text', 'ace/tokenizer', 'ace/mode/xml_highlight_rules', 'ace/mode/behaviour/xml', 'ace/mode/folding/xml'], function(require, exports, module) {

 

 

var oop = require("../lib/oop");

var TextMode = require("./text").Mode;

var Tokenizer = require("../tokenizer").Tokenizer;

var XmlHighlightRules = require("./xml_highlight_rules").XmlHighlightRules;

var XmlBehaviour = require("./behaviour/xml").XmlBehaviour;

var XmlFoldMode = require("./folding/xml").FoldMode;

 

var Mode = function() {

    this.$tokenizer = new Tokenizer(new XmlHighlightRules().getRules());

    this.$behaviour = new XmlBehaviour();

    this.foldingRules = new XmlFoldMode();

};

 

oop.inherits(Mode, TextMode);

 

(function() {

    

    this.blockComment = {start: "<!--", end: "-->"};

 

}).call(Mode.prototype);

 

exports.Mode = Mode;

});

 

define('ace/mode/xml_highlight_rules', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/xml_util', 'ace/mode/text_highlight_rules'], function(require, exports, module) {

 

 

var oop = require("../lib/oop");

var xmlUtil = require("./xml_util");

var TextHighlightRules = require("./text_highlight_rules").TextHighlightRules;

 

var XmlHighlightRules = function() {

    this.$rules = {

        start : [

            {token : "text", regex : "<\\!\\[CDATA\\[", next : "cdata"},

            {token : "xml-pe", regex : "<\\?.*?\\?>"},

            {token : "comment", regex : "<\\!--", next : "comment"},

            {token : "xml-pe", regex : "<\\!.*?>"},

            {token : "meta.tag", regex : "<\\/?", next : "tag"},

            {token : "text", regex : "\\s+"},

            {

                token : "constant.character.entity", 

                regex : "(?:&#[0-9]+;)|(?:&#x[0-9a-fA-F]+;)|(?:&[a-zA-Z0-9_:\\.-]+;)" 

            }

        ],

        

        cdata : [

            {token : "text", regex : "\\]\\]>", next : "start"},

            {token : "text", regex : "\\s+"},

            {token : "text", regex : "(?:[^\\]]|\\](?!\\]>))+"}

        ],

 

        comment : [

            {token : "comment", regex : ".*?-->", next : "start"},

            {token : "comment", regex : ".+"}

        ]

    };

    

    xmlUtil.tag(this.$rules, "tag", "start");

};

 

oop.inherits(XmlHighlightRules, TextHighlightRules);

 

exports.XmlHighlightRules = XmlHighlightRules;

});

 

define('ace/mode/xml_util', ['require', 'exports', 'module' ], function(require, exports, module) {

 

 

function string(state) {

    return [{

        token : "string",

        regex : '"',

        next : state + "_qqstring"

    }, {

        token : "string",

        regex : "'",

        next : state + "_qstring"

    }];

}

 

function multiLineString(quote, state) {

    return [

        {token : "string", regex : quote, next : state},

        {

            token : "constant.language.escape",

            regex : "(?:&#[0-9]+;)|(?:&#x[0-9a-fA-F]+;)|(?:&[a-zA-Z0-9_:\\.-]+;)" 

        },

        {defaultToken : "string"}

    ];

}

 

exports.tag = function(states, name, nextState, tagMap) {

    states[name] = [{

        token : "text",

        regex : "\\s+"

    }, {

        

    token : !tagMap ? "meta.tag.tag-name" : function(value) {

            if (tagMap[value])

                return "meta.tag.tag-name." + tagMap[value];

            else

                return "meta.tag.tag-name";

        },

        regex : "[-_a-zA-Z0-9:]+",

        next : name + "_embed_attribute_list" 

    }, {

        token: "empty",

        regex: "",

        next : name + "_embed_attribute_list"

    }];

 

    states[name + "_qstring"] = multiLineString("'", name + "_embed_attribute_list");

    states[name + "_qqstring"] = multiLineString("\"", name + "_embed_attribute_list");

    

    states[name + "_embed_attribute_list"] = [{

        token : "meta.tag.r",

        regex : "/?>",

        next : nextState

    }, {

        token : "keyword.operator",

        regex : "="

    }, {

        token : "entity.other.attribute-name",

        regex : "[-_a-zA-Z0-9:]+"

    }, {

        token : "constant.numeric", // float

        regex : "[+-]?\\d+(?:(?:\\.\\d*)?(?:[eE][+-]?\\d+)?)?\\b"

    }, {

        token : "text",

        regex : "\\s+"

    }].concat(string(name));

};

 

});

 

define('ace/mode/behaviour/xml', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/behaviour', 'ace/mode/behaviour/cstyle', 'ace/token_iterator'], function(require, exports, module) {

 

 

var oop = require("../../lib/oop");

var Behaviour = require("../behaviour").Behaviour;

var CstyleBehaviour = require("./cstyle").CstyleBehaviour;

var TokenIterator = require("../../token_iterator").TokenIterator;

 

function hasType(token, type) {

    var hasType = true;

    var typeList = token.type.split('.');

    var needleList = type.split('.');

    needleList.forEach(function(needle){

        if (typeList.indexOf(needle) == -1) {

            hasType = false;

            return false;

        }

    });

    return hasType;

}

 

var XmlBehaviour = function () {

    

    this.inherit(CstyleBehaviour, ["string_dquotes"]); // Get string behaviour

    

    this.add("autoclosing", "insertion", function (state, action, editor, session, text) {

        if (text == '>') {

            var position = editor.getCursorPosition();

            var iterator = new TokenIterator(session, position.row, position.column);

            var token = iterator.getCurrentToken();

            var atCursor = false;

            if (!token || !hasType(token, 'meta.tag') && !(hasType(token, 'text') && token.value.match('/'))){

                do {

                    token = iterator.stepBackward();

                } while (token && (hasType(token, 'string') || hasType(token, 'keyword.operator') || hasType(token, 'entity.attribute-name') || hasType(token, 'text')));

            } else {

                atCursor = true;

            }

            if (!token || !hasType(token, 'meta.tag-name') || iterator.stepBackward().value.match('/')) {

                return

            }

            var tag = token.value;

            if (atCursor){

                var tag = tag.substring(0, position.column - token.start);

            }

 

            return {

               text: '>' + '</' + tag + '>',

               selection: [1, 1]

            }

        }

    });

 

    this.add('autoindent', 'insertion', function (state, action, editor, session, text) {

        if (text == "\n") {

            var cursor = editor.getCursorPosition();

            var line = session.doc.getLine(cursor.row);

            var rightChars = line.substring(cursor.column, cursor.column + 2);

            if (rightChars == '</') {

                var indent = this.$getIndent(session.doc.getLine(cursor.row)) + session.getTabString();

                var next_indent = this.$getIndent(session.doc.getLine(cursor.row));

 

                return {

                    text: '\n' + indent + '\n' + next_indent,

                    selection: [1, indent.length, 1, indent.length]

                }

            }

        }

    });

    

}

oop.inherits(XmlBehaviour, Behaviour);

 

exports.XmlBehaviour = XmlBehaviour;

});

 

define('ace/mode/behaviour/cstyle', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/behaviour', 'ace/token_iterator', 'ace/lib/lang'], function(require, exports, module) {

 

 

var oop = require("../../lib/oop");

var Behaviour = require("../behaviour").Behaviour;

var TokenIterator = require("../../token_iterator").TokenIterator;

var lang = require("../../lib/lang");

 

var SAFE_INSERT_IN_TOKENS =

    ["text", "paren.rparen", "punctuation.operator"];

var SAFE_INSERT_BEFORE_TOKENS =

    ["text", "paren.rparen", "punctuation.operator", "comment"];

 

 

var autoInsertedBrackets = 0;

var autoInsertedRow = -1;

var autoInsertedLineEnd = "";

var maybeInsertedBrackets = 0;

var maybeInsertedRow = -1;

var maybeInsertedLineStart = "";

var maybeInsertedLineEnd = "";

 

var CstyleBehaviour = function () {

    

    CstyleBehaviour.isSaneInsertion = function(editor, session) {

        var cursor = editor.getCursorPosition();

        var iterator = new TokenIterator(session, cursor.row, cursor.column);

        if (!this.$matchTokenType(iterator.getCurrentToken() || "text", SAFE_INSERT_IN_TOKENS)) {

            var iterator2 = new TokenIterator(session, cursor.row, cursor.column + 1);

            if (!this.$matchTokenType(iterator2.getCurrentToken() || "text", SAFE_INSERT_IN_TOKENS))

                return false;

        }

        iterator.stepForward();

        return iterator.getCurrentTokenRow() !== cursor.row ||

            this.$matchTokenType(iterator.getCurrentToken() || "text", SAFE_INSERT_BEFORE_TOKENS);

    };

    

    CstyleBehaviour.$matchTokenType = function(token, types) {

        return types.indexOf(token.type || token) > -1;

    };

    

    CstyleBehaviour.recordAutoInsert = function(editor, session, bracket) {

        var cursor = editor.getCursorPosition();

        var line = session.doc.getLine(cursor.row);

        if (!this.isAutoInsertedClosing(cursor, line, autoInsertedLineEnd[0]))

            autoInsertedBrackets = 0;

        autoInsertedRow = cursor.row;

        autoInsertedLineEnd = bracket + line.substr(cursor.column);

        autoInsertedBrackets++;

    };

    

    CstyleBehaviour.recordMaybeInsert = function(editor, session, bracket) {

        var cursor = editor.getCursorPosition();

        var line = session.doc.getLine(cursor.row);

        if (!this.isMaybeInsertedClosing(cursor, line))

            maybeInsertedBrackets = 0;

        maybeInsertedRow = cursor.row;

        maybeInsertedLineStart = line.substr(0, cursor.column) + bracket;

        maybeInsertedLineEnd = line.substr(cursor.column);

        maybeInsertedBrackets++;

    };

    

    CstyleBehaviour.isAutoInsertedClosing = function(cursor, line, bracket) {

        return autoInsertedBrackets > 0 &&

            cursor.row === autoInsertedRow &&

            bracket === autoInsertedLineEnd[0] &&

            line.substr(cursor.column) === autoInsertedLineEnd;

    };

    

    CstyleBehaviour.isMaybeInsertedClosing = function(cursor, line) {

        return maybeInsertedBrackets > 0 &&

            cursor.row === maybeInsertedRow &&

            line.substr(cursor.column) === maybeInsertedLineEnd &&

            line.substr(0, cursor.column) == maybeInsertedLineStart;

    };

    

    CstyleBehaviour.popAutoInsertedClosing = function() {

        autoInsertedLineEnd = autoInsertedLineEnd.substr(1);

        autoInsertedBrackets--;

    };

    

    CstyleBehaviour.clearMaybeInsertedClosing = function() {

        maybeInsertedBrackets = 0;

        maybeInsertedRow = -1;

    };

 

    this.add("braces", "insertion", function (state, action, editor, session, text) {

        var cursor = editor.getCursorPosition();

        var line = session.doc.getLine(cursor.row);

        if (text == '{') {

            var selection = editor.getSelectionRange();

            var selected = session.doc.getTextRange(selection);

            if (selected !== "" && selected !== "{" && editor.getWrapBehavioursEnabled()) {

                return {

                    text: '{' + selected + '}',

                    selection: false

                };

            } else if (CstyleBehaviour.isSaneInsertion(editor, session)) {

                if (/[\]\}\)]/.test(line[cursor.column])) {

                    CstyleBehaviour.recordAutoInsert(editor, session, "}");

                    return {

                        text: '{}',

                        selection: [1, 1]

                    };

                } else {

                    CstyleBehaviour.recordMaybeInsert(editor, session, "{");

                    return {

                        text: '{',

                        selection: [1, 1]

                    };

                }

            }

        } else if (text == '}') {

            var rightChar = line.substring(cursor.column, cursor.column + 1);

            if (rightChar == '}') {

                var matching = session.$findOpeningBracket('}', {column: cursor.column + 1, row: cursor.row});

                if (matching !== null && CstyleBehaviour.isAutoInsertedClosing(cursor, line, text)) {

                    CstyleBehaviour.popAutoInsertedClosing();

                    return {

                        text: '',

                        selection: [1, 1]

                    };

                }

            }

        } else if (text == "\n" || text == "\r\n") {

            var closing = "";

            if (CstyleBehaviour.isMaybeInsertedClosing(cursor, line)) {

                closing = lang.stringRepeat("}", maybeInsertedBrackets);

                CstyleBehaviour.clearMaybeInsertedClosing();

            }

            var rightChar = line.substring(cursor.column, cursor.column + 1);

            if (rightChar == '}' || closing !== "") {

                var openBracePos = session.findMatchingBracket({row: cursor.row, column: cursor.column}, '}');

                if (!openBracePos)

                     return null;

 

                var indent = this.getNextLineIndent(state, line.substring(0, cursor.column), session.getTabString());

                var next_indent = this.$getIndent(line);

 

                return {

                    text: '\n' + indent + '\n' + next_indent + closing,

                    selection: [1, indent.length, 1, indent.length]

                };

            }

        }

    });

 

    this.add("braces", "deletion", function (state, action, editor, session, range) {

        var selected = session.doc.getTextRange(range);

        if (!range.isMultiLine() && selected == '{') {

            var line = session.doc.getLine(range.start.row);

            var rightChar = line.substring(range.end.column, range.end.column + 1);

            if (rightChar == '}') {

                range.end.column++;

                return range;

            } else {

                maybeInsertedBrackets--;

            }

        }

    });

 

    this.add("parens", "insertion", function (state, action, editor, session, text) {

        if (text == '(') {

            var selection = editor.getSelectionRange();

            var selected = session.doc.getTextRange(selection);

            if (selected !== "" && editor.getWrapBehavioursEnabled()) {

                return {

                    text: '(' + selected + ')',

                    selection: false

                };

            } else if (CstyleBehaviour.isSaneInsertion(editor, session)) {

                CstyleBehaviour.recordAutoInsert(editor, session, ")");

                return {

                    text: '()',

                    selection: [1, 1]

                };

            }

        } else if (text == ')') {

            var cursor = editor.getCursorPosition();

            var line = session.doc.getLine(cursor.row);

            var rightChar = line.substring(cursor.column, cursor.column + 1);

            if (rightChar == ')') {

                var matching = session.$findOpeningBracket(')', {column: cursor.column + 1, row: cursor.row});

                if (matching !== null && CstyleBehaviour.isAutoInsertedClosing(cursor, line, text)) {

                    CstyleBehaviour.popAutoInsertedClosing();

                    return {

                        text: '',

                        selection: [1, 1]

                    };

                }

            }

        }

    });

 

    this.add("parens", "deletion", function (state, action, editor, session, range) {

        var selected = session.doc.getTextRange(range);

        if (!range.isMultiLine() && selected == '(') {

            var line = session.doc.getLine(range.start.row);

            var rightChar = line.substring(range.start.column + 1, range.start.column + 2);

            if (rightChar == ')') {

                range.end.column++;

                return range;

            }

        }

    });

 

    this.add("brackets", "insertion", function (state, action, editor, session, text) {

        if (text == '[') {

            var selection = editor.getSelectionRange();

            var selected = session.doc.getTextRange(selection);

            if (selected !== "" && editor.getWrapBehavioursEnabled()) {

                return {

                    text: '[' + selected + ']',

                    selection: false

                };

            } else if (CstyleBehaviour.isSaneInsertion(editor, session)) {

                CstyleBehaviour.recordAutoInsert(editor, session, "]");

                return {

                    text: '[]',

                    selection: [1, 1]

                };

            }

        } else if (text == ']') {

            var cursor = editor.getCursorPosition();

            var line = session.doc.getLine(cursor.row);

            var rightChar = line.substring(cursor.column, cursor.column + 1);

            if (rightChar == ']') {

                var matching = session.$findOpeningBracket(']', {column: cursor.column + 1, row: cursor.row});

                if (matching !== null && CstyleBehaviour.isAutoInsertedClosing(cursor, line, text)) {

                    CstyleBehaviour.popAutoInsertedClosing();

                    return {

                        text: '',

                        selection: [1, 1]

                    };

                }

            }

        }

    });

 

    this.add("brackets", "deletion", function (state, action, editor, session, range) {

        var selected = session.doc.getTextRange(range);

        if (!range.isMultiLine() && selected == '[') {

            var line = session.doc.getLine(range.start.row);

            var rightChar = line.substring(range.start.column + 1, range.start.column + 2);

            if (rightChar == ']') {

                range.end.column++;

                return range;

            }

        }

    });

 

    this.add("string_dquotes", "insertion", function (state, action, editor, session, text) {

        if (text == '"' || text == "'") {

            var quote = text;

            var selection = editor.getSelectionRange();

            var selected = session.doc.getTextRange(selection);

            if (selected !== "" && selected !== "'" && selected != '"' && editor.getWrapBehavioursEnabled()) {

                return {

                    text: quote + selected + quote,

                    selection: false

                };

            } else {

                var cursor = editor.getCursorPosition();

                var line = session.doc.getLine(cursor.row);

                var leftChar = line.substring(cursor.column-1, cursor.column);

                if (leftChar == '\\') {

                    return null;

                }

                var tokens = session.getTokens(selection.start.row);

                var col = 0, token;

                var quotepos = -1; // Track whether we're inside an open quote.

 

                for (var x = 0; x < tokens.length; x++) {

                    token = tokens[x];

                    if (token.type == "string") {

                      quotepos = -1;

                    } else if (quotepos < 0) {

                      quotepos = token.value.indexOf(quote);

                    }

                    if ((token.value.length + col) > selection.start.column) {

                        break;

                    }

                    col += tokens[x].value.length;

                }

                if (!token || (quotepos < 0 && token.type !== "comment" && (token.type !== "string" || ((selection.start.column !== token.value.length+col-1) && token.value.lastIndexOf(quote) === token.value.length-1)))) {

                    if (!CstyleBehaviour.isSaneInsertion(editor, session))

                        return;

                    return {

                        text: quote + quote,

                        selection: [1,1]

                    };

                } else if (token && token.type === "string") {

                    var rightChar = line.substring(cursor.column, cursor.column + 1);

                    if (rightChar == quote) {

                        return {

                            text: '',

                            selection: [1, 1]

                        };

                    }

                }

            }

        }

    });

 

    this.add("string_dquotes", "deletion", function (state, action, editor, session, range) {

        var selected = session.doc.getTextRange(range);

        if (!range.isMultiLine() && (selected == '"' || selected == "'")) {

            var line = session.doc.getLine(range.start.row);

            var rightChar = line.substring(range.start.column + 1, range.start.column + 2);

            if (rightChar == selected) {

                range.end.column++;

                return range;

            }

        }

    });

 

};

 

oop.inherits(CstyleBehaviour, Behaviour);

 

exports.CstyleBehaviour = CstyleBehaviour;

});

 

define('ace/mode/folding/xml', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/lib/lang', 'ace/range', 'ace/mode/folding/fold_mode', 'ace/token_iterator'], function(require, exports, module) {

 

 

var oop = require("../../lib/oop");

var lang = require("../../lib/lang");

var Range = require("../../range").Range;

var BaseFoldMode = require("./fold_mode").FoldMode;

var TokenIterator = require("../../token_iterator").TokenIterator;

 

var FoldMode = exports.FoldMode = function(voidElements) {

    BaseFoldMode.call(this);

    this.voidElements = voidElements || {};

};

oop.inherits(FoldMode, BaseFoldMode);

 

(function() {

 

    this.getFoldWidget = function(session, foldStyle, row) {

        var tag = this._getFirstTagInLine(session, row);

 

        if (tag.closing)

            return foldStyle == "markbeginend" ? "end" : "";

 

        if (!tag.tagName || this.voidElements[tag.tagName.toLowerCase()])

            return "";

 

        if (tag.selfClosing)

            return "";

 

        if (tag.value.indexOf("/" + tag.tagName) !== -1)

            return "";

 

        return "start";

    };

    

    this._getFirstTagInLine = function(session, row) {

        var tokens = session.getTokens(row);

        var value = "";

        for (var i = 0; i < tokens.length; i++) {

            var token = tokens[i];

            if (token.type.indexOf("meta.tag") === 0)

                value += token.value;

            else

                value += lang.stringRepeat(" ", token.value.length);

        }

        

        return this._parseTag(value);

    };

 

    this.tagRe = /^(\s*)(<?(\/?)([-_a-zA-Z0-9:!]*)\s*(\/?)>?)/;

    this._parseTag = function(tag) {

        

        var match = this.tagRe.exec(tag);

        var column = this.tagRe.lastIndex || 0;

        this.tagRe.lastIndex = 0;

 

        return {

            value: tag,

            match: match ? match[2] : "",

            closing: match ? !!match[3] : false,

            selfClosing: match ? !!match[5] || match[2] == "/>" : false,

            tagName: match ? match[4] : "",

            column: match[1] ? column + match[1].length : column

        };

    };

    this._readTagForward = function(iterator) {

        var token = iterator.getCurrentToken();

        if (!token)

            return null;

            

        var value = "";

        var start;

        

        do {

            if (token.type.indexOf("meta.tag") === 0) {

                if (!start) {

                    var start = {

                        row: iterator.getCurrentTokenRow(),

                        column: iterator.getCurrentTokenColumn()

                    };

                }

                value += token.value;

                if (value.indexOf(">") !== -1) {

                    var tag = this._parseTag(value);

                    tag.start = start;

                    tag.end = {

                        row: iterator.getCurrentTokenRow(),

                        column: iterator.getCurrentTokenColumn() + token.value.length

                    };

                    iterator.stepForward();

                    return tag;

                }

            }

        } while(token = iterator.stepForward());

        

        return null;

    };

    

    this._readTagBackward = function(iterator) {

        var token = iterator.getCurrentToken();

        if (!token)

            return null;

            

        var value = "";

        var end;

 

        do {

            if (token.type.indexOf("meta.tag") === 0) {

                if (!end) {

                    end = {

                        row: iterator.getCurrentTokenRow(),

                        column: iterator.getCurrentTokenColumn() + token.value.length

                    };

                }

                value = token.value + value;

                if (value.indexOf("<") !== -1) {

                    var tag = this._parseTag(value);

                    tag.end = end;

                    tag.start = {

                        row: iterator.getCurrentTokenRow(),

                        column: iterator.getCurrentTokenColumn()

                    };

                    iterator.stepBackward();

                    return tag;

                }

            }

        } while(token = iterator.stepBackward());

        

        return null;

    };

    

    this._pop = function(stack, tag) {

        while (stack.length) {

            

            var top = stack[stack.length-1];

            if (!tag || top.tagName == tag.tagName) {

                return stack.pop();

            }

            else if (this.voidElements[tag.tagName]) {

                return;

            }

            else if (this.voidElements[top.tagName]) {

                stack.pop();

                continue;

            } else {

                return null;

            }

        }

    };

    

    this.getFoldWidgetRange = function(session, foldStyle, row) {

        var firstTag = this._getFirstTagInLine(session, row);

        

        if (!firstTag.match)

            return null;

        

        var isBackward = firstTag.closing || firstTag.selfClosing;

        var stack = [];

        var tag;

        

        if (!isBackward) {

            var iterator = new TokenIterator(session, row, firstTag.column);

            var start = {

                row: row,

                column: firstTag.column + firstTag.tagName.length + 2

            };

            while (tag = this._readTagForward(iterator)) {

                if (tag.selfClosing) {

                    if (!stack.length) {

                        tag.start.column += tag.tagName.length + 2;

                        tag.end.column -= 2;

                        return Range.fromPoints(tag.start, tag.end);

                    } else

                        continue;

                }

                

                if (tag.closing) {

                    this._pop(stack, tag);

                    if (stack.length == 0)

                        return Range.fromPoints(start, tag.start);

                }

                else {

                    stack.push(tag)

                }

            }

        }

        else {

            var iterator = new TokenIterator(session, row, firstTag.column + firstTag.match.length);

            var end = {

                row: row,

                column: firstTag.column

            };

            

            while (tag = this._readTagBackward(iterator)) {

                if (tag.selfClosing) {

                    if (!stack.length) {

                        tag.start.column += tag.tagName.length + 2;

                        tag.end.column -= 2;

                        return Range.fromPoints(tag.start, tag.end);

                    } else

                        continue;

                }

                

                if (!tag.closing) {

                    this._pop(stack, tag);

                    if (stack.length == 0) {

                        tag.start.column += tag.tagName.length + 2;

                        return Range.fromPoints(tag.start, end);

                    }

                }

                else {

                    stack.push(tag)

                }

            }

        }

        

    };

 

}).call(FoldMode.prototype);

 

});

 

define('ace/mode/javascript', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/text', 'ace/tokenizer', 'ace/mode/javascript_highlight_rules', 'ace/mode/matching_brace_outdent', 'ace/range', 'ace/worker/worker_client', 'ace/mode/behaviour/cstyle', 'ace/mode/folding/cstyle'], function(require, exports, module) {

 

 

var oop = require("../lib/oop");

var TextMode = require("./text").Mode;

var Tokenizer = require("../tokenizer").Tokenizer;

var JavaScriptHighlightRules = require("./javascript_highlight_rules").JavaScriptHighlightRules;

var MatchingBraceOutdent = require("./matching_brace_outdent").MatchingBraceOutdent;

var Range = require("../range").Range;

var WorkerClient = require("../worker/worker_client").WorkerClient;

var CstyleBehaviour = require("./behaviour/cstyle").CstyleBehaviour;

var CStyleFoldMode = require("./folding/cstyle").FoldMode;

 

var Mode = function() {

    this.$tokenizer = new Tokenizer(new JavaScriptHighlightRules().getRules());

    this.$outdent = new MatchingBraceOutdent();

    this.$behaviour = new CstyleBehaviour();

    this.foldingRules = new CStyleFoldMode();

};

oop.inherits(Mode, TextMode);

 

(function() {

 

    this.lineCommentStart = "//";

    this.blockComment = {start: "/*", end: "*/"};

 

    this.getNextLineIndent = function(state, line, tab) {

        var indent = this.$getIndent(line);

 

        var tokenizedLine = this.$tokenizer.getLineTokens(line, state);

        var tokens = tokenizedLine.tokens;

        var endState = tokenizedLine.state;

 

        if (tokens.length && tokens[tokens.length-1].type == "comment") {

            return indent;

        }

 

        if (state == "start" || state == "no_regex") {

            var match = line.match(/^.*(?:\bcase\b.*\:|[\{\(\[])\s*$/);

            if (match) {

                indent += tab;

            }

        } else if (state == "doc-start") {

            if (endState == "start" || endState == "no_regex") {

                return "";

            }

            var match = line.match(/^\s*(\/?)\*/);

            if (match) {

                if (match[1]) {

                    indent += " ";

                }

                indent += "* ";

            }

        }

 

        return indent;

    };

 

    this.checkOutdent = function(state, line, input) {

        return this.$outdent.checkOutdent(line, input);

    };

 

    this.autoOutdent = function(state, doc, row) {

        this.$outdent.autoOutdent(doc, row);

    };

 

    this.createWorker = function(session) {

        var worker = new WorkerClient(["ace"], "ace/mode/javascript_worker", "JavaScriptWorker");

        worker.attachToDocument(session.getDocument());

 

        worker.on("jslint", function(results) {

            session.setAnnotations(results.data);

        });

 

        worker.on("terminate", function() {

            session.clearAnnotations();

        });

 

        return worker;

    };

 

}).call(Mode.prototype);

 

exports.Mode = Mode;

});

 

define('ace/mode/javascript_highlight_rules', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/doc_comment_highlight_rules', 'ace/mode/text_highlight_rules'], function(require, exports, module) {

 

 

var oop = require("../lib/oop");

var DocCommentHighlightRules = require("./doc_comment_highlight_rules").DocCommentHighlightRules;

var TextHighlightRules = require("./text_highlight_rules").TextHighlightRules;

 

var JavaScriptHighlightRules = function() {

    var keywordMapper = this.createKeywordMapper({

        "variable.language":

            "Array|Boolean|Date|Function|Iterator|Number|Object|RegExp|String|Proxy|"  + // Constructors

            "Namespace|QName|XML|XMLList|"                                             + // E4X

            "ArrayBuffer|Float32Array|Float64Array|Int16Array|Int32Array|Int8Array|"   +

            "Uint16Array|Uint32Array|Uint8Array|Uint8ClampedArray|"                    +

            "Error|EvalError|InternalError|RangeError|ReferenceError|StopIteration|"   + // Errors

            "SyntaxError|TypeError|URIError|"                                          +

            "decodeURI|decodeURIComponent|encodeURI|encodeURIComponent|eval|isFinite|" + // Non-constructor functions

            "isNaN|parseFloat|parseInt|"                                               +

            "JSON|Math|"                                                               + // Other

            "this|arguments|prototype|window|document"                                 , // Pseudo

        "keyword":

            "const|yield|import|get|set|" +

            "break|case|catch|continue|default|delete|do|else|finally|for|function|" +

            "if|in|instanceof|new|return|switch|throw|try|typeof|let|var|while|with|debugger|" +

            "__parent__|__count__|escape|unescape|with|__proto__|" +

            "class|enum|extends|super|export|implements|private|public|interface|package|protected|static",

        "storage.type":

            "const|let|var|function",

        "constant.language":

            "null|Infinity|NaN|undefined",

        "support.function":

            "alert",

        "constant.language.boolean": "true|false"

    }, "identifier");

    var kwBeforeRe = "case|do|else|finally|in|instanceof|return|throw|try|typeof|yield|void";

    var identifierRe = "[a-zA-Z\\$_\u00a1-\uffff][a-zA-Z\\d\\$_\u00a1-\uffff]*\\b";

 

    var escapedRe = "\\\\(?:x[0-9a-fA-F]{2}|" + // hex

        "u[0-9a-fA-F]{4}|" + // unicode

        "[0-2][0-7]{0,2}|" + // oct

        "3[0-6][0-7]?|" + // oct

        "37[0-7]?|" + // oct

        "[4-7][0-7]?|" + //oct

        ".)";

 

    this.$rules = {

        "no_regex" : [

            {

                token : "comment",

                regex : /\/\/.*$/

            },

            DocCommentHighlightRules.getStartRule("doc-start"),

            {

                token : "comment", // multi line comment

                regex : /\/\*/,

                next : "comment"

            }, {

                token : "string",

                regex : "'(?=.)",

                next  : "qstring"

            }, {

                token : "string",

                regex : '"(?=.)',

                next  : "qqstring"

            }, {

                token : "constant.numeric", // hex

                regex : /0[xX][0-9a-fA-F]+\b/

            }, {

                token : "constant.numeric", // float

                regex : /[+-]?\d+(?:(?:\.\d*)?(?:[eE][+-]?\d+)?)?\b/

            }, {

                token : [

                    "storage.type", "punctuation.operator", "support.function",

                    "punctuation.operator", "entity.name.function", "text","keyword.operator"

                ],

                regex : "(" + identifierRe + ")(\\.)(prototype)(\\.)(" + identifierRe +")(\\s*)(=)",

                next: "function_arguments"

            }, {

                token : [

                    "storage.type", "punctuation.operator", "entity.name.function", "text",

                    "keyword.operator", "text", "storage.type", "text", "paren.lparen"

                ],

                regex : "(" + identifierRe + ")(\\.)(" + identifierRe +")(\\s*)(=)(\\s*)(function)(\\s*)(\\()",

                next: "function_arguments"

            }, {

                token : [

                    "entity.name.function", "text", "keyword.operator", "text", "storage.type",

                    "text", "paren.lparen"

                ],

                regex : "(" + identifierRe +")(\\s*)(=)(\\s*)(function)(\\s*)(\\()",

                next: "function_arguments"

            }, {

                token : [

                    "storage.type", "punctuation.operator", "entity.name.function", "text",

                    "keyword.operator", "text",

                    "storage.type", "text", "entity.name.function", "text", "paren.lparen"

                ],

                regex : "(" + identifierRe + ")(\\.)(" + identifierRe +")(\\s*)(=)(\\s*)(function)(\\s+)(\\w+)(\\s*)(\\()",

                next: "function_arguments"

            }, {

                token : [

                    "storage.type", "text", "entity.name.function", "text", "paren.lparen"

                ],

                regex : "(function)(\\s+)(" + identifierRe + ")(\\s*)(\\()",

                next: "function_arguments"

            }, {

                token : [

                    "entity.name.function", "text", "punctuation.operator",

                    "text", "storage.type", "text", "paren.lparen"

                ],

                regex : "(" + identifierRe + ")(\\s*)(:)(\\s*)(function)(\\s*)(\\()",

                next: "function_arguments"

            }, {

                token : [

                    "text", "text", "storage.type", "text", "paren.lparen"

                ],

                regex : "(:)(\\s*)(function)(\\s*)(\\()",

                next: "function_arguments"

            }, {

                token : "keyword",

                regex : "(?:" + kwBeforeRe + ")\\b",

                next : "start"

            }, {

                token : ["punctuation.operator", "support.function"],

                regex : /(\.)(s(?:h(?:ift|ow(?:Mod(?:elessDialog|alDialog)|Help))|croll(?:X|By(?:Pages|Lines)?|Y|To)?|t(?:opzzzz|rike)|i(?:n|zeToContent|debar|gnText)|ort|u(?:p|b(?:str(?:ing)?)?)|pli(?:ce|t)|e(?:nd|t(?:Re(?:sizable|questHeader)|M(?:i(?:nutes|lliseconds)|onth)|Seconds|Ho(?:tKeys|urs)|Year|Cursor|Time(?:out)?|Interval|ZOptions|Date|UTC(?:M(?:i(?:nutes|lliseconds)|onth)|Seconds|Hours|Date|FullYear)|FullYear|Active)|arch)|qrt|lice|avePreferences|mall)|h(?:ome|andleEvent)|navigate|c(?:har(?:CodeAt|At)|o(?:s|n(?:cat|textual|firm)|mpile)|eil|lear(?:Timeout|Interval)?|a(?:ptureEvents|ll)|reate(?:StyleSheet|Popup|EventObject))|t(?:o(?:GMTString|S(?:tring|ource)|U(?:TCString|pperCase)|Lo(?:caleString|werCase))|est|a(?:n|int(?:Enabled)?))|i(?:s(?:NaN|Finite)|ndexOf|talics)|d(?:isableExternalCapture|ump|etachEvent)|u(?:n(?:shift|taint|escape|watch)|pdateCommands)|j(?:oin|avaEnabled)|p(?:o(?:p|w)|ush|lugins.refresh|a(?:ddings|rse(?:Int|Float)?)|r(?:int|ompt|eference))|e(?:scape|nableExternalCapture|val|lementFromPoint|x(?:p|ec(?:Script|Command)?))|valueOf|UTC|queryCommand(?:State|Indeterm|Enabled|Value)|f(?:i(?:nd|le(?:ModifiedDate|Size|CreatedDate|UpdatedDate)|xed)|o(?:nt(?:size|color)|rward)|loor|romCharCode)|watch|l(?:ink|o(?:ad|g)|astIndexOf)|a(?:sin|nchor|cos|t(?:tachEvent|ob|an(?:2)?)|pply|lert|b(?:s|ort))|r(?:ou(?:nd|teEvents)|e(?:size(?:By|To)|calc|turnValue|place|verse|l(?:oad|ease(?:Capture|Events)))|andom)|g(?:o|et(?:ResponseHeader|M(?:i(?:nutes|lliseconds)|onth)|Se(?:conds|lection)|Hours|Year|Time(?:zoneOffset)?|Da(?:y|te)|UTC(?:M(?:i(?:nutes|lliseconds)|onth)|Seconds|Hours|Da(?:y|te)|FullYear)|FullYear|A(?:ttention|llResponseHeaders)))|m(?:in|ove(?:B(?:y|elow)|To(?:Absolute)?|Above)|ergeAttributes|a(?:tch|rgins|x))|b(?:toa|ig|o(?:ld|rderWidths)|link|ack))\b(?=\()/

            }, {

                token : ["punctuation.operator", "support.function.dom"],

                regex : /(\.)(s(?:ub(?:stringData|mit)|plitText|e(?:t(?:NamedItem|Attribute(?:Node)?)|lect))|has(?:ChildNodes|Feature)|namedItem|c(?:l(?:ick|o(?:se|neNode))|reate(?:C(?:omment|DATASection|aption)|T(?:Head|extNode|Foot)|DocumentFragment|ProcessingInstruction|E(?:ntityReference|lement)|Attribute))|tabIndex|i(?:nsert(?:Row|Before|Cell|Data)|tem)|open|delete(?:Row|C(?:ell|aption)|T(?:Head|Foot)|Data)|focus|write(?:ln)?|a(?:dd|ppend(?:Child|Data))|re(?:set|place(?:Child|Data)|move(?:NamedItem|Child|Attribute(?:Node)?)?)|get(?:NamedItem|Element(?:sBy(?:Name|TagName)|ById)|Attribute(?:Node)?)|blur)\b(?=\()/

            }, {

                token : ["punctuation.operator", "support.constant"],

                regex : /(\.)(s(?:ystemLanguage|cr(?:ipts|ollbars|een(?:X|Y|Top|Left))|t(?:yle(?:Sheets)?|atus(?:Text|bar)?)|ibling(?:Below|Above)|ource|uffixes|e(?:curity(?:Policy)?|l(?:ection|f)))|h(?:istory|ost(?:name)?|as(?:h|Focus))|y|X(?:MLDocument|SLDocument)|n(?:ext|ame(?:space(?:s|URI)|Prop))|M(?:IN_VALUE|AX_VALUE)|c(?:haracterSet|o(?:n(?:structor|trollers)|okieEnabled|lorDepth|mp(?:onents|lete))|urrent|puClass|l(?:i(?:p(?:boardData)?|entInformation)|osed|asses)|alle(?:e|r)|rypto)|t(?:o(?:olbar|p)|ext(?:Transform|Indent|Decoration|Align)|ags)|SQRT(?:1_2|2)|i(?:n(?:ner(?:Height|Width)|put)|ds|gnoreCase)|zIndex|o(?:scpu|n(?:readystatechange|Line)|uter(?:Height|Width)|p(?:sProfile|ener)|ffscreenBuffering)|NEGATIVE_INFINITY|d(?:i(?:splay|alog(?:Height|Top|Width|Left|Arguments)|rectories)|e(?:scription|fault(?:Status|Ch(?:ecked|arset)|View)))|u(?:ser(?:Profile|Language|Agent)|n(?:iqueID|defined)|pdateInterval)|_content|p(?:ixelDepth|ort|ersonalbar|kcs11|l(?:ugins|atform)|a(?:thname|dding(?:Right|Bottom|Top|Left)|rent(?:Window|Layer)?|ge(?:X(?:Offset)?|Y(?:Offset)?))|r(?:o(?:to(?:col|type)|duct(?:Sub)?|mpter)|e(?:vious|fix)))|e(?:n(?:coding|abledPlugin)|x(?:ternal|pando)|mbeds)|v(?:isibility|endor(?:Sub)?|Linkcolor)|URLUnencoded|P(?:I|OSITIVE_INFINITY)|f(?:ilename|o(?:nt(?:Size|Family|Weight)|rmName)|rame(?:s|Element)|gColor)|E|whiteSpace|l(?:i(?:stStyleType|n(?:eHeight|kColor))|o(?:ca(?:tion(?:bar)?|lName)|wsrc)|e(?:ngth|ft(?:Context)?)|a(?:st(?:M(?:odified|atch)|Index|Paren)|yer(?:s|X)|nguage))|a(?:pp(?:MinorVersion|Name|Co(?:deName|re)|Version)|vail(?:Height|Top|Width|Left)|ll|r(?:ity|guments)|Linkcolor|bove)|r(?:ight(?:Context)?|e(?:sponse(?:XML|Text)|adyState))|global|x|m(?:imeTypes|ultiline|enubar|argin(?:Right|Bottom|Top|Left))|L(?:N(?:10|2)|OG(?:10E|2E))|b(?:o(?:ttom|rder(?:Width|RightWidth|BottomWidth|Style|Color|TopWidth|LeftWidth))|ufferDepth|elow|ackground(?:Color|Image)))\b/

            }, {

                token : ["storage.type", "punctuation.operator", "support.function.firebug"],

                regex : /(console)(\.)(warn|info|log|error|time|timeEnd|assert)\b/

            }, {

                token : keywordMapper,

                regex : identifierRe

            }, {

                token : "keyword.operator",

                regex : /--|\+\+|[!$%&*+\-~]|===|==|=|!=|!==|<=|>=|<<=|>>=|>>>=|<>|<|>|!|&&|\|\||\?\:|\*=|%=|\+=|\-=|&=|\^=/,

                next  : "start"

            }, {

                token : "punctuation.operator",

                regex : /\?|\:|\,|\;|\./,

                next  : "start"

            }, {

                token : "paren.lparen",

                regex : /[\[({]/,

                next  : "start"

            }, {

                token : "paren.rparen",

                regex : /[\])}]/

            }, {

                token : "keyword.operator",

                regex : /\/=?/,

                next  : "start"

            }, {

                token: "comment",

                regex: /^#!.*$/

            }

        ],

        "start": [

            DocCommentHighlightRules.getStartRule("doc-start"),

            {

                token : "comment", // multi line comment

                regex : "\\/\\*",

                next : "comment_regex_allowed"

            }, {

                token : "comment",

                regex : "\\/\\/.*$",

                next : "start"

            }, {

                token: "string.regexp",

                regex: "\\/",

                next: "regex",

            }, {

                token : "text",

                regex : "\\s+|^$",

                next : "start"

            }, {

                token: "empty",

                regex: "",

                next: "no_regex"

            }

        ],

        "regex": [

            {

                token: "regexp.keyword.operator",

                regex: "\\\\(?:u[\\da-fA-F]{4}|x[\\da-fA-F]{2}|.)"

            }, {

                token: "string.regexp",

                regex: "/\\w*",

                next: "no_regex",

            }, {

                token : "invalid",

                regex: /\{\d+\b,?\d*\}[+*]|[+*$^?][+*]|[$^][?]|\?{3,}/

            }, {

                token : "constant.language.escape",

                regex: /\(\?[:=!]|\)|\{\d+\b,?\d*\}|[+*]\?|[()$^+*?]/

            }, {

                token : "constant.language.delimiter",

                regex: /\|/

            }, {

                token: "constant.language.escape",

                regex: /\[\^?/,

                next: "regex_character_class",

            }, {

                token: "empty",

                regex: "$",

                next: "no_regex"

            }, {

                defaultToken: "string.regexp"

            }

        ],

        "regex_character_class": [

            {

                token: "regexp.keyword.operator",

                regex: "\\\\(?:u[\\da-fA-F]{4}|x[\\da-fA-F]{2}|.)"

            }, {

                token: "constant.language.escape",

                regex: "]",

                next: "regex",

            }, {

                token: "constant.language.escape",

                regex: "-"

            }, {

                token: "empty",

                regex: "$",

                next: "no_regex"

            }, {

                defaultToken: "string.regexp.charachterclass"

            }

        ],

        "function_arguments": [

            {

                token: "variable.parameter",

                regex: identifierRe

            }, {

                token: "punctuation.operator",

                regex: "[, ]+",

            }, {

                token: "punctuation.operator",

                regex: "$",

            }, {

                token: "empty",

                regex: "",

                next: "no_regex"

            }

        ],

        "comment_regex_allowed" : [

            {token : "comment", regex : "\\*\\/", next : "start"},

            {defaultToken : "comment"}

        ],

        "comment" : [

            {token : "comment", regex : "\\*\\/", next : "no_regex"},

            {defaultToken : "comment"}

        ],

        "qqstring" : [

            {

                token : "constant.language.escape",

                regex : escapedRe

            }, {

                token : "string",

                regex : "\\\\$",

                next  : "qqstring",

            }, {

                token : "string",

                regex : '"|$',

                next  : "no_regex",

            }, {

                defaultToken: "string"

            }

        ],

        "qstring" : [

            {

                token : "constant.language.escape",

                regex : escapedRe

            }, {

                token : "string",

                regex : "\\\\$",

                next  : "qstring",

            }, {

                token : "string",

                regex : "'|$",

                next  : "no_regex",

            }, {

                defaultToken: "string"

            }

        ]

    };

 

    this.embedRules(DocCommentHighlightRules, "doc-",

        [ DocCommentHighlightRules.getEndRule("no_regex") ]);

};

 

oop.inherits(JavaScriptHighlightRules, TextHighlightRules);

 

exports.JavaScriptHighlightRules = JavaScriptHighlightRules;

});

 

define('ace/mode/doc_comment_highlight_rules', ['require', 'exports', 'module' , 'ace/lib/oop', 'ace/mode/text_highlight_rules'], function(require, exports, module) {

 

 

var oop = require("../lib/oop");

var TextHighlightRules = require("./text_highlight_rules").TextHighlightRules;

 

var DocCommentHighlightRules = function() {

 

    this.$rules = {

        "start" : [ {

            token : "comment.doc.tag",

            regex : "@[\\w\\d_]+" // TODO: fix email addresses

        }, {

            token : "comment.doc.tag",

            regex : "\\bTODO\\b"

        }, {

            defaultToken : "comment.doc"

        }]

    };

};

 

oop.inherits(DocCommentHighlightRules, TextHighlightRules);

 

DocCommentHighlightRules.getStartRule = function(start) {

    return {

        token : "comment.doc", // doc comment

        regex : "\\/\\*(?=\\*)",

        next  : start

    };

};

 

DocCommentHighlightRules.getEndRule = function (start) {

    return {

        token : "comment.doc", // closing comment