Extension docs: Manual merge crrev.com/143652

chrome/common/extensions/docs/js/api_page_generator.js

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**
  * @fileoverview This file is the controller for generating extension
  * doc pages.
  *
  * It expects to have available via XHR (relative path):
  *   1) API_TEMPLATE which is the main template for the api pages.
@@ skipping 96 matching lines @@
 
 // Mappings of api calls to URLs
 var apiMapping;
 
 // The current module for this page (if this page is an api module);
 var module;
 
 // Mapping from typeId to module.
 var typeModule = {};
 
+// Mapping from typeId to type.
+var typeIdType = {};
+
 // Auto-created page name as default
 var pageName;
 
 // If this page is an apiModule, the name of the api module
 var apiModuleName;
 
 // Permission information according to PERMISSION_FEATURES.
 var permissionFeatures = {};
 
 // Visits each item in the list in-order. Stops when f returns any truthy
@@ skipping 66 matching lines @@
 
   var schemas_to_retrieve = [];
   if (!USE_DEVTOOLS_SCHEMA || is_experimental_index)
     schemas_to_retrieve = schemas_to_retrieve.concat(MODULE_SCHEMAS);
   if (USE_DEVTOOLS_SCHEMA || is_experimental_index)
     schemas_to_retrieve.push(DEVTOOLS_SCHEMA);
 
   var schemas_retrieved = 0;
   schema = [];
 
+  function qualifyRefs(namespace, obj) {
+    if (typeof(obj) == "object") {
+      for (var i in obj) {
+        if (typeof(obj[i]) == "object") {
+          obj[i] = qualifyRefs(namespace, obj[i]);
+        } else if (i == "$ref") {
+          if (obj[i].indexOf('.') == -1) {
+            obj[i] = namespace + '.' + obj[i];
+          }
+        }
+      }
+    }
+    return obj;
+  }
+
+  function qualifyTypes(schema) {
+    schema.forEach(function(mod) {
+      if (mod.types) {
+        mod.types.forEach(function(type) {
+          type.prettyId = type.id;
+          if (type.prettyId.indexOf(mod.namespace) == 0) {
+            type.prettyId = type.prettyId.substring(mod.namespace.length + 1);
+          }
+          if (type.id.indexOf(mod.namespace) != 0) {
+            type.id = mod.namespace + '.' + type.id;
+          }
+          typeModule[type.id] = mod;
+          typeIdType[type.id] = type;
+        });
+      }
+      mod = qualifyRefs(mod.namespace, mod);
+    });
+    return schema;
+  }
+
   function onSchemaContent(content) {
     if (content)
-      schema = schema.concat(JSON.parse(JSON.minify(content)));
+      schema = schema.concat(qualifyTypes(JSON.parse(JSON.minify(content))));
     if (++schemas_retrieved < schemas_to_retrieve.length)
       return;
     if (pageName.toLowerCase() == 'samples') {
       fetchSamples();
     } else {
       renderTemplate();
     }
   }
 
   schemas_to_retrieve.forEach(function(schema_path) {
@@ skipping 488 matching lines @@
 
   if (schema.type == 'array')
     return 'array of ' + getTypeName(schema.items);
 
   if (schema.isInstanceOf)
     return schema.isInstanceOf;
 
   return schema.type;
 }
 
+function getPrettyTypeId(typeName) {
+  return typeIdType[typeName].prettyId;
+}
+
 function hasPrimitiveValue(schema) {
   var type = typeof(schema.value);
   return type === 'string' || type === 'number';
 }
 
 function getPrimitiveValue(schema) {
   switch (typeof(schema.value)) {
     case 'string':
       return '"' + schema.value + '"';
 
@@ skipping 35 matching lines @@
   }
   if (a.name > b.name) {
     return 1;
   }
   return 0;
 }
 
 function disableDocs(obj) {
   return !!obj.nodoc;
 }