Merge branch 'open1098' into open-master

platform/containment/bundle.json

@@ -7,6 +7,11 @@
                 "depends": [ "$injector" ],
                 "message": "Objects of this type cannot contain objects of that type."
             },
+            {
+                "category": "composition",
+                "implementation": "CompositionMutabilityPolicy.js",
+                "message": "Objects of this type cannot be modified."
+            },
             {
                 "category": "action",
                 "implementation": "ComposeActionPolicy.js",

platform/containment/src/CompositionMutabilityPolicy.js

@@ -0,0 +1,30 @@
+/*global define*/
+
+define(
+    [],
+    function () {
+        "use strict";
+
+        /**
+         * Disallow composition changes to objects which are not mutable.
+         * @constructor
+         */
+        function CompositionMutabilityPolicy() {
+            return {
+                /**
+                 * Is the type identified by the candidate allowed to
+                 * contain the type described by the context?
+                 * @param {Type} candidate the type of domain object
+                 */
+                allow: function (candidate) {
+                    // Equate creatability with mutability; that is, users
+                    // can only modify objects of types they can create, and
+                    // vice versa.
+                    return candidate.hasFeature('creation');
+                }
+            };
+        }
+
+        return CompositionMutabilityPolicy;
+    }
+);

platform/containment/test/CompositionMutabilityPolicySpec.js

@@ -0,0 +1,26 @@
+/*global define,Promise,describe,it,expect,beforeEach,waitsFor,jasmine*/
+
+define(
+    ["../src/CompositionMutabilityPolicy"],
+    function (CompositionMutabilityPolicy) {
+        "use strict";
+
+        describe("The composition mutability policy", function () {
+            var mockType,
+                policy;
+
+            beforeEach(function () {
+                mockType = jasmine.createSpyObj('type', ['hasFeature']);
+                policy = new CompositionMutabilityPolicy();
+            });
+
+            it("only allows composition for types which will have a composition capability", function () {
+                expect(policy.allow(mockType)).toBeFalsy();
+                mockType.hasFeature.andReturn(true);
+                expect(policy.allow(mockType)).toBeTruthy();
+                expect(mockType.hasFeature).toHaveBeenCalledWith('creation');
+            });
+        });
+
+    }
+);

platform/containment/test/suite.json

@@ -1,6 +1,7 @@
 [
     "CapabilityTable",
     "ComposeActionPolicy",
+    "CompositionMutabilityPolicy",
     "CompositionPolicy",
     "ContainmentTable"
 ]