marko/widgets/index.js

/**
* Module to manage the lifecycle of widgets
*
*/
'use strict';
var warp10 = require('warp10');
var WidgetsContext = require('./WidgetsContext');
var escapeEndingScriptTagRegExp = /<\//g;

function flattenHelper(widgets, flattened, typesArray, typesLookup) {
    for (var i = 0, len = widgets.length; i < len; i++) {
        var widgetDef = widgets[i];
        var type = widgetDef.$__type;
        if (!type) {
            continue;
        }

        var typeIndex = typesLookup[type];
        if (typeIndex === undefined) {
            typeIndex = typesArray.length;
            typesArray.push(type);
            typesLookup[type] = typeIndex;
        }

        var children = widgetDef.$__children;

        if (children) {
            // Depth-first search (children should be initialized before parent)
            flattenHelper(children, flattened, typesArray, typesLookup);
        }

        var customEvents = widgetDef.$__customEvents;
        var extra = {
            p: customEvents && widgetDef.$__scope, // Only serialize scope if we need to attach custom events
            e: widgetDef.$__domEvents,
            ce: widgetDef.$__customEvents,
            c: widgetDef.$__config
        };

        var state = widgetDef.$__state;

        if (state) {
            // Update state properties with an `undefined` value to have a `null`
            // value so that the property name will be serialized down to the browser.
            // This ensures that we add the proper getter/setter for the state property.
            for (var k in state) {
                if (state[k] === undefined) {
                    state[k] = null;
                }
            }
        }

        flattened.push([
            widgetDef.id,        // 0 = id
            typeIndex,           // 1 = type
            widgetDef.$__roots,  // 2 = root el ids
            state,               // 3 = state
            extra                // 4
        ]);
    }
}

function getRenderedWidgets(widgetsContext) {
    var widgets = widgetsContext.$__widgets;
    if (!widgets || !widgets.length) {
        return;
    }

    var flattened = [];
    var typesLookup = {};
    var typesArray = [];

    flattenHelper(widgets, flattened, typesArray, typesLookup);
    return [flattened, typesArray];
}


function writeInitWidgetsCode(widgetsContext, out) {
    var renderedWidgets = getRenderedWidgets(widgetsContext);
    if (!renderedWidgets) {
        return;
    }

    var cspNonce = out.global.cspNonce;
    var nonceAttr = cspNonce ? ' nonce='+JSON.stringify(cspNonce) : '';

    out.write('<script' + nonceAttr + '>' +
        '(function(){var w=window;w.$widgets=((w.$widgets||[]).concat(' +
        warp10.stringify(renderedWidgets).replace(escapeEndingScriptTagRegExp, '\\u003C/') +
         ')||w.$widgets)})()</script>');

    widgetsContext.$__clearWidgets();
}

exports.writeInitWidgetsCode = writeInitWidgetsCode;

/**
 * Returns an object that can be sent to the browser using JSON.stringify. The parsed object should be
 * passed to require('marko-widgets').initWidgets(...);
 *
 * @param  {WidgetsContext|AsyncWriter} widgetsContext A WidgetsContext or an AsyncWriter
 * @return {Object} An object with information about the rendered widgets that can be serialized to JSON. The object should be treated as opaque
 */
exports.getRenderedWidgets = function(widgetsContext) {
    if (!(widgetsContext instanceof WidgetsContext)) {
        // Assume that the provided "widgetsContext" argument is
        // actually an AsyncWriter
        var out = widgetsContext;
        if (!out.global) {
            throw new Error('Invalid argument: ' + widgetsContext);
        }

        widgetsContext = WidgetsContext.$__getWidgetsContext(out);
    }

    var renderedWidgets = getRenderedWidgets(widgetsContext);
    return warp10.stringifyPrepare(renderedWidgets);
};

exports.defineComponent = require('./defineComponent');
exports.defineWidget = require('./defineWidget');
exports.defineRenderer = require('./defineRenderer');
exports.makeRenderable = exports.renderable = require('../runtime/renderable');

exports.r = require('./renderer');

exports.w = function() { /* no op for defining a widget on teh server */ };

// registerWidget is a no-op on the server.
// Fixes https://github.com/marko-js/marko-widgets/issues/111
exports.rw = function(typeName) { return typeName; };