Merge branch 'refs/heads/Ninja-DOM-Architecture' into Document

66 files changed, 7578 insertions, 3685 deletions

diff --git a/node_modules/montage/core/change-notification.js b/node_modules/montage/core/change-notification.js
new file mode 100644
index 00000000..bfe5ff2d
--- /dev/null
+++ b/node_modules/montage/core/change-notification.js
@@ -0,0 +1,1418 @@
+/* <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/event/change-notification
+*/
+
+var Montage = require("montage").Montage,
+    logger = require("core/logger").logger("change-notification"),
+    UNDERSCORE = "_";
+
+// key: <path>, <target uuid>, <listener uuid>
+var _descriptorsDirectory = Object.create(null);
+
+// key: <target uuid>, <path>
+var _willChangeDescriptorsDirectory = Object.create(null);
+var _willChangeDescriptorsIndexesDirectory = Object.create(null);
+var _changeDescriptorsDirectory = Object.create(null);
+var _changeDescriptorsIndexesDirectory = Object.create(null);
+
+exports.__reset__ = function() {
+    _descriptorsDirectory = Object.create(null);
+    _willChangeDescriptorsDirectory = Object.create(null);
+    _willChangeDescriptorsIndexesDirectory = Object.create(null);
+    _changeDescriptorsDirectory = Object.create(null);
+    _changeDescriptorsIndexesDirectory = Object.create(null);
+    // also need to remove all installed setters
+};
+
+exports.__debug__ = function() {
+    console.log("_descriptorsDirectory", _descriptorsDirectory);
+    console.log("_willChangeDescriptorsDirectory", _willChangeDescriptorsDirectory, _willChangeDescriptorsIndexesDirectory);
+    console.log("_changeDescriptorsDirectory", _changeDescriptorsDirectory, _changeDescriptorsIndexesDirectory);
+};
+
+var ChangeNotification = exports.ChangeNotification = Object.create(Montage, {
+    // (object) => <object>.uuid
+    //
+    // (target_n): {
+    //     <propertyPath_n>: {
+    //         target,
+    //         propertyPath,
+    //         willChangeListeners: {
+    //             (listener_n): {
+    //                 listenerTarget,
+    //                 listenerFunction,
+    //                 listensToMutation
+    //             }
+    //         },
+    //         changeListeners: same as willChangeListeners,
+    //         willChangeListenersCount: Object.keys(willChangeListeners).length,
+    //         changeListenersCount: Object.keys(changeListeners).length,
+    //         handleWillChange: function()
+    //         handleChange: function()
+    //     }
+    // }
+    _descriptorsRegistry: {
+        writable: true,
+        value: Object.create(null)
+    },
+
+    _createFunctionDescriptor: {
+        value: function(target, listener, beforeChange, mutation) {
+            var identifier,
+                functionName,
+                functionDescriptor = Object.create(ChangeNotificationFunctionDescriptor);
+
+            if (typeof listener === "function") {
+                functionDescriptor.listenerFunction = listener;
+                functionDescriptor.listenerTarget = target;
+            } else {
+                identifier = target.identifier;
+
+                if (identifier) {
+                    identifier = identifier.toCapitalized();
+
+                    functionName = "handle" + identifier + (beforeChange ? "WillChange" : "Change");
+                    if (typeof listener[functionName] === "function") {
+                        functionDescriptor.listenerFunctionName = functionName;
+                        functionDescriptor.listenerFunction = listener[functionName];
+                        functionDescriptor.listenerTarget = listener;
+                    }
+                }
+
+                if (!functionDescriptor.listenerFunction) {
+                    functionName = "handle" + (beforeChange ? "WillChange" : "Change");
+                    if (typeof listener[functionName] === "function") {
+                        functionDescriptor.listenerFunctionName = functionName;
+                        functionDescriptor.listenerFunction = listener[functionName];
+                        functionDescriptor.listenerTarget = listener;
+                    }
+                }
+            }
+
+            if (!functionDescriptor.listenerFunction) {
+                console.log("Could not find valid listener when installing", target, listener);
+                throw "Could not find valid listener when installing";
+            }
+
+            functionDescriptor.listensToMutation = mutation;