integrating the latest montage version

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

1 files changed, 146 insertions, 77 deletions

diff --git a/node_modules/montage/ui/rich-text-editor/rich-text-editor.reel/rich-text-editor.js b/node_modules/montage/ui/rich-text-editor/rich-text-editor.reel/rich-text-editor.js
index 89af8eb3..a132b0ab 100644
--- a/node_modules/montage/ui/rich-text-editor/rich-text-editor.reel/rich-text-editor.js
+++ b/node_modules/montage/ui/rich-text-editor/rich-text-editor.reel/rich-text-editor.js
@@ -4,8 +4,11 @@
  (c) Copyright 2011 Motorola Mobility, Inc.  All Rights Reserved.
  </copyright> */
 /**
-        @module "montage/ui/rich-text-editor.reel"
+    @module "montage/ui/rich-text-editor/rich-text-editor.reel"
     @requires montage/core/core
+    @requires montage/core/event/mutable-event
+    @requires montage/core/event/event-manager
+    @requires rich-text-sanitizer
 */
 var Montage = require("montage").Montage,
     RichTextEditorBase = require("./rich-text-editor-base").RichTextEditorBase,
@@ -14,15 +17,38 @@ var Montage = require("montage").Montage,
     defaultEventManager = require("core/event/event-manager").defaultEventManager;
 
 /**
-    @class module:"montage/ui/rich-text-editor.reel".RichTextEditor
+    @classdesc The RichTextEditor component is a lightweight Montage component that provides basic HTML editing capability. It wraps the HTML5 <code>contentEditable</code> property and largely relies on the browser's support of <code><a href="http://www.quirksmode.org/dom/execCommand.html" target="_blank">execCommand</a></code>.
+    @class module:"montage/ui/rich-text-editor/rich-text-editor.reel".RichTextEditor
     @extends module:montage/ui/component.Component
+    @summary
+The easiest way to create a RichTextEditor is with a serialization and a &lt;div> tag:<p>
+
+<em>Serialization</em>
+<pre class="sh_javascript">
+{
+"editor": {
+   "prototype": "montage/ui/rich-text-editor/rich-text-editor.reel",
+   "properties": {
+      "element": {"#": "editor" }
+   }
+}
+</pre>
+<em>HTML</em>
+<pre class="sh_javascript">
+&lt;body&gt;
+&lt;div data-montage-id="editor"&gt;
+    &lt;span&gt;Hello World!&lt;/span&gt;
+&lt;/div&gt;
+&lt;/body&gt;
+</pre>
 */
-exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"montage/ui/rich-text-editor.reel".RichTextEditor# */ {
+exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"montage/ui/rich-text-editor/rich-text-editor.reel".RichTextEditor# */ {
 
-    /**
-      Description TODO
-     @type {Function}
-    */
+/**
+    Returns <code>true</code> if the edtior has focus, otherwise returns <code>false</code>.
+    @type {boolean}
+    @readonly
+*/
     hasFocus: {
         enumerable: true,
         get: function() {
@@ -30,10 +56,11 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
         }
     },
 
-    /**
-      Description TODO
-     @type {Function}
-    */
+/**
+    Returns the editor's inner element, which is the element that is editable.
+     @type {Element}
+    @readonly
+*/
     innerElement: {
         enumerable: true,
         get: function() {
@@ -43,8 +70,8 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
 
 
     /**
-      Description TODO
-      @type {Function}
+      Sets the focus on the editor's element. The editor will also become the <code>activeElement</code>.
+      @function
     */
     focus: {
         enumerable: true,
@@ -55,8 +82,10 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
     },
 
     /**
-      Description TODO
-     @type {Function}
+      Returns <code>true</code> when the editor is the active element, otherwise return <code>false</code>. Normally the active element has also focus. However, in a multiple window environment it’s possible to be the active element without having focus. Typically, a toolbar item my steal the focus but not become the active element.
+
+     @type {boolean}
+    @readonly
     */
     isActiveElement: {
         enumerable: true,
@@ -66,8 +95,8 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
     },
 
     /**
-      Description TODO
-     @type {Function}
+     Returns <code>true</code> if the content is read only, otherwise returns <code>false</code>. When the editor is set to read only, the user is not able to modify the content. However it still possible to set the content programmatically with by setting the <code>value</code> or <code>textValue</code> properties.
+     @type {boolean}
     */
     readOnly: {
         enumerable: true,
@@ -87,8 +116,9 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
     },
 
     /**
-      Description TODO
-     @type {Function}
+      Gets or sets the editor's content as HTML. By default, the HTML content assigned to the editor's DOM element is used.
+      The new value is passed through the editor's sanitizer before being assigned.
+     @type {string}
     */
     value: {
         enumerable: true,
@@ -154,10 +184,10 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
         }
     },
 
-    /**
-      Description TODO
-     @type {Function}
-    */
+/**
+    Gets or sets the editor's content as plain text. By default, the text content assigned to the editor's DOM element is used.
+    @type {string}
+*/
     textValue: {
         enumerable: true,
         get: function() {
@@ -206,8 +236,8 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
     },
 
     /**
-      Description TODO
-     @type {}
+      Gets or sets the editor's delegate object that can define one or more delegate methods that a consumer can implement. For a list of delegate methods, see [Delegate methods]{@link  http://tetsubo.org/docs/montage/using-the-rich…itor-component#Delegate_methods}.
+     @type {object}
     */
     delegate: {
         enumerable: true,
@@ -215,8 +245,8 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
     },
 
     /**
-      Description TODO
-     @type {Function}
+    The role of the sanitizer is to cleanup any data before its inserted, or extracted, from the editor. The default sanitizer removes any JavaScript, and scopes any CSS before injecting any data into the editor. However, JavaScript is not removed when the initial value is set using <code>editor.value</code>.
+     @type {object}
     */
     sanitizer: {
         enumerable: false,
@@ -229,8 +259,8 @@ exports.RichTextEditor = Montage.create(RichTextEditorBase,/** @lends module:"mo
     },
 
     /**