+/*
+ * Copyright 2013 Laurent Bovet <laurent.bovet@windmaster.ch>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+var docson = docson || {};
+
+docson.templateBaseUrl="templates";
+
+define(["lib/jquery", "lib/handlebars", "lib/highlight", "lib/jsonpointer", "lib/marked", "lib/traverse"], function(jquery, handlebars, highlight, jsonpointer, marked) {
+
+ var ready = $.Deferred();
+ var boxTemplate;
+ var signatureTemplate;
+ var source;
+ var stack = [];
+ var boxes=[];
+
+ Handlebars.registerHelper('scope', function(schema, options) {
+ var result;
+ boxes.push([]);
+ if(schema && (schema.id || schema.root)) {
+ stack.push( schema );
+ result = options.fn(this);
+ stack.pop();
+ } else {
+ result = options.fn(this);
+ }
+ boxes.pop();
+ return result;
+ });
+
+ Handlebars.registerHelper('source', function(schema) {
+ delete schema.root;
+ delete schema.__boxId;
+ delete schema.__name;
+ delete schema.__ref;
+ return JSON.stringify(schema, null, 2);
+ });
+
+ Handlebars.registerHelper('desc', function(schema) {
+ var description = schema.description;
+
+ if( !description ) return "";
+ var text = description;
+ if(marked) {
+ marked.setOptions({gfm: true, breaks: true})
+ return new Handlebars.SafeString(marked(text));
+ } else {
+ return text;
+ }
+ });
+
+ Handlebars.registerHelper('equals', function(lvalue, rvalue, options) {
+ if (arguments.length < 3)
+ throw new Error("Handlebars Helper equals needs 2 parameters");
+ if( lvalue!=rvalue ) {
+ return options.inverse(this);
+ } else {
+ return options.fn(this);
+ }
+ });
+
+ Handlebars.registerHelper('contains', function(arr, item, options) {;
+ if(arr && arr instanceof Array && arr.indexOf(item) != -1) {
+ return options.fn(this);
+ }
+ });
+
+ Handlebars.registerHelper('primitive', function(schema, options) {
+ if(schema.type && schema.type != "object" && schema.type != "array" || schema.enum) {
+ return withType(this, options, true)
+ }
+ });
+
+ Handlebars.registerHelper('exists', function(value, options) {
+ if(value !== undefined) {
+ value = value === null ? "null": value;
+ value = value === true ? "true": value;
+ value = value === false ? "false": value;
+ value = typeof value === "object" ? JSON.stringify(value): value;
+ this.__default = value;
+ var result = options.fn(this);
+ delete this.__default;
+ return result;
+ }
+ });
+
+ Handlebars.registerHelper('range', function(from, to, replFrom, replTo, exclFrom, exclTo, sep) {
+ var result = "";
+ if(from !== undefined || to !== undefined) {
+ result += exclFrom ? "]" : "[";
+ result += from !== undefined ? from : replFrom;
+ if( (from || replFrom) !== (to || replTo)) {
+ result += (from !== undefined || replFrom !== null) && (to !== undefined || replTo !== null) ? sep : "";
+ result += to !== undefined ? to : replTo;
+ }
+ result += exclTo ? "[" : "]";
+ return result;
+ }
+ });
+
+ var sub = function(schema) {
+ return schema.type == "array" || schema.allOf || schema.anyOf || schema.oneOf || schema.not;
+ }
+
+ Handlebars.registerHelper('sub', function(schema, options) {
+ if(sub(schema) || (schema.type && schema.type != "object" && schema.type != "array") || schema.enum) {
+ return options.fn(this);
+ }
+ });
+
+ Handlebars.registerHelper('main', function(schema, options) {
+ if(!sub(schema)) {
+ return options.fn(this);
+ }
+ });
+
+ var simpleSchema = function(schema) {
+ var result = schema.description===undefined && schema.title===undefined && schema.id===undefined;
+ result &= schema.properties===undefined;
+ return result;
+ };
+
+ Handlebars.registerHelper('simple', function(schema, options) {
+ if(simpleSchema(schema) && !schema.$ref) {
+ return withType(schema, options, true);
+ }
+ });
+
+ var withType = function(schema, options, hideAny) {
+ schema.__type = schema.type;
+ if(!schema.type && !hideAny) {
+ schema.__type="any";
+ }
+ if(schema.format) {
+ schema.__type=schema.format;
+ }
+ if( (schema.__type == "any" || schema.__type == "object") && schema.title) {
+ schema.__type = schema.title;
+ }
+ var result = options.fn(schema);
+ delete schema.__type;
+ return result;
+ }
+
+ Handlebars.registerHelper('complex', function(schema, options) {
+ if(!simpleSchema(schema) && !schema.$ref || schema.properties) {
+ return withType(schema, options);
+ }
+ });
+
+ Handlebars.registerHelper('enum', function(schema) {
+ if(schema.enum) {
+ return (schema.enum.length > 1) ? "enum": "constant";
+ }
+ });
+
+ Handlebars.registerHelper('obj', function(schema, options) {
+ if(schema.properties || schema.type == "object") {
+ return withType(schema, options);
+ }
+ });
+
+ var pushBox = function(schema) {
+ boxes[boxes.length-1].push(schema);
+ }
+
+ Handlebars.registerHelper('box', function(schema, options) {
+ if(schema) {
+ pushBox(schema);
+ return options.fn(schema);
+ }
+ });
+
+ Handlebars.registerHelper('boxId', function() {
+ return boxes[boxes.length-1].length
+ });
+
+ Handlebars.registerHelper('boxes', function(options) {
+ var result="";
+ $.each(boxes[boxes.length-1], function(k, box) {
+ box.__boxId = k+1;
+ result=result+options.fn(box);
+ });
+ boxes[boxes.length-1] = []
+ return result;
+ });
+
+ var resolveIdRef = function(ref) {
+ if(stack) {
+ var i;
+ for(i=stack.length-1; i>=0; i--) {
+ if(stack[i][ref]) {
+ return stack[i][ref];
+ }
+ }
+ }
+ return null;
+ }
+
+ var resolvePointerRef = function(ref) {
+ var root = stack[1];
+ if(ref=="#") {
+ return root;
+ }
+ try {
+ return jsonpointer.get(stack[1], ref);
+ } catch(e) {
+ console.log(e);
+ return null;
+ }
+ }
+
+ var resolveRef = function(ref) {
+ if(ref.indexOf("#") == 0) {
+ return resolvePointerRef(ref);
+ } else {
+ return resolveIdRef(ref);
+ }
+ }
+
+ var getName = function(schema) {
+ if(!schema) {
+ return "<error>";
+ }
+ var name = schema.title;
+ name = !name && schema.id ? schema.id: name;
+ name = !name ? schema.__name: name;
+ return name;
+ }
+
+ Handlebars.registerHelper('name', function(schema, options) {
+ schema.__name = getName(schema);
+ if(schema.__name) {
+ return options.fn(schema);
+ }
+ });
+
+ var refName = function(ref) {
+ var name = getName(resolveRef(ref));
+ if(!name) {
+ if(ref == "#") {
+ name = "<root>";
+ } else {
+ name = ref.replace("#", "/")
+ }
+ }
+ var segments = name.split("/");
+ name = segments[segments.length-1];
+ return name;
+ }
+
+ function renderSchema(schema) {
+ if(stack.indexOf(schema) == -1) { // avoid recursion
+ stack.push(schema);
+ var ret = new Handlebars.SafeString(boxTemplate(schema));
+ stack.pop();
+ return ret;
+ } else {
+ return new Handlebars.SafeString(boxTemplate({"description": "_circular reference_"}));
+ }
+ }
+
+ Handlebars.registerHelper('ref', function(schema, options) {
+ if(schema.$ref) {
+ var target = resolveRef(schema.$ref);
+ if(target) {
+ target.__name = refName(schema.$ref);
+ target.__ref = schema.$ref.replace("#", "");
+ }
+ var result;
+ if(target) {
+ result = options.fn(target);
+ } else {
+ result = new Handlebars.SafeString("<span class='signature-type-ref'>"+schema.$ref+"</span>");
+ }
+ if(target) {
+ delete target.__ref;
+ }
+ return result;
+ }
+ });
+
+ Handlebars.registerHelper('schema', function(schema) {
+ return renderSchema(schema);
+ });
+
+ Handlebars.registerHelper('signature', function(schema, keyword, schemas) {
+ if(!schemas) {
+ schemas = []
+ }
+ schemas = schemas instanceof Array ? schemas : [schemas];
+ return new Handlebars.SafeString(signatureTemplate({ schema: schema, keyword: keyword, schemas: schemas}));
+ });
+
+ Handlebars.registerHelper('l', function(context) {
+ console.log(context);
+ });
+
+ function init() {
+ $.when( $.get(docson.templateBaseUrl+"/box.html").done(function(content) {
+ source = content
+ boxTemplate = Handlebars.compile(source);
+ }), $.get(docson.templateBaseUrl+"/signature.html").done(function(content) {
+ source = content
+ signatureTemplate = Handlebars.compile(source);
+ })).always(function() {
+ ready.resolve();
+ });
+ };
+
+ docson.doc = function(element, schema, ref, baseUrl) {
+ var d = $.Deferred();
+ if(baseUrl === undefined) baseUrl='';
+ init();
+ ready.done(function() {
+ if(typeof element == "string") {
+ element = $("#"+element);
+ }
+ if(typeof schema == "string") {
+ schema = JSON.parse(schema);
+ }
+
+ var refsPromise = $.Deferred().resolve().promise();
+ var refs = {};
+
+
+ var renderBox = function() {
+ stack.push(refs);
+ var target = schema;
+ if(ref) {
+ ref = ref[0] !== '/' ? '/'+ref : ref;
+ target = jsonpointer.get(schema, ref);
+ stack.push( schema );
+ }
+ target.root = true;
+ target.__ref = "<root>";
+ var html = boxTemplate(target);
+
+ if(ref) {
+ stack.pop();
+ }
+ stack.pop();
+
+ element.addClass("docson").html(html);
+
+ var resizeHandler = element.get(0).onresize;
+ function resized() {
+ if(resizeHandler) {
+ var box = element.find(".box").first();
+ element.get(0).onresize(box.outerWidth(), box.outerHeight());
+ }
+ }
+ element.get(0).resized = resized;
+ resized();
+
+ if(highlight) {
+ element.find(".json-schema").each(function(k, schemaElement) {
+ highlight.highlightSchema(schemaElement);
+ });
+ }
+ element.find(".box-title").each(function() {
+ var ref = $(this).attr("ref");
+ if(ref) {
+ if(window.location.href.indexOf("docson/index.html") > -1) {
+ $(this).find(".box-name").css("cursor", "pointer").attr("title", "Open in new window")
+ .hover(
+ function(){ $(this).addClass('link') },
+ function(){ $(this).removeClass('link') })
+ .click(function() {
+ var url = window.location.href+"$$expand";
+ if(ref !=="<root>") {
+ url = url.replace(/(docson\/index.html#[^\$]*).*/, "$1$"+ref+"$$expand");
+ }
+ var w;
+ function receiveMessage(event) {
+ if (event.data.id && event.data.id == "docson" && event.data.action == "ready") {
+ w.postMessage({ id: "docson", action: "load", definitions: schema, type: event.data.url.split("$")[1], expand: true}, "*");
+ }
+ }
+ window.addEventListener("message", receiveMessage, false);
+ w = window.open(url, "_blank");
+ });
+ }
+ }
+ });
+ element.find(".box").mouseenter(function() {
+ $(this).children(".source-button").fadeIn(300);
+ $(this).children(".box-body").children(".expand-button").fadeIn(300);
+ });
+ element.find(".box").mouseleave(function() {
+ $(this).children(".source-button").fadeOut(300);
+ $(this).children(".box-body").children(".expand-button").fadeOut(300);
+ });
+ element.find(".signature-type-expandable").click(function() {
+ var boxId = $(this).attr("boxid");
+ $(this).toggleClass("signature-type-expanded");
+ $(this).parent().parent().parent().children(".signature-box-container").
+ children("[boxid='"+boxId+"']").toggle(resizeHandler ? 0 : 300);
+ resized();
+ });
+ element.find(".expand-button").click(function() {
+ if($(this).attr("expanded")) {
+ $(this).parent().parent().find(".expand-button").html(" + ").attr("title", "Expand all");
+ $(this).parent().parent().find(".signature-type-expandable").removeClass("signature-type-expanded");
+ $(this).parent().parent().find(".box-container").hide( resizeHandler ? 0 : 300);
+ $(this).parent().parent().find(".expand-button").removeAttr("expanded");
+ resized();
+ } else {
+ $(this).parent().parent().find(".expand-button").html(" - ").attr("title", "Collapse all");
+ $(this).parent().parent().find(".signature-type-expandable").addClass("signature-type-expanded");
+ $(this).parent().parent().find(".box-container").show(resizeHandler ? 0 : 300);
+ $(this).parent().parent().find(".expand-button").attr("expanded", true);
+ resized();
+ }
+ });
+ element.find(".source-button").click(function() {
+ $(this).parent().children(".box-body").toggle();
+ $(this).parent().children(".source").toggle();
+ resized();
+ });
+ };
+
+ var resolveRefsReentrant = function(schema){
+ traverse(schema).forEach(function(item) {
+ // Fix Swagger weird generation for array.
+ if(item && item.$ref == "array") {
+ delete item.$ref;
+ item.type ="array";
+ }
+
+ // Fetch external schema
+ if(this.key === "$ref") {
+ var external = false;
+ //Local meaning local to this server, but not in this file.
+ var local = false;
+ if((/^https?:\/\//).test(item)) {
+ external = true;
+ }
+ else if((/^[^#]/).test(item)) {
+ local = true;
+ } else if(item.indexOf('#') > 0) {
+ //Internal reference
+ //Turning relative refs to absolute ones
+ external = true;
+ item = baseUrl + item;
+ this.update(item);
+ }
+ if(external){
+ //External reference, fetch it.
+ var segments = item.split("#");
+ refs[item] = null;
+ var p = $.get(segments[0]).then(function(content) {
+ if(typeof content != "object") {
+ try {
+ content = JSON.parse(content);
+ } catch(e) {
+ console.error("Unable to parse "+segments[0], e);
+ }
+ }
+ if(content) {
+ refs[item] = content;
+ renderBox();
+ resolveRefsReentrant(content);
+ }
+ });
+ }
+ else if(local) {
+ //Local to this server, fetch relative
+ var segments = item.split("#");
+ refs[item] = null;
+ var p = $.get(baseUrl + segments[0]).then(function(content) {
+ if(typeof content != "object") {
+ try {
+ content = JSON.parse(content);
+ } catch(e) {
+ console.error("Unable to parse "+segments[0], e);
+ }
+ }
+ if(content) {
+ refs[item] = content;
+ renderBox();
+ resolveRefsReentrant(content);
+ }
+ });
+ }
+ }
+ });
+ };
+
+ resolveRefsReentrant(schema);
+ renderBox();
+
+ d.resolve();
+ })
+ return d.promise();
+ }
+
+ return docson;
+});