marko/runtime/vdom/index.js

'use strict';
// helpers provide a core set of various utility methods
// that are available in every template
var helpers;

/**
 * Method is for internal usage only. This method
 * is invoked by code in a compiled Marko template and
 * it is used to create a new Template instance.
 * @private
 */
 exports.c = function createTemplate(path) {
     return new Template(path);
};

var AsyncVDOMBuilder = require('./AsyncVDOMBuilder');

function createOut(globalData) {
    return new AsyncVDOMBuilder(globalData);
}

var extend = require('raptor-util/extend');

function Template(path, func) {
    this.path = path;
    this._ = func;
    this.meta = undefined;
}

Template.prototype = {
    createOut: createOut,

    renderSync: function(data) {
        var localData;
        var globalData;

        if (data) {
            localData = data;
            globalData = data.$global;
            localData.$global = null;
        } else {
            localData = {};
        }

        var out = new AsyncVDOMBuilder(globalData);
        out.sync();
        this._(localData, out);
        return out.getOutput();
    },

    /**
     * Renders a template to either a stream (if the last
     * argument is a Stream instance) or
     * provides the output to a callback function (if the last
     * argument is a Function).
     *
     * Supported signatures:
     *
     * render(data, callback)
     * render(data, out)
     * render(data, stream)
     * render(data, out, callback)
     * render(data, stream, callback)
     *
     * @param  {Object} data The view model data for the template
     * @param  {AsyncVDOMBuilder} out A Stream or an AsyncVDOMBuilder instance
     * @param  {Function} callback A callback function
     * @return {AsyncVDOMBuilder} Returns the AsyncVDOMBuilder instance that the template is rendered to
     */
    render: function(data, out, callback) {
        var renderFunc = this._;

        var finalData;
        var globalData;
        if (data) {
            finalData = data;

            if ((globalData = data.$global)) {
                // We will *move* the "$global" property
                // into the "out.global" object
                data.$global = null;
            }
        } else {
            finalData = {};
        }

        if (out) {
            // The out can either be a callback function or AsyncStream...
            if (out.isAsyncVDOMBuilder) {
                if (callback) {
                    out
                        .on('finish', function() {
                            callback(null, out.getOutput(), out);
                        })
                        .once('error', callback);
                }

                if (globalData) {
                    extend(out.global, globalData);
                }

                renderFunc(finalData, out);

                return out;
            } else if (typeof out === 'function') {
                callback = out;
                out = null;
            }
        }

        var finalOut = new AsyncVDOMBuilder(globalData);

        if (callback) {
            finalOut
                .on('finish', function() {
                    callback(null, finalOut.getOutput(), finalOut);
                })
                .once('error', callback);
        }

        // Invoke the compiled template's render function to have it
        // write out strings to the provided out.
        renderFunc(finalData, finalOut);

        return finalOut.end();
    }
};

function createInlineMarkoTemplate(filename, renderFunc) {
    return new Template(filename, renderFunc);
}

exports.createOut = createOut;

exports.Template = Template;

exports._inline = createInlineMarkoTemplate;


helpers = require('./helpers');
exports.helpers = helpers;

require('../')._setRuntime(exports);