add special handler in Plotly.validate for enumerated w/ dynamic values

- e.g. axis 'anchor' declare both x and y values, but coerce
  x or y values depending on the container.
- similarly for 'overlaying' and 'contraintoward'

Author: etpinard

src/plot_api/validate.js

@@ -219,6 +219,11 @@ function crawl(objIn, objOut, schema, list, base, path) {
         else if(!Lib.validate(valIn, nestedSchema)) {
             list.push(format('value', base, p, valIn));
         }
+        else if(nestedSchema.valType === 'enumerated' &&
+            ((nestedSchema.coerceNumber && valIn !== +valOut) || valIn !== valOut)
+        ) {
+            list.push(format('dynamic', base, p, valIn, valOut));
+        }
     }
 
     return list;
@@ -267,6 +272,16 @@ var code2msgFunc = {
 
         return inBase(base) + target + ' ' + astr + ' did not get coerced';
     },
+    dynamic: function(base, astr, valIn, valOut) {
+        return [
+            inBase(base) + 'key',
+            astr,
+            '(set to \'' + valIn + '\')',
+            'got reset to',
+            '\'' + valOut + '\'',
+            'during defaults.'
+        ].join(' ');
+    },
     invisible: function(base) {
         return 'Trace ' + base[1] + ' got defaulted to be not visible';
     },
@@ -284,7 +299,7 @@ function inBase(base) {
     return 'In ' + base + ', ';
 }
 
-function format(code, base, path, valIn) {
+function format(code, base, path, valIn, valOut) {
     path = path || '';
 
     var container, trace;
@@ -301,8 +316,8 @@ function format(code, base, path, valIn) {
         trace = null;
     }
 
-    var astr = convertPathToAttributeString(path),
-        msg = code2msgFunc[code](base, astr, valIn);
+    var astr = convertPathToAttributeString(path);
+    var msg = code2msgFunc[code](base, astr, valIn, valOut);
 
     // log to console if logger config option is enabled
     Lib.log(msg);

test/jasmine/tests/validate_test.js

@@ -392,4 +392,45 @@ describe('Plotly.validate', function() {
             'In data trace 2, key transforms[0].type is set to an invalid value (no gonna work)'
         );
     });
+
+    it('should catch input errors for attribute with dynamic defaults', function() {
+        var out = Plotly.validate([], {
+            xaxis: {
+                constrain: 'domain',
+                constraintoward: 'bottom'
+            },
+            yaxis: {
+                constrain: 'domain',
+                constraintoward: 'left'
+            },
+            xaxis2: {
+                anchor: 'x3'
+            },
+            yaxis2: {
+                overlaying: 'x'
+            }
+        });
+
+        expect(out.length).toBe(4);
+        assertErrorContent(
+            out[0], 'dynamic', 'layout', null,
+            ['xaxis', 'constraintoward'], 'xaxis.constraintoward',
+            'In layout, key xaxis.constraintoward (set to \'bottom\') got reset to \'center\' during defaults.'
+        );
+        assertErrorContent(
+            out[1], 'dynamic', 'layout', null,
+            ['yaxis', 'constraintoward'], 'yaxis.constraintoward',
+            'In layout, key yaxis.constraintoward (set to \'left\') got reset to \'middle\' during defaults.'
+        );
+        assertErrorContent(
+            out[2], 'dynamic', 'layout', null,
+            ['xaxis2', 'anchor'], 'xaxis2.anchor',
+            'In layout, key xaxis2.anchor (set to \'x3\') got reset to \'y\' during defaults.'
+        );
+        assertErrorContent(
+            out[3], 'dynamic', 'layout', null,
+            ['yaxis2', 'overlaying'], 'yaxis2.overlaying',
+            'In layout, key yaxis2.overlaying (set to \'x\') got reset to \'false\' during defaults.'
+        );
+    });
 });