First commit of Ninja to ninja-internal

Signed-off-by: Valerio Virgillito <rmwh84@motorola.com>

1 files changed, 595 insertions, 0 deletions

diff --git a/node_modules/montage/core/state-chart.js b/node_modules/montage/core/state-chart.js
new file mode 100755
index 00000000..1e7265d8
--- /dev/null
+++ b/node_modules/montage/core/state-chart.js
@@ -0,0 +1,595 @@
+/* <copyright>
+ This file contains proprietary software owned by Motorola Mobility, Inc.<br/>
+ No rights, expressed or implied, whatsoever to this software are provided by Motorola Mobility, Inc. hereunder.<br/>
+ (c) Copyright 2011 Motorola Mobility, Inc.  All Rights Reserved.
+ </copyright> */
+ /**
+        @module montage/core/state-chart
+    @requires montage
+*/
+var Montage = require("montage").Montage;
+
+/**
+    @class module:montage/core/state-chart.State
+    @extends module:montage/core/core.Montage
+*/
+var State = exports.State = Montage.create(Montage, /** @lends module:montage/core/state-chart.State# */{
+
+    _stateChart: {
+        enumerable: false,
+        value: null
+    },
+/**
+    Initializes a State object with a set of options.
+    @function
+    @param {String} options The options for the new State.
+    @returns {State}
+    */
+    init: {
+        value: function(options) {
+
+            this.substates = {};
+            this.enterState = null;
+            this.exitState = null;
+
+            var keys = Object.keys(options),
+                i = 0,
+                iKey,
+                iOption;
+
+            for (; (iKey = keys[i]); i++) {
+
+                iOption = options[iKey];
+
+                if (iOption.prototype === State.prototype) {
+                    iOption.name = iKey;
+                    iOption.parentState = this;
+                    this.substates[iKey] = iOption;
+                }
+
+                // TODO is it worth guarding against any old property being added to this state?
+                if (typeof iOption === "string" && "initialSubstate" !== iKey) {
+                    // this is a simple gotoState transition syntax
+                    this[iKey] = this._encloseGotoState(iOption);
+                } else {
+                    this[iKey] = iOption;
+                }
+            }
+
+            return this;
+        }
+    },
+/**
+        The name of the state.
+        @type {Property}
+        @default {String} null
+    */
+    name: {
+        enumerable: false,
+        value: null
+    },
+    _initialSubstate: {
+        enumerable: false,
+        value: null
+    },
+
+/**
+        The intitial substate.
+        @type {Function}
+        @default {String} null
+    */
+    initialSubstate: {
+        get: function() {
+            if (typeof this._initialSubstate === "string") {
+                this._initialSubstate = this[this._initialSubstate];
+            }
+            return this._initialSubstate;
+        },
+        set: function(value) {
+            this._initialSubstate = value;
+        }
+    },
+/**
+        The set of substates.
+        @type {Property}
+        @default {String} null
+    */
+    substates: {
+        enumerable: false,
+        value: null
+    },
+/**
+       The state's parent state.
+        @type {Property}
+        @default {String} null
+    */
+    parentState: {
+        enumerable: false,
+        value: null
+    },
+
+    _path: {
+        enumerable: false,
+        value: null
+    },
+
+/**
+        @type {Function}
+        @default {String} null
+    */
+    path: {
+        // TODO add dependency on parentState, remember to clear cached value
+        enumerable: false,
+        get: function() {
+            if (!this._path) {
+
+                if (this.parentState && this.parentState.path) {
+                    this._path = this.parentState.path + "." + this.name;
+                } else {
+                    this._path = this.name;
+                }
+            }
+            return this._path;
+        }
+    },
+/**
+        @type {Property}
+        @default {String} null
+    */
+    enterState: {
+        enumerable: false,
+        value: null
+    },
+/**
+        @type {Property}
+        @default {String} null
+    */
+    exitState: {
+        enumerable: false,
+        value: null
+    },
+/**
+    @function
+    @param {String} otherState
+    @returns !!this.path.match(new RegExp(".?" + otherState + ".?"))
+    */
+    isInState: {
+        enumerable: false,
+        value: function(otherState) {
+
+            if (typeof otherState !== "string") {
+                otherState = otherState.name;
+            }
+
+            return !!this.path.match(new RegExp(".?" + otherState + ".?"));
+        }
+    },
+/**
+  @private
+*/
+    _encloseGotoState: {
+        value: function(state) {
+            return (function(stateChart, owner) {
+                // Not relying on original implementation to save an extra function call, despite duplicated code
+                return this._stateChart._gotoState(state, owner);
+            });
+        }
+    },
+/**
+    @function
+    @param {Property} state
+    @param {Property} owner
+    @returns this._stateChart._gotoState(state, owner)
+    */
+    gotoState: {
+        value: function(state, owner) {
+            return this._stateChart._gotoState(state, owner);
+        }
+    },
+/**
+  @private
+*/
+    _performAction: {
+        enumerable: null,
+        value: function(actionName, stateChart, owner) {
+            if (this[actionName]) {
+                // TODO what should the context be inside the action function: state or stateChart?
+                // state makes sense but requires that authors know that when building a stateChart
+                // it's easy to get annoyed with having to remember which one you're in when building
+                // a relatively complex stateChart
+                // we could just .call(this._stateChart, args) etc...
+                this[actionName](stateChart, owner);
+
+            } else if (this.parentState) {
+                this.parentState._performAction(actionName, stateChart, owner);
+            } else {
+                throw "Action '" + actionName + "' not available";
+            }
+        }
+    },
+/**
+    @function
+    @returns "[State " + this.path + " ]"
+    */
+    toString: {
+        enumerable: false,
+        value: function() {
+            return "[State " + this.path + " ]";
+        }
+    }
+
+});
+/**
+    @class module:montage/core/state-chart.StateChart
+*/
+var StateChart = exports.StateChart = Montage.create(Montage,/** @lends module:montage/core/state-chart.StateChart# */ {
+/**
+        @type {Property}
+        @default {String} null
+    */
+    delegate: {
+        enumerable: false,
+        value: null