Chris' Notes

// Example Widget
function(app, ns, data, utils){
    // Create Widget short name for local reference    exWdgt = {};

    // Use closures for private code    var testFunc();

    // Add all widget code to widget namespace.
    ns.WidgetModel = can.Model({...});
    ns.WidgetControl = can.Control({...});

    // Add an initialization function if the widget should be initialized externally
    ns.initWidget = function(/*params*/){...};

// Pass in external values that will be used by this code
}(
raft.app,              // The app namespace
raft.widgets.ExWidget, // The specific namespace to which the resulting objects and functions from this file will be added.
raft.data.ExWidget,    // The specific data namespace for this widget/page/object. Cached and local data  should go here
raft.utils             // The namespace containing app framework utilities
));

$(document).ready(function()){
    // Code to run when document is finished loading
}

// Example Widget Definition
function(app, ns, data, utils){
    // Create Widget short name for local reference
    ns.ExampleWidget = {
        SomeWidgetFunctionObjectOrEnum : {...}
    };

    // Create Widget data namespace
    data.ExampleWidget = {
        WidgetDataVal1 : "foo",
        WidgetDataVal2 : {...}
    };

    // It's common to always defer loading of css and data since they aren't debugged
    utils.requireCSS("widgets/ExampleWidget/ExampleWidget.CSS");
    utils.requireScript("widgets/ExampleWidget/widget_test_data.js", false);

    // Only defer load these if it's turned on
    if (app.config.isDeferLoad) {
        utils.requireScript("widgets/ExampleWidget/ExampleWidgetModel.js", true);
        utils.requireScript("widgets/ExampleWidget/ExampleWidgetCtrl.js", true);
    }
// Pass in external values that will be used by this code
}(
raft.app,     // The app namespace
raft.widgets, // The widget or page namespace
raft.data,    // The data namespace
raft.utils    // Application framework utilities namespace
));

$(document).ready(function()){
    // Code to run when document is finished loading
}

$.isDefined(obj) // Returns true if object is not undefined and not null

String.isString(obj) // Returns true if object is a string literal or String object

String.isEmpty(obj) // Returns true if object is a zero-length string

String.isNonEmpty(obj) // Returns true if object is a non-zero-length string

Number.isNumber(obj) // Returns true if object is a primitive number or a Number object

raft.utils.requireScript(path).always(...).then(...);

raft.utils.requiresCSS(path);