fixes #497: document enum values

docs/_generate/item.html

@@ -10,8 +10,8 @@
       <%= prop.required ? 'Required' : 'Optional' %>
       <% if (prop.type && prop.type !== '*') { %><a href='#types-<%= prop.type %>'><%= prop.type %></a>.<% } %>
     </em>
-    <% if (prop.values) { %><span class='space-right quiet'>
-      <em>One of</em> <%= _(prop.values).map(function(opt) { return '<var>' + opt + '</var>' }).join(', ') %>.
+    <% if (prop.values && Array.isArray(prop.values) === false) { // skips $root.version %><span class='space-right quiet'>
+      <em>One of</em> <%= _(Object.keys(prop.values)).map(function(opt) { return '<var>' + opt + '</var>' }).join(', ') %>.
     </span><% } %>
     <% if (prop.units) { %><span class='space-right quiet'>
       <em>Units in</em>
@@ -45,6 +45,12 @@
   <% if (prop.doc) { %>
   <div class='space-bottom1'><%= md(prop.doc) %></div>
   <% } %>
+  <% if (prop.values && Array.isArray(prop.values) === false) { // skips $root.version %><div class='space-bottom1'><dl>
+    <% for (var v in prop.values) { %>
+      <dt><var><%= v %></var></dt>
+      <dd><%= md(prop.values[v].doc) %></dd>
+    <% } %>
+  </dl></div><% } %>
   <% if (prop.example) { %>
   <div class='space-bottom1 clearfix'>
 {% highlight json %}

lib/validate/validate_enum.js

@@ -9,8 +9,14 @@ module.exports = function validateEnum(options) {
     var valueSpec = options.valueSpec;
     var errors = [];
 
-    if (valueSpec.values.indexOf(unbundle(value)) === -1) {
-        errors.push(new ValidationError(key, value, 'expected one of [%s], %s found', valueSpec.values.join(', '), value));
+    if (Array.isArray(valueSpec.values)) { // <=v7
+        if (valueSpec.values.indexOf(unbundle(value)) === -1) {
+            errors.push(new ValidationError(key, value, 'expected one of [%s], %s found', valueSpec.values.join(', '), value));
+        }
+    } else { // >=v8
+        if (Object.keys(valueSpec.values).indexOf(unbundle(value)) === -1) {
+            errors.push(new ValidationError(key, value, 'expected one of [%s], %s found', Object.keys(valueSpec.values).join(', '), value));
+        }
     }
     return errors;
 };